Page spec — Token detail
The anatomy, states, interactions and data contract for the clanker.world token page.

01Anatomy (top → bottom)

Each region maps to components in the design system. Class names in mono are the tags — look them up there for the full spec.

Nav .topnav
Brand + bars, centered search (focus-grows; “/” focuses it; dropdown of results), the ☀/☾ theme toggle .nrtheme, Launch CTA .nrlaunch, hamburger .nrham. On scroll it gains a bottom border and the collapsed masthead .sliver drops in below it (PFP-first, then name · price · stats · verified · risk) — two stacked borders. 🌐 Global
Age banner .agebanner
Full-width risk warning. Shown only for fresh (“just launched · high risk”) and early (“early token · trade with care”); absent on established. 🔒
Masthead .header
Avatar, name + ticker, ✓ Verified chip, agent status (per agent axis), contract address (full desktop / truncated mobile + copy), handle pills, launched-by + NEW, and the Admin button (admin only). 🔒 🔧
Anchor row .anchorrow
Chip nav — Launch · Holders · Clankernomics · Contract · Agent — smooth-scrolls to each section. Styled identically to the swap tabs. 🔒
Chart hero .charthero
Price + 24h change header, then the live GeckoTerminal embed (canvas pinned to page bg, both themes). 🔧
Activity .activity
One filter bar (All / Farcaster / X / Trades / Updates) driving BOTH the timeline (volume bars + curated event markers, Launch→Now) and the feed. In admin, a composer to post updates. Feed rows expand (casts/trades); update rows are plain text. 🔒 🔧
Evidence .evid
Holders (+ view top 10), Agent block (3 states), Launch cast, Contract (kv), Clankernomics (kv), About (SEO prose). 🔒 🔧
Right rail .col-right
Sticky trade console: swap card (tabs → pay/receive → quick chips → connect) → stats card → Safety verdict card. Hidden < 900px (stats move inline; a docked Trade bar appears). 🔒 🔧
Footer .footer
Token column ($CLANKER + price + Clank + X/Farcaster socials), link columns, CLANKER watermark, legal disclosure. 🌐 Global
Overlays
Hamburger menu .hbmenu, Admin drawer .mdrawer, swap token menu .curmenu, confirm modal .fmodal, toast, and the review-only ⚙ FAB (does not ship). 🔧

02State matrix

Four independent axes (see the handoff home for where they come from in production). What each changes:

Axis · valueWhat changes on the page
viewer = visitorNo Admin button, no manage drawer, no update composer. The “no-agent” block shows the visitor note (not the set-up CTA).
viewer = adminAdmin button in the masthead → opens the Manage drawer. Update composer appears above the feed. “No-agent” block shows the “Set up an agent” CTA.
agent = agentAgent section shows live metrics (fees / deployed / treasury / uptime). Farcaster + X feed rows and filter chips are present.
agent = noagentAgent section → “No agent yet” (+ set-up CTA in admin). Social (FC/X) feed rows + filter chips are HIDDEN — feed falls back to trades/updates. Masthead shows “○ No agent yet”.
agent = v1lockedAgent section → “Not agent-capable” (v1 contract). Social feed rows + chips hidden. Masthead shows “● v1 · not agent-capable”.
age = established / early / freshNavigates to that token's page. established = $CLANKER (no banner). early = $AIRGAP (amber “early” banner, thin liq, zero trades). fresh = $BRIAN (“just launched” banner, high risk, no agent).
theme = light / darkFull palette swap (incl. the GT chart canvas). Toggled by the ☀/☾ control; persists across the age-navigation.
Combinatorics: the axes are independent — viewer × agent × age × theme = 2 × 3 × 3 × 2 = 36 base combinations, each of which must render coherently (× desktop/mobile). The three token pages ship default values (established→agent, early→agent, fresh→noagent) but any agent/viewer/theme combination is valid on any of them.

03Interaction inventory

Every interaction that must exist. In the prototype these are wired as vanilla JS; treat them as the behaviour spec.

