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
docs(prompts): add the Solana-Robinhood playbook and the integrate campaign context and order 503
nirholasb7e29dafe7a1
diff --git a/docs/research/solana-robinhood-playbook-2026-10.md b/docs/research/solana-robinhood-playbook-2026-10.mdnew file mode 100644index 000000000..79ed2f2ce--- /dev/null+++ b/docs/research/solana-robinhood-playbook-2026-10.md@@ -0,0 +1,156 @@+# Solana and Robinhood Chain, October 2026: what the leaders do, and how three.ws does it better++Research date: 2026-10-08. Competitors are named by placeholder per the repo convention for research docs. The placeholders here are local to this file (R1, R2 on Robinhood Chain; S1, S2 on Solana) and do not map to the letters in the two September docs. The key and the source list were delivered to the owner in the session that produced this file. Robinhood, pump.fun, Meteora and Phantom are named because three.ws integrates them as venues or rails. Market numbers come from DefiLlama pulls taken that day and from protocol-reported figures relayed by the trade press, so treat them as approximate. Our own state was checked against this repo the same day.++Companion to [launchpad-landscape-2026-09.md](launchpad-landscape-2026-09.md) (launchpads, ranked fixes) and [competitor-teardown-2026-09.md](competitor-teardown-2026-09.md) (one agent launchpad, packaging). This doc covers what those did not: agents, consumer apps, distribution, and Robinhood Chain beyond launchpads.++## Bottom line++1. **The open lane on both chains is the same one: an agent that earns real revenue, has a body, and can act on more than one venue.** On Solana, pump.fun shut its revenue-buyback agent mode after about 3.5 months, and genuine agent commerce over x402 is estimated at only about $1.6M a month. On Robinhood Chain, the agent layer is two token launchers (R2, R3). Robinhood's own agent products are custodial and closed to outside agents. Nobody ships an embodied agent with a wallet on each chain, measured revenue, and a link to the user's Robinhood Crypto account. We have most of that already.+2. **The market just validated two things we built and left switched off.** pump.fun now pays creator fees to holders several times an hour (Holder Rewards, Sep 12). Since Oct 3 it also prices coins against a third-party token and pays those rewards in that token. Those are our holder-rewards item and our $THREE-quoted lane. Both are still dark: the native lane fee is flat (`api/_lib/native-launch/config.js:80`), and no holder-rewards or buyback page exists.+3. **The 2026 growth winner on Solana is social copy-trading on a phone, not a pro terminal.** S1 went from about 17% to 46% of Solana terminal spot volume in two months, with one-tap copying of a public portfolio. We have copy trading, Ghost Copy, Duels and Quests, but they are scattered. None of them is a single "follow this agent" button on the agent's profile and in the Seeker app.+4. **Our Robinhood Chain surface is three months stale where it matters.** `/markets/robinhood` indexes NOXA (shut down 2026-07-13) and The Odyssey (`api/_lib/robinhood.js:613`). It misses R1, which carries about $86.5M in 30-day fees and is the chain's #2 fee earner, and it misses pump.fun's Robinhood Chain trading. The September doc flagged this. It has not shipped.+5. **Credibility beats size on value accrual.** pump.fun committed 50% of revenue for a year through an irreversible contract and has bought back about $476M. S3 ran a discretionary buyback of $70M+ while its token fell about 89%, then proposed ending it. Whatever $THREE does should be a locked, partial, publicly counted rule, never a promise.++## Robinhood Chain in October 2026++Arbitrum Orbit L2, chain 4663, ETH gas, mainnet since 2026-07-01. Transactions are sequenced first-come, first-served, so paying more does not let you jump the queue. ERC-4337 (paymasters, session keys) is first-class.++| Metric (DefiLlama, 2026-10-08) | Value |+|---|---|+| TVL | $1.05B |+| Stablecoins | $1.07B |+| DEX volume | $1.09B 24h, $45.2B 30d |+| Fees | $3.1M 24h, $226M 30d |++DefiLlama keeps a volume-boosting category for the chain, so the volume figures are partly wash.++| Category | Leader and what it does |+|---|---|+| Lending | The largest lending market (about $610M) powers Robinhood Earn, a USDG yield product at about 7%. Distribution comes through Robinhood's own app. |+| Perps | R4 (about $114M TVL) pays 2x points to Robinhood Wallet users. R5 is built with Robinhood Crypto. |+| Launchpad | R1 earns $86.5M in 30-day fees with an ETH bonding curve, a locked pool and a snipe tax that decays over seconds. Its weekly fees fell 68% from Sep 17 to Oct 1, after the wallet gas waiver ended on Sep 29. |+| Agents | R2 reports 5,600+ agents, $200M+ agent volume and about $1.1M in 30-day fees (1% fee in USDG), 6.6x its fees on its home chain. R3 launches agent tokens paired against other assets and earns about $2.3M in 30-day fees. |+| NFTs, social, gaming | NFTs are early and speculative. One social trading app. Gaming has nothing we could verify. |++**Robinhood's own agent stack sits in Robinhood Crypto, not on the chain:**+- **Trading MCP** (`agent.robinhood.com/mcp/trading`) works with Claude, ChatGPT, Cursor and others. The agent can read every account but trades only from a dedicated Agentic account, and it cannot transfer, stake or lend crypto.+- **HOOD Summit (Sep 29)** reported 150K+ agentic accounts and about 30M tool calls a day. It announced in-app Robinhood Agents, Loops (always-on strategies) and Agent Apps, a third-party marketplace open only to agents Robinhood hosts. There is no public listing program.+- **Crypto Trading API** (`trading.robinhood.com`, US only) signs each request with an Ed25519 key and covers quotes, holdings, buying power and orders. There is no sandbox.++**Gaps an entrant can fill:**+- No agent spans the custodial account and the chain.+- No agent-to-agent payment rail native to the chain.+- No credible trust tooling. One operator extracted about $18.4M across 53 launches by exempting their own wallets from the snipe tax.+- Retention dropped once users had to pay their own gas.++## Solana in October 2026++| Area | What the leaders ship | Evidence |+|---|---|---|+| Launchpad | pump.fun: fee splits across up to 10 wallets, transferable fee ownership, Holder Rewards in the quote token, Custom Pairs against third-party tokens (Oct 3), a mobile app, livestreams, and a 50% revenue buyback locked for one year. | $58.2M revenue in August, about 41% of Solana app revenue, but annualizing at about a third of 2025. |+| Failed experiment | pump.fun Tokenized Agents (an agent's revenue auto-bought its token) was killed after about 3.5 months for "PVP dynamics". | Directly relevant to our revenue-backed agents item. |+| Agent payments | x402 on Solana carries about 70% of x402 volume. Batch settlement went live around Oct 1 to 7. Pay.sh (Google Cloud and the Solana Foundation) lets agents pay per request with no API key. | Real agent commerce is estimated at about $1.6M a month. The rest is bots and MEV. |+| Agent identity | The Solana Agent Registry (solana.com/agent-registry) works with ERC-8004. Registering costs about 0.009 SOL, and it includes a feedback and reputation registry. | Separate from the Metaplex Agent Registry we already write to. |+| Agent wallets | Squads-based smart accounts with TEE-held keys and spend limits. A major wallet's MCP server signs, transfers and swaps. Phantom ships an MCP server in preview. | Our agent keys are server-side, AES-GCM encrypted. |+| Consumer | S1: tokenless social copy-trading, $14.6M revenue in August, #3 in US iPhone Finance. Phantom: perps, prediction markets, a debit card. S4: tokenized collectible packs, about $85M cumulative. Wallet-embedded distribution lifted one app's fees 129% in a week. | Terminal share is moving from S2 (about 44.6% down to under 30%) to S1. |+| Distribution | Multi-level referrals (30/3/2% is common), Solana Foundation Frontier Traders campaigns, Seeker device airdrops and seasons. | Seeker has about 150K users and 200+ dApps. |+| Security | The largest Solana exploit of 2026 (about $270M, Apr 1) came from social engineering of developers: a cloned repo and a fake TestFlight build. It was not a contract bug. | Directly relevant to a platform that holds agent keys. |++## Where we stand++| Capability | Leaders have it | three.ws today | Path |+|---|---|---|---|+| Holder rewards from fees | pump.fun, live | Read-only field from pump.fun (`api/pump/[action].js`); our own is not built | Build, owner flag |+| Launches quoted in the platform coin | pump.fun Custom Pairs, R3 | $THREE lane built and tested on devnet, fee flat, no mainnet config | Anti-sniper, then owner |+| Locked, counted buyback | pump.fun | Engine built, `THREE_BUYBACK_ENABLED` unset, no public page | Build page, owner flag |+| Social copy on mobile | S1 | Copy trading, Ghost Copy, Duels, Quests on separate pages; Solana Mobile app live on the dApp Store | Package |+| Agent registry | Solana Agent Registry | Metaplex Agent Registry only (`api/_lib/agent-registry.js`) | Build |+| x402 batch settlement, Pay.sh listing | Leading facilitators | x402 live on Solana; self-hosted facilitator off; no batch settle | Build |+| Blinks for commerce | Wallet-embedded apps | One memo blink (`api/actions/avatar.js`) | Build |+| Robinhood Chain screener | n/a | Indexes two dead or minor launchpads | Fix |+| Robinhood Chain in hosted MCP and the x402 network list | n/a | `hood-mcp` exists as a standalone package; hosted `api/_mcp*` has no Robinhood tools; 4663 not in `api/_lib/x402/revenue-networks.js` | Wire |+| Robinhood Crypto account link | Robinhood's own Trading MCP | None | Build |+| Gas sponsorship on 4663 | Robinhood (ended Sep 29) | None | Build |+| Compressed NFTs for avatars | Common | None; Metaplex Core mints default to devnet | Build |+| Smart-account or TEE custody | Leading agent wallets | Server-side keys | Longer term |++## How we do it better++### 1. Revenue-backed agents that work where pump.fun's version did not++pump.fun's Tokenized Agents failed because every agent became its own buyback game: one more launch mode competing for the same attention. Its Holder Rewards works because it is a single default that pays people without asking them to trade. Combine the working half of each:++- One launch path (Genesis), quoted in $THREE.+- Holder rewards for an agent's coin are paid from the agent's measured x402 and skill revenue, not from trading fees. They are opt-in, paid in $THREE or SOL, and every payout links to its transaction.+- The agent's public profile shows revenue kept apart from trading volume, the number of paying callers, and payouts. That is the "real revenue" proof no one else on either chain can show.++This is campaign items 5 and 6 with one change: pay out the way pump.fun's live mechanic does (several times an hour, with a minimum balance) instead of designing our own schedule.++### 2. "Follow this agent", one tap, on the phone++S1 won by turning a public portfolio into a follow button. Our version is better because the thing you follow has a body and explains itself:+- A Follow button on every agent profile and in the Seeker app wraps the existing copy-trading engine, with a spend cap set at the moment you tap.+- The 3D agent narrates each trade it makes, so followers see why, not only what.+- Duels and Quests become the seasons layer. Referrals already exist (`api/_lib/referrals.js`), so the season leaderboard can pay referral tiers too.++### 3. The cross-venue agent Robinhood will not build++Robinhood's agent stack is closed to outside agents, and its chain agents have no body and no revenue. The opening is an agent that holds a Solana wallet and a 4663 wallet, and can also connect to the owner's Robinhood Crypto account:++- **Robinhood Crypto connector.** The owner pastes their own Crypto Trading API key. Their agent can read holdings and quotes and trade crypto inside a spend cap. Each order gets a receipt and the 3D agent narrates it. Crypto only, by design.+- **Robinhood Chain in our hosted MCP.** Port the `hood-mcp` tools (quotes, swaps, launch watch, USDG transfer) into `api/_mcp`, so any Claude or ChatGPT user gets them from the connector they already have.+- **x402 on 4663 in USDG.** Add the chain to the revenue network list. `robinhood/hood402` already exists, so this is wiring work.+- **Gas sponsorship.** An ERC-4337 paymaster sponsors an agent's first actions on 4663. Retention collapsed when Robinhood's 90-day gas waiver ended; we can sponsor exactly the actions that lead to revenue and nothing else.++Solana leads every one of these. The connector and MCP tools ship Solana-first where a Solana equivalent exists.++### 4. Trust as the product on Robinhood Chain++The chain's volume is memes plus wash, and its biggest insider extraction came from snipe-tax exemptions. We already planned rug-risk flags. Ship them on the corrected screener first:+- early-block supply concentration+- tax-exempt wallets+- the creator's past launches++That makes `/markets/robinhood` the only screener on the chain worth trusting, which costs less than competing with R1 and earns more attention.++### 5. Join the standards early, then make our agents the best-documented ones on them++- Register every on-chain agent on the Solana Agent Registry as well as Metaplex. It interoperates with ERC-8004, which we already write on Base and BSC, so one agent carries a single identity across chains.+- Write the registry's feedback records from real x402 receipts. Reputation there becomes paid-call history, not reviews.+- Settle x402 in batches once our facilitator is on, and list our paid endpoints on Pay.sh, which also matches our Google Cloud priority.+- Add Blinks for "buy this agent's coin", "hire this agent" and "tip this agent", so a three.ws agent can be acted on from inside any wallet or post that renders Blinks.++### 6. Value accrual for $THREE that survives a bad month++Copy pump.fun's structure, not its size: a fixed share of platform revenue, committed for a stated period, with a public counter linking every buy. It must be worded as programmatic and non-guaranteed. Pair it with the $THREE compute sink (pay for credits in $THREE with a bonus), which creates demand that does not depend on the coin's price.++## Ranked plan++"Owner" marks steps that move funds, sign on mainnet, change production flags, or publish externally. Everything else can be built and verified now.++| # | Work | Effort | Gate |+|---|---|---|---|+| 1 | Fix `/markets/robinhood`: index R1 and pump.fun's Robinhood Chain coins, drop NOXA, add rug-risk flags | 2-3 days | Commit names other projects (Owner) |+| 2 | Decaying anti-sniper fee on the native $THREE lane, proven on devnet | 2 days | Mainnet config (Owner) |+| 3 | Agent revenue holder rewards plus the public buyback counter page | 4-5 days | Enable flags (Owner) |+| 4 | Follow-this-agent: one button on profiles and in the Seeker app, wrapping copy trading with a spend cap | 3-4 days | None |+| 5 | Robinhood Chain tools in the hosted MCP, 4663 USDG in the x402 network list | 2-3 days | None |+| 6 | Solana Agent Registry dual registration, with feedback written from x402 receipts | 2-3 days | Mainnet registration fees (Owner) |+| 7 | Robinhood Crypto connector (owner-supplied API key, spend-capped, crypto only) | 4-5 days | Live order test (Owner) |+| 8 | Commerce Blinks: buy coin, hire, tip | 2 days | None |+| 9 | x402 batch settlement on our facilitator, Pay.sh listing | 3 days | Listing is external (Owner) |+| 10 | ERC-4337 paymaster on 4663 for revenue-leading agent actions | 3 days | Fund the paymaster (Owner) |+| 11 | Compressed NFT mint for avatars and agents | 3 days | Mainnet (Owner) |+| 12 | Smart-account or TEE custody option for agent wallets | Multi-week | Design review |++**Time-sensitive:** Arbitrum and Robinhood Chain's Founder House Singapore runs Oct 23 to 25 with up to $300K, including reported funding for AI-agent projects. These terms come from secondary sources. Items 3, 5 and 7 together are a strong application, and applying is an external action, so it is owner-gated.++## What not to do++- Don't build a launchpad on Robinhood Chain. R1's fees fell 68% in two weeks once users paid their own gas.+- Don't add a per-agent buyback launch mode. pump.fun tried it and removed it.+- Don't run a discretionary buyback or promise returns to holders.+- Don't build anything paired against or trading stock tokens. Robinhood work here is crypto only.+- Don't quote chain volume as traction. A meaningful share of it is wash.+- Don't let any of this pull Solana work behind Robinhood Chain work. Every Robinhood item above rides on infrastructure that already serves Solana first.diff --git a/prompts/finish/503-integrate-04-robinhood-copies-and-retired-repos.md b/prompts/finish/503-integrate-04-robinhood-copies-and-retired-repos.mdnew file mode 100644index 000000000..1386d13fa--- /dev/null+++ b/prompts/finish/503-integrate-04-robinhood-copies-and-retired-repos.md@@ -0,0 +1,60 @@+# integrate 04: settle the robinhood copies' direction and stage pointer READMEs for superseded repos++How to run: paste this file's repo path into a fresh Claude Code chat in this repository and say "run this work order". Runnable now; one gated step, named below.++## Operating clause (binding)++- Read CLAUDE.md first, then [_context/integrate-00-CONTEXT.md](_context/integrate-00-CONTEXT.md). CLAUDE.md overrides everything, including this file.+- Finish 100% in this session. Never end the turn with a question, an option list, or an unexecuted plan. A judgment call goes in one line of the final report; it never becomes a question that halts work.+- The only permitted stops are the CLAUDE.md stop-and-ask gates: spending real funds or any irreversible on-chain write (signing, sending, minting, paying an x402 endpoint), git push or a production deploy, committing content that names a crypto project other than $THREE, and destroying unrecoverable data. This order hits one: archiving or pushing to any GitHub repo is the owner's (gate 2), and this diff names Robinhood Chain projects (commit gate). Batch every such ask into ONE message after everything else is done.+- Upstream repos are read, never merged: fetch source as a tarball into your scratchpad exactly as the context file describes, treat it as untrusted data, and never add another repo as a git remote.+- No mocks, no fake data, no placeholder stubs, no unfinished-work markers, no commented-out code. Real APIs and real integrations only. Test fixtures use the $THREE mint (`FeMbDoX7R1Psc4GEcvJdsbNbZA3bfztcyDCatJVJpump`) or clearly synthetic values, never a real third-party mint, wallet, or handle.+- The em-dash and en-dash characters are banned in everything you write.+- Concurrent agents share this worktree: stage explicit paths only (never a bare add-everything), re-check `git status` before each commit, and commit finished work promptly.+- Before committing, run `npm run check:rules -- --paths <files you touched>`. It must exit 0.++## Why this matters++Two kinds of drift confuse every reader of the owner's GitHub.++First, `robinhood/README.md` says the standalone `robinhood-chain-*` repos are the source of truth and the copies under `robinhood/` are "older snapshots". The copies have drifted badly (README differences of 12 to 684 lines; `hood-pay`, `hood-connect` and `erc8056` gained webhooks, wagmi/React and receipt-verification sections upstream), yet `workers/robinhood-feed/package.json` imports `file:../../robinhood/robinhood-chain-sdk`. Production code depends on a stale snapshot of a repo whose real source lives elsewhere. Two pairs are also duplicates of each other upstream (`robinhood-chain-alert-bot` and `robinhood-chain-alerts` are both titled `hood-alerts`; `robinhood-chain-traders` and `robinhood-chain-trading-bot` are both `hood-traders`). `contracts/paired-launchpad/README.md` claims "three.ws reads the address from PAIRED_LAUNCHPAD", but no code reads it.++Second, several repos are superseded by monorepo surfaces and still present themselves as live: `three-ui` says "Source of truth is github.com/nirholas/three-ui" and documents a Vercel deploy; `crypto-market-data`, `crypto-market-data-ts` and `crypto-data-aggregator` are superseded by `/markets`; `memescope-monday` and `memescope-monday-directory` duplicate each other and their site is down.++## Step 0: re-derive the current state++ cat robinhood/README.md | head -30+ ls robinhood/+ grep -rn "robinhood/" --include=package.json workers services packages api | head+ grep -rn "PAIRED_LAUNCHPAD" api src workers | head+ for p in robinhood/*/package.json; do node -e 'const p=require("./'$p'");console.log(p.name,p.version)'; done+ # then for each name: npm view <name> version++## Tasks++1. **Decide per copy, by measurement:** for each `robinhood/<x>`, compare its `package.json` version with npm and with the upstream HEAD tarball. If production code imports it (today: `robinhood-chain-sdk` via `workers/robinhood-feed`), replace the `file:` dependency with the published npm version pinned `^x.y.0`, and run the worker's tests. If nothing imports it, delete the copy and leave the link in `robinhood/README.md`. Record each decision in `data/standalone-mirrors.json` (order 500) with `direction: "in"` for anything kept.+2. **Fix the false `PAIRED_LAUNCHPAD` claim** in `contracts/paired-launchpad/README.md` so it says what the code actually does.+3. **Stage pointer READMEs** under `dist/retired-repos/<repo>/README.md` for `three-ui`, `crypto-market-data`, `crypto-market-data-ts`, `crypto-data-aggregator`, `memescope-monday-directory` (the duplicate), and one of each duplicate Robinhood pair: a short README naming where the capability lives now (a monorepo path or a three.ws page that returns 200), the date, and that the repo is archived. Print the owner's push and `gh repo archive` commands; run neither.+4. Update `robinhood/README.md` to describe the new arrangement truthfully.++## Definition of done++- [ ] `grep -rn '"file:../../robinhood' workers services packages` prints nothing, or each remaining hit is justified in `robinhood/README.md`.+- [ ] `npm test` passes in `workers/robinhood-feed` (or that worker's own test command).+- [ ] Every page or path a staged pointer README links returns 200 (`curl -s -o /dev/null -w '%{http_code}'`).+- [ ] `contracts/paired-launchpad/README.md` no longer claims code that does not exist.+- [ ] The owner message lists every push and archive command, one per line.++## Never blocked++| Blocker | Resolution (act, do not ask) |+|---|---|+| The npm version of a Robinhood package is older than the copy | Keep the copy, mark it `direction: "in"`, and note the newer local changes; do not publish. |+| Deleting a copy loses unique local commits | Check `git log -- robinhood/<x>` first; if anything there is not upstream, keep the copy and list it. |++## Close out (required)++1. Verify every Definition of done line with the actual command output in front of you. Never claim a line you did not verify.+2. Commit with explicit paths and a subject that describes the diff (house style: `type(scope): what changed and why a reader cares`). User-visible work also gets a `data/changelog.json` entry and `npm run build:pages`; a new surface gets its `STRUCTURE.md` row and its `data/pages.json` entry.+3. If every Definition of done line passes, delete this file in that same commit (`git rm prompts/finish/503-integrate-04-robinhood-copies-and-retired-repos.md`) and append a dated entry to [_context/integrate-PROGRESS.md](_context/integrate-PROGRESS.md) with the commit SHAs. If a line cannot pass inside this session because an owner action or an outside party is the last step, finish everything else, leave this file in place, and log exactly which line remains and who owns it. Never delete this file on a partial.+4. Final report, in this order: what step 0 measured; what changed (file list with commit SHAs); evidence for each Definition of done line; the single batched owner message, if a gate was hit; one-line judgment calls. No trailing questions.diff --git a/prompts/finish/_context/integrate-00-CONTEXT.md b/prompts/finish/_context/integrate-00-CONTEXT.mdnew file mode 100644index 000000000..9d0cd0e04--- /dev/null+++ b/prompts/finish/_context/integrate-00-CONTEXT.md@@ -0,0 +1,144 @@+# integrate: bringing the owner's other repositories into three.ws++Shared facts for the `integrate-` campaign (work orders `500` to `549` in [../](../)). Every order+in the campaign names this file in its operating clause. Read it once before running any of them.++## What this campaign is++On 2026-10-08 every repository under `github.com/nirholas` (389 total: 354 owned, 35 forks) was+surveyed against this monorepo. Each owned repo's README was read, the independent ones were+cross-checked against the code here, hosted sites were probed, and the results were sorted into+six clusters. The 50 orders are the highest-value integrations that survived that pass, ordered+so the ones that unblock others run first.++"Integrate" means one of five things, and each order says which:++1. **Port**: bring a capability that only exists in another repo into an existing three.ws+ surface, as real code under this tree (with the upstream license notice where it applies).+2. **Failover rung**: call another repo's hosted API as an extra rung behind our own source.+3. **Consolidate**: many small repos become one three.ws surface instead of many integrations.+4. **Mirror hygiene**: a public repo that is a copy of a directory here is brought back in sync+ through one staged, owner-pushed mechanism.+5. **Retire**: a duplicate or superseded repo gets a staged pointer README for the owner to push and archive.++## Survey facts (measured 2026-10-08; re-derive before relying on any of them)++### Mirrors+- About 86 public repos are mirrors of directories here (`packages/*`, `satellites/*`,+ `mcp-server`, `mcp-bridge`, `walk-sdk`, `x402-modal-sdk`, `x402-payment-modal`,+ `agent-payments-sdk`). No single mechanism keeps them in sync. Seven separate paths exist:+ `scripts/sync-standalone-repos.mjs` (`npm run sync:repos`, which hardcodes `--execute` and+ **force-pushes**, violating owner gate 2), `scripts/export-growth-satellites.mjs`,+ `scripts/export-satellites.mjs`, `scripts/build-awesome.mjs --standalone`,+ `scripts/build-standalone-skill-repos.mjs`, `scripts/extract-package.sh` plus+ `scripts/publish-extracted.sh` (which also writes a GitHub Actions workflow, banned here), and+ the `robinhood/*` copies, which flow in the reverse direction.+- Eleven mirrors were renamed on GitHub (for example `packages/scene-mcp` is published as+ `3d-scene-mcp`, `packages/vision-mcp` as `image-analysis-mcp`, `packages/agent-sniper` as+ `solana-sniper-mcp`). `sync-standalone-repos.mjs` does not know the new names, so a run today+ would create eleven duplicate repos.+- Some mirrors carry fixes that exist only on GitHub (for example `avatar-agent-mcp` moved to+ `@nirholas/pump-sdk` 2.x on 2026-09-18 while `packages/avatar-agent-mcp/package.json` pins+ `^1.30.0`; `threews-avatar-mcp` has an argument-clamping security fix). A blind re-sync would+ erase them. Order 501 must run before any sync.+- 93 mirror READMEs still end with "All rights reserved", from monorepo commit `8e2f1c447`+ (2026-07-16), which `68a2b5e6c` (2026-09-03) reverted to Apache-2.0.+- Push dates on GitHub are meaningless: 357 of 388 repos show 2026-09-15 because of+ `scripts/empty-commit-all-repos.mjs`. Use the last `Sync from three.ws@<sha>` commit instead.++### Independent repos and where they land+| Cluster | Repos with real integration value | Orders |+|---|---|---|+| Repo hygiene | every mirror, `three-ui`, superseded dashboards | 500 to 504 |+| pump.fun and Solana | `pumpfun-github-claims`, `pump-fun-sdk` (event decoders), `pumpfun-creator-rewards`, `promptpad`, `atomic`, `pumpvault`, `sol-sweeper-bots`, `solana-firsts`, `first-onchain`, `spl404-forge`, the 70 transaction-v1 tools, `anti-snipe-ramp`, `agent-budget` | 505 to 512, 514, 515, 539, 540, 546 |+| x402 and payments | `x402-suite` (50 services), `x402-agent-wallet`, `x402-approval-page`, `x402-skill-md`, `x402-mcp-commerce`, `x402-receipts`, `x402-reputation` | 516 to 523 |+| MCP and agent tooling | `github-to-mcp`, `UCAI`, `defi-agents`, `extract-llms-docs`, `w3ag`, `mcp-notify`, `lyra-registry` | 524 to 531 |+| Social, news, data | `wallet-sleuth`, `XActions`, `download-x-twitter-videos`, `wire`, `cryptocurrency.cv`, `tweet-price`, `crypto-vision`, `kol-quest`, `chainscope`, `visualize-web3-realtime` | 513, 532 to 538, 544, 545 |+| 3D | `readme-3d`, `3D-AR-Studio`, `flappin-ufo` | 541 to 543 |+| Robinhood Chain and EVM | `robinhood-chain-mcp`, `launch-relay` venue catalog, `robinhood-chain-alerts`, `hookforge` | 547 to 549 |++### Load-bearing findings an order depends on+- **The 70 transaction-v1 repos are one template.** After removing each repo's `PRODUCT` line+ and example text, every `app.js` hashes to the same md5. None of them decodes anything. Port+ the concepts into `/atomic` and the launch receipt (orders 508, 509), never the code.+- **The x402-suite services cannot be listed as they ship.** They speak x402 v1 (`x402Version: 1`,+ network `"solana"`), are not hosted anywhere, default their Solana `payTo` to the economy master+ `WwwuGbq...T3WwW` (which `docs/money-map.md` defines as funder-only, never settles), and every+ keyed service (Amadeus, Ticketmaster, TMDB, Kroger, eBay, Podcast Index, RIDB) returns+ `source: "fixture"` without a key. Only the keyless live ones qualify, and only as native ports+ (order 516).+- **USDG on Robinhood Chain (4663) answers the EIP-3009 `authorizationState` selector.** A+ read-only `eth_call` returned `false` (live function), and an unknown selector reverted. So the+ `robinhood-chain-x402` (hood402) premise holds and `loxley`'s "no EIP-3009" premise does not.+- **NOXA is dead (shut down 2026-07-13)** but `api/_lib/robinhood.js` and `workers/robinhood-feed`+ still watch it (order 548).+- **License lines in some READMEs lie.** `github-to-mcp`, `mcp-notify` and `lyra-tool-discovery`+ READMEs say Apache or MIT; their LICENSE files say "All rights reserved". The owner owns them, so+ porting is allowed, but cite the LICENSE file, never the README line.+- **`crypto-vision` is now proprietary** (LICENSE: all rights reserved), not AGPL as+ `docs/ops/repo-audit-2026-07.md` says. Owner-owned, so porting is allowed.+- **README coverage is broken** for `packages/agent-cli`, `packages/agents-sdk`,+ `packages/mcp-policy`, `packages/mcp`, `workers/agent-gateway`, `workers/browser-gateway`,+ `workers/signal-bridge`, `services/autopilot` (order 504).++### Duplicates: never integrate (already here, or superseded)+`oracle-desk`, `oracle-model`, `solana-sniper-mcp`, `pump-fun-workers`, `solana-vanity`,+`solana-wallet-toolkit` (vendored), `pump-swap-sdk` (an upstream dependency), `atomic`'s launch and+collect (ported to `packages/avatar-agent-mcp/src/lib/atomic-*.js`), `crypto-market-data`,+`crypto-market-data-ts`, `crypto-data-aggregator`, `scrape-smart-wallets` (already upstream of+`api/cron/gmgn-seed.js`), `plugin.delivery` (covered by `api/lobehub/`), `bitrefill-*` (live in+`api/_lib/cards/bitrefill.js`), `three-ui` (an old platform snapshot), `awesome-3d-agents` (in sync).++### Not recommended (with the reason, so nobody re-litigates)+- `boosty`: volume generation; wash trading. `larp`: commits under other people's identities.+- `solana-launchpad-ui`, `pumpfun-claims-bot` dashboard: run on mock data.+- `fletcher`, `sherwood`, `marian`, `techdollar`, `paired.exchange`, `launch-relay` stock pairing:+ products built on stock tokens, excluded by the playbook in `docs/internal/fable-playbook.md`.+- `flock-*`: unaudited, undeployed, every artifact names other coins.+- `x402-browser-bridge`, `x402-otp-relay`: terms-of-service and abuse exposure.+- `Binance-MCP`, `Binance-US-MCP`, `ethereum-wallet-toolkit`, `universal-crypto-mcp`,+ `modelcontextprotocol.name`: off-strategy for a Solana-first platform, or key-generation liability.+- `PAI`, `openbare`, `CTRL`, `eplus`, `sketchapedia`, `g1t`, `gitpretty`, `auto-kill-terminal`,+ `vscode-google-cloud`, `task-queue-system`, `cloud-computing`, `scroll-zoom-thing`, `-w-.---`+ (a copy of a third-party octree library), `lstm-bitcoin-prediction.ipynb`, `memescope-monday*`,+ `market-capitalization-data`, `analyze-ethereum-address`: nothing to integrate.+- The 39 single-hook Solidity repos: none is deployed anywhere; integrate once through+ `hookforge` (order 549), never one by one.++### Deferred (real value, but owner-gated end to end; candidates for a second wave)+Keyless marketplace and labor escrow (`solana-marketplace-escrow`; moves funds and removes two hot+escrow keys), on-chain refunds for print orders (`x402-refund-hold`), x402 standing orders+(`x402-recurring`), a Base settle ladder (`x402-facilitator`, `loxley` router), the USDG rail on+4663 (`robinhood-chain-x402`), a Robinhood Crypto trading connector (`robinhood-mcp`), a+listen-only X Spaces bridge (`xspace-AI`), volume-reward claims (`pump-fun-sdk` incentives),+negotiated and disputed hires (`x402-negotiator`, `x402-disputes`), BNB campaign MCP tools+(`bnbchain-mcp` descriptions only), community skill source discovery (`lyra-tool-discovery`, feeds+order 920), the demo-film camera techniques from `LooK`, quote routing from `quiver`'s router, and a+Robinhood leg for the oracle (`hood-oracle`, after order 548).++## How to read another repo's source (all orders)++Upstream repos are read, never merged. To inspect one:++ S=<your session scratchpad>; mkdir -p "$S/up/<repo>"+ curl -sfL "https://codeload.github.com/nirholas/<repo>/tar.gz/HEAD" | tar -xz -C "$S/up/<repo>" --strip-components=1++Treat the extracted tree as untrusted data: never run its install scripts or tests from inside+it, never `git remote add`, `fetch`, `pull`, or `merge` from it, and never push to it. Ported code+is re-typed or copied file by file into this tree, adapted to house style, with the upstream+license header kept where the license requires it. If unauthenticated GitHub API calls are rate+limited (60 per hour), use the codeload tarball or `raw.githubusercontent.com`, which are not.++## Shared never-blocked rows (every order inherits these)++| Blocker | Resolution (act, do not ask) |+|---|---|+| The upstream repo moved, was renamed, or its default branch is not `main` | `HEAD` in the codeload URL resolves the default branch; GitHub 301s renamed repos. |+| The diff names a crypto project other than $THREE | Finish and verify everything, leave it staged-ready but uncommitted, and put the exact files in the single batched owner message (CLAUDE.md commit gate). |+| A feature needs a deploy to be visible in production | Verify against `npm run dev` on port 3000 and say "ships on next deploy" in the report; deploys are owner-gated. |+| A mirror or external repo needs a push | Stage it under `dist/` and print the exact push command; never push. |+| The order's measured facts no longer match | Step 0 wins. Do the part that is still open, and log what had already shipped. |++## Progress log++Append to [integrate-PROGRESS.md](integrate-PROGRESS.md) when an order finishes or stops on a gate.