Open-source platform for 3D AI agents. Turn text or a photo into a rigged, animated GLB avatar, give it an LLM brain, memory and a wallet, and embed it anywhere with one web component. Remote MCP server, x402 payments, Three.js, browser-native.
JavaScript 3d-generationai-agentsanimationavatardigital-humangenerative-aiglbgltfimage-to-3dllmmcpmcp-servermodel-context-protocolsolanatext-to-3dthreejsweb-componentswebglwebxrx402
/**
* Trader Leaderboard controller.
*
* Renders /api/sniper/leaderboard into a ranked, filterable, live-refreshing
* board. State (tab / window / sort / network / verified) is reflected into the
* URL so any view is shareable. The Earned tab (?tab=earned) ranks agents by
* what they earned and lives in src/leaderboard-earned.js. Every row deep-links to the trader's profile, where each
* number can be followed to its on-chain transaction.
*/
import {
escapeHtml, fmtSol, fmtUsd, fmtPct, pnlClass, shortAddr, holdTime, relTime,
identicon, verifiedBadge, signatureCoin, pnlSparkline,
} from './trader-format.js';
import { walletChipHTML, wireWalletChips } from './shared/agent-wallet-chip.js';
import { updateValue, flipReorder, setLiveDot } from './ui-juice.js';
import { loadEarned, wireEarned } from './leaderboard-earned.js';
const API = '/api/sniper/leaderboard';
const REFRESH_MS = 20_000;
const WINDOWS = new Set(['24h', '7d', '30d', 'all']);
const SORTS = new Set(['score', 'pnl', 'winrate', 'roi']);
const NETWORKS = new Set(['mainnet', 'devnet']);
const TABS = new Set(['trading', 'earned']);
// The earnings snapshot refreshes every 30 minutes, so the Earned tab polls slowly.
const EARNED_REFRESH_MS = 60_000;
const $ = (sel, root = document) => root.querySelector(sel);
const state = { tab: 'trading', network: 'mainnet', window: '30d', sort: 'score', verified: false };
let timer = null;
let firstLoad = true;
let staleBadgeEl = null;
// Stale / reconnecting indicator — surfaced when a background refresh fails
// while a previously-loaded board is still on screen, so holders know the
// numbers may be momentarily out of date instead of silently trusting them.
function ensureStaleBadge() {
if (staleBadgeEl) return staleBadgeEl;
const board = $('.lb-board');
if (!board) return null;
const badge = document.createElement('div');
badge.className = 'lb-stale-badge';
badge.hidden = true;
badge.setAttribute('role', 'status');
badge.setAttribute('aria-live', 'polite');
badge.innerHTML = '<span class="lb-stale-dot" aria-hidden="true"></span><span class="lb-stale-text">Reconnecting — showing last known standings</span>';
board.parentNode.insertBefore(badge, board);
staleBadgeEl = badge;
return badge;
}
function showStale() {
const badge = ensureStaleBadge();
if (badge) badge.hidden = false;
}
function clearStale() {
if (staleBadgeEl) staleBadgeEl.hidden = true;
}
// --- URL <-> state -----------------------------------------------------------
function readUrl() {
const p = new URL(location.href).searchParams;
if (TABS.has(p.get('tab'))) state.tab = p.get('tab');
// The Earned tab opens on this week, the window agent pages link its rank to.
if (state.tab === 'earned') state.window = '7d';
if (NETWORKS.has(p.get('network'))) state.network = p.get('network');
if (WINDOWS.has(p.get('window'))) state.window = p.get('window');
if (SORTS.has(p.get('sort'))) state.sort = p.get('sort');
state.verified = p.get('verified') === '1';
}
function writeUrl() {
const p = new URLSearchParams();
if (state.tab === 'earned') {
p.set('tab', 'earned');
p.set('window', state.window);
history.replaceState(null, '', `${location.pathname}?${p}`);
return;
}
p.set('window', state.window);
p.set('sort', state.sort);
if (state.network !== 'mainnet') p.set('network', state.network);
if (state.verified) p.set('verified', '1');
history.replaceState(null, '', `${location.pathname}?${p}`);
}
// --- Rendering ---------------------------------------------------------------
function skeletonRows(n = 8) {
const cell = '<span class="lb-sk" style="width:70%"></span>';
return Array.from({ length: n }, () => `
<div class="lb-row lb-skeleton" aria-hidden="true">
<span class="lb-sk" style="width:60%"></span>
<span class="lb-trader"><span class="lb-avatar"></span><span class="lb-sk" style="width:55%"></span></span>
${cell.repeat(6)}
<span class="lb-sk" style="width:80%"></span>
</div>`).join('');
}
function rowMarkup(r) {
const img = r.image || identicon(r.agent_id || r.wallet || r.agent_name || '?');
const href = `/trader/${encodeURIComponent(r.agent_id)}`;
const pnlSol = `<span class="${pnlClass(r.realized_pnl_sol)}">${fmtSol(r.realized_pnl_sol)}</span>`;
const pnlUsd = r.realized_pnl_usd != null
? `<span class="lb-sub-num">${fmtUsd(r.realized_pnl_usd)}</span>` : '';
const dd = r.max_drawdown_pct > 0
? `<span class="lb-neg">−${r.max_drawdown_pct.toFixed(1)}%</span>` : '<span class="lb-muted">0%</span>';
const scoreBar = Math.max(4, Math.min(100, r.score));
const spark = pnlSparkline(r.pnl_series, { label: `${r.agent_name || 'Trader'} P&L trend` });
// Win/loss distribution micro-bar — the same wins/closed the cell already shows,
// as a proportion you can read at a glance. Only meaningful with closed trades.
const wlBar = r.closed > 0
? `<span class="lb-wl" aria-hidden="true"><span class="lb-wl-win" style="width:${((r.wins / r.closed) * 100).toFixed(1)}%"></span></span>`
: '';
const rowLabel = [
`Rank ${r.rank}`,
r.agent_name || 'Unnamed agent',
r.wallet ? `wallet ${shortAddr(r.wallet)}` : '',
`score ${r.score}`,
`realized P&L ${fmtSol(r.realized_pnl_sol)}`,
].filter(Boolean).join(', ');
return `
<a class="lb-row" href="${href}" data-key="${escapeHtml(String(r.agent_id))}" data-top="${r.rank <= 3 ? r.rank : ''}" aria-label="${escapeHtml(rowLabel)}">
<span class="lb-rank">${r.rank}</span>
<span class="lb-trader">
<img class="lb-avatar" src="${escapeHtml(img)}" alt="" loading="lazy" data-fallback-src="${identicon(r.agent_id || r.wallet || '?')}" />
<span class="lb-trader-meta">
<span class="lb-trader-name"><span class="lb-trader-nm">${escapeHtml(r.agent_name || 'Unnamed agent')}</span>${verifiedBadge(r.verified)}</span>
<span class="lb-trader-sub">${r.wallet ? walletChipHTML(r, { isOwner: false, showPending: false, link: false }) : escapeHtml(shortAddr(r.wallet))} · ${r.unique_coins} coins${r.top_coin ? ` · ${signatureCoin(r.top_coin, { compact: true })}` : ''}${r.copiers ? ` · <span class="lb-copiers">${r.copiers} copying</span>` : ''}</span>
</span>
</span>
<span class="lb-num">
<span class="lb-score">${r.score}</span>
<span class="lb-score-track"><span class="lb-score-bar" style="width:${scoreBar}%"></span></span>
</span>
<span class="lb-num lb-pnl-cell">${spark}<span class="lb-pnl-nums">${pnlSol}${pnlUsd}</span></span>
<span class="lb-num lb-winrate">${fmtPct(r.win_rate * 100)}<span class="lb-sub-num">${r.wins}/${r.closed}</span>${wlBar}</span>
<span class="lb-num lb-hide-sm"><span class="${pnlClass(r.roi_pct)}">${fmtPct(r.roi_pct, { sign: true })}</span></span>
<span class="lb-num lb-hide-sm">${dd}</span>
<span class="lb-num lb-hide-md">${r.closed}<span class="lb-sub-num">${holdTime(r.avg_hold_seconds)} avg</span></span>
<span class="lb-col-act"><span class="lb-view"><span class="lb-view-full">Track record</span> →</span></span>
</a>`;
}
// --- Live top-trader fallback (kolscan) --------------------------------------
// When no three.ws agent has a provable record in the window yet, the board shows
// the real, public kolscan ranking of top Solana traders so it is never an empty
// void. These rows are external wallets: they deep-link to the on-chain account
// (not a three.ws trader profile) and carry no Trader Score — that is ours to award.
const LIVE_HEAD = `
<span class="lb-col-rank">#</span>
<span class="lb-col-trader">Trader</span>
<span class="lb-col-num">Realized P&L</span>
<span class="lb-col-num lb-winrate">Win rate</span>
<span class="lb-col-num">Trades</span>
<span class="lb-col-act"></span>`;
let agentHeadHTML = null;
function setBoardMode(live) {
const board = $('.lb-board');
const head = board?.querySelector('.lb-board-head');
if (agentHeadHTML == null && head) agentHeadHTML = head.innerHTML;
board?.classList.toggle('is-live', live);
if (head) head.innerHTML = live ? LIVE_HEAD : (agentHeadHTML || head.innerHTML);
// The verified-track-record toggle has no meaning for external wallets.
const verified = $('#lb-verified');
if (verified) {
verified.disabled = live;
verified.closest('.lb-toggle')?.classList.toggle('is-disabled', live);
}
}
const LIVE_SORTS = {
pnl: (a, b) => (b.realized_pnl_usd ?? -Infinity) - (a.realized_pnl_usd ?? -Infinity),
winrate: (a, b) => b.win_rate - a.win_rate || b.trades - a.trades,
};
// score/roi don't exist for external wallets — fall back to realized P&L.
function sortLive(rows, sort) {
const cmp = LIVE_SORTS[sort] || LIVE_SORTS.pnl;
return [...rows].sort(cmp).map((r, i) => ({ ...r, rank: i + 1 }));
}
function liveRowMarkup(r) {
const img = identicon(r.wallet || '?');
const pnlSol = r.realized_pnl_sol != null
? `<span class="${pnlClass(r.realized_pnl_sol)}">${fmtSol(r.realized_pnl_sol)}</span>` : '';
const pnlUsd = r.realized_pnl_usd != null
? `<span class="lb-sub-num">${fmtUsd(r.realized_pnl_usd)}</span>` : '';
const label = [
`Rank ${r.rank}`,
`Solana trader ${shortAddr(r.wallet)}`,
r.realized_pnl_usd != null ? `realized P&L ${fmtUsd(r.realized_pnl_usd)}` : '',
`${r.trades} trades`,
].filter(Boolean).join(', ');
return `
<a class="lb-row lb-row--live" href="${escapeHtml(r.account_url)}" target="_blank" rel="noopener" data-key="${escapeHtml(String(r.wallet))}" data-top="${r.rank <= 3 ? r.rank : ''}" aria-label="${escapeHtml(label)}">
<span class="lb-rank">${r.rank}</span>
<span class="lb-trader">
<img class="lb-avatar" src="${escapeHtml(img)}" alt="" loading="lazy" />
<span class="lb-trader-meta">
<span class="lb-trader-name"><span class="lb-trader-nm">${escapeHtml(shortAddr(r.wallet, 6, 6))}</span></span>
<span class="lb-trader-sub">Solana trader · on-chain account</span>
</span>
</span>
<span class="lb-num">${pnlSol}${pnlUsd}</span>
<span class="lb-num lb-winrate">${fmtPct(r.win_rate * 100)}</span>
<span class="lb-num">${r.trades}</span>
<span class="lb-col-act"><span class="lb-view"><span class="lb-view-full">Account</span> →</span></span>
</a>`;
}
let liveBannerEl = null;
function showLiveBanner(data) {
if (!liveBannerEl) {
const board = $('.lb-board');
if (!board) return;
const el = document.createElement('div');
el.className = 'lb-live-banner';
el.setAttribute('role', 'note');
board.parentNode.insertBefore(el, board);
liveBannerEl = el;
}
const win = data.live_window || '7d';
liveBannerEl.innerHTML = `
<span class="lb-stale-dot" aria-hidden="true"></span>
<span class="lb-live-banner-text">No three.ws agent has a verified track record in this window yet — showing the <strong>live top Solana traders</strong> (${escapeHtml(win)}, via kolscan). <a href="/create-agent">Launch an agent</a> to earn your spot on the provable board.</span>`;
liveBannerEl.hidden = false;
}
function clearLiveBanner() {
if (liveBannerEl) liveBannerEl.hidden = true;
}
function staggerRows(rows) {
rows.querySelectorAll('.lb-row').forEach((el, i) => { el.style.animationDelay = `${Math.min(i, 12) * 22}ms`; });
}
// Update a summary cell's <dt> label so the same strip reads correctly in both
// the agent-track-record mode and the live-market fallback.
function summaryLabel(ddId, text) {
const dt = document.getElementById(ddId)?.closest('.lb-summary-cell')?.querySelector('dt');
if (dt) dt.textContent = text;
}
// Count a summary tile from its previously-shown real value to the new one and
// flash the direction of change. Non-numeric / missing → static dash, and the
// tracked value is cleared so the next real number doesn't count from a stale one.
const intFmt = (n) => String(Math.round(n));
function setSummaryNum(el, value, format) {
if (!el) return;
if (value == null || !Number.isFinite(value)) { el.textContent = '—'; delete el.dataset.juiceVal; return; }
updateValue(el, value, format);
}
function setSummaryStr(el, str) {
if (!el) return;
el.textContent = str;
delete el.dataset.juiceVal;
}
function renderSummary(data) {
const agents = data.leaderboard || [];
const live = data.live_traders || [];
const isLive = !agents.length && live.length > 0;
setSummaryNum($('#lb-sum-sol'), data.sol_usd || null, (n) => `$${Math.round(n)}`);
if (isLive) {
const top = live[0];
summaryLabel('lb-sum-traders', 'Live traders');
summaryLabel('lb-sum-verified', 'Source');
setSummaryNum($('#lb-sum-traders'), live.length, intFmt);
setSummaryStr($('#lb-sum-verified'), 'kolscan');
const topSol = top && top.realized_pnl_sol != null;
setSummaryNum($('#lb-sum-top'), top ? (topSol ? top.realized_pnl_sol : top.realized_pnl_usd) : null, topSol ? fmtSol : fmtUsd);
return;
}
summaryLabel('lb-sum-traders', 'Ranked traders');
summaryLabel('lb-sum-verified', 'Verified');
setSummaryNum($('#lb-sum-traders'), agents.length, intFmt);
setSummaryNum($('#lb-sum-verified'), agents.filter((r) => r.verified).length, intFmt);
const top = agents[0];
setSummaryNum($('#lb-sum-top'), top ? top.realized_pnl_sol : null, fmtSol);
}
// --- Most Profitable Trader spotlight ----------------------------------------
// A hero card for the single most profitable provable agent in the window —
// avatar, realized P&L, and the coin they made it on. Only shown for real agent
// records with a positive realized P&L; hidden in the live-fallback mode (those
// external wallets have no three.ws profile to spotlight) and when nobody is up.
const WINDOW_LABEL = { '24h': '24h', '7d': '7d', '30d': '30d', all: 'all-time' };
function renderSpotlight(data) {
const el = document.getElementById('lb-spotlight');
if (!el) return;
const agents = data.leaderboard || [];
const top = [...agents]
.filter((a) => a.realized_pnl_sol > 0)
.sort((a, b) => b.realized_pnl_sol - a.realized_pnl_sol)[0];
if (!top) { el.hidden = true; el.innerHTML = ''; return; }
const img = top.image || identicon(top.agent_id || top.wallet || top.agent_name || '?');
const href = `/trader/${encodeURIComponent(top.agent_id)}`;
const name = escapeHtml(top.agent_name || 'Unnamed agent');
const usd = top.realized_pnl_usd != null ? ` · ${fmtUsd(top.realized_pnl_usd)}` : '';
const coin = top.top_coin
? `<div class="lb-spot-coin"><span class="lb-spot-coin-lead">${top.top_coin.pnl_sol >= 0 ? 'Made it on' : 'Biggest hit'}</span> ${signatureCoin(top.top_coin, { compact: true })}</div>`
: '';
const label = `Most profitable trader: ${top.agent_name || 'agent'}, ${fmtSol(top.realized_pnl_sol)} realized${top.top_coin && top.top_coin.symbol ? `, made on ${top.top_coin.symbol}` : ''}`;
el.innerHTML = `
<a class="lb-spot-card" href="${href}" aria-label="${escapeHtml(label)}">
<div class="lb-spot-tag"><span class="lb-spot-crown" aria-hidden="true">♛</span> Most profitable trader · ${escapeHtml(WINDOW_LABEL[state.window] || state.window)}</div>
<div class="lb-spot-body">
<img class="lb-spot-av" src="${escapeHtml(img)}" alt="" loading="lazy" data-fallback-src="${identicon(top.agent_id || '?')}" />
<div class="lb-spot-main">
<div class="lb-spot-name">${name}${verifiedBadge(top.verified)}</div>
${coin}
</div>
<div class="lb-spot-pnl">
<div class="lb-spot-pnl-val ${pnlClass(top.realized_pnl_sol)}">${fmtSol(top.realized_pnl_sol)}</div>
<div class="lb-spot-pnl-sub">${fmtPct(top.win_rate * 100)} win rate${usd}</div>
</div>
<span class="lb-spot-cta">Track record →</span>
</div>
</a>`;
el.hidden = false;
}
function renderTicker(trades) {
const el = $('#lb-ticker');
// No internal closes (e.g. while the live fallback board is showing) — hide the
// whole "Latest closes" aside rather than leave a hollow "No closes yet." panel.
const wrap = el.closest('.lb-ticker-wrap');
if (!trades || !trades.length) {
el.innerHTML = '';
if (wrap) wrap.hidden = true;
return;
}
if (wrap) wrap.hidden = false;
el.innerHTML = trades.slice(0, 16).map((t) => {
const url = t.sell_url || t.buy_url || '#';
const pnl = t.pnl_sol != null ? `<span class="lb-tick-pnl ${pnlClass(t.pnl_sol)}">${fmtSol(t.pnl_sol)}</span>` : '';
return `<a class="lb-tick" href="${escapeHtml(url)}" target="_blank" rel="noopener" title="View on Solscan">
<span class="lb-tick-top"><span class="lb-tick-sym">${escapeHtml(t.symbol || t.name || '—')}</span>${pnl}</span>
<span class="lb-tick-meta">${escapeHtml(t.agent_name || 'agent')} · ${escapeHtml(t.exit_reason || '')} · ${relTime(t.at)}</span>
</a>`;
}).join('');
}
function renderBoard(data) {
const board = $('.lb-board');
const rows = $('#lb-rows');
const stateEl = $('#lb-state');
const agents = data.leaderboard || [];
const live = data.live_traders || [];
board.setAttribute('aria-busy', 'false');
// First paint staggers rows in; subsequent refreshes/sorts FLIP-animate rows to
// their new rank instead of re-flashing the whole board (the --reflow class
// suppresses the per-row entrance animation while standings settle in place).
const initial = firstLoad;
// 1. Provable three.ws agent track records take precedence.
if (agents.length) {
setBoardMode(false);
clearLiveBanner();
stateEl.innerHTML = '';
const flip = initial ? null : flipReorder(rows, (el) => el.dataset.key || '');
flip?.capture();
rows.classList.toggle('lb-rows--reflow', !initial);
rows.innerHTML = agents.map(rowMarkup).join('');
// Wire the wallet chips' copy + Tip actions. The board is public — viewers
// don't own these traders' agents — so chips render isOwner:false (◎ Tip).
wireWalletChips(rows);
if (initial) staggerRows(rows);
flip?.play();
return;
}
// 2. Live fallback: real top Solana traders from kolscan, so the flagship is
// never an empty void before the first agent earns a record.
if (live.length) {
setBoardMode(true);
showLiveBanner(data);
stateEl.innerHTML = '';
const flip = initial ? null : flipReorder(rows, (el) => el.dataset.key || '');
flip?.capture();
rows.classList.toggle('lb-rows--reflow', !initial);
rows.innerHTML = sortLive(live, state.sort).map(liveRowMarkup).join('');
if (initial) staggerRows(rows);
flip?.play();
return;
}
// 3. Genuinely nothing — devnet, or the live source is momentarily unreachable.
setBoardMode(false);
clearLiveBanner();
rows.innerHTML = '';
const liveDown = state.network === 'mainnet';
stateEl.innerHTML = `
<div class="lb-state-title">No ranked traders yet</div>
<p>${liveDown
? 'No agent has a track record in this window yet, and the live trader feed is momentarily unreachable.'
: `No agent has closed a sniper position in this window${state.verified ? ' that meets the verified bar' : ''}.`}
Widen the window, turn off “verified only”, or be the first.</p>
<a class="lb-btn lb-btn-primary" href="/create-agent">Launch a trader</a>`;
}
// --- Fetch -------------------------------------------------------------------
async function load() {
if (state.tab === 'earned') {
const ok = await loadEarned(state.window);
setLiveDot($('#lb-live'), ok ? 'live' : 'connecting', ok ? 'live' : 'reconnecting');
return;
}
const board = $('.lb-board');
if (firstLoad) { $('#lb-rows').innerHTML = skeletonRows(); board.setAttribute('aria-busy', 'true'); }
const qs = new URLSearchParams({ network: state.network, window: state.window, sort: state.sort });
if (state.verified) qs.set('verified', '1');
try {
const res = await fetch(`${API}?${qs}`, { headers: { accept: 'application/json' } });
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const data = await res.json();
renderSummary(data);
renderSpotlight(data);
renderBoard(data);
renderTicker(data.trades);
firstLoad = false;
clearStale();
setLiveDot($('#lb-live'), 'live', 'live');
} catch (err) {
board.setAttribute('aria-busy', 'false');
if (firstLoad) {
setLiveDot($('#lb-live'), 'error', 'offline');
$('#lb-rows').innerHTML = '';
$('#lb-state').innerHTML = `
<div class="lb-state-title">Couldn’t load the leaderboard</div>
<p>The track-record feed didn’t respond. This is usually transient.</p>
<button class="lb-btn lb-btn-primary" id="lb-retry">Retry</button>`;
$('#lb-retry')?.addEventListener('click', () => load());
} else {
// On a refresh failure we keep the last good board on screen — no
// flicker — but flag it as stale so the standings aren't trusted blindly.
showStale();
setLiveDot($('#lb-live'), 'connecting', 'reconnecting');
}
}
}
// --- Controls ----------------------------------------------------------------
function setActive(group, attr, value) {
group.querySelectorAll('.lb-seg-btn').forEach((b) => {
const on = b.dataset[attr] === value;
b.classList.toggle('is-active', on);
b.setAttribute('aria-selected', on ? 'true' : 'false');
});
}
// --- Tabs --------------------------------------------------------------------
// The <title> carries an i18n key for the trading board; the Earned board's
// title is set here, with the key parked so a locale pass cannot overwrite it.
const titleEl = document.querySelector('title');
const titleKey = titleEl?.getAttribute('data-i18n') || null;
const tradingTitle = document.title;
function applyTab() {
document.body.dataset.lbTab = state.tab;
setActive($('#lb-tab'), 'tab', state.tab);
if (state.tab === 'earned') {
titleEl?.removeAttribute('data-i18n');
document.title = 'Earnings Leaderboard · three.ws';
} else {
if (titleKey) titleEl?.setAttribute('data-i18n', titleKey);
document.title = tradingTitle;
}
}
function wireControls() {
const tabGroup = $('#lb-tab');
tabGroup.addEventListener('click', (e) => {
const btn = e.target.closest('.lb-seg-btn');
if (!btn || btn.dataset.tab === state.tab) return;
state.tab = btn.dataset.tab;
applyTab();
firstLoad = true; writeUrl(); load(); startTimer();
});
// Arrow keys move between the two tabs, as a tablist should.
tabGroup.addEventListener('keydown', (e) => {
if (e.key !== 'ArrowLeft' && e.key !== 'ArrowRight') return;
const tabs = [...tabGroup.querySelectorAll('.lb-seg-btn')];
const next = tabs[(tabs.indexOf(document.activeElement) + (e.key === 'ArrowRight' ? 1 : -1) + tabs.length) % tabs.length];
next?.focus();
next?.click();
});
const winGroup = $('#lb-window');
winGroup.addEventListener('click', (e) => {
const btn = e.target.closest('.lb-seg-btn');
if (!btn) return;
state.window = btn.dataset.window;
setActive(winGroup, 'window', state.window);
firstLoad = true; writeUrl(); load();
});
const netGroup = $('#lb-network');
netGroup.addEventListener('click', (e) => {
const btn = e.target.closest('.lb-seg-btn');
if (!btn) return;
state.network = btn.dataset.network;
setActive(netGroup, 'network', state.network);
firstLoad = true; writeUrl(); load();
});
$('#lb-sort').addEventListener('change', (e) => {
state.sort = SORTS.has(e.target.value) ? e.target.value : 'score';
writeUrl(); load();
});
$('#lb-verified').addEventListener('change', (e) => {
state.verified = e.target.checked;
writeUrl(); load();
});
const howto = $('#lb-howto-toggle');
howto.addEventListener('click', () => {
const open = howto.getAttribute('aria-expanded') === 'true';
howto.setAttribute('aria-expanded', String(!open));
$('#lb-howto-body').hidden = open;
});
}
function syncControlsToState() {
applyTab();
setActive($('#lb-window'), 'window', state.window);
setActive($('#lb-network'), 'network', state.network);
$('#lb-sort').value = state.sort;
$('#lb-verified').checked = state.verified;
}
// --- Live refresh ------------------------------------------------------------
function startTimer() {
stopTimer();
timer = setInterval(() => { if (!document.hidden) load(); }, state.tab === 'earned' ? EARNED_REFRESH_MS : REFRESH_MS);
}
function stopTimer() { if (timer) { clearInterval(timer); timer = null; } }
document.addEventListener('visibilitychange', () => { if (!document.hidden) load(); });
// --- Ambient field -----------------------------------------------------------
function ambientField() {
const canvas = document.getElementById('lb-field');
if (!canvas || matchMedia('(prefers-reduced-motion: reduce)').matches) return;
const ctx = canvas.getContext('2d');
let w, h, dots, raf;
const resize = () => {
w = canvas.width = innerWidth;
h = canvas.height = innerHeight;
dots = Array.from({ length: Math.min(60, Math.floor(w / 26)) }, () => ({
x: Math.random() * w, y: Math.random() * h,
vx: (Math.random() - 0.5) * 0.18, vy: (Math.random() - 0.5) * 0.18,
r: Math.random() * 1.4 + 0.4,
}));
};
const draw = () => {
ctx.clearRect(0, 0, w, h);
ctx.fillStyle = 'rgba(140,160,255,0.35)';
for (const d of dots) {
d.x = (d.x + d.vx + w) % w;
d.y = (d.y + d.vy + h) % h;
ctx.beginPath();
ctx.arc(d.x, d.y, d.r, 0, Math.PI * 2);
ctx.fill();
}
raf = requestAnimationFrame(draw);
};
addEventListener('resize', resize, { passive: true });
document.addEventListener('visibilitychange', () => {
if (document.hidden) cancelAnimationFrame(raf);
else raf = requestAnimationFrame(draw);
});
resize();
draw();
}
// --- Oracle Conviction Rankings -------------------------------------------
async function loadOracleLeaderboard() {
const container = document.getElementById('lb-oracle-rows');
if (!container) return;
container.innerHTML = [1, 2, 3, 4, 5].map(() => '<span class="lb-oracle-sk"></span>').join('');
container.setAttribute('aria-busy', 'true');
let data;
try {
const r = await fetch('/api/oracle/leaderboard?network=mainnet&limit=10&min_actions=3');
if (!r.ok) throw new Error(`HTTP ${r.status}`);
data = await r.json();
} catch {
container.innerHTML = `<div class="lb-oracle-empty">Could not load conviction rankings — <a href="/oracle">browse Oracle →</a></div>`;
container.setAttribute('aria-busy', 'false');
return;
}
const agents = data.agents || [];
if (agents.length === 0) {
container.innerHTML = `<div class="lb-oracle-empty">No agents with enough resolved conviction calls yet. <a href="/oracle">Explore Oracle →</a></div>`;
container.setAttribute('aria-busy', 'false');
return;
}
container.innerHTML = '';
for (const a of agents) {
// identicon() returns a data-URI for an <img src>, and it must never be dropped
// into element text (that renders the raw "data:image/svg+xml…" string).
const img = `<img class="lb-avatar" src="${escapeHtml(a.image_url || identicon(a.agent_id))}" alt="" loading="lazy" data-fallback-src="${identicon(a.agent_id)}" />`;
const name = escapeHtml(a.name || a.agent_id.slice(0, 8) + '…');
const wr = a.win_rate != null
? `<span class="${a.win_rate >= 60 ? 'lb-pos' : a.win_rate >= 40 ? '' : 'lb-neg'}">${a.win_rate}%</span>`
: '—';
const wl = `${a.wins}W · ${a.losses}L${a.open > 0 ? ` · ${a.open}↗` : ''}`;
const pnl = a.realized_pnl_sol != null
? `<span class="${pnlClass(a.realized_pnl_sol)}">${fmtSol(a.realized_pnl_sol)}</span>`
: '—';
const roi = a.roi_pct != null
? `<span class="${pnlClass(a.roi_pct)}">${a.roi_pct > 0 ? '+' : ''}${a.roi_pct}%</span>`
: '—';
const row = document.createElement('div');
row.className = 'lb-oracle-row';
row.setAttribute('data-rank', String(a.rank));
const traderHref = `/trader/${encodeURIComponent(a.agent_id)}`;
const profileHref = `/agents/${encodeURIComponent(a.agent_id)}`;
const plainName = a.name || `${a.agent_id.slice(0, 8)}…`;
const wrText = a.win_rate != null ? `${a.win_rate}% conviction win rate` : 'win rate pending';
row.setAttribute('aria-label', `Rank ${a.rank}: ${plainName}, ${wrText}`);
row.innerHTML = `
<span class="lb-rank">${a.rank}</span>
<a class="lb-trader lb-oracle-trader-link" href="${profileHref}">${img}<span class="lb-trader-meta"><span class="lb-trader-name"><span class="lb-trader-nm">${name}</span></span></span></a>
<span class="lb-col-num">${wr}</span>
<span class="lb-col-num lb-hide-sm lb-oracle-record">${wl}</span>
<span class="lb-col-num lb-hide-sm">${pnl}</span>
<span class="lb-col-num lb-hide-sm">${roi}</span>
<span class="lb-col-num lb-oracle-act"><a class="lb-btn lb-btn-primary lb-oracle-copy" href="${traderHref}#tp-copy-panel" aria-label="Copy ${escapeHtml(plainName)}">Copy →</a></span>
`;
container.appendChild(row);
}
container.setAttribute('aria-busy', 'false');
}
// --- Boot --------------------------------------------------------------------
readUrl();
syncControlsToState();
wireControls();
wireEarned();
ambientField();
load();
startTimer();
loadOracleLeaderboard();