WhereTrigger → resultTag
SearchFocus grows the field + reveals a results dropdown; “/” focuses it; picking a result would route. Mobile: collapses to an icon.🔧
Theme toggle☀/☾ flips light↔dark, persists, re-renders the chart. Also in the hamburger menu.🔒
Hamburger menuOpens the account menu. Disconnected: Navigate · Tools · Settings · Connect Wallet. Connected: wallet addresses (EVM×3 + Solana, copy/open) · Link X · Toggle Theme · Export Privy · Disconnect · Navigate · Tools. Outside-click / Esc closes.🌐 🔧
Address copyCopy icon → clipboard + toast. (Masthead address + contract section.)🔒
Anchor chipsSmooth-scroll to the target section.🔒
Swap tabsSwap / Limit / Buy / Sell — active tab gets the accent fill; Limit reveals the limit-price + expiry row.🔒
Swap amountTyping in You-pay computes You-receive + reveals the quote (rate / network fee / slippage / price impact). Focusing You-pay lifts it to white + accent border (one box, no divider).🔒 visual · 🔧 quote
Currency selectThe token button opens the token menu (WETH/ETH/USDC/$TOKEN). Quick chips (0.01/0.1/1/Max) fill the amount. Reverse arrow swaps direction.🔒
Connect walletConnect Wallet → connected state (walletline + Disconnect). Mirrors the hamburger's connect state.🔧 real Privy
Activity filtersAll/FC/X/Trades/Updates filter the feed AND the timeline markers together. Updates isolates the plain-text updates.🔒
Feed rowsCast/trade rows expand into a panel (cast: engagement + View on X/Farcaster; trade: tx + Basescan + copy-tx). The top non-trade (cast) row is auto-expanded on load. Update rows are plain text — not expandable, no panel.🔒
Post update (admin)Composer above the feed → Post prepends a plain-text UPDATE row + toast.🔒 shape · 🔧 persist
Holders“View top 10” expands the holder list.🔒
Admin drawerAdmin button → slide-in drawer with the clanker.world admin sections (metadata, image, verify, rewards, recipient/admin, bulk, agent config). Accordion sections; actions toast (dummy).🔧
Mobile Trade barDocked black “Trade $token” button → opens the swap route (the rail is hidden on mobile).🔒 visual · 🔧

04Data contract

Each page is filled from a per-token JSON (clanker-token-{established,early,fresh}.json) by token-fill.js → sets window.TOKEN. Activity + the chart pull live from GeckoTerminal / Neynar. This is the field map — and what's real vs mock in the prototype (all “mock” = 🔧 wire to real).

JSON fieldDrivesPrototype source
name, ticker, verifiedMasthead identity + verified chipReal (from brief)
contractShort / Full, pool, basescanHrefAddress (+copy), contract section, chart poolReal
price, changeAbs/Pct/DirMasthead price + change, stats, sliver, footerReal (snapshot)
stats{}Stats grid (mcap / vol / liq / holders / fdv)Real (snapshot)
handles[], launchedBy, isNewHandle pills, launched-by, NEW pillReal
agentState, agent{}Agent axis default + Agent metrics blockagentState real; metrics mock
safety[]Safety verdict badgesMock (plausible)
holders[], holdersCountHolders list + countsMock addresses
launch, contract, clankernomicsLaunch cast, contract kv, clankernomics kvContract real; launch/clankernomics mock
about[], agentSkillAbout prose; hamburger “Copy Agent Skill”Mock (SEO/skill copy)
activity[] (+ GT / Neynar)Feed rows + timeline markers + volumeCasts/X/trades real; updates/launch mock; trade times re-spread

05Responsive

06Open questions & known limits 🔧 all Adapt

These are intentional — documented so you don't mistake them for bugs. All resolve when you wire real data / your stack. The page is otherwise robust: 0 console errors across all 36 state combinations × light/dark × desktop/mobile.

Full component-by-component audit (54 findings, all triaged) was run against this page; every blocker + the token-awareness cluster + the clear state/interaction bugs are fixed. What remains above is the deliberately-deferred, wire-to-real-data set.

RED · NEYN-12112 · Page spec for the token-detail surface. Pairs with the design system (component specs) and the handoff home (legend + conventions).