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.

docs(copy): document fork-trade and refresh the ghost-copy, smart-money and trading-surface guides

nirholas4447e5c7709c
diff --git a/STRUCTURE.md b/STRUCTURE.md
index 2af919ab5..2a5d11d0f 100644
--- a/STRUCTURE.md
+++ b/STRUCTURE.md
@@ -200,7 +200,7 @@ bottom.
| Ship log (release notes joined to the commits that shipped them) | Package [packages/shipfeed/](packages/shipfeed/README.md), endpoint [api/ship/feed.js](api/ship/feed.js) `→ GET /api/ship/feed`, page [public/ship/index.html](public/ship/index.html) `→ /ship`, provenance for the announcement lane [api/_lib/ship-provenance.js](api/_lib/ship-provenance.js) | Live | The join between the two records of the same work this repo keeps: the changelog (readable, incomplete) and the commit log (complete, unreadable). `@three-ws/shipfeed` parses conventional commits, scores each one by audience (holder / developer / internal) and signal, and links release notes to the commits that produced them with no metadata in the workflow: a `Changelog:` trailer wins where one exists, otherwise a time window plus IDF-weighted term overlap plus tag agreement plus proximity, and every link publishes its confidence and its reasons (`?explain=<sha>` returns one commit's full reasoning). Unclaimed commits are grouped into bursts and shown as "unannounced", which is the half no changelog has ever surfaced. The same package now drives both Telegram lanes: release announcements carry a "shipped in N commits" compare link, and the raw commit feed reads its headline from the parser (`feat(resilience):` reads as "Feature · resilience") and skips merges, `chore(deps):` bumps and lockfile-only changes. Zero dependencies, works on any repository, CLI included (`npx @three-ws/shipfeed`). Docs: [docs/shipfeed.md](docs/shipfeed.md). Tests: [packages/shipfeed/tests/](packages/shipfeed/tests), [tests/ship-feed-endpoint.test.js](tests/ship-feed-endpoint.test.js), [tests/ship-provenance.test.js](tests/ship-provenance.test.js) |
| On-chain agent invocation | [contracts/agent-invocation/](contracts/agent-invocation) | In-repo | Anchor program: verifiable agent-to-agent skill invocation events. SDK: [agent-protocol-sdk/](agent-protocol-sdk) |
| Cross-chain SDKs | [sdk/](sdk), [solana-agent-sdk/](solana-agent-sdk), [agent-payments-sdk/](agent-payments-sdk), [agent-protocol-sdk/](agent-protocol-sdk) | Published | Cross-chain agent SDKs |
-| MCP integration | [mcp-server/](mcp-server), [mcp-bridge/](mcp-bridge), [packages/*-mcp/](packages) | 43 npm servers + 7 hosted remote (50 total, incl. the free `/api/mcp-studio` 3D Studio), all in the [MCP registry](https://registry.modelcontextprotocol.io/?q=io.github.nirholas). Canonical metadata: [prompts/store-submissions/_generated/mcp-listing-source.json](prompts/store-submissions/_generated/mcp-listing-source.json) | Model Context Protocol surface, full server list in [docs/mcp.md](docs/mcp.md). Searchable index of every tool: [pages/mcp-tools.html](pages/mcp-tools.html) `→ /mcp-tools`, rendered from the generated [public/mcp-catalog.json](public/mcp-catalog.json) ([scripts/build-mcp-catalog.mjs](scripts/build-mcp-catalog.mjs), `npm run build:mcp-catalog`, staleness gated by `npm run audit:mcp-catalog`). Tool safety annotations are verified against each handler by [scripts/audit-mcp-safety.mjs](scripts/audit-mcp-safety.mjs) (`npm run audit:mcp-safety`, rules in [scripts/lib/mcp-safety-check.mjs](scripts/lib/mcp-safety-check.mjs), guarded-file list shared with the golden snapshot via [scripts/lib/mcp-tool-sources.mjs](scripts/lib/mcp-tool-sources.mjs)); docs [docs/mcp-safety.md](docs/mcp-safety.md) `→ /docs/mcp-safety`. Trust policy: [api/mcp-policy.js](api/mcp-policy.js) `-> GET /api/mcp-policy` turns those verified labels into a ready-to-paste client allowlist (profiles strict/balanced/open x formats claude/vscode/json), surfaced by the builder panel on `/mcp-tools`. Tests: [tests/mcp-safety-audit.test.js](tests/mcp-safety-audit.test.js), [tests/mcp-catalog.test.js](tests/mcp-catalog.test.js), [tests/api/mcp-policy.test.js](tests/api/mcp-policy.test.js) |
+| MCP integration | [mcp-server/](mcp-server), [mcp-bridge/](mcp-bridge), [packages/*-mcp/](packages) | 43 npm servers + 7 hosted remote (50 total, incl. the free `/api/mcp-studio` 3D Studio), all in the [MCP registry](https://registry.modelcontextprotocol.io/?q=io.github.nirholas). Canonical metadata: [prompts/store-submissions/_generated/mcp-listing-source.json](prompts/store-submissions/_generated/mcp-listing-source.json), generated from the manifests by [scripts/build-mcp-listing-source.mjs](scripts/build-mcp-listing-source.mjs) (`npm run audit:mcp-listing` fails when it drifts) | Model Context Protocol surface, full server list in [docs/mcp.md](docs/mcp.md). Searchable index of every tool: [pages/mcp-tools.html](pages/mcp-tools.html) `→ /mcp-tools`, rendered from the generated [public/mcp-catalog.json](public/mcp-catalog.json) ([scripts/build-mcp-catalog.mjs](scripts/build-mcp-catalog.mjs), `npm run build:mcp-catalog`, staleness gated by `npm run audit:mcp-catalog`). Tool safety annotations are verified against each handler by [scripts/audit-mcp-safety.mjs](scripts/audit-mcp-safety.mjs) (`npm run audit:mcp-safety`, rules in [scripts/lib/mcp-safety-check.mjs](scripts/lib/mcp-safety-check.mjs), guarded-file list shared with the golden snapshot via [scripts/lib/mcp-tool-sources.mjs](scripts/lib/mcp-tool-sources.mjs)); docs [docs/mcp-safety.md](docs/mcp-safety.md) `→ /docs/mcp-safety`. Trust policy: [api/mcp-policy.js](api/mcp-policy.js) `-> GET /api/mcp-policy` turns those verified labels into a ready-to-paste client allowlist (profiles strict/balanced/open x formats claude/vscode/json), surfaced by the builder panel on `/mcp-tools`. Connector-review readiness (every paid stdio tool answers a clean x402 challenge, and the reviewer entitlement lifts it): [scripts/audit-mcp-reviewer-path.mjs](scripts/audit-mcp-reviewer-path.mjs), `npm run audit:mcp-reviewer`. Tests: [tests/mcp-safety-audit.test.js](tests/mcp-safety-audit.test.js), [tests/mcp-catalog.test.js](tests/mcp-catalog.test.js), [tests/api/mcp-policy.test.js](tests/api/mcp-policy.test.js) |
| Agent Skills pack | [.agents/skills/](.agents/skills) → manifest [.agents/skills/SKILLS.md](.agents/skills/SKILLS.md), [.agents/skills/skills-pack.json](.agents/skills/skills-pack.json) | In-repo; bundled in the `three-ws-core` [plugin](.claude-plugin/marketplace.json) | 40 portable `SKILL.md` folders (Agent Skills open standard) for any Claude surface — 3d/creative (cross-platform-safe), wallet/payments, intel/trading. Regenerate manifest: `node scripts/build-skills-pack.mjs`. Docs: [docs/agent-skills.md](docs/agent-skills.md) |
| Claude Code plugin marketplace | [marketplace/](marketplace) → plugins [three-ws-3d](marketplace/plugins/three-ws-3d), [three-ws-developer](marketplace/plugins/three-ws-developer) | In-repo · installable via `/plugin marketplace add nirholas/three.ws` | 3D generation + rigged avatars inside Claude Code (free lane + paid x402 tools) and developer tooling for building on three.ws. Index: [marketplace/README.md](marketplace/README.md) |
| SNS naming + pay-by-name | [api/sns.js](api/sns.js), [api/sns-subdomain.js](api/sns-subdomain.js), [api/threews/subdomain.js](api/threews/subdomain.js), [api/x402/pay-by-name.js](api/x402/pay-by-name.js), [src/solana/sns-subdomain.js](src/solana/sns-subdomain.js), [pages/threews-claim.html](pages/threews-claim.html) | In-repo | `*.threews.sol` subdomain mint, x402 payments addressed by name. Env: `THREEWS_SOL_PARENT_SECRET_BASE58` |
diff --git a/data/pages.json b/data/pages.json
index 9cd036e65..9afc0e260 100644
--- a/data/pages.json
+++ b/data/pages.json
@@ -7,7 +7,7 @@
"description": "three.ws is the AI-agent layer for the open web: build, embed, monetize, and trade autonomous agents with real 3D avatars, on-chain identity (ERC-8004), pay-per-call (x402), and pump.fun token launches.",
"contact": "https://x.com/trythreews",
"github": "https://github.com/nirholas/three.ws",
- "examples": "https://github.com/nirholas/three.ws/tree/main/examples"
+ "examples": "https://github.com/nirholas/three.ws/tree/main/examples"
},
"sections": [
{
@@ -2687,14 +2687,14 @@
"changefreq": "monthly",
"added": "2026-09-02"
},
- {
- "path": "/docs/home-satellite",
- "title": "Docs \u00b7 Give your voice assistant a face",
- "description": "Point an existing Home Assistant voice pipeline at a three.ws agent and it gains a face: the setup in four steps, exactly what crosses your network and what never does, the eleven states the display can be in, and the rule the whole thing is built around, that closing the page never stops your voice assistant working.",
- "priority": 0.6,
- "changefreq": "monthly",
- "added": "2026-09-03"
- },
+ {
+ "path": "/docs/home-satellite",
+ "title": "Docs · Give your voice assistant a face",
+ "description": "Point an existing Home Assistant voice pipeline at a three.ws agent and it gains a face: the setup in four steps, exactly what crosses your network and what never does, the eleven states the display can be in, and the rule the whole thing is built around, that closing the page never stops your voice assistant working.",
+ "priority": 0.6,
+ "changefreq": "monthly",
+ "added": "2026-09-03"
+ },
{
"path": "/docs/home-households",
"title": "Docs · Home households and roles",
@@ -2713,7 +2713,7 @@
},
{
"path": "/docs/home-relay",
- "title": "Docs \u00b7 Connect a home that is only on your network",
+ "title": "Docs · Connect a home that is only on your network",
"description": "Most Home Assistant installs cannot be reached from the internet, so the house dials three.ws instead: install one HACS integration, paste a ten-minute pairing code, and nothing listens on your network, no port is forwarded, and three.ws never receives a Home Assistant token. Includes the operator half: the relay service, its configuration and deploy, how the allowlist is changed, and how to prove the whole path against a real house on a network the server cannot route to.",
"priority": 0.6,
"changefreq": "monthly",
@@ -2729,7 +2729,7 @@
},
{
"path": "/docs/home-scene",
- "title": "Docs \u00b7 The live 3D home",
+ "title": "Docs · The live 3D home",
"description": "How the connected house becomes a room you can stand in: the room graph the bridge builds from Home Assistant's registries, how a real light dimming dims the model, what the scene does while the house is unreachable, and the fallback that keeps every control usable without WebGL.",
"priority": 0.6,
"changefreq": "monthly",
@@ -5627,6 +5627,14 @@
"changefreq": "monthly",
"added": "2026-08-02"
},
+ {
+ "path": "/docs/fork-trade",
+ "title": "Docs · Fork a trade",
+ "description": "One tap on any coin across the Radar, the Live Trade Feed, the Smart Money Radar, or a ghost-copy replay opens the real pump.fun trade panel for it, pre-filled and signed by your own wallet. No custody, no delegated key, and a ?fork= link so a coin travels.",
+ "priority": 0.6,
+ "changefreq": "monthly",
+ "added": "2026-09-03"
+ },
{
"path": "/docs/trader-passport",
"title": "Docs · Trader Passport",
@@ -5698,6 +5706,14 @@
"priority": 0.5,
"changefreq": "monthly",
"added": "2026-08-28"
+ },
+ {
+ "path": "/tutorials/connect-your-home",
+ "title": "Tutorial · Connect your home",
+ "description": "Point your agent at a real Home Assistant and it runs your actual house: lights, thermostat, and the scenes you already built. Covers the three honest ways to reach a house that lives on a home network, and the rule that unlocking, opening and disarming always stop and ask, while locking up never...",
+ "priority": 0.8,
+ "changefreq": "monthly",
+ "added": "2026-09-03"
}
]
},
diff --git a/docs/fork-trade.md b/docs/fork-trade.md
new file mode 100644
index 000000000..82ca56625
--- /dev/null
+++ b/docs/fork-trade.md
@@ -0,0 +1,140 @@
+# Fork a trade: the one-tap "do what they just did"
+
+Fork is the action that turns three.ws's read-only trading intelligence into
+something you can act on without leaving the page. Wherever the platform shows
+you a coin, a **Fork** button opens the real pump.fun trade panel for that exact
+mint, pre-filled with the size being forked. Your own wallet signs it. three.ws
+never holds your funds, never delegates a key, and never places the trade for
+you.
+
+Surfaces: [/radar](https://three.ws/radar) · [/trades](https://three.ws/trades)
+· [/smart-money](https://three.ws/smart-money) ·
+[/ghost-copy](https://three.ws/ghost-copy)
+Module: `src/fork-trade.js` · Trade panel: `src/game/coin-buy.js`
+
+## Why it exists
+
+The platform already answers "who is winning and what are they in": the
+[Coin Radar](radar.md) scores every launch in its first 90 seconds, the
+[Smart Money Radar](smart-money.md) shows which proven wallets are accumulating
+right now, [Ghost-copy](ghost-copy.md) replays a leader's real record against
+your budget, and the [Live Trade Feed](trading-surfaces.md) opens the full
+deep-dive on any mint. Until Fork, every one of those answers ended in a link
+out to pump.fun, where you had to find the coin again and start over.
+
+The unit of virality in trading is not "follow me". It is "do what I just did,
+right now, in one tap". Fork is that tap, and because a fork is a link, it
+travels: any shared artifact can carry one back into the product.
+
+## Using it
+
+**On a page.** Click **Fork** on a radar card, a smart-money card, the coin
+deep-dive header on /trades, or a still-open position in a ghost-copy replay.
+The trade panel opens on that mint. On ghost-copy it opens at the size your
+ghost budget used, so the paper position and the real one match.
+
+**From a link.** Any page that mounts Fork also honors a `?fork=` deep link:
+
+```
+https://three.ws/trades?fork=<mint>&fork_size=0.5
+```
+
+Landing on that URL opens the trade panel for `<mint>` pre-filled with 0.5 SOL.
+The fork params are stripped from the address bar once honored, so a refresh
+does not reopen a panel you dismissed. Everything else in the query string is
+left alone, including `ref`.
+
+**Share sheet.** The Fork buttons that carry a share icon (the coin deep-dive
+header on /trades, the smart-money coin drawer) build that link for you and hand
+it to the X / Farcaster / copy panel, with your referral code appended when you
+are signed in. That is what closes the loop: the fork you shared pays you when
+whoever clicked it signs up.
+
+## What Fork does not do
+
+- **It does not take custody.** The transaction is built server-side (unsigned),
+ your wallet signs it, and it is broadcast through the same-origin RPC proxy.
+ No key is delegated, no session key is minted, no balance is held.
+- **It does not skip the safety checks.** The panel runs the same firewall as
+ every other trade surface: honeypot and sell-tax simulation, authority checks,
+ liquidity floor, price impact. A coin that fails hard renders **Blocked,
+ likely unsafe to buy** and the buy button stays disabled. A forked link cannot
+ route around that.
+- **It does not trust the link's numbers.** A `fork_size` arrives from whoever
+ wrote the link, so it is clamped to a positive amount no larger than 10 SOL
+ and rounded to the precision the panel quotes in. The size is a suggestion you
+ can edit; the amount you sign is always the one on screen.
+- **It is not advice.** A fork is a pre-filled intent, nothing more. The coin may
+ be a rug; the wallet you are following may be wrong. The panel shows you the
+ pedigree and the risk verdict it has, and then it is your signature.
+
+## Adding Fork to a surface
+
+Three pieces, so a new page adopts it in a few lines.
+
+For a page that renders rows with `innerHTML`:
+
+```js
+import { initFork, forkButton } from './fork-trade.js';
+
+// once, on boot: delegates every [data-fork-mint] click and honors ?fork=
+initFork();
+
+// per row
+row.innerHTML = `
+ <td>${escapeHtml(coin.symbol)}</td>
+ <td>${forkButton({ mint: coin.mint, symbol: coin.symbol, size: 0.5 }, { className: 'my-fork-btn' })}</td>`;
+```
+
+For a page that builds DOM nodes, or whose rows already claim the click (a card
+that opens a drawer, for instance), bind the action directly so the event can be
+stopped at the button:
+
+```js
+import { openFork } from './fork-trade.js';
+
+btn.addEventListener('click', (e) => {
+ e.stopPropagation();
+ openFork({ mint: coin.mint, symbol: coin.symbol, name: coin.name });
+});
+```
+
+To offer the share sheet instead of the trade panel, pass `share: true` to
+`forkButton`. To build the link yourself, `forkShareUrl(trade)` returns the
+absolute URL with the viewer's referral code attached.
+
+Two things to remember when wiring a new surface:
+
+1. **Call `initFork()` before the page's own `writeUrl()`**, or the page rewrites
+ the query string and drops the inbound fork params before they are read.
+2. **Add `<script src="/referral-capture.js"></script>`** to the page head. It
+ parks an inbound `?ref=` code for signup attribution; without it a fork link
+ still works but the referrer earns nothing.
+
+### API
+
+| Export | What it does |
+| --- | --- |
+| `initFork({ root, deepLink })` | Mount delegation and honor `?fork=`. The usual one-liner. |
+| `openFork(trade)` | Open the trade panel for `{ mint, symbol, name, image, size }`. |
+| `forkButton(trade, opts)` | Markup for a fork or share button (`label`, `className`, `share`, `title`). |
+| `forkPath(trade, base)` | The `?fork=` query string for a path. |
+| `forkShareUrl(trade, opts)` | Absolute shareable URL, with the viewer's referral code. |
+| `mountForkLinks(root)` | Delegation only, no deep link. Idempotent per root. |
+| `consumeForkLink()` | Deep link only. Returns whether one was present. |
+| `clampForkSize(raw)` / `isMint(v)` | The input guards, exported for callers that validate first. |
+| `MAX_FORK_SOL` | The size ceiling a link may pre-fill (10 SOL). |
+
+The trade panel itself takes two options that Fork uses: `amount` (pre-fill the
+buy input, SOL) and `elevate` (lift the modal above a page's sticky site nav,
+which the /play HUD does not need).
+
+## Related
+
+- [Ghost-copy](ghost-copy.md): find out what a leader would have done to your
+ budget before you fork anything.
+- [Copy trading](copy-trading.md): when one fork at a time is not enough and you
+ want a leader mirrored automatically under hard spend limits.
+- [The trading surfaces](trading-surfaces.md): where every fork button lives.
+- [Smart Money Radar](smart-money.md): the proven-wallet ledger behind the coin
+ pedigree the panel shows you before you sign.
diff --git a/docs/ghost-copy.md b/docs/ghost-copy.md
index 9b99c6211..31f8cb010 100644
--- a/docs/ghost-copy.md
+++ b/docs/ghost-copy.md
@@ -7,8 +7,12 @@ copied this agent, at my size, with my limits, where would I be now?*
Page: [/ghost-copy](https://three.ws/ghost-copy) · API: `/api/pump/ghost-copy`
-Nothing is signed, nothing is spent, no wallet is connected, and no account is
-required. It is arithmetic over trades that already happened.
+The replay itself signs nothing, spends nothing, connects no wallet, and needs
+no account. It is arithmetic over trades that already happened. The one live
+action on the page is [Fork](fork-trade.md) on a position the leader is still
+holding: that opens the real pump.fun trade panel at your ghost size, and your
+own wallet signs it. Forking is opt-in, one coin at a time, and never happens
+as part of a replay.
## Why it exists
diff --git a/docs/radar.md b/docs/radar.md
index a3d90af0b..b1cdc501a 100644
--- a/docs/radar.md
+++ b/docs/radar.md
@@ -41,6 +41,7 @@ The UI colors quality as Healthy at 70 and up, Mixed from 40 to 69, and High ris
4. Click any coin for the drawer: the full signal grid, the top-50 wallet ledger, the smart-money notable roster, the outcome (if labeled), and an asynchronously injected Oracle conviction section.
5. Every mainnet coin links to its full page at `/oracle/coin/<mint>`: the card's "Full intel →" button goes there directly, and the drawer carries an "Open full page →" link in its header. The full page renders in the markets-hub design (the same system as `/coin/:id`) with the live price chart, the complete Launch Intelligence read (this engine's signal grid, risk flags, and trader ledger), Oracle conviction, live market intel, agent transactions, and a live trade tape.
6. On a coin worth tracking, use Watch to add it to your [Watchlist](https://three.ws/watchlist), then open it in [Mission Control](./terminal.md) to trade.
+7. On a coin worth acting on now, use **[Fork](./fork-trade.md)**. It opens the real pump.fun trade panel for that mint without leaving the page: live quote, the safety firewall's verdict, and your own browser wallet as the signer. Devnet coins have no market to buy into, so they carry no Fork button.
## Examples
@@ -83,6 +84,7 @@ console.log(clean.map((c) => `${c.symbol} q${c.quality_score}`));
- [The trading surfaces: Radar, Mission Control, Live Trade Feed, Watchlist, Coin Intelligence](./trading-surfaces.md)
- [Oracle: the conviction engine](./oracle.md) fuses this intel into a single conviction score
- [Smart Money Radar](./smart-money.md) is the pedigree layer Radar surfaces inline
+- [Fork a trade](./fork-trade.md) is the one-tap buy on every Radar card, and the deep link that brings a shared coin back here
- [Mission Control](./terminal.md) is where a Radar find gets traded
- [Coin pages](./coin-pages.md) cross-link the per-mint intel and conviction views
- Pages: [/radar](https://three.ws/radar) · [/coin-intel](https://three.ws/coin-intel) · [/watchlist](https://three.ws/watchlist)
diff --git a/docs/smart-money.md b/docs/smart-money.md
index 71eb95dcc..92cd39fef 100644
--- a/docs/smart-money.md
+++ b/docs/smart-money.md
@@ -47,8 +47,9 @@ A wallet is "proven smart money" at reputation 70 or more. The card's smart-mone
1. Open [/smart-money](https://three.ws/smart-money). The hero shows live totals: proven wallets, proven win rate, tracked capital, coins on radar, and last-updated.
2. Stay on **Smart money is buying**. Filter by `On radar (fresh)`, `Graduated`, or `All`, and sort by pedigree, smart-money share, smart buy volume, proven wallets in, or freshest. Each card shows the pedigree badge, the share bar, and up to four notable wallet labels.
3. Click a coin to open its drawer: the full notable roster, and an Oracle conviction slot fetched separately from `/api/oracle/coin`.
-4. Switch to **Top wallets**. Filter by label (`smart_money`, `sniper`, `dumper`, or all), or paste a wallet address to jump straight to it. The sortable table shows win rate, early-win rate, dump rate, record, volume, and score.
-5. Click any wallet to see its recent coins and cross-navigate back to a coin it bought. Star coins to your Watchlist to track them locally.
+4. **[Fork this trade](fork-trade.md)** on the card or in the drawer. It opens the real pump.fun trade panel for that coin, quoted live and screened by the safety firewall, and your own browser wallet signs it. Nothing is delegated and no balance is held. The drawer's **Share** button hands you a one-tap fork link (carrying your referral code when you are signed in) so the wallets you found can travel.
+5. Switch to **Top wallets**. Filter by label (`smart_money`, `sniper`, `dumper`, or all), or paste a wallet address to jump straight to it. The sortable table shows win rate, early-win rate, dump rate, record, volume, and score.
+6. Click any wallet to see its recent coins and cross-navigate back to a coin it bought. Star coins to your Watchlist to track them locally.
## Examples
diff --git a/docs/start-here.md b/docs/start-here.md
index d70fc9b20..53753fbdc 100644
--- a/docs/start-here.md
+++ b/docs/start-here.md
@@ -141,6 +141,7 @@ Want the model in your hands rather than on a screen? [Materialize](./materializ
- **Backing an agent with capital?** → [USDC agent vaults](./vaults.md): NAV-priced deposits and redemptions, the drawdown breaker that halts a vault, performance-fee claims, and the public audit ledger anyone can read
- **Funding your own agents?** → [Your master wallet](./user-wallet.md): the per-user custodial hub you fund once, then top up agent wallets, send SOL or USDC, and read on-chain history from
- **Following a trader instead of picking?** → [Copy trading](./copy-trading.md): follow a leader two ways, either your agent mirroring real Solana trades inside its own spend policy, or sized intents you sign yourself. Nothing is simulated, so the doc covers the leaderboard weighting, the Smart Money directory, and how performance fees accrue
+- **Found a coin and want to act on it now?** → [Fork a trade](./fork-trade.md): one tap on any coin across the Radar, the Live Trade Feed, the Smart Money Radar, or a ghost-copy replay opens the real pump.fun trade panel for it, pre-filled with the size being forked and signed by your own wallet. No custody, no delegated key, the same safety firewall as every other trade surface, and a `?fork=` link so a coin can travel to X or Telegram and open the panel on arrival
- **Not ready to risk money on a trader yet?** → [Ghost-copy](./ghost-copy.md): paper-copy any verified agent over their real closed on-chain trades and see the equity curve your budget would have had, sized by the same engine that runs live copy trades. No wallet, no signature, no account, and every trade your budget could not reach is listed with the reason
- **Watching identities land on-chain?** → [On-chain deployments](./deployments.md): the live feed of agent identities registering on-chain as it happens, Solana Metaplex Core mints alongside ERC-8004 registrations across 15 EVM chains, with chain footprint and capability stats
- **Building against the API?** → [The developer platform](./developer-platform.md): API keys, usage metrics, signed webhooks, the one-call MCP connection test, and the public tool and skills catalogs, with a runnable example per endpoint
diff --git a/docs/trading-surfaces.md b/docs/trading-surfaces.md
index e6652d16c..b187856b4 100644
--- a/docs/trading-surfaces.md
+++ b/docs/trading-surfaces.md
@@ -1,18 +1,18 @@
# The trading surfaces: Radar, Mission Control, Live Trade Feed, Watchlist, Coin Intelligence
-The platform's trading stack is spread across five public pages. Four of them are read-only intelligence — they exist to answer "what's launching, what's real, who's winning" — and one, Mission Control, is the actual cockpit where a signed-in user trades from their agent's wallet. This doc explains what each surface is, where its numbers come from, and how they fit together.
+The platform's trading stack is spread across five public pages. Four of them are intelligence surfaces — they exist to answer "what's launching, what's real, who's winning" — and one, Mission Control, is the full cockpit where a signed-in user trades from their agent's wallet. The intelligence pages are no longer dead ends: the Coin Radar and the Live Trade Feed (along with the [Smart Money Radar](smart-money.md) and [Ghost-copy](ghost-copy.md)) each carry a [Fork](fork-trade.md) button that opens the real pump.fun trade panel for the coin you are looking at, signed by your own wallet. This doc explains what each surface is, where its numbers come from, and how they fit together.
The one-line map:
| Surface | Route | What it answers | Trades? |
| --- | --- | --- | --- |
-| Coin Radar | [/radar](https://three.ws/radar) | What launched in the last 90 seconds, and is it real? | No |
+| Coin Radar | [/radar](https://three.ws/radar) | What launched in the last 90 seconds, and is it real? | Fork, from your own wallet |
| Coin Intelligence | [/coin-intel](https://three.ws/coin-intel) | What did the intel engine learn about every launch? | No |
-| Live Trade Feed | [/trades](https://three.ws/trades) | Which trades actually won, and what did the winner see? | No |
+| Live Trade Feed | [/trades](https://three.ws/trades) | Which trades actually won, and what did the winner see? | Fork, from your own wallet |
| Watchlist | [/watchlist](https://three.ws/watchlist) | What are *my* coins doing right now? | Buy via coin card |
| Mission Control | [/terminal](https://three.ws/terminal) | Everything, live — and execute. | Yes, from your agent wallet |
-Everything below is public and works signed-out except executing trades in Mission Control, which requires a signed-in account with a trading agent.
+Everything below is public and works signed-out except executing trades in Mission Control, which requires a signed-in account with a trading agent. Forking needs no account either: a browser wallet signs the trade directly, and the same safety firewall that guards every other trade surface blocks a coin it judges unsafe.
## Where the numbers come from
@@ -36,6 +36,7 @@ What you can do:
- Filter by narrative category (meme / ai / tech / culture / …) and a minimum-quality slider; sort by buyers, buy volume, and more.
- Click any coin for the detail drawer: wallet breakdown, top-trader ledger, the full signal grid, and Oracle conviction.
- **Watch** any coin — one tap adds it to your [Watchlist](#watchlist--watchlist).
+- **[Fork](fork-trade.md)** any mainnet coin — one tap opens the real pump.fun trade panel for it, priced live, screened by the safety firewall, and signed by your own wallet. Devnet coins have no market to buy into, so they show no Fork button.
The list refreshes every 12 seconds. Fully public, no account.
@@ -64,7 +65,7 @@ Click any trade (or paste any mint) and the center pane becomes a full analytics
- Smart-money pedigree and a wallet-footprint table with Solscan links and DEV tags
- The live trade tape, the outcome badge (with ATH multiple), and the agent's economics on the trade (buyback runs and burns)
-Every wallet links to Solscan; every coin links onward to its Oracle page. Public, no account.
+Every wallet links to Solscan; every coin links onward to its Oracle page. The deep-dive header also carries **[Fork](fork-trade.md)**, which opens the real trade panel for the coin you are reading about, and **Share**, which hands you a one-tap fork link (carrying your referral code when you are signed in) for X, Farcaster, or the clipboard. Public, no account.
## Watchlist — /watchlist