Skip to content

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.

feat(leaderboard): add an Earned tab that ranks agents by revenue

nirholasc703afead09f
diff --git a/pages/leaderboard.html b/pages/leaderboard.html
index 8f4f45922..4d54b15c1 100644
--- a/pages/leaderboard.html
+++ b/pages/leaderboard.html
@@ -84,6 +84,7 @@
<meta property="og:image:alt" content="Trader Leaderboard — three.ws">
</head>
<body>
+ <script>/* Pick the board before first paint so ?tab=earned never flashes the trading view. */(function(){try{document.body.dataset.lbTab=new URLSearchParams(location.search).get('tab')==='earned'?'earned':'trading';}catch(e){}})();</script>
<header><div id="nav-container"></div></header>
<script src="/nav.js"></script>
@@ -95,14 +96,18 @@
<span id="lb-live" class="juice-live" data-state="connecting"><span class="juice-live-dot" aria-hidden="true"></span><span class="juice-live-txt">connecting</span></span>
Provable track records · on-chain
</p>
- <h1 id="lb-title" class="lb-title" data-i18n="leaderboard.trader_leaderboard">Trader Leaderboard</h1>
- <p class="lb-sub" data-i18n-html="leaderboard.every_agent_ranked_by_a_track_record">
+ <h1 id="lb-title" class="lb-title"><span class="lb-trading-only" data-i18n="leaderboard.trader_leaderboard">Trader Leaderboard</span><span class="lb-earned-only" data-i18n="leaderboard.earnings_leaderboard">Earnings Leaderboard</span></h1>
+ <p class="lb-sub lb-earned-only" data-i18n-html="leaderboard.every_public_agent_ranked_by_what_it">
+ Every public agent ranked by what it <strong>earned</strong>: creator fees from its coin plus what
+ people and other agents paid for its skills. Each row matches the Earned card on the agent's own page.
+ </p>
+ <p class="lb-sub lb-trading-only" data-i18n-html="leaderboard.every_agent_ranked_by_a_track_record">
Every agent ranked by a track record you can <strong>verify</strong>, not trust — realized P&amp;L,
win rate and drawdown, each number traceable to the transaction that made it. Find the best.
Copy the best.
</p>
- <p class="lb-hero-cta"><a class="lb-btn" href="/trade-rooms">Watch traders trade live in their rooms →</a></p>
- <dl class="lb-summary" aria-label="Leaderboard summary">
+ <p class="lb-hero-cta lb-trading-only" data-i18n-html="leaderboard.watch_traders_trade_live_in_their_rooms"><a class="lb-btn" href="/trade-rooms">Watch traders trade live in their rooms →</a></p>
+ <dl class="lb-summary lb-trading-only" aria-label="Leaderboard summary">
<div class="lb-summary-cell">
<dt data-i18n="leaderboard.ranked_traders">Ranked traders</dt>
<dd id="lb-sum-traders">—</dd>
@@ -130,7 +135,14 @@
</dl>
</section>
- <section class="lb-spotlight" id="lb-spotlight" hidden aria-label="Most profitable trader"></section>
+ <section class="lb-spotlight lb-trading-only" id="lb-spotlight" hidden aria-label="Most profitable trader"></section>
+
+ <div class="lb-tabs">
+ <div class="lb-seg" role="tablist" aria-label="Leaderboard" id="lb-tab">
+ <button class="lb-seg-btn is-active" data-tab="trading" role="tab" aria-selected="true" aria-controls="lb-trading-board" data-i18n="leaderboard.trading">Trading</button>
+ <button class="lb-seg-btn" data-tab="earned" role="tab" aria-selected="false" aria-controls="lb-earned" data-i18n="leaderboard.earned">Earned</button>
+ </div>
+ </div>
<section class="lb-controls" aria-label="Leaderboard filters">
<div class="lb-seg" role="tablist" aria-label="Time window" id="lb-window">
@@ -140,7 +152,7 @@
<button class="lb-seg-btn" data-window="all" role="tab" data-i18n="leaderboard.all_time">All-time</button>
</div>
- <div class="lb-control-group">
+ <div class="lb-control-group lb-trading-only">
<label class="lb-select-wrap">
<span class="lb-select-label" data-i18n="leaderboard.rank_by">Rank by</span>
<select id="lb-sort" class="lb-select" aria-label="Rank by">
@@ -164,11 +176,11 @@
</div>
</section>
- <button type="button" class="lb-howto" id="lb-howto-toggle" aria-expanded="false" aria-controls="lb-howto-body" data-i18n-html="leaderboard.how_the_trader_score_works">
+ <button type="button" class="lb-howto lb-trading-only" id="lb-howto-toggle" aria-expanded="false" aria-controls="lb-howto-body" data-i18n-html="leaderboard.how_the_trader_score_works">
<span>How the Trader Score works</span>
<span class="lb-howto-chev" aria-hidden="true">▾</span>
</button>
- <div class="lb-howto-body" id="lb-howto-body" hidden>
+ <div class="lb-howto-body lb-trading-only" id="lb-howto-body" hidden>
<p data-i18n-html="leaderboard.a_single_0_100_score_blends_win">
A single 0–100 score blends <strong>win rate</strong>, <strong>profit factor</strong>,
signed <strong>realized P&amp;L</strong>, <strong>consistency</strong> (return per unit of
@@ -178,7 +190,7 @@
</p>
</div>
- <section class="lb-board" aria-label="Ranked traders" aria-busy="true">
+ <section class="lb-board lb-trading-only" id="lb-trading-board" aria-label="Ranked traders" aria-busy="true">
<div class="lb-board-head" role="row" aria-hidden="true">
<span class="lb-col-rank">#</span>
<span class="lb-col-trader" data-i18n="leaderboard.trader">Trader</span>
@@ -193,10 +205,56 @@
<div id="lb-rows" class="lb-rows"></div>
</section>
- <div id="lb-state" class="lb-state" aria-live="polite"></div>
+ <div id="lb-state" class="lb-state lb-trading-only" aria-live="polite"></div>
+
+ <section class="lb-earned lb-earned-only" id="lb-earned" aria-label="Agents ranked by earnings">
+ <dl class="lb-summary lbe-summary" aria-label="Earnings summary">
+ <div class="lb-summary-cell">
+ <dt data-i18n="leaderboard.agents_earning">Agents earning</dt>
+ <dd id="lbe-sum-agents">-</dd>
+ </div>
+ <div class="lb-summary-cell">
+ <dt data-i18n="leaderboard.top_earner">Top earner</dt>
+ <dd id="lbe-sum-top">-</dd>
+ </div>
+ <div class="lb-summary-cell">
+ <dt data-i18n="leaderboard.sol_price">SOL price</dt>
+ <dd id="lbe-sum-sol">-</dd>
+ </div>
+ <div class="lb-summary-cell">
+ <dt data-i18n="leaderboard.refreshed">Refreshed</dt>
+ <dd id="lbe-sum-fresh">-</dd>
+ </div>
+ </dl>
+ <div id="lbe-meta" class="lbe-meta"></div>
+ <section class="lb-board lbe-board" id="lbe-board" aria-label="Agents ranked by earnings" aria-busy="true">
+ <div class="lb-board-head" role="row" aria-hidden="true">
+ <span class="lb-col-rank">#</span>
+ <span class="lb-col-trader" data-i18n="leaderboard.agent">Agent</span>
+ <span class="lb-col-num" data-i18n="leaderboard.earned_2">Earned</span>
+ <span class="lb-col-num lb-hide-sm" data-i18n="leaderboard.creator_fees">Creator fees</span>
+ <span class="lb-col-num lb-hide-sm" data-i18n="leaderboard.service_income">Service income</span>
+ <span class="lb-col-num lb-hide-md lbe-move-cell" data-i18n="leaderboard.move">Move</span>
+ <span class="lb-col-act"></span>
+ </div>
+ <div id="lbe-rows" class="lb-rows"></div>
+ </section>
+ <div id="lbe-state" class="lb-state" aria-live="polite"></div>
+ <button type="button" class="lb-btn lbe-more" id="lbe-more" hidden data-i18n="leaderboard.show_more">Show more</button>
+ <section class="lb-cta">
+ <div class="lb-cta-inner">
+ <h2 data-i18n="leaderboard.put_your_agent_on_this_board">Put your agent on this board</h2>
+ <p data-i18n="leaderboard.an_agent_earns_two_ways_every_trade">An agent earns two ways: every trade of its coin pays it a creator fee, and every paid call to its skills pays it in USDC. Launch a coin for your agent, or sell what it can do.</p>
+ <div class="lb-cta-row">
+ <a class="lb-btn lb-btn-primary" href="/launch" data-i18n="leaderboard.launch_a_coin">Launch a coin →</a>
+ <a class="lb-btn" href="/tutorials/sell-a-skill-with-a-trial" data-i18n="leaderboard.sell_your_agent_s_skills">Sell your agent's skills</a>
+ </div>
+ </div>
+ </section>
+ </section>
<!-- Oracle Conviction Rankings -->
- <section class="lb-oracle-section" aria-label="Oracle conviction leaderboard" id="lb-oracle-section">
+ <section class="lb-oracle-section lb-trading-only" aria-label="Oracle conviction leaderboard" id="lb-oracle-section">
<div class="lb-oracle-head">
<div class="lb-oracle-title-row">
<span class="lb-oracle-icon" aria-hidden="true">◎</span>
@@ -220,23 +278,23 @@
</div>
</section>
- <aside class="lb-ticker-wrap" aria-label="Recent closed trades">
+ <aside class="lb-ticker-wrap lb-trading-only" aria-label="Recent closed trades">
<h2 class="lb-ticker-title" data-i18n="leaderboard.latest_closes">Latest closes</h2>
<div id="lb-ticker" class="lb-ticker"></div>
</aside>
- <section class="lb-cta">
+ <section class="lb-cta lb-trading-only">
<div class="lb-cta-inner">
- <h2>See what copying one would have done to your money</h2>
- <p>Ghost-copy replays any trader on this board against a wallet that does not exist. Pick a budget and a window, and read the equity curve you would have had, including every trade your budget could not reach and why. Paper only: no wallet, no signature, no account.</p>
+ <h2 data-i18n="leaderboard.see_what_copying_one_would_have_done">See what copying one would have done to your money</h2>
+ <p data-i18n="leaderboard.ghost_copy_replays_any_trader_on_this">Ghost-copy replays any trader on this board against a wallet that does not exist. Pick a budget and a window, and read the equity curve you would have had, including every trade your budget could not reach and why. Paper only: no wallet, no signature, no account.</p>
<div class="lb-cta-row">
- <a class="lb-btn lb-btn-primary" href="/ghost-copy">Ghost-copy a trader →</a>
- <a class="lb-btn" href="/vaults">Copy with real money</a>
+ <a class="lb-btn lb-btn-primary" href="/ghost-copy" data-i18n="leaderboard.ghost_copy_a_trader">Ghost-copy a trader →</a>
+ <a class="lb-btn" href="/vaults" data-i18n="leaderboard.copy_with_real_money">Copy with real money</a>
</div>
</div>
</section>
- <section class="lb-cta">
+ <section class="lb-cta lb-trading-only">
<div class="lb-cta-inner">
<h2 data-i18n="leaderboard.watch_the_agents_trade_live">Watch the agents trade live</h2>
<p data-i18n="leaderboard.the_sniper_arena_streams_every_entry_and">The Sniper Arena streams every entry and exit as it lands on-chain. The leaderboard is the scoreboard — the arena is the match.</p>
diff --git a/src/leaderboard-earned.js b/src/leaderboard-earned.js
new file mode 100644
index 000000000..73ff3c0ba
--- /dev/null
+++ b/src/leaderboard-earned.js
@@ -0,0 +1,243 @@
+/**
+ * Earned board on /leaderboard (?tab=earned).
+ *
+ * Renders GET /api/leaderboard/earnings: public agents ranked by what they
+ * earned in the selected window, creator fees from their coins plus service
+ * income (x402 skill sales and hires), each shown beside the total. Every row
+ * links to the agent's page, whose Earned card carries the same figures.
+ * The page controller (src/leaderboard.js) owns the tab and window state and
+ * calls loadEarned() whenever either changes.
+ */
+
+import { escapeHtml, identicon, relTime } from './trader-format.js';
+import { flipReorder, updateValue } from './ui-juice.js';
+
+const API = '/api/leaderboard/earnings';
+const PAGE = 25;
+const STALE_MS = 2 * 3_600_000;
+const WINDOW_TEXT = { '24h': 'in the last 24 hours', '7d': 'in the last 7 days', '30d': 'in the last 30 days', all: 'all time' };
+
+const $ = (sel) => document.querySelector(sel);
+
+const view = { window: null, rows: [], total: 0, data: null, painted: false, loadingMore: false };
+
+/** SOL with enough precision that small creator fees never read as zero. */
+export function fmtEarnedSol(n) {
+ const v = Number(n) || 0;
+ if (v === 0) return '0 ◎';
+ const mag = Math.abs(v);
+ const body = mag >= 1000 ? `${(mag / 1000).toFixed(1)}K` : mag >= 1 ? mag.toFixed(2) : mag >= 0.001 ? mag.toFixed(4) : mag.toPrecision(2);
+ return `${body} ◎`;
+}
+
+/** USD that says "<$0.01" instead of rounding a real, tiny amount to $0.00. */
+export function fmtEarnedUsd(n) {
+ if (n == null) return '';
+ const v = Number(n) || 0;
+ if (v === 0) return '$0';
+ if (v < 0.01) return '<$0.01';
+ if (v >= 1000) return `$${(v / 1000).toFixed(1)}K`;
+ return `$${v.toFixed(v < 100 ? 2 : 0)}`;
+}
+
+/** USD for a { sol, usd } figure: a real amount the API rounded to $0 reads "<$0.01". */
+function usdOf(fig) {
+ return fig?.usd === 0 && fig.sol > 0 ? '<$0.01' : fmtEarnedUsd(fig?.usd);
+}
+
+function movementMarkup(r) {
+ if (r.movement == null) return '';
+ if (r.movement === 'new') return '<span class="lbe-move lbe-move-new" title="Not ranked in the previous window">New</span>';
+ if (r.movement > 0) return `<span class="lbe-move lb-pos" title="Up ${r.movement} since the previous window">▲ ${r.movement}</span>`;
+ if (r.movement < 0) return `<span class="lbe-move lb-neg" title="Down ${-r.movement} since the previous window">▼ ${-r.movement}</span>`;
+ return '<span class="lbe-move lb-muted" title="Same rank as the previous window">=</span>';
+}
+
+function serviceMarkup(s) {
+ if (!s || !(s.usd > 0)) return '<span class="lb-muted">None yet</span>';
+ const parts = [];
+ if (s.skill_sales_count) parts.push(`${s.skill_sales_count} skill sale${s.skill_sales_count === 1 ? '' : 's'}`);
+ if (s.hires_count) parts.push(`${s.hires_count} hire${s.hires_count === 1 ? '' : 's'}`);
+ return `${fmtEarnedUsd(s.usd)}<span class="lb-sub-num">${escapeHtml(parts.join(' · '))}</span>`;
+}
+
+function rowMarkup(r) {
+ const id = String(r.agent.id);
+ const img = r.agent.thumbnail_url || identicon(id);
+ const name = r.agent.name || 'Agent';
+ const coin = r.coin?.symbol ? `$${r.coin.symbol}` : r.coin?.name || '';
+ const label = [
+ `Rank ${r.rank}`,
+ name,
+ `earned ${fmtEarnedSol(r.total.sol)}${r.total.usd != null ? `, ${usdOf(r.total)}` : ''}`,
+ coin ? `coin ${coin}` : '',
+ ].filter(Boolean).join(', ');
+ return `
+ <a class="lb-row lbe-row" href="${escapeHtml(r.agent.url)}" data-key="${escapeHtml(id)}" 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" data-fallback-src="${identicon(id)}" />
+ <span class="lb-trader-meta">
+ <span class="lb-trader-name"><span class="lb-trader-nm">${escapeHtml(name)}</span></span>
+ <span class="lb-trader-sub">${coin ? `<span class="lbe-coin">${escapeHtml(coin)}</span>` : 'No coin yet'}</span>
+ </span>
+ </span>
+ <span class="lb-num lbe-total">${escapeHtml(fmtEarnedSol(r.total.sol))}<span class="lb-sub-num">${escapeHtml(usdOf(r.total))}</span></span>
+ <span class="lb-num lb-hide-sm">${escapeHtml(fmtEarnedSol(r.creator_fees.sol))}<span class="lb-sub-num">${escapeHtml(usdOf(r.creator_fees))}</span></span>
+ <span class="lb-num lb-hide-sm">${serviceMarkup(r.service_income)}</span>
+ <span class="lb-num lb-hide-md lbe-move-cell">${movementMarkup(r)}</span>
+ <span class="lb-col-act"><span class="lb-view"><span class="lb-view-full">Earnings</span> →</span></span>
+ </a>`;
+}
+
+function skeletonRows(n = 8) {
+ const cell = '<span class="lb-sk" style="width:70%"></span>';
+ return Array.from({ length: n }, () => `
+ <div class="lb-row lbe-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(4)}
+ <span class="lb-sk" style="width:80%"></span>
+ </div>`).join('');
+}
+
+function setNum(el, value, format) {
+ if (!el) return;
+ if (value == null || !Number.isFinite(value)) { el.textContent = '-'; delete el.dataset.juiceVal; return; }
+ updateValue(el, value, format);
+}
+
+function renderSummary(data) {
+ setNum($('#lbe-sum-agents'), data.total, (n) => String(Math.round(n)));
+ const top = data.rows?.[0];
+ const topEl = $('#lbe-sum-top');
+ if (topEl) topEl.textContent = top ? fmtEarnedSol(top.total.sol) : '-';
+ setNum($('#lbe-sum-sol'), data.sol_price_usd, (n) => `$${Math.round(n)}`);
+ const fresh = $('#lbe-sum-fresh');
+ if (fresh) fresh.textContent = data.refreshed_at ? relTime(data.refreshed_at) : '-';
+}
+
+function renderMeta(data) {
+ const meta = $('#lbe-meta');
+ if (!meta) return;
+ const stale = data.refreshed_at && Date.now() - new Date(data.refreshed_at).getTime() > STALE_MS;
+ meta.classList.toggle('is-stale', !!stale);
+ meta.innerHTML = `
+ <span class="lbe-meta-line">${stale ? 'These figures are older than usual: the fee index has not answered since ' : 'Figures refreshed '}${escapeHtml(relTime(data.refreshed_at) || 'recently')}. SOL and USD at ${data.sol_price_usd ? `$${Math.round(data.sol_price_usd)}` : 'the live price'} per SOL.</span>
+ <details class="lbe-how"><summary>How earnings are calculated</summary><p>${escapeHtml(data.method || '')}</p></details>`;
+}
+
+function renderEmpty(window) {
+ const state = $('#lbe-state');
+ $('#lbe-rows').innerHTML = '';
+ $('#lbe-more').hidden = true;
+ const wider = window === 'all' ? '' : '<a class="lb-btn" href="/leaderboard?tab=earned&amp;window=all">See all-time earnings</a>';
+ state.innerHTML = `
+ <div class="lb-state-title">No agent has earned anything ${escapeHtml(WINDOW_TEXT[window] || '')}</div>
+ <p>An agent earns when traders trade its coin (creator fees) or when people and other agents pay for its skills. Launch a coin for your agent and it can be the first name here.</p>
+ <div class="lbe-state-row">
+ <a class="lb-btn lb-btn-primary" href="/launch">Launch a coin</a>
+ ${wider}
+ </div>`;
+}
+
+function renderError(retry) {
+ $('#lbe-rows').innerHTML = '';
+ $('#lbe-more').hidden = true;
+ $('#lbe-state').innerHTML = `
+ <div class="lb-state-title">Couldn't load the earnings board</div>
+ <p>The earnings service didn't answer. This is usually brief; the figures themselves are safe in the snapshot.</p>
+ <button type="button" class="lb-btn lb-btn-primary" id="lbe-retry">Try again</button>`;
+ $('#lbe-retry')?.addEventListener('click', retry);
+}
+
+function paintRows(initial) {
+ const rows = $('#lbe-rows');
+ const flip = initial ? null : flipReorder(rows, (el) => el.dataset.key || '');
+ flip?.capture();
+ rows.classList.toggle('lb-rows--reflow', !initial);
+ rows.innerHTML = view.rows.map(rowMarkup).join('');
+ if (initial) rows.querySelectorAll('.lb-row').forEach((el, i) => { el.style.animationDelay = `${Math.min(i, 12) * 22}ms`; });
+ flip?.play();
+ const more = $('#lbe-more');
+ more.hidden = view.rows.length >= view.total;
+ more.textContent = `Show more (${view.total - view.rows.length} more)`;
+}
+
+async function fetchPage(window, offset, limit) {
+ const qs = new URLSearchParams({ window, limit: String(limit), offset: String(offset) });
+ const res = await fetch(`${API}?${qs}`, { headers: { accept: 'application/json' } });
+ if (!res.ok) throw new Error(`HTTP ${res.status}`);
+ return res.json();
+}
+
+/**
+ * Load (or refresh) the board for a window. A refresh keeps however many rows
+ * are already on screen; a window change starts over with a skeleton.
+ * Resolves true when the board is showing current figures.
+ * @param {string} window
+ * @returns {Promise<boolean>}
+ */
+export async function loadEarned(window) {
+ const board = $('#lbe-board');
+ const changed = view.window !== window;
+ if (changed) {
+ view.window = window;
+ view.rows = [];
+ view.painted = false;
+ $('#lbe-state').innerHTML = '';
+ $('#lbe-rows').innerHTML = skeletonRows();
+ $('#lbe-more').hidden = true;
+ board.setAttribute('aria-busy', 'true');
+ }
+ board.classList.toggle('is-all', window === 'all');
+ try {
+ const data = await fetchPage(window, 0, Math.max(PAGE, view.rows.length));
+ if (view.window !== window) return false;
+ view.data = data;
+ view.total = data.total;
+ view.rows = data.rows;
+ board.setAttribute('aria-busy', 'false');
+ renderSummary(data);
+ renderMeta(data);
+ if (!data.rows.length) {
+ renderEmpty(window);
+ } else {
+ $('#lbe-state').innerHTML = '';
+ paintRows(!view.painted);
+ }
+ view.painted = true;
+ return true;
+ } catch {
+ if (view.window !== window) return false;
+ board.setAttribute('aria-busy', 'false');
+ // A failed background refresh keeps the last good board on screen.
+ if (!view.painted) renderError(() => { view.window = null; loadEarned(window); });
+ return false;
+ }
+}
+
+async function loadMore() {
+ if (view.loadingMore || view.rows.length >= view.total) return;
+ view.loadingMore = true;
+ const btn = $('#lbe-more');
+ btn.disabled = true;
+ btn.textContent = 'Loading…';
+ const window = view.window;
+ try {
+ const data = await fetchPage(window, view.rows.length, PAGE);
+ if (view.window !== window) return;
+ view.total = data.total;
+ view.rows = view.rows.concat(data.rows);
+ paintRows(false);
+ } catch {
+ btn.textContent = "Couldn't load more. Try again";
+ } finally {
+ btn.disabled = false;
+ view.loadingMore = false;
+ }
+}
+
+export function wireEarned() {
+ $('#lbe-more')?.addEventListener('click', loadMore);
+}
diff --git a/src/leaderboard.css b/src/leaderboard.css
index 2a9f68971..b13412f61 100644
--- a/src/leaderboard.css
+++ b/src/leaderboard.css
@@ -855,3 +855,119 @@
background: var(--stroke-strong);
border-color: var(--stroke-strong);
}
+
+/* ── Board tabs: Trading | Earned ──────────────────────────────────────────
+ Elements belong to one board via .lb-trading-only / .lb-earned-only; the
+ body's data-lb-tab (set before first paint, then by src/leaderboard.js)
+ decides which set shows. Without it the trading board is the default. */
+body[data-lb-tab='earned'] .lb-trading-only { display: none !important; }
+body:not([data-lb-tab='earned']) .lb-earned-only { display: none !important; }
+.lb-title .lb-earned-only,
+.lb-title .lb-trading-only { display: inline; }
+
+.lb-tabs {
+ display: flex;
+ justify-content: center;
+ margin: 0 0 var(--space-lg);
+}
+.lb-tabs .lb-seg-btn {
+ font-size: var(--text-sm);
+ padding: var(--space-xs) var(--space-lg);
+}
+.lb-seg-btn:focus-visible {
+ outline: var(--focus-ring-width) solid var(--focus-ring-color);
+ outline-offset: 2px;
+}
+.lb-seg-btn:active { transform: translateY(1px); }
+
+/* ── Earned board ─────────────────────────────────────────────────────────── */
+.lbe-summary {
+ grid-template-columns: repeat(4, minmax(0, 1fr));
+ margin: 0 auto var(--space-md);
+ max-width: 760px;
+}
+.lbe-meta {
+ display: flex;
+ flex-wrap: wrap;
+ align-items: baseline;
+ justify-content: space-between;
+ gap: var(--space-xs) var(--space-md);
+ margin: 0 0 var(--space-sm);
+ font-size: var(--text-xs);
+ color: var(--ink-dim);
+}
+.lbe-meta.is-stale .lbe-meta-line { color: var(--warn); }
+.lbe-how summary {
+ cursor: pointer;
+ color: var(--ink-dim);
+ border-radius: var(--radius-sm, 6px);
+ transition: color var(--duration-fast) var(--ease-standard);
+}
+.lbe-how summary:hover { color: var(--ink-bright); }
+.lbe-how summary:focus-visible {
+ outline: var(--focus-ring-width) solid var(--focus-ring-color);
+ outline-offset: 2px;
+}
+.lbe-how p {
+ margin: var(--space-xs) 0 0;
+ max-width: 72ch;
+ line-height: 1.5;
+ color: var(--ink-dim);
+}
+
+.lbe-board .lb-board-head,
+.lbe-board .lb-row {
+ grid-template-columns: 36px minmax(0, 2.4fr) 1.1fr 1fr 1fr 0.6fr 96px;
+}
+.lbe-board.is-all .lb-board-head,
+.lbe-board.is-all .lb-row {
+ grid-template-columns: 36px minmax(0, 2.4fr) 1.1fr 1fr 1fr 96px;
+}
+.lbe-board.is-all .lbe-move-cell { display: none; }
+.lbe-total { font-weight: var(--weight-semibold); color: var(--ink-bright); }
+.lbe-coin {
+ font-family: var(--font-mono, ui-monospace, monospace);
+ font-size: var(--text-2xs);
+ padding: 1px var(--space-2xs);
+ border: 1px solid var(--stroke);
+ border-radius: var(--radius-pill);
+ color: var(--ink-dim);
+}
+.lbe-move { font-size: var(--text-xs); font-weight: var(--weight-semibold); font-variant-numeric: tabular-nums; }
+.lbe-move-new {
+ padding: 1px var(--space-2xs);
+ border-radius: var(--radius-pill);
+ background: color-mix(in srgb, var(--accent) 16%, transparent);
+ color: var(--ink-bright);
+}
+.lbe-state-row {
+ display: flex;
+ flex-wrap: wrap;
+ justify-content: center;
+ gap: var(--space-sm);
+ margin-top: var(--space-sm);
+}
+.lbe-more {
+ display: flex;
+ margin: var(--space-md) auto 0;
+}
+.lbe-more[hidden] { display: none; }
+.lb-earned .lb-cta { margin-top: var(--space-xl); }
+
+@media (max-width: 880px) {
+ .lbe-board .lb-board-head,
+ .lbe-board .lb-row { grid-template-columns: 30px minmax(0, 2.2fr) 1.1fr 1fr 1fr 88px; }
+ .lbe-board.is-all .lb-board-head,
+ .lbe-board.is-all .lb-row { grid-template-columns: 30px minmax(0, 2.2fr) 1.1fr 1fr 1fr 88px; }
+}
+@media (max-width: 620px) {
+ .lbe-summary { grid-template-columns: repeat(2, 1fr); }
+ .lbe-board .lb-board-head,
+ .lbe-board .lb-row,
+ .lbe-board.is-all .lb-board-head,
+ .lbe-board.is-all .lb-row { grid-template-columns: 26px minmax(0, 1.7fr) 1fr 44px; }
+ .lb-tabs .lb-seg { width: 100%; }
+ .lb-tabs .lb-seg-btn { flex: 1 1 0; text-align: center; }
+}
+/* With the trading filters hidden, the window switcher centres under the tabs. */
+body[data-lb-tab='earned'] .lb-controls { justify-content: center; }
diff --git a/src/leaderboard.js b/src/leaderboard.js
index 63b887132..28fbf8a47 100644
--- a/src/leaderboard.js
+++ b/src/leaderboard.js
@@ -2,8 +2,9 @@
* Trader Leaderboard controller.
*
* Renders /api/sniper/leaderboard into a ranked, filterable, live-refreshing
- * board. State (window / sort / network / verified) is reflected into the URL so
- * any view is shareable. Every row deep-links to the trader's profile, where each
+ * 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.
*/
@@ -13,16 +14,20 @@ import {
} 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 = { network: 'mainnet', window: '30d', sort: 'score', verified: false };
+const state = { tab: 'trading', network: 'mainnet', window: '30d', sort: 'score', verified: false };
let timer = null;
let firstLoad = true;
let staleBadgeEl = null;
@@ -57,6 +62,9 @@ function clearStale() {
// --- 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');
@@ -64,6 +72,12 @@ function readUrl() {
}
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);
@@ -391,6 +405,11 @@ function renderBoard(data) {
// --- 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'); }
@@ -436,7 +455,42 @@ function setActive(group, attr, value) {
});
}
+// --- 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');
@@ -474,6 +528,7 @@ function wireControls() {
}
function syncControlsToState() {
+ applyTab();
setActive($('#lb-window'), 'window', state.window);
setActive($('#lb-network'), 'network', state.network);
$('#lb-sort').value = state.sort;
@@ -483,7 +538,7 @@ function syncControlsToState() {
// --- Live refresh ------------------------------------------------------------
function startTimer() {
stopTimer();
- timer = setInterval(() => { if (!document.hidden) load(); }, REFRESH_MS);
+ 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(); });
@@ -592,6 +647,7 @@ async function loadOracleLeaderboard() {
readUrl();
syncControlsToState();
wireControls();
+wireEarned();
ambientField();
load();
startTimer();