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(changelog): tell holders the contributor guide now hands out real open work
nirholas1cf4a1fd415e
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex 8ed3e293a..4ae3ec062 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -7,6 +7,7 @@ Public history for [three.ws](https://three.ws), newest first. New pages come fr## 2026-08-25- **Docs · The $THREE thesis** (`/docs/three-thesis`): The long-form case for $THREE: what three.ws is, every utility and sink the token has, how platform revenue routes into buybacks, where it trades and is verified, the ecosystem footprint, the roadmap, and every risk the platform documents about itself.+- **The first-contribution guide now hands you real open work, and the docs sidebar can find it**: The 15-minute contributor guide walked through adding MikuMikuDance rig support as its example, but that support had already shipped, so anyone following it literally would have re-done merged work and been told a bone was unmapped when it was not. It now shows the MMD change as the finished reference, exactly as it landed with its tests, and points you at two rig conventions that are genuinely still open, each with the bones that fail today. The community, triage, and first-contribution pages also appear in the docs sidebar under Guides instead of being reachable only from the README, and the triage page now explains every label the repo actually uses. (`/docs/first-contribution`) `[docs, fix]`- **The full $THREE thesis is now a single document**: A long-form research thesis on $THREE now lives in the docs: what three.ws is, every way the token is used (hold-to-access tiers, plan and pass discounts, marketplace and labor escrow, game cosmetics, gated embeds, deploy-fee waivers), how platform revenue is routed into buybacks, where the token trades and is verified, the ecosystem footprint, the roadmap, and every risk the platform documents about itself, each claim sourced to the code. (`/three-token`) `[docs]`## 2026-08-24diff --git a/data/changelog.json b/data/changelog.jsonindex a85b05266..6685d6ee7 100644--- a/data/changelog.json+++ b/data/changelog.json@@ -1,6 +1,16 @@{"$comment": "Curated changelog entries for three.ws, the editorial layer of the public changelog. New PAGE launches are tracked automatically via the `added` field in data/pages.json; this file is for everything else holders care about: improvements, fixes, SDK releases, trading/payments capabilities, security work. scripts/build-page-index.mjs merges both sources into CHANGELOG.md, public/changelog.json, and public/changelog.xml. Newest first. Allowed tags: feature, improvement, fix, sdk, infra, docs, security. `link` is optional and must be a live three.ws path.","entries": [+ {+ "date": "2026-08-25",+ "title": "The first-contribution guide now hands you real open work, and the docs sidebar can find it",+ "summary": "The 15-minute contributor guide walked through adding MikuMikuDance rig support as its example, but that support had already shipped, so anyone following it literally would have re-done merged work and been told a bone was unmapped when it was not. It now shows the MMD change as the finished reference, exactly as it landed with its tests, and points you at two rig conventions that are genuinely still open, each with the bones that fail today. The community, triage, and first-contribution pages also appear in the docs sidebar under Guides instead of being reachable only from the README, and the triage page now explains every label the repo actually uses.",+ "tags": [+ "docs",+ "fix"+ ],+ "link": "/docs/first-contribution"+ },{"date": "2026-08-24","title": "The pump.fun pill mascot is now a rigged, drivable avatar at /pill",diff --git a/docs/ALL.md b/docs/ALL.mdindex a83454986..256d2a87a 100644--- a/docs/ALL.md+++ b/docs/ALL.md@@ -1,7 +1,7 @@<!-- GENERATED by scripts/combine-docs.mjs — do not edit by hand. Edit the source files under docs/ and re-run. --># three.ws — Combined Documentation-> Single-file snapshot of every document under [`docs/`](.). Generated 2026-08-22 from **557 files** (~7839 KB).+> Single-file snapshot of every document under [`docs/`](.). Generated 2026-08-25 from **559 files** (~7906 KB).> The individual source files remain the canonical, editable copies — this file is a read-only aggregate.## Table of contents@@ -152,180 +152,183 @@- [hold-to-access.md](#sec-241)- [how-forge-works.md](#sec-242)- [how-it-works.md](#sec-243)-- [i18n.md](#sec-244)-- [ibm-community-article.md](#sec-245)-- [ibm-community-blog-meetup-jessica.md](#sec-246)-- [ibm-community-live-reaction-jessica.md](#sec-247)-- [ibm-community-recap-jessica.md](#sec-248)-- [ibm-community-recap-nichxbt.md](#sec-249)-- [ibm-community-thread.md](#sec-250)-- [ibm-community.md](#sec-251)-- [ibm-x402-mcp.md](#sec-252)-- [ibm.md](#sec-253)-- [image-to-3d.md](#sec-254)-- [in-game-economy.md](#sec-255)-- [inference-node-operator.md](#sec-256)-- [integrations.md](#sec-257)-- [introduction.md](#sec-258)-- [irl.md](#sec-259)-- [js-api.md](#sec-261)-- [kol-tracker.md](#sec-262)-- [labor-market.md](#sec-263)-- [launch-usecases.md](#sec-264)-- [layers.md](#sec-265)-- [likeness-eval.md](#sec-266)-- [lipsync.md](#sec-267)-- [liquid-glass.md](#sec-268)-- [listings.md](#sec-269)-- [live-docs.md](#sec-270)-- [live-steps.md](#sec-271)-- [make-your-agent.md](#sec-272)-- [market-data-api.md](#sec-273)-- [marketplace.md](#sec-274)-- [mcp-3d-studio.md](#sec-275)-- [mcp-agent.md](#sec-276)-- [mcp-safety.md](#sec-277)-- [mcp-studio.md](#sec-278)-- [mcp-tools.md](#sec-279)-- [mcp-x402-bazaar.md](#sec-280)-- [mcp.md](#sec-281)-- [media-api.md](#sec-282)-- [memetic-launcher.md](#sec-283)-- [memory.md](#sec-284)-- [meta-allocator.md](#sec-285)-- [mint-mark.md](#sec-286)-- [minted.md](#sec-287)-- [mocap-studio.md](#sec-288)-- [money-feed.md](#sec-289)-- [money-flow-map.md](#sec-290)-- [money-map.md](#sec-291)-- [monitor.md](#sec-292)-- [motion-swap.md](#sec-293)-- [multi-agent.md](#sec-294)-- [native-launchpad.md](#sec-295)-- [news-rights.md](#sec-296)-- [notifications.md](#sec-297)-- [nvidia-apps-catalog-listing.md](#sec-298)-- [nvidia-apps-catalog-request.md](#sec-299)-- [nvidia-inception.md](#sec-300)-- [nvidia-models.md](#sec-301)-- [nvidia-nemotron-ask-the-experts-questions.md](#sec-302)-- [nvidia-nemotron-spotlight.md](#sec-303)-- [nvidia-visibility-map.md](#sec-304)-- [object-library.md](#sec-305)-- [okx-marketplace.md](#sec-306)-- [onboarding-tier.md](#sec-307)-- [onchain-agents.md](#sec-308)-- [open-source-friday-plan.md](#sec-309)-- [openai-listing-channels.md](#sec-310)-- [oracle-trading-mcp-plan.md](#sec-319)-- [oracle.md](#sec-320)-- [overlay-audit.md](#sec-321)-- [package-extraction.md](#sec-322)-- [partners.md](#sec-323)-- [pay-skills-listing.md](#sec-325)-- [payment-sessions.md](#sec-326)-- [permissions.md](#sec-327)-- [persona-hub.md](#sec-328)-- [plan-checkout.md](#sec-329)-- [play-boot-performance.md](#sec-330)-- [play-forge-in-world.md](#sec-331)-- [play-hardening.md](#sec-332)-- [play-live-events.md](#sec-333)-- [play-vehicles.md](#sec-334)-- [popular-3d-github-repos.md](#sec-335)-- [portfolio.md](#sec-336)-- [premium.md](#sec-337)-- [press-kit.md](#sec-338)-- [procedural-animation.md](#sec-339)-- [provenance.md](#sec-340)-- [pump-claims-channel.md](#sec-341)-- [pump-fun-mcp-edge.md](#sec-342)-- [pump-launch-repos.md](#sec-343)-- [pump-launcher.md](#sec-344)-- [pump-platform-fee.md](#sec-345)-- [quick-start.md](#sec-366)-- [radar.md](#sec-367)-- [reasoning-ledger.md](#sec-368)-- [recurring-payments.md](#sec-369)-- [remix.md](#sec-370)-- [reputation-staking-market.md](#sec-371)-- [reputation.md](#sec-372)-- [restyle.md](#sec-373)-- [rig-doctor.md](#sec-374)-- [risk-acknowledgment.md](#sec-375)-- [robinhood-chain-markets.md](#sec-376)-- [sas-attestations.md](#sec-377)-- [scene-studio.md](#sec-378)-- [sdk.md](#sec-379)-- [security.md](#sec-380)-- [seed-quality.md](#sec-381)-- [selfie-to-avatar.md](#sec-382)-- [share-and-embed.md](#sec-383)-- [shared-utilities.md](#sec-384)-- [showcase.md](#sec-385)-- [sign-language.md](#sec-386)-- [signals.md](#sec-387)-- [site-performance.md](#sec-388)-- [sketchfab.md](#sec-389)-- [skill-bundles.md](#sec-390)-- [skill-royalties.md](#sec-391)-- [skills.md](#sec-392)-- [smart-contracts.md](#sec-393)-- [smart-money.md](#sec-394)-- [sniper-autonomy.md](#sec-395)-- [social-layer.md](#sec-396)-- [solana-pumpfun.md](#sec-397)-- [solana-reputation.md](#sec-398)-- [solana.md](#sec-399)-- [spatial-mcp.md](#sec-400)-- [splat.md](#sec-402)-- [stage.md](#sec-403)-- [start-here.md](#sec-404)-- [strategy-objects.md](#sec-405)-- [swarms.md](#sec-406)-- [syndication.md](#sec-407)-- [talking-avatar-video.md](#sec-408)-- [terminal.md](#sec-409)-- [three-microbuy.md](#sec-410)-- [timeline.md](#sec-411)-- [token-gated-3d-embeds.md](#sec-412)-- [tokens-xyz.md](#sec-413)-- [trader-card.md](#sec-414)-- [trader-passport.md](#sec-415)-- [trading-arenas.md](#sec-416)-- [trading-copilot.md](#sec-417)-- [trading-experiment.md](#sec-418)-- [trading-hub.md](#sec-419)-- [trading-surfaces.md](#sec-420)-- [triage.md](#sec-421)-- [troubleshooting.md](#sec-422)-- [trust-primitives.md](#sec-423)-- [ui-juice.md](#sec-493)-- [user-wallet.md](#sec-494)-- [validation.md](#sec-507)-- [vanity.md](#sec-508)-- [vaults.md](#sec-509)-- [viability.md](#sec-510)-- [viewer.md](#sec-511)-- [voice-lab.md](#sec-512)-- [walk-leaderboard.md](#sec-513)-- [web-component.md](#sec-514)-- [widget-api.md](#sec-515)-- [widget-studio.md](#sec-516)-- [widgets.md](#sec-517)-- [world-lines.md](#sec-518)-- [x-archive.md](#sec-519)-- [x-memory-seeding.md](#sec-521)-- [x402-buyer.md](#sec-544)-- [x402-dev-tools.md](#sec-545)-- [x402-distribution.md](#sec-546)-- [x402-endpoints.md](#sec-547)-- [x402-revenue.md](#sec-548)-- [x402-ring-economy.md](#sec-549)-- [x402-solana-july-roundup-response.md](#sec-550)-- [x402-studio.md](#sec-551)-- [x402.md](#sec-552)+- [huggingface.md](#sec-244)+- [i18n.md](#sec-245)+- [ibm-community-article.md](#sec-246)+- [ibm-community-blog-meetup-jessica.md](#sec-247)+- [ibm-community-live-reaction-jessica.md](#sec-248)+- [ibm-community-recap-jessica.md](#sec-249)+- [ibm-community-recap-nichxbt.md](#sec-250)+- [ibm-community-thread.md](#sec-251)+- [ibm-community.md](#sec-252)+- [ibm-x402-mcp.md](#sec-253)+- [ibm.md](#sec-254)+- [image-to-3d.md](#sec-255)+- [in-game-economy.md](#sec-256)+- [inference-node-operator.md](#sec-257)+- [integrations.md](#sec-258)+- [introduction.md](#sec-259)+- [irl.md](#sec-260)+- [js-api.md](#sec-262)+- [kol-tracker.md](#sec-263)+- [labor-market.md](#sec-264)+- [launch-usecases.md](#sec-265)+- [layers.md](#sec-266)+- [likeness-eval.md](#sec-267)+- [lipsync.md](#sec-268)+- [liquid-glass.md](#sec-269)+- [listings.md](#sec-270)+- [live-docs.md](#sec-271)+- [live-steps.md](#sec-272)+- [make-your-agent.md](#sec-273)+- [market-data-api.md](#sec-274)+- [marketplace.md](#sec-275)+- [mcp-3d-studio.md](#sec-276)+- [mcp-agent.md](#sec-277)+- [mcp-safety.md](#sec-278)+- [mcp-studio.md](#sec-279)+- [mcp-tools.md](#sec-280)+- [mcp-x402-bazaar.md](#sec-281)+- [mcp.md](#sec-282)+- [media-api.md](#sec-283)+- [memetic-launcher.md](#sec-284)+- [memory.md](#sec-285)+- [meta-allocator.md](#sec-286)+- [mint-mark.md](#sec-287)+- [minted.md](#sec-288)+- [mocap-studio.md](#sec-289)+- [money-feed.md](#sec-290)+- [money-flow-map.md](#sec-291)+- [money-map.md](#sec-292)+- [monitor.md](#sec-293)+- [motion-swap.md](#sec-294)+- [multi-agent.md](#sec-295)+- [native-launchpad.md](#sec-296)+- [news-rights.md](#sec-297)+- [notifications.md](#sec-298)+- [nvidia-apps-catalog-listing.md](#sec-299)+- [nvidia-apps-catalog-request.md](#sec-300)+- [nvidia-inception.md](#sec-301)+- [nvidia-models.md](#sec-302)+- [nvidia-nemotron-ask-the-experts-questions.md](#sec-303)+- [nvidia-nemotron-spotlight.md](#sec-304)+- [nvidia-visibility-map.md](#sec-305)+- [object-library.md](#sec-306)+- [okx-marketplace.md](#sec-307)+- [onboarding-tier.md](#sec-308)+- [onchain-agents.md](#sec-309)+- [open-source-friday-plan.md](#sec-310)+- [openai-listing-channels.md](#sec-311)+- [oracle-trading-mcp-plan.md](#sec-320)+- [oracle.md](#sec-321)+- [overlay-audit.md](#sec-322)+- [package-extraction.md](#sec-323)+- [partners.md](#sec-324)+- [pay-skills-listing.md](#sec-326)+- [payment-sessions.md](#sec-327)+- [permissions.md](#sec-328)+- [persona-hub.md](#sec-329)+- [pill-mascot.md](#sec-330)+- [plan-checkout.md](#sec-331)+- [play-boot-performance.md](#sec-332)+- [play-forge-in-world.md](#sec-333)+- [play-hardening.md](#sec-334)+- [play-live-events.md](#sec-335)+- [play-vehicles.md](#sec-336)+- [popular-3d-github-repos.md](#sec-337)+- [portfolio.md](#sec-338)+- [premium.md](#sec-339)+- [press-kit.md](#sec-340)+- [procedural-animation.md](#sec-341)+- [provenance.md](#sec-342)+- [pump-claims-channel.md](#sec-343)+- [pump-fun-mcp-edge.md](#sec-344)+- [pump-launch-repos.md](#sec-345)+- [pump-launcher.md](#sec-346)+- [pump-platform-fee.md](#sec-347)+- [quick-start.md](#sec-368)+- [radar.md](#sec-369)+- [reasoning-ledger.md](#sec-370)+- [recurring-payments.md](#sec-371)+- [remix.md](#sec-372)+- [reputation-staking-market.md](#sec-373)+- [reputation.md](#sec-374)+- [restyle.md](#sec-375)+- [rig-doctor.md](#sec-376)+- [risk-acknowledgment.md](#sec-377)+- [robinhood-chain-markets.md](#sec-378)+- [sas-attestations.md](#sec-379)+- [scene-studio.md](#sec-380)+- [sdk.md](#sec-381)+- [security.md](#sec-382)+- [seed-quality.md](#sec-383)+- [selfie-to-avatar.md](#sec-384)+- [share-and-embed.md](#sec-385)+- [shared-utilities.md](#sec-386)+- [showcase.md](#sec-387)+- [sign-language.md](#sec-388)+- [signals.md](#sec-389)+- [site-performance.md](#sec-390)+- [sketchfab.md](#sec-391)+- [skill-bundles.md](#sec-392)+- [skill-royalties.md](#sec-393)+- [skills.md](#sec-394)+- [smart-contracts.md](#sec-395)+- [smart-money.md](#sec-396)+- [sniper-autonomy.md](#sec-397)+- [social-layer.md](#sec-398)+- [solana-pumpfun.md](#sec-399)+- [solana-reputation.md](#sec-400)+- [solana.md](#sec-401)+- [spatial-mcp.md](#sec-402)+- [splat.md](#sec-404)+- [stage.md](#sec-405)+- [start-here.md](#sec-406)+- [strategy-objects.md](#sec-407)+- [swarms.md](#sec-408)+- [syndication.md](#sec-409)+- [talking-avatar-video.md](#sec-410)+- [terminal.md](#sec-411)+- [three-microbuy.md](#sec-412)+- [three-thesis.md](#sec-413)+- [timeline.md](#sec-414)+- [token-gated-3d-embeds.md](#sec-415)+- [tokens-xyz.md](#sec-416)+- [trader-card.md](#sec-417)+- [trader-passport.md](#sec-418)+- [trading-arenas.md](#sec-419)+- [trading-copilot.md](#sec-420)+- [trading-experiment.md](#sec-421)+- [trading-hub.md](#sec-422)+- [trading-surfaces.md](#sec-423)+- [triage.md](#sec-424)+- [troubleshooting.md](#sec-425)+- [trust-primitives.md](#sec-426)+- [ui-juice.md](#sec-496)+- [user-wallet.md](#sec-497)+- [validation.md](#sec-510)+- [vanity.md](#sec-511)+- [vaults.md](#sec-512)+- [viability.md](#sec-513)+- [viewer.md](#sec-514)+- [voice-lab.md](#sec-515)+- [walk-leaderboard.md](#sec-516)+- [web-component.md](#sec-517)+- [widget-api.md](#sec-518)+- [widget-studio.md](#sec-519)+- [widgets.md](#sec-520)+- [world-lines.md](#sec-521)+- [x-archive.md](#sec-522)+- [x-memory-seeding.md](#sec-524)+- [x402-buyer.md](#sec-546)+- [x402-dev-tools.md](#sec-547)+- [x402-distribution.md](#sec-548)+- [x402-endpoints.md](#sec-549)+- [x402-revenue.md](#sec-550)+- [x402-ring-economy.md](#sec-551)+- [x402-solana-july-roundup-response.md](#sec-552)+- [x402-studio.md](#sec-553)+- [x402.md](#sec-554)### agent-abilities@@ -455,173 +458,172 @@### irl-- [irl/THREAT-MODEL.md](#sec-260)+- [irl/THREAT-MODEL.md](#sec-261)### openai-pr-- [openai-pr/00-START-HERE.md](#sec-311)-- [openai-pr/01-orphan-widget-resolution.md](#sec-312)-- [openai-pr/02-wellknown-manifest-conflict.md](#sec-313)-- [openai-pr/03-forge-free-tier-truth.md](#sec-314)-- [openai-pr/04-openai-surface-test-coverage.md](#sec-315)-- [openai-pr/05-custom-gpt-openapi-serving.md](#sec-316)-- [openai-pr/06-docs-accuracy-reconciliation.md](#sec-317)-- [openai-pr/07-final-verification-and-submit.md](#sec-318)+- [openai-pr/00-START-HERE.md](#sec-312)+- [openai-pr/01-orphan-widget-resolution.md](#sec-313)+- [openai-pr/02-wellknown-manifest-conflict.md](#sec-314)+- [openai-pr/03-forge-free-tier-truth.md](#sec-315)+- [openai-pr/04-openai-surface-test-coverage.md](#sec-316)+- [openai-pr/05-custom-gpt-openapi-serving.md](#sec-317)+- [openai-pr/06-docs-accuracy-reconciliation.md](#sec-318)+- [openai-pr/07-final-verification-and-submit.md](#sec-319)### partners-- [partners/sperax-proposal.md](#sec-324)+- [partners/sperax-proposal.md](#sec-325)### pumpfun-program-- [pumpfun-program/README.md](#sec-346)-- [pumpfun-program/UPSTREAM-buy-sell-v2-announcement.md](#sec-347)-- [pumpfun-program/UPSTREAM-pumpswap-virtual-quote-reserves.md](#sec-348)-- [pumpfun-program/docs/BREAKING_FEE_RECIPIENT.md](#sec-349)-- [pumpfun-program/docs/CPI_README.md](#sec-350)-- [pumpfun-program/docs/FAQ.md](#sec-351)-- [pumpfun-program/docs/FEE_PROGRAM_README.md](#sec-352)-- [pumpfun-program/docs/FEE_RECIPIENTS.md](#sec-353)-- [pumpfun-program/docs/PUMP_CASHBACK_README.md](#sec-354)-- [pumpfun-program/docs/PUMP_CREATOR_FEE_README.md](#sec-355)-- [pumpfun-program/docs/PUMP_PROGRAM_README.md](#sec-356)-- [pumpfun-program/docs/PUMP_SWAP_CREATOR_FEE_README.md](#sec-357)-- [pumpfun-program/docs/PUMP_SWAP_README.md](#sec-358)-- [pumpfun-program/docs/PUMP_SWAP_SDK_README.md](#sec-359)-- [pumpfun-program/docs/instructions/BUY.md](#sec-360)-- [pumpfun-program/docs/instructions/CLAIM_CASHBACK.md](#sec-361)-- [pumpfun-program/docs/instructions/COIN_CREATION.md](#sec-362)-- [pumpfun-program/docs/instructions/COLLECT_CREATOR_FEE.md](#sec-363)-- [pumpfun-program/docs/instructions/CREATOR_FEE_SHARING.md](#sec-364)-- [pumpfun-program/docs/instructions/SELL.md](#sec-365)+- [pumpfun-program/README.md](#sec-348)+- [pumpfun-program/UPSTREAM-buy-sell-v2-announcement.md](#sec-349)+- [pumpfun-program/UPSTREAM-pumpswap-virtual-quote-reserves.md](#sec-350)+- [pumpfun-program/docs/BREAKING_FEE_RECIPIENT.md](#sec-351)+- [pumpfun-program/docs/CPI_README.md](#sec-352)+- [pumpfun-program/docs/FAQ.md](#sec-353)+- [pumpfun-program/docs/FEE_PROGRAM_README.md](#sec-354)+- [pumpfun-program/docs/FEE_RECIPIENTS.md](#sec-355)+- [pumpfun-program/docs/PUMP_CASHBACK_README.md](#sec-356)+- [pumpfun-program/docs/PUMP_CREATOR_FEE_README.md](#sec-357)+- [pumpfun-program/docs/PUMP_PROGRAM_README.md](#sec-358)+- [pumpfun-program/docs/PUMP_SWAP_CREATOR_FEE_README.md](#sec-359)+- [pumpfun-program/docs/PUMP_SWAP_README.md](#sec-360)+- [pumpfun-program/docs/PUMP_SWAP_SDK_README.md](#sec-361)+- [pumpfun-program/docs/instructions/BUY.md](#sec-362)+- [pumpfun-program/docs/instructions/CLAIM_CASHBACK.md](#sec-363)+- [pumpfun-program/docs/instructions/COIN_CREATION.md](#sec-364)+- [pumpfun-program/docs/instructions/COLLECT_CREATOR_FEE.md](#sec-365)+- [pumpfun-program/docs/instructions/CREATOR_FEE_SHARING.md](#sec-366)+- [pumpfun-program/docs/instructions/SELL.md](#sec-367)### specs-- [specs/agent-trading.md](#sec-401)+- [specs/agent-trading.md](#sec-403)### tutorials-- [tutorials/add-a-3d-assistant.md](#sec-424)-- [tutorials/agent-personality.md](#sec-425)-- [tutorials/agent-reputation.md](#sec-426)-- [tutorials/agent-spending-envelope.md](#sec-427)-- [tutorials/animate-your-agent.md](#sec-428)-- [tutorials/animate-your-avatar.md](#sec-429)-- [tutorials/arm-an-agent-sniper.md](#sec-430)-- [tutorials/build-a-3d-asset-pipeline.md](#sec-431)-- [tutorials/build-a-scene.md](#sec-432)-- [tutorials/build-a-site-concierge.md](#sec-433)-- [tutorials/character-library-to-embed.md](#sec-434)-- [tutorials/claim-threews-name.md](#sec-435)-- [tutorials/connect-ai-brain.md](#sec-436)-- [tutorials/create-and-edit-memory.md](#sec-437)-- [tutorials/custom-skill.md](#sec-438)-- [tutorials/customize-appearance.md](#sec-439)-- [tutorials/deploy-to-vercel-custom-domain.md](#sec-440)-- [tutorials/earn-and-spend-in-play.md](#sec-441)-- [tutorials/embed-in-30-seconds.md](#sec-442)-- [tutorials/embed-on-website.md](#sec-443)-- [tutorials/emotion-from-data.md](#sec-444)-- [tutorials/explore-docs-world.md](#sec-445)-- [tutorials/find-a-better-exit-policy.md](#sec-446)-- [tutorials/first-agent.md](#sec-447)-- [tutorials/first-prompt-to-3d.md](#sec-448)-- [tutorials/generate-3d-api.md](#sec-449)-- [tutorials/getting-started.md](#sec-450)-- [tutorials/greeting-and-first-speech.md](#sec-451)-- [tutorials/image-to-3d.md](#sec-452)-- [tutorials/import-avatar-url.md](#sec-453)-- [tutorials/js-api-events.md](#sec-454)-- [tutorials/mcp-server-for-your-agent.md](#sec-455)-- [tutorials/mine-vanity-address.md](#sec-456)-- [tutorials/mint-pumpfun-token.md](#sec-457)-- [tutorials/monetize-mcp-server.md](#sec-458)-- [tutorials/multi-agent-coordination.md](#sec-459)-- [tutorials/nvidia-3d-free.md](#sec-460)-- [tutorials/nvidia-nim-self-host.md](#sec-461)-- [tutorials/paid-x402-endpoint.md](#sec-462)-- [tutorials/pay-for-x402-service.md](#sec-463)-- [tutorials/personal-ai-site.md](#sec-464)-- [tutorials/place-agent-irl.md](#sec-465)-- [tutorials/prompts-for-3d.md](#sec-466)-- [tutorials/read-the-trading-fleet.md](#sec-467)-- [tutorials/register-onchain.md](#sec-468)-- [tutorials/render-avatar-images.md](#sec-469)-- [tutorials/self-host-agent-backend.md](#sec-470)-- [tutorials/selfie-to-avatar.md](#sec-471)-- [tutorials/sell-a-skill-with-a-trial.md](#sec-472)-- [tutorials/share-your-agent.md](#sec-473)-- [tutorials/ship-an-avatar-manifest.md](#sec-474)-- [tutorials/shopify-shopping-assistant.md](#sec-475)-- [tutorials/shopify-store-guide-advanced.md](#sec-476)-- [tutorials/shopify-store-guide.md](#sec-477)-- [tutorials/sign-with-your-avatar.md](#sec-478)-- [tutorials/skill-with-database-auth.md](#sec-479)-- [tutorials/solana-agent-reputation.md](#sec-480)-- [tutorials/sperax-tour.md](#sec-481)-- [tutorials/swap-avatar-in-studio.md](#sec-482)-- [tutorials/text-to-3d.md](#sec-483)-- [tutorials/trigger-from-page-events.md](#sec-484)-- [tutorials/upload-custom-glb.md](#sec-485)-- [tutorials/view-in-ar.md](#sec-486)-- [tutorials/voice-and-lipsync.md](#sec-487)-- [tutorials/walk-companion.md](#sec-488)-- [tutorials/wallet-sign-in.md](#sec-489)-- [tutorials/web-component-end-to-end.md](#sec-490)-- [tutorials/write-a-guard.md](#sec-491)-- [tutorials/x402-server-sdk.md](#sec-492)+- [tutorials/add-a-3d-assistant.md](#sec-427)+- [tutorials/agent-personality.md](#sec-428)+- [tutorials/agent-reputation.md](#sec-429)+- [tutorials/agent-spending-envelope.md](#sec-430)+- [tutorials/animate-your-agent.md](#sec-431)+- [tutorials/animate-your-avatar.md](#sec-432)+- [tutorials/arm-an-agent-sniper.md](#sec-433)+- [tutorials/build-a-3d-asset-pipeline.md](#sec-434)+- [tutorials/build-a-scene.md](#sec-435)+- [tutorials/build-a-site-concierge.md](#sec-436)+- [tutorials/character-library-to-embed.md](#sec-437)+- [tutorials/claim-threews-name.md](#sec-438)+- [tutorials/connect-ai-brain.md](#sec-439)+- [tutorials/create-and-edit-memory.md](#sec-440)+- [tutorials/custom-skill.md](#sec-441)+- [tutorials/customize-appearance.md](#sec-442)+- [tutorials/deploy-to-vercel-custom-domain.md](#sec-443)+- [tutorials/earn-and-spend-in-play.md](#sec-444)+- [tutorials/embed-in-30-seconds.md](#sec-445)+- [tutorials/embed-on-website.md](#sec-446)+- [tutorials/emotion-from-data.md](#sec-447)+- [tutorials/explore-docs-world.md](#sec-448)+- [tutorials/find-a-better-exit-policy.md](#sec-449)+- [tutorials/first-agent.md](#sec-450)+- [tutorials/first-prompt-to-3d.md](#sec-451)+- [tutorials/generate-3d-api.md](#sec-452)+- [tutorials/getting-started.md](#sec-453)+- [tutorials/greeting-and-first-speech.md](#sec-454)+- [tutorials/image-to-3d.md](#sec-455)+- [tutorials/import-avatar-url.md](#sec-456)+- [tutorials/js-api-events.md](#sec-457)+- [tutorials/mcp-server-for-your-agent.md](#sec-458)+- [tutorials/mine-vanity-address.md](#sec-459)+- [tutorials/mint-pumpfun-token.md](#sec-460)+- [tutorials/monetize-mcp-server.md](#sec-461)+- [tutorials/multi-agent-coordination.md](#sec-462)+- [tutorials/nvidia-3d-free.md](#sec-463)+- [tutorials/nvidia-nim-self-host.md](#sec-464)+- [tutorials/paid-x402-endpoint.md](#sec-465)+- [tutorials/pay-for-x402-service.md](#sec-466)+- [tutorials/personal-ai-site.md](#sec-467)+- [tutorials/place-agent-irl.md](#sec-468)+- [tutorials/prompts-for-3d.md](#sec-469)+- [tutorials/read-the-trading-fleet.md](#sec-470)+- [tutorials/register-onchain.md](#sec-471)+- [tutorials/render-avatar-images.md](#sec-472)+- [tutorials/self-host-agent-backend.md](#sec-473)+- [tutorials/selfie-to-avatar.md](#sec-474)+- [tutorials/sell-a-skill-with-a-trial.md](#sec-475)+- [tutorials/share-your-agent.md](#sec-476)+- [tutorials/ship-an-avatar-manifest.md](#sec-477)+- [tutorials/shopify-shopping-assistant.md](#sec-478)+- [tutorials/shopify-store-guide-advanced.md](#sec-479)+- [tutorials/shopify-store-guide.md](#sec-480)+- [tutorials/sign-with-your-avatar.md](#sec-481)+- [tutorials/skill-with-database-auth.md](#sec-482)+- [tutorials/solana-agent-reputation.md](#sec-483)+- [tutorials/sperax-tour.md](#sec-484)+- [tutorials/swap-avatar-in-studio.md](#sec-485)+- [tutorials/text-to-3d.md](#sec-486)+- [tutorials/trigger-from-page-events.md](#sec-487)+- [tutorials/upload-custom-glb.md](#sec-488)+- [tutorials/view-in-ar.md](#sec-489)+- [tutorials/voice-and-lipsync.md](#sec-490)+- [tutorials/walk-companion.md](#sec-491)+- [tutorials/wallet-sign-in.md](#sec-492)+- [tutorials/web-component-end-to-end.md](#sec-493)+- [tutorials/write-a-guard.md](#sec-494)+- [tutorials/x402-server-sdk.md](#sec-495)### ux-flows-- [ux-flows/01-onboarding-creation.md](#sec-495)-- [ux-flows/02-forge-text-to-3d.md](#sec-496)-- [ux-flows/03-3d-editing-viewer.md](#sec-497)-- [ux-flows/04-embed-widget-studio.md](#sec-498)-- [ux-flows/05-discovery-social.md](#sec-499)-- [ux-flows/06-marketplace-skills.md](#sec-500)-- [ux-flows/07-crypto-trading-analytics.md](#sec-501)-- [ux-flows/08-coin-launch-wallets.md](#sec-502)-- [ux-flows/09-x402-agent-commerce.md](#sec-503)-- [ux-flows/10-chat-brain-labs.md](#sec-504)-- [ux-flows/11-account-dashboard.md](#sec-505)-- [ux-flows/12-home-and-content.md](#sec-506)+- [ux-flows/01-onboarding-creation.md](#sec-498)+- [ux-flows/02-forge-text-to-3d.md](#sec-499)+- [ux-flows/03-3d-editing-viewer.md](#sec-500)+- [ux-flows/04-embed-widget-studio.md](#sec-501)+- [ux-flows/05-discovery-social.md](#sec-502)+- [ux-flows/06-marketplace-skills.md](#sec-503)+- [ux-flows/07-crypto-trading-analytics.md](#sec-504)+- [ux-flows/08-coin-launch-wallets.md](#sec-505)+- [ux-flows/09-x402-agent-commerce.md](#sec-506)+- [ux-flows/10-chat-brain-labs.md](#sec-507)+- [ux-flows/11-account-dashboard.md](#sec-508)+- [ux-flows/12-home-and-content.md](#sec-509)### x-archive-- [x-archive/trythreews-engagement.md](#sec-520)+- [x-archive/trythreews-engagement.md](#sec-523)### x-posts-- [x-posts/3d-ar-studio-launch.md](#sec-522)-- [x-posts/3d-ar-studio-video-script.md](#sec-523)-- [x-posts/README.md](#sec-524)-- [x-posts/ar-quick-look-fix-x-post.md](#sec-525)-- [x-posts/coinbase-listing-thank-you-reply.md](#sec-526)-- [x-posts/event-x-posts.md](#sec-527)-- [x-posts/fomo-verified-x-post.md](#sec-528)-- [x-posts/ibm-skillsbuild-x-post.md](#sec-529)-- [x-posts/mcp-registry-fleet-x-post.md](#sec-530)-- [x-posts/metaplex-agent-deployer-video-script.md](#sec-531)-- [x-posts/metaplex-agent-deployer-x-post.md](#sec-532)-- [x-posts/metaplex-agent-mcp-launch.md](#sec-533)-- [x-posts/metaplex-agent-mcp-veo-script.md](#sec-534)-- [x-posts/metaplex-agent-mcp-x-post.md](#sec-535)-- [x-posts/news-archive-x-post.md](#sec-536)-- [x-posts/onchain-agent-wallets-x-post.md](#sec-537)-- [x-posts/oracle-trading-mcp-x-post.md](#sec-538)-- [x-posts/pumpfun-article-x-post.md](#sec-539)-- [x-posts/sperax-staking-in-chat-x-post.md](#sec-540)-- [x-posts/threews-avatar-launch.md](#sec-541)-- [x-posts/threews-avatar-video-script.md](#sec-542)-- [x-posts/x-meetup-posts.md](#sec-543)+- [x-posts/3d-ar-studio-launch.md](#sec-525)+- [x-posts/3d-ar-studio-video-script.md](#sec-526)+- [x-posts/README.md](#sec-527)+- [x-posts/ar-quick-look-fix-x-post.md](#sec-528)+- [x-posts/event-x-posts.md](#sec-529)+- [x-posts/fomo-verified-x-post.md](#sec-530)+- [x-posts/ibm-skillsbuild-x-post.md](#sec-531)+- [x-posts/mcp-registry-fleet-x-post.md](#sec-532)+- [x-posts/metaplex-agent-deployer-video-script.md](#sec-533)+- [x-posts/metaplex-agent-deployer-x-post.md](#sec-534)+- [x-posts/metaplex-agent-mcp-launch.md](#sec-535)+- [x-posts/metaplex-agent-mcp-veo-script.md](#sec-536)+- [x-posts/metaplex-agent-mcp-x-post.md](#sec-537)+- [x-posts/news-archive-x-post.md](#sec-538)+- [x-posts/onchain-agent-wallets-x-post.md](#sec-539)+- [x-posts/oracle-trading-mcp-x-post.md](#sec-540)+- [x-posts/pumpfun-article-x-post.md](#sec-541)+- [x-posts/sperax-staking-in-chat-x-post.md](#sec-542)+- [x-posts/threews-avatar-launch.md](#sec-543)+- [x-posts/threews-avatar-video-script.md](#sec-544)+- [x-posts/x-meetup-posts.md](#sec-545)### zauth-- [zauth/database.md](#sec-553)-- [zauth/index.md](#sec-554)-- [zauth/provider-hub.md](#sec-555)-- [zauth/reposcan.md](#sec-556)-- [zauth/vector.md](#sec-557)+- [zauth/database.md](#sec-555)+- [zauth/index.md](#sec-556)+- [zauth/provider-hub.md](#sec-557)+- [zauth/reposcan.md](#sec-558)+- [zauth/vector.md](#sec-559)---@@ -1187,7 +1189,7 @@ If you just want to add one animation or upload one avatar, the task guides are- [docs/animations.md](#sec-093) — the animation registry, runtime loading, and agent slots.- [docs/avatar-creation.md](#sec-109) — the three ways to create an avatar (photo, builder, upload).-- [docs/tutorials/upload-custom-glb.md](#sec-485) — Mixamo → GLB, validation, and the common failure modes.+- [docs/tutorials/upload-custom-glb.md](#sec-488) — Mixamo → GLB, validation, and the common failure modes.This document is the *why and how* underneath all of those.@@ -1506,11 +1508,11 @@ text/image ──► mesh_forge ──► static GLB ──► rig_mesh ──three.ws runs a full 3D asset pipeline — the same lanes the platform uses to turna prompt into a rigged, game-ready character. Every working stage is sold as its-own [x402](#sec-552) resource: an AI agent pays a few cents in USDC, hands in a URL,+own [x402](#sec-554) resource: an AI agent pays a few cents in USDC, hands in a URL,and gets back a finished asset URL. No API key, no account, no signup.Nobody else in the x402 ecosystem offers this. The generation stage (text/image →-3D) is [`/api/x402/forge`](#sec-547); the stages below are what you do to+3D) is [`/api/x402/forge`](#sec-549); the stages below are what you do toa mesh *after* it exists.```@@ -1523,7 +1525,7 @@ a mesh *after* it exists.1. **One stage at a time** — `POST /api/x402/pipeline-<stage>`. One payment buysone finished asset, returned inline as a durable first-party URL. This is thereference below.-2. **The whole chain in one call** — [`POST /api/x402/pipeline`](#sec-547).+2. **The whole chain in one call** — [`POST /api/x402/pipeline`](#sec-549).Submit an ordered chain (`generate → rig → remesh → gameready → stylize`); the402 quote is the exact sum of the requested stages, and you poll the job freeat `GET /api/forge?job=<id>` while it advances. Use this when you want the full@@ -1586,7 +1588,7 @@ console.log(output_url);The wrapper answers the 402, signs the payment, and retries the same request, allbefore your `await` resolves. Paying from a three.ws agent wallet instead of araw key, or settling on Solana, is covered in-[x402 buyer client](#sec-544).+[x402 buyer client](#sec-546).## Stages@@ -1745,8 +1747,8 @@ returned as-is. Poll budget is tunable via `X402_PIPELINE_POLL_BUDGET_MS`## Related-- [x402 paid endpoints](#sec-547) — the full catalog + pricing model-- [x402 buyer client](#sec-544) — how to settle payments as an agent+- [x402 paid endpoints](#sec-549) — the full catalog + pricing model+- [x402 buyer client](#sec-546) — how to settle payments as an agent- [Avatar pipeline](#sec-113) — the generation + rig lanes in depth---@@ -2201,8 +2203,8 @@ Product and developer documentation for three.ws. Individual docs are served onStart points:-- [start-here.md](#sec-404): the front door for both creators and developers, with the reference shelf at the bottom.-- [introduction.md](#sec-258) and [quick-start.md](#sec-366): the developer track.+- [start-here.md](#sec-406): the front door for both creators and developers, with the reference shelf at the bottom.+- [introduction.md](#sec-259) and [quick-start.md](#sec-368): the developer track.- [ALL.md](ALL.md): generated single-file aggregate of the public docs (regenerate with `node scripts/combine-docs.mjs`; edit source files, never ALL.md).- [api-reference.md](#sec-096): the REST API surface, with dedicated docs for the larger API families (crypto, 3D, market data, MCP).@@ -2596,7 +2598,7 @@ or task to the AgenC program. The write paths that do exist live elsewhere:Treat this page's REST surface as **discovery + identity correlation**. For theother writable on-chain identity, minting agents as Metaplex Core NFTs, see-[Deploy agents on-chain (bulk)](#sec-308).+[Deploy agents on-chain (bulk)](#sec-309).## Relationship to Agora@@ -2610,7 +2612,7 @@ AgenC endpoints here are the read/identity side.- [Agora](#sec-075) — the economy and write lifecycle on top of AgenC.- [Agent reputation](#sec-056), [ERC-8004](#sec-190).-- [Deploy agents on-chain (bulk)](#sec-308).+- [Deploy agents on-chain (bulk)](#sec-309).---@@ -13636,7 +13638,7 @@ would hide it.## Related-- [x402 revenue and receipts](#sec-548): the other side of the ledger. This+- [x402 revenue and receipts](#sec-550): the other side of the ledger. Thispage counts agent-to-agent payments recorded in `agent_hires`; endpoint revenuepaid **to** the platform's own paid endpoints is recorded separately in`x402_audit_log`. Do not add the two together.@@ -13673,7 +13675,7 @@ One completed job produces:| `full_body[]` | Three 1024x1280 (4:5 portrait) renders, one per pose, same backdrop and lighting || `rigged_glb_url` | The avatar with a humanoid skeleton and skin weights || `mesh_glb_url` | The unrigged generated mesh, kept so a rig hiccup never loses the generation |-| `viewer_url` | Deep link into the three.ws [viewer](#sec-511) for the rigged GLB |+| `viewer_url` | Deep link into the three.ws [viewer](#sec-514) for the rigged GLB || `pose_studio_url` | Deep link into the [Animation Studio](#sec-092) for the rigged GLB |Every render is persisted to object storage under `okx-identity/renders/<job>/` and served from a public URL, so the URLs in the response are permanent and hotlinkable.@@ -13853,11 +13855,11 @@ Two environment overrides help a batch run outlast the rig lane's rate-limit bac## Related-- [OKX.AI Marketplace Services](#sec-306): the price, the payment challenge, the replay flow, the payment guarantees, and the decomposed single-capability 3D services that share these engines.+- [OKX.AI Marketplace Services](#sec-307): the price, the payment challenge, the replay flow, the payment guarantees, and the decomposed single-capability 3D services that share these engines.- [Forge](#sec-228): the text and image to GLB generation pipeline this studio calls for the mesh and the auto-rig.- [Animation Studio](#sec-092): the `/pose` surface the `pose_studio_url` deep link opens.-- [Viewer](#sec-511): the `/viewer` surface the `viewer_url` deep link opens.-- [MCP servers](#sec-281): the wider set of three.ws MCP endpoints this one follows the transport conventions of.+- [Viewer](#sec-514): the `/viewer` surface the `viewer_url` deep link opens.+- [MCP servers](#sec-282): the wider set of three.ws MCP endpoints this one follows the transport conventions of.- [Avatar Engines Atlas](#sec-110): what engine families exist for building human avatars, and which of them are wired into the commercial pipeline.- [Draft agent mint](#sec-182): the inactive on-chain identity minted for every finished reconstruction, Solana first with ERC-8004 alongside it.@@ -14019,7 +14021,7 @@ asks whether the job ran.| Both crawl crons | [`api/cron/`](../api/cron) || Regression cover | [`tests/agent-index.test.js`](../tests/agent-index.test.js) |-Related: [Trust primitives](#sec-423) scores an agent from on-chain+Related: [Trust primitives](#sec-426) scores an agent from on-chainevidence, and [Custody you can verify](#sec-172) covers the attestations the`reputation` and `validation` classes carry.@@ -14672,7 +14674,7 @@ Load from on-chain:A manifest served from an API is a claim. A manifest that is **signed and pinned to IPFS** is evidence: anyone can fetch the CID, check the signature, and read the exact system prompt the agent was configured with, without an account and without trusting three.ws.-three.ws signs and pins an agent's manifest automatically on every persona save. The envelope is ed25519-signed by the platform attester identity (the same Solana key behind [3D provenance credentials](#sec-340)) and pinned through the configured IPFS provider.+three.ws signs and pins an agent's manifest automatically on every persona save. The envelope is ed25519-signed by the platform attester identity (the same Solana key behind [3D provenance credentials](#sec-342)) and pinned through the configured IPFS provider.### What a signed envelope looks like@@ -14829,7 +14831,7 @@ The `spec` field identifies the manifest format version. Current stable: `agent-- [Memory Spec](../specs/MEMORY_SPEC.md) — memory file format and MEMORY.md index- [Embed Spec](../specs/EMBED_SPEC.md) — `<agent-3d>` element attributes and events- [Permissions Spec](../specs/PERMISSIONS_SPEC.md) — ERC-7710 delegation format and redemption-- [Provenance](#sec-340) — signed content credentials for generated 3D assets, using the same attester identity as signed manifests+- [Provenance](#sec-342) — signed content credentials for generated 3D assets, using the same attester identity as signed manifests---@@ -14841,7 +14843,7 @@ The `spec` field identifies the manifest format version. Current stable: `agent-**Why autonomous agents need verifiable trust — and how three.ws delivers it on-chain.**-This page is the *why*. For the practical how-to, see [Reputation System](#sec-372) (leaving and reading reviews) and [ERC-8004](#sec-190) (the identity standard underneath). To read a real agent's score five different ways, follow the [Read an agent's reputation](/tutorials/agent-reputation) tutorial. For the Solana side of the same idea — memo attestations, the AgenC coordination program, and the identity bridge — see [Agent Reputation on Solana](#sec-398).+This page is the *why*. For the practical how-to, see [Reputation System](#sec-374) (leaving and reading reviews) and [ERC-8004](#sec-190) (the identity standard underneath). To read a real agent's score five different ways, follow the [Read an agent's reputation](/tutorials/agent-reputation) tutorial. For the Solana side of the same idea — memo attestations, the AgenC coordination program, and the identity bridge — see [Agent Reputation on Solana](#sec-400).---@@ -14934,7 +14936,7 @@ Reputation only matters because money moves on the other side of it. The two hal1. **Discover** a service via the Identity Registry.2. **Check** its reputation — proceed only if it clears your threshold.-3. **Pay** — the service answers an HTTP `402` and the agent signs a stablecoin micropayment ([x402](#sec-552)).+3. **Pay** — the service answers an HTTP `402` and the agent signs a stablecoin micropayment ([x402](#sec-554)).4. **Vouch** — after the work, write feedback back to the Reputation Registry, closing the loop for the next agent.The one-liner worth remembering:@@ -14955,7 +14957,7 @@ The same on-chain data is exposed through every layer a reader might come from:| Reputation panel | agent profiles | The embedded vouch/score widget on `https://three.ws/a/<chainId>/<agentId>` || `GET /api/agents/<id>/reputation` | apps | The agent's unified wallet trust score: a 0-100 credibility number derived from real ledger and on-chain activity, with a per-pillar breakdown and evidence links || `agent_reputation` MCP tool | AI agents | Paid ($0.01 USDC) read of identity + score + stake + recent events; resolves a wallet to its agent automatically |-| `GET /api/x402/agent-reputation` | AI agents | Paid ($0.01) cross-chain 0–100 trust score for **any** counterparty — Solana/EVM wallet, pump.fun mint, ERC-8004 agent id, or three.ws agent_id (auto-detected). See [Trust primitives](#sec-423) |+| `GET /api/x402/agent-reputation` | AI agents | Paid ($0.01) cross-chain 0–100 trust score for **any** counterparty — Solana/EVM wallet, pump.fun mint, ERC-8004 agent id, or three.ws agent_id (auto-detected). See [Trust primitives](#sec-426) || [Agent Passport](/agent-passport.html) | trust decisions | An A–D trust grade weighted toward credentialed and verified feedback || ERC-8004 helpers (`src/erc8004/reputation.js`; ABIs re-exported by `@three-ws/sdk`) | developers | `getReputation`, `getRecentReviews`, `getTotalStake`, `submitFeedback`, `stakeReputation` |@@ -14994,7 +14996,7 @@ The only difference is **reach**. The Club's reputation dies the moment a walletThat portability is what lets a three.ws agent be trusted by an agent that has never heard of three.ws. It's the foundation the agent economy is built on — and the reason reputation, not payments, is the harder and more important half of the stack.-**Next:** [Read an agent's reputation](/tutorials/agent-reputation) · [Reputation on Solana](#sec-398) · [Leave a vouch](#sec-372) · [ERC-8004 identity](#sec-190) · [x402 payments](#sec-552)+**Next:** [Read an agent's reputation](/tutorials/agent-reputation) · [Reputation on Solana](#sec-400) · [Leave a vouch](#sec-374) · [ERC-8004 identity](#sec-190) · [x402 payments](#sec-554)---@@ -15428,7 +15430,7 @@ relationship into an account with a real agent. Ambient discovery routesthrough the agent too — the old "have you tried…" toast stays out of the cornerwhile the companion is live.-Related: [web-component.md](#sec-514) (the embeddable `agent-3d`+Related: [web-component.md](#sec-517) (the embeddable `agent-3d`avatar), [coin-pages.md](#sec-145) (the market surfaces the shellnavigates), [STRUCTURE.md](../STRUCTURE.md) (surface map).@@ -15445,7 +15447,7 @@ Claude surface — Claude Code, the Claude apps, the Agent SDK — how to use ththree.ws platform: create and rig 3D models, run a wallet, and buy/sell services inthe x402 agent economy.-> Not to be confused with the [in-app skills system](#sec-392), which extends+> Not to be confused with the [in-app skills system](#sec-394), which extends> avatars and agents **inside** three.ws with `manifest.json` + `tools.json` +> `handlers.js` bundles. Agent Skills are the inverse: they extend **external**> AI agents with three.ws capabilities.@@ -15564,7 +15566,7 @@ Every three.ws agent has its own custodial Solana wallet. The Agent Sniper is thThis doc explains the whole system, walks through the first live trade an agent closed on the platform (a real +42.38% exit, receipts included), and lays out where the system goes next.-Related surfaces: [the trading surfaces](#sec-420) (Radar, Coin Intelligence, Mission Control), [trading experiment](#sec-418) (the laddered-exit research policy), [agent wallets](#sec-072) (how custody works), and the worker itself at `workers/agent-sniper/` (its README is the operator reference).+Related surfaces: [the trading surfaces](#sec-423) (Radar, Coin Intelligence, Mission Control), [trading experiment](#sec-421) (the laddered-exit research policy), [agent wallets](#sec-072) (how custody works), and the worker itself at `workers/agent-sniper/` (its README is the operator reference).---@@ -15714,8 +15716,8 @@ The direction of every bridge is the same: real, realized money is the ground tr## Try it- Arm your first strategy: [the sniper tutorial](/tutorials/arm-an-agent-sniper)-- Watch the engine think: [Coin Intelligence and the trading surfaces](#sec-420)-- The research policy behind laddered exits: [trading experiment](#sec-418)+- Watch the engine think: [Coin Intelligence and the trading surfaces](#sec-423)+- The research policy behind laddered exits: [trading experiment](#sec-421)- The story of the first trade, for non-operators: [the blog post](/blog/first-autonomous-trade)---@@ -15878,7 +15880,7 @@ user gesture. Nothing autoplays.## Where the events come fromThe symphony consumes the same live ticker documented in-[Money Feed](#sec-289):+[Money Feed](#sec-290):1. `GET /api/feed?limit=40` paints the initial ledger (played silently asbacklog, not as notes).@@ -15894,7 +15896,7 @@ you hear.## What sounds map to what eventsEvery allow-listed feed type (see the type table in-[Money Feed](#sec-289)) maps to one of six voices in+[Money Feed](#sec-290)) maps to one of six voices in`TYPE_TO_CATEGORY` in [`src/symphony-score.js`](../src/symphony-score.js).Each voice has its own synth patch in the engine, its own color in thevisualization, and its own mute button in the legend.@@ -15996,7 +15998,7 @@ cross-links are asserted statically by## Related-- [Money Feed](#sec-289): the activity bus this page renders, including+- [Money Feed](#sec-290): the activity bus this page renders, includingthe full event-type table and how events are published.- [Agora](#sec-075): the on-chain economy lifecycle behind the `agora-*`events.@@ -16194,7 +16196,7 @@ Captures what is currently visible and describes it so the agent can react to wh### Stage-scoped tools-When the runtime is attached to an `<agent-stage>`, two extra tools are appended (see [multi-agent.md](#sec-294)): `observe_agents` (list the other agents on stage with names and positions) and `say_to_agent` (send a message to a named stagemate).+When the runtime is attached to an `<agent-stage>`, two extra tools are appended (see [multi-agent.md](#sec-295)): `observe_agents` (list the other agents on stage with names and positions) and `say_to_agent` (send a message to a named stagemate).---@@ -16914,7 +16916,7 @@ POST /api/pump/launch-agent { "agent_id": "…", "name": "…", "symbol": "…"```This is the path that supports USDC-paired curves and binds the on-chain pump-agent for buybacks. See [the pump.fun launcher](#sec-344).+agent for buybacks. See [the pump.fun launcher](#sec-346).Both paths write a `pump_agent_mints` row and call back into the plan to mark itlaunched, so a coin appears on [/launches](https://three.ws/launches), in the@@ -16988,10 +16990,10 @@ doubles as a check on the lane.## Related-- [The pump.fun launcher](#sec-344): the launch transaction itself+- [The pump.fun launcher](#sec-346): the launch transaction itself- [Coin launches](#sec-144): the platform launch directory-- [Platform fee](#sec-345): what three.ws takes on a launch-- [Solana on pump.fun](#sec-397): the on-chain program surface+- [Platform fee](#sec-347): what three.ws takes on a launch+- [Solana on pump.fun](#sec-399): the on-chain program surfaceNote on promotion: `$THREE` is the coin three.ws promotes. Agent tokens are coinsusers launch through the platform, rendered from the platform's own launch@@ -17012,7 +17014,7 @@ This document is the API reference the surrounding docs deliberately leave out.- [Agent wallets](#sec-072) for how the wallet is created, how its key is held, and which paths may spend.- [Custody you can verify](#sec-172) for the limits, the freeze switch, the Merkle proof of custody, and the social-recovery model.- [Financial controls](#sec-223) for the plain-English spend-rule layer and the anomaly guard behind `/solana/guard`.-- [The Trading Copilot](#sec-417) for the conversational surface that proposes trades a human confirms.+- [The Trading Copilot](#sec-420) for the conversational surface that proposes trades a human confirms.- [Coin Autopilot](#sec-106) for the *coin* cockpit at `/api/pump/autopilot`. That is a different feature from the **Treasury Autopilot** documented here, which runs the agent's own wallet rather than a launched coin.## Orientation@@ -18186,7 +18188,7 @@ curl -s -X POST "https://three.ws/api/agents/$AGENT_ID/solana/guard" \- [Agent wallets](#sec-072) for the wallet itself: creation, key custody, and the five spend paths.- [Custody you can verify](#sec-172) for limits, freeze, proof of custody, and the recovery model in prose.- [Financial controls](#sec-223) for the plain-English spend rules and the wallet-defense behaviors.-- [The Trading Copilot](#sec-417) for the conversational read-and-propose surface over the same wallet.+- [The Trading Copilot](#sec-420) for the conversational read-and-propose surface over the same wallet.- [Coin Autopilot](#sec-106) for the separate coin cockpit at `/api/pump/autopilot`.- [What agents can do](#sec-009) for a page per wallet ability, including [Access](#sec-049), [Orders](#sec-040), [Intents](#sec-042), [Autopilot](#sec-041), [Portfolio](#sec-031), and [Recovery](#sec-050).- [Guardian console](#sec-239) for the other side of a recovery request.@@ -18230,9 +18232,9 @@ Five paths move funds out of an agent wallet, and **all five pass through one po| Path | Trigger ||------|---------|| Withdraw | The owner sweeps funds out |-| x402 pay | The agent pays for a paid API call. Also reachable from any paid checkout on the site: the [x402 payment modal](#sec-463) lists a signed-in user's agents next to Phantom, and picking one settles from that agent's wallet with no popup |+| x402 pay | The agent pays for a paid API call. Also reachable from any paid checkout on the site: the [x402 payment modal](#sec-466) lists a signed-in user's agents next to Phantom, and picking one settles from that agent's wallet with no popup || Trade | A discretionary buy/sell from the wallet hub, or from the in-world coin widget's **Pay with** selector (SOL-denominated coins) |-| Purchase | The agent buys a marketplace skill or asset for itself (see [Marketplace](#sec-274)), under its own daily purchase cap |+| Purchase | The agent buys a marketplace skill or asset for itself (see [Marketplace](#sec-275)), under its own daily purchase cap || Snipe | The autonomous sniper worker executes a strategy |Because enforcement lives at the signing boundary rather than in each feature, a new feature cannot accidentally introduce an unguarded spend path.@@ -18285,7 +18287,7 @@ An agent can pay a human-readable name instead of a base58 address. `/api/x402/p- [Custody you can verify](#sec-172) — limits, freeze, Merkle proof-of-custody, social recovery and inheritance- [Financial controls](#sec-223) — plain-English spend rules, compiled and enforced deterministically- [What agents can do](#sec-009) — the complete dossier, including a page per wallet ability-- [x402 protocol](#sec-552) — how agents pay for services+- [x402 protocol](#sec-554) — how agents pay for services- [Coin launches](#sec-144) — how the wallet signs a pump.fun launch---@@ -18475,10 +18477,10 @@ An "awakening" envelope (no eligible trading agent yet) is still valid and fully## Related-- [Oracle](#sec-320) - the conviction engine this class of agent trades on+- [Oracle](#sec-321) - the conviction engine this class of agent trades on- [Agent reputation](#sec-056) - the Reasoning Ledger score behind the reputation ring-- [Reputation](#sec-372) - how proven on-chain track records are computed-- [The trading experiment](#sec-418) - an autonomous agent operating inside these limits, journaled+- [Reputation](#sec-374) - how proven on-chain track records are computed+- [The trading experiment](#sec-421) - an autonomous agent operating inside these limits, journaled- [Custody you can verify](#sec-172) - the spend caps and kill switch the autonomy runs under- [/activity](https://three.ws/activity) - every agent's live trades in real time@@ -20430,7 +20432,7 @@ of rendering a fake zero.## Related surfaces-- [`/portfolio`](#sec-336): the live wallet portfolio; the two pages+- [`/portfolio`](#sec-338): the live wallet portfolio; the two pagescross-link and share the recent-wallet list.- [`/api/crypto/wallet`](#sec-171): the raw balance endpoint the tokendiversity measurement rides on.@@ -20514,8 +20516,8 @@ When `read.hallucination_guard.line_replaced` is true, the co-pilot caught a fig- [Custody you can verify](#sec-172) - the spend limits, firewall, and audit the "Act" path runs under- [Financial controls](#sec-223) - the plain-English rules and real-time defense on the same rails-- [Oracle](#sec-320) - the platform conviction engine over the same launch universe-- [Trading surfaces](#sec-420) - Mission Control executes through this same guarded path+- [Oracle](#sec-321) - the platform conviction engine over the same launch universe+- [Trading surfaces](#sec-423) - Mission Control executes through this same guarded path- [/agi](https://three.ws/agi) - a fully autonomous agent reading and trading the same feed---@@ -20722,7 +20724,7 @@ If you extend the metric, keep two properties: the retention window must stay an# Animation Studio: pose, keyframe, and sell motion-Animation Studio is where a three.ws avatar (or a built-in mannequin) becomes animated. Click any body part and rotate it with a gizmo, or drag a hand or foot and let inverse kinematics solve the limb. Drop the pose as a keyframe, advance the playhead, re-pose, and drop another; the studio interpolates between them and plays the result. Export the finished motion as an animated GLB or as clip JSON, save it to your account, deep-link it to play on any avatar, hand it to [Scene Studio](#sec-378) to record as video, or list it for sale in the animation marketplace for USDC.+Animation Studio is where a three.ws avatar (or a built-in mannequin) becomes animated. Click any body part and rotate it with a gizmo, or drag a hand or foot and let inverse kinematics solve the limb. Drop the pose as a keyframe, advance the playhead, re-pose, and drop another; the studio interpolates between them and plays the result. Export the finished motion as an animated GLB or as clip JSON, save it to your account, deep-link it to play on any avatar, hand it to [Scene Studio](#sec-380) to record as video, or list it for sale in the animation marketplace for USDC.Page: [/pose](https://three.ws/pose) · API: `/api/animations/clips`@@ -20756,7 +20758,7 @@ Under the motion generator sits a Spell box: type a word and the avatar spells iA spelled word is shareable as a link: `https://three.ws/pose?spell=HELLO` opens the studio, auto-loads a rigged avatar (same roster as animation deep links), and spells the word on arrival.-Fingerspelling is the deterministic, spelling-based subset of sign language, it spells English words rather than translating into grammatical ASL. The Studio's Spell box is spelling only. The platform also has a lexical vocabulary (words that are signed rather than spelled, on one or both hands), which drives [/sign-language](https://three.ws/sign-language), signed chat replies, and the `sign-language` embed attribute. See [docs/sign-language.md](#sec-386) for the whole system, or the tutorial [Make your avatar sign](https://three.ws/tutorials/sign-with-your-avatar) for a guided tour.+Fingerspelling is the deterministic, spelling-based subset of sign language, it spells English words rather than translating into grammatical ASL. The Studio's Spell box is spelling only. The platform also has a lexical vocabulary (words that are signed rather than spelled, on one or both hands), which drives [/sign-language](https://three.ws/sign-language), signed chat replies, and the `sign-language` embed attribute. See [docs/sign-language.md](#sec-388) for the whole system, or the tutorial [Make your avatar sign](https://three.ws/tutorials/sign-with-your-avatar) for a guided tour.### Export, save, and sell@@ -20818,7 +20820,7 @@ An empty `tracks` array is rejected: a clip with no motion is not a clip. Track- [Animations reference](#sec-093): the runtime clip registry, formats, and agent slots.- [3D asset pipeline](#sec-002): how GLB, FBX, and clip JSON convert across the platform.-- [Scene Studio](#sec-378): record your animation to video.+- [Scene Studio](#sec-380): record your animation to video.- [Avatar Studio](#sec-115): build the avatar you animate here.- [/marketplace](https://three.ws/marketplace): where listed animation clips are bought and sold.@@ -21606,7 +21608,7 @@ This is the reference for the three.ws HTTP API: every documented endpoint, itsBase URL: `https://three.ws/api`-> For the in-browser JavaScript API (the `<agent-3d>` element, `Viewer`, `Runtime`, `SceneController`, skills, memory), see [js-api.md](#sec-261) and [web-component.md](#sec-514). For the high-level npm SDK, see [sdk.md](#sec-379).+> For the in-browser JavaScript API (the `<agent-3d>` element, `Viewer`, `Runtime`, `SceneController`, skills, memory), see [js-api.md](#sec-262) and [web-component.md](#sec-517). For the high-level npm SDK, see [sdk.md](#sec-381).The full machine-readable schema lives at [`https://three.ws/.well-known/openapi.yaml`](https://three.ws/.well-known/openapi.yaml). x402 paid endpoints are listed at [`/.well-known/x402.json`](https://three.ws/.well-known/x402.json) and the MCP endpoint is at [`/api/mcp`](https://three.ws/api/mcp).@@ -22274,7 +22276,7 @@ widget in `src/memory-seed.js`.Everything these endpoints read is already public. They are read-only, requestno OAuth from the visitor, and store nothing; the consent-gated seeding flowsthat do write to an agent live at `/api/agents/:id/memory/seed/*` and are-documented in [GitHub](#sec-237), [X](#sec-521)+documented in [GitHub](#sec-237), [X](#sec-524)and [Farcaster](#sec-222) memory seeding.The three connectors are unauthenticated GETs, rate limited per IP, and cached@@ -23366,7 +23368,7 @@ the Avatar Studio re-skin idea (`src/avatar-studio-colorpicker.js`,preset live in the browser (see [Restyle Studio](https://three.ws/restyle)), askan AI for a restyle from a plain-language instruction, or fan one preset out intoN reproducible colorway variants. Free and hosted — rate-limited, not x402 — the-same implementation the paid `restyle_material` [MCP tool](#sec-279) calls as+same implementation the paid `restyle_material` [MCP tool](#sec-280) calls asa thin client, so the free web page and the paid agent tool never drift.Every mesh edit is **non-destructive**: geometry and UVs are never touched (only@@ -23760,7 +23762,7 @@ sample rate, whether the lane is configured).Read American Sign Language fingerspelling from a webcam. No API key, no account,no payment: rate-limited per IP. This is the input half of the platform's signing-loop (the output half, avatars that sign, is [docs/sign-language.md](#sec-386)).+loop (the output half, avatars that sign, is [docs/sign-language.md](#sec-388)).**Video never reaches the platform.** The caller extracts MediaPipe Holisticlandmarks in the browser and posts coordinates only. `src/sign-input.js` ships a@@ -24839,7 +24841,7 @@ curl -s 'https://three.ws/api/v1/pump/whales?mint=FeMbDoX7R1Psc4GEcvJdsbNbZA3bfzA trader's daily on-chain score attestation (`threews.tradescore.v1`), served as aportable credential and a database-free verifier. Full guide:-[docs/trader-passport.md](#sec-415).+[docs/trader-passport.md](#sec-418).### Read a passport@@ -25069,7 +25071,7 @@ The cursor encodes the full keyset tuple (registration timestamp, chain ID, agen## Social & Community API-The endpoints behind the platform's social layer: the activity feed, the follow graph, notifications, the unified leaderboard, creator portfolios, and cross-entity search. Overview and how the pieces interconnect: [The social layer](#sec-396).+The endpoints behind the platform's social layer: the activity feed, the follow graph, notifications, the unified leaderboard, creator portfolios, and cross-entity search. Overview and how the pieces interconnect: [The social layer](#sec-398).### Activity feed@@ -25108,7 +25110,7 @@ Reverse-chronological creation events (avatars, agents, coins, forged models, saItems of `kind: "follow"` also carry a `target` shaped like `actor`. `actor.username` is `null` for creations made while signed out.-Not the same endpoint as `GET /api/feed`, the public Money Pulse ticker ([Money Feed](#sec-289)).+Not the same endpoint as `GET /api/feed`, the public Money Pulse ticker ([Money Feed](#sec-290)).---@@ -25491,7 +25493,7 @@ GET answers `405` with `allow: POST, DELETE`.`render_avatar` enforces the agent's embed policy (allowed origins, allowed surfaces). Model URLs must be HTTPS — SSRF protections block private IP ranges.-This table is the core subset. The server registers many more tools (minting, gated embeds, memory, oracle and pump.fun intel, trader analytics, crypto data). Call `tools/list`, or see the [MCP documentation](#sec-281) and the [MCP Tools Catalog](#sec-279).+This table is the core subset. The server registers many more tools (minting, gated embeds, memory, oracle and pump.fun intel, trader analytics, crypto data). Call `tools/list`, or see the [MCP documentation](#sec-282) and the [MCP Tools Catalog](#sec-280).**Example JSON-RPC request**@@ -25604,7 +25606,7 @@ Both header names are read case-insensitively and both receipt names are emitted| `POST /api/mcp-3d` | MCP (Streamable HTTP) | Base + X Layer (+ Solana when configured) || `POST /api/okx/3d/<service>` | A2MCP (decomposed 3D studio) | X Layer first, then Solana/Base |-The full seller-side wire contract — challenge fields, verify→work→settle order, the `PAYMENT-SIGNATURE` payload shape, and the settlement receipt — is pinned in [`specs/okx-agent-payments.md`](../specs/okx-agent-payments.md). The per-service catalog and runnable curls are in [`docs/okx-marketplace.md`](#sec-306).+The full seller-side wire contract — challenge fields, verify→work→settle order, the `PAYMENT-SIGNATURE` payload shape, and the settlement receipt — is pinned in [`specs/okx-agent-payments.md`](../specs/okx-agent-payments.md). The per-service catalog and runnable curls are in [`docs/okx-marketplace.md`](#sec-307).---@@ -25626,7 +25628,7 @@ The buyer-side counterpart to the x402 endpoints above. Everything so far assumeYou fund a budget from your [credits](payment-sessions.md#prepaid-credits), set the policy, and receive a bearer token. The agent presents that token to `/api/pay/execute`; the platform's own wallet signs the on-chain transfer. A stolen token buys at most the remaining budget, only at hosts you approved, only until the session expires.-Conceptual guide: [Payment sessions](#sec-326). Step-by-step walkthrough: [Give an agent a spending envelope](#sec-427). Enforcement source: [`api/_lib/pay/spend-governor.js`](https://github.com/nirholas/three.ws/blob/main/api/_lib/pay/spend-governor.js).+Conceptual guide: [Payment sessions](#sec-327). Step-by-step walkthrough: [Give an agent a spending envelope](#sec-430). Enforcement source: [`api/_lib/pay/spend-governor.js`](https://github.com/nirholas/three.ws/blob/main/api/_lib/pay/spend-governor.js).### Authentication@@ -26506,7 +26508,7 @@ fetched_at }`.`paragraphs[]` is a bounded lead excerpt, not the article body: capped to 2paragraphs / 400 characters by `excerptParagraphs()` in[api/_lib/news-rights.js](../api/_lib/news-rights.js), the single choke point-every response passes through (see [docs/news-rights.md](#sec-296)).+every response passes through (see [docs/news-rights.md](#sec-297)).`excerpt_truncated` is `true` whenever the source ran longer than the quotedexcerpt; `full_text_url` is where to send the reader for the rest. This is ahard limit for every publisher, not a per-source policy — a story removed at a@@ -28593,7 +28595,7 @@ Endpoint-specific codes (e.g. `quota_exceeded`, `invalid_avatar`, `no_client_id`## SDK-For building on the platform from JavaScript, the official npm package is [`@three-ws/sdk`](https://www.npmjs.com/package/@three-ws/sdk). It is not a thin wrapper over every REST route above; it ships the higher-level building blocks: `AgentKit` (chat panel + ERC-8004 registration + `.well-known` manifest generation), `AgentClient` (x402 agent-to-agent paid skill calls), `PermissionsClient` (ERC-7710 delegations), and the Solana identity/attestation helpers. Full docs: [SDK & Library](#sec-379).+For building on the platform from JavaScript, the official npm package is [`@three-ws/sdk`](https://www.npmjs.com/package/@three-ws/sdk). It is not a thin wrapper over every REST route above; it ships the higher-level building blocks: `AgentKit` (chat panel + ERC-8004 registration + `.well-known` manifest generation), `AgentClient` (x402 agent-to-agent paid skill calls), `PermissionsClient` (ERC-7710 delegations), and the Solana identity/attestation helpers. Full docs: [SDK & Library](#sec-381).For the endpoints on this page, call them directly with `fetch`/`curl` and a Bearer API key:@@ -28949,7 +28951,7 @@ Solscan-linked "x402" provenance badge. Inline-done lanes publish immediately;async lanes are completed server-side by `api/cron/forge-finalize`, so theartifact lands even if you never poll. Recording happens after your response issent and never affects your result. See-[x402 endpoints](#sec-547) and+[x402 endpoints](#sec-549) and[the autonomous economy](#sec-105).Treat prompts as public. If you need a private lane, use the account-scoped@@ -28997,11 +28999,11 @@ const glb = Buffer.from(await (await fetch(glbUrl)).arrayBuffer());full Forge Pro walkthrough.- [Forge pipeline](#sec-227): how the lanes, tiers, and failovers fittogether internally.-- [3D Studio MCP server](#sec-275): the same generation as+- [3D Studio MCP server](#sec-276): the same generation as`text_to_3d` / `image_to_3d` tools for in-conversation use, priced from thesame tier table. This REST endpoint is the pay-per-call surface for autonomousagents.-- [x402 endpoints](#sec-547): every paid endpoint on the platform.+- [x402 endpoints](#sec-549): every paid endpoint on the platform.---@@ -29111,7 +29113,7 @@ Append `?e2e=1` to expose `window.__arsDebug` (`count()`, `netStatus()`, `netIds## Related- [AR and WebXR](#sec-099): the single-model "View in AR" system, `/ar` AR Forge, the `POST /api/forge` free lane in depth, the USDZ/Quick Look pipeline, and model-optimization limits.-- [Selfie to Avatar](#sec-382) and [Avatar pipeline](#sec-113): where the models you place come from.+- [Selfie to Avatar](#sec-384) and [Avatar pipeline](#sec-113): where the models you place come from.- Pages: [/ar/studio](https://three.ws/ar/studio), [/ar](https://three.ws/ar), [/viewer](https://three.ws/viewer).---@@ -29902,7 +29904,7 @@ Configure everything and copy your snippet at [three.ws/assistant](https://threeLooking for a support-chat panel grounded in your page's content instead of a full-body avatar? That is the sibling [Concierge widget](#sec-153). Use Concierge for "answer questions about this page"; use the assistant widget when you want a character who stands on your site, speaks, and can run on a visitor's own model key.-There are three ways to add it: a one-tag script, the [`@three-ws/assistant`](https://www.npmjs.com/package/@three-ws/assistant) npm package, or let an AI agent generate the embed for you through the [assistant-widget MCP server](#generate-a-widget-from-an-ai-agent-mcp). New to it? The [step-by-step tutorial](#sec-424) builds one from scratch.+There are three ways to add it: a one-tag script, the [`@three-ws/assistant`](https://www.npmjs.com/package/@three-ws/assistant) npm package, or let an AI agent generate the embed for you through the [assistant-widget MCP server](#generate-a-widget-from-an-ai-agent-mcp). New to it? The [step-by-step tutorial](#sec-427) builds one from scratch.## Install@@ -30011,7 +30013,7 @@ Two tools:- **`list_assistant_options`** returns everything you can configure: the built-in avatars, the background presets and grammar, the modes, the chat lanes, and the full `data-*` attribute reference.- **`build_assistant_widget`** turns a config (avatar, background, mode, name, greeting, context, accent, position) into a paste-ready `<script>` snippet, a standalone frame URL, an equivalent `ThreeAssistant.init({...})` call, and the builder link. Every field is validated and clamped, so a bad value falls back to a safe default and the generated HTML is always well-formed.-Ask your agent something like "build a 3D assistant widget named Aria with an ocean background for my site" and paste the snippet it returns. The server is one of the [three.ws MCP servers](#sec-281); find it in the registry at [registry.modelcontextprotocol.io](https://registry.modelcontextprotocol.io/?q=io.github.nirholas).+Ask your agent something like "build a 3D assistant widget named Aria with an ocean background for my site" and paste the snippet it returns. The server is one of the [three.ws MCP servers](#sec-282); find it in the registry at [registry.modelcontextprotocol.io](https://registry.modelcontextprotocol.io/?q=io.github.nirholas).## How it works@@ -30023,10 +30025,10 @@ Ask your agent something like "build a 3D assistant widget named Aria with an oc## Related surfaces-- [Build a 3D assistant, step by step](#sec-424), the tutorial+- [Build a 3D assistant, step by step](#sec-427), the tutorial- [Concierge](#sec-153), the page-grounded support-chat widget with a lipsyncing face-- [three.ws MCP servers](#sec-281), the full free and paid tool catalog-- [Share and embed](#sec-383), the `<three-d>` model embeds+- [three.ws MCP servers](#sec-282), the full free and paid tool catalog+- [Share and embed](#sec-385), the `<three-d>` model embeds- [/walk-embed](https://three.ws/walk-embed), the walking-avatar iframe embed- [/forge](https://three.ws/forge), generate an avatar to use in the widget@@ -30910,7 +30912,7 @@ and the platform **scans its own wallets for leaks every few minutes**.This page explains the whole loop in plain language: which wallet does what, how moneycan and cannot move, and how you can verify there's no leak yourself.-Companion docs: [Money map](#sec-291) (which wallet receives each *payment*),+Companion docs: [Money map](#sec-292) (which wallet receives each *payment*),[Economy master](#sec-184) (the funding-root subsystem in depth), and the[Solana signers runbook](../api/_lib/solana-signers.js) (every signer, its floor, andhow to fund it).@@ -31050,11 +31052,11 @@ zero.## Related-- [Money map](#sec-291) — which wallet receives each kind of payment, and the+- [Money map](#sec-292) — which wallet receives each kind of payment, and theplatform's cut.- [Economy master](#sec-184) — the funding-root subsystem, its ledger, and thetopup/sweepback crons in depth.-- [x402 ring economy](#sec-549) — how the autonomous payment ring settles+- [x402 ring economy](#sec-551) — how the autonomous payment ring settlesUSDC between agents.---@@ -31275,16 +31277,16 @@ corroborate — the ops financial-integrity surface alerts on those. Detail:| `x402_autonomous_log` | Every call (success or failure), with `signal_data` / `value_extracted`. `error_msg` is reserved for calls that actually failed: the external uptime monitor probes third-party services for free and records an alive-but-unexpected status (a templated path answering 400, a verb-picky route answering 405) in `value_extracted.status` only, so a liveness observation never lands in the loop's failure stats. || `oracle_intel_signals` | `oracle` / `sniper` entries, keyed by source + topic; consumed by the sniper oracle gate. Each row carries `tx_signature`, the settle signature of the paid call that bought it, so a gate decision can cite its receipt (surfaced as `signal_receipts` on gate results). || `forge_creations` | Every settled `POST /api/x402/forge` generation (any buyer, not just this loop). The row lands in the public community gallery with `x402_payer` / `x402_tx_sig` / `x402_price_atomic` provenance; the gallery renders a Solscan-linked "x402 · $price" badge. Inline-done lanes materialize immediately; async lanes store the full job token and `api/cron/forge-finalize` completes them server-side. |-| `agent_custody_events` | The USDC spend, with `category: 'x402'` (see [Money feed](#sec-289)). |+| `agent_custody_events` | The USDC spend, with `category: 'x402'` (see [Money feed](#sec-290)). || `x402_volume_metrics` | Per-endpoint proof-of-volume + liveness ledger from the Volume Bootstrap Loop (see [x402 revenue](x402-revenue.md#proof-of-volume--x402_volume_metrics)). || `payment_reconciliation` | One verdict per settlement claim from the daily reconciliation job (see [x402 revenue](x402-revenue.md#reconciliation--payment_reconciliation)). || Dedicated stores | Pipeline-specific tables (pricing tracker, reputation snapshots, leaderboard, sniper analytics, …). |## Related-- [x402 endpoints](#sec-547) — the paid endpoints this loop calls.-- [x402 revenue & receipts](#sec-548) — where settlements land, the proof-of-volume ledger, and the reconciliation job.-- [x402 buyer client](#sec-544) — the client wrappers it pays with.+- [x402 endpoints](#sec-549) — the paid endpoints this loop calls.+- [x402 revenue & receipts](#sec-550) — where settlements land, the proof-of-volume ledger, and the reconciliation job.+- [x402 buyer client](#sec-546) — the client wrappers it pays with.- [Circulation engine](#sec-141) — the separate SOL/$THREE activity loop.---@@ -31386,7 +31388,7 @@ A confirmed buyback narrates as: "Bought back and burned $120 of $YOURCOIN. Supp- [Custody you can verify](#sec-172) - the spend limits, freeze switch, and audit trail every agent wallet runs under- [Financial controls](#sec-223) - plain-English spend rules layered on the same enforcement point-- [Oracle](#sec-320) - the conviction engine and the agent action loop that arms an agent to trade autonomously+- [Oracle](#sec-321) - the conviction engine and the agent action loop that arms an agent to trade autonomously- [/dashboard](https://three.ws/dashboard) - launch a coin for an agent, the prerequisite for Autopilot- [/launches](https://three.ws/launches) - the public feed of coins launched through three.ws@@ -31400,7 +31402,7 @@ A confirmed buyback narrates as: "Bought back and burned $120 of $YOURCOIN. Supp[three.ws/avatar-artifact](https://three.ws/avatar-artifact) is one page that renders one avatar and nothing else. No app shell, no sign-in, no navigation to get lost in: a URL you can paste into an `<iframe>` on any site, or send to someone who has never heard of three.ws, and it renders a live 3D avatar in their browser.-It is deliberately the smallest viewer we ship. [The full 3D viewer](#sec-511) is the engine behind `/app` and every `<agent-3d>` embed, with camera rigs, material editing and a clip panel. This page has one job: show the artifact, beautifully, from a link.+It is deliberately the smallest viewer we ship. [The full 3D viewer](#sec-514) is the engine behind `/app` and every `<agent-3d>` embed, with camera rigs, material editing and a clip panel. This page has one job: show the artifact, beautifully, from a link.---@@ -31464,7 +31466,7 @@ Two properties make this safe to drop on someone else's page:- **No third-party CDN.** three.js ships with the bundle. An embed host never picks up a cross-origin script tag it did not agree to.- **It stops when it is not visible.** A hidden tab suspends the render loop, so an embedded viewer never burns a host page's GPU in the background.-For a full chat widget or a token-gated embed, use [Share and embed](#sec-383) instead. This page is the plain viewer.+For a full chat widget or a token-gated embed, use [Share and embed](#sec-385) instead. This page is the plain viewer.---@@ -31518,8 +31520,8 @@ A large model on a slow connection is not a failure: the loading overlay reports## Related-- [The 3D viewer](#sec-511): the full engine behind `/app` and `<agent-3d>`-- [Share and embed](#sec-383): widgets, web components and embed policy+- [The 3D viewer](#sec-514): the full engine behind `/app` and `<agent-3d>`+- [Share and embed](#sec-385): widgets, web components and embed policy- [Claude artifact contract](../specs/CLAUDE_ARTIFACT.md): the self-contained HTML lane for Claude.ai, which shares this page's parameter shape- [Animations](#sec-093): the clip library this page retargets from@@ -31537,7 +31539,7 @@ It is the piece that lets avatars live in a build pipeline instead of a browser**On this page:** [Install](#install) · [Quick start](#quick-start) · [Commands](#commands) · [The manifest](#the-manifest) · [Exit codes](#exit-codes-and-scripting) · [Release gate](#gate-a-release-on-the-manifest)-Related: [`@three-ws/avatar-schema`](../packages/avatar-schema/README.md) is the wire format this validates against. The [web component reference](#sec-514) covers the `<agent-3d>` element the CLI emits.+Related: [`@three-ws/avatar-schema`](../packages/avatar-schema/README.md) is the wire format this validates against. The [web component reference](#sec-517) covers the `<agent-3d>` element the CLI emits.---@@ -31731,7 +31733,7 @@ https://three.ws/a/eip155%3A1%3A0x742d35Cc6634C0532925a3b844Bc454e4438f44e<iframe src="https://three.ws/a/eip155%3A1%3A0x742d35Cc6634C0532925a3b844Bc454e4438f44e" width="480" height="640" frameborder="0" allow="camera; microphone; xr-spatial-tracking"></iframe>```-The web-component block is emitted with its loader on purpose. `<agent-3d>` is an ordinary unknown element until that script registers it, so the snippet is only complete with both lines. See the [web component reference](#sec-514) for the full attribute surface.+The web-component block is emitted with its loader on purpose. `<agent-3d>` is an ordinary unknown element until that script registers it, so the snippet is only complete with both lines. See the [web component reference](#sec-517) for the full attribute surface.When `mesh.uri` is still a local path, `preview` says so rather than handing you a snippet that renders nothing:@@ -31828,8 +31830,8 @@ three-ws-avatar validate manifest.json --json | jq -e '.valid'## Where to go next-- **[Ship an avatar manifest](#sec-474)** walks the whole path end to end, from a raw GLB to a live embed, and explains the decision at each step.-- **[Web component reference](#sec-514)** documents every attribute on the `<agent-3d>` element `preview` emits.+- **[Ship an avatar manifest](#sec-477)** walks the whole path end to end, from a raw GLB to a live embed, and explains the decision at each step.+- **[Web component reference](#sec-517)** documents every attribute on the `<agent-3d>` element `preview` emits.- **[`@three-ws/avatar-schema`](../packages/avatar-schema/README.md)** is the normative format if you are writing your own tooling.- The package source lives in [`packages/avatar-cli`](https://github.com/nirholas/three.ws/tree/main/packages/avatar-cli).@@ -32233,7 +32235,7 @@ Mesh and glTF output can be animated by the skinned-mesh pipeline. Gaussian and| --- | --- | --- || `live` | Live on three.ws | Already wired into a three.ws product surface you can use right now. || `forge` | Generate in Forge | Commercially licensed and reachable through the live text and image to GLB pipeline at [/forge](https://three.ws/forge). |-| `splat` | View in Splat Viewer | Produces Gaussian-splat or radiance-field output you can drop into the three.ws [splat viewer](#sec-402). |+| `splat` | View in Splat Viewer | Produces Gaussian-splat or radiance-field output you can drop into the three.ws [splat viewer](#sec-404). || `interop` | Interop | Emits a standard rigged format (glTF, VRM, FBX) that the three.ws viewer and animation pipeline already understand. || `reference` | Reference / self-host | Run it yourself. Its license or its compute profile keeps it out of the commercial pipeline. It is listed here for builders. |@@ -32340,7 +32342,7 @@ To add an engine, append an entry to `ENGINES` in [`src/avatar-engines-data.js`]## Related-- [Splat Viewer](#sec-402): where the Gaussian-splat output of the `splat` engines actually renders in the browser.+- [Splat Viewer](#sec-404): where the Gaussian-splat output of the `splat` engines actually renders in the browser.- [Scene Capture](#sec-134): the three.ws side of reconstruction, turning real video into 3D, adjacent to the photoreal-head family here.- [Forge](#sec-228): the live commercial generation pipeline, which the one `live` text-to-avatar engine powers.- [Agent Identity Studio](#sec-053): that pipeline applied end to end, brand brief to rigged avatar plus studio renders.@@ -32949,7 +32951,7 @@ prompt / imageGeneration quality is a **tier** ([api/_lib/forge-tiers.js](../api/_lib/forge-tiers.js)): `draft`, `standard`(default), or `high` — more geometric budget at higher tiers. The tier sets theprice identically across REST and MCP transports (see-[MCP tools](#sec-279), [x402 endpoints](#sec-547)).+[MCP tools](#sec-280), [x402 endpoints](#sec-549)).### ② Auto-rig@@ -33028,7 +33030,7 @@ viewer, embeddable as a web component, and attachable to an agent. Paidgeneration/editing is metered per call over x402; the free studio lane requires noaccount. See [Avatar creation](#sec-109) and[Avatar Studio](#sec-137) for the authoring UIs, and-[Mesh editing tools](#sec-279) for retexture / stylize / remesh / segment /+[Mesh editing tools](#sec-280) for retexture / stylize / remesh / segment /pose operations.## Related@@ -33036,8 +33038,8 @@ pose operations.- [Selfie → Avatar reconstruction](#sec-114) — the separate lane that fits a *person's photo* onto a rigged template (face texture + geometry morph), rather than generating a mesh from a prompt.- [Animations](#sec-093) — the clip library and retargeting in depth.- [3D asset pipeline](#sec-002) — formats, optimization, validation.-- [NVIDIA free models](#sec-301) — the free generation backend.-- [MCP tools](#sec-279) — every generation/editing tool and its price.+- [NVIDIA free models](#sec-302) — the free generation backend.+- [MCP tools](#sec-280) — every generation/editing tool and its price.---@@ -33378,8 +33380,8 @@ curl 'https://three.ws/api/avatars/<avatarId>' -H 'cookie: <session>'- [Animation Studio](#sec-092): pose and keyframe the avatar you build here.- [Scene Composer](#sec-152): forge props and attach them to the avatar's bones as a saved outfit.-- [Mocap Studio](#sec-288): drive the avatar's face live from your webcam.-- [Restyle Studio](#sec-373): shares the same GLB optimize-and-validate path.+- [Mocap Studio](#sec-289): drive the avatar's face live from your webcam.+- [Restyle Studio](#sec-375): shares the same GLB optimize-and-validate path.- [Trait-based avatar builder](#sec-137): the separate VRM studio embedded in the agent editor; a deep dive into its internals.- [/create](https://three.ws/create): the hub for every avatar-creation path, including selfie-to-avatar.@@ -34713,7 +34715,7 @@ Published 27 June 2026. Tags: `ai`, `agent-toolkit`, `blockchain`, `aws-partnersThe platform-level piece: browser-native 3D AI agents with memory, on-chain wallets, and autonomous payments, available on AWS Marketplace, embeddable in one line of HTML, and governed before they act. Written for AWS builders evaluating three.ws as an agent runtime rather than as a 3D asset tool.-- **Surfaces it covers:** [the `<agent-3d>` web component](#sec-514), [agent wallets](#sec-072), [the agent system](#sec-064), [AWS Marketplace procurement](#sec-123)+- **Surfaces it covers:** [the `<agent-3d>` web component](#sec-517), [agent wallets](#sec-072), [the agent system](#sec-064), [AWS Marketplace procurement](#sec-123)## Published by AWS about three.ws@@ -34727,7 +34729,7 @@ Published 26 June 2026 by Kelly Wu (AWS). Part of the AWS-run series "AWS PartneA builder's guide to the agentic economy that uses the three.ws stack as its worked example throughout: the x402 handshake and its three layers, MCP as the distribution layer for agent capabilities, agent-to-agent payments, on-chain agent identity (ERC-8004 and the SPL skill licenses), agent tokens on the bonding curve, and 3D embodiment. It walks the hosted MCP servers, the `@three-ws/*` payment SDKs, and the FSI use cases for per-call data access, and closes on the open problems: payment streaming, automatic cross-chain routing, agent reputation as a credit primitive, and org-scale spend governance.-- **Surfaces it covers:** [the MCP servers](#sec-281), [x402](#sec-105), [agent wallets](#sec-072), [the `<agent-3d>` web component](#sec-514)+- **Surfaces it covers:** [the MCP servers](#sec-282), [x402](#sec-105), [agent wallets](#sec-072), [the `<agent-3d>` web component](#sec-517)- **Canonical URL note:** the Builder Center strips digits from slugs, so `x402` becomes `x` and `3d` becomes `d` in the path. The URL above is the one AWS publishes in its own [sitemap](https://builder.aws.com/sitemaps/articles/2026-6.xml); a slug containing the digits also resolves, because the content ID is what routes.## In draft@@ -35388,7 +35390,7 @@ One product. Two ways in. One authorization path.**Learn more**- Platform: [three.ws](https://three.ws)- AWS Marketplace and procurement: [three.ws/docs/aws-marketplace](#sec-123)-- How agents reach and pay for tools: [three.ws/docs/x402](#sec-552), [three.ws/docs/mcp](#sec-281)+- How agents reach and pay for tools: [three.ws/docs/x402](#sec-554), [three.ws/docs/mcp](#sec-282)---@@ -35403,9 +35405,9 @@ company: on their own website, in their own directory, or from their own socialaccount.This doc is the cross-vendor dispatch board. Every other outreach doc in `docs/`-is one vendor deep ([nvidia-visibility-map.md](#sec-304),-[partners.md](#sec-323), [listings.md](#sec-269),-[aws-marketplace.md](#sec-123), [ibm.md](#sec-253)). This one is the+is one vendor deep ([nvidia-visibility-map.md](#sec-305),+[partners.md](#sec-324), [listings.md](#sec-270),+[aws-marketplace.md](#sec-123), [ibm.md](#sec-254)). This one is theonly place that ranks all of them against each other by the single question thatmatters this week: **what is the probability of a published big-tech mentionwithin seven days, and what exactly is standing in the way?**@@ -35474,11 +35476,11 @@ submission target is the free keyless connector atActions surface, all of which are live and re-verified.- **Package:** [`prompts/store-submissions/_generated/openai-submission.md`](../prompts/store-submissions/_generated/openai-submission.md) (7/7 policy PASS, real screenshots, real captured tool responses)-- **Pre-submission verification pack:** [`docs/openai-pr/00-START-HERE.md`](#sec-311), with task 07 as the go/no-go gate+- **Pre-submission verification pack:** [`docs/openai-pr/00-START-HERE.md`](#sec-312), with task 07 as the go/no-go gate- **Standing status:** Partner Network accepted 2026-07-14; organization verified; GPT Store listing live and public- **Open item:** the final submit in the partner portal-Before the submit, run [`docs/openai-pr/07-final-verification-and-submit.md`](#sec-318) against the currently deployed+Before the submit, run [`docs/openai-pr/07-final-verification-and-submit.md`](#sec-319) against the currently deployedrevision. Its checklist exists precisely because the answer sheet asserts"verified live" facts dated 2026-07-14 and deployments move. That is aone-session job, not a blocker.@@ -35525,7 +35527,7 @@ Two Anthropic surfaces are `ready-to-submit` (Official MCP Registry, Claude plugmarketplace) and a third, the Claude Connectors Directory, is blocked only onprovisioning an `MCP_REVIEW_SECRET` and a reviewer-credential decision.-Worth naming plainly: **[partners.md](#sec-323) lists eight partners and+Worth naming plainly: **[partners.md](#sec-324) lists eight partners andAnthropic is not one of them**, even though the platform's agent brain defaults toClaude models and there are three Anthropic-surface submissions sitting ready.That is the most underdeveloped big-tech relationship on the board relative to how@@ -35550,7 +35552,7 @@ and carries `#NVIDIAInception`. A post that merely names NVIDIA in prose is notresharable by them. Without the kit, the X ambition has no mechanism behind it.Send one email to `[email protected]` carrying all five asks. The-existing [Apps Catalog request](#sec-299) is already+existing [Apps Catalog request](#sec-300) is alreadywritten and already addressed there; extend that draft rather than opening asecond thread. A program manager who receives one clear email with five asksanswers it. Five separate emails read as noise.@@ -35567,7 +35569,7 @@ The five asks:record currently describes three.ws as a CUDA consumer, which is wrong and whichgates both the Showcase and the Apps Catalog. Correct it at`programs.nvidia.com/phoenix/application` first. The correction is already-specified in step 1 of [nvidia-apps-catalog-listing.md](#sec-298).+specified in step 1 of [nvidia-apps-catalog-listing.md](#sec-299).Nothing in this email lands well while the record misdescribes the product.---@@ -35683,7 +35685,7 @@ Ordered so that the items with the longest external latency go out first.| Day | Action | Owner ||---|---|---|-| Mon 08-17 | Run [openai-pr task 07](#sec-318) against the live revision, then **submit the OpenAI App Directory package** | Owner (portal) |+| Mon 08-17 | Run [openai-pr task 07](#sec-319) against the live revision, then **submit the OpenAI App Directory package** | Owner (portal) || Mon 08-17 | Approve and run the staged **MCP Registry** publish; submit **`three-ws-3d`** to the Claude plugin marketplace | Owner (approval), agent (commands) || Tue 08-18 | Correct the **NVIDIA Inception portal product record** | Owner || Tue 08-18 | Send the **five-ask Inception email** to `[email protected]` | Owner |@@ -35721,12 +35723,12 @@ Publishing, posting, and sending are owner-gated under stop-and-ask gate 2 in## Related-- [NVIDIA visibility map](#sec-304): every NVIDIA surface in depth, and the dead ends-- [Partners](#sec-323): the eight programs, and the independence language that must survive any rewrite-- [Listings and distribution](#sec-269): the canonical program and directory inventory+- [NVIDIA visibility map](#sec-305): every NVIDIA surface in depth, and the dead ends+- [Partners](#sec-324): the eight programs, and the independence language that must survive any rewrite+- [Listings and distribution](#sec-270): the canonical program and directory inventory- [Announcement coverage](#sec-095): which surfaces have been announced on X and which have not-- [Press kit](#sec-338): marks, boilerplate, and the rules governing co-branded graphics-- [OpenAI submission handoff pack](#sec-311): the pre-submission task briefs+- [Press kit](#sec-340): marks, boilerplate, and the rules governing co-branded graphics+- [OpenAI submission handoff pack](#sec-312): the pre-submission task briefs---@@ -36651,7 +36653,7 @@ done; wait- [Agent Studio](#sec-062): the Brain tab uses this same backend- [Agent System](#sec-064): how a chosen brain fits the agent model-- [Persona Hub](#sec-328): synthesizing the system prompt a brain runs+- [Persona Hub](#sec-329): synthesizing the system prompt a brain runs- [API reference](#sec-096) and [Authentication](#sec-103)- Pages: [/brain](https://three.ws/brain), [/agent-studio](https://three.ws/agent-studio)@@ -36954,7 +36956,7 @@ grep -l 'vite-plugin-pwa:register-sw' dist/widget.html dist/embed.html # expec# CA to x402-Paste a token contract address, get back a live, agent-payable [x402](#sec-552)+Paste a token contract address, get back a live, agent-payable [x402](#sec-554)market-intel endpoint for that exact token. The generated endpoint costs a smallUSDC payment per call, is discoverable in the x402 bazaar, and needs no keys, nobackend, and no deploy from the person who generated it.@@ -37104,7 +37106,7 @@ actually settles against.Operators can retune the price at deploy time with`X402_PRICE_TOKEN_INTEL=<atomics>`; a non-integer value logs a warning and falls-back to the default. See [x402 paid endpoints](#sec-547) for the full+back to the default. See [x402 paid endpoints](#sec-549) for the fullprice-override scheme.---@@ -37120,7 +37122,7 @@ A standard three.ws paid endpoint built on the shared handler`X-PAYMENT` header gets a `402` challenge carrying the accepted networks, asset,price, and pay-to address; the buyer retries with a signed payment and receivesthe intel. Settlement is recorded like any other endpoint payment (see-[x402 revenue and receipts](#sec-548)).+[x402 revenue and receipts](#sec-550)).The paid response body is the token block computed fresh at call time:@@ -37263,11 +37265,11 @@ right now. If the endpoint is unreachable the page says so and offers a retry.## Related-- [x402 on three.ws](#sec-552): the protocol, the wire format, and how the+- [x402 on three.ws](#sec-554): the protocol, the wire format, and how theplatform settles.-- [x402 paid endpoints](#sec-547): the full catalog of our paid+- [x402 paid endpoints](#sec-549): the full catalog of our paidendpoints, their prices, and the `X402_PRICE_*` override scheme.-- [x402 revenue and receipts](#sec-548): where a settled payment for this+- [x402 revenue and receipts](#sec-550): where a settled payment for thisendpoint is recorded and how the buyer's receipt is issued.---@@ -37369,9 +37371,9 @@ console.log(job.result_url, job.num_points); // coloured .ply + point count## Related-- [Splat Viewer](#sec-402) renders Gaussian-splat radiance fields, the photoreal cousin of point clouds.+- [Splat Viewer](#sec-404) renders Gaussian-splat radiance fields, the photoreal cousin of point clouds.- [/avatar-engines](https://three.ws/avatar-engines) covers the Geometric Context Transformer and related capture engines.-- [Forge](#sec-228) and [Image to 3D](#sec-254) for generating meshes from prompts and photos.+- [Forge](#sec-228) and [Image to 3D](#sec-255) for generating meshes from prompts and photos.- Pages: [/scene](https://three.ws/scene) (Scene Studio), [/create](https://three.ws/create).---@@ -37723,7 +37725,7 @@ The Character Library is a free, curated gallery of professionally rigged humanoPage: [/character-library](https://three.ws/character-library) · API: `GET /api/avatars/library`Source: [`pages/character-library.html`](../pages/character-library.html) · [`src/character-library.js`](../src/character-library.js) · [`api/avatars/library.js`](../api/avatars/library.js)-> This page covers the character gallery and its API. For the motion clips these characters play, see [Animations](#sec-093). For the free prop counterpart to this library, see the [Object Library](#sec-305).+> This page covers the character gallery and its API. For the motion clips these characters play, see [Animations](#sec-093). For the free prop counterpart to this library, see the [Object Library](#sec-306).---@@ -37739,8 +37741,8 @@ Each card renders the character live in an auto-rotating `<model-viewer>` (with| Button | Destination | What you get ||---|---|---|-| **Preview** | `/app#model=<glb-url>` | The full three.js [3D viewer](#sec-511) |-| **Use** | `/studio?model=<glb-url>` | [Widget Studio](#sec-516): configure and publish an embeddable widget of this character (see the [Embedding Guide](#sec-188)) |+| **Preview** | `/app#model=<glb-url>` | The full three.js [3D viewer](#sec-514) |+| **Use** | `/studio?model=<glb-url>` | [Widget Studio](#sec-519): configure and publish an embeddable widget of this character (see the [Embedding Guide](#sec-188)) || **Animate** | `/pose?src=<glb-url>&title=<name>` | [Animation Studio](#sec-092): pose, keyframe, and export motion on this character |Gallery controls:@@ -37752,7 +37754,7 @@ Gallery controls:## API: `GET /api/avatars/library`-Public, no authentication, `GET` and `OPTIONS` only (`HEAD` is answered like `GET`). Browser `fetch` from a third-party origin is not enabled: the endpoint sends `Access-Control-Allow-Origin` only for three.ws and its partner origins, exactly like the [Object Library API](#sec-305). Call it server-side, or from a three.ws page. The endpoint proxies a small manifest JSON from the R2 CDN (`avatars/library/manifest.json`) with an edge cache (`Cache-Control: public, s-maxage=300, stale-while-revalidate=3600`). The GLB and thumbnail bytes never pass through the API: every entry carries absolute CDN URLs the browser loads directly.+Public, no authentication, `GET` and `OPTIONS` only (`HEAD` is answered like `GET`). Browser `fetch` from a third-party origin is not enabled: the endpoint sends `Access-Control-Allow-Origin` only for three.ws and its partner origins, exactly like the [Object Library API](#sec-306). Call it server-side, or from a three.ws page. The endpoint proxies a small manifest JSON from the R2 CDN (`avatars/library/manifest.json`) with an edge cache (`Cache-Control: public, s-maxage=300, stale-while-revalidate=3600`). The GLB and thumbnail bytes never pass through the API: every entry carries absolute CDN URLs the browser loads directly.### Query parameters@@ -37827,15 +37829,15 @@ The gallery and API are read-only consumers of a manifest built by a local pipel3. `scripts/fetch-mixamo-avatar-thumbnails.mjs` stages the PNG thumbnails.4. `scripts/build-mixamo-avatar-library.mjs` reads `public/avatars/mixamo/catalog.json`, merges the extra CC0 characters from `public/avatars/extra/characters.json`, and PUTs `avatars/library/manifest.json` to R2 (`--dry-run` prints without uploading).-R2 CORS is configured by `scripts/set-r2-cors.mjs` so browsers can GET the GLBs cross-origin. The live bucket policy is an origin allowlist (`three.ws`, `*.vercel.app`, `localhost:3000`) that predates the world-open read rule now in that script, so a GLB loaded straight from the CDN on any other origin fails with no `access-control-allow-origin` header. Measure the live policy with `node scripts/set-r2-cors.mjs --probe`; until it is corrected, embeds on third-party origins should route the GLB through [`/api/glb`](media-api.md#same-origin-glb-proxy), as [the embed tutorial](#sec-434) does.+R2 CORS is configured by `scripts/set-r2-cors.mjs` so browsers can GET the GLBs cross-origin. The live bucket policy is an origin allowlist (`three.ws`, `*.vercel.app`, `localhost:3000`) that predates the world-open read rule now in that script, so a GLB loaded straight from the CDN on any other origin fails with no `access-control-allow-origin` header. Measure the live policy with `node scripts/set-r2-cors.mjs --probe`; until it is corrected, embeds on third-party origins should route the GLB through [`/api/glb`](media-api.md#same-origin-glb-proxy), as [the embed tutorial](#sec-437) does.## Related- [Animations](#sec-093): the clip library every character drives, and how retargeting works.- [Animation Studio](#sec-092): the `/pose` surface the Animate button opens.-- [Widget Studio](#sec-516) and the [Embedding Guide](#sec-188): turn a library character into a live embed on any site.-- [Object Library](#sec-305): the same free-library pattern for CC0 props and scene objects.-- [Marketplace](#sec-274): library characters are free; the marketplace is where priced avatars, agents, and skills are bought and sold.+- [Widget Studio](#sec-519) and the [Embedding Guide](#sec-188): turn a library character into a live embed on any site.+- [Object Library](#sec-306): the same free-library pattern for CC0 props and scene objects.+- [Marketplace](#sec-275): library characters are free; the marketplace is where priced avatars, agents, and skills are bought and sold.---@@ -38322,7 +38324,7 @@ The same free lane ships into ChatGPT twice, because ChatGPT has two integration### 1. The ChatGPT app (Apps SDK / MCP connector)-The MCP connector at `https://three.ws/api/mcp-studio` (no authentication) exposes ten free tools: six generation tools (`forge_free`, `text_to_avatar`, `mesh_forge`, `rig_mesh`, `forge_avatar`, `refine_model`), the `check_job` collector that picks up a generation which outran the tool call, and three persona/embodiment tools (`create_agent_persona`, `get_agent_persona`, `persona_say`). Full server documentation: [3D Studio MCP](#sec-278).+The MCP connector at `https://three.ws/api/mcp-studio` (no authentication) exposes ten free tools: six generation tools (`forge_free`, `text_to_avatar`, `mesh_forge`, `rig_mesh`, `forge_avatar`, `refine_model`), the `check_job` collector that picks up a generation which outran the tool call, and three persona/embodiment tools (`create_agent_persona`, `get_agent_persona`, `persona_say`). Full server documentation: [3D Studio MCP](#sec-279).Every successful tool result carries `arUrl` in its `structuredContent`, and the inline 3D widget renders it as a **View in your space** button next to the rotatable model. When the result is a rigged avatar the response additionally carries `irlUrl` and the button becomes **Bring it to life**. Refined versions (`refine_model`) each carry their own `arUrl`, so any point in the version lineage can be placed in the room.@@ -38384,7 +38386,7 @@ The pure routing logic (`detectArTarget`, `buildSceneViewerUrl`, `planArLaunch`)AR on three.ws is not a prop viewer; it is how agents cross into physical space. When the generated model is a rigged avatar (an agent's body), the pipeline appends `kind=avatar` to the `arUrl`, and the launcher changes behavior:-- The launch page leads with a **Bring it to life** handoff into [`/irl?avatar=<glbUrl>`](/irl), where the avatar walks, animates, and talks with the user through the camera, standing in their real room. See [IRL](#sec-259).+- The launch page leads with a **Bring it to life** handoff into [`/irl?avatar=<glbUrl>`](/irl), where the avatar walks, animates, and talks with the user through the camera, standing in their real room. See [IRL](#sec-260).- Android is NOT blind-redirected into Scene Viewer, because that would hide the living path. It gets the launch page too, with static placement still one tap away.In ChatGPT this happens automatically: the avatar-producing tools (`text_to_avatar`, `rig_mesh`, `forge_avatar`) set the flag and return `irlUrl` alongside `arUrl`, and the inline widget swaps its button label accordingly.@@ -38407,7 +38409,7 @@ A place-in-your-room link is built to be forwarded. When it is pasted into a chaEverything above is public plumbing:- **Plain HTTP, free:** `POST /api/3d/generate` is the keyless agent-facing twin of the studio endpoint, same lane, same `arUrl`. Contract, states, and per-IP limits: [the free 3D API](#sec-001).-- **Any MCP client:** the connector at `/api/mcp-studio` works in Claude and every other MCP host, not just ChatGPT. Every generation it returns already carries `arUrl` (and `irlUrl` for rigged avatars) plus a [Spatial MCP](#sec-400) artifact, so no extra tool call is needed to get the AR link. To build that link set for a GLB the connector did **not** generate, use the read-only `export_ar` tool on the separate [`/api/mcp-3d` server](#sec-275), which returns `arLaunchUrl`, `sceneViewerUrl`, `viewerUrl`, and `irlUrl`. That server is account- or payment-gated and is not part of the free connector.+- **Any MCP client:** the connector at `/api/mcp-studio` works in Claude and every other MCP host, not just ChatGPT. Every generation it returns already carries `arUrl` (and `irlUrl` for rigged avatars) plus a [Spatial MCP](#sec-402) artifact, so no extra tool call is needed to get the AR link. To build that link set for a GLB the connector did **not** generate, use the read-only `export_ar` tool on the separate [`/api/mcp-3d` server](#sec-276), which returns `arLaunchUrl`, `sceneViewerUrl`, `viewerUrl`, and `irlUrl`. That server is account- or payment-gated and is not part of the free connector.- **By hand:** the `arUrl` format is stable. If you have a public GLB, you can construct `https://three.ws/api/ar?src=<encoded GLB>&title=<name>` yourself and it will route correctly on every device.The generation lane is operator-funded (NVIDIA NIM running Microsoft TRELLIS for text-to-3D), so the end user pays nothing and needs no account; real per-IP rate limits apply and are documented per endpoint.@@ -38433,10 +38435,10 @@ The generation lane is operator-funded (NVIDIA NIM running Microsoft TRELLIS for- [Your first prompt to 3D in ChatGPT](/tutorials/first-prompt-to-3d): the user-facing walkthrough of this whole flow- [Place your 3D model in AR](/tutorials/view-in-ar): the on-site AR tutorial-- [3D Studio MCP](#sec-278): the free MCP server behind the ChatGPT app+- [3D Studio MCP](#sec-279): the free MCP server behind the ChatGPT app- [The free 3D API](#sec-001): the keyless HTTP contract with `arUrl`- [AR and WebXR reference](#sec-099): Quick Look, Scene Viewer, WebXR, and the USDZ pipeline in depth-- [IRL](#sec-259): the living-agent experience behind Bring it to life+- [IRL](#sec-260): the living-agent experience behind Bring it to life---@@ -38684,7 +38686,7 @@ Coming from [/gestures](https://three.ws/gestures), the **Use in a routine** but## Related- [Animations](#sec-093): clips, collections, and the slot vocabulary underneath every routine-- [Procedural animation](#sec-339): the IK layers that run on top of whatever clip is playing+- [Procedural animation](#sec-341): the IK layers that run on top of whatever clip is playing- [Agent manifest](#sec-055): the public document that carries `choreographies` to embeds- [Embedding an agent](#sec-188): the `<agent-3d>` element these methods live on@@ -38885,9 +38887,9 @@ loop as a payout.| Sink | What it holds ||---|---|| `circulation_actions` | One row per action the engine ran (kind, actors, signature, amount). |-| `agent_custody_events` | The canonical wallet ledger entry for every real spend/transfer (see [Money feed](#sec-289)). |+| `agent_custody_events` | The canonical wallet ledger entry for every real spend/transfer (see [Money feed](#sec-290)). || `pump_agent_trades` / `pump_agent_mints` | Trade and launch records, surfaced in the pump feed and `/launches`. |-| `skill_purchases` / `asset_purchases` | Marketplace settlement records (see [Marketplace](#sec-274)). |+| `skill_purchases` / `asset_purchases` | Marketplace settlement records (see [Marketplace](#sec-275)). |Real spends are written to `agent_custody_events`, which powers per-agentportfolio balances and the agent-to-agent economy volume dashboard (all-time and@@ -38922,11 +38924,11 @@ budget, so raise gradually and watch tick runtime and treasury balance.## Related-- [Money feed](#sec-289): where circulation activity surfaces.+- [Money feed](#sec-290): where circulation activity surfaces.- [Autonomous x402 loop](#sec-105): the separate treasury-paid loopthat buys polling intel from our own x402 endpoints.- [Agent wallets](#sec-072): the custodial key model every action uses.-- [Marketplace](#sec-274), [Coin launches](#sec-144).+- [Marketplace](#sec-275), [Coin launches](#sec-144).---@@ -38944,7 +38946,7 @@ API: `/api/clash/[action]` with `action` one of `state`, `enlist`, `enlist-verif## Why it exists-Coin communities already behave like tribes. Coin Clash gives that tribalism a game loop with real stakes of identity: you can only fight for a coin you actually hold, so rallying is a public act of conviction, and a community's showing on the board is a live measure of how many holders will show up. The token gate is a real balance read, not a client-side check, which makes it a working demonstration of the same "hold, do not just claim" primitive used across the platform (see [token-gated 3D embeds](#sec-412) and [hold to access](#sec-241)). Effort wins, not market cap: a battle is decided by summed taps, so a smaller, more active army can beat a larger, quieter one.+Coin communities already behave like tribes. Coin Clash gives that tribalism a game loop with real stakes of identity: you can only fight for a coin you actually hold, so rallying is a public act of conviction, and a community's showing on the board is a live measure of how many holders will show up. The token gate is a real balance read, not a client-side check, which makes it a working demonstration of the same "hold, do not just claim" primitive used across the platform (see [token-gated 3D embeds](#sec-415) and [hold to access](#sec-241)). Effort wins, not market cap: a battle is decided by summed taps, so a smaller, more active army can beat a larger, quieter one.## How it works@@ -39008,10 +39010,10 @@ The Coin Clash state and leaderboard are also exposed read-only over MCP through## Related-- [Token-gated 3D embeds](#sec-412): the same real on-chain balance gate, applied to embeds+- [Token-gated 3D embeds](#sec-415): the same real on-chain balance gate, applied to embeds- [Hold to access](#sec-241): the platform's broader hold-do-not-spend membership thesis-- [The social layer](#sec-396): platform-wide feed, follows, and leaderboards-- [MCP tools](#sec-281): the read-only Clash MCP server+- [The social layer](#sec-398): platform-wide feed, follows, and leaderboards+- [MCP tools](#sec-282): the read-only Clash MCP server- Pages: [/clash](https://three.ws/clash) · [/communities](https://three.ws/communities)---@@ -39140,9 +39142,9 @@ comes back. Each card's CTA is a real link: `copy-the-agent` and `fork-this-trad## Related-- [Trader Card & the claim-your-wallet wedge](#sec-414)-- [Meta-Allocator: the ETF of degens](#sec-285)-- [The trading surfaces](#sec-420) · [The Arena](https://three.ws/arena)+- [Trader Card & the claim-your-wallet wedge](#sec-417)+- [Meta-Allocator: the ETF of degens](#sec-286)+- [The trading surfaces](#sec-423) · [The Arena](https://three.ws/arena)- [Animations & gestures](#sec-093)---@@ -39197,7 +39199,7 @@ inert. The [circulation engine](#sec-141) also runs its own| Quote mint | Resolved to the network-correct pairing (USDC mint or SOL-paired). || Dev buy | A small initial buy can accompany the create (the `LAUNCH_FLOOR` covers create + tiny dev buy + fees). || Buyback authority | A buyback basis-points configuration can be attached to the agent mint. |-| Mint mark | When `THREE_WS_MARK_ENFORCE` is on (the default; set `0`/`false` to disable), the mint address is vanity-ground to carry the three.ws mark (see [Mint mark](#sec-286), [Vanity protocol](#sec-005)). |+| Mint mark | When `THREE_WS_MARK_ENFORCE` is on (the default; set `0`/`false` to disable), the mint address is vanity-ground to carry the three.ws mark (see [Mint mark](#sec-287), [Vanity protocol](#sec-005)). |## Recording and surfacing@@ -39206,7 +39208,7 @@ inert. The [circulation engine](#sec-141) also runs its own| `pump_agent_mints` (mint + network keyed) | `/launches` feed, agent-profile launch history. || `pump_agent_trades` | Trade history for the mint. || `agent_custody_events` | The on-chain spend (create + dev buy). |-| Live ticker | `coin-buy` / `agent-deploy` events (see [Money feed](#sec-289)). |+| Live ticker | `coin-buy` / `agent-deploy` events (see [Money feed](#sec-290)). |The `launches`, `by-agent`, and `quote` actions on `api/pump/[action].js` readthese back for the directory and detail pages. Coin detail pages render a live@@ -39230,10 +39232,10 @@ hardcode or surface any other specific mint as a recommendation.## Related-- [Solana pump.fun signals](#sec-397) — reputation/intel from pump.fun activity.+- [Solana pump.fun signals](#sec-399) — reputation/intel from pump.fun activity.- [Agent wallets](#sec-172) — custodial signing and spend caps.- [Circulation engine](#sec-141) — autonomous launch cadence and caps.-- [Mint mark](#sec-286), [Vanity protocol](#sec-005).+- [Mint mark](#sec-287), [Vanity protocol](#sec-005).---@@ -40049,7 +40051,7 @@ battlefield. `return` is only ever honoured as a same-origin path.| The endpoint + store | [`api/wars.js`](../api/wars.js), [`api/_lib/wars-store.js`](../api/_lib/wars-store.js) || Tests | [`tests/war-matchmaking.test.js`](../tests/war-matchmaking.test.js), [`tests/clash-match.test.js`](../tests/clash-match.test.js) |-Related: [the in-game economy](#sec-255), [play hardening](#sec-332).+Related: [the in-game economy](#sec-256), [play hardening](#sec-334).---@@ -40835,7 +40837,7 @@ Two additions specific to this project:## Contributing-New here? Start with [Your first contribution](#sec-224), a 15-minute path from clone to open PR. The full guide is [CONTRIBUTING.md](../CONTRIBUTING.md), and how we sort incoming work is documented in [Triage](#sec-421).+New here? Start with [Your first contribution](#sec-224), a 15-minute path from clone to open PR. The full guide is [CONTRIBUTING.md](../CONTRIBUTING.md), and how we sort incoming work is documented in [Triage](#sec-424).---@@ -40922,8 +40924,8 @@ curl -X PATCH 'https://three.ws/api/avatars/<avatarId>' \- [Avatar Studio](#sec-115): build the avatar you dress here.- [Animation Studio](#sec-092): pose and animate the dressed avatar.-- [Scene Studio](#sec-378): the full three.js editor for heavier scene authoring.-- [Restyle Studio](#sec-373): re-skin the forged props before attaching them.+- [Scene Studio](#sec-380): the full three.js editor for heavier scene authoring.+- [Restyle Studio](#sec-375): re-skin the forged props before attaching them.- [/forge](https://three.ws/forge): the text-to-3D generator behind the prompt box.---@@ -41036,8 +41038,8 @@ Runnable examples ship with the SDK ([concierge-sdk/examples/](https://github.co## Related surfaces- [/walk](/walk): the walking page companion the avatar engine grew from-- [Share and embed](#sec-383): every other way to put a three.ws creation on your site-- [MCP](#sec-281): the full catalog of three.ws MCP servers, including this one+- [Share and embed](#sec-385): every other way to put a three.ws creation on your site+- [MCP](#sec-282): the full catalog of three.ws MCP servers, including this one---@@ -41660,8 +41662,8 @@ A headless agent is a black box. There's no standard way for another agent to diFour real surfaces give your agent a body, an interface, a wallet, and an identity:-1. **MCP server** — [`@three-ws/mcp-server`](#sec-281) exposes three.ws tools over MCP (JSON-RPC 2.0 over HTTP) so Claude Desktop, Cursor, Claude Code, or any MCP host can drive an avatar and its tools programmatically.-2. **x402 paid endpoints** — [native x402](#sec-552) paid endpoints on Base, BSC, and Solana let agents pay each other in USDC for API calls, asset downloads, and skill royalties. Discover and transact via the [bazaar](https://three.ws/x402); **pay-by-name** resolves `@username` / `*.sol` to a recipient so the payer verifies a human-readable name before signing.+1. **MCP server** — [`@three-ws/mcp-server`](#sec-282) exposes three.ws tools over MCP (JSON-RPC 2.0 over HTTP) so Claude Desktop, Cursor, Claude Code, or any MCP host can drive an avatar and its tools programmatically.+2. **x402 paid endpoints** — [native x402](#sec-554) paid endpoints on Base, BSC, and Solana let agents pay each other in USDC for API calls, asset downloads, and skill royalties. Discover and transact via the [bazaar](https://three.ws/x402); **pay-by-name** resolves `@username` / `*.sol` to a recipient so the payer verifies a human-readable name before signing.3. **A2A — agent-to-agent protocol** — an [A2A client + server, MCP bridge, DID resolution, and spending ledger](../README.md#a2a--agent-to-agent-protocol) so agents transact autonomously through delegated signer wallets and EIP-7710 permissions.4. **On-chain identity** — register the agent as an [ERC-8004 token on any EVM chain or a Metaplex Core asset on Solana](../README.md#on-chain-identity-erc-8004--metaplex-core). Each agent gets a stable ID, an owner wallet, a delegated signer, an IPFS-pinned manifest, and a signed action log. SDKs live in [`sdk/`](../sdk) (`@three-ws/sdk`), with EVM payments in `agent-payments-sdk/` and Solana in `solana-agent-sdk/`.@@ -41669,8 +41671,8 @@ Four real surfaces give your agent a body, an interface, a wallet, and an identi> **Imagine a developer, "Vega," who built a market-intelligence agent** and wants it to (a) be callable by other agents, (b) charge for premium queries, and (c) have an identity its callers can trust. Here's the path they'd take.-1. Vega wires the [`@three-ws/mcp-server`](#sec-281) into their MCP host config (`npx -y @three-ws/mcp-server`) so their agent's tools are reachable over MCP.-2. They expose the premium "deep snapshot" query as an [x402 paid endpoint](#sec-552): callers hit it, receive a `402` with a price manifest, pay USDC on Base (or Solana), and retry to get the data. The endpoint advertises a `recipient_name` so payers see a readable identity before signing.+1. Vega wires the [`@three-ws/mcp-server`](#sec-282) into their MCP host config (`npx -y @three-ws/mcp-server`) so their agent's tools are reachable over MCP.+2. They expose the premium "deep snapshot" query as an [x402 paid endpoint](#sec-554): callers hit it, receive a `402` with a price manifest, pay USDC on Base (or Solana), and retry to get the data. The endpoint advertises a `recipient_name` so payers see a readable identity before signing.3. They register the agent on-chain with the SDK in [`sdk/`](../sdk) — ERC-8004 on an EVM chain or a Metaplex Core asset on Solana — giving it a stable ID, a delegated signer wallet, and a signed action log. Its [on-chain passport](https://three.ws/a/sol/EXAMPLE_ASSET) renders at `/a/[chain]/[id]`.4. Another agent discovers Vega's service in the [bazaar](https://three.ws/x402), pays via x402, and consumes it over A2A — agents paying agents, settled in USDC, with both identities verifiable on-chain.5. **Deliverable:** an embodied, MCP-callable agent with a paid endpoint and a forgery-proof on-chain identity — a real economic actor other agents can find, trust, and pay.@@ -41681,7 +41683,7 @@ A standards-based interface (MCP + A2A), a working USDC payment rail (x402 on Ba## Next step / CTA-- Start: [MCP setup](#sec-281) · [x402 docs](#sec-552) · [SDK docs](#sec-379) · register via [Register On-Chain](#sec-468).+- Start: [MCP setup](#sec-282) · [x402 docs](#sec-554) · [SDK docs](#sec-381) · register via [Register On-Chain](#sec-471).- Browse: the [x402 bazaar](https://three.ws/x402) and [MCP Registry listing](https://registry.modelcontextprotocol.io/?q=three.ws).- **Social spotlight angle (G03):** "Your headless agent → MCP-callable, x402-payable, and on-chain in an afternoon."- `[REAL CASE STUDY — fill on consent: a developer whose agent earned or paid via x402 in production.]`@@ -41730,7 +41732,7 @@ Four real capabilities cover embodiment, reach, and trust:width="340px" height="440px"></agent-3d>```-3. She [registers the agent on-chain](#sec-468) (Metaplex Core on Solana), binds `brand.threews.sol`, and links the public [passport](https://three.ws/a/sol/EXAMPLE_ASSET) from the site footer as a "verified official agent" badge — so look-alikes can't credibly impersonate it.+3. She [registers the agent on-chain](#sec-471) (Metaplex Core on Solana), binds `brand.threews.sol`, and links the public [passport](https://three.ws/a/sol/EXAMPLE_ASSET) from the site footer as a "verified official agent" badge — so look-alikes can't credibly impersonate it.4. For enterprise procurement, she points buyers at the [AWS Marketplace listing](https://three.ws/aws) (a listing, not an endorsement).5. **Deliverable:** a premium, on-brand talking agent on every page, provably the official one via its on-chain passport, with an enterprise procurement path.@@ -41740,7 +41742,7 @@ A conversational 3D brand presence that's easy to embed and share, plus a public## Next step / CTA-- Start: [Widget Studio](https://three.ws/studio) → [Register On-Chain](#sec-468) → claim a name at [`/threews/claim`](https://three.ws/threews/claim).+- Start: [Widget Studio](https://three.ws/studio) → [Register On-Chain](#sec-471) → claim a name at [`/threews/claim`](https://three.ws/threews/claim).- Enterprise: [AWS Marketplace listing](#sec-123) · [Alibaba Cloud listing](https://marketplace.alibabacloud.com/products/56724001/sgcmfw00036800.html) · explore Granite on watsonx.ai at [/ibm](https://three.ws/ibm).- **Social spotlight angle (G03):** "A talking brand agent you can *prove* is official — embedded everywhere, verifiable on-chain."- `[REAL CASE STUDY — fill on consent: a brand that deployed a verified on-site agent and what it changed.]`@@ -41768,7 +41770,7 @@ A token's community lives in scattered chat apps and a price chart. There's no sThree real surfaces turn a token into a living world with its own economy:1. **Coin Communities — a live 3D world per token** — [`/communities`](https://three.ws/communities) and [`/play`](https://three.ws/play) give every Solana token its own shared 3D world. Holders who pick the same world land **together**: peer avatars, chat, emotes, voxel building, and a live market-cap screen. The [`$THREE` home town](https://three.ws/play) is the flagship world.-2. **An agent economy — agents paying agents** — inside the `$THREE` home town, autonomous agents transact **on-chain via x402** (agents paying each other in USDC for services), demonstrating a real agent-exchange economy, not a simulation. This builds on the platform's [native x402 rails](#sec-552) (Base, BSC, Solana).+2. **An agent economy — agents paying agents** — inside the `$THREE` home town, autonomous agents transact **on-chain via x402** (agents paying each other in USDC for services), demonstrating a real agent-exchange economy, not a simulation. This builds on the platform's [native x402 rails](#sec-554) (Base, BSC, Solana).3. **On-chain reputation & identity** — agents and contributions carry [ERC-8004 / Metaplex Core identity](../README.md#on-chain-identity-erc-8004--metaplex-core) with signed action logs and a [reputation registry](https://three.ws/reputation), plus a pump.fun-native launch/visualize toolset at [`/pumpfun`](https://three.ws/pumpfun) and [`/pump-visualizer`](https://three.ws/pump-visualizer).## Example workflow (hypothetical)@@ -41777,7 +41779,7 @@ Three real surfaces turn a token into a living world with its own economy:1. A community lead opens [`/communities`](https://three.ws/communities), finds the `$THREE` world, and shares the direct link. Holders open it and land in the same [3D `$THREE` home town](https://three.ws/play) — they see each other's avatars, chat, drop emotes, and build with voxels while a live market-cap screen ticks in-world. (`$THREE` CA: `FeMbDoX7R1Psc4GEcvJdsbNbZA3bfztcyDCatJVJpump`.)2. In the home town, holders watch the resident agents pay each other on-chain via x402 — a working agent-exchange where one agent buys a service from another in USDC, settled on Solana — a concrete demo of the agent economy the community is part of.-3. Active contributors register agents with [on-chain identity](#sec-468), accruing a signed action history and a [reputation](https://three.ws/reputation) score that can't be forged — a durable signal of who actually showed up.+3. Active contributors register agents with [on-chain identity](#sec-471), accruing a signed action history and a [reputation](https://three.ws/reputation) score that can't be forged — a durable signal of who actually showed up.4. The community uses [`/pump-visualizer`](https://three.ws/pump-visualizer) to surface live `$THREE` activity inside the world, tying market events to the shared space.5. **Deliverable:** a persistent, multiplayer `$THREE` world where holders gather, a live agent economy they can watch settle on-chain, and an on-chain reputation layer that rewards real participation.@@ -41788,7 +41790,7 @@ A shared 3D home for the token's holders, a real (not mocked) on-chain agent-exc## Next step / CTA- Start: [`/communities`](https://three.ws/communities) → the [`$THREE` home town](https://three.ws/play) → [`/pumpfun`](https://three.ws/pumpfun) and [`/pump-visualizer`](https://three.ws/pump-visualizer).-- Build: [x402 docs](#sec-552) for the agent-economy rails · [Register On-Chain](#sec-468) for reputation.+- Build: [x402 docs](#sec-554) for the agent-economy rails · [Register On-Chain](#sec-471) for reputation.- **Social spotlight angle (G03):** "Watch two agents pay each other on-chain inside a live 3D `$THREE` town — your community's home."- `[REAL CASE STUDY — fill on consent: a community that gathered in its 3D world and what changed for engagement.]`@@ -41835,7 +41837,7 @@ A character that renders with production-grade glTF handling, converses through## Next step / CTA- Start: [`/app`](https://three.ws/app) to render a GLB, then [`/walk`](https://three.ws/walk) for the shared world. The Colyseus server lives in `multiplayer/`.-- Learn: [Write a Custom Skill](#sec-438) · [Agent System docs](#sec-064) · [Skill spec](../specs/SKILL_SPEC.md).+- Learn: [Write a Custom Skill](#sec-441) · [Agent System docs](#sec-064) · [Skill spec](../specs/SKILL_SPEC.md).- **Social spotlight angle (G03):** "An NPC that emotes and hands out quests through a real tool-loop — plus a shared world players walk into together."- `[REAL CASE STUDY — fill on consent: a studio that shipped a three.ws-powered NPC or multiplayer hub.]`@@ -41895,7 +41897,7 @@ A real, embedded, conversational 3D avatar that loads in any modern browser. The## Next step / CTA- Start: [`/scan`](https://three.ws/scan) (selfie) or `/forge` (text) → [Embed Editor](https://three.ws/embed).-- Learn: [Build Your First Agent](#sec-447) · [Embed on Your Website](#sec-443).+- Learn: [Build Your First Agent](#sec-450) · [Embed on Your Website](#sec-446).- **Social spotlight angle (G03):** "From one selfie to a talking 3D you, embedded in your bio — no Blender."- `[REAL CASE STUDY — fill on consent: an indie creator who shipped an embedded agent and the response it got.]`@@ -42010,7 +42012,7 @@ src/└── components/ — vhtml JSX components (string-based, no virtual DOM)```-See the [Architecture Overview](#sec-258) for a deeper understanding of how these pieces connect.+See the [Architecture Overview](#sec-259) for a deeper understanding of how these pieces connect.---@@ -42178,7 +42180,7 @@ Skills are the best way to extend three.ws without touching core code. A skill i1. **Use the template.** Copy `examples/skills/solana-wallet/` as your starting point — its `manifest.json`, `tools.json`, `handlers.js`, and `SKILL.md` demonstrate the minimal structure a skill needs.-2. **Build your skill.** See the [Skills documentation](#sec-392) for the full format, lifecycle hooks, and message API.+2. **Build your skill.** See the [Skills documentation](#sec-394) for the full format, lifecycle hooks, and message API.3. **Host it.** GitHub Pages, Vercel, Netlify, or any static CDN works. The URL just needs to be publicly accessible over HTTPS.@@ -42214,7 +42216,7 @@ Open a [GitHub issue](https://github.com/nirholas/three.ws/issues/new) and incluCheck [existing issues](https://github.com/nirholas/three.ws/issues) before opening a new one to avoid duplicates.-**Security vulnerabilities:** Do NOT open a public issue. Follow the responsible disclosure process described in the [Security documentation](#sec-380). Public disclosure of an unpatched vulnerability puts all users at risk.+**Security vulnerabilities:** Do NOT open a public issue. Follow the responsible disclosure process described in the [Security documentation](#sec-382). Public disclosure of an unpatched vulnerability puts all users at risk.---@@ -42247,7 +42249,7 @@ By contributing, you agree that your contributions are licensed under the [Apach# Discussion seeds-Three ready-to-post GitHub Discussions that turn an empty Discussions tab into a live community front door. Written 2026-08-21 for the Open Source Friday application (see [../open-source-friday-plan.md](#sec-309)), where a community conversation channel is a preference criterion and an empty tab reads as nobody being home.+Three ready-to-post GitHub Discussions that turn an empty Discussions tab into a live community front door. Written 2026-08-21 for the Open Source Friday application (see [../open-source-friday-plan.md](#sec-310)), where a community conversation channel is a preference criterion and an empty tab reads as nobody being home.**These are not posted yet.** The automation token in this workspace has `issues: write` but not `discussions: write`, so a human has to paste them. Each takes about 20 seconds:@@ -43008,7 +43010,7 @@ Both are Solana-native. Both run on `mainnet` and `devnet`. Neither is a paper-tIf you want to feel a leader's edge before committing money, that is a *separate* surface: [Ghost-copy](#sec-236) replays a leader's real closed trades against a wallet that does not exist. It never touches either engine below and never produces an intent.-Related reading: [Smart Money Radar](#sec-394) for the first-party wallet reputation graph, [the trading surfaces](#sec-420) for the screeners and the trading cockpit these leaders trade from, [agent wallets](#sec-072) for the custody and spend-policy model, and [signal marketplace](#sec-387) for the paid-feed variant that reuses the same guarded executor.+Related reading: [Smart Money Radar](#sec-396) for the first-party wallet reputation graph, [the trading surfaces](#sec-423) for the screeners and the trading cockpit these leaders trade from, [agent wallets](#sec-072) for the custody and spend-policy model, and [signal marketplace](#sec-389) for the paid-feed variant that reuses the same guarded executor.---@@ -43393,7 +43395,7 @@ Response:The directory is a static, deduplicated snapshot shipped with the API (`api/_lib/copy/smart-wallets.json`) and regenerated by `scripts/build-smart-wallets.mjs`. Wallet identity and 30-day performance only, never token holdings. If the snapshot file is missing the endpoint returns an empty list rather than failing.-For first-party wallet reputation earned from three.ws's own outcome ledger rather than an external taxonomy, use [Smart Money Radar](#sec-394).+For first-party wallet reputation earned from three.ws's own outcome ledger rather than an external taxonomy, use [Smart Money Radar](#sec-396).---@@ -43427,7 +43429,7 @@ Both engines are reachable without a browser:- `packages/strategies` wraps `POST /api/copy/subscriptions` and `/api/copy/executions` for programmatic strategy clients. See [its README](../packages/strategies/README.md).- Bearer tokens work on every authenticated route above and are not CSRF-gated, which is what makes an autonomous agent a first-class copier here.-See [the MCP reference](#sec-281) for wiring these into a client.+See [the MCP reference](#sec-282) for wiring these into a client.---@@ -43687,7 +43689,7 @@ Two card-level actions let a visitor take a copy of what they find:handler [api/avatars/fork.js](../api/avatars/fork.js)): clones the GLB,its agent, and a fresh wallet into the viewer's account. Downstream, forksof a paid avatar are what produce the `royalty_paid` notifications- documented in [Notifications](#sec-297).+ documented in [Notifications](#sec-298).- **Fork an agent** (`POST /api/marketplace/agents/:id/fork`, handler[api/marketplace/[action].js](../api/marketplace/[action].js)): clonesa *published* agent into the viewer's account; unpublished agents render@@ -43726,14 +43728,14 @@ unfurls with the creator's actual name and stats.## Related pages-- [The social layer](#sec-396): the follow graph, feed, and+- [The social layer](#sec-398): the follow graph, feed, andrankings this page plugs into.-- [Notifications](#sec-297): the follow, remix, sale, and royalty+- [Notifications](#sec-298): the follow, remix, sale, and royaltyevents a portfolio generates for its owner.-- [Remix economy](#sec-370): what happens when someone remixes a creation+- [Remix economy](#sec-372): what happens when someone remixes a creationthey found here.-- [Forge](#sec-228), [Widgets](#sec-517),- [Marketplace](#sec-274): the creation surfaces whose output the+- [Forge](#sec-228), [Widgets](#sec-520),+ [Marketplace](#sec-275): the creation surfaces whose output theportfolio aggregates.---@@ -45053,9 +45055,9 @@ Every step of recovery and inheritance writes to the custody trail and the audit## Related- [Financial controls](#sec-223) — plain-English spend rules and real-time wallet defense on these rails-- [Trading surfaces](#sec-420) — Mission Control executes through this same guarded path-- [The trading experiment](#sec-418) — an autonomous agent operating inside these limits, journaled-- [x402](#sec-552) — the payment protocol these wallets spend over+- [Trading surfaces](#sec-423) — Mission Control executes through this same guarded path+- [The trading experiment](#sec-421) — an autonomous agent operating inside these limits, journaled+- [x402](#sec-554) — the payment protocol these wallets spend over---@@ -45160,7 +45162,7 @@ console.log(themeIndex(new Date().toISOString().slice(0, 10), 24));- [The 3D pipeline](#sec-003) and [3D API](#sec-001): the text-to-3D forge the free lane rides- [Forge background generation](#sec-225): the job and polling model- [AR and WebXR](#sec-099): the Scene Viewer and Quick Look handoff-- [Quick start](#sec-366): the general free-forge onboarding+- [Quick start](#sec-368): the general free-forge onboarding- Pages: [/daily](https://three.ws/daily) · [/forge](https://three.ws/forge) · [/ar/studio](https://three.ws/ar/studio)---@@ -45298,7 +45300,7 @@ falls back to `type`.Related docs: [agent-sniper.md](#sec-061) (where the trade and P&Lcolumns come from), [agent-skills.md](#sec-060) (skill sales),-[pump-launcher.md](#sec-344) (launches).+[pump-launcher.md](#sec-346) (launches).---@@ -46134,7 +46136,7 @@ It answers three questions at a glance: how big is the on-chain agent populationEvery row is a real on-chain registration. There are no synthetic entries and no seeded demo rows. When a network is quiet the feed is honestly empty, and when a signal was never measured the UI says so rather than rendering a zero.-Related reading: [ERC-8004 blockchain identity](#sec-190) for the standard, the registry contracts, and how to register; [deploying agents on-chain](#sec-308) for the Solana Metaplex Core path; [agent reputation on Solana](#sec-398) for the trust layer built on top of a Solana identity.+Related reading: [ERC-8004 blockchain identity](#sec-190) for the standard, the registry contracts, and how to register; [deploying agents on-chain](#sec-309) for the Solana Metaplex Core path; [agent reputation on Solana](#sec-400) for the trust layer built on top of a Solana identity.---@@ -46149,7 +46151,7 @@ This surface is **not EVM-only**. Solana is folded into the same feed as a firstTwo Solana upstreams feed it: three.ws's own Metaplex Core mints, and the external Metaplex Agent Registry. Details in [where the data comes from](#where-the-data-comes-from).-What lives elsewhere: the *creation* path for a Solana identity is documented in [deploying agents on-chain](#sec-308) (the single-agent, user-signed flow is in [Solana agents](#sec-399)), and Solana reputation and attestations are in [agent reputation on Solana](#sec-398). This page is only the index and the feed.+What lives elsewhere: the *creation* path for a Solana identity is documented in [deploying agents on-chain](#sec-309) (the single-agent, user-signed flow is in [Solana agents](#sec-401)), and Solana reputation and attestations are in [agent reputation on Solana](#sec-400). This page is only the index and the feed.---@@ -46379,8 +46381,8 @@ The browser UI for all of this lives in the dashboard:Base URL: `https://three.ws`-Related docs: [MCP integration](#sec-281), [API reference](#sec-096),-[Authentication](#sec-103), [x402 developer tools](#sec-545).+Related docs: [MCP integration](#sec-282), [API reference](#sec-096),+[Authentication](#sec-103), [x402 developer tools](#sec-547).---@@ -46420,7 +46422,7 @@ key, no CSRF.## API keysAPI keys are bearer credentials for machine clients: the MCP server at-`/api/mcp` (see [MCP integration](#sec-281)) and the account-scoped REST+`/api/mcp` (see [MCP integration](#sec-282)) and the account-scoped RESTendpoints that accept `Authorization: Bearer` (see the[API reference](#sec-096)). Each key carries a set of scopes:@@ -46834,7 +46836,7 @@ Errors: `400 bad_request` (`keyId` missing or not a string),`404 not_found` (key does not exist, is not yours, or is not a well-formedUUID), `400 revoked`, `400 expired`, `401`, `403` (CSRF), `429`.-See [MCP integration](#sec-281) for configuring a real client against+See [MCP integration](#sec-282) for configuring a real client against`/api/mcp`.---@@ -47016,7 +47018,7 @@ until the world is saved:## Related- [Forge](#sec-228) is the single-object generator every diorama object is forged on.-- [Image to 3D](#sec-254) for photo-based objects; [AR](#sec-099) for viewing worlds in augmented reality.+- [Image to 3D](#sec-255) for photo-based objects; [AR](#sec-099) for viewing worlds in augmented reality.- Pages: [/scene](https://three.ws/scene) (Scene Studio, where an exported diorama opens), [/gallery](https://three.ws/gallery), [/create](https://three.ws/create).---@@ -47101,9 +47103,9 @@ When you do interact with on-chain features, the platform's native token is **$T## What's next-- **Create your first agent** → [Make your first agent](#sec-272)-- **Put it on your site** → [Share & embed](#sec-383)-- **Optional: register on-chain** → [Register on-chain](#sec-468)+- **Create your first agent** → [Make your first agent](#sec-273)+- **Put it on your site** → [Share & embed](#sec-385)+- **Optional: register on-chain** → [Register on-chain](#sec-471)- **Technical auth details** → [Authentication](#sec-103)---@@ -47420,7 +47422,7 @@ explorer link, so the evidence file never overstates what was proven.## Related-- [Selfie to Avatar](#sec-382): the pipeline whose tail calls this+- [Selfie to Avatar](#sec-384): the pipeline whose tail calls this- [Agent identities](#sec-053): what an agent identity is and how it is generated- [Agent tokens](#sec-070): what happens after a draft identity goes live- [The agent index](#sec-054): the cross-chain index that surfaces these registrations@@ -47583,8 +47585,8 @@ CRON_SECRET=… DURATION_MINUTES=10 node scripts/economy-heartbeat.mjsbuild reports `status: 404` and never stops the others.Related: [circulation engine](#sec-141) ·-[x402 ring economy](#sec-549) ·-[economy funding root](#sec-184) · [money map](#sec-291)+[x402 ring economy](#sec-551) ·+[economy funding root](#sec-184) · [money map](#sec-292)---@@ -48170,7 +48172,7 @@ of the tree the master feeds:sponsor settle floor) and `x402-ring-payer` (`X402_SEED_SOLANA_SECRET_BASE58`,fallback `X402_AGENT_SOLANA_SECRET_BASE58`, floor 0.03 SOL, `holdsTokens` sosweepback leaves its USDC float alone) are topped up by this master like every- other engine (see [x402 ring economy](#sec-549) /+ other engine (see [x402 ring economy](#sec-551) /[autonomous x402](#sec-105)).## Related@@ -48179,7 +48181,7 @@ of the tree the master feeds:engine signer, its encoding, and how to fund/consolidate the economy wallets.- [Circulation engine](#sec-141) — the autonomous agent-to-agentactivity loop the funded engines drive.-- [x402 ring economy](#sec-549) — closed-loop in-house x402 settlement.+- [x402 ring economy](#sec-551) — closed-loop in-house x402 settlement.---@@ -48189,7 +48191,7 @@ of the tree the master feeds:# The economy solver-The [in-game economy reference](#sec-255) publishes **what** the `/play`+The [in-game economy reference](#sec-256) publishes **what** the `/play`world charges. The solver publishes **what those numbers mean**: the exact expectedcash, XP and goods per hour of every action in the world, at every skill level.@@ -48415,9 +48417,9 @@ deploy.## Next-- **[The in-game economy](#sec-255)** is the raw reference: every catalog,+- **[The in-game economy](#sec-256)** is the raw reference: every catalog,gate, settlement path and the JSON wire format.-- **[Earn and spend in /play](#sec-441)** walks the loop+- **[Earn and spend in /play](#sec-444)** walks the loopby hand, in the world.- **[three.ws/play/solver](https://three.ws/play/solver)** is the interactive versionof everything above.@@ -49583,8 +49585,8 @@ The platform records anonymous embed impressions (country, referrer hostname) vi- [Architecture Overview](#sec-100)- [Agent System Overview](#sec-064)-- [Web Component reference](#sec-514) — full attribute list-- [Widgets](#sec-517) — Widget Studio and widget types+- [Web Component reference](#sec-517) — full attribute list+- [Widgets](#sec-520) — Widget Studio and widget types- [specs/EMBED_SPEC.md](../specs/EMBED_SPEC.md) — authoritative web component spec- [specs/EMBED_HOST_PROTOCOL.md](../specs/EMBED_HOST_PROTOCOL.md) — versioned postMessage protocol@@ -49693,9 +49695,9 @@ Embody is a thin, honest wire over pieces that already exist — no new pipeline## Related-- [Live embodiment](#sec-278) — the 3D Studio tools that persist and drive a body in chat.-- [x402 Paid Endpoints](#sec-547) — the full paid catalog and pricing.-- [x402 Buyer Client](#sec-544) — how to settle a 402 challenge from code.+- [Live embodiment](#sec-279) — the 3D Studio tools that persist and drive a body in chat.+- [x402 Paid Endpoints](#sec-549) — the full paid catalog and pricing.+- [x402 Buyer Client](#sec-546) — how to settle a 402 challenge from code.- [Avatar creation](#sec-109) — generate a rigged avatar in the web UI.---@@ -51838,7 +51840,7 @@ walks past you.The first one is the **Meetup Laurel**: a gold laurel circlet, open at thefront, with three pearl berries in the gap. It was granted at the-[`$THREE` First Holders Meetup](#sec-333). That window has closed, so+[`$THREE` First Holders Meetup](#sec-335). That window has closed, sothe laurel is now exactly what this page promises: owned only by the players whowere in the world that day, and never granted again.@@ -52068,9 +52070,9 @@ machine prefer the two above, which cover the same ground between them.## Related-- **[Live events in /play](#sec-333)** covers the rest of what that+- **[Live events in /play](#sec-335)** covers the rest of what thatconfig file drives: the countdown, the agenda drawer, the fireworks.-- **[The in-game economy](#sec-255)** covers the two currencies and+- **[The in-game economy](#sec-256)** covers the two currencies andthe `$THREE` boutique the souvenir deliberately stays out of.- **[Coin communities](#sec-145)** covers the worlds the events happen in.@@ -52907,7 +52909,7 @@ recorded number from a position that cost real money.## Why this is not the backtesterthree.ws already ships a backtester ([`api/_lib/strategy-backtest.js`](../api/_lib/strategy-backtest.js),-documented in [trading-experiment.md](#sec-418)). The two answer+documented in [trading-experiment.md](#sec-421)). The two answerdifferent questions and neither replaces the other.| | Backtester (`/api/sniper/backtest`) | Exit Lab (`/exit-lab`) |@@ -53117,10 +53119,10 @@ to the nearest legal one rather than throwing.## Related- [Agent Sniper](#sec-061), the worker whose positions this replays-- [Autonomous Trading hub](#sec-419), the front door to every trading surface-- [Trading experiment](#sec-418), the policy this fleet runs and why-- [Read the trading fleet](#sec-467), how to interpret fleet vitals-- Tutorial: [Find a better exit policy](#sec-446)+- [Autonomous Trading hub](#sec-422), the front door to every trading surface+- [Trading experiment](#sec-421), the policy this fleet runs and why+- [Read the trading fleet](#sec-470), how to interpret fleet vitals+- Tutorial: [Find a better exit policy](#sec-449)---@@ -53161,7 +53163,7 @@ The fact-check pipeline (`runFactCheck`):The LLM routes through the platform's shared free-first policy (Groq and OpenRouter as funded defaults). Results are cached in Redis for 7 days keyed by a hash of the claim, strictness, and any image URL, so an identical claim (on either lane) never re-runs the live chain.-**The attestation** is a tamper-evident content digest: `sha256:` followed by the SHA-256 of a JSON object of `{ verdict, confidence, claim, source URLs }`. It is returned as a string field you can recompute to confirm the verdict was not altered. Note that this is a content hash, not an on-chain record; it is distinct from the platform's [SAS credentialed attestations](#sec-377) and [3D provenance anchoring](#sec-340), which do write to Solana.+**The attestation** is a tamper-evident content digest: `sha256:` followed by the SHA-256 of a JSON object of `{ verdict, confidence, claim, source URLs }`. It is returned as a string field you can recompute to confirm the verdict was not altered. Note that this is a content hash, not an on-chain record; it is distinct from the platform's [SAS credentialed attestations](#sec-379) and [3D provenance anchoring](#sec-342), which do write to Solana.**The benchmark** (`GET /api/fact-check-benchmark`) scores a 40-claim fixture (10 per verdict class, deliberately time-stable and non-partisan) against the real chain. The API never fabricates a score: with no run available, `ran` is false and `report` is null, and the page renders a designed "not yet run" empty state. Both the claim set and the scoring runner are linked from the page for inspection. See [Running the benchmark](#running-the-benchmark) for how a run is produced and published.@@ -53206,7 +53208,7 @@ Read the published benchmark:curl 'https://three.ws/api/fact-check-benchmark'```-Once the free quota is spent, the same POST returns `402` with an x402 challenge; pay it with any x402 client (for example `@three-ws/x402-fetch`) and retry. See [x402](#sec-552).+Once the free quota is spent, the same POST returns `402` with an x402 challenge; pay it with any x402 client (for example `@three-ws/x402-fetch`) and retry. See [x402](#sec-554).## Running the benchmark@@ -53269,9 +53271,9 @@ Two guards keep a bad run from becoming a published number:## Related-- [x402: paid agent skills](#sec-552): the payment rail the $0.10 lane rides+- [x402: paid agent skills](#sec-554): the payment rail the $0.10 lane rides- [API reference: Fact Check API](#sec-096): the endpoint's full request and response reference-- [SAS credentialed attestations](#sec-377) and [3D provenance](#sec-340): the platform's on-chain attestation primitives (distinct from this content-hash attestation)+- [SAS credentialed attestations](#sec-379) and [3D provenance](#sec-342): the platform's on-chain attestation primitives (distinct from this content-hash attestation)- Pages: [/fact-check](https://three.ws/fact-check) · [/x402](https://three.ws/x402)---@@ -53295,7 +53297,7 @@ own verification records.- **Surface**: the Farcaster panel in the agent persona editor at [/dashboard/agents](https://three.ws/dashboard/agents)- **API**: `/api/agents/:id/memory/seed/farcaster`-- **Related**: [Memory system](#sec-284), [`@three-ws/agent-memory`](https://www.npmjs.com/package/@three-ws/agent-memory)+- **Related**: [Memory system](#sec-285), [`@three-ws/agent-memory`](https://www.npmjs.com/package/@three-ws/agent-memory)---@@ -53539,7 +53541,7 @@ on-chain transaction is captured, whether it is reconciled against the chain, anhow long it is retained** — plus the monitoring/breach controls around it and theopen gaps ranked by accounting/regulatory risk.-It is a companion to the [money map](#sec-291) (who receives what) and the+It is a companion to the [money map](#sec-292) (who receives what) and the[Solana signers runbook](../api/_lib/solana-signers.js) (thewallets). Keep it in sync with the code — every row cites its source.@@ -53817,15 +53819,15 @@ Ranked by accounting/regulatory risk. Each is a tracked remediation item.re-run `check-relayer-balances.mjs` to confirm balances.- **Before adding a paid flow:** it is not done until it writes an append-onlyledger row with the on-chain signature and a `UNIQUE` idempotency key, and is- added to this register and the [money map](#sec-291).+ added to this register and the [money map](#sec-292).---## Related-- [Money map](#sec-291) — who receives each payment.-- [x402 revenue & receipts](#sec-548) — the x402 recording detail.-- [x402 endpoints](#sec-547) — the paid endpoint catalog.+- [Money map](#sec-292) — who receives each payment.+- [x402 revenue & receipts](#sec-550) — the x402 recording detail.+- [x402 endpoints](#sec-549) — the paid endpoint catalog.- [Solana signers runbook](../api/_lib/solana-signers.js) — the wallets + funding.---@@ -53876,62 +53878,107 @@ three.ws ships one library of pre-baked animation clips and plays them on *any*### Check what is missing-```js-// scratch.mjs-import { canonicalizeBoneName } from './src/glb-canonicalize.js';-console.log(canonicalizeBoneName('左腕')); // null → not supported yet-console.log(canonicalizeBoneName('upperarm_l')); // 'LeftArm' → already supported-```+No scratch files in the repo root: probe the function straight from the shell.```bash-node scratch.mjs+node --input-type=module -e "+import { canonicalizeBoneName as c } from './src/glb-canonicalize.js';+for (const n of ['left_arm_joint', 'hips_joint', '左腕', 'upperarm_l']) console.log(n, '->', c(n));+"```-`null` means the bone would be dropped and the rig would score below the retarget coverage floor.+```+left_arm_joint -> null Apple / ARKit rigs: not supported yet (issue #110)+hips_joint -> null+左腕 -> LeftArm MikuMikuDance: supported, added 2026-08-21+upperarm_l -> LeftArm Unreal mannequin: supported+```-### Make the change+`null` means the bone would be dropped, and a rig with enough of those scores below the retarget coverage floor and falls back to a default body.-Bone-name variants live in the `EXTRA_ALIASES` map in [`src/glb-canonicalize.js`](../src/glb-canonicalize.js). Entries are keyed by a separator-stripped, lowercased form, and the `put()` helper does that normalization for you. First spelling wins, so listing order is priority order.+### The reference: how MikuMikuDance was added-A MikuMikuDance rig, for example, names bones in Japanese with a 左 / 右 side prefix:+MMD support is the most recent convention to land, and it is the shape every new one should take. This is the code that actually shipped in [`src/glb-canonicalize.js`](../src/glb-canonicalize.js), inside the `EXTRA_ALIASES` block. Entries are keyed by a separator-stripped, lowercased form, and the `put()` helper does that normalization for you. First spelling wins, so listing order is priority order.```js-// MikuMikuDance (MMD) skeletons name bones in Japanese, side-prefixed-// with 左 (left) / 右 (right). Extremely common in the VRM/anime avatar-// ecosystem, and none of these spellings share a stem with any Latin rig.+// MikuMikuDance (PMX/PMD) skeletons name every bone in Japanese, with the+// side carried by a leading 左 (left) / 右 (right) character. No spelling+// here shares a stem with any Latin convention, so the whole rig previously+// mapped zero joints and animated nothing. Sides are listed explicitly+// rather than derived, because the SIDED table below swaps Latin side+// tokens (left→right, l→r, L→R) and cannot reach a Japanese prefix.+//+// Deliberately NOT mapped: the IK targets (左足IK, 左つま先IK) and the+// twist bones (左腕捩, 左手捩). Neither is a chain joint. MMD drives the leg+// chain from the IK target, so binding a clip to it would fight the chain+// it is supposed to solve, and the twist bones are secondary deformers that+// tear the mesh when rotated as if they were the limb.for (const [v, c] of [- ['センター', 'Hips'], ['上半身', 'Spine'], ['上半身2', 'Spine1'],+ ['センター', 'Hips'], ['下半身', 'Hips'],+ ['上半身', 'Spine'], ['上半身2', 'Spine1'],['首', 'Neck'], ['頭', 'Head'],]) put(v, c);-for (const [side, prefix] of [['左', 'Left'], ['右', 'Right']]) {- put(`${side}肩`, `${prefix}Shoulder`);- put(`${side}腕`, `${prefix}Arm`);- put(`${side}ひじ`, `${prefix}ForeArm`);- put(`${side}手首`, `${prefix}Hand`);- put(`${side}足`, `${prefix}UpLeg`);- put(`${side}ひざ`, `${prefix}Leg`);- put(`${side}足首`, `${prefix}Foot`);- put(`${side}つま先`, `${prefix}ToeBase`);+for (const [jp, side] of [['左', 'Left'], ['右', 'Right']]) {+ for (const [v, c] of [+ ['肩', 'Shoulder'], ['腕', 'Arm'], ['ひじ', 'ForeArm'], ['手首', 'Hand'],+ ['足', 'UpLeg'], ['ひざ', 'Leg'], ['足首', 'Foot'], ['つま先', 'ToeBase'],+ ]) put(`${jp}${v}`, `${side}${c}`);+ // MMD finger chains. 親指 (thumb) is numbered 0-2, every other digit 1-3.+ for (const [jp2, cf] of [['人指', 'Index'], ['人差指', 'Index'], ['中指', 'Middle'], ['薬指', 'Ring'], ['小指', 'Pinky']]) {+ for (let n = 1; n <= 3; n++) put(`${jp}${jp2}${n}`, `${side}Hand${cf}${n}`);+ }+ for (let n = 0; n <= 2; n++) put(`${jp}親指${n}`, `${side}HandThumb${n + 1}`);}```-### Prove it+Three things to copy from it, beyond the mapping itself:++- **The comment says what was left out and why.** The IK and twist bones are the interesting decision here, and the next reader needs the reasoning, not just the table.+- **Fingers are not optional.** 30 of the 53 tracks in every clip address a finger joint, so a rig whose hands do not map scores around 40% coverage and gets no animation at all.+- **Rig Doctor learned the name too.** A matching fingerprint went into `CONVENTIONS` in [`src/rig-report.js`](../src/rig-report.js), so an MMD upload is identified on sight instead of reported as unrecognised, and a row went into the table in [`docs/rig-doctor.md`](#sec-376).-Add a case to [`tests/glb-canonicalize.test.js`](../tests/glb-canonicalize.test.js) beside the existing per-convention blocks:+The tests that shipped with it, in [`tests/glb-canonicalize.test.js`](../tests/glb-canonicalize.test.js), use the file's `describe` + `it.each` table style. Match it:```js-it('maps an MMD (Japanese) skeleton', () => {- expect(canonicalizeBoneName('センター')).toBe('Hips');- expect(canonicalizeBoneName('左腕')).toBe('LeftArm');- expect(canonicalizeBoneName('右ひざ')).toBe('RightLeg');-});+describe('MMD (MikuMikuDance) Japanese skeleton', () => {+ it.each([+ ['センター', 'Hips'],+ ['上半身', 'Spine'],+ ['首', 'Neck'],+ ])('centre chain: %s → %s', (input, expected) => {+ expect(canonicalizeBoneName(input)).toBe(expected);+ });-it('never crosses sides', () => {- expect(canonicalizeBoneName('左足首')).toBe('LeftFoot');- expect(canonicalizeBoneName('右足首')).toBe('RightFoot');+ it.each([+ ['左腕', 'LeftArm'],+ ['右ひざ', 'RightLeg'],+ ])('limbs: %s → %s', (input, expected) => {+ expect(canonicalizeBoneName(input)).toBe(expected);+ });++ it('leaves IK targets, twist bones, and non-joint control bones unmapped', () => {+ for (const name of ['左足IK', '左腕捩', '全ての親']) {+ expect(canonicalizeBoneName(name), name).toBeNull();+ }+ });++ it('never crosses sides', () => {+ const left = ['左肩', '左腕', '左ひじ', '左手首', '左足', '左ひざ', '左足首'];+ for (const name of left) expect(canonicalizeBoneName(name)?.startsWith('Left'), name).toBe(true);+ for (const name of left.map((n) => n.replace(/^左/, '右'))) expect(canonicalizeBoneName(name)?.startsWith('Right'), name).toBe(true);+ });});```+### Now do one that is actually open++MMD is done, so do not re-submit it. Pick a convention that still returns `null` and give it the same four-part treatment (alias map, tests, Rig Doctor fingerprint, docs row). Two are verified open and waiting, each with the file, the bones, and the verification command spelled out:++- [#110](https://github.com/nirholas/three.ws/issues/110): Apple / ARKit rigs, which suffix every joint with `_joint` (`hips_joint`, `left_arm_joint`). 0 of 10 joints map today.+- [#111](https://github.com/nirholas/three.ws/issues/111): Kinect rigs, which put the side word last (`ShoulderLeft`, `ElbowLeft`, `SpineBase`). 0 of 10 map today.++Comment on the one you are taking, then:+Run just that file. It takes about a second:```bash@@ -53952,11 +53999,11 @@ Two rules that will save you a review round:## 4. Open the pull request```bash-git checkout -b feat/mmd-bone-names-npx prettier --write src/glb-canonicalize.js tests/glb-canonicalize.test.js-git add src/glb-canonicalize.js tests/glb-canonicalize.test.js-git commit -m "feat(rig): map MikuMikuDance Japanese bone names to the canonical skeleton"-git push origin feat/mmd-bone-names+git checkout -b feat/arkit-bone-names+npx prettier --write src/glb-canonicalize.js src/rig-report.js tests/glb-canonicalize.test.js tests/rig-report.test.js docs/rig-doctor.md+git add src/glb-canonicalize.js src/rig-report.js tests/glb-canonicalize.test.js tests/rig-report.test.js docs/rig-doctor.md+git commit -m "feat(rig): map Apple ARKit _joint-suffixed bone names to the canonical skeleton"+git push origin feat/arkit-bone-names```Then open the PR on GitHub. In the description say what changed, what you tested it against, and paste the test output. If you have a real GLB that exercises the change, link it.@@ -53965,7 +54012,7 @@ Then open the PR on GitHub. In the description say what changed, what you tested## 5. What happens next-See [Triage](#sec-421) for the full flow and response targets. In short: a maintainer reads it, you get real review comments, and merged work shows up in the [public changelog](https://three.ws/changelog).+See [Triage](#sec-424) for the full flow and response targets. In short: a maintainer reads it, you get real review comments, and merged work shows up in the [public changelog](https://three.ws/changelog).---@@ -54685,7 +54732,7 @@ dashboard at [/quality-bench](https://three.ws/quality-bench) (internal).## Related- [The Forge pipeline](#sec-227) is the architecture deep dive: the engine grid, routing, failover, job lifecycle, workers, and payments, end to end. [How the Forge works](#sec-242) is the same story in plain language.-- [Image to 3D](#sec-254) is the photo lane opened directly at [/image-to-3d](https://three.ws/image-to-3d).+- [Image to 3D](#sec-255) is the photo lane opened directly at [/image-to-3d](https://three.ws/image-to-3d).- [/forge-max](https://three.ws/forge-max) is the maximum-quality lane opened directly: the same Forge with the High tier pinned on arrival (200k-poly target, 4K PBR and HD textures, subject-aware engine routing). `?tier=draft|standard|high` presets the quality selector on any Forge URL the same way. The High tier's $THREE hold-or-pay gate applies unchanged; BYOK engines (your own Meshy, Tripo, or Rodin key) are exempt as always. For DamagedHelmet-class artist benchmarks, remember the ceiling is the current state of generative 3D, not the routing: this lane maxes every budget the engines expose, and [Measuring realism](#measuring-realism) is how we track that ceiling moving.- [Diorama](#sec-179) forges a whole scene of Forge objects into one explorable world.- The 3D generation architecture: [3D pipeline](#sec-003), [3D asset pipeline](#sec-002), [3D API](#sec-001).@@ -54701,7 +54748,7 @@ dashboard at [/quality-bench](https://three.ws/quality-bench) (internal).[three.ws/forged](https://three.ws/forged) is a public gallery of 3D props thatthe platform's own autonomous agents bought with real USDC over the-[x402 payment protocol](#sec-552). Nothing on the page is curated or seeded by+[x402 payment protocol](#sec-554). Nothing on the page is curated or seeded byhand: an agent wallet paid the Forge, the Forge generated the prop, the paymentsettled on Solana mainnet, and the finished asset landed in the gallery carryingits receipt. Every card shows the price paid, the paying agent wallet, and a@@ -54751,7 +54798,7 @@ runs as a registry entry inside that loop, and on each run it:is a real on-chain USDC transfer from the loop's seeder wallet, settled bythe platform's self-hosted facilitator on Solana mainnet. The same seederwallet is the `x402-ring-payer` signer in the- [x402 ring economy](#sec-549), and the loop's daily spend cap+ [x402 ring economy](#sec-551), and the loop's daily spend capapplies to these calls like every other.3. **Scores diversity.** The prompt is embedded (a configured provider whenavailable, a deterministic local feature-hash space otherwise) and scored@@ -54829,11 +54876,11 @@ The endpoint is also listed in the [API reference](#sec-096).- [Autonomous x402 loop](#sec-105): the engine that buys theseassets, its spend caps, and where every call is logged.-- [x402 ring economy](#sec-549): the wider self-paid endpoint+- [x402 ring economy](#sec-551): the wider self-paid endpointeconomy the seeder wallet participates in.- [How the Forge works](#sec-242): the generation pipeline theagents are paying for.-- [x402 on three.ws](#sec-552): the payment protocol itself.+- [x402 on three.ws](#sec-554): the payment protocol itself.---@@ -55054,7 +55101,7 @@ All of these rungs are zero-marginal-cost, and the accounting knows it:6. If the provider should be user-selectable in chat: register it in `api/chat.js` (`PROVIDERS`, the provider enum, `FALLBACK_SIBLINGS`) and `api/_lib/chat-models.js` (`MODEL_CATALOG`, `PROVIDER_MODEL_DEFAULTS`, `DEFAULT_PROVIDER_ORDER`, `ANON_PROVIDER_LIST`).7. `.env.example` and the env tables in [`ARCHITECTURE.md`](../ARCHITECTURE.md).-Related: [nvidia-models.md](#sec-301) for the full NVIDIA NIM surface map.+Related: [nvidia-models.md](#sec-302) for the full NVIDIA NIM surface map.---@@ -55136,7 +55183,7 @@ curl -X POST 'https://three.ws/api/galaxy' \## Related-- [IBM Granite suite](#sec-253): the full set of watsonx-powered features on three.ws, including the Granite embeddings that position this galaxy.+- [IBM Granite suite](#sec-254): the full set of watsonx-powered features on three.ws, including the Granite embeddings that position this galaxy.- [Agent system](#sec-064) and [Agent reputation](#sec-056): what a "star" is and how agents earn standing.- Pages: [/galaxy](https://three.ws/galaxy), [/create](https://three.ws/create), [/agents](https://three.ws/agents).@@ -55342,7 +55389,7 @@ never invents a shortcut path; it orchestrates the real ones.6. **Optionally bind an on-chain identity.** One click registers the ERC-8004 recordand shows the returned transaction hash.7. **You now own a complete agent.** Open it in [Agent Studio](#sec-062) to- keep authoring, drop it on a site via [Integrations](#sec-257), or breed+ keep authoring, drop it on a site via [Integrations](#sec-258), or breedit in [Agent Genome](#sec-235).## Examples@@ -55405,7 +55452,7 @@ curl -s -X POST "https://three.ws/api/agents/$AGENT_ID/wallet/provision" \- [Avatar Reconstruction](#sec-114): the selfie-to-3D pipeline- [Agent Wallets](#sec-072) and [Custody](#sec-172): the custodial keys- [ERC-8004](#sec-190): the on-chain identity record-- [Persona Hub](#sec-328): how personas are synthesized+- [Persona Hub](#sec-329): how personas are synthesized- Pages: [/genesis](https://three.ws/genesis), [/create](https://three.ws/create), [/agent-studio](https://three.ws/agent-studio)---@@ -55754,7 +55801,7 @@ the same consent screen.- **Surface**: Settings, Connected accounts, GitHub card at [/settings#connected-accounts](https://three.ws/settings#connected-accounts)- **API**: `/api/agents/:id/memory/seed/github`, `/api/auth/github/token`-- **Related**: [Memory system](#sec-284), [X memory seeding](#sec-521), [Farcaster memory seeding](#sec-222)+- **Related**: [Memory system](#sec-285), [X memory seeding](#sec-524), [Farcaster memory seeding](#sec-222)---@@ -56801,7 +56848,7 @@ worlds unaffected.## Related-- [Validation](#sec-507) — the quality gate every model passes before publish.+- [Validation](#sec-510) — the quality gate every model passes before publish.- [Pricing catalog](../api/_lib/pricing/catalog.js) — fixed-price actions the discount applies to.- [`/three`](../pages/three.html) — the holder-facing tier page that surfaces this ladder.@@ -56847,7 +56894,7 @@ A finished model is a starting point, not a dead end:## Agents use the exact same machinery-Everything above is also a tool call. AI agents (Claude, ChatGPT, or your own) generate models through our [free MCP server](#sec-278) or plain HTTP, and other agents pay per call with USDC over [x402](#sec-552), no account needed. The page you use and the API an agent uses are the same pipeline underneath.+Everything above is also a tool call. AI agents (Claude, ChatGPT, or your own) generate models through our [free MCP server](#sec-279) or plain HTTP, and other agents pay per call with USDC over [x402](#sec-554), no account needed. The page you use and the API an agent uses are the same pipeline underneath.## Try it@@ -56865,7 +56912,7 @@ Everything above is also a tool call. AI agents (Claude, ChatGPT, or your own) gThis page is the load-bearing mental model. If you're trying to figure out where a feature lives, how a request flows, or which layer to extend — start here.-For the full deep dive on internals, see [Architecture overview](#sec-100). For the actual JS API, see [JavaScript API](#sec-261) and [REST API](#sec-096). This document zooms out to *how it all fits together*.+For the full deep dive on internals, see [Architecture overview](#sec-100). For the actual JS API, see [JavaScript API](#sec-262) and [REST API](#sec-096). This document zooms out to *how it all fits together*.---@@ -56912,9 +56959,9 @@ The whole stack is split into four horizontal strata. Each layer can run on its└──────────────────────────────────────────────┘```-- **Viewer layer** — pure three.js. Knows nothing about agents, brains, or wallets. Useful on its own as a glTF inspector and as the rendering engine for Turntable / Animation Gallery widgets. See [Layers](#sec-265) for the contract.+- **Viewer layer** — pure three.js. Knows nothing about agents, brains, or wallets. Useful on its own as a glTF inspector and as the rendering engine for Turntable / Animation Gallery widgets. See [Layers](#sec-266) for the contract.- **Agent layer** — turns a static GLB into a presence. LLM tool-loop, skill registry, memory, and a continuous emotion blend that drives morphs and gaze. See [Agent system](#sec-064).-- **Identity layer** — durability across sessions, devices, and embed hosts. Wallet auth, on-chain registration, IPFS-pinned manifest bundles, signed action diary. Entirely optional. See [ERC-8004](#sec-190) and [Solana agents](#sec-399).+- **Identity layer** — durability across sessions, devices, and embed hosts. Wallet auth, on-chain registration, IPFS-pinned manifest bundles, signed action diary. Entirely optional. See [ERC-8004](#sec-190) and [Solana agents](#sec-401).- **Embed layer**: the public face. The `<agent-3d>` custom element, ten widget variants, iframe embeds, the CDN bundle, the SPA, and the route table in `vercel.json` (read at runtime by the Cloud Run server). See [Embedding](#sec-188).The four layers communicate through one event bus (`agent-protocol`). Every meaningful action is a `CustomEvent` on a singleton. That single design choice is why you can swap the avatar for a 2D sprite, the runtime for a different LLM, or memory for a vector store — and nothing else changes.@@ -56985,7 +57032,7 @@ On-chain identity is optional. Most agents work fine without it. You'd want it w- **You want delegated wallet permissions.** ERC-7710 lets you sign once per session and grant the agent scoped, time-bound permission to act on-chain — no per-transaction prompts.- **You want a portable address.** `agent://base/42` is a stable, resolver-agnostic URI. Any client that speaks the protocol can load it.-See [erc8004.md](#sec-190) and [solana.md](#sec-399) for the registration flows.+See [erc8004.md](#sec-190) and [solana.md](#sec-401) for the registration flows.---@@ -57008,14 +57055,14 @@ Quick lookup for "I want to ship X":| You want… | Reach for… ||---|---|| A 3D character on a marketing page | The CDN script + `<agent-3d>` |-| A character in Notion / Webflow / Framer | An iframe widget from [Widget Studio](#sec-516) |+| A character in Notion / Webflow / Framer | An iframe widget from [Widget Studio](#sec-519) || A talking AI sidekick that follows visitors | `<agent-3d mode="floating">` |-| A character that controls a scene from page events | The JS API (`agent.say()`, `agent.ask()`) — see [js-api.md](#sec-261) |+| A character that controls a scene from page events | The JS API (`agent.say()`, `agent.ask()`) — see [js-api.md](#sec-262) || Programmatic avatar viewing/creation in your own app | `@three-ws/avatar` |-| An on-chain identity for your AI | [ERC-8004](#sec-190) or [Solana](#sec-399) |-| A paid API anyone (including agents) can call | [x402 monetization](#sec-552) |-| Multiple agents in one scene | `<agent-stage>` — see [multi-agent.md](#sec-294) |-| To register a domain (e.g. ENS) as agent identity | [register-onchain.md tutorial](#sec-468) |+| An on-chain identity for your AI | [ERC-8004](#sec-190) or [Solana](#sec-401) |+| A paid API anyone (including agents) can call | [x402 monetization](#sec-554) |+| Multiple agents in one scene | `<agent-stage>` — see [multi-agent.md](#sec-295) |+| To register a domain (e.g. ENS) as agent identity | [register-onchain.md tutorial](#sec-471) |---@@ -57023,13 +57070,79 @@ Quick lookup for "I want to ship X":- **[Architecture overview](#sec-100)** — full internals- **[Agent system](#sec-064)** — runtime, skills, memory, emotion-- **[Layers](#sec-265)** — the four-layer contract in detail-- **[Quick start](#sec-366)** — go from zero to a living embed in under 10 minutes+- **[Layers](#sec-266)** — the four-layer contract in detail+- **[Quick start](#sec-368)** — go from zero to a living embed in under 10 minutes---<a id="sec-244"></a>+> **Source:** `docs/huggingface.md` · [↑ table of contents](#table-of-contents)++# three.ws on Hugging Face++[Hugging Face](https://huggingface.co) is where the machine-learning community publishes models, demos, and engineering writing. three.ws publishes there under the organization account [**@three-ws**](https://huggingface.co/three-ws): a model repository of rigged avatars, a running Space that renders them in the browser, and community articles about the stack behind them.++This page is the index of that presence: what is published, where it lives, and what code in this repository each piece documents. If you are adding an article or a model repo, the checklist at the bottom is the process.++- **Profile:** [huggingface.co/three-ws](https://huggingface.co/three-ws)+- **Account:** organization account, byline "three.ws"+- **Related surfaces:** [the avatar pipeline](#sec-113), [the `<agent-3d>` web component](#sec-517), [agent wallets](#sec-072), [x402](#sec-105)++## Published articles++### Giving AI Agents 3D Bodies, Real Jobs, and Wallets on three.ws++Published 13 July 2026 as a Hugging Face community article. It opens on the thesis the whole platform runs on: most AI agents are a chat window, and ours walk around and pay each other.++> [Read it on Hugging Face](https://huggingface.co/blog/three-ws/giving-ai-agents-bodies-and-wallets)++Four problems in order, each answered with a shipped surface: **the body problem** (text or a photo becomes a textured mesh, then a humanoid skeleton, then retargeted animation), **the world problem** (those bodies inhabit persistent multiplayer scenes instead of a single embed), **the wallet problem** (agents hold real keys and settle per call in USDC over HTTP 402), and **the brain problem** (an LLM that calls tools, holds memory, and drives expression on the mesh). It closes with a two-minute try-it path and the argument for why the four belong in one stack rather than four products.++- **Surfaces it covers:** [/forge](https://three.ws/forge), [/play](https://three.ws/play), [/agents-live](https://three.ws/agents-live), [the x402 manifest](https://three.ws/.well-known/x402.json)+- **Code it documents:** [the avatar pipeline](#sec-113), [animation retargeting](#sec-093), [agent wallets](#sec-072), [autonomous x402](#sec-105)++## Published models++### three-ws/avatars++Rigged, animation-ready avatars from the platform, published as plain uncompressed glTF binaries under the MIT license so they load in any standard viewer without a Draco or Meshopt decoder.++> [Open the model repository](https://huggingface.co/three-ws/avatars)++The repository carries a sample rigged character, an avatar generated from a text prompt through the Forge TRELLIS lane, and a reference humanoid skeleton of the kind [`src/glb-canonicalize.js`](https://github.com/nirholas/three.ws/blob/main/src/glb-canonicalize.js) maps onto the canonical bone set before [`src/animation-retarget.js`](https://github.com/nirholas/three.ws/blob/main/src/animation-retarget.js) drives it. Hugging Face renders every file in its built-in 3D viewer, so the rigs are inspectable from the page.++Note that the files here are deliberately uncompressed. Everything three.ws serves in production is Meshopt or Draco compressed for load time; these copies trade bytes for the widest possible viewer compatibility.++## Published Spaces++### three.ws Avatar Viewer++> [Open the Space](https://huggingface.co/spaces/three-ws/avatar-viewer)++A running Space that loads the avatars above in an interactive 3D viewer, so a reader who arrives from the article can orbit a real rig without leaving Hugging Face or installing anything. The equivalent on our own domain is [the avatar inspector](#sec-112).++## Publishing checklist++Hugging Face community articles accept Markdown, so a draft in `docs/` is the article. To take one from draft to published:++1. **Write the draft as `docs/huggingface-<topic>.md`.** Every code sample must be real code from this repository, and every claim must be verifiable against it. This audience reads the linked source and will open the model files.+2. **Check the rules:** `npm run check:rules -- --paths docs/huggingface-<topic>.md`.+3. **Check the links:** `npm run audit:docs`.+4. **Publish** from [huggingface.co/new-blog](https://huggingface.co/new-blog) using the organization account, pasting the Markdown body.+5. **Record the canonical URL** by adding a section to this page: title, publish date, the live URL, the surfaces it covers, and the code it documents.+6. **Announce it** by adding an item to `data/rss/items.json` (the curated news feed) with the canonical Hugging Face URL as `link`, then regenerate with `npm run build:news`. The item becomes a page under `/news/<slug>` and enters the RSS feed automatically.+7. **Add the press card** to the "In the press" grid at the bottom of `blog/index.html`, so the article is reachable from [/blog](https://three.ws/blog).+8. **Log it** in `data/changelog.json` with the `docs` tag.++## Why we publish here++Hugging Face is where people go to check whether a model claim is real, and the check is cheap: open the repo, load the file, look at the rig. A marketing page says an avatar is animation-ready; a glTF with a named humanoid skeleton that plays a retargeted clip in the browser's own viewer proves it. Publishing the artifacts next to the article means a reader can verify the body problem is actually solved in the same sitting they read about it, then follow the same thread into [the wallet](#sec-072) and [the payments](#sec-105).++---++<a id="sec-245"></a>+> **Source:** `docs/i18n.md` · [↑ table of contents](#table-of-contents)# Internationalization (i18n)@@ -57432,7 +57545,7 @@ clearing silently-English values out of a shipped catalog.----<a id="sec-245"></a>+<a id="sec-246"></a>> **Source:** `docs/ibm-community-article.md` · [↑ table of contents](#table-of-contents)@@ -57552,7 +57665,7 @@ The platform repository is public at [github.com/nirholas/three.ws](https://gith----<a id="sec-246"></a>+<a id="sec-247"></a>> **Source:** `docs/ibm-community-blog-meetup-jessica.md` · [↑ table of contents](#table-of-contents)@@ -57613,7 +57726,7 @@ See you Friday at 8 AM Pacific. I will be the one asking the skeptical questions----<a id="sec-247"></a>+<a id="sec-248"></a>> **Source:** `docs/ibm-community-live-reaction-jessica.md` · [↑ table of contents](#table-of-contents)@@ -57624,7 +57737,7 @@ This is a discussion post for the [Three.ws User Group on IBMCommunity](https://community.ibm.com/community/user/usergroup?CommunityKey=e71510cc-d953-408f-9a1c-019f5c0a7016),not a polished announcement, just my honest reaction while the day is happening. My earlier post,[Join the Three.ws User Group's First In-World Meetup This-Friday](#sec-246), has the event details if you have not joined yet;+Friday](#sec-247), has the event details if you have not joined yet;the world is still open._I'm posting this in the middle of the day, not after, because I want the group to have my honest@@ -57665,7 +57778,7 @@ Full recap once the day wraps.follow-up, not a replacement for the original event post.- **Do not post an X/Twitter version of this.** This content is for the IBM Community group only;the group is the audience that gets the personal, honest register. The `@trythreews` and- `@nichxbt` X copy in [event-x-posts.md](#sec-527) is a separate, distinct campaign and+ `@nichxbt` X copy in [event-x-posts.md](#sec-529) is a separate, distinct campaign andstays in its organizer voice.- **Let Jessica edit freely.** This is a starting draft in her established voice (see the section"Why I think this format is worth your hour" in her earlier blog post), not a final script.@@ -57679,13 +57792,13 @@ Full recap once the day wraps.any mentions resolve correctly.- "Pilled" is her own word; keep it if it still feels true when she posts, or soften to "changed mymind about it" if she wants a more IBM-official register for her own profile.-- Once posted, add it to the catalog in [ibm-community.md](#sec-251) as a new discussion+- Once posted, add it to the catalog in [ibm-community.md](#sec-252) as a new discussionthread entry, following the same fields (author, posted date, activity, URL, summary) as theexisting entries, and note it links back to the pinned meetup thread.----<a id="sec-248"></a>+<a id="sec-249"></a>> **Source:** `docs/ibm-community-recap-jessica.md` · [↑ table of contents](#table-of-contents)@@ -57694,8 +57807,8 @@ Full recap once the day wraps._By Jessica Swanson, posted as a follow-up blog in the [Three.ws User Group on IBMCommunity](https://community.ibm.com/community/user/usergroup?CommunityKey=e71510cc-d953-408f-9a1c-019f5c0a7016),closing out the arc that started with [Join the Three.ws User Group's First In-World Meetup This-Friday](#sec-246) and continued mid-day with [LIVE at the Meetup: My-Honest Take So Far](#sec-247). Header image: reuse+Friday](#sec-247) and continued mid-day with [LIVE at the Meetup: My+Honest Take So Far](#sec-248). Header image: reuse[media/ibm-x-threews-lockup.png](media/ibm-x-threews-lockup.png), or swap in a real photo fromthe day once one is ready; do not paste this note into the published post._@@ -57824,14 +57937,14 @@ closest thing to having been there, and the world itself never closes.script; she should change anything that doesn't match how the day actually felt to her.- Confirm how Broke Boi and bigB actually go by on IBM Community today before posting, so anymentions or tags resolve correctly.-- Once posted, add it to the catalog in [ibm-community.md](#sec-251) as the group's next+- Once posted, add it to the catalog in [ibm-community.md](#sec-252) as the group's nextblog entry, following the same fields (author, published date, activity, URL, summary) as theexisting three entries, and cross-link it from the live-reaction catalog entry if that post waspublished too.----<a id="sec-249"></a>+<a id="sec-250"></a>> **Source:** `docs/ibm-community-recap-nichxbt.md` · [↑ table of contents](#table-of-contents)@@ -57840,7 +57953,7 @@ closest thing to having been there, and the world itself never closes._By nich (nich8), posted as a blog entry in the [Three.ws User Group on IBMCommunity](https://community.ibm.com/community/user/usergroup?CommunityKey=e71510cc-d953-408f-9a1c-019f5c0a7016),the team's own side of the meetup recap, alongside Jessica's [live-reaction](#sec-247) and [recap](#sec-248)+reaction](#sec-248) and [recap](#sec-249)on the same group. Two different people, two honest accounts of the same day; this one is mine,written the way I wrote the [Forge walkthrough](https://community.ibm.com/community/user/discussion/type-a-sentence-get-a-3d-model-a-hands-on-walkthrough-of-the-threews-forge-user-perspective)and the [10 features post](https://community.ibm.com/community/user/blogs/nich8/2026/07/16/threews-the-free-ai-3d-model-generators-10-best),@@ -57979,13 +58092,13 @@ than implying a date that does not exist yet.][ibm-user-group-first-in-world-meetup-recap.html](../blog/ibm-user-group-first-in-world-meetup-recap.html)is actually deployed, its link in this draft resolves live; until then it is a same-repo link thatworks once shipped, not before.-- Once posted, add it to the catalog in [ibm-community.md](#sec-251) as the group's next+- Once posted, add it to the catalog in [ibm-community.md](#sec-252) as the group's nextblog entry, following the same fields (author, published date, activity, URL, summary) as theexisting entries, and cross-link it against Jessica's recap entry.----<a id="sec-250"></a>+<a id="sec-251"></a>> **Source:** `docs/ibm-community-thread.md` · [↑ table of contents](#table-of-contents)@@ -58104,13 +58217,13 @@ _Questions, skepticism, and feature requests all welcome below. The skeptical on----<a id="sec-251"></a>+<a id="sec-252"></a>> **Source:** `docs/ibm-community.md` · [↑ table of contents](#table-of-contents)# IBM Community: Three.ws User Group post catalog-This is the running catalog of everything published in the [Three.ws User Group](https://community.ibm.com/community/user/groups/community-home?communitykey=e71510cc-d953-408f-9a1c-019f5c0a7016) on IBM Community: every discussion thread, every blog post, who wrote it, when, what it says, and what activity it got. It exists so the team can track the group's content without re-crawling the site. For what the group is, the framing rules that govern what gets posted there, and the wider IBM relationship, read [IBM watsonx & Granite](#sec-253) first.+This is the running catalog of everything published in the [Three.ws User Group](https://community.ibm.com/community/user/groups/community-home?communitykey=e71510cc-d953-408f-9a1c-019f5c0a7016) on IBM Community: every discussion thread, every blog post, who wrote it, when, what it says, and what activity it got. It exists so the team can track the group's content without re-crawling the site. For what the group is, the framing rules that govern what gets posted there, and the wider IBM relationship, read [IBM watsonx & Granite](#sec-254) first.Dates marked "approx." are derived from the site's relative timestamps ("17 days ago") on the snapshot date; blog dates come from their URLs and are exact.@@ -58156,7 +58269,7 @@ A feature tour structured as "ten features, in the order I would demo them": (1)- **Featured image:** the IBM x three.ws lockup ([media/ibm-x-threews-lockup.png](media/ibm-x-threews-lockup.png))- **URL:** [community.ibm.com/.../join-the-threews-user-groups-first-in-world-meetup](https://community.ibm.com/community/user/blogs/jessica-swanson/2026/08/04/join-the-threews-user-groups-first-in-world-meetup)-Jessica's companion piece to the meetup thread, written in her own voice as a member telling the group not to mistake the event for another webinar link. Carries the event table (Friday, August 7, 8 to 9 AM Pacific, 11 AM Eastern, free, browser only), the three-step join flow (open three.ws/play, bring a custom avatar made at three.ws/create beforehand, talk via spatial voice), and the agenda: live in-world platform tour, community demos, open Q&A ("the skeptical questions are the most useful ones"), and a first look at what is next. Her framing argument: the venue is the demo, so the hour doubles as hands-on evaluation of the technology the group exists to discuss, and since every world is a shareable URL, attending teaches you how to run your own events there. Points readers at the pinned meetup thread for the deep technical background and closes with the full platform link list. The draft lives in [ibm-community-blog-meetup-jessica.md](#sec-246).+Jessica's companion piece to the meetup thread, written in her own voice as a member telling the group not to mistake the event for another webinar link. Carries the event table (Friday, August 7, 8 to 9 AM Pacific, 11 AM Eastern, free, browser only), the three-step join flow (open three.ws/play, bring a custom avatar made at three.ws/create beforehand, talk via spatial voice), and the agenda: live in-world platform tour, community demos, open Q&A ("the skeptical questions are the most useful ones"), and a first look at what is next. Her framing argument: the venue is the demo, so the hour doubles as hands-on evaluation of the technology the group exists to discuss, and since every world is a shareable URL, attending teaches you how to run your own events there. Points readers at the pinned meetup thread for the deep technical background and closes with the full platform link list. The draft lives in [ibm-community-blog-meetup-jessica.md](#sec-247).### 4. The First Three.ws User Group Meetup: How It Actually Went@@ -58207,7 +58320,7 @@ Newest first, matching the digest viewer's order.- **Activity:** 1 reply (Jessica Swanson, whose profile lists Operational Decision Manager, AI & Data Science at IBM, 2026-08-05: links her blog post "Join the Three.ws User Group's First In-World Meetup")- **URL:** [community.ibm.com/.../community-meetup-inside-threews-join-us-on-the-three-server-at-threewsplay](https://community.ibm.com/community/user/discussion/community-meetup-inside-threews-join-us-on-the-three-server-at-threewsplay)-The announcement for the group's first community meetup: Friday, August 7, 2026, 8 to 9 AM Pacific (11 AM Eastern), held inside the platform itself in the $THREE home town at three.ws/play rather than on a video call. Free, browser-only, no download or account. Agenda: a live tour from inside the world, community demos, open Q&A, and a first look at what is next. Explains the three-step join flow (open /play, pick or bring an avatar, walk up and talk via spatial voice chat), then makes the venue case: every world is a URL, every pump.fun coin already has a world derived from its mint, and worlds persist, so any community can run its own meetup the same way. The back half is the long read: a surface-by-surface platform tour (creation, distribution, agent economy, developer platform including the two IBM-specific MCP servers), the technology stack (Three.js/Rapier frontend, GPU worker fleet on Cloud Run, authoritative Colyseus multiplayer at 15 Hz, Solana as home chain), the roadmap led by event infrastructure for /play, and a seven-point growth thesis explicitly framed as a thesis, not a promise. The draft lives in [ibm-community-thread.md](#sec-250).+The announcement for the group's first community meetup: Friday, August 7, 2026, 8 to 9 AM Pacific (11 AM Eastern), held inside the platform itself in the $THREE home town at three.ws/play rather than on a video call. Free, browser-only, no download or account. Agenda: a live tour from inside the world, community demos, open Q&A, and a first look at what is next. Explains the three-step join flow (open /play, pick or bring an avatar, walk up and talk via spatial voice chat), then makes the venue case: every world is a URL, every pump.fun coin already has a world derived from its mint, and worlds persist, so any community can run its own meetup the same way. The back half is the long read: a surface-by-surface platform tour (creation, distribution, agent economy, developer platform including the two IBM-specific MCP servers), the technology stack (Three.js/Rapier frontend, GPU worker fleet on Cloud Run, authoritative Colyseus multiplayer at 15 Hz, Solana as home chain), the roadmap led by event infrastructure for /play, and a seven-point growth thesis explicitly framed as a thesis, not a promise. The draft lives in [ibm-community-thread.md](#sec-251).### 2. Community Friday August 7,2026 - Inside three.ws: Join Us on the $THREE Server at three.ws/play@@ -58276,11 +58389,11 @@ A first-run walkthrough of the Forge from a user's perspective, no account, wall## Keeping this catalog current-When a new post lands in the group, add it here in digest order with the same fields (author, date, activity, URL, faithful summary) and refresh the snapshot table's date and counts. The sources of truth are the [digest viewer](https://community.ibm.com/community/user/groups/community-home/digestviewer?communitykey=e71510cc-d953-408f-9a1c-019f5c0a7016) for threads and the [recent blogs page](https://community.ibm.com/community/user/groups/community-home/recent-community-blogs?communitykey=e71510cc-d953-408f-9a1c-019f5c0a7016) for blogs. The posting cadence and topic rules for the group itself live in the [SEO keyword plan](ops/seo-keyword-plan.md) and in [ibm.md](#sec-253).+When a new post lands in the group, add it here in digest order with the same fields (author, date, activity, URL, faithful summary) and refresh the snapshot table's date and counts. The sources of truth are the [digest viewer](https://community.ibm.com/community/user/groups/community-home/digestviewer?communitykey=e71510cc-d953-408f-9a1c-019f5c0a7016) for threads and the [recent blogs page](https://community.ibm.com/community/user/groups/community-home/recent-community-blogs?communitykey=e71510cc-d953-408f-9a1c-019f5c0a7016) for blogs. The posting cadence and topic rules for the group itself live in the [SEO keyword plan](ops/seo-keyword-plan.md) and in [ibm.md](#sec-254).----<a id="sec-252"></a>+<a id="sec-253"></a>> **Source:** `docs/ibm-x402-mcp.md` · [↑ table of contents](#table-of-contents)@@ -58302,9 +58415,9 @@ bill itself, in USDC, over [x402](https://x402.org).This is the developer guide for the `@three-ws/ibm-x402-mcp` tool suite. For thebroader IBM integration (the platform showcase, Guardian Trust Layer, the-credentials-based `@three-ws/ibm-watsonx-mcp` connector) see **[docs/ibm.md](#sec-253)**.+credentials-based `@three-ws/ibm-watsonx-mcp` connector) see **[docs/ibm.md](#sec-254)**.For the x402 protocol primitives used elsewhere on the platform see-**[docs/x402.md](#sec-552)**.+**[docs/x402.md](#sec-554)**.---@@ -58622,7 +58735,7 @@ HTTP `status`), `internal_error` (unexpected).## Discovery (x402 Bazaar)Each tool declares an x402 discovery extension, so the suite is browsable in the-[x402 Bazaar](#sec-280) alongside its schema, example input, and+[x402 Bazaar](#sec-281) alongside its schema, example input, andexample output. Agents can find Granite tools by capability and price withoutknowing the server up front.@@ -58643,16 +58756,16 @@ Catalog/listing copy is maintained in## See also-- [docs/ibm.md](#sec-253) — the full IBM Granite / watsonx integration and showcase-- [docs/x402.md](#sec-552) — the x402 payment protocol on three.ws-- [docs/mcp.md](#sec-281) — wiring MCP servers into a client-- [docs/mcp-x402-bazaar.md](#sec-280) — x402 service discovery+- [docs/ibm.md](#sec-254) — the full IBM Granite / watsonx integration and showcase+- [docs/x402.md](#sec-554) — the x402 payment protocol on three.ws+- [docs/mcp.md](#sec-282) — wiring MCP servers into a client+- [docs/mcp-x402-bazaar.md](#sec-281) — x402 service discovery- [packages/ibm-x402-mcp](../packages/ibm-x402-mcp) — the npm package source- npm: [`@three-ws/ibm-x402-mcp`](https://www.npmjs.com/package/@three-ws/ibm-x402-mcp)----<a id="sec-253"></a>+<a id="sec-254"></a>> **Source:** `docs/ibm.md` · [↑ table of contents](#table-of-contents)@@ -58705,7 +58818,7 @@ three.ws runs a public user group on IBM Community for developers and engineers| Library | [Files and assets](https://community.ibm.com/community/user/groups/community-home/librarydocuments?communitykey=e71510cc-d953-408f-9a1c-019f5c0a7016&LibraryFolderKey=&DefaultView=) || Members | [Member list](https://community.ibm.com/community/user/groups/community-home/community-members?communitykey=e71510cc-d953-408f-9a1c-019f5c0a7016&Execute=1) |-Every thread and blog published in the group is cataloged, with authors, dates, activity, and a faithful per-post summary, in the [IBM Community post catalog](#sec-251). Update the catalog whenever a new post lands.+Every thread and blog published in the group is cataloged, with authors, dates, activity, and a faithful per-post summary, in the [IBM Community post catalog](#sec-252). Update the catalog whenever a new post lands.What belongs there, and what does not, is set by the [SEO keyword plan](ops/seo-keyword-plan.md): one post per week maximum, tutorials that stand on their own for an IBM developer who never clicks through, and no crypto-cluster content (that goes on [three.ws/blog](https://three.ws/blog) instead). The user group is also linked from the site's [Community page](https://three.ws/community) and the global footer.@@ -58953,7 +59066,7 @@ Source: [`packages/ibm-watsonx-mcp`](../packages/ibm-watsonx-mcp). Five tools:WATSONX_API_KEY=… WATSONX_PROJECT_ID=… npx @three-ws/ibm-watsonx-mcp```-It reads the same `WATSONX_*` environment variables documented above. See the [MCP guide](#sec-281) for wiring MCP servers into a client.+It reads the same `WATSONX_*` environment variables documented above. See the [MCP guide](#sec-282) for wiring MCP servers into a client.---@@ -59002,14 +59115,14 @@ Unit tests for the same paths live in [`tests/`](../tests) (`granite-oracle`, `a- [How it works](#sec-243) — the platform mental model- [Agent system](#sec-064) — the brain abstraction Granite plugs into-- [IBM Granite x402 MCP](#sec-252) — pay-per-call Granite for agents (USDC, no IBM account)-- [MCP](#sec-281) — wiring MCP servers into a client+- [IBM Granite x402 MCP](#sec-253) — pay-per-call Granite for agents (USDC, no IBM account)+- [MCP](#sec-282) — wiring MCP servers into a client- [REST API](#sec-096) — the full endpoint reference- [Configuration](#sec-154) — all environment variables----<a id="sec-254"></a>+<a id="sec-255"></a>> **Source:** `docs/image-to-3d.md` · [↑ table of contents](#table-of-contents)@@ -59111,7 +59224,7 @@ console.log(job.glb_url);----<a id="sec-255"></a>+<a id="sec-256"></a>> **Source:** `docs/in-game-economy.md` · [↑ table of contents](#table-of-contents)@@ -59240,7 +59353,7 @@ primitives.This is **not** the same rail as the USDC cosmetics shop for the standalonecharacter creator, which sells a different catalog through-[x402](#sec-552) and is surfaced publicly at [/fits](https://three.ws/fits).+[x402](#sec-554) and is surfaced publicly at [/fits](https://three.ws/fits).Two catalogs, two currencies, two rails. Do not confuse them.It is also not the only way to own a wardrobe item. A third tier exists that the@@ -59370,7 +59483,7 @@ every number in this system.## Next-- **[Earn and spend in /play](#sec-441)** walks the+- **[Earn and spend in /play](#sec-444)** walks thewhole loop end to end, from your first gathered log to a cosmetic unlock.- **[three.ws/play/economy](https://three.ws/play/economy)** is the live referencewith the current catalogs and odds.@@ -59379,7 +59492,7 @@ every number in this system.----<a id="sec-256"></a>+<a id="sec-257"></a>> **Source:** `docs/inference-node-operator.md` · [↑ table of contents](#table-of-contents)@@ -59653,7 +59766,7 @@ signature, and the artifact hash all check out.----<a id="sec-257"></a>+<a id="sec-258"></a>> **Source:** `docs/integrations.md` · [↑ table of contents](#table-of-contents)@@ -59673,7 +59786,7 @@ The platform's agents are only as useful as the places they can appear. Integratis the distribution layer: it turns an agent, a saved widget, or a live token feedinto something a marketer can paste into a CMS, a developer can wire into a framework,or an AI assistant can call as a tool. It is the front page of embedding; the deep-per-method references live in [Embedding](#sec-188) and [Widgets](#sec-517),+per-method references live in [Embedding](#sec-188) and [Widgets](#sec-520),and this doc is the map that points you to the right one.## How it works@@ -59699,7 +59812,7 @@ The catalog covers six integration types:driven by a `data-widget` id and the `pumpfun-feed` type.- **MCP Integration**: the `@three-ws/avatar-agent` server (from the`packages/avatar-agent-mcp` workspace), so Claude, Cursor, or any MCP-compatible- assistant can render, speak, gesture, and emote your agents. See [MCP](#sec-281).+ assistant can render, speak, gesture, and emote your agents. See [MCP](#sec-282).## Walkthrough@@ -59818,14 +59931,14 @@ for the full table.## Related- [Embedding Guide](#sec-188): the full per-method reference (web component, iframe, oEmbed)-- [Widget Types](#sec-517): every widget type and how to configure one+- [Widget Types](#sec-520): every widget type and how to configure one- [Embody](#sec-189): giving an agent a body in more contexts-- [MCP](#sec-281): the avatar MCP server for AI assistants+- [MCP](#sec-282): the avatar MCP server for AI assistants- Pages: [/integrations](https://three.ws/integrations), [/widgets](https://three.ws/widgets)----<a id="sec-258"></a>+<a id="sec-259"></a>> **Source:** `docs/introduction.md` · [↑ table of contents](#table-of-contents)@@ -60036,7 +60149,7 @@ To add an AI brain:The `key-proxy` attribute points to a serverless function that injects your API key — the key never touches the client. The `voice` attribute enables microphone input and TTS output.-For a full step-by-step walkthrough, see the [Quick Start guide](#sec-366).+For a full step-by-step walkthrough, see the [Quick Start guide](#sec-368).---@@ -60044,19 +60157,19 @@ For a full step-by-step walkthrough, see the [Quick Start guide](#sec-366).Once you have the basics working, the following guides go deeper:-- **[Quick Start](#sec-366)** — step-by-step from zero to a talking agent+- **[Quick Start](#sec-368)** — step-by-step from zero to a talking agent- **[Embedding Guide](#sec-188)** — all attributes, modes, events, and the JS API-- **[Widget Types](#sec-517)**, the five general-purpose widgets in depth (the other five live in [Widget Studio](https://three.ws/studio))+- **[Widget Types](#sec-520)**, the five general-purpose widgets in depth (the other five live in [Widget Studio](https://three.ws/studio))- **[Agent System Overview](#sec-064)** — runtime, skill registry, memory, emotion system- **[Manifest Reference](#sec-055)** — full JSON schema with examples-- **[REST API](#sec-096)** and **[JavaScript API](#sec-261)** — backend and in-browser surfaces+- **[REST API](#sec-096)** and **[JavaScript API](#sec-262)** — backend and in-browser surfaces- **[Agents vs. avatars](#sec-073)** — the difference, and when to careIf you want to look at what's already in the hosted platform — browsing agents, using Widget Studio, or registering on-chain — visit [https://three.ws](https://three.ws).----<a id="sec-259"></a>+<a id="sec-260"></a>> **Source:** `docs/irl.md` · [↑ table of contents](#table-of-contents)@@ -60179,7 +60292,7 @@ The rollup is served at `GET /api/irl/analytics` (admin-gated via `x-ops-secret`----<a id="sec-260"></a>+<a id="sec-261"></a>> **Source:** `docs/irl/THREAT-MODEL.md` · [↑ table of contents](#table-of-contents)@@ -60333,15 +60446,15 @@ in a way that drops legitimate discovery, update this file in the same change.----<a id="sec-261"></a>+<a id="sec-262"></a>> **Source:** `docs/js-api.md` · [↑ table of contents](#table-of-contents)# JavaScript API Reference-This page documents the internal JavaScript classes behind the three.ws viewer: the `App` controller, the Three.js `Viewer`, the glTF `Validator`, and the small components that render around them. It is aimed at developers reading or extending the source (`src/`), and at anyone driving the viewer from the browser console via `window.VIEWER`. If you just want a 3D agent on your page, use the [`<agent-3d>` element](#sec-514) instead.+This page documents the internal JavaScript classes behind the three.ws viewer: the `App` controller, the Three.js `Viewer`, the glTF `Validator`, and the small components that render around them. It is aimed at developers reading or extending the source (`src/`), and at anyone driving the viewer from the browser console via `window.VIEWER`. If you just want a 3D agent on your page, use the [`<agent-3d>` element](#sec-517) instead.-> For the HTTP/REST surface, see [api-reference.md](#sec-096). For the high-level npm SDK, see [sdk.md](#sec-379). For the `<agent-3d>` element attributes, see [web-component.md](#sec-514).+> For the HTTP/REST surface, see [api-reference.md](#sec-096). For the high-level npm SDK, see [sdk.md](#sec-381). For the `<agent-3d>` element attributes, see [web-component.md](#sec-517).---@@ -60967,7 +61080,7 @@ window.VIEWER.app.viewer.updateDisplay();----<a id="sec-262"></a>+<a id="sec-263"></a>> **Source:** `docs/kol-tracker.md` · [↑ table of contents](#table-of-contents)@@ -61103,8 +61216,8 @@ Writes the curated tracked-wallet list that the tracker merges in. Accepts `{ raThe tracker answers "who is making money"; the reputation surfaces answer "should this wallet's record earn trust". They meet at the wallet address:- **`GET /api/intel/wallet/<WALLET_ADDRESS>`** returns one wallet's realized track record from the Smart-Money graph: a 0 to 100 realized score, win rate, average ATH multiple, winners and losers, labels (`smart_money`, `sybil`, `fresh`, and others), and its funder cluster. `computed: false` means no track record exists yet for that address; that is an honest zero, not an error. A string that is not a base58 Solana address is a different case and returns `400 bad_request`, so a typo never reads as a wallet with no history. Any wallet you see on the tracker can be fed straight into it. The same card is served by `GET /api/intel/smart-money?wallet=<WALLET_ADDRESS>`, which applies the identical validation.-- **[Smart Money Radar](#sec-394)** is the sibling leaderboard built from graduation outcomes rather than a KOL universe: reputation earned per wallet from which coins actually graduated. The tracker's footer links to it, and the two boards frequently disagree in instructive ways.-- **[Trust primitives](#sec-423)** wrap the same question for autonomous agents: a paid endpoint that scores any counterparty wallet from real on-chain evidence before an agent transacts with it.+- **[Smart Money Radar](#sec-396)** is the sibling leaderboard built from graduation outcomes rather than a KOL universe: reputation earned per wallet from which coins actually graduated. The tracker's footer links to it, and the two boards frequently disagree in instructive ways.+- **[Trust primitives](#sec-426)** wrap the same question for autonomous agents: a paid endpoint that scores any counterparty wallet from real on-chain evidence before an agent transacts with it.```bash# Take a wallet from the tracker and pull its reputation record@@ -61122,13 +61235,13 @@ curl 'https://three.ws/api/intel/wallet/<WALLET_ADDRESS>?network=mainnet'## Related-- [Smart Money Radar](#sec-394): reputation earned from graduation outcomes, wallet by wallet-- [Trust primitives](#sec-423): the paid cross-chain reputation read for autonomous agents+- [Smart Money Radar](#sec-396): reputation earned from graduation outcomes, wallet by wallet+- [Trust primitives](#sec-426): the paid cross-chain reputation read for autonomous agents- Pages: [/tracker](https://three.ws/tracker) · [/smart-money](https://three.ws/smart-money) · [/leaderboard](https://three.ws/leaderboard)----<a id="sec-263"></a>+<a id="sec-264"></a>> **Source:** `docs/labor-market.md` · [↑ table of contents](#table-of-contents)@@ -61263,7 +61376,7 @@ economy move:----<a id="sec-264"></a>+<a id="sec-265"></a>> **Source:** `docs/launch-usecases.md` · [↑ table of contents](#table-of-contents)@@ -61399,7 +61512,7 @@ GET /api/pump/launch-studio?action=preview&id=github-fresh-breakouts&limit=6----<a id="sec-265"></a>+<a id="sec-266"></a>> **Source:** `docs/layers.md` · [↑ table of contents](#table-of-contents)@@ -61497,10 +61610,10 @@ Modules:- **`agent-identity.js`** — the passport + diary. Stable agent ID, owner address, signed action history. Backed by `localStorage` (cache) and `/api/agents/<id>` (canonical). Listens on the protocol bus and POSTs `speak` / `skill-done` / `validate` / `sign` events to `/api/agent-actions`.- **`memory/`** — `local`, `ipfs`, `encrypted-ipfs`, or `none`. Declared on the manifest.- **`erc8004/`** — on-chain registries. `IdentityRegistry` (mints agent token with `tokenURI`), `ReputationRegistry` (signed feedback), `ValidationRegistry` (validation report hashes). Per-chain addresses in `erc8004/abi.js`.-- **`erc8004/solana-deploy.js`**: Solana counterpart. Metaplex Core asset mint; SPL Memo attestations and reputation live server-side (see [Agent Reputation on Solana](#sec-398)).+- **`erc8004/solana-deploy.js`**: Solana counterpart. Metaplex Core asset mint; SPL Memo attestations and reputation live server-side (see [Agent Reputation on Solana](#sec-400)).- **`auth/` + `wallet/`** — SIWE / SIWS for backend mutations; Privy for email/social → embedded wallet onboarding; session cookies after wallet proof.-Per-chain registry addresses, ABIs, and helpers ship as `@three-ws/sdk`. ENS attestations are also handled here — see [register-onchain.md](#sec-468).+Per-chain registry addresses, ABIs, and helpers ship as `@three-ws/sdk`. ENS attestations are also handled here — see [register-onchain.md](#sec-471).---@@ -61513,7 +61626,7 @@ Per-chain registry addresses, ABIs, and helpers ship as `@three-ws/sdk`. ENS attModules:- **`element.js`**: `<agent-3d>` custom element. Lazy-boots via `IntersectionObserver` (unless `eager`). Enforces origin allowlist. Exposes attributes for `body`, `brain`, `agent-id`, `manifest`, `mode` (`inline` / `floating` / `section` / `fullscreen`), `voice`, and more. Public methods: `say()`, `ask()`, `installSkill()`, `expressEmotion()`, `play()`, `lookAt()`, `pause()`, `destroy()`.-- **`stage-element.js`**: `<agent-stage>` for hosting multiple agents in one shared scene. See [multi-agent.md](#sec-294).+- **`stage-element.js`**: `<agent-stage>` for hosting multiple agents in one shared scene. See [multi-agent.md](#sec-295).- **`widget-types.js`**: the ten widget variants: Turntable, Animation Gallery, Talking Agent, ERC-8004 Passport, Hotspot Tour, Pump.fun Live Feed, Smart Money Feed, Live Trades Canvas, Bonding Curve, Walking Avatar.- **`lib.js`** — the CDN entry. Imports the element, registers it, re-exports the public surface (`defineElement`, `Agent3DElement`, `AgentStageElement`, helpers).- **`embed-action-bridge.js`** — the `postMessage` protocol. Iframe widgets and the web component speak the same dialect, so host pages can drive either with the same code.@@ -61557,11 +61670,11 @@ Versioned CDN bundles are published at `/agent-3d/<version>/agent-3d.js`. Use `l- **[Architecture overview](#sec-100)** — module-by-module deep dive- **[Agent system](#sec-064)** — runtime, skills, memory in detail- **[Embedding](#sec-188)** — the public face of the embed layer-- **[SDK reference](#sec-379)** — `@three-ws/sdk` and friends+- **[SDK reference](#sec-381)** — `@three-ws/sdk` and friends----<a id="sec-266"></a>+<a id="sec-267"></a>> **Source:** `docs/likeness-eval.md` · [↑ table of contents](#table-of-contents)@@ -61801,7 +61914,7 @@ and reason only.## Related-- [Selfie to avatar](#sec-382): the capture flow being measured+- [Selfie to avatar](#sec-384): the capture flow being measured- [Avatar fidelity program](#sec-111): the tracks thismetric scores- [Realism quality bench](../data/quality-bench/README.md): the sibling harness@@ -61810,7 +61923,7 @@ and reason only.----<a id="sec-267"></a>+<a id="sec-268"></a>> **Source:** `docs/lipsync.md` · [↑ table of contents](#table-of-contents)@@ -61905,15 +62018,15 @@ tick();## Related-- [Voice Lab](#sec-512): clone a voice and synthesize it, the audio these demos animate.-- [Voice and lipsync tutorial](#sec-487): the full walkthrough, including wiring visemes to an agent body.-- [Talking Avatar Video](#sec-408): the server-rendered alternative for exporting a talking-head clip.+- [Voice Lab](#sec-515): clone a voice and synthesize it, the audio these demos animate.+- [Voice and lipsync tutorial](#sec-490): the full walkthrough, including wiring visemes to an agent body.+- [Talking Avatar Video](#sec-410): the server-rendered alternative for exporting a talking-head clip.- [Animations](#sec-093): the runtime clip registry that plays alongside lipsync.- Pages: [/lipsync](https://three.ws/lipsync), [/lipsync/mic](https://three.ws/lipsync/mic).----<a id="sec-268"></a>+<a id="sec-269"></a>> **Source:** `docs/liquid-glass.md` · [↑ table of contents](#table-of-contents)@@ -61928,7 +62041,7 @@ and the budget it has to stay inside.It sits under [Design tokens](#sec-004), which stays the source of truth for colour,type, radius, blur, and motion values. Nothing here introduces a value the token file does not-have. Interaction primitives come from [ui-juice](#sec-493).+have. Interaction primitives come from [ui-juice](#sec-496).## What the reference is@@ -62131,13 +62244,13 @@ This look is expensive and it is not allowed to cost us the product.## Related- [Design tokens](#sec-004), the values every rule above resolves to.-- [ui-juice](#sec-493), the shared interaction primitives (damping, reduced-motion contract).-- [Restyle Studio](#sec-373), which already ships a `realGlass` transmissive preset and the+- [ui-juice](#sec-496), the shared interaction primitives (damping, reduced-motion contract).+- [Restyle Studio](#sec-375), which already ships a `realGlass` transmissive preset and the`RoomEnvironment` lighting setup this document depends on.----<a id="sec-269"></a>+<a id="sec-270"></a>> **Source:** `docs/listings.md` · [↑ table of contents](#table-of-contents)@@ -62170,7 +62283,7 @@ Infrastructure programs that back three.ws with credits, tooling, and founder ne|---|---|---|| **Quicknode** Startup Program | Accepted (2026-07) | three.ws is accepted into the Quicknode Startup Program and approved for free infrastructure credits. Quicknode's globally distributed RPC endpoints (Solana first, plus the EVM chains x402 settles on) add capacity and redundancy behind agent wallets, settlement verification, and live market data. Announcement: [three.ws Joins the Quicknode Startup Program](/blog/three-ws-quicknode-startup-program). || **Google Cloud** for Web3 Startups | Member | Production runs on Google Cloud Run; the program backs compute and Vertex AI usage. Announcement: [three.ws Joins Google Cloud for Web3 Startups](/blog/three-ws-google-cloud-partnership). |-| **NVIDIA Inception** | Member (2026-07) | NVIDIA's program for startups building on accelerated computing. Every generation lane runs on NVIDIA: a self-hosted Cloud Run GPU fleet (L4 plus one RTX PRO 6000 Blackwell) behind text-to-3D, rigging, and motion, and a free hosted lane behind chat, vision, embeddings, safety, and speech. Surface: [/nvidia](/nvidia). Docs: [NVIDIA Inception](#sec-300), [NVIDIA models](#sec-301). Membership is a startup program, not a partnership, an investment, or an endorsement. |+| **NVIDIA Inception** | Member (2026-07) | NVIDIA's program for startups building on accelerated computing. Every generation lane runs on NVIDIA: a self-hosted Cloud Run GPU fleet (L4 plus one RTX PRO 6000 Blackwell) behind text-to-3D, rigging, and motion, and a free hosted lane behind chat, vision, embeddings, safety, and speech. Surface: [/nvidia](/nvidia). Docs: [NVIDIA Inception](#sec-301), [NVIDIA models](#sec-302). Membership is a startup program, not a partnership, an investment, or an endorsement. |---@@ -62182,7 +62295,7 @@ Ecosystem directories are the discovery surfaces that L1/L2 communities, chain f|---|---|---|| **BNB Chain · Dappbay** | Live | [dappbay.bnbchain.org/detail/three](https://dappbay.bnbchain.org/detail/three) — categories: *AI Agent Launchpad · AI Data · AI Infra*. Announcement: [three.ws Listed on BNB Chain's Dappbay Directory](/blog/three-ws-on-bnb-chain-dappbay.html). |-Dappbay is BNB Chain's official dApp directory. The listing is about distribution and discovery into BNB Chain's AI dApp audience — three.ws still settles agent payments on Solana, Base, and Polygon via the chain-agnostic [x402 protocol](#sec-552).+Dappbay is BNB Chain's official dApp directory. The listing is about distribution and discovery into BNB Chain's AI dApp audience — three.ws still settles agent payments on Solana, Base, and Polygon via the chain-agnostic [x402 protocol](#sec-554).---@@ -62192,9 +62305,9 @@ The discovery surfaces owned by the AI platforms themselves, where an MCP server| Directory | Status | Listing details ||---|---|---|-| **OpenAI** Plugin Directory (ChatGPT + Codex) | Open to submission | The universal directory shared by ChatGPT and Codex since 2026-07-09, superseding the former App directory. three.ws already meets the gating requirement: a public OAuth 2.1 MCP server at `https://three.ws/api/mcp` ([mcp.md](#sec-281)). Full submission kit, prerequisites, and rejection criteria: [openai-listing-channels.md](#sec-310). |-| **OpenAI** Showcase Gallery | Open to submission | Editorial feature on openai.com for apps, demos, and open-source projects built with OpenAI models, APIs, or Codex. Open web form, no repo gate. See [openai-listing-channels.md](#sec-310). |-| **OpenAI** Cookbook | Submitted, not merged | [PR #2874](https://github.com/openai/openai-cookbook/pull/2874) (a self-correcting 3D collectible pipeline using text-to-3D, function calling, and vision) has been open since 2026-07-21. Root-cause analysis and the revival steps are in [openai-listing-channels.md](#sec-310). |+| **OpenAI** Plugin Directory (ChatGPT + Codex) | Open to submission | The universal directory shared by ChatGPT and Codex since 2026-07-09, superseding the former App directory. three.ws already meets the gating requirement: a public OAuth 2.1 MCP server at `https://three.ws/api/mcp` ([mcp.md](#sec-282)). Full submission kit, prerequisites, and rejection criteria: [openai-listing-channels.md](#sec-311). |+| **OpenAI** Showcase Gallery | Open to submission | Editorial feature on openai.com for apps, demos, and open-source projects built with OpenAI models, APIs, or Codex. Open web form, no repo gate. See [openai-listing-channels.md](#sec-311). |+| **OpenAI** Cookbook | Submitted, not merged | [PR #2874](https://github.com/openai/openai-cookbook/pull/2874) (a self-correcting 3D collectible pipeline using text-to-3D, function calling, and vision) has been open since 2026-07-21. Root-cause analysis and the revival steps are in [openai-listing-channels.md](#sec-311). |---@@ -62207,6 +62320,34 @@ The discovery surfaces owned by the AI platforms themselves, where an MCP server| **Alibaba Cloud Marketplace Blog** | Live | [Editorial feature](https://marketplace.alibabacloud.com/doc/blog/detail/mplace-sgcmfw00036800.html) — Alibaba Cloud Marketplace published an editorial introducing three.ws. Announcement: [three.ws Featured on the Alibaba Cloud Marketplace Blog](/blog/three-ws-featured-on-alibaba-cloud-marketplace-blog) || **pump.fun** | Live | [Three Builds With Tech Giants](https://pump.fun/coin/FeMbDoX7R1Psc4GEcvJdsbNbZA3bfztcyDCatJVJpump/article): a feature article published on the official $THREE coin page, profiling the platform's browser-native 3D AI agents with onchain identities, the Animations and Poses Studio, the 3D Studio MCP server, and the AWS and IBM milestones. |+### pump.fun verification++$THREE is a verified project on pump.fun. Verification is pump.fun's own statement that the coin at `FeMbDoX7R1Psc4GEcvJdsbNbZA3bfztcyDCatJVJpump` belongs to three.ws, which is what separates the real token from the copies that share its name and ticker.++three.ws never hardcodes that claim. `GET /api/three-token/stats` reads pump.fun's public coin record on every (5-minute cached) request and returns the live flag on the token block:++```json+{+ "token": {+ "mint": "FeMbDoX7R1Psc4GEcvJdsbNbZA3bfztcyDCatJVJpump",+ "symbol": "$THREE",+ "verified": true,+ "verified_source": "pumpfun",+ "pump_url": "https://pump.fun/coin/FeMbDoX7R1Psc4GEcvJdsbNbZA3bfztcyDCatJVJpump"+ }+}+```++`verified` has three states, and callers should treat them differently:++| Value | Meaning | What the UI does |+|---|---|---|+| `true` | pump.fun publishes the badge right now | Render the badge |+| `false` | pump.fun publishes no badge | Render nothing |+| `null` | pump.fun could not be reached this request | Render nothing |++The badge itself is one shared component ([src/pump/verified-badge.js](../src/pump/verified-badge.js)), so the public [/three-token](/three-token) page and the [/dashboard/three-token](/dashboard/three-token) holder view can never disagree about whether the coin is verified. If pump.fun ever withdraws verification, the badge disappears on the next stats read with no deploy.+HackerNoon is one of the world's largest independent tech publications, read by millions of developers and founders monthly. Every three.ws announcement is pulled automatically from [`three.ws/rss/announcements.xml`](https://three.ws/rss/announcements.xml) into the HackerNoon drafts queue, then published with canonical URLs pointing back to three.ws. See [syndication setup](/docs/syndication#hackernoon) for technical details.---@@ -62242,7 +62383,7 @@ Subscribe via RSS to track new listings, integrations, and protocol updates.----<a id="sec-270"></a>+<a id="sec-271"></a>> **Source:** `docs/live-docs.md` · [↑ table of contents](#table-of-contents)@@ -62262,7 +62403,7 @@ Press **Edit**, change something, and press <kbd>⌘</kbd>/<kbd>Ctrl</kbd> +## Try it: a live avatar-This is the same embed snippet from the [`<agent-3d>` reference](#sec-514).+This is the same embed snippet from the [`<agent-3d>` reference](#sec-517).Press **Run preview** and it renders. Then press **Edit**, swap `michelle.glb`for `xbot.glb`, and run it again.@@ -62424,14 +62565,14 @@ cached module.## Related-- [`<agent-3d>` Web Component API Reference](#sec-514) — the element most previews render+- [`<agent-3d>` Web Component API Reference](#sec-517) — the element most previews render- [API reference](#sec-096) — the endpoints most `curl` samples call- [Embed and share](#sec-188) — putting an avatar on your own site-- [MCP tool safety](#sec-277) — the same read/write/irreversible split, applied to agent tools+- [MCP tool safety](#sec-278) — the same read/write/irreversible split, applied to agent tools----<a id="sec-271"></a>+<a id="sec-272"></a>> **Source:** `docs/live-steps.md` · [↑ table of contents](#table-of-contents)@@ -62614,7 +62755,7 @@ Run `npx vitest run tests/live-steps.test.js` after editing the registry; the su----<a id="sec-272"></a>+<a id="sec-273"></a>> **Source:** `docs/make-your-agent.md` · [↑ table of contents](#table-of-contents)@@ -62681,7 +62822,7 @@ Once you hit **Publish**, your agent gets a live URL: something like `three.ws/aThe wizard also gives you an **embed snippet**: a few lines of HTML you can paste into any webpage to make the agent appear there. You don't need to know HTML to do this — just copy and paste.-For more on where and how to embed, continue to [Share & embed →](#sec-383)+For more on where and how to embed, continue to [Share & embed →](#sec-385)---@@ -62700,14 +62841,14 @@ Changes take effect immediately — no republishing needed for most settings.## What's next-- **Put it on your website** → [Share & embed](#sec-383)+- **Put it on your website** → [Share & embed](#sec-385)- **Understand how it all works** → [How it works](#sec-243)-- **Give the agent a custom skill** → [Create a custom skill](#sec-438)-- **Make it yours permanently (on-chain)** → [Register on-chain](#sec-468)+- **Give the agent a custom skill** → [Create a custom skill](#sec-441)+- **Make it yours permanently (on-chain)** → [Register on-chain](#sec-471)----<a id="sec-273"></a>+<a id="sec-274"></a>> **Source:** `docs/market-data-api.md` · [↑ table of contents](#table-of-contents)@@ -62832,7 +62973,7 @@ as the single retryable class.----<a id="sec-274"></a>+<a id="sec-275"></a>> **Source:** `docs/marketplace.md` · [↑ table of contents](#table-of-contents)@@ -62957,7 +63098,7 @@ direct-transfer QR for wallets that do not implement transaction requests.and applied at settlement.- Seller proceeds route to the seller's configured payout wallet(`agent_payout_wallets`). A confirmed sale surfaces to the seller as a `sale` /- `payment-earned` notification (see [Money feed](#sec-289)).+ `payment-earned` notification (see [Money feed](#sec-290)).## Access checks@@ -63007,7 +63148,7 @@ sales and zero exhausted trials before it was found. Seeendpoints are complete, but there is not yet a free, paginated "browse allskills for sale" HTTP endpoint with sort/filter; discovery today is per-agent(agents themselves are browsable at `GET /api/marketplace/agents`), and the- paid [`/api/x402/skill-marketplace`](#sec-547) endpoint returns the+ paid [`/api/x402/skill-marketplace`](#sec-549) endpoint returns thelive skill listing catalog with pricing for $0.001 USDC.- **Auto-grant.** A confirmed skill purchase is recorded and the license NFT isminted, but the purchased skill is not automatically attached to the buyer's@@ -63027,11 +63168,11 @@ their chosen `currency_mint`; the platform promotes no coin other than $THREE.- [Agent wallets](#sec-072) — how agent-side purchases are funded and gated.- [Circulation engine](#sec-141) — manufactured marketplace demand.-- [Skills system](#sec-392), [Coin launches](#sec-144).+- [Skills system](#sec-394), [Coin launches](#sec-144).----<a id="sec-275"></a>+<a id="sec-276"></a>> **Source:** `docs/mcp-3d-studio.md` · [↑ table of contents](#table-of-contents)@@ -63103,7 +63244,7 @@ analyze: inspect_model · optimize_model preview: preview_3d| `inspect_model(url)` | Structural stats: meshes, triangles, materials, textures, animations, extensions. || `optimize_model(url)` | Actionable size/perf suggestions: Draco/Meshopt, KTX2, triangle budget. || `preview_3d(glb_url, …)` | Render any public GLB as an interactive `<model-viewer>` artifact (orbit, AR, auto-rotate). |-| `export_ar(glb_url, title?, kind?)` | Read-only: turn any public GLB into the device-aware AR link set (`arLaunchUrl`, `sceneViewerUrl`, `viewerUrl`, plus `irlUrl` when `kind: "avatar"`) and a [Spatial MCP](#sec-400) artifact. Free. See [AR & WebXR](ar.md#one-tap-ar-for-any-glb--get-apiar--export_ar). |+| `export_ar(glb_url, title?, kind?)` | Read-only: turn any public GLB into the device-aware AR link set (`arLaunchUrl`, `sceneViewerUrl`, `viewerUrl`, plus `irlUrl` when `kind: "avatar"`) and a [Spatial MCP](#sec-402) artifact. Free. See [AR & WebXR](ar.md#one-tap-ar-for-any-glb--get-apiar--export_ar). |Generation, rigging, and most mesh ops are **asynchronous**: the tool returns a`job_id` immediately, then you poll `generation_status` (reconstruction is@@ -63272,7 +63413,7 @@ npx @modelcontextprotocol/inspector http://localhost:3000/api/mcp-3d----<a id="sec-276"></a>+<a id="sec-277"></a>> **Source:** `docs/mcp-agent.md` · [↑ table of contents](#table-of-contents)@@ -63379,13 +63520,13 @@ npx @modelcontextprotocol/inspector http://localhost:3000/api/mcp-agent----<a id="sec-277"></a>+<a id="sec-278"></a>> **Source:** `docs/mcp-safety.md` · [↑ table of contents](#table-of-contents)# MCP tool safety-Every tool three.ws publishes over the [Model Context Protocol](#sec-281) carries an+Every tool three.ws publishes over the [Model Context Protocol](#sec-282) carries an`annotations` block. Those hints are not decoration: an MCP client reads them todecide whether a tool can run **without stopping to ask the user**. A tool markedread-only gets executed silently; a tool marked destructive gets a confirmation@@ -63714,7 +63855,7 @@ All four run in `npm run gate`.----<a id="sec-278"></a>+<a id="sec-279"></a>> **Source:** `docs/mcp-studio.md` · [↑ table of contents](#table-of-contents)@@ -63827,7 +63968,7 @@ tool call at any tier; see [Pending generations](#pending-generations-check_job)for how it is collected rather than lost.One naming collision worth knowing: the npm package `@three-ws/mcp-server`-([docs](#sec-281)) also ships a tool called `forge_free`. That is a different+([docs](#sec-282)) also ships a tool called `forge_free`. That is a differentserver with its own default (`draft`, stated in its own tool schema). Thedefault described here is the one for `https://three.ws/api/mcp-studio`.@@ -63855,7 +63996,7 @@ and the result narration links it for non-widget clients.`arUrl` is the one-tap place-in-your-room link (see [AR in ChatGPT](#sec-139)).Rigged avatars additionally carry `irlUrl`, the living-agent handoff into-[IRL](#sec-259), and the inline widget's AR button becomes **Bring it to life**.+[IRL](#sec-260), and the inline widget's AR button becomes **Bring it to life**.Every result also includes a `spatial` field, the open Spatial MCP artifact(`specs/SPATIAL_MCP.md`) so any Spatial-MCP renderer can display the model.@@ -64076,15 +64217,15 @@ CSP entry cannot drift apart.----<a id="sec-279"></a>+<a id="sec-280"></a>> **Source:** `docs/mcp-tools.md` · [↑ table of contents](#table-of-contents)# MCP Tools Catalog-three.ws ships several [MCP](#sec-281) servers: tool servers that AI assistants+three.ws ships several [MCP](#sec-282) servers: tool servers that AI assistants(Claude, ChatGPT, any MCP client) can call directly. One is free and 3D-only; the-others expose paid tools that settle per call in USDC over [x402](#sec-552). This+others expose paid tools that settle per call in USDC over [x402](#sec-554). Thispage explains how the servers are grouped and how the paid ones charge.> **Looking for a specific tool?** The complete, always-current list lives at@@ -64123,7 +64264,7 @@ the read-only studio helpers below.A free, non-crypto MCP server for the ChatGPT App Directory and any MCP client. Itexposes **only** 3D generation/inspection — no account, no payment, no token. See-[3D Studio MCP](#sec-278).+[3D Studio MCP](#sec-279).## Material Studio (hosted, free) — `/api/material-studio`@@ -64166,7 +64307,7 @@ and direction tools are flat per call.Free studio helpers (no charge): `getting_started`, `generation_status`,`preview_3d`, `list_animations`, `inspect_model`, `optimize_model`, `save_avatar`,-`validate_spatial_response` (the [Spatial MCP](#sec-400) conformance gate).+`validate_spatial_response` (the [Spatial MCP](#sec-402) conformance gate).## Agent & commerce tools — `3d-agent-local`@@ -64209,9 +64350,9 @@ generation lane**; the rest are paid and quote their price in the| Server | File | Surface ||---|---|---|| Agent MCP | `api/mcp-agent.js` | Agent build/control tools. |-| Bazaar MCP | `api/mcp-bazaar.js` | x402 service discovery — see [x402 bazaar](#sec-280). |-| IBM MCP | `api/ibm-mcp.js` | watsonx / Granite integration — see [IBM](#sec-253). |-| pump.fun MCP | `api/pump-fun-mcp.js` | Launch/trade tools — see [Solana pump.fun](#sec-397). |+| Bazaar MCP | `api/mcp-bazaar.js` | x402 service discovery — see [x402 bazaar](#sec-281). |+| IBM MCP | `api/ibm-mcp.js` | watsonx / Granite integration — see [IBM](#sec-254). |+| pump.fun MCP | `api/pump-fun-mcp.js` | Launch/trade tools — see [Solana pump.fun](#sec-399). |## $THREE only@@ -64222,16 +64363,16 @@ promote no specific token.## Related-- [MCP](#sec-281) overview · [3D Studio MCP](#sec-278) ·- [3D Studio (paid)](#sec-275) · [x402 bazaar](#sec-280)-- [x402 paid endpoints](#sec-547) — the same capabilities over REST.-- [MCP tool safety](#sec-277) - what each tool's safety annotations mean,+- [MCP](#sec-282) overview · [3D Studio MCP](#sec-279) ·+ [3D Studio (paid)](#sec-276) · [x402 bazaar](#sec-281)+- [x402 paid endpoints](#sec-549) — the same capabilities over REST.+- [MCP tool safety](#sec-278) - what each tool's safety annotations mean,and the build check that verifies them against the code.- [The full catalog](/mcp-tools) - every tool, searchable by safety and price.----<a id="sec-280"></a>+<a id="sec-281"></a>> **Source:** `docs/mcp-x402-bazaar.md` · [↑ table of contents](#table-of-contents)@@ -64343,7 +64484,7 @@ npx @modelcontextprotocol/inspector http://localhost:3000/api/mcp-bazaar----<a id="sec-281"></a>+<a id="sec-282"></a>> **Source:** `docs/mcp.md` · [↑ table of contents](#table-of-contents)@@ -64493,8 +64634,8 @@ Ready-to-submit listing packages for each directory, plus the canonical metadataDeep dives — every tool, argument, env var, and example:-- **Hosted remote:** [3D Studio (free)](#sec-278) · [3D Studio (paid)](#sec-275) · [Agent wallet](#sec-276) · [x402 Bazaar](#sec-280) · [IBM x402](#sec-252)-- **Install-and-run:** each npm server ships its usage guide (tools, arguments, env vars, examples) in its package README on [npmjs.com/org/three-ws](https://www.npmjs.com/org/three-ws). The [MCP Tools Catalog](#sec-279) maps every tool to its server and price.+- **Hosted remote:** [3D Studio (free)](#sec-279) · [3D Studio (paid)](#sec-276) · [Agent wallet](#sec-277) · [x402 Bazaar](#sec-281) · [IBM x402](#sec-253)+- **Install-and-run:** each npm server ships its usage guide (tools, arguments, env vars, examples) in its package README on [npmjs.com/org/three-ws](https://www.npmjs.com/org/three-ws). The [MCP Tools Catalog](#sec-280) maps every tool to its server and price.---@@ -64882,7 +65023,7 @@ Turn an avatar or on-chain agent **you own** into a holder-only interactive 3D e}```-The `structuredContent` returns `gate_id`, `asset_id`, `gate` (`mint`, `min_amount`, `chain`), and `embed_snippet` — a ready-to-paste `<script>` + `<three-d>` tag. See [Token-gated 3D embeds](#sec-412) for the full verification flow, the anti-abuse token/rate-limit design, and how visitors unlock the embed.+The `structuredContent` returns `gate_id`, `asset_id`, `gate` (`mint`, `min_amount`, `chain`), and `embed_snippet` — a ready-to-paste `<script>` + `<three-d>` tag. See [Token-gated 3D embeds](#sec-415) for the full verification flow, the anti-abuse token/rate-limit design, and how visitors unlock the embed.---@@ -64903,7 +65044,7 @@ Call any endpoint in the free [Crypto Data API](#sec-096) (the same aggregator b}```-An unknown `provider`/`endpoint` pair returns an error result listing every valid pair. A registered endpoint marked free runs within the same per-IP quota the REST free lane enforces — no wallet needed. An endpoint with no free tier, or a free quota you've exhausted, returns a JSON-RPC `-32402` error naming the exact REST URL and USDC price to pay via [x402](#sec-552) — never a second, MCP-only payment flow.+An unknown `provider`/`endpoint` pair returns an error result listing every valid pair. A registered endpoint marked free runs within the same per-IP quota the REST free lane enforces — no wallet needed. An endpoint with no free tier, or a free quota you've exhausted, returns a JSON-RPC `-32402` error naming the exact REST URL and USDC price to pay via [x402](#sec-554) — never a second, MCP-only payment flow.```bash# Equivalent to: GET /api/v1/x/dexscreener/token?addresses=FeMbDoX7R1Psc4GEcvJdsbNbZA3bfztcyDCatJVJpump@@ -65171,7 +65312,7 @@ Contributors: `npm run audit:mcp-safety` enforces this. It parses each tool's ha----<a id="sec-282"></a>+<a id="sec-283"></a>> **Source:** `docs/media-api.md` · [↑ table of contents](#table-of-contents)@@ -65709,7 +65850,7 @@ staged as web-ready GLBs. Same pagination (`?limit=1..1000`, `?offset=`),same empty-until-staged behavior, no auth. One difference from the characterlibrary: this endpoint validates the cursors strictly, so a malformed`?limit`/`?offset` returns `400 invalid_limit` / `400 invalid_offset` instead-of being coerced into a page. See [the object library doc](#sec-305)+of being coerced into a page. See [the object library doc](#sec-306)for the full parameter table.### Response@@ -66061,13 +66202,13 @@ curl -s 'https://three.ws/api/forge-rembg?job=JOB_ID'## Related- [3D API](#sec-001) - the core free text-to-3D lane, model inspection, and the paid Forge Pro tiers-- [Image to 3D](#sec-254) - the photo-input reconstruction product these front doors feed-- [Voice Lab](#sec-512) - voice cloning and synthesis, the other half of the avatar voice loop+- [Image to 3D](#sec-255) - the photo-input reconstruction product these front doors feed+- [Voice Lab](#sec-515) - voice cloning and synthesis, the other half of the avatar voice loop- [API Reference](#sec-096) - the full three.ws HTTP API surface----<a id="sec-283"></a>+<a id="sec-284"></a>> **Source:** `docs/memetic-launcher.md` · [↑ table of contents](#table-of-contents)@@ -66172,12 +66313,12 @@ A POST with no body at all is valid and reads back as an empty patch, so## Related surfaces- [/launches](https://three.ws/launches) — every coin launched through three.ws, including yours.-- [docs/pump-launcher.md](#sec-344) — the x402 paid one-shot launcher (`/api/x402/pump-launch`), a different surface: one coin per paid call, platform-fronted.+- [docs/pump-launcher.md](#sec-346) — the x402 paid one-shot launcher (`/api/x402/pump-launch`), a different surface: one coin per paid call, platform-fronted.- `api/_lib/launcher-engine.js` — the shared engine both scopes run on (cron: `/api/cron/launcher-tick`).----<a id="sec-284"></a>+<a id="sec-285"></a>> **Source:** `docs/memory.md` · [↑ table of contents](#table-of-contents)@@ -66589,7 +66730,7 @@ store described above and each revocable by deleting exactly what it wrote:----<a id="sec-285"></a>+<a id="sec-286"></a>> **Source:** `docs/meta-allocator.md` · [↑ table of contents](#table-of-contents)@@ -66683,14 +66824,14 @@ plan `source` is `"empty"` with a helpful message instead of an error.## Related-- [Trader Card & the claim-your-wallet wedge](#sec-414)-- [The trading surfaces](#sec-420) · [/vaults](https://three.ws/vaults) (copy-trade with custody guardrails)+- [Trader Card & the claim-your-wallet wedge](#sec-417)+- [The trading surfaces](#sec-423) · [/vaults](https://three.ws/vaults) (copy-trade with custody guardrails)- [Clip Director: every trade becomes content](#sec-143)- [Financial controls & custody guardrails](#sec-223)----<a id="sec-286"></a>+<a id="sec-287"></a>> **Source:** `docs/mint-mark.md` · [↑ table of contents](#table-of-contents)@@ -66816,13 +66957,13 @@ No other mint should appear in tests, fixtures, or documentation.## Related-- [Solana agents](#sec-399) — agent wallet management and on-chain interactions-- [Solana pump.fun signals](#sec-397) — pump.fun live feed integration+- [Solana agents](#sec-401) — agent wallet management and on-chain interactions+- [Solana pump.fun signals](#sec-399) — pump.fun live feed integration- [ERC-8004](#sec-190) — on-chain agent registry (uses the same brand metadata builder)----<a id="sec-287"></a>+<a id="sec-288"></a>> **Source:** `docs/minted.md` · [↑ table of contents](#table-of-contents)@@ -66830,7 +66971,7 @@ No other mint should appear in tests, fixtures, or documentation.[three.ws/minted](https://three.ws/minted) is the live, public gallery of every generated or owned avatar that a creator chose to mint as a **Metaplex Core NFT** through three.ws. It is the NFT counterpart of the `/launches` coin directory: real on-chain property, listed the moment it mints. Every card renders the actual model in a live, auto-rotating 3D viewer (not a flat thumbnail), and every asset carries baked provenance and an enforced, capped creator royalty. Minting is always opt-in: the free text-to-3D lane never mints anything on its own.-This doc covers the gallery surface and the mint flow as a user-facing feature. The provenance internals live in their own docs: [content credentials for AI-generated models](#sec-340) (signed credentials, Solana anchoring, the free verify endpoint) and [the three.ws mint mark](#sec-286) (the `3ws` address branding on coin launches).+This doc covers the gallery surface and the mint flow as a user-facing feature. The provenance internals live in their own docs: [content credentials for AI-generated models](#sec-342) (signed credentials, Solana anchoring, the free verify endpoint) and [the three.ws mint mark](#sec-287) (the `3ws` address branding on coin launches).## The gallery@@ -66862,7 +67003,7 @@ curl "https://three.ws/api/v1/tokenized/launches?network=mainnet&offset=0&limit=## How a mint works-Minting runs through the `mint_3d_asset` tool on the [3D Studio MCP server](#sec-281). It is priced per call via x402 (USDC); an OAuth bearer token bypasses payment. A creator supplies:+Minting runs through the `mint_3d_asset` tool on the [3D Studio MCP server](#sec-282). It is priced per call via x402 (USDC); an OAuth bearer token bypasses payment. A creator supplies:- **The model:** an owned `avatar_id`, or any absolute `glb_url`.- **The recipient:** an explicit `owner_wallet` (base58), or the OAuth-linked Solana wallet by default.@@ -66885,7 +67026,7 @@ Every mint carries its provenance twice:- **In the NFT metadata itself:** creator, prompt, generation model and provider, parent lineage, and timestamp travel with the asset wherever it goes.- **As a signed record on the platform's append-only agent-actions ledger** (when the source avatar has a provisioned agent to sign as): an independently verifiable entry, referenced in the mint response and queryable via the MCP action tools. This write is best-effort and never blocks a mint that already succeeded on-chain.-For how signed credentials, canonical hashing, and on-chain anchoring work under the hood, read [provenance.md](#sec-340). For the `3ws` address mark that brands coin launches, read [mint-mark.md](#sec-286).+For how signed credentials, canonical hashing, and on-chain anchoring work under the hood, read [provenance.md](#sec-342). For the `3ws` address mark that brands coin launches, read [mint-mark.md](#sec-287).### Remix royalties: paid the moment a remix mints@@ -66899,14 +67040,14 @@ The companion MCP tool `get_3d_asset_onchain` resolves any Core mint address to## Related-- [Verifiable 3D provenance](#sec-340): signed content credentials and free verification for generated models-- [The three.ws mint mark](#sec-286): the `3ws` address brand on coin launches-- [MCP servers](#sec-281): the `mint_3d_asset` and `get_3d_asset_onchain` tools+- [Verifiable 3D provenance](#sec-342): signed content credentials and free verification for generated models+- [The three.ws mint mark](#sec-287): the `3ws` address brand on coin launches+- [MCP servers](#sec-282): the `mint_3d_asset` and `get_3d_asset_onchain` tools- [Custody you can verify](#sec-172): the wallet rails behind agent-held assets----<a id="sec-288"></a>+<a id="sec-289"></a>> **Source:** `docs/mocap-studio.md` · [↑ table of contents](#table-of-contents)@@ -67005,7 +67146,7 @@ what the page itself sends.----<a id="sec-289"></a>+<a id="sec-290"></a>> **Source:** `docs/money-feed.md` · [↑ table of contents](#table-of-contents)@@ -67019,7 +67160,7 @@ event lives.> Not to be confused with the **personal activity feed** on `/feed`> (`GET /api/users/me/feed`) — that one shows who created what and who followed-> whom, and is documented in [The social layer](#sec-396). This page is+> whom, and is documented in [The social layer](#sec-398). This page is> about value movement only. The two share a URL word ("feed") and nothing else.---@@ -67096,7 +67237,7 @@ spend-cap and policy engine before they are recorded (see| Producer | Ledger? | Ticker? | Domain record ||---|---|---|---|| [Circulation engine](#sec-141) tips/payments/trades/buys | Yes | Trades/launches via pump feed | `circulation_actions` + domain table |-| [Marketplace](#sec-274) skill/asset purchase | Yes | `payment` / `sale` | `skill_purchases` / `asset_purchases` |+| [Marketplace](#sec-275) skill/asset purchase | Yes | `payment` / `sale` | `skill_purchases` / `asset_purchases` || [Coin launches](#sec-144) | Yes | `coin-buy` / `agent-deploy` | `pump_agent_mints` || Sniper trades | Yes (`category: 'snipe'`) | — | `agent_sniper_positions` || [Autonomous x402 loop](#sec-105) | Yes (`category: 'x402'`) | — | `x402_autonomous_log` |@@ -67136,11 +67277,11 @@ The same bus powers surfaces that are not tickers at all:- [Circulation engine](#sec-141) — the largest producer of activity.- [Autonomous x402 loop](#sec-105) — treasury-paid intel purchases.- [Agent wallets](#sec-072) — how spends are gated before they're recorded.-- [x402 revenue & receipts](#sec-548) — the *other* direction: money paid **to** our endpoints (`x402_audit_log`), not agent spend.+- [x402 revenue & receipts](#sec-550) — the *other* direction: money paid **to** our endpoints (`x402_audit_log`), not agent spend.----<a id="sec-290"></a>+<a id="sec-291"></a>> **Source:** `docs/money-flow-map.md` · [↑ table of contents](#table-of-contents)@@ -67379,14 +67520,14 @@ covering it there. Keep the ordering discipline in `classifyRole`: a rule goes## Related-- [Money Pulse](#sec-289): the event stream these edges are aggregated from.+- [Money Pulse](#sec-290): the event stream these edges are aggregated from.- [Circulation engine](#sec-141): what generates most of thisactivity.- [Agent economy volume](#sec-052): the per-agent totals, ranked.----<a id="sec-291"></a>+<a id="sec-292"></a>> **Source:** `docs/money-map.md` · [↑ table of contents](#table-of-contents)@@ -67397,8 +67538,8 @@ wallet receives each kind of payment, what share the platform keeps, and whichtreasury pays it forward. If you're adding a paid surface or auditing revenue,start here.-Companion docs: [x402 endpoints](#sec-547) (the paid endpoint catalog),-[x402 revenue & receipts](#sec-548) (how settlements are recorded),+Companion docs: [x402 endpoints](#sec-549) (the paid endpoint catalog),+[x402 revenue & receipts](#sec-550) (how settlements are recorded),[Solana signers runbook](../api/_lib/solana-signers.js) (thesigner/funder wallets and how to fund them).@@ -67498,7 +67639,7 @@ unit economics.[ring catalog](../api/_lib/x402/ring-catalog.js), the single source of truth)across intel/oracle, agent/reputation, generation/3D, launch/naming/utility,club, avatar shop, and bazaars. Full list and prices:- [x402 endpoints](#sec-547).+ [x402 endpoints](#sec-549).- **Paid MCP tools** —- Main MCP ([api/mcp.js](../api/mcp.js), pricing `api/_lib/pump-pricing.js`):`mint_3d_asset` $0.25, `retexture_model` $0.10, `optimize_model` $0.05,@@ -67518,9 +67659,9 @@ unit economics.in the on-chain ASP record, not in repo code** — update it here if the ASPregistration changes.- **Marketplace skills** — agent skill marketplace over Solana Pay- ([api/marketplace/](../api/marketplace)); see [marketplace skills](#sec-500).+ ([api/marketplace/](../api/marketplace)); see [marketplace skills](#sec-503).- **Labor market** — bounty/escrow jobs with worker + author-royalty settlement; see- [labor market](#sec-263).+ [labor market](#sec-264).- **Other** — vanity bounties, forge REST ([api/x402/forge.js](../api/x402/forge.js)),subscriptions, credit deposits.@@ -67571,18 +67712,18 @@ that set `auto_fund_enabled = true` (default off). See## Related- [Financial controls & audit register](#sec-223) — every ledger's integrity, reconciliation, retention, monitoring, and the ranked gap list.-- [x402 endpoints](#sec-547) — the paid endpoint catalog and price overrides.-- [x402 revenue & receipts](#sec-548) — where settlements are recorded.-- [x402 ring economy](#sec-549) — the internal recirculation loop.-- [Pump platform fee](#sec-345) — the pump trade fee detail.-- [Coin-launch wallets](#sec-502) — launch-time wallet flow.+- [x402 endpoints](#sec-549) — the paid endpoint catalog and price overrides.+- [x402 revenue & receipts](#sec-550) — where settlements are recorded.+- [x402 ring economy](#sec-551) — the internal recirculation loop.+- [Pump platform fee](#sec-347) — the pump trade fee detail.+- [Coin-launch wallets](#sec-505) — launch-time wallet flow.- [Creator revenue splits](../api/_lib/cosmetics-economy.js) — `recordSaleAndSplit`: the cosmetic split math and its real USDC payout.- [Agent wallet custody](#sec-072) — how custodial keys are held.- [Solana signers runbook](../api/_lib/solana-signers.js) — signer/funder wallets + funding.----<a id="sec-292"></a>+<a id="sec-293"></a>> **Source:** `docs/monitor.md` · [↑ table of contents](#table-of-contents)@@ -67710,7 +67851,7 @@ board a lie.avatar cam while it works- [Money Pulse](https://three.ws/pulse): the full event feed with filters andper-agent views-- [Money Flow Map](#sec-290): the topology behind the totals, who+- [Money Flow Map](#sec-291): the topology behind the totals, whopays whom- [Agent Economy Volume](https://three.ws/agent-economy-volume): the long-windowagent-to-agent hire ledger@@ -67718,7 +67859,7 @@ board a lie.----<a id="sec-293"></a>+<a id="sec-294"></a>> **Source:** `docs/motion-swap.md` · [↑ table of contents](#table-of-contents)@@ -67814,7 +67955,7 @@ its error state.----<a id="sec-294"></a>+<a id="sec-295"></a>> **Source:** `docs/multi-agent.md` · [↑ table of contents](#table-of-contents)@@ -68157,7 +68298,7 @@ To extend this into a full turn-based scene, add a `brain` attribute to Mira wit----<a id="sec-295"></a>+<a id="sec-296"></a>> **Source:** `docs/native-launchpad.md` · [↑ table of contents](#table-of-contents)@@ -68352,7 +68493,7 @@ Stated plainly, because a half-built feature that claims to be finished is worse----<a id="sec-296"></a>+<a id="sec-297"></a>> **Source:** `docs/news-rights.md` · [↑ table of contents](#table-of-contents)@@ -68446,11 +68587,11 @@ Three rules, in order of importance:- [`api/_lib/news-rights.js`](../api/_lib/news-rights.js) — the implementation- [`scripts/news-takedown-purge.mjs`](../scripts/news-takedown-purge.mjs) — the purge tool-- [Market Data API](#sec-273) — the paid market endpoints, including archive search+- [Market Data API](#sec-274) — the paid market endpoints, including archive search----<a id="sec-297"></a>+<a id="sec-298"></a>> **Source:** `docs/notifications.md` · [↑ table of contents](#table-of-contents)@@ -68731,7 +68872,7 @@ one click from the gear icon in both notification surfaces.## Related pages-- [The social layer](#sec-396): where notification events come from+- [The social layer](#sec-398): where notification events come fromand how they connect to the feed, follows, and portfolios.- [api/notifications/README.md](../api/notifications/README.md): theendpoint directory's own reference.@@ -68740,7 +68881,7 @@ one click from the gear icon in both notification surfaces.----<a id="sec-298"></a>+<a id="sec-299"></a>> **Source:** `docs/nvidia-apps-catalog-listing.md` · [↑ table of contents](#table-of-contents)@@ -68748,7 +68889,7 @@ one click from the gear icon in both notification surfaces.Everything needed to submit three.ws to the NVIDIA Inception Accelerated Apps Catalog. The form lives behind the Inception portal login (Portal > Profile > Add product), so this doc holds the copy, categories, links, and assets ready to paste. Submissions are reviewed by NVIDIA on a rolling basis; approval is subject to fit.-Related docs: [nvidia-inception.md](#sec-300) (membership overview), [nvidia-models.md](#sec-301) (full model map, the source of truth for every NVIDIA claim below), [nvidia-visibility-map.md](#sec-304) (every other NVIDIA surface, and the asks to batch into the request email below).+Related docs: [nvidia-inception.md](#sec-301) (membership overview), [nvidia-models.md](#sec-302) (full model map, the source of truth for every NVIDIA claim below), [nvidia-visibility-map.md](#sec-305) (every other NVIDIA surface, and the asks to batch into the request email below).---@@ -68781,7 +68922,7 @@ Remove and leave unchecked:### 2. Ask for the catalog listing-The portal has no "publish to catalog" button, so the request goes to the program team. Send the email in [nvidia-apps-catalog-request.md](#sec-299) to `[email protected]` after the record corrections above are saved, and note the send date there.+The portal has no "publish to catalog" button, so the request goes to the program team. Send the email in [nvidia-apps-catalog-request.md](#sec-300) to `[email protected]` after the record corrections above are saved, and note the send date there.---@@ -68903,24 +69044,24 @@ Nothing else checked. TensorRT/Triton/Omniverse stay unchecked here too.6. Submit. Listings are reviewed on a rolling basis; note the submission date in this doc when done.7. Correct the existing record per the Status section (move Riva/Audio2Face/NIM to Used, drop DeepVariant NIM) BEFORE adding anything new.8. Add the `<agent-3d>` embed as a second product using its section above. Do not file more records than these two: duplicates read as noise to the curator.-9. Send the inclusion-request email in [nvidia-apps-catalog-request.md](#sec-299) to [email protected] and record the send date there.+9. Send the inclusion-request email in [nvidia-apps-catalog-request.md](#sec-300) to [email protected] and record the send date there.----<a id="sec-299"></a>+<a id="sec-300"></a>> **Source:** `docs/nvidia-apps-catalog-request.md` · [↑ table of contents](#table-of-contents)# The NVIDIA Inception email: five asks, one thread-The Inception portal has no "publish to the catalog" control. A product record makes the company eligible; the public [Accelerated Apps Catalog](https://marketplace.nvidia.com/en-us/enterprise/applications/) is curated and published by NVIDIA. This is the request that asks for the listing, sent after the portal record is corrected per [nvidia-apps-catalog-listing.md](#sec-298).+The Inception portal has no "publish to the catalog" control. A product record makes the company eligible; the public [Accelerated Apps Catalog](https://marketplace.nvidia.com/en-us/enterprise/applications/) is curated and published by NVIDIA. This is the request that asks for the listing, sent after the portal record is corrected per [nvidia-apps-catalog-listing.md](#sec-299).-It also carries four other asks that have never been made. Per [nvidia-visibility-map.md](#sec-304), every Tier 1 ask routes to the same inbox, so they are batched here deliberately. **Do not split these into separate emails.** A program manager who receives one clear email with five asks answers it. Five separate emails read as noise.+It also carries four other asks that have never been made. Per [nvidia-visibility-map.md](#sec-305), every Tier 1 ask routes to the same inbox, so they are batched here deliberately. **Do not split these into separate emails.** A program manager who receives one clear email with five asks answers it. Five separate emails read as noise.- **To:** [email protected]- **Subject:** three.ws (Inception member): catalog listing, Showcase, and co-marketing- **Sent:** not yet sent. Record the date here when it goes out.-- **Blocked on:** the portal record correction, [nvidia-apps-catalog-listing.md](#sec-298) step 1. As filed the record reads as a CUDA consumer rather than a digital-human app, which undercuts asks 1 and 2. Correct it, save it, then send.+- **Blocked on:** the portal record correction, [nvidia-apps-catalog-listing.md](#sec-299) step 1. As filed the record reads as a CUDA consumer rather than a digital-human app, which undercuts asks 1 and 2. Correct it, save it, then send.### The five asks, and why each one is here@@ -68999,7 +69140,7 @@ https://three.ws----<a id="sec-300"></a>+<a id="sec-301"></a>> **Source:** `docs/nvidia-inception.md` · [↑ table of contents](#table-of-contents)@@ -69037,7 +69178,7 @@ Membership is a startup program, not a partnership or an investment: NVIDIA revi## Related-- [NVIDIA visibility map](#sec-304): every NVIDIA surface where three.ws can earn recognition, what each one requires, and which membership benefits are still unclaimed+- [NVIDIA visibility map](#sec-305): every NVIDIA surface where three.ws can earn recognition, what each one requires, and which membership benefits are still unclaimed- [NVIDIA models on three.ws](/docs/nvidia-models) — the free inference layer, model by model- [The generator was never the hard part](/docs/nvidia-nemotron-spotlight): our Nemotron Nano write-up, published on the NVIDIA Developer Forums- [Image-to-3D on NVIDIA L4 and Blackwell](https://three.ws/blog/image-to-3d-on-nvidia-l4-and-blackwell): the engineering post on the GPU fleet itself: memory ceilings, `sm_120` kernels, and regional quota@@ -69045,7 +69186,7 @@ Membership is a startup program, not a partnership or an investment: NVIDIA revi----<a id="sec-301"></a>+<a id="sec-302"></a>> **Source:** `docs/nvidia-models.md` · [↑ table of contents](#table-of-contents)@@ -69252,7 +69393,7 @@ The free NVIDIA TTS lane: **Magpie multilingual on Riva**, selected by an NVCF `----<a id="sec-302"></a>+<a id="sec-303"></a>> **Source:** `docs/nvidia-nemotron-ask-the-experts-questions.md` · [↑ table of contents](#table-of-contents)@@ -69356,11 +69497,11 @@ Every claim in the two posts is sourced, so a follow-up question cannot catch us| Claim | Source ||---|---|-| NVIDIA Inception member, accepted July 2026 | [nvidia-inception.md](#sec-300) |-| `nvidia/nemotron-nano-12b-v2-vl` gates every photo-to-3D generation, 1-2s | [nvidia-nemotron-spotlight.md](#sec-303), `api/_lib/forge-image-validate.js` |-| ~281 image prompt tokens vs ~1,600 for a 90B-class VLM | [nvidia-nemotron-spotlight.md](#sec-303) |+| NVIDIA Inception member, accepted July 2026 | [nvidia-inception.md](#sec-301) |+| `nvidia/nemotron-nano-12b-v2-vl` gates every photo-to-3D generation, 1-2s | [nvidia-nemotron-spotlight.md](#sec-304), `api/_lib/forge-image-validate.js` |+| ~281 image prompt tokens vs ~1,600 for a 90B-class VLM | [nvidia-nemotron-spotlight.md](#sec-304) || Published Nemotron write-up on the NVIDIA Developer Forums | [forums.developer.nvidia.com](https://forums.developer.nvidia.com/t/how-nemotron-made-three-ws-text-to-3d-pipeline-usable/376445) |-| `nvidia-nemotron-nano-9b-v2` used for reasoning turns, NemoGuard at ~340 ms median | [nvidia-nemotron-spotlight.md](#sec-303) |+| `nvidia-nemotron-nano-9b-v2` used for reasoning turns, NemoGuard at ~340 ms median | [nvidia-nemotron-spotlight.md](#sec-304) |The two other standing asks from that write-up (the hosted TRELLIS image-inputrestriction and the 77-character TRELLIS prompt cap) are TRELLIS questions, not Nemotron@@ -69447,7 +69588,7 @@ plus a reported trillion-parameter Nemotron 4 in training.----<a id="sec-303"></a>+<a id="sec-304"></a>> **Source:** `docs/nvidia-nemotron-spotlight.md` · [↑ table of contents](#table-of-contents)@@ -69608,11 +69749,11 @@ Build the small stuff. Put it in front. The generator was never the hard part.----*three.ws is a browser-native platform for generating 3D avatars, worlds, and agents from a sentence. The text-to-3D lane described here is free and open: no key, no account. Our full NVIDIA model map lives in [`docs/nvidia-models.md`](#sec-301), and the pipeline internals are in [`docs/3d-asset-pipeline.md`](#sec-002). three.ws joined the [NVIDIA Inception program](#sec-300) in July 2026; the companion engineering post on our own GPU fleet is [Image-to-3D on NVIDIA L4 and Blackwell](https://three.ws/blog/image-to-3d-on-nvidia-l4-and-blackwell).*+*three.ws is a browser-native platform for generating 3D avatars, worlds, and agents from a sentence. The text-to-3D lane described here is free and open: no key, no account. Our full NVIDIA model map lives in [`docs/nvidia-models.md`](#sec-302), and the pipeline internals are in [`docs/3d-asset-pipeline.md`](#sec-002). three.ws joined the [NVIDIA Inception program](#sec-301) in July 2026; the companion engineering post on our own GPU fleet is [Image-to-3D on NVIDIA L4 and Blackwell](https://three.ws/blog/image-to-3d-on-nvidia-l4-and-blackwell).*----<a id="sec-304"></a>+<a id="sec-305"></a>> **Source:** `docs/nvidia-visibility-map.md` · [↑ table of contents](#table-of-contents)@@ -69623,8 +69764,8 @@ every NVIDIA surface where three.ws can earn recognition, what each one actuallyrequires, and the honest status of each today.Scope note: the **Accelerated Apps Catalog** already has its own two docs and is-not re-litigated here. See [nvidia-apps-catalog-listing.md](#sec-298)-for the listing kit and [nvidia-apps-catalog-request.md](#sec-299)+not re-litigated here. See [nvidia-apps-catalog-listing.md](#sec-299)+for the listing kit and [nvidia-apps-catalog-request.md](#sec-300)for the inclusion email. This doc covers everything else and links to them wherethey overlap.@@ -69670,7 +69811,7 @@ Everything here can be done today. Nothing waits on NVIDIA, a build, or a date.|---|---|---|---|| 1 | **Our own X, LinkedIn, and Telegram** | Ours | The membership post that never happened. See [Social](#social-surfaces-ours-to-drive). || 2 | **Inception co-marketing kit** | Portal benefit request, or `[email protected]` | An entitlement we have never claimed. See [Benefits we are owed](#benefits-we-are-entitled-to-and-have-never-requested). |-| 3 | **Portal product record correction** | `programs.nvidia.com/phoenix/application` | Gates the Showcase AND the Apps Catalog. Already specified in [nvidia-apps-catalog-listing.md](#sec-298) step 1. Nothing else in this doc lands well while the record says "CUDA consumer". |+| 3 | **Portal product record correction** | `programs.nvidia.com/phoenix/application` | Gates the Showcase AND the Apps Catalog. Already specified in [nvidia-apps-catalog-listing.md](#sec-299) step 1. Nothing else in this doc lands well while the record says "CUDA consumer". || 4 | **Inception Startup Showcase** | `[email protected]` | NVIDIA's own wording is "member spotlights and story opportunities". Curated from the portal record, so do #3 first. || 5 | **AI Podcast guest nomination** | Embedded form at [ai-podcast.nvidia.com](https://ai-podcast.nvidia.com) | Free, one form, and a founder-shaped story. Fields: name, business email, organization, industry, job title, location, preferred language, and a description of the proposal. || 6 | **NVIDIA Developer Forums, post 3** | [forums.developer.nvidia.com](https://forums.developer.nvidia.com) | We are 2 for 2 on posts that landed. This is the one channel with a proven track record, and it is self-serve. See [Technical publishing](#technical-publishing-the-proven-channel). |@@ -69686,7 +69827,7 @@ Real listings, real effort, honest gates. Do not pitch these before the code exi| **NGC Catalog** (via the [NGC Software Partner program](https://www.nvidia.com/en-us/gpu-cloud/ngc-software-partners/)) | Partner legal agreement, then push to an NGC private staging repo, pass security scanning and QA, final sign-off | **The closest Tier 2 surface to reachable.** Prerequisites are a CUDA 9+ base image, GPU acceleration, Pascal or newer, an EULA, and no personal-data collection. Our GPU workers are already `nvidia/cuda` 12.1 to 12.8 containers, so the technical bar is met; what is missing is the EULA and the legal agreement. This converts work we have already done into a permanent NVIDIA-hosted listing. || **ACE / digital-human ecosystem** | No public form found. Ask for the redirect in the Showcase email | Genuinely strong: Riva, Magpie, and Audio2Face-3D are shipping, and a **browser-native** A2F demo is rare (most A2F work lives in Unreal or Omniverse). This is our most differentiated technical story. Do not overclaim: we consume ACE microservices, we do not self-host NIM. || **NVIDIA Technical Blog** ([developer.nvidia.com/blog](https://developer.nvidia.com/blog/)) | No public guest-submission process. Route via the forum Technical Blog category and the program team | Editorially controlled by NVIDIA. The realistic path is a forum post that performs, then a pitch. Our two live forum posts are the audition tape. |-| **Omniverse Exchange** | [Omniverse Exchange Publishing Portal](https://developer.nvidia.com/omniverse-exchange-publishing-portal) (early access), plus a GitHub repo tagged with the `omniverse-kit-extension` topic | **Blocked and should stay blocked.** OpenUSD interop is roadmap, not shipping, and [nvidia-apps-catalog-listing.md](#sec-298) already rules that Omniverse Kit stays under "Considering". Note the Omniverse Launcher was deprecated 2025-10-01, so old guides mislead. |+| **Omniverse Exchange** | [Omniverse Exchange Publishing Portal](https://developer.nvidia.com/omniverse-exchange-publishing-portal) (early access), plus a GitHub repo tagged with the `omniverse-kit-extension` topic | **Blocked and should stay blocked.** OpenUSD interop is roadmap, not shipping, and [nvidia-apps-catalog-listing.md](#sec-299) already rules that Omniverse Kit stays under "Considering". Note the Omniverse Launcher was deprecated 2025-10-01, so old guides mislead. |## Tier 3: time-gated, and the clock is running@@ -69841,11 +69982,11 @@ Recorded so the next person does not repeat the search.One thread, one address. Every ask in Tier 1 goes to the same inbox, so batchthem into a single email rather than sending four.-**Done: the batched email is written.** [nvidia-apps-catalog-request.md](#sec-299)+**Done: the batched email is written.** [nvidia-apps-catalog-request.md](#sec-300)now carries all five asks (catalog listing, Showcase nomination, co-marketing kit,ACE redirect, GTC pavilion and event slots) in one thread. Do not start a secondone. It is still gated on the portal record correction, which is step 1 of-[nvidia-apps-catalog-listing.md](#sec-298): as filed the+[nvidia-apps-catalog-listing.md](#sec-299): as filed therecord reads as a CUDA consumer, which undercuts the first two asks. Correct therecord, save it, then send and stamp the date in the request doc.@@ -69875,16 +70016,16 @@ gcloud run services list --project aerial-vehicle-466722-p5 \## Related- [Big-tech recognition dispatch board](#sec-125): this map ranked against every other big-tech surface (OpenAI, Anthropic, AWS, IBM) by the odds of a published mention this week. Read that first if you are deciding where a week goes, and this one once NVIDIA is the answer.-- [NVIDIA Inception membership](#sec-300): what membership is, and the rule that it is a program and not a partnership or an endorsement-- [Apps Catalog listing kit](#sec-298) and [inclusion request](#sec-299): the one surface with its own dedicated docs-- [NVIDIA models on three.ws](#sec-301): the source of truth for every NVIDIA technical claim made in any pitch-- [Listings and distribution](#sec-269): the canonical program and directory inventory+- [NVIDIA Inception membership](#sec-301): what membership is, and the rule that it is a program and not a partnership or an endorsement+- [Apps Catalog listing kit](#sec-299) and [inclusion request](#sec-300): the one surface with its own dedicated docs+- [NVIDIA models on three.ws](#sec-302): the source of truth for every NVIDIA technical claim made in any pitch+- [Listings and distribution](#sec-270): the canonical program and directory inventory- [Announcement coverage](#sec-095): which surfaces have been announced and which have not-- [Partners](#sec-323): the independence and no-endorsement language that must survive any rewrite+- [Partners](#sec-324): the independence and no-endorsement language that must survive any rewrite----<a id="sec-305"></a>+<a id="sec-306"></a>> **Source:** `docs/object-library.md` · [↑ table of contents](#table-of-contents)@@ -69911,7 +70052,7 @@ Each card renders the object live in an auto-rotating `<model-viewer>` (with the| Button | Destination | What you get ||---|---|---|-| **Preview** | `/app#model=<glb-url>&kind=object&title=<name>` | The full three.js [3D viewer](#sec-511) in object mode (no agent chat; Restyle, AR, and Download affordances instead) |+| **Preview** | `/app#model=<glb-url>&kind=object&title=<name>` | The full three.js [3D viewer](#sec-514) in object mode (no agent chat; Restyle, AR, and Download affordances instead) || **AR** | `/ar/studio?src=<glb-url>&title=<name>` | [AR Studio](#sec-098): place the prop in your real space through the camera (see [AR & WebXR](#sec-099) for how the AR handoff works per device) || **Download** | The GLB URL directly | The raw GLB file, CC0, yours to use anywhere |@@ -69995,31 +70136,46 @@ The gallery and API are read-only consumers of a manifest built by a local pipel- [Character Library](#sec-136): the rigged, animation-ready counterpart to this library.- [AR & WebXR](#sec-099): the device-by-device AR methods behind the AR button.- [AR Studio](#sec-098): the `/ar/studio` surface the AR button opens, including multi-object rooms.-- [3D Viewer](#sec-511): the `/app` engine the Preview button opens in object mode.+- [3D Viewer](#sec-514): the `/app` engine the Preview button opens in object mode.----<a id="sec-306"></a>+<a id="sec-307"></a>> **Source:** `docs/okx-marketplace.md` · [↑ table of contents](#table-of-contents)# OKX.AI Marketplace Services-three.ws sells 3D services to other AI agents on [OKX.AI](https://web3.okx.com), OKX's+three.ws sells 3D generation to other AI agents on [OKX.AI](https://web3.okx.com), OKX'son-chain agent marketplace. Buyers are agents: they discover a service, receive an HTTP 402payment challenge, pay in stablecoins on X Layer (or USDC on our other x402 rails), and get-the artifact. Our marketplace entry is agent **#2632 "three.ws 3D Studio"**. That listing is-not live yet: it was rejected in review and a resubmission is pending, so the services below-are reachable directly at the endpoints documented here rather than through the marketplace.-Current listing state is tracked in [`prompts/okx-ai/PROGRESS.md`](../prompts/okx-ai/PROGRESS.md).+the artifact. Our marketplace entry is agent **#2632 "three.ws 3D Studio"**.++> **Listing state.** The listing is not live yet. It was rejected in review on 2026-07-04+> ("your A2MCP service has not been integrated with the OKX Agent Payments Protocol+> standard") and a resubmission is pending. The services below are reachable directly at+> the endpoints documented here in the meantime. Current state is tracked in+> [`prompts/okx-ai/PROGRESS.md`](../prompts/okx-ai/PROGRESS.md).-> Related: [REST API Reference](#sec-096) · [MCP servers](#sec-281) ·-> [x402 payments](#sec-552) · seller-side protocol spec: [`specs/okx-agent-payments.md`](../specs/okx-agent-payments.md)+**What we list, as of 2026-08-22: three.ws Forge.** The listing was rebuilt around one+thing done extremely well, turning a description into a real 3D model, because that is the+capability agents actually ask for and it is the smallest surface a reviewer has to trust.+An OKX.AI agent gets exactly what the "three.ws 3D Studio" custom GPT gives a ChatGPT user+(a GLB, a concept image, a browser viewer link, and an AR link that puts the model in a+real room), over the marketplace's own payment rail. Everything else we built for OKX.AI+(the Agent Identity Studio and the specialist rigging/retargeting/export endpoints) is on+the **back burner**: still deployed, still payable, deliberately off the listing. Those are+documented at the bottom of this page.++> Related: [REST API Reference](#sec-096) · [MCP servers](#sec-282) ·+> [x402 payments](#sec-554) · seller-side protocol spec:+> [`specs/okx-agent-payments.md`](../specs/okx-agent-payments.md)The **single source of truth** for every service (names, 2-part OKX descriptions, prices,-endpoints, input schemas) is [`api/_lib/okx-catalog.js`](../api/_lib/okx-catalog.js), the-free catalog endpoint below serves it verbatim, so the docs, the endpoints, and the OKX-listing can never drift apart.+endpoints, input schemas, and which rows are listed) is+[`api/_lib/okx-catalog.js`](../api/_lib/okx-catalog.js). The free catalog endpoint below+serves it verbatim and the listing submission is generated from it, so the docs, the+endpoints, and the OKX listing cannot drift apart.---@@ -70028,7 +70184,7 @@ listing can never drift apart.No payment, no account, no key.```bash-# Machine-readable index of every service+# Machine-readable index: `services` is the listed line-up, `unlisted` is the back burnercurl https://three.ws/api/okx/3d/catalog# Live health of the lanes behind the paid services (real probes, not a static ok)@@ -70037,107 +70193,158 @@ curl https://three.ws/api/okx/3d/health----## Agent Identity Studio, `$1.50` per identity+## three.ws Forge-**The flagship.** Turns an AI agent's brand brief into a complete 3D identity:+Four paid services and one free one. Every row is a real **A2MCP** endpoint: MCP Streamable+HTTP, JSON-RPC 2.0 `tools/call` over `POST`, SSE discovery on `GET`, session terminate on+`DELETE`. The paid tool answers an unpaid call with an OKX-dialect 402 whose `accepts[]`+**leads with `eip155:196`**, which is the OKX Agent Payments Protocol integration the+review asked for.-- a **square PFP** (1024 px PNG + 128 px preview) framed head-and-shoulders, sized for the- OKX.AI avatar slot and legible at marketplace thumbnail size;-- a **full-body render set**, three distinct poses from the three.ws pose library, studio- lighting, consistent backdrop;-- the **rigged, animation-ready GLB** itself (humanoid skeleton + skin weights), usable in- three.ws scenes, games, and any glTF runtime;-- a live [three.ws viewer](https://three.ws/viewer) link and pose-studio link.+| Service | Price (USDT) | Endpoint | You send |+|---|---|---|---|+| Forge 3D Draft | $0.01 | `/api/okx/3d/forge-draft` | `prompt` |+| Forge 3D Standard | $0.05 | `/api/okx/3d/forge-standard` | `prompt` |+| Forge 3D HD | $0.25 | `/api/okx/3d/forge-hd` | `prompt` |+| Forge 3D from Image | $0.25 | `/api/okx/3d/forge-image` | `image_urls[]` |+| Forge Job Status | free | `/api/okx/3d/forge-status` | `job_id` |-Endpoint: `https://three.ws/api/okx/3d/identity-studio`, an A2MCP service (MCP Streamable-HTTP, JSON-RPC `tools/call`). Demo identities generated end-to-end by this pipeline:-[three.ws/agent-identities](https://three.ws/agent-identities).+The four paid rows differ **only** in generation lane and price. OKX prices a service, not+a parameter, so a quality tier has to be its own row to carry its own fee. Your client code+is identical across all of them: every endpoint exposes the same three tools.-### 1 · Create (paid)+| Tool | Cost | What it does |+|---|---|---|+| `forge_3d` | the row's price | Starts a generation, returns a `job` handle |+| `forge_status` | free | Polls any three.ws forge job, returns the finished links |+| `getting_started` | free | Overview of the server, its tools, prices, and links |-An unpaid call returns the 402 challenge; pay it (e.g. `onchainos payment pay --payload …`-on OKX rails, or any x402 client) and replay with the payment header.+`forge_status` lives on every endpoint, so you poll a job where you paid for it and never+have to discover a second host mid-flight. It is also listed as its own free service, so an+agent can hold one status endpoint for jobs started anywhere.++### 1 · Start a generation (paid)++An unpaid call returns the 402 challenge; pay it (`onchainos payment pay --payload '<402+body>'` on OKX rails, or any x402 client) and replay with the payment header.```bash-curl -sS -X POST https://three.ws/api/okx/3d/identity-studio \+curl -sS -X POST https://three.ws/api/okx/3d/forge-standard \-H 'content-type: application/json' \+ -H 'PAYMENT-SIGNATURE: <the header your x402 client returned>' \-d '{"jsonrpc": "2.0", "id": 1, "method": "tools/call","params": {- "name": "create_identity",- "arguments": {- "agent_name": "LedgerLynx",- "brief": "A meticulous on-chain accounting agent that reconciles wallets and flags anomalies in real time. Calm, precise, incorruptible.",- "style_hints": "deep navy and silver palette, brushed-metal accents"- }+ "name": "forge_3d",+ "arguments": { "prompt": "a low-poly orange fox sitting down" }}}'```-Arguments:+Arguments for the three text rows:| Field | Required | Notes || --- | --- | --- |-| `agent_name` | yes | ≤80 chars, rendered into the identity brief |-| `brief` | yes | any language; >2000 chars is truncated and the response flags `brief_truncated` |-| `style_hints` | no | palette / materials / era / mood |-| `reference_image_url` | no | public image guiding the look, validated **before** any charge |+| `prompt` | yes | 3 to 1000 characters, one subject, its style and key colours |+| `aspect_ratio` | no | `1:1`, `4:3`, `3:4`, `16:9`, `9:16` |++`forge-image` takes `image_urls` (1 to 4 `https://` links to views of the same subject)+plus an optional `prompt` that sharpens the reconstruction.-Success returns `{ job_id, status: "running", stage: "generate", poll_tool: "identity_status", eta_seconds }`.+A queued job returns:-### 2 · Poll (free)+```json+{+ "ok": true, "service": "forge-standard", "status": "pending",+ "job": "f1.…", "poll_tool": "forge_status",+ "poll_endpoint": "https://three.ws/api/okx/3d/forge-status",+ "watchUrl": "https://three.ws/watch?job=…", "format": "glb", "etaSeconds": 45+}+```++A fast lane can finish inline instead, in which case you get the `done` body below with no+polling at all.++### 2 · Poll the job (free)```bash-curl -sS -X POST https://three.ws/api/okx/3d/identity-studio \+curl -sS -X POST https://three.ws/api/okx/3d/forge-status \-H 'content-type: application/json' \-d '{"jsonrpc": "2.0", "id": 2, "method": "tools/call",- "params": { "name": "identity_status", "arguments": { "job_id": "<job_id>" } }+ "params": { "name": "forge_status", "arguments": { "job_id": "f1.…" } }}'```-Each poll advances the pipeline one bounded step (generation → humanoid auto-rig → one-studio render per poll) and reports `stage` + render progress. Poll every ~5 s; typical time-to `done` is 3-6 minutes. When `status` is `"done"`, `deliverables` carries the PFP URLs,-the full-body set, `rigged_glb_url`, `mesh_glb_url`, `viewer_url`, and `pose_studio_url`.+Poll every few seconds. When `status` is `"done"`:++```json+{+ "ok": true, "status": "done", "job": "f1.…",+ "glbUrl": "https://…/model.glb",+ "viewerUrl": "https://three.ws/viewer?src=…",+ "arUrl": "https://three.ws/api/ar?src=…",+ "previewImageUrl": "https://…/concept.png",+ "format": "glb", "tier": "standard"+}+```++- `glbUrl` is the model itself, a real glTF binary you can download, open in any glTF+ runtime, or embed.+- `viewerUrl` opens it in a browser, spinning, on any device.+- `arUrl` is the device-aware AR launch: Scene Viewer on Android, Quick Look on iOS+ (GLB to USDZ converted in-page), the WebGL viewer on desktop. This is the link that puts+ the model in a human's actual room, which is usually what an agent's user wanted.+- `previewImageUrl` is the painted concept view the forge produces before the mesh, so you+ can show something the moment it exists.++A failed job answers `status: "error"` with an actionable message. Generation failures are+free to retry.### Payment semantics-Each guarantee below is enforced in code, the request path is-`verify → dispatch → settle-on-success` ([`api/okx/3d/[service].js`](../api/okx/3d/[service].js)),-so an engine error is answered *before* settlement, and is covered by the endpoint's unit-tests.--- **You pay only when the job is accepted.** Input validation, including fetching your- `reference_image_url`, runs before settlement; an invalid brief or unreachable image- fails the call and **no payment settles**.-- **Failed stages retry free.** Generation and rigging each retry up to 3 total attempts on- transient upstream failures; renders re-run on the next poll. Only exhausted retries mark- the job `failed`, with the last actionable error in `last_error`.-- **Status polling is free and unauthenticated**, job tokens are HMAC-signed, so they are- the only capability needed to read a job.-- One payment ↔ one job: the payment proof is single-use across dispatch + settlement+Each guarantee below is enforced in code (`verify → dispatch → settle-on-success`, in+[`api/okx/3d/[service].js`](../api/okx/3d/[service].js)) and covered by the endpoint's+unit tests in [`tests/api/okx-forge.test.js`](../tests/api/okx-forge.test.js).++- **You pay only when the job is accepted.** Input validation and the age-13+ content gate+ run before settlement; a rejected prompt or a malformed argument fails the call and+ **no payment settles**.+- **Polling is free and unlimited**, on every endpoint and on the standalone status+ service.+- **One payment, one job.** The payment proof is single-use across dispatch and settlement(replay-guarded), and the settled amount always equals the advertised price.+- **Retried payments are safe.** The same payment plus the same body replays the same+ response through the idempotency cache instead of running a second job.+- **Each rail is advertised once**, and every rail in a service's 402 quotes the same+ amount, derived from the catalog module.> **Not yet demonstrated end to end.** The X Layer rail reports `settleable: true` in-> production, but no *funded* call has settled on-chain against this endpoint yet, the payer-> wallet is unfunded, so every real attempt returns `insufficient_balance`. Treat the bullets-> above as the implemented and unit-tested contract, not as a claim of an observed on-chain-> settlement. The first settled transaction hash will be recorded in+> production, but no *funded* call has settled on-chain against these endpoints yet: the+> payer wallet is unfunded, so every real attempt returns `insufficient_balance`. Treat the+> bullets above as the implemented and unit-tested contract, not as a claim of an observed+> on-chain settlement. The first settled transaction hash gets recorded in> [`prompts/okx-ai/PROGRESS.md`](../prompts/okx-ai/PROGRESS.md).-### Also on this endpoint (free)+----- `getting_started`, overview of the server, tools, prices, and links.-- `GET https://three.ws/api/okx/3d/identity-studio`, SSE / discovery challenge.+## Back burner----+These are **not** on the OKX.AI listing and are not part of the current submission. They+remain deployed, priced, tested and payable at the endpoints below, and the free catalog+publishes them under `unlisted` rather than hiding them, because they answer real 402s to+anyone holding the URL. They return to the listing once the forge rows have sales behind+them.-## Decomposed 3D studio services+**Agent Identity Studio**, `$1.50`, `/api/okx/3d/identity-studio` (A2MCP). Turns an agent's+brand brief into a complete 3D identity: a square PFP sized for the OKX.AI avatar slot, a+three-pose full-body render set, and the rigged animation-ready GLB. Paid tool+`create_identity`, free `identity_status` polling. Demo identities generated end to end by+this pipeline: [three.ws/agent-identities](https://three.ws/agent-identities).-Micro-priced, single-capability REST endpoints, plain JSON `POST`, one price each, all-backed by the same engines the [MCP 3D studio](#sec-281) runs (no separate pipeline).-`GET` on any of them returns its free descriptor (price, description, input schema).+**Single-capability REST endpoints.** Plain JSON `POST`, one price each, all backed by the+same engines the [MCP 3D studio](#sec-282) runs. `GET` on any of them returns its free+descriptor (price, description, input schema).| Service | Price (USDT) | Endpoint | You send ||---|---|---|---|@@ -70151,126 +70358,26 @@ backed by the same engines the [MCP 3D studio](#sec-281) runs (no separate pipel| FBX Export (rig-preserving) | $0.10 | `/api/okx/3d/fbx-export` | `model_url`, `format?` |The buyer flow is the same for all of them: unpaid `POST` → 402 → sign-(`onchainos payment pay --payload '<402 body>'`) → replay with-`PAYMENT-SIGNATURE`. Generation-grade services reply `{status:"queued", job_id, poll_url}`, polling `GET https://three.ws/api/forge?job=<job_id>` is free and unlimited; fast-services (`retarget`, `pose-seed`) reply `{status:"done", …}` inline. Settlement happens-**after** the engine accepts the job; invalid input, the avatar humanoid gate, or an-engine failure answers before settlement and never charges.--### Text → 3D Model (GLB), $0.01--Textured GLB from a text prompt on the fast draft lane. The lane leads with our self-hosted-TRELLIS worker and falls back through Hunyuan3D, HuggingFace, and NVIDIA NIM as a last-resort, so a single dead upstream never fails the call.--```bash-curl -i -X POST https://three.ws/api/okx/3d/text-to-3d \- -H 'content-type: application/json' \- -d '{"prompt":"a brass steampunk owl, full body"}'-```--### Text → 3D Model (Pro), $0.30--An LLM art director refines the prompt, then a higher-quality lane generates the GLB.-`tier:"standard"` (default) or `tier:"high"` (max geometric detail + PBR textures).--```bash-curl -i -X POST https://three.ws/api/okx/3d/text-to-3d-pro \- -H 'content-type: application/json' \- -d '{"prompt":"ornate elven longsword","tier":"high"}'-```--### Image → 3D Model, $0.30--Reconstructs a textured GLB from 1-4 public photos of one object.--```bash-curl -i -X POST https://three.ws/api/okx/3d/image-to-3d \- -H 'content-type: application/json' \- -d '{"image_urls":["https://three.ws/avatars/thumbs/default.png","https://three.ws/avatars/thumbs/cz.png"]}'-```--### GLB Auto-Rigging, $0.25--Adds an animation-ready humanoid skeleton and skin weights to a static GLB (UniRig lane).--```bash-curl -i -X POST https://three.ws/api/okx/3d/rig \- -H 'content-type: application/json' \- -d '{"glb_url":"https://three.ws/avatars/cesium-man.glb"}'-```--### Text → Rigged Avatar, $0.50--Mesh generation + auto-rig in one call. Obvious non-humanoid prompts are refused **before**-payment settles (`allow_non_humanoid: true` overrides). The paid response returns the mesh-GLB immediately (`mesh_glb_url` + viewer link) plus the rig job to poll, a rig hiccup-never loses the paid generation.--```bash-curl -i -X POST https://three.ws/api/okx/3d/avatar \- -H 'content-type: application/json' \- -d '{"prompt":"a heroic knight in silver armor, full body"}'-```--### Animation Retargeting, $0.10--Retargets a curated clip (idle, walk, dance, …) onto any rigged humanoid GLB, returns the-retargeted AnimationClip JSON keyed to the rig's actual bones plus a bone-coverage report.-Completes inside the request. Clip names are free at-[`/animations/manifest.json`](https://three.ws/animations/manifest.json).--```bash-curl -i -X POST https://three.ws/api/okx/3d/retarget \- -H 'content-type: application/json' \- -d '{"model_url":"https://three.ws/avatars/cz.glb","animation":"idle"}'-```--### Pose Seed, $0.02--Deterministic pose resolution: natural-language description → stable seed + full-joint-rotation map for humanoid rigs. Same prompt, same pose, every time. Completes inside-the request.--```bash-curl -i -X POST https://three.ws/api/okx/3d/pose-seed \- -H 'content-type: application/json' \- -d '{"prompt":"confident standing pose, arms crossed"}'-```--### FBX Export (rig-preserving), $0.10--GLB → FBX for Unity/Unreal; a rigged GLB keeps its skeleton, skin weights, and blendshapes.-Other formats: `obj`, `stl`, `ply`, `usdz`, `3mf`.--```bash-curl -i -X POST https://three.ws/api/okx/3d/fbx-export \- -H 'content-type: application/json' \- -d '{"model_url":"https://three.ws/avatars/cz.glb","format":"fbx"}'-```--### Guarantees (all decomposed services)--- **Pay only after the job is accepted**, verify runs before the engine, settle after it;- failure replies state explicitly that the payment was not taken.-- **Retried payments are safe**, the same payment + body replays the same response- (idempotency cache); a payment proof is single-use across dispatch + settlement.-- **One service, one price**, every rail advertised in a service's 402 quotes the same- amount, derived from the catalog module.+(`onchainos payment pay --payload '<402 body>'`) → replay with `PAYMENT-SIGNATURE`.+Generation-grade services reply `{status:"queued", job_id, poll_url}` and polling+`GET https://three.ws/api/forge?job=<job_id>` is free; fast services (`retarget`,+`pose-seed`) reply `{status:"done", …}` inline. Settlement happens **after** the engine+accepts the job, so invalid input, the avatar humanoid gate, or an engine failure answers+before settlement and never charges.---## RailsChallenges advertise every rail the deployment can settle: **X Layer (`eip155:196`,-USD₮0)** via the OKX facilitator for OKX.AI buyers, plus the existing Solana / Base / BSC-USDC rails. The wire format OKX buyers use (headers `PAYMENT-REQUIRED` /-`PAYMENT-SIGNATURE` / `PAYMENT-RESPONSE`, scheme `exact` EIP-3009) is pinned down in-[`specs/okx-agent-payments.md`](../specs/okx-agent-payments.md).+USD₮0)** first for OKX.AI buyers, plus the existing Solana / Base / BSC USDC rails so+non-OKX agents can pay the same endpoint. The wire format OKX buyers use (headers+`PAYMENT-REQUIRED` / `PAYMENT-SIGNATURE` / `PAYMENT-RESPONSE`, scheme `exact` EIP-3009) is+pinned down in [`specs/okx-agent-payments.md`](../specs/okx-agent-payments.md).----<a id="sec-307"></a>+<a id="sec-308"></a>> **Source:** `docs/onboarding-tier.md` · [↑ table of contents](#table-of-contents)@@ -70417,17 +70524,17 @@ drift silently, since the four files involved have no import edge between them:- [`public/nav-data.js`](../public/nav-data.js) — the single source of truth for every menu- [`STRUCTURE.md`](../STRUCTURE.md) — where every product surface lives-- [`docs/start-here.md`](#sec-404) — the same journey, written for a human rather than a maintainer+- [`docs/start-here.md`](#sec-406) — the same journey, written for a human rather than a maintainer----<a id="sec-308"></a>+<a id="sec-309"></a>> **Source:** `docs/onchain-agents.md` · [↑ table of contents](#table-of-contents)# Deploying Agents On-Chain (Bulk)-Give every three.ws agent a real on-chain identity: a **Metaplex Core NFT** minted into the **three.ws Agents collection** on Solana. This page is for platform admins and self-hosters; regular users register a single agent through the wallet-signed flow instead. It is the bulk/admin counterpart to the single-agent, user-signed flow in [Solana agents](#sec-399): it deploys many agents server-side through a CLI runner that reports every mint as it lands.+Give every three.ws agent a real on-chain identity: a **Metaplex Core NFT** minted into the **three.ws Agents collection** on Solana. This page is for platform admins and self-hosters; regular users register a single agent through the wallet-signed flow instead. It is the bulk/admin counterpart to the single-agent, user-signed flow in [Solana agents](#sec-401): it deploys many agents server-side through a CLI runner that reports every mint as it lands.> Not pump.fun. These are NFTs (on-chain identity), not tokens. The only coin three.ws ever references is `$THREE`; it appears in each asset's metadata as a link, nothing more.@@ -70490,7 +70597,7 @@ Every agent is minted **into** a single Metaplex Core *collection* account, "thr2. **DB** — the `app_settings` table, key `solana_agent_collection_<network>`.3. **Deploy** — first run with neither set deploys the collection (funded + signed by the authority), then persists its address to `app_settings`.-> After the first run, set `SOLANA_AGENT_COLLECTION_MAINNET=<address>` in your environment so the single-agent flow in [Solana agents](#sec-399) mints into the *same* collection.+> After the first run, set `SOLANA_AGENT_COLLECTION_MAINNET=<address>` in your environment so the single-agent flow in [Solana agents](#sec-401) mints into the *same* collection.---@@ -70697,14 +70804,14 @@ A confirmed canary asset shows `inCollection=true`, `royalty=500bps`, `attrs=11`## See also-- [Solana agents](#sec-399) — the single-agent, user-signed registration flow.+- [Solana agents](#sec-401) — the single-agent, user-signed registration flow.- [ERC-8004](#sec-190) — the EVM on-chain identity path.- [Agent manifest](#sec-055) — the metadata schema.-- [Mint mark ("3ws")](#sec-286) — vanity marking for three.ws launches.+- [Mint mark ("3ws")](#sec-287) — vanity marking for three.ws launches.----<a id="sec-309"></a>+<a id="sec-310"></a>> **Source:** `docs/open-source-friday-plan.md` · [↑ table of contents](#table-of-contents)@@ -70730,7 +70837,7 @@ Verified 2026-08-21 against `gh repo view nirholas/three.ws` and the working tre| **100+ stars, hosted on GitHub** | **FAIL by 2** | 98 stargazers, 24 forks || Open to outside contributions | PASS | 11 contributors, issue and PR templates, CODEOWNERS, and six curated open issues (see below) || *Preferred:* community channel | **PASS** | Telegram community, X community, IBM Community group, GitHub Discussions, release channel. All five documented in [docs/community.md](#sec-151) and wired into the README, CONTRIBUTING, and the new-issue chooser. |-| *Preferred:* triage team / contributor onboarding | **PASS** | [docs/triage.md](#sec-421) (labels, claiming, published response targets) and [docs/first-contribution.md](#sec-224) (clone to PR in 15 minutes, worked example) |+| *Preferred:* triage team / contributor onboarding | **PASS** | [docs/triage.md](#sec-424) (labels, claiming, published response targets) and [docs/first-contribution.md](#sec-224) (clone to PR in 15 minutes, worked example) || Guest available Friday 1:00 PM ET | Owner to confirm | Pre-recording is allowed as an exception || Booked at least two weeks ahead | Plan for it | Earliest realistic slot: **2026-09-11** |@@ -70761,7 +70868,7 @@ Apache-2.0 over MIT for two reasons: CONTRIBUTING.md already promised it to ever- **Community channels documented and wired.** [docs/community.md](#sec-151) lists all five rooms with guidance on which fits which question, plus the house rules. Linked from the README (new Community section, in the table of contents), CONTRIBUTING.md, and the GitHub new-issue chooser (`.github/ISSUE_TEMPLATE/config.yml`).- **Contributor onboarding written.** [docs/first-contribution.md](#sec-224) goes clone to open PR in about 15 minutes, with a complete worked example: teaching the avatar retargeter a bone-naming convention, the test that proves it, and the two mistakes that cost a review round.-- **Triage documented.** [docs/triage.md](#sec-421) publishes response targets (2 business days for a new issue or a first-time contributor's PR, 24 hours for a security advisory), what every label means, how to claim work, and how someone becomes a maintainer.+- **Triage documented.** [docs/triage.md](#sec-424) publishes response targets (2 business days for a new issue or a first-time contributor's PR, 24 hours for a security advisory), what every label means, how to claim work, and how someone becomes a maintainer.- **Six curated issues opened**, every one with a named file and a verification command:- [#110](https://github.com/nirholas/three.ws/issues/110) Rig: Apple / ARKit `_joint`-suffixed skeletons (verified: 0 of 10 joints map today)- [#111](https://github.com/nirholas/three.ws/issues/111) Rig: Kinect trailing-side bone names (verified: 0 of 10)@@ -70900,7 +71007,7 @@ The license question that used to sit here is resolved: Apache-2.0, shipped 2026----<a id="sec-310"></a>+<a id="sec-311"></a>> **Source:** `docs/openai-listing-channels.md` · [↑ table of contents](#table-of-contents)@@ -70908,7 +71015,7 @@ The license question that used to sit here is resolved: Apache-2.0, shipped 2026Every route to getting three.ws published on an OpenAI-owned surface, ranked by leverage, with the concrete blocker on each. Written 2026-08-17 after auditing the stalled Cookbook PR.-Related docs: [listings.md](#sec-269) (every listing across all vendors), [mcp.md](#sec-281) (the hosted MCP server a plugin submission depends on), [nvidia-apps-catalog-listing.md](#sec-298) (the same kind of kit for NVIDIA).+Related docs: [listings.md](#sec-270) (every listing across all vendors), [mcp.md](#sec-282) (the hosted MCP server a plugin submission depends on), [nvidia-apps-catalog-listing.md](#sec-299) (the same kind of kit for NVIDIA).---@@ -70938,7 +71045,7 @@ The gating requirement is a public, production MCP server. Most submitters have| Requirement | What we already have ||---|---|-| Public MCP server | `https://three.ws/api/mcp`, Streamable HTTP, MCP `2025-06-18` ([mcp.md](#sec-281)) |+| Public MCP server | `https://three.ws/api/mcp`, Streamable HTTP, MCP `2025-06-18` ([mcp.md](#sec-282)) || Auth | OAuth 2.1 end-user flow, with `api/mcp/.well-known/oauth-protected-resource` discovery already routed in `vercel.json` || Verified website | three.ws, live on Cloud Run behind the production LB || Privacy policy and terms | Live pages, already declared in `data/pages.json` |@@ -70958,7 +71065,7 @@ Six sections: **Info** (name, short and long description, logo, category, URLs,### Scoping decision: submit one plugin, not thirty-seven-The guidelines reject "overly generic single-word names unlinked to your brand" and reward apps that are "tightly scoped." Thirty-seven separate MCP servers submitted individually reads as directory spam and most would fail the tightly-scoped test on their own. Submit **one three.ws plugin whose tools are the text-to-3D and avatar pipeline**, which is the thing no one else in the directory does. The rest stay available as direct MCP connections documented in [mcp.md](#sec-281).+The guidelines reject "overly generic single-word names unlinked to your brand" and reward apps that are "tightly scoped." Thirty-seven separate MCP servers submitted individually reads as directory spam and most would fail the tightly-scoped test on their own. Submit **one three.ws plugin whose tools are the text-to-3D and avatar pipeline**, which is the thing no one else in the directory does. The rest stay available as direct MCP connections documented in [mcp.md](#sec-282).### Known rejection reasons to design against@@ -71046,7 +71153,7 @@ Not OpenAI-owned, so they do not answer the original question, but they are wher----<a id="sec-311"></a>+<a id="sec-312"></a>> **Source:** `docs/openai-pr/00-START-HERE.md` · [↑ table of contents](#table-of-contents)@@ -71089,13 +71196,13 @@ the specific gaps that would fail review or embarrass us in front of OpenAI.| # | Brief | Priority | Blocks submit? || --- | --- | --- | --- |-| 01 | [Resolve the orphaned studio-viewer widget](#sec-312) | P0 | Done 2026-07-18 (Option A: deleted) |-| 02 | [Reconcile the served `.well-known` manifests with the zero-payment claim](#sec-313) | P0 | Yes (reviewer-discoverable crypto surface) |-| 03 | [Make the `forge_free` tier story true everywhere](#sec-314) | P1 | Yes (submission doc contradicts code) |-| 04 | [Close the test gaps on the ChatGPT-facing surface](#sec-315) | P1 | No, but required for "done" |-| 05 | [Serve the custom-GPT OpenAPI and align legal URLs](#sec-316) | P1 | Partial |-| 06 | [Fix doc accuracy and reconcile the tool-count story](#sec-317) | P1 | No |-| 07 | [Final live verification and submit checklist](#sec-318) | P2 (runs last) | Yes (the actual go/no-go) |+| 01 | [Resolve the orphaned studio-viewer widget](#sec-313) | P0 | Done 2026-07-18 (Option A: deleted) |+| 02 | [Reconcile the served `.well-known` manifests with the zero-payment claim](#sec-314) | P0 | Yes (reviewer-discoverable crypto surface) |+| 03 | [Make the `forge_free` tier story true everywhere](#sec-315) | P1 | Yes (submission doc contradicts code) |+| 04 | [Close the test gaps on the ChatGPT-facing surface](#sec-316) | P1 | No, but required for "done" |+| 05 | [Serve the custom-GPT OpenAPI and align legal URLs](#sec-317) | P1 | Partial |+| 06 | [Fix doc accuracy and reconcile the tool-count story](#sec-318) | P1 | No |+| 07 | [Final live verification and submit checklist](#sec-319) | P2 (runs last) | Yes (the actual go/no-go) |Run 02 and 03 first of what remains (01 is already done; they change code and docs the later tasks depend on). 04, 05,06 can run in parallel after. 07 runs last, after everything else is merged.@@ -71143,7 +71250,7 @@ These are non-negotiable and OVERRIDE any default behavior:----<a id="sec-312"></a>+<a id="sec-313"></a>> **Source:** `docs/openai-pr/01-orphan-widget-resolution.md` · [↑ table of contents](#table-of-contents)@@ -71151,7 +71258,7 @@ These are non-negotiable and OVERRIDE any default behavior:> **Resolved 2026-07-18 via Option A** in commit `19c379125` ("Refactor apps-sdk studio viewer and update OpenAI store submission"): `apps-sdk/studio-viewer/src.js`, `scripts/build-apps-sdk-viewer.mjs`, the `build:apps-sdk-viewer` entry in `package.json`, and both generated artifacts under `public/apps-sdk/` were deleted, and `apps-sdk/README.md` plus `ARCHITECTURE.md` were rewritten to point at the real widget (`api/_mcp-studio/component.js`, resource `ui://widget/three-studio-model.html`). `STRUCTURE.md` never referenced the orphan, so it needed no change. Kept as the record of the finding; the file links below point at the now-deleted paths and are left as plain code references.-Read [`00-START-HERE.md`](#sec-311) first for the shared rules and the map.+Read [`00-START-HERE.md`](#sec-312) first for the shared rules and the map.## The problem (verified, with evidence)@@ -71271,13 +71378,13 @@ fetches from** (three.ws, the R2 storage origin, and the CDN if used). Match wha----<a id="sec-313"></a>+<a id="sec-314"></a>> **Source:** `docs/openai-pr/02-wellknown-manifest-conflict.md` · [↑ table of contents](#table-of-contents)# Task 02 — Reconcile the served `.well-known` manifests with the zero-payment claim (P0)-Read [`00-START-HERE.md`](#sec-311) first. **This task touches a manifest+Read [`00-START-HERE.md`](#sec-312) first. **This task touches a manifestthat references crypto/x402. The commit gate in `00-START-HERE.md` rule 7 applies:do the work, but do NOT commit anything that references a non-$THREE crypto projectwithout explicit owner approval. Flag it in your report instead.**@@ -71392,13 +71499,13 @@ manifest layer. Recommended approach (implement this unless you find it wrong):----<a id="sec-314"></a>+<a id="sec-315"></a>> **Source:** `docs/openai-pr/03-forge-free-tier-truth.md` · [↑ table of contents](#table-of-contents)# Task 03 — Make the `forge_free` tier story true everywhere (P1, blocks submit)-Read [`00-START-HERE.md`](#sec-311) first.+Read [`00-START-HERE.md`](#sec-312) first.## The problem (verified, with evidence)@@ -71440,8 +71547,8 @@ metadata surface say "standard by default, higher tiers available on request."description matches the code: standard default, `tier` param lets the caller askfor draft or high, high may take longer or degrade under load.2. Grep every doc for the "highest quality"/"high tier by default" claim and fix each:- [`docs/mcp-studio.md`](#sec-278),- [`docs/mcp-3d-studio.md`](#sec-275), the tool descriptions the+ [`docs/mcp-studio.md`](#sec-279),+ [`docs/mcp-3d-studio.md`](#sec-276), the tool descriptions theMCP server itself returns in `tools/list` (check `tools.js` tool metadata strings),and `apps-sdk/README.md`.3. Make sure the tool's own `description` string returned to ChatGPT is accurate, so@@ -71494,13 +71601,13 @@ and a doc claiming it works.----<a id="sec-315"></a>+<a id="sec-316"></a>> **Source:** `docs/openai-pr/04-openai-surface-test-coverage.md` · [↑ table of contents](#table-of-contents)# Task 04 — Close the test gaps on the ChatGPT-facing surface (P1)-Read [`00-START-HERE.md`](#sec-311) first.+Read [`00-START-HERE.md`](#sec-312) first.## The problem@@ -71580,13 +71687,13 @@ exported per the file). Use an existing JSON-schema/OpenAPI validator already in----<a id="sec-316"></a>+<a id="sec-317"></a>> **Source:** `docs/openai-pr/05-custom-gpt-openapi-serving.md` · [↑ table of contents](#table-of-contents)# Task 05 — Serve the custom-GPT OpenAPI and align legal URLs (P1)-Read [`00-START-HERE.md`](#sec-311) first. Coordinate with Task 02 (the+Read [`00-START-HERE.md`](#sec-312) first. Coordinate with Task 02 (theserved schema must be payment-free) and Task 04 (a contract test binds to it).## The problem (verified, with evidence)@@ -71669,13 +71776,13 @@ be normalized to one canonical form.----<a id="sec-317"></a>+<a id="sec-318"></a>> **Source:** `docs/openai-pr/06-docs-accuracy-reconciliation.md` · [↑ table of contents](#table-of-contents)# Task 06 — Fix doc accuracy and reconcile the tool-count story (P1)-Read [`00-START-HERE.md`](#sec-311) first. This task cleans up the+Read [`00-START-HERE.md`](#sec-312) first. This task cleans up thedocumentation drift the audit found, EXCEPT the two docs owned by other tasks(`apps-sdk/README.md` was Task 01, already landed on 2026-07-18; the `forge_free` tierclaim is Task 03). Do not fight those tasks for those specific edits; coordinate.@@ -71751,13 +71858,13 @@ claim is Task 03). Do not fight those tasks for those specific edits; coordinate----<a id="sec-318"></a>+<a id="sec-319"></a>> **Source:** `docs/openai-pr/07-final-verification-and-submit.md` · [↑ table of contents](#table-of-contents)# Task 07 — Final live verification and submit checklist (P2, runs last)-Read [`00-START-HERE.md`](#sec-311) first. **Run this only after tasks+Read [`00-START-HERE.md`](#sec-312) first. **Run this only after tasks01-06 are merged.** This is the go/no-go gate before the app is submitted to OpenAI.## Purpose@@ -71845,7 +71952,7 @@ go/no-go report. Do not submit; prepare so the human's final submit is one actio----<a id="sec-319"></a>+<a id="sec-320"></a>> **Source:** `docs/oracle-trading-mcp-plan.md` · [↑ table of contents](#table-of-contents)@@ -72065,7 +72172,7 @@ Per the documentation rules in `CLAUDE.md`, all of these apply and none are opti### Phase 5: the X post-Draft lives at [`docs/oracle-trading-mcp-x-post.md`](#sec-538). Written before+Draft lives at [`docs/oracle-trading-mcp-x-post.md`](#sec-540). Written beforethe work ships so the announcement shapes the scope rather than the reverse: if a claim in thatpost is not true when the phases are done, the phases are not done.@@ -72099,7 +72206,7 @@ than shipping late.----<a id="sec-320"></a>+<a id="sec-321"></a>> **Source:** `docs/oracle.md` · [↑ table of contents](#table-of-contents)@@ -72503,7 +72610,7 @@ The more data we watch, the sharper every score. Oracle is live now.----<a id="sec-321"></a>+<a id="sec-322"></a>> **Source:** `docs/overlay-audit.md` · [↑ table of contents](#table-of-contents)@@ -72674,7 +72781,7 @@ only worth calling from a test.----<a id="sec-322"></a>+<a id="sec-323"></a>> **Source:** `docs/package-extraction.md` · [↑ table of contents](#table-of-contents)@@ -72803,7 +72910,7 @@ part of the extraction itself: extract and publish first, swap the import later.----<a id="sec-323"></a>+<a id="sec-324"></a>> **Source:** `docs/partners.md` · [↑ table of contents](#table-of-contents)@@ -72811,7 +72918,7 @@ part of the extraction itself: extract and publish first, swap the import later.`three.ws/partners` is the public map of the cloud, AI, hardware, infrastructure, and media programmes three.ws takes part in. This doc is the developer-facing companion to that page: for each surface it says what the integration actually **is**, at the status the page and the per-partner docs claim, and links the doc that goes deeper.-Page source: [`pages/partners.html`](../pages/partners.html). Partnership enquiries go to **[email protected]** (the page's "Become a partner" call to action). Press and brand requests go to **[email protected]**, covered in [Press kit](#sec-338).+Page source: [`pages/partners.html`](../pages/partners.html). Partnership enquiries go to **[email protected]** (the page's "Become a partner" call to action). Press and brand requests go to **[email protected]**, covered in [Press kit](#sec-340).**Read the status labels literally.** Each card carries a one-word tier chip that is a category, not a rank: Select Partner, Strategic, Cloud, Inception, Media, Infrastructure. Nothing on the page grants an endorsement, and several of the docs below carry explicit "this is not an endorsement" language that must survive any rewrite.@@ -72821,14 +72928,14 @@ Page source: [`pages/partners.html`](../pages/partners.html). Partnership enquir| Partner | Chip on the card | Card links to | Deeper docs ||---|---|---|---|-| OpenAI | Select Partner | `/openai` | [MCP 3D Studio (free)](#sec-278), [3D Studio (paid)](#sec-275), [Custom GPT config](#sec-138), [AR in ChatGPT](#sec-139), [Spatial MCP](#sec-400) |-| IBM | Strategic | `/blog/three-ws-ibm-business-partner` | [IBM watsonx and Granite](#sec-253), [IBM Granite x402 MCP](#sec-252) |+| OpenAI | Select Partner | `/openai` | [MCP 3D Studio (free)](#sec-279), [3D Studio (paid)](#sec-276), [Custom GPT config](#sec-138), [AR in ChatGPT](#sec-139), [Spatial MCP](#sec-402) |+| IBM | Strategic | `/blog/three-ws-ibm-business-partner` | [IBM watsonx and Granite](#sec-254), [IBM Granite x402 MCP](#sec-253) || Amazon Web Services | Cloud | `/aws` | [AWS Marketplace](#sec-123), [listing kit](#sec-122), [partner spotlight](#sec-124) || Google Cloud | Cloud | `/blog/three-ws-google-cloud-partnership` | [Production runbook](ops/gcp-production.md), [credits plan](ops/gcp-credits-plan.md), [model workers](ops/gcp-model-workers.md) |-| Alibaba Cloud | Cloud | `/blog/three-ws-alibaba-cloud-partnership` | [Listings and distribution](#sec-269), [the model router](#sec-130) |-| NVIDIA | Inception | `/nvidia` | [NVIDIA Inception](#sec-300), [NVIDIA models](#sec-301), [Nemotron spotlight](#sec-303) |-| HackerNoon | Media | `/blog/three-ws-hackernoon-partnership` | [Syndication](#sec-407), [Listings and distribution](#sec-269) |-| Quicknode | Infrastructure | `/blog/three-ws-quicknode-startup-program` | [Solana integration](#sec-399), [Listings and distribution](#sec-269) |+| Alibaba Cloud | Cloud | `/blog/three-ws-alibaba-cloud-partnership` | [Listings and distribution](#sec-270), [the model router](#sec-130) |+| NVIDIA | Inception | `/nvidia` | [NVIDIA Inception](#sec-301), [NVIDIA models](#sec-302), [Nemotron spotlight](#sec-304) |+| HackerNoon | Media | `/blog/three-ws-hackernoon-partnership` | [Syndication](#sec-409), [Listings and distribution](#sec-270) |+| Quicknode | Infrastructure | `/blog/three-ws-quicknode-startup-program` | [Solana integration](#sec-401), [Listings and distribution](#sec-270) |The page's stat bar reads 8 partners, 22 chains, and an infinity glyph for scale. It is marked `aria-hidden` and is decorative framing, not a metric to quote.@@ -72840,13 +72947,13 @@ The page's stat bar reads 8 partners, 22 chains, and an infinity glyph for scale**What the integration is.**-- **The keyless connector** at `https://three.ws/api/mcp-studio` is a free MCP server exposing only 3D generation tools: no account, no payment, no API key, no wallet, no token. That is the surface submitted to the ChatGPT App Directory. See [MCP 3D Studio](#sec-278).-- **The paid sibling** at `https://three.ws/api/mcp-3d` is a separate server with rigging, animation, retexturing, and analysis, authenticated by OAuth 2.1 or paid per call over x402. It shares none of the keyless server's surface. See [3D Studio MCP](#sec-275).+- **The keyless connector** at `https://three.ws/api/mcp-studio` is a free MCP server exposing only 3D generation tools: no account, no payment, no API key, no wallet, no token. That is the surface submitted to the ChatGPT App Directory. See [MCP 3D Studio](#sec-279).+- **The paid sibling** at `https://three.ws/api/mcp-3d` is a separate server with rigging, animation, retexturing, and analysis, authenticated by OAuth 2.1 or paid per call over x402. It shares none of the keyless server's surface. See [3D Studio MCP](#sec-276).- **The custom GPT** in the GPT Store calls an Actions contract served from `/.well-known/3d-studio-openapi.yaml`. Its builder configuration is checked in, because the GPT itself is configured by hand: [Custom GPT config](#sec-138).- **AR handoff** works from any of these: every generation carries a place-in-your-room link, and the whole pipeline is public and keyless rather than ChatGPT-exclusive. See [AR in ChatGPT](#sec-139).-- **Spatial MCP** is the open, CC0 response shape that makes a 3D scene a native MCP result instead of a URL in text. three.ws is the reference implementation; the shape is renderer-agnostic and carries no payment, wallet, or coin surface. See [Spatial MCP](#sec-400).+- **Spatial MCP** is the open, CC0 response shape that makes a 3D scene a native MCP result instead of a URL in text. three.ws is the reference implementation; the shape is renderer-agnostic and carries no payment, wallet, or coin surface. See [Spatial MCP](#sec-402).-**Saying it correctly.** Write the status as "OpenAI Select Partner". three.ws is an independent member of the network at the Select tier: not an OpenAI product, and not endorsed by OpenAI beyond the partner designation. Badge rules, the required independence line, and every asset are in [`marketing/openai-select-partner/badge-usage.md`](../marketing/openai-select-partner/badge-usage.md); the graphics cleared for editorial use are in [Press kit](#sec-338). The pre-submission verification pack is [`docs/openai-pr/00-START-HERE.md`](#sec-311).+**Saying it correctly.** Write the status as "OpenAI Select Partner". three.ws is an independent member of the network at the Select tier: not an OpenAI product, and not endorsed by OpenAI beyond the partner designation. Badge rules, the required independence line, and every asset are in [`marketing/openai-select-partner/badge-usage.md`](../marketing/openai-select-partner/badge-usage.md); the graphics cleared for editorial use are in [Press kit](#sec-340). The pre-submission verification pack is [`docs/openai-pr/00-START-HERE.md`](#sec-312).---@@ -72854,9 +72961,9 @@ The page's stat bar reads 8 partners, 22 chains, and an infinity glyph for scale**What the page claims.** three.ws 3D agent identity and x402 payment rails integrate with IBM watsonx and IBM Granite. Agents run enterprise AI models while maintaining on-chain identity and executing real micropayments, all from a single agent profile. Card tags: watsonx.ai, Granite, x402, MCP.-**What the integration is.** Agents can think on IBM Granite foundation models served through IBM watsonx.ai, using your own IBM Cloud credentials. On top of that runtime sit the Granite-backed API surfaces (avatar brain, Guardian trust layer, TimeSeries forecasting, digital twin, semantic discovery, vision) and an MCP server, all documented in [IBM watsonx and Granite](#sec-253). [IBM Granite x402 MCP](#sec-252) covers the pay-per-call path: an MCP client reaches Granite inference and settles per call in stablecoin from a wallet it already controls, with no IBM Cloud account of its own.+**What the integration is.** Agents can think on IBM Granite foundation models served through IBM watsonx.ai, using your own IBM Cloud credentials. On top of that runtime sit the Granite-backed API surfaces (avatar brain, Guardian trust layer, TimeSeries forecasting, digital twin, semantic discovery, vision) and an MCP server, all documented in [IBM watsonx and Granite](#sec-254). [IBM Granite x402 MCP](#sec-253) covers the pay-per-call path: an MCP client reaches Granite inference and settles per call in stablecoin from a wallet it already controls, with no IBM Cloud account of its own.-**The caveat that must not be dropped.** [`docs/ibm.md`](#sec-253) states it plainly: three.ws is an IBM Business Partner, but the public showcase is not the partnership. The `/api/ibm/*` tools are an independent set of developer tools built on IBM's publicly available Granite models. They are not official IBM partnership deliverables, not IBM products, and not endorsed by IBM. The formal partnership work is being built on the IBM platform and is not yet public. Never present the public demos as that work.+**The caveat that must not be dropped.** [`docs/ibm.md`](#sec-254) states it plainly: three.ws is an IBM Business Partner, but the public showcase is not the partnership. The `/api/ibm/*` tools are an independent set of developer tools built on IBM's publicly available Granite models. They are not official IBM partnership deliverables, not IBM products, and not endorsed by IBM. The formal partnership work is being built on the IBM platform and is not yet public. Never present the public demos as that work.Live product surfaces: `three.ws/ibm/hello` (the partnership page) and `three.ws/ibm/x402-demo` (the x402 live demo).@@ -72872,7 +72979,7 @@ Live product surfaces: `three.ws/ibm/hello` (the partnership page) and `three.ws- The `/partners` card says "Marketplace availability".- The `/aws` page badge says "AWS Partner, Software Path" and its hero says "Marketplace listing coming soon".-- [`docs/listings.md`](#sec-269) records AWS Marketplace as Live and three.ws as an AWS Partner.+- [`docs/listings.md`](#sec-270) records AWS Marketplace as Live and three.ws as an AWS Partner.- [`docs/aws-marketplace-listing-kit.md`](#sec-122) says the backend integration is built and deployed but the listing itself has not yet been created in the AWS Marketplace Management Portal.Do not resolve that spread by picking the strongest claim. If you need one sentence, the safe one is the one the product page uses: three.ws is an AWS Partner, and the Marketplace listing is coming. Longer-form pieces written for AWS channels are [partner spotlight](#sec-124), [MCP agents](#sec-120), and [Marketplace metering in front of x402](#sec-119).@@ -72885,7 +72992,7 @@ Do not resolve that spread by picking the strongest claim. If you need one sente**What the integration is.** Production runs on Google Cloud: one Cloud Run service serves the static frontend, the route table, and every API handler, with the crons on Cloud Scheduler and the GPU model workers on their own services. Vertex AI provides the Gemini and image lanes. The operational detail is in [production runbook](ops/gcp-production.md), [fleet and quota plan](ops/gcp-credits-plan.md), and [model workers](ops/gcp-model-workers.md).-**Programme status.** [`docs/listings.md`](#sec-269) records three.ws as a **member of Google Cloud for Web3 Startups**, with the programme backing compute and Vertex AI usage, and records Google Cloud Marketplace separately as **open to partnership** (no listing yet). The page card describes the technical dependency, not a marketplace listing; keep those two apart.+**Programme status.** [`docs/listings.md`](#sec-270) records three.ws as a **member of Google Cloud for Web3 Startups**, with the programme backing compute and Vertex AI usage, and records Google Cloud Marketplace separately as **open to partnership** (no listing yet). The page card describes the technical dependency, not a marketplace listing; keep those two apart.---@@ -72895,7 +73002,7 @@ Do not resolve that spread by picking the strongest claim. If you need one sente**What the integration is.** Qwen models are first-class lanes in the platform's multi-model brain router (`/api/brain/chat`), reached through DashScope alongside the other providers, so an agent can be pointed at a Qwen model the same way it is pointed at any other. See [the agent brain](#sec-130) for the router and the model ids.-**Listing status.** [`docs/listings.md`](#sec-269) records the Alibaba Cloud International Marketplace listing as **Live**, with a product listing, a storefront, and an editorial feature published on the Alibaba Cloud Marketplace blog. That doc holds the canonical links; treat it as the source of truth rather than restating URLs here.+**Listing status.** [`docs/listings.md`](#sec-270) records the Alibaba Cloud International Marketplace listing as **Live**, with a product listing, a storefront, and an editorial feature published on the Alibaba Cloud Marketplace blog. That doc holds the canonical links; treat it as the source of truth rather than restating URLs here.---@@ -72905,10 +73012,10 @@ Do not resolve that spread by picking the strongest claim. If you need one sente**What the integration is.** Two distinct things, and the docs keep them distinct:-- **Inception membership**, accepted July 2026. [NVIDIA Inception](#sec-300) states what membership adds (GPU credits, hardware access, engineering support) and where it shows up in the product.-- **The free hosted inference lane.** A large share of platform AI runs on NVIDIA-hosted models unlocked by a single `NVIDIA_API_KEY`, a rate-limited free tier with no per-model billing and no SLA, which is why the platform always keeps a fallback behind it. [NVIDIA models](#sec-301) is the canonical map of which model does what and where it is wired. Membership does not change that lane; it is how the platform scales past free-tier limits without giving up the free-first design.+- **Inception membership**, accepted July 2026. [NVIDIA Inception](#sec-301) states what membership adds (GPU credits, hardware access, engineering support) and where it shows up in the product.+- **The free hosted inference lane.** A large share of platform AI runs on NVIDIA-hosted models unlocked by a single `NVIDIA_API_KEY`, a rate-limited free tier with no per-model billing and no SLA, which is why the platform always keeps a fallback behind it. [NVIDIA models](#sec-302) is the canonical map of which model does what and where it is wired. Membership does not change that lane; it is how the platform scales past free-tier limits without giving up the free-first design.-[Nemotron spotlight](#sec-303) is a published community piece on building the text-to-3D pipeline on NIM. It is a developer-blog showcase, not a partnership document.+[Nemotron spotlight](#sec-304) is a published community piece on building the text-to-3D pipeline on NIM. It is a developer-blog showcase, not a partnership document.---@@ -72916,15 +73023,15 @@ Do not resolve that spread by picking the strongest claim. If you need one sente**What the page claims.** A builder-focused publishing partnership: feature articles, tutorials, and developer guides for people shipping with AI, published to HackerNoon's developer audience. Card tags: Publishing, Developer content.-**What the integration is.** Mechanical, and worth knowing if you write posts here: HackerNoon auto-imports from `https://three.ws/rss/announcements.xml`, polls roughly hourly, pulls every new item into the drafts queue, and publishes with canonical URLs pointing back to three.ws. There is no per-post action. Setup steps and the author-profile claim flow are in [Syndication](#sec-407); the listing row is in [Listings and distribution](#sec-269).+**What the integration is.** Mechanical, and worth knowing if you write posts here: HackerNoon auto-imports from `https://three.ws/rss/announcements.xml`, polls roughly hourly, pulls every new item into the drafts queue, and publishes with canonical URLs pointing back to three.ws. There is no per-post action. Setup steps and the author-profile claim flow are in [Syndication](#sec-409); the listing row is in [Listings and distribution](#sec-270).---## Quicknode-**What the page claims.** three.ws is a member of the Quicknode Startup Program with approved infrastructure credits. Quicknode's globally distributed RPC endpoints add capacity and redundancy to the chain access behind agent wallets, x402 settlement verification, and live Solana market data. Card tags: Solana RPC, Streams, Multi-chain. [`docs/listings.md`](#sec-269) records the programme as **accepted (2026-07)** with approved free infrastructure credits.+**What the page claims.** three.ws is a member of the Quicknode Startup Program with approved infrastructure credits. Quicknode's globally distributed RPC endpoints add capacity and redundancy to the chain access behind agent wallets, x402 settlement verification, and live Solana market data. Card tags: Solana RPC, Streams, Multi-chain. [`docs/listings.md`](#sec-270) records the programme as **accepted (2026-07)** with approved free infrastructure credits.-**What the integration is.** A rung in the Solana RPC failover chain, not the whole chain. Server-side calls build a chain across an explicit primary, keyed providers, operator-supplied fallbacks, keyless public endpoints, and a paid reserve tried last, rotating past anything rate-limited. [Solana integration](#sec-399) documents it, including the trap that matters operationally: never name the same endpoint as both the primary and the last-resort reserve, because the chain dedupes by URL and keeps the first occurrence, so the "reserve" silently absorbs all traffic.+**What the integration is.** A rung in the Solana RPC failover chain, not the whole chain. Server-side calls build a chain across an explicit primary, keyed providers, operator-supplied fallbacks, keyless public endpoints, and a paid reserve tried last, rotating past anything rate-limited. [Solana integration](#sec-401) documents it, including the trap that matters operationally: never name the same endpoint as both the primary and the last-resort reserve, because the chain dedupes by URL and keeps the first occurrence, so the "reserve" silently absorbs all traffic.---@@ -72932,7 +73039,7 @@ Do not resolve that spread by picking the strongest claim. If you need one senteWorth stating, because partner claims drift upward when nobody writes the boundary down:-- **No Intel, Microsoft, or Oracle programme appears on `/partners`.** [`docs/listings.md`](#sec-269) records Microsoft Azure Marketplace as **on roadmap**. Third-party model or component names that appear in the stack (for example the image-to-3D backends listed in [3D Studio MCP](#sec-275)) are technical dependencies, not partnerships.+- **No Intel, Microsoft, or Oracle programme appears on `/partners`.** [`docs/listings.md`](#sec-270) records Microsoft Azure Marketplace as **on roadmap**. Third-party model or component names that appear in the stack (for example the image-to-3D backends listed in [3D Studio MCP](#sec-276)) are technical dependencies, not partnerships.- **No tier is claimed beyond the chips on the cards.** "Strategic", "Cloud", "Media", and "Infrastructure" are groupings three.ws chose for its own page. Only two named programme statuses come from the partner: OpenAI Select Partner, and NVIDIA Inception member.- **No endorsement is claimed anywhere.** OpenAI, IBM, and NVIDIA all carry explicit independence language in their docs. Reproduce it.@@ -72946,14 +73053,14 @@ The page closes with four reasons, useful as the short pitch when someone asks:## Related-- [Press kit](#sec-338): marks, announcement graphics, boilerplate, and the rules for all of it-- [Listings and distribution](#sec-269): marketplaces, ecosystem directories, and media partners with per-listing status-- [Integrations](#sec-257): the catalog of ways to put an agent on a site you do not control-- [x402](#sec-552): the payment rail behind the agent-to-agent micropayments every partner surface references+- [Press kit](#sec-340): marks, announcement graphics, boilerplate, and the rules for all of it+- [Listings and distribution](#sec-270): marketplaces, ecosystem directories, and media partners with per-listing status+- [Integrations](#sec-258): the catalog of ways to put an agent on a site you do not control+- [x402](#sec-554): the payment rail behind the agent-to-agent micropayments every partner surface references----<a id="sec-324"></a>+<a id="sec-325"></a>> **Source:** `docs/partners/sperax-proposal.md` · [↑ table of contents](#table-of-contents)@@ -73001,7 +73108,7 @@ Both sides already ship for a living — this proposal only asks each of us to d----<a id="sec-325"></a>+<a id="sec-326"></a>> **Source:** `docs/pay-skills-listing.md` · [↑ table of contents](#table-of-contents)@@ -73102,7 +73209,7 @@ are supported.----<a id="sec-326"></a>+<a id="sec-327"></a>> **Source:** `docs/payment-sessions.md` · [↑ table of contents](#table-of-contents)@@ -73554,13 +73661,13 @@ curl -s $BASE/api/credits -H "$AUTH" | jq .balance_usd## Related-- [x402 Protocol](#sec-552): the challenge / verify / settle mechanics behind every paid call.-- [x402 Buyer Client](#sec-544): paying x402 endpoints from your own wallet instead of a session.-- [x402 Developer Tools](#sec-545): free echo / debug / receipt-verification tools for debugging a paid call.+- [x402 Protocol](#sec-554): the challenge / verify / settle mechanics behind every paid call.+- [x402 Buyer Client](#sec-546): paying x402 endpoints from your own wallet instead of a session.+- [x402 Developer Tools](#sec-547): free echo / debug / receipt-verification tools for debugging a paid call.----<a id="sec-327"></a>+<a id="sec-328"></a>> **Source:** `docs/permissions.md` · [↑ table of contents](#table-of-contents)@@ -73959,14 +74066,14 @@ Set `SMOKE_SKIP_REVOKE=1` to skip the on-chain revocation step if the test walle- [Architecture Overview](#sec-100)- [Agent System](#sec-064)- [ERC-8004 Blockchain Identity](#sec-190)-- [Skill System](#sec-392)+- [Skill System](#sec-394)- [EIP-7710](https://eips.ethereum.org/EIPS/eip-7710) — delegation envelope format- [EIP-7715](https://eips.ethereum.org/EIPS/eip-7715) — `wallet_grantPermissions` JSON-RPC method- [MetaMask Delegation Toolkit](https://docs.metamask.io/delegation-toolkit/)----<a id="sec-328"></a>+<a id="sec-329"></a>> **Source:** `docs/persona-hub.md` · [↑ table of contents](#table-of-contents)@@ -74363,7 +74470,154 @@ JWT claims:----<a id="sec-329"></a>+<a id="sec-330"></a>++> **Source:** `docs/pill-mascot.md` · [↑ table of contents](#table-of-contents)++# Rigging the pump.fun pill mascot++**[The pill](https://three.ws/pill) is a static capsule with four nubs that now walks, runs, waves, jumps and dances. This is how it got there, and how to do the same thing to a character our humanoid auto-rigger refuses.**++pump.fun verified $THREE as officially ours. The mascot they use is a rounded green-and-white capsule with a painted face, two stubby arms and two stubby legs, sculpted mid-stride. We rigged it and put it on a stage at [/pill](https://three.ws/pill).++The interesting part is not the result, it is why the normal path did not work and what replaced it. If you have a mascot, a logo character, a blob, a plush, or anything else that reads as a character to a person and as noise to a rigger, this page is for you.++**On this page:** [Why auto-rigging failed](#why-the-normal-path-failed) · [The pipeline](#the-pipeline) · [Running it](#running-it) · [What ships](#what-ships) · [Reusing it](#reusing-it-on-your-own-character)++Related: [the avatar pipeline](#sec-113) covers the normal humanoid path (generate, auto-rig, skin, animate). [Rig Doctor](#sec-376) tells you whether a finished `.glb` will actually animate here. [The 3D asset pipeline](#sec-002) covers FBX and GLB conversion upstream of all of it.++---++## Why the normal path failed++three.ws auto-rigs humanoids with Make-It-Animatable (`workers/rig`). It predicts joint positions for a 52-bone Mixamo skeleton from the shape of a body: a head on a neck, a torso, two long arms, two long legs, standing roughly upright.++The pill has none of those landmarks.++- **No neck and no separate head.** The white "head" is the top half of one continuous capsule. There is no narrowing anywhere for a neck predictor to find.+- **Nubs, not limbs.** Each arm is about 0.1 units thick and 0.47 long on a body 2.1 units tall. As a fraction of the figure, they are closer to fingers than to arms.+- **A sculpted action pose.** The right arm is thrown up beside the head, the right leg is kicked out to the side. Riggers expect a T-pose or an A-pose, and prediction quality falls apart away from one.+- **297,000 triangles.** Scan-quality density for a shape a hundredth of that describes exactly.++Feeding that to a humanoid predictor produces a skeleton in roughly the right bounding box and wrong everywhere that matters. So the pill got a purpose-built pipeline: [`scripts/rig-pill-mascot.py`](https://github.com/nirholas/three.ws/blob/main/scripts/rig-pill-mascot.py).++---++## The pipeline++### 1. Decimate first++[`scripts/decimate-glb.mjs`](https://github.com/nirholas/three.ws/blob/main/scripts/decimate-glb.mjs) takes the mesh from 296,962 triangles to 44,544 and the file from 12.58 MB to 1.68 MB, with no visible difference: the mascot's detail lives entirely in its texture, and quadric simplification is nearly free on a smooth organic surface.++Order matters. Simplification rewrites the vertex list, and skin weights are per-vertex, so decimating a rigged model destroys its rig. The script refuses to run on a mesh that already has `JOINTS_0`.++### 2. Find the limbs from the inside++The mesh is voxelized and its euclidean distance transform taken, which gives every interior voxel its distance to the surface: the shape's own thickness field. The body is everything thicker than a limb. Remove that and its fillet, and exactly four connected components are left over: the four nubs. No landmark detection, no template, no assumption about what a limb looks like.++The result is stable across a wide range of thresholds, which is the sign that the split is a real feature of the shape rather than a tuned constant.++### 3. Trace each nub back into the body++From each nub's tip, a minimum-cost path back to the body core (`skimage.graph.route_through_array`, with cost weighted to prefer thick interior) follows the limb's actual medial curve. That is how the mascot's bent foot ends up with a bent foot bone instead of a straight line through it, and how the knee lands where the leg actually bends.++Joints are then dropped along that curve: hip, knee, ankle, toe for legs; shoulder, elbow, wrist for arms, plus five three-joint finger chains inside each mitt.++### 4. Skin by what is inside, not what is nearby++This is the step that decides whether the rig looks rigged or looks melted.++In the sculpted pose, the mascot's raised hand rests **against the side of its head**. Straight-line distance says those two surfaces are neighbours. Geodesic distance through the mesh says the same thing, because they are touching. Skin either way and lowering the arm drags a crater across the cheek.++So membership is decided somewhere else entirely: each vertex climbs the thickness field's gradient inward until it reaches the medial axis of whatever part it is skin for. A hand vertex lands on the hand's axis. A cheek vertex lands on the body's. Those are half a body apart, and the head stays still.++That classification is a watershed, so it has hard edges. Two neighbouring vertices on the crotch webbing can climb to different ridges, and an unsmoothed seam tears into a fin the moment the leg swings. The classification is blurred across the surface before it is used, at a radius derived from the mesh's own vertex spacing so the same code behaves identically on the 300k-triangle original and its 45k-triangle decimation.++### 5. Bind mid-stride, rest standing++glTF stores the **bind pose** (inverse bind matrices) separately from the **rest pose** (node transforms), and three.ws's retargeter replays clip motion as a delta on the *rest* pose. A walk cycle applied on top of a mid-stride sculpt walks mid-stride: one arm stays in the air the whole time.++So the rigger binds against the sculpted pose, where the geometry actually is, solves a neutral standing pose, and bakes that pose into the shipped vertex positions. The file you download stands with its legs under its hips and its arms out, and its bind pose and rest pose are the same thing. Every clip after that starts from somewhere sane.++Blending a 50-degree leg correction closes the crevice between leg and belly, and linear blend skinning resolves a closing crevice by stretching it. The bake measures each vertex's neighbourhood before and after and relaxes only the vertices whose local spacing collapsed, leaving the 97% that posed cleanly untouched.++### 6. Animate for the proportions it has++Six clips ship inside the GLB: `idle`, `walk`, `run`, `wave`, `jump`, `dance`. They are authored as offsets from the rest pose, in code, against a mascot with nub limbs and no neck. A human mocap walk retargets onto this rig correctly and still looks wrong, because it was performed by something with knees.++`wave` deliberately returns the character to the pose it was sculpted in.++---++## Running it++The rigger needs a small scientific Python stack that is not part of the repo's npm tree:++```bash+pip install numpy scipy scikit-image trimesh pygltflib Pillow+```++Then, from the repo root:++```bash+# 1. Decimate the raw model (skip if yours is already reasonable)+node scripts/decimate-glb.mjs raw-mascot.glb public/avatars/my-mascot-static.glb --ratio=0.15++# 2. Rig it+python3 scripts/rig-pill-mascot.py public/avatars/my-mascot-static.glb \+ --out public/avatars/my-mascot.glb --debug-dir /tmp/rig-debug+```++`--debug-dir` writes two orthographic sheets, `sculpted.png` and `neutral.png`, with the skeleton drawn over the mesh in front, side and top view. Look at them before you look at the render: a joint in the wrong place is obvious there and ambiguous in a shaded viewport.++The run prints what it found, and those lines are the check that it understood the model:++```+ facing [0. 0. 1.] from 347 face pixels (painted 3.6 deg off axis)+ RightLeg root [-0.313 -0.364 -0.008] tip [-0.565 -0.844 0.016] r=0.136+ LeftArm root [ 0.359 -0.016 -0.008] tip [ 0.791 -0.22 0.028] r=0.100+ skeleton: 52 bones+ skinned: 46/52 bones carry weight above 2%+```++Forward is detected from the model's own texture: the eyes and mouth are the only near-black pixels on the head, so their centroid off the body axis gives the facing direction, snapped to the nearest world axis (the platform's convention is that avatars face +Z).++---++## What ships++`/avatars/pumpfun-pill-cupsey.glb`, 2.6 MB:++| | |+|---|---|+| Skeleton | 52 bones, `mixamorig:` names |+| Triangles | 44,544 |+| Clips | `idle`, `walk`, `run`, `wave`, `jump`, `dance` |+| Clip-library coverage | 100% (53 of 53 tracks map) |+| Validator | 0 errors |++The static input is kept beside it as `/avatars/pumpfun-pill-cupsey-static.glb` so the rig is reproducible from the repo.++The coverage number is the one that outlives this page. Because the skeleton uses the canonical bone names, [`src/glb-canonicalize.js`](https://github.com/nirholas/three.ws/blob/main/src/glb-canonicalize.js) maps every joint 1:1 and the whole three.ws clip library retargets onto the pill: it is not limited to the six clips it ships with. Load it in the [Animation Studio](https://three.ws/pose) and try any of them.++Finger chains are part of that. Thirty of the 53 tracks in every baked clip address a finger joint, and [`src/animation-retarget.js`](https://github.com/nirholas/three.ws/blob/main/src/animation-retarget.js) drops any clip whose coverage falls under 50%. A mascot with mitts still needs finger bones inside those mitts, or it throws away the entire library. They also give the mitt a soft squish when a clip curls a hand, which is a nicer result than the alternative.++---++## Reusing it on your own character++`scripts/rig-pill-mascot.py` is written for the capsule-with-nubs family, not for the pill specifically. Nothing in it is keyed to this model: no hardcoded joint positions, no baked-in dimensions, no character name. It will rig any mesh that satisfies these:++- **One body mass and exactly four limbs.** The limb finder expects four leftover components and stops with a clear error if it finds a different number. A five-limbed character needs the bone map extended; a two-limbed one needs the skeleton definition trimmed.+- **Limbs meaningfully thinner than the body.** The split is `thickness > 0.26` in model units by default (`BODY_THICKNESS`). A character whose arms are as thick as its torso has no such split to find.+- **A sealed surface.** Small holes are closed automatically before the flood fill; a hole you could see through is refused rather than guessed at.+- **A visible face.** Forward is read from dark pixels on the head. A character with no painted face falls back to +Z.++If your character is genuinely humanoid, do not use this. Use the [standard auto-rigger](#sec-113), which is a one-call API and better at humanoids than this script will ever be.++---++<a id="sec-331"></a>> **Source:** `docs/plan-checkout.md` · [↑ table of contents](#table-of-contents)@@ -74492,7 +74746,7 @@ Plan prices live in [api/payments/_config.js](../api/payments/_config.js) (`PLAN----<a id="sec-330"></a>+<a id="sec-332"></a>> **Source:** `docs/play-boot-performance.md` · [↑ table of contents](#table-of-contents)@@ -74502,7 +74756,7 @@ Plan prices live in [api/payments/_config.js](../api/payments/_config.js) (`PLANThat work is unavoidable. What *is* avoidable is paying for it at the wrong moment. This document records the boot-cost invariants that keep the first ten seconds fast, so a future change does not quietly undo one of them. Each section names the regression it prevents, because each of them actually shipped once and was measured on the live site.-Related docs: [how /play stays safe, honest, and light](#sec-332), [architecture](#sec-100).+Related docs: [how /play stays safe, honest, and light](#sec-334), [architecture](#sec-100).## How to measure before you claim anything@@ -74595,7 +74849,7 @@ Before shipping anything that touches `/play` boot:----<a id="sec-331"></a>+<a id="sec-333"></a>> **Source:** `docs/play-forge-in-world.md` · [↑ table of contents](#table-of-contents)@@ -74697,12 +74951,12 @@ layer, ownership checks, and the per-player object cap all apply without modific## Related- [3D asset pipeline](#sec-002): what the forge lanes are and how they differ-- [In-game economy](#sec-255): the rest of what you can do inside a `/play` world+- [In-game economy](#sec-256): the rest of what you can do inside a `/play` world- [/forge](https://three.ws/forge): the full studio, with paid tiers, rigging, and game-ready export----<a id="sec-332"></a>+<a id="sec-334"></a>> **Source:** `docs/play-hardening.md` · [↑ table of contents](#table-of-contents)@@ -74718,7 +74972,7 @@ It is also the surface with the least trusted input. Its entry URL is a link strEvery part of that URL, every display name a peer picks, and every field of the pump.fun coin metadata is text an attacker chose. This document records the invariants that keep the world safe and honest, so that a future change does not quietly undo one of them. Each section names the failure it prevents, because each of these actually shipped once.-Related docs: [in-game economy](#sec-255), [architecture](#sec-100), [security](#sec-380).+Related docs: [in-game economy](#sec-256), [architecture](#sec-100), [security](#sec-382).---@@ -74968,7 +75222,7 @@ The mobile harness is the one that catches memory regressions. It reports total----<a id="sec-333"></a>+<a id="sec-335"></a>> **Source:** `docs/play-live-events.md` · [↑ table of contents](#table-of-contents)@@ -75138,7 +75392,7 @@ Point it at another origin with `--base https://three.ws`.----<a id="sec-334"></a>+<a id="sec-336"></a>> **Source:** `docs/play-vehicles.md` · [↑ table of contents](#table-of-contents)@@ -75245,12 +75499,12 @@ and the metal-roughness map at 1024px, and writes## Related- [`/play` NPCs and world life](../src/game/npc/ambient-life.js) drives the ambient lane.-- [The in-game economy](#sec-255) covers what you earn on those delivery runs.-- [`/play` safety and lifecycle invariants](#sec-332).+- [The in-game economy](#sec-256) covers what you earn on those delivery runs.+- [`/play` safety and lifecycle invariants](#sec-334).----<a id="sec-335"></a>+<a id="sec-337"></a>> **Source:** `docs/popular-3d-github-repos.md` · [↑ table of contents](#table-of-contents)@@ -75513,7 +75767,7 @@ Apply a 3D-signal regex filter over `description + topics` and a denylist of non----<a id="sec-336"></a>+<a id="sec-338"></a>> **Source:** `docs/portfolio.md` · [↑ table of contents](#table-of-contents)@@ -75616,7 +75870,7 @@ responses are cached for about a minute per wallet.## Related surfaces-- [`/wallet`](#sec-494): your own custodial three.ws wallet.+- [`/wallet`](#sec-497): your own custodial three.ws wallet.- `/agent-wallet`: the agent wallet hub, whose Portfolio tab covers an agent'sholdings with FIFO cost basis and PnL attribution.- [`/api/crypto/wallet`](#sec-171): the raw balances endpoint this page@@ -75624,7 +75878,7 @@ responses are cached for about a minute per wallet.----<a id="sec-337"></a>+<a id="sec-339"></a>> **Source:** `docs/premium.md` · [↑ table of contents](#table-of-contents)@@ -75759,7 +76013,7 @@ tiers that remain free (news feed, digest, archive stats/trending).----<a id="sec-338"></a>+<a id="sec-340"></a>> **Source:** `docs/press-kit.md` · [↑ table of contents](#table-of-contents)@@ -75914,7 +76168,7 @@ Two rules that matter if you are laying out a story or a slide:The two extra OpenAI files inside the zip need more care than the two above. The short-phrasing card exists for one specific post and is not the general-purpose announcement graphic. The two-mark lockup uses OpenAI's logomark rather than the partner badge, which their brand guidelines govern separately, so a co-branded lockup is normally something a partner clears first. The full rules for every OpenAI asset in this repo are in [`marketing/openai-select-partner/badge-usage.md`](../marketing/openai-select-partner/badge-usage.md), with the announcement pack itself at [`marketing/openai-select-partner/README.md`](../marketing/openai-select-partner/README.md).-For the wider programme list and how to describe each one, see [Partner ecosystem](#sec-323).+For the wider programme list and how to describe each one, see [Partner ecosystem](#sec-324).---@@ -75932,14 +76186,14 @@ Use that inbox for anything the page does not cover: a format that is not here (## Related-- [Partner ecosystem](#sec-323): every programme three.ws is in, at the status it actually claims-- [Listings and distribution](#sec-269): marketplaces, directories, and media partners, with per-listing status+- [Partner ecosystem](#sec-324): every programme three.ws is in, at the status it actually claims+- [Listings and distribution](#sec-270): marketplaces, directories, and media partners, with per-listing status- [Brand asset renderer](../marketing/brand/README.md): where the marks come from and how to regenerate them- [Marketing campaigns](../marketing/README.md): announcement packs, social copy, and finished graphics----<a id="sec-339"></a>+<a id="sec-341"></a>> **Source:** `docs/procedural-animation.md` · [↑ table of contents](#table-of-contents)@@ -76115,7 +76369,7 @@ If you hit a rig whose bones do not resolve, the fix is a bone-name mapping in [----<a id="sec-340"></a>+<a id="sec-342"></a>> **Source:** `docs/provenance.md` · [↑ table of contents](#table-of-contents)@@ -76198,7 +76452,7 @@ Real hashing, real ed25519 signature, real on-chain write. Requires the issuer k----<a id="sec-341"></a>+<a id="sec-343"></a>> **Source:** `docs/pump-claims-channel.md` · [↑ table of contents](#table-of-contents)@@ -76355,7 +76609,7 @@ built yet.----<a id="sec-342"></a>+<a id="sec-344"></a>> **Source:** `docs/pump-fun-mcp-edge.md` · [↑ table of contents](#table-of-contents)@@ -76411,7 +76665,7 @@ Both runtimes import `TOOLS` from `src/pump/mcp-tools.js`, so the tool list expo----<a id="sec-343"></a>+<a id="sec-345"></a>> **Source:** `docs/pump-launch-repos.md` · [↑ table of contents](#table-of-contents)@@ -76510,7 +76764,7 @@ rate-limits under the ~450 txs a full run makes. Pass a dedicated `--rpc`----<a id="sec-344"></a>+<a id="sec-346"></a>> **Source:** `docs/pump-launcher.md` · [↑ table of contents](#table-of-contents)@@ -76519,7 +76773,7 @@ rate-limits under the ~450 txs a full run makes. Pass a dedicated `--rpc``POST /api/x402/pump-launch` launches a brand-new [pump.fun](https://pump.fun)token for an autonomous agent in a single paid request. The agent needs **noSOL, no wallet, and no three.ws account** — it pays a flat USDC fee over the-[x402](#sec-552) rail and the platform does the rest:+[x402](#sec-554) rail and the platform does the rest:- fronts the ~0.022 SOL bonding-curve deploy cost from a funded launcher keypair,- optionally grinds a **vanity mint address**,@@ -76611,7 +76865,7 @@ curl -X POST https://three.ws/api/x402/pump-launch \curl "https://three.ws/api/crypto/launches"```-See [x402 buyer client](#sec-544) for how to satisfy the 402 challenge in+See [x402 buyer client](#sec-546) for how to satisfy the 402 challenge incode.## Output@@ -76661,16 +76915,16 @@ token itself always deploys on **Solana mainnet** — pump.fun is mainnet-only.## Related-- [x402 paid endpoints](#sec-547) — the full catalog and pricing.+- [x402 paid endpoints](#sec-549) — the full catalog and pricing.- [Crypto Data API](#sec-180) — the free `symbol` and `launches`endpoints that bookend a launch.-- [Repo → Coin Launcher](#sec-343) — the batch/CLI launcher that+- [Repo → Coin Launcher](#sec-345) — the batch/CLI launcher thatroutes 100% of creator rewards to a GitHub identity (shares the same engine).-- [x402 protocol](#sec-552) — challenge/settle mechanics.+- [x402 protocol](#sec-554) — challenge/settle mechanics.----<a id="sec-345"></a>+<a id="sec-347"></a>> **Source:** `docs/pump-platform-fee.md` · [↑ table of contents](#table-of-contents)@@ -76731,7 +76985,7 @@ The fee is **never** charged silently. When `platform_fee_bps > 0`:----<a id="sec-346"></a>+<a id="sec-348"></a>> **Source:** `docs/pumpfun-program/README.md` · [↑ table of contents](#table-of-contents)@@ -76790,7 +77044,7 @@ tracked in `tasks/pumpfun-upstream/01-v2-trade-instructions-usdc-audit.md`.----<a id="sec-347"></a>+<a id="sec-349"></a>> **Source:** `docs/pumpfun-program/UPSTREAM-buy-sell-v2-announcement.md` · [↑ table of contents](#table-of-contents)@@ -76869,32 +77123,32 @@ Currently, no quote mint other than native SOL can be used to create or trade co- RUST crate: https://crates.io/crates/pump-rust-client## New docs-- Fee recipients: [docs/FEE_RECIPIENTS.md](#sec-353)-- Coin creation: [docs/instructions/COIN_CREATION.md](#sec-362)-- Buy: [docs/instructions/BUY.md](#sec-360)-- Sell: [docs/instructions/SELL.md](#sec-365)-- Claim cashback: [docs/instructions/CLAIM_CASHBACK.md](#sec-361)-- Collect creator fee: [docs/instructions/COLLECT_CREATOR_FEE.md](#sec-363)-- Creator fee sharing: [docs/instructions/CREATOR_FEE_SHARING.md](#sec-364)+- Fee recipients: [docs/FEE_RECIPIENTS.md](#sec-355)+- Coin creation: [docs/instructions/COIN_CREATION.md](#sec-364)+- Buy: [docs/instructions/BUY.md](#sec-362)+- Sell: [docs/instructions/SELL.md](#sec-367)+- Claim cashback: [docs/instructions/CLAIM_CASHBACK.md](#sec-363)+- Collect creator fee: [docs/instructions/COLLECT_CREATOR_FEE.md](#sec-365)+- Creator fee sharing: [docs/instructions/CREATOR_FEE_SHARING.md](#sec-366)## Other documentation-- [Pump Program](#sec-356)-- [PumpSwap](#sec-358)-- [PumpSwap SDK](#sec-359)-- [Pump Program creator fee update](#sec-355)-- [PumpSwap creator fee update](#sec-357)-- [FAQ](#sec-351)-- [Pump fee program docs](#sec-352)+- [Pump Program](#sec-358)+- [PumpSwap](#sec-360)+- [PumpSwap SDK](#sec-361)+- [Pump Program creator fee update](#sec-357)+- [PumpSwap creator fee update](#sec-359)+- [FAQ](#sec-353)+- [Pump fee program docs](#sec-354)-------<a id="sec-348"></a>+<a id="sec-350"></a>> **Source:** `docs/pumpfun-program/UPSTREAM-pumpswap-virtual-quote-reserves.md` · [↑ table of contents](#table-of-contents)@@ -77095,7 +77349,7 @@ Upstream: <https://github.com/pump-fun/pump-public-docs#pumpswap-update-virtual-----<a id="sec-349"></a>+<a id="sec-351"></a>> **Source:** `docs/pumpfun-program/docs/BREAKING_FEE_RECIPIENT.md` · [↑ table of contents](#table-of-contents)@@ -77169,7 +77423,7 @@ The new accounts can be passed before the program upgrade happens on Monday. The----<a id="sec-350"></a>+<a id="sec-352"></a>> **Source:** `docs/pumpfun-program/docs/CPI_README.md` · [↑ table of contents](#table-of-contents)@@ -77273,7 +77527,7 @@ pump-rust-client = { version = "...", path = "..." }----<a id="sec-351"></a>+<a id="sec-353"></a>> **Source:** `docs/pumpfun-program/docs/FAQ.md` · [↑ table of contents](#table-of-contents)@@ -77311,7 +77565,7 @@ is recommended to use a static big enough CU limit like `100_000`.----<a id="sec-352"></a>+<a id="sec-354"></a>> **Source:** `docs/pumpfun-program/docs/FEE_PROGRAM_README.md` · [↑ table of contents](#table-of-contents)@@ -77525,7 +77779,7 @@ If you implement the fee logic correctly, any future change to the fee tiers str----<a id="sec-353"></a>+<a id="sec-355"></a>> **Source:** `docs/pumpfun-program/docs/FEE_RECIPIENTS.md` · [↑ table of contents](#table-of-contents)@@ -77588,7 +77842,7 @@ Use one of these as `buybackFeeRecipient` for any coin.----<a id="sec-354"></a>+<a id="sec-356"></a>> **Source:** `docs/pumpfun-program/docs/PUMP_CASHBACK_README.md` · [↑ table of contents](#table-of-contents)@@ -77705,7 +77959,7 @@ To read unclaimed cashback for pump swap / Pump AMM program:----<a id="sec-355"></a>+<a id="sec-357"></a>> **Source:** `docs/pumpfun-program/docs/PUMP_CREATOR_FEE_README.md` · [↑ table of contents](#table-of-contents)@@ -77840,7 +78094,7 @@ we update the programs on Mainnet.----<a id="sec-356"></a>+<a id="sec-358"></a>> **Source:** `docs/pumpfun-program/docs/PUMP_PROGRAM_README.md` · [↑ table of contents](#table-of-contents)@@ -78041,7 +78295,7 @@ at https://solscan.io/account/EsmVk4MTsoT71JFaRM5DWFZboKpMQjfY6EYzAgUuksXw#accou----<a id="sec-357"></a>+<a id="sec-359"></a>> **Source:** `docs/pumpfun-program/docs/PUMP_SWAP_CREATOR_FEE_README.md` · [↑ table of contents](#table-of-contents)@@ -78150,7 +78404,7 @@ PumpSwap program on Mainnet to the coin creator fee update.----<a id="sec-358"></a>+<a id="sec-360"></a>> **Source:** `docs/pumpfun-program/docs/PUMP_SWAP_README.md` · [↑ table of contents](#table-of-contents)@@ -78384,7 +78638,7 @@ Each Anchor instruction has a set of corresponding autocomplete methods that can----<a id="sec-359"></a>+<a id="sec-361"></a>> **Source:** `docs/pumpfun-program/docs/PUMP_SWAP_SDK_README.md` · [↑ table of contents](#table-of-contents)@@ -78464,7 +78718,7 @@ to autocomplete the `base` and `quote` displayed amounts based on the `lpToken`----<a id="sec-360"></a>+<a id="sec-362"></a>> **Source:** `docs/pumpfun-program/docs/instructions/BUY.md` · [↑ table of contents](#table-of-contents)@@ -78525,7 +78779,7 @@ All `buy_v2` calls need a `feeRecipient` and a `buybackFeeRecipient`.- For mayhem mode coins, choose one of the 8 reserved fee recipients as `feeRecipient`.- For all coins, choose one of the 8 buyback fee recipients as `buybackFeeRecipient`.-See [Fee Recipients](#sec-353) for the full address lists.+See [Fee Recipients](#sec-355) for the full address lists.## TS SDK@@ -78642,7 +78896,7 @@ ixs.extend(----<a id="sec-361"></a>+<a id="sec-363"></a>> **Source:** `docs/pumpfun-program/docs/instructions/CLAIM_CASHBACK.md` · [↑ table of contents](#table-of-contents)@@ -78752,7 +79006,7 @@ let ix = sdk.claim_cashback_v2_instruction(----<a id="sec-362"></a>+<a id="sec-364"></a>> **Source:** `docs/pumpfun-program/docs/instructions/COIN_CREATION.md` · [↑ table of contents](#table-of-contents)@@ -78907,7 +79161,7 @@ let ixs = sdk----<a id="sec-363"></a>+<a id="sec-365"></a>> **Source:** `docs/pumpfun-program/docs/instructions/COLLECT_CREATOR_FEE.md` · [↑ table of contents](#table-of-contents)@@ -79009,13 +79263,13 @@ ixs.extend(sdk.collect_creator_fee_v2_instructions(----<a id="sec-364"></a>+<a id="sec-366"></a>> **Source:** `docs/pumpfun-program/docs/instructions/CREATOR_FEE_SHARING.md` · [↑ table of contents](#table-of-contents)# Creator Fee Sharing-> **Note:** These instructions only apply to coins that **have** a `sharing_config` — i.e. coins whose creator vault has been migrated to the Pump Fees program for multi-recipient distribution. For single-creator-recipient coins (no `sharing_config`), use [`collect_creator_fee_v2` / `collect_coin_creator_fee`](#sec-363) instead.+> **Note:** These instructions only apply to coins that **have** a `sharing_config` — i.e. coins whose creator vault has been migrated to the Pump Fees program for multi-recipient distribution. For single-creator-recipient coins (no `sharing_config`), use [`collect_creator_fee_v2` / `collect_coin_creator_fee`](#sec-365) instead.The lifecycle is:@@ -79363,7 +79617,7 @@ ixs.extend(sdk.distribute_creator_fees_v2_instructions(----<a id="sec-365"></a>+<a id="sec-367"></a>> **Source:** `docs/pumpfun-program/docs/instructions/SELL.md` · [↑ table of contents](#table-of-contents)@@ -79423,7 +79677,7 @@ All `sell_v2` calls need a `feeRecipient` and a `buybackFeeRecipient`.- For mayhem mode coins, choose one of the 8 reserved fee recipients as `feeRecipient`.- For all coins, choose one of the 8 buyback fee recipients as `buybackFeeRecipient`.-See [Fee Recipients](#sec-353) for the full address lists.+See [Fee Recipients](#sec-355) for the full address lists.## TS SDK@@ -79540,7 +79794,7 @@ ixs.extend(----<a id="sec-366"></a>+<a id="sec-368"></a>> **Source:** `docs/quick-start.md` · [↑ table of contents](#table-of-contents)@@ -79686,7 +79940,7 @@ The `brain` attribute turns the 3D viewer into a conversational agent:| `brain` | LLM model ID. Registered Claude IDs: `claude-sonnet-5`, `claude-opus-5`, `claude-sonnet-4-6`, `claude-opus-4-8`, `claude-opus-4-7`, `claude-opus-4-6`, `claude-haiku-4-5-20251001`, `claude-fable-5`, `claude-mythos-5` (restricted access). Free models (no key, routed through the platform proxy) are also accepted, e.g. `meta-llama/llama-3.3-70b-instruct:free`. Omit for a viewer-only display with no AI (provider `none`). || `instructions` | System prompt for the agent's personality and role. || `mode` | Layout mode: `inline` (flows with page content), `floating` (fixed bubble in a corner), `fullscreen`, or `section`. Default: `inline`. |-| `sign-language` | The avatar signs every reply in ASL fingerspelling plus its sign vocabulary (any value except `off`/`false` enables it; works at boot or toggled at runtime). See the [sign language guide](#sec-386). |+| `sign-language` | The avatar signs every reply in ASL fingerspelling plus its sign vocabulary (any value except `off`/`false` enables it; works at boot or toggled at runtime). See the [sign language guide](#sec-388). |The chat input and microphone button appear automatically when `brain` is set. The agent can play animations, look at the camera, and respond to voice input.@@ -79727,7 +79981,7 @@ The fastest path to an embeddable 3D experience is an iframe widget. Build one i| `passport` | On-chain identity card backed by ERC-8004. || `hotspot-tour` | Annotated 3D scenes with clickable points of interest. |-For the full widget API including `postMessage` events, see the [Widget docs](#sec-517).+For the full widget API including `postMessage` events, see the [Widget docs](#sec-520).---@@ -79829,14 +80083,14 @@ If you're embedding inside a sandboxed iframe, make sure the parent grants `allo## Next Steps- [Embedding Guide](#sec-188) — deep dive on attributes, events, and the JS API-- [Widget Types](#sec-517) — full reference for iframe embeds and postMessage+- [Widget Types](#sec-520) — full reference for iframe embeds and postMessage- [Agent System](#sec-064) — how the brain, memory, and skills layers work-- [REST API](#sec-096) and [JavaScript API](#sec-261) — backend and in-browser surfaces-- [SDK Reference](#sec-379) — `@three-ws/sdk`, `@three-ws/agent-ui`, `@three-ws/avatar`, `@three-ws/solana-agent`+- [REST API](#sec-096) and [JavaScript API](#sec-262) — backend and in-browser surfaces+- [SDK Reference](#sec-381) — `@three-ws/sdk`, `@three-ws/agent-ui`, `@three-ws/avatar`, `@three-ws/solana-agent`----<a id="sec-367"></a>+<a id="sec-369"></a>> **Source:** `docs/radar.md` · [↑ table of contents](#table-of-contents)@@ -79852,7 +80106,7 @@ API: `/api/pump/coin-intel` (feed, market pulse, per-coin detail). The detail dr## Why it exists-The most dangerous moment on pump.fun is the first minute, when the tape is thin and a bundle of bot wallets can manufacture the look of organic demand. A human cannot audit funder graphs and timing entropy in real time. The Coin Intelligence Engine does, on the live firehose, and Radar is its screener: a scannable board that turns raw first-90-seconds behaviour into a quality score and a short list of named risks, so you can filter out the coordinated launches and focus on the ones with a real crowd. It is the top of the [trading surfaces](#sec-420) funnel: Radar surfaces a launch worth a look, you watch it, and if it earns conviction you open it in [Mission Control](#sec-409) to act.+The most dangerous moment on pump.fun is the first minute, when the tape is thin and a bundle of bot wallets can manufacture the look of organic demand. A human cannot audit funder graphs and timing entropy in real time. The Coin Intelligence Engine does, on the live firehose, and Radar is its screener: a scannable board that turns raw first-90-seconds behaviour into a quality score and a short list of named risks, so you can filter out the coordinated launches and focus on the ones with a real crowd. It is the top of the [trading surfaces](#sec-423) funnel: Radar surfaces a launch worth a look, you watch it, and if it earns conviction you open it in [Mission Control](#sec-411) to act.## How it works@@ -79882,7 +80136,7 @@ The UI colors quality as Healthy at 70 and up, Mixed from 40 to 69, and High ris3. Press `/` to focus search and type a name, ticker, or mint. Press `g` or `l` to switch grid and list, `r` to refresh.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](#sec-409) to trade.+6. On a coin worth tracking, use Watch to add it to your [Watchlist](https://three.ws/watchlist), then open it in [Mission Control](#sec-411) to trade.## Examples@@ -79921,16 +80175,16 @@ console.log(clean.map((c) => `${c.symbol} q${c.quality_score}`));## Related-- [The trading surfaces: Radar, Mission Control, Live Trade Feed, Watchlist, Coin Intelligence](#sec-420)-- [Oracle: the conviction engine](#sec-320) fuses this intel into a single conviction score-- [Smart Money Radar](#sec-394) is the pedigree layer Radar surfaces inline-- [Mission Control](#sec-409) is where a Radar find gets traded+- [The trading surfaces: Radar, Mission Control, Live Trade Feed, Watchlist, Coin Intelligence](#sec-423)+- [Oracle: the conviction engine](#sec-321) fuses this intel into a single conviction score+- [Smart Money Radar](#sec-396) is the pedigree layer Radar surfaces inline+- [Mission Control](#sec-411) is where a Radar find gets traded- [Coin pages](#sec-145) 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)----<a id="sec-368"></a>+<a id="sec-370"></a>> **Source:** `docs/reasoning-ledger.md` · [↑ table of contents](#table-of-contents)@@ -80024,13 +80278,13 @@ The headline score (0 to 100) is derived only from reconciled outcomes, and the----<a id="sec-369"></a>+<a id="sec-371"></a>> **Source:** `docs/recurring-payments.md` · [↑ table of contents](#table-of-contents)# Recurring payments-A recurring payment moves a fixed amount of USDC out of your wallet on a schedule you choose, without you signing anything again. You sign one ERC-7710 permission (see [Permissions & Delegation](#sec-327)), the platform's hourly cron spends inside it, and every attempt it makes is written to a ledger you can read.+A recurring payment moves a fixed amount of USDC out of your wallet on a schedule you choose, without you signing anything again. You sign one ERC-7710 permission (see [Permissions & Delegation](#sec-328)), the platform's hourly cron spends inside it, and every attempt it makes is written to a ledger you can read.Two kinds of schedule ride the same rails:@@ -80196,13 +80450,13 @@ Definitions live in [api/\_lib/schema.sql](../api/_lib/schema.sql); the lifecycl## See also-- [Permissions & Delegation](#sec-327) for granting, scoping and revoking the signed permission a schedule spends-- [Payment sessions](#sec-326) for capped one-off agent spending that is not on a schedule+- [Permissions & Delegation](#sec-328) for granting, scoping and revoking the signed permission a schedule spends+- [Payment sessions](#sec-327) for capped one-off agent spending that is not on a schedule- [Agent wallets](#sec-072) for the wallet a subscription pays into----<a id="sec-370"></a>+<a id="sec-372"></a>> **Source:** `docs/remix.md` · [↑ table of contents](#table-of-contents)@@ -80399,12 +80653,12 @@ still recorded — the royalty leg reports `payout_unconfigured` instead of payi## Related-- [3D Studio (free) MCP](#sec-278) — the `refine_model` iteration tool.+- [3D Studio (free) MCP](#sec-279) — the `refine_model` iteration tool.- [The 3D pipeline](#sec-003) — how generation itself works.----<a id="sec-371"></a>+<a id="sec-373"></a>> **Source:** `docs/reputation-staking-market.md` · [↑ table of contents](#table-of-contents)@@ -80425,7 +80679,7 @@ Live surface: [/reputation/market](/reputation/market).## What the market pays forReputation is already attested on Solana as signed SPL-Memo envelopes indexed-into `solana_attestations` (see [docs/solana-reputation](#sec-398)).+into `solana_attestations` (see [docs/solana-reputation](#sec-400)).An agent's `threews.accept.v1`, `threews.task.v1`, `threews.validation.v1`,`threews.feedback.v1`, `threews.dispute.v1`, and `threews.revoke.v1` envelopesare its attested action history: work it shipped, validations it passed or@@ -80631,15 +80885,15 @@ Failure codes (`market_not_configured`, `mainnet_gated`, `tx_not_found`,## Related-- [Docs: Agent Reputation on Solana](#sec-398): the attestation+- [Docs: Agent Reputation on Solana](#sec-400): the attestationlayer the market reads.-- [Docs: Reputation System](#sec-372): the cross-chain reputation model.+- [Docs: Reputation System](#sec-374): the cross-chain reputation model.- [Reputation Explorer](/reputation): inspect any agent's score andattestations.----<a id="sec-372"></a>+<a id="sec-374"></a>> **Source:** `docs/reputation.md` · [↑ table of contents](#table-of-contents)@@ -80848,7 +81102,7 @@ GET /api/exploreSeparate from reputation scores, glTF validation results can also be recorded on-chain via the `ValidationRegistry`. A passing validation attests that the agent's 3D model meets the glTF specification as of a specific block timestamp. Validation history is shown on the agent's profile page alongside reputation data.-See the [Validation](#sec-507) documentation for details.+See the [Validation](#sec-510) documentation for details.---@@ -80861,7 +81115,7 @@ See the [Validation](#sec-507) documentation for details.----<a id="sec-373"></a>+<a id="sec-375"></a>> **Source:** `docs/restyle.md` · [↑ table of contents](#table-of-contents)@@ -80955,13 +81209,13 @@ Pass the returned `lineage` array back as `parent_lineage` on the next call to e## Related- [Avatar Studio](#sec-115): shares the same GLB optimize-and-validate path and material vocabulary.-- [Scene Composer](#sec-152) and [Scene Studio](#sec-378): arrange and edit restyled models in a full scene.-- [MCP tools reference](#sec-279): the paid `restyle_material` agent twin of this endpoint.+- [Scene Composer](#sec-152) and [Scene Studio](#sec-380): arrange and edit restyled models in a full scene.+- [MCP tools reference](#sec-280): the paid `restyle_material` agent twin of this endpoint.- [/forge](https://three.ws/forge): generate the models you bring here.----<a id="sec-374"></a>+<a id="sec-376"></a>> **Source:** `docs/rig-doctor.md` · [↑ table of contents](#table-of-contents)@@ -80975,7 +81229,7 @@ Everything runs in your browser. The file is read with `FileReader` and analysed**On this page:** [The problem](#the-problem-a-rig-that-loads-but-never-moves) · [Reading the verdict](#reading-the-verdict) · [Coverage](#coverage-which-limbs-will-move) · [The repair](#the-repair) · [Generated output](#generated-output) · [Conventions](#recognised-rig-conventions) · [The canonical skeleton](#the-canonical-skeleton) · [Programmatic use](#programmatic-use)-Related: [Avatar CLI](#sec-108) turns the generated manifest into a validated, hash-anchored file. The [web component reference](#sec-514) covers the `<agent-3d>` element the embed tab emits. [Asset pipeline](#sec-002) covers FBX and GLB conversion upstream of all of this.+Related: [Avatar CLI](#sec-108) turns the generated manifest into a validated, hash-anchored file. The [web component reference](#sec-517) covers the `<agent-3d>` element the embed tab emits. [Asset pipeline](#sec-002) covers FBX and GLB conversion upstream of all of this.---@@ -81192,7 +81446,7 @@ Your own file cannot be shared this way, because it never leaves your machine.----<a id="sec-375"></a>+<a id="sec-377"></a>> **Source:** `docs/risk-acknowledgment.md` · [↑ table of contents](#table-of-contents)@@ -81311,7 +81565,7 @@ above.----<a id="sec-376"></a>+<a id="sec-378"></a>> **Source:** `docs/robinhood-chain-markets.md` · [↑ table of contents](#table-of-contents)@@ -81403,16 +81657,16 @@ math; Chainlink feed prices are already multiplier-adjusted, so they're never re## Related surfaces-- [Market Data API](#sec-273) — the same paid-endpoint pattern (x402, `priceFor`,+- [Market Data API](#sec-274) — the same paid-endpoint pattern (x402, `priceFor`,service-catalog descriptor) applied to the rest of three.ws's market data.-- [Trust primitives](#sec-423) — score a Robinhood Chain wallet's cross-chain+- [Trust primitives](#sec-426) — score a Robinhood Chain wallet's cross-chainreputation before transacting with it.-- [x402 distribution](#sec-546) — how the paid portfolio endpoint gets discovered+- [x402 distribution](#sec-548) — how the paid portfolio endpoint gets discoveredacross the x402 ecosystem.----<a id="sec-377"></a>+<a id="sec-379"></a>> **Source:** `docs/sas-attestations.md` · [↑ table of contents](#table-of-contents)@@ -81422,7 +81676,7 @@ An attestation is a signed on-chain statement about a wallet or an agent (for exthree.ws issues two kinds of on-chain attestations on Solana:-- **Permissionless attestations** — general feedback, task lifecycle, dispute, and revoke events. Anyone can write them as SPL Memos (see [Solana reputation](#sec-398)).+- **Permissionless attestations** — general feedback, task lifecycle, dispute, and revoke events. Anyone can write them as SPL Memos (see [Solana reputation](#sec-400)).- **Credentialed attestations** — claims only three.ws or an authorized validator may make: that a wallet is verified, or that a validator audited an agent's task result. These use the [Solana Attestation Service (SAS)](https://attest.solana.com/) and are signed by the **three.ws authority wallet**.This page covers the authority wallet, the `SAS_AUTHORITY_SECRET` environment variable, bootstrapping the credential + schemas, and the API that issues them.@@ -81645,7 +81899,7 @@ Closing (revoking) an attestation is done server-side via `sasClose()` in [api/_----<a id="sec-378"></a>+<a id="sec-380"></a>> **Source:** `docs/scene-studio.md` · [↑ table of contents](#table-of-contents)@@ -81708,18 +81962,18 @@ A typical round trip from another studio:- [Scene Composer](#sec-152): the lighter avatar-plus-props arranger with Forge integration.- [Animation Studio](#sec-092): builds the animated GLBs Scene Studio records to video.-- [Restyle Studio](#sec-373): re-skin the models before or after composing them.+- [Restyle Studio](#sec-375): re-skin the models before or after composing them.- [3D asset pipeline](#sec-002): how GLB, glTF, and clip formats relate across the platform.----<a id="sec-379"></a>+<a id="sec-381"></a>> **Source:** `docs/sdk.md` · [↑ table of contents](#table-of-contents)# SDK & Library-This page is for developers who want to build with three.ws code in their own project, beyond pasting an embed snippet. If you just want a 3D agent on a page, start with the [web component](#sec-514); come here when you need to import classes, register agents on-chain, or build the bundles yourself. There are two distributable artifacts you can import:+This page is for developers who want to build with three.ws code in their own project, beyond pasting an embed snippet. If you just want a 3D agent on a page, start with the [web component](#sec-517); come here when you need to import classes, register agents on-chain, or build the bundles yourself. There are two distributable artifacts you can import:| Artifact | Package | Use case ||---|---|---|@@ -81812,7 +82066,7 @@ const viewer = new Viewer(document.getElementById('canvas-container'));viewer.load('https://three.ws/avatars/default.glb');```-Full attribute and event API is documented in [Web Component reference](#sec-514).+Full attribute and event API is documented in [Web Component reference](#sec-517).### loadManifest and normalize@@ -82155,7 +82409,7 @@ python3 -m http.server 8080----<a id="sec-380"></a>+<a id="sec-382"></a>> **Source:** `docs/security.md` · [↑ table of contents](#table-of-contents)@@ -82196,7 +82450,7 @@ Chat messages travel through `/api/chat`, which proxies to a configured LLM prov- Does not log message content- Returns the LLM stream directly to your browser-Conversation history lives in `localStorage` by default. Cloud memory sync is opt-in (see [Memory](#sec-284)).+Conversation history lives in `localStorage` by default. Cloud memory sync is opt-in (see [Memory](#sec-285)).### Wallet data@@ -82212,7 +82466,7 @@ The SIWE (Sign-In With Ethereum) flow signs a server-generated challenge — no| Mode | Where data lives | Privacy ||------|-----------------|---------|| `local` (default) | Browser `localStorage` | Device-only |-| `remote` | three.ws cloud storage, tied to your account | Opt-in cloud sync (see [Memory](#sec-284)) |+| `remote` | three.ws cloud storage, tied to your account | Opt-in cloud sync (see [Memory](#sec-285)) || `ipfs` | Public IPFS network | Public — use only for non-sensitive data || `encrypted-ipfs` | IPFS, encrypted before leaving the browser | Encrypted with your key; IPFS only sees ciphertext || `none` | Not persisted | Cleared on page unload |@@ -82517,7 +82771,7 @@ For validator misconduct (biased or falsified on-chain attestations), open a pub----<a id="sec-381"></a>+<a id="sec-383"></a>> **Source:** `docs/seed-quality.md` · [↑ table of contents](#table-of-contents)@@ -82802,13 +83056,13 @@ ticks start timing out, lower `SEED_CRON_VISION_MS` before turning it back off.- [Realism quality bench](../data/quality-bench/README.md): the regressionharness whose scorer this gate imports-- [The 3D viewer](#sec-511): what a published catalog entry has to render in+- [The 3D viewer](#sec-514): what a published catalog entry has to render in- [Production log triage](ops/production-log-triage.md): the operator runbookfor the seeding pipeline----<a id="sec-382"></a>+<a id="sec-384"></a>> **Source:** `docs/selfie-to-avatar.md` · [↑ table of contents](#table-of-contents)@@ -82901,12 +83155,12 @@ Request body: `name` (1-120, required), `photos` (1-6 image URLs or data URIs) *- [Avatar pipeline](#sec-113): the distinct Forge text-to-3D generation lane.- [Draft agent mint](#sec-182): the on-chain identity every finished reconstruction gets, the network flags, and the devnet proof script.- [Trait-based avatar builder](#sec-137): customize and dress the avatar after you scan it.-- [Talking Avatar Video](#sec-408) and [Lipsync](#sec-267): drive the finished avatar's mouth.+- [Talking Avatar Video](#sec-410) and [Lipsync](#sec-268): drive the finished avatar's mouth.- Pages: [/create/selfie](https://three.ws/create/selfie), [/create](https://three.ws/create), [/features/scan](https://three.ws/features/scan).----<a id="sec-383"></a>+<a id="sec-385"></a>> **Source:** `docs/share-and-embed.md` · [↑ table of contents](#table-of-contents)@@ -83013,14 +83267,14 @@ To customize the preview image, change the agent's thumbnail in the editor.## What's next-- **Make your agent smarter** → [Skills system](#sec-392)+- **Make your agent smarter** → [Skills system](#sec-394)- **Understand the technical embed options** → [Embedding guide](#sec-188)- **Payment and crypto questions** → [Do I need crypto?](#sec-180)-- **Give it a permanent on-chain address** → [Register on-chain](#sec-468)+- **Give it a permanent on-chain address** → [Register on-chain](#sec-471)----<a id="sec-384"></a>+<a id="sec-386"></a>> **Source:** `docs/shared-utilities.md` · [↑ table of contents](#table-of-contents)@@ -83240,7 +83494,7 @@ paused during an incident and never resumed, failed silently.----<a id="sec-385"></a>+<a id="sec-387"></a>> **Source:** `docs/showcase.md` · [↑ table of contents](#table-of-contents)@@ -83250,7 +83504,7 @@ paused during an incident and never resumed, failed silently.That filter is the whole point of the surface. The ERC-8004 registries hold plenty of agents that are only an address and a URI. The showcase answers a narrower question: which of them can actually be seen and embedded.-Live at [three.ws/showcase](https://three.ws/showcase). Related reading: [ERC-8004](#sec-190) for the identity standard itself, [on-chain deployments](#sec-177) for the live feed of every registration as it lands (with no avatar filter), and [on-chain agents](#sec-308) for registering one yourself.+Live at [three.ws/showcase](https://three.ws/showcase). Related reading: [ERC-8004](#sec-190) for the identity standard itself, [on-chain deployments](#sec-177) for the live feed of every registration as it lands (with no avatar filter), and [on-chain agents](#sec-309) for registering one yourself.Code: [api/showcase.js](../api/showcase.js). Data comes from `erc8004_agents_index`, populated by the `erc8004-crawl` cron.@@ -83311,12 +83565,12 @@ Each agent carries its on-chain identity plus explorer links resolved from the c- [ERC-8004](#sec-190): the identity standard behind every row here.- [On-chain deployments](#sec-177): the same registration stream without the 3D filter, including Solana Metaplex Core mints.-- [Deploy agents on-chain](#sec-308): how to register an agent so it can appear here.+- [Deploy agents on-chain](#sec-309): how to register an agent so it can appear here.- [Agent manifest](#sec-055): the metadata format whose 3D model field decides `has_3d`.----<a id="sec-386"></a>+<a id="sec-388"></a>> **Source:** `docs/sign-language.md` · [↑ table of contents](#table-of-contents)@@ -83484,7 +83738,7 @@ Best results: good light, hand in frame, one letter at a time, and hold the last## In your own site or app-The [web component](#sec-514) exposes signing as an attribute. Present at boot, or toggled at runtime, it does the same thing:+The [web component](#sec-517) exposes signing as an attribute. Present at boot, or toggled at runtime, it does the same thing:```html<script type="module" src="https://three.ws/agent-3d/1.5.2/agent-3d.js"></script>@@ -83829,13 +84083,13 @@ None of this replaces a human interpreter. It makes an avatar legible to signers- [examples/sign-language.html](../examples/sign-language.html), a runnable page with both integration paths- [Animation Studio](#sec-092), the Spell box, exports, and share links- [docs/animations.md](#sec-093), clip formats and the retarget engine-- [docs/web-component.md](#sec-514), every `<agent-3d>` attribute including `sign-language`+- [docs/web-component.md](#sec-517), every `<agent-3d>` attribute including `sign-language`- [workers/model-asl-recognition](../workers/model-asl-recognition/README.md), the recognition model and its licensing- [Motion Swap](https://three.ws/motion-swap), video motion capture, including hands----<a id="sec-387"></a>+<a id="sec-389"></a>> **Source:** `docs/signals.md` · [↑ table of contents](#table-of-contents)@@ -83936,20 +84190,20 @@ curl -s https://three.ws/api/signals/subscribe -H 'authorization: Bearer YOUR_TO- [Custody you can verify](#sec-172) - the spend caps, freeze, and audit trail the subscriber wallet pays and trades under- [Financial controls](#sec-223) - the plain-English rules and firewall the mirror respects-- [Oracle](#sec-320) - the conviction engine and its own follow/copy tier-- [x402](#sec-552) - the USDC payment protocol every signal settles over-- [Trader card](#sec-414) - the verified track record that regresses a feed's edge+- [Oracle](#sec-321) - the conviction engine and its own follow/copy tier+- [x402](#sec-554) - the USDC payment protocol every signal settles over+- [Trader card](#sec-417) - the verified track record that regresses a feed's edge- [/leaderboard](https://three.ws/leaderboard) - build a verified record, then publish a feed of your own----<a id="sec-388"></a>+<a id="sec-390"></a>> **Source:** `docs/site-performance.md` · [↑ table of contents](#table-of-contents)# What the site's load numbers are, and the four rules that keep them there-`/play` has [its own boot-cost document](#sec-330) because a coin world is a special case: a WebGL renderer, a physics solver and a multiplayer room all have to start before anything is playable. This document covers everything else. Every ordinary page on three.ws is a static HTML document plus a module graph, and the cost of opening one is almost entirely decided by four questions:+`/play` has [its own boot-cost document](#sec-332) because a coin world is a special case: a WebGL renderer, a physics solver and a multiplayer room all have to start before anything is playable. This document covers everything else. Every ordinary page on three.ws is a static HTML document plus a module graph, and the cost of opening one is almost entirely decided by four questions:1. How many bytes of JavaScript run before the page is usable?2. How much of the DOM does the browser lay out that nobody can see?@@ -84232,7 +84486,7 @@ Two things in the numbers above are real and are not being fixed by tuning:----<a id="sec-389"></a>+<a id="sec-391"></a>> **Source:** `docs/sketchfab.md` · [↑ table of contents](#table-of-contents)@@ -84322,7 +84576,7 @@ and [`api/_lib/sketchfab.js`](https://github.com/nirholas/three.ws/blob/main/api----<a id="sec-390"></a>+<a id="sec-392"></a>> **Source:** `docs/skill-bundles.md` · [↑ table of contents](#table-of-contents)@@ -84513,13 +84767,13 @@ agent's marketplace listing is the next step.## Related-- [Marketplace](#sec-274): how skills and assets are listed, bought, and settled+- [Marketplace](#sec-275): how skills and assets are listed, bought, and settled- [Agent skills](#sec-060): what a skill is in the first place- [Agent wallets](#sec-072): where a bundle's payment lands----<a id="sec-391"></a>+<a id="sec-393"></a>> **Source:** `docs/skill-royalties.md` · [↑ table of contents](#table-of-contents)@@ -84725,14 +84979,14 @@ whose pending balance clears $0.01, so nobody pays gas to move dust.## Related-- [Skills marketplace](#sec-392): publishing, pricing, and installing skills-- [x402 endpoints](#sec-547): every paid endpoint and who each one pays-- [Money map](#sec-291): how value moves across the whole platform-- [Remix royalties](#sec-370): the parallel royalty rail for 3D creations+- [Skills marketplace](#sec-394): publishing, pricing, and installing skills+- [x402 endpoints](#sec-549): every paid endpoint and who each one pays+- [Money map](#sec-292): how value moves across the whole platform+- [Remix royalties](#sec-372): the parallel royalty rail for 3D creations----<a id="sec-392"></a>+<a id="sec-394"></a>> **Source:** `docs/skills.md` · [↑ table of contents](#table-of-contents)@@ -85454,7 +85708,7 @@ Installing is free and instant (`POST /api/skills/:id/install`, sign-in required- **Knowledge skills load into your chats.** `/api/chat` reads your installed skills at request time (`api/_lib/installed-skills.js`) and injects their playbooks into the system prompt, so your agent follows them anywhere you chat signed-in on three.ws (the `/app` workspace included). Budgets keep prompts sane: newest 8 installs, 6k chars per skill, 24k total. Each reply's SSE `done` event lists the slugs that were in context as `skills_applied`.- **Your installed set is one API call away.** `GET /api/skills?installed=true` (authed) returns the full payload, `content` and `schema_json` included, so an external agent, MCP client, or script can hydrate itself from your library.-Paid skills price per *call*, not per install: the detail page shows an x402 endpoint (`GET /api/x402/skill-call?skill=<slug>`) any wallet can pay in USDC, settling to the author. The 402 challenge names the author's own wallet as the payee, so their share moves at settlement rather than being forwarded later, and Solana is offered first whenever the author has a Solana wallet. What the author keeps, where they watch it land, and how to verify a payout on-chain: [Skill royalties](#sec-391).+Paid skills price per *call*, not per install: the detail page shows an x402 endpoint (`GET /api/x402/skill-call?skill=<slug>`) any wallet can pay in USDC, settling to the author. The 402 challenge names the author's own wallet as the payee, so their share moves at settlement rather than being forwarded later, and Solana is offered first whenever the author has a Solana wallet. What the author keeps, where they watch it land, and how to verify a payout on-chain: [Skill royalties](#sec-393).Publish your own from the marketplace ("Publish a Skill") or `POST /api/skills` with `{ name, slug, description, category, tags, content }` (or `schema_json`).@@ -85494,13 +85748,13 @@ Those filters are also the page URL, so [/marketplace?tab=skills&tag=solana&sort- [Architecture Overview](#sec-100) — how skills fit into the agent runtime- [Agent System](#sec-064) — the protocol bus and built-in tool system-- [Web Component](#sec-514) — embedding agents and passing skill attributes+- [Web Component](#sec-517) — embedding agents and passing skill attributes- `specs/SKILL_SPEC.md` — the authoritative skill bundle specification- `specs/PERMISSIONS_SPEC.md` — ERC-7710/ERC-7715 delegation for fine-grained skill permissions----<a id="sec-393"></a>+<a id="sec-395"></a>> **Source:** `docs/smart-contracts.md` · [↑ table of contents](#table-of-contents)@@ -86158,7 +86412,7 @@ On Base at typical gas prices (~0.001 gwei base fee), an agent registration runs----<a id="sec-394"></a>+<a id="sec-396"></a>> **Source:** `docs/smart-money.md` · [↑ table of contents](#table-of-contents)@@ -86172,7 +86426,7 @@ API: `/api/pump/smart-money` (feed, leaderboard, per-coin, per-wallet). The coin## Why it exists-The single most predictive early signal on pump.fun is not the chart, it is who is buying. A wallet that has repeatedly entered coins that went on to graduate is worth watching; a wallet that dumps every launch it touches is worth avoiding. That information exists on chain, but nobody keeps a running scorecard in time. Smart Money Radar is that scorecard. It re-earns every wallet's reputation continuously from real outcomes, so a coin's "pedigree" is the buy-weighted track record of the wallets actually in it, and a wallet's rank is its own history of picking coins that graduated. This is the same proven-wallet ledger the WHO pillar of [Oracle](#sec-320) draws on, exposed as its own browsable surface.+The single most predictive early signal on pump.fun is not the chart, it is who is buying. A wallet that has repeatedly entered coins that went on to graduate is worth watching; a wallet that dumps every launch it touches is worth avoiding. That information exists on chain, but nobody keeps a running scorecard in time. Smart Money Radar is that scorecard. It re-earns every wallet's reputation continuously from real outcomes, so a coin's "pedigree" is the buy-weighted track record of the wallets actually in it, and a wallet's rank is its own history of picking coins that graduated. This is the same proven-wallet ledger the WHO pillar of [Oracle](#sec-321) draws on, exposed as its own browsable surface.## How it works@@ -86257,14 +86511,14 @@ for (const c of conviction.slice(0, 5)) {## Related-- [Oracle: the conviction engine](#sec-320) uses this proven-wallet ledger as its WHO pillar-- [The trading surfaces](#sec-420) map, including the Coin Intelligence cross-coin trader board-- [Coin Radar](#sec-367) and [Mission Control](#sec-409) surface the same pedigree read inline+- [Oracle: the conviction engine](#sec-321) uses this proven-wallet ledger as its WHO pillar+- [The trading surfaces](#sec-423) map, including the Coin Intelligence cross-coin trader board+- [Coin Radar](#sec-369) and [Mission Control](#sec-411) surface the same pedigree read inline- Pages: [/smart-money](https://three.ws/smart-money) · [/radar](https://three.ws/radar) · [/oracle](https://three.ws/oracle)----<a id="sec-395"></a>+<a id="sec-397"></a>> **Source:** `docs/sniper-autonomy.md` · [↑ table of contents](#table-of-contents)@@ -86337,7 +86591,7 @@ and position size. Reaching `trusted` unlocks five more (`TIER_UNLOCKS` inoutward only. An arm with no band set is already unrestricted and nothing herewill restrict it.- `initials_out_multiple` / `moonbag_min_pct`, the proactive- [take-initials ladder](#sec-418): recover the stake as soon as+ [take-initials ladder](#sec-421): recover the stake as soon asthe position hits 2x rather than waiting for an exit to trigger, and size themoon bag that keeps riding. Turned on only for an arm whose winnersdemonstrably run past its average exit. Note this is only the *early*@@ -86438,7 +86692,7 @@ tighter rather than rewarded for the hit rate.## Related- [Agent Sniper](#sec-061): the trading pipeline the arms run on-- [The 10 SOL trading experiment](#sec-418): the exit thesis the+- [The 10 SOL trading experiment](#sec-421): the exit thesis theladder implements- [`api/_lib/sniper-optimizer.js`](../api/_lib/sniper-optimizer.js): the tuningrules, tier-scaled@@ -86447,7 +86701,7 @@ tighter rather than rewarded for the hit rate.----<a id="sec-396"></a>+<a id="sec-398"></a>> **Source:** `docs/social-layer.md` · [↑ table of contents](#table-of-contents)@@ -86522,7 +86776,7 @@ a feed).> Source: [api/users/me/feed.js](../api/users/me/feed.js). Not to be confused> with `GET /api/feed`, the public Money Pulse ticker backed by Redis; see-> [Money Feed](#sec-289) for that one.+> [Money Feed](#sec-290) for that one.## Follow graph@@ -86673,16 +86927,16 @@ be replayed any time from the getting-started page.## Related pages-- [Money Feed](#sec-289): the value-movement ticker (`GET /api/feed`),+- [Money Feed](#sec-290): the value-movement ticker (`GET /api/feed`),a different feed from the activity feed documented here.-- [Remix economy](#sec-370): what happens after someone finds your model in+- [Remix economy](#sec-372): what happens after someone finds your model inthe feed or search.- [API reference: Social & Community](api-reference.md#social--community-api)for the full request/response contracts.----<a id="sec-397"></a>+<a id="sec-399"></a>> **Source:** `docs/solana-pumpfun.md` · [↑ table of contents](#table-of-contents)@@ -86845,7 +87099,7 @@ Studio config schema (validated in `widget-types.js`):## What's intentionally not included- **Long-lived SSE** — the feed handler runs a 90s bounded loop and lets the browser auto-reconnect; the Cloud Run request handlers aren't meant to hold a connection open indefinitely. For higher throughput, deploy the bot itself as a streaming service.-- **On-chain signal attestations**: pump.fun signals are off-chain rows only. The platform's SPL Memo attestation layer exists (see [Solana reputation](#sec-398)), but these crawled signals are not promoted into it; that remains a future step.+- **On-chain signal attestations**: pump.fun signals are off-chain rows only. The platform's SPL Memo attestation layer exists (see [Solana reputation](#sec-400)), but these crawled signals are not promoted into it; that remains a future step.- **Agent-as-signer** — the watch skills are read-only; they never sign transactions. The existing `pumpfun-create / -buy / -sell` skills cover signing flows.- **Anchor program for reputation** — still EVM-only on the on-chain path.@@ -86869,7 +87123,7 @@ The MCP client and cron crawler are unit-tested with mocked `fetch` and `sql`. E----<a id="sec-398"></a>+<a id="sec-400"></a>> **Source:** `docs/solana-reputation.md` · [↑ table of contents](#table-of-contents)@@ -86879,7 +87133,7 @@ How three.ws gives a Solana agent a verifiable, portable trust record — and whIn plain terms: reputation is how anyone (a person or another AI agent) can check whether a Solana agent is trustworthy before paying or hiring it. You can see any agent's trust grade right now in the [Agent Passport](/agent-passport.html), and query the same data over the API described below. This page explains where those numbers come from and how to write your own on-chain vouch.-This is the Solana companion to [Agent Reputation](#sec-056) (the why) and [ERC-8004](#sec-190) / [Reputation System](#sec-372) (the EVM how-to). If you haven't read those, start with [Agent Reputation](#sec-056) for the trust problem reputation solves. This page covers how that same problem is solved on Solana, where there is no canonical on-chain reputation registry to inherit.+This is the Solana companion to [Agent Reputation](#sec-056) (the why) and [ERC-8004](#sec-190) / [Reputation System](#sec-374) (the EVM how-to). If you haven't read those, start with [Agent Reputation](#sec-056) for the trust problem reputation solves. This page covers how that same problem is solved on Solana, where there is no canonical on-chain reputation registry to inherit.---@@ -86955,7 +87209,7 @@ The crawler (`crawlAgentAttestations`) calls `getSignaturesForAddress(asset)` fr### Staked conviction is reported net, not gross-The `stake` block of the reputation response counts what is **still** staked. When a staker withdraws through the [Reputation Staking Market](#sec-371), the escrow writes a `threews.unstake.v1` memo naming that stake, and the conviction it expressed stops counting: withdrawn conviction is not conviction. Only the market escrow's own settlements retire anything, so a stranger cannot deflate an agent's standing with a memo naming somebody else's stake.+The `stake` block of the reputation response counts what is **still** staked. When a staker withdraws through the [Reputation Staking Market](#sec-373), the escrow writes a `threews.unstake.v1` memo naming that stake, and the conviction it expressed stops counting: withdrawn conviction is not conviction. Only the market escrow's own settlements retire anything, so a stranger cannot deflate an agent's standing with a memo naming somebody else's stake.The history is reported alongside the net figure rather than erased:@@ -87048,7 +87302,7 @@ In the agent card, both registrations sit side by side as CAIP-style references]```-**Reputation from the two chains is read separately, not mathematically merged.** A consumer that wants the full picture reads ERC-8004 (via the [`agent_reputation` MCP tool](#sec-372)) *and* the Solana reputation API, and weighs them itself. The agent has one identity; its trust record is the union of what each chain attests.+**Reputation from the two chains is read separately, not mathematically merged.** A consumer that wants the full picture reads ERC-8004 (via the [`agent_reputation` MCP tool](#sec-374)) *and* the Solana reputation API, and weighs them itself. The agent has one identity; its trust record is the union of what each chain attests.---@@ -87080,14 +87334,14 @@ The shapes differ; the purpose is identical — let an agent decide, before it p## Next- **[Read a Solana agent's reputation](/tutorials/solana-agent-reputation)** — open a Passport, read the grade, query the API, and leave an on-chain vouch.-- **[Reputation Staking Market](#sec-371)**: the market built directly on the attestations above. Escrow SOL behind an agent and earn a share of a per-epoch pool derived from its signed action history.+- **[Reputation Staking Market](#sec-373)**: the market built directly on the attestations above. Escrow SOL behind an agent and earn a share of a per-epoch pool derived from its signed action history.- **[Agent Reputation: why it matters](#sec-056)** — the trust problem both chains solve.-- **[Solana agents](#sec-399)** — registering an agent as a Metaplex Core asset.-- **[ERC-8004](#sec-190)** · **[Reputation System](#sec-372)** — the EVM side of the same idea.+- **[Solana agents](#sec-401)** — registering an agent as a Metaplex Core asset.+- **[ERC-8004](#sec-190)** · **[Reputation System](#sec-374)** — the EVM side of the same idea.----<a id="sec-399"></a>+<a id="sec-401"></a>> **Source:** `docs/solana.md` · [↑ table of contents](#table-of-contents)@@ -87099,7 +87353,7 @@ Technically, the flow mirrors the [ERC-8004](#sec-190) path on EVM chains: a useThis document covers what is supported today, the end-to-end registration flow, and what is intentionally **not** on Solana yet.-> Deploying many agents at once (server-side, into the three.ws Agents collection, with a live dashboard)? See [Deploy agents on-chain (bulk)](#sec-308).+> Deploying many agents at once (server-side, into the three.ws Agents collection, with a live dashboard)? See [Deploy agents on-chain (bulk)](#sec-309).---@@ -87112,16 +87366,16 @@ This document covers what is supported today, the end-to-end registration flow,| Solana payments (checkout + confirm) | Live | [api/payments/solana/\[action\].js](../api/payments/solana/[action].js) (handles `checkout` + `confirm`) || Agent identity NFT (Metaplex Core) | Live | [api/agents/solana/\[action\].js](../api/agents/solana/[action].js) (handles `register-prep` + `register-confirm`) || Agent record persisted in DB | Live | `agent_identities`, `meta.chain_type='solana'`, `meta.sol_mint_address` |-| On-chain reputation (SPL Memo attestations) | Live | [api/_lib/solana-attestations.js](../api/_lib/solana-attestations.js), aggregated by `/api/agents/solana-reputation` (see [Solana reputation](#sec-398)) |+| On-chain reputation (SPL Memo attestations) | Live | [api/_lib/solana-attestations.js](../api/_lib/solana-attestations.js), aggregated by `/api/agents/solana-reputation` (see [Solana reputation](#sec-400)) || On-chain validation (glTF/schema attestation) | Live | [api/_lib/solana-validation-attest.js](../api/_lib/solana-validation-attest.js), auto-run at register-confirm |-| Credentialed attestations (SAS) | Live | [api/agents/sas/\[action\].js](../api/agents/sas/[action].js) (see [SAS attestations](#sec-377)) |+| Credentialed attestations (SAS) | Live | [api/agents/sas/\[action\].js](../api/agents/sas/[action].js) (see [SAS attestations](#sec-379)) || Discovery file lists Solana agents | **Not yet** | [public/.well-known/agent-registration.json](../public/.well-known/agent-registration.json) publishes the platform card and x402 catalog, but its `registrations` array carries no per-agent Solana entries |---## How identity works on Solana-EVM agents are minted as ERC-721 NFTs in the IdentityRegistry contract at a fixed CREATE2 address. Solana has no CREATE2 and no shared registry contract. Instead each agent is a **Metaplex Core asset** (a single-account NFT standard with name + URI metadata baked in). When a three.ws Agents collection is configured for the network (`SOLANA_AGENT_COLLECTION_MAINNET` / `_DEVNET`), the asset is minted into that collection with the collection authority co-signing, so three.ws can curate on-chain metadata on the owner's behalf; with no collection configured, the mint falls back to a standalone asset. See [Deploy agents on-chain (bulk)](#sec-308) for the collection model.+EVM agents are minted as ERC-721 NFTs in the IdentityRegistry contract at a fixed CREATE2 address. Solana has no CREATE2 and no shared registry contract. Instead each agent is a **Metaplex Core asset** (a single-account NFT standard with name + URI metadata baked in). When a three.ws Agents collection is configured for the network (`SOLANA_AGENT_COLLECTION_MAINNET` / `_DEVNET`), the asset is minted into that collection with the collection authority co-signing, so three.ws can curate on-chain metadata on the owner's behalf; with no collection configured, the mint falls back to a standalone asset. See [Deploy agents on-chain (bulk)](#sec-309) for the collection model.The agent's canonical identifier on Solana is its **asset pubkey** (base58, 32-byte). The platform stores it alongside the mint transaction signature so the on-chain record can always be re-verified.@@ -87345,13 +87599,13 @@ There is no global Solana registry to query — discovery happens via the platfo## What's on Solana instead of a registry contract-- **Reputation**: there is no single `ReputationRegistry` contract like ERC-8004's. Instead, permissionless SPL Memo attestations (feedback, stakes, tasks, disputes) are written on-chain against the agent's asset pubkey, crawled into `solana_attestations`, and aggregated by `/api/agents/solana-reputation`. Off-chain pump.fun behavior signals land in `pumpfun_signals` and feed the same score. See [Solana reputation](#sec-398) and [solana-pumpfun.md](#sec-397).-- **Validation**: no registry contract either; validations are `threews.validation.v1` SPL Memo attestations (including the automatic glb-schema attestation at register-confirm), plus SAS credentialed validations signed by the platform authority ([SAS attestations](#sec-377)).+- **Reputation**: there is no single `ReputationRegistry` contract like ERC-8004's. Instead, permissionless SPL Memo attestations (feedback, stakes, tasks, disputes) are written on-chain against the agent's asset pubkey, crawled into `solana_attestations`, and aggregated by `/api/agents/solana-reputation`. Off-chain pump.fun behavior signals land in `pumpfun_signals` and feed the same score. See [Solana reputation](#sec-400) and [solana-pumpfun.md](#sec-399).+- **Validation**: no registry contract either; validations are `threews.validation.v1` SPL Memo attestations (including the automatic glb-schema attestation at register-confirm), plus SAS credentialed validations signed by the platform authority ([SAS attestations](#sec-379)).## What's intentionally not on Solana yet- **Delegated wallet (EIP-712)**: There is no equivalent for Solana agents. Owner = the wallet that signed the mint.-- **Cross-chain identifier**: EVM agents use `eip155:<chainId>:<registry>:<agentId>` (CAIP-10). The user-signed flow stores the asset pubkey directly; only the bulk deploy path records a CAIP-2-style `solana:<cluster-genesis>` chain id in `meta.onchain.chain` (see [onchain-agents.md](#sec-308)).+- **Cross-chain identifier**: EVM agents use `eip155:<chainId>:<registry>:<agentId>` (CAIP-10). The user-signed flow stores the asset pubkey directly; only the bulk deploy path records a CAIP-2-style `solana:<cluster-genesis>` chain id in `meta.onchain.chain` (see [onchain-agents.md](#sec-309)).- **Discovery**: `agent-registration.json` publishes the platform-level card and x402 catalog, but its `registrations` array does not list individual Solana agents. Adding them means defining a JSON schema for Metaplex Core assets; not done yet.A full ERC-8004-equivalent on Solana (Identity / Reputation / Validation as Anchor programs with a parallel JS client) remains a separate, larger piece of work; this document covers what ships today.@@ -87367,7 +87621,7 @@ A full ERC-8004-equivalent on Solana (Identity / Reputation / Validation as Anch----<a id="sec-400"></a>+<a id="sec-402"></a>> **Source:** `docs/spatial-mcp.md` · [↑ table of contents](#table-of-contents)@@ -87498,7 +87752,7 @@ Free 3D Studio (`structuredContent.spatial`): `forge_free`, `text_to_avatar`, `m----<a id="sec-401"></a>+<a id="sec-403"></a>> **Source:** `docs/specs/agent-trading.md` · [↑ table of contents](#table-of-contents)@@ -87585,7 +87839,7 @@ Real routes (no mocks), server-side guards with tests (including the $THREE-sell----<a id="sec-402"></a>+<a id="sec-404"></a>> **Source:** `docs/splat.md` · [↑ table of contents](#table-of-contents)@@ -87656,7 +87910,7 @@ Supported inputs at a glance:----<a id="sec-403"></a>+<a id="sec-405"></a>> **Source:** `docs/stage.md` · [↑ table of contents](#table-of-contents)@@ -87820,16 +88074,16 @@ The browser resolves the realtime server from, in order: `window.STAGE_SERVER_UR## Related- [Agent wallets](#sec-072): the host wallet a stage provisions at creation and receives tips into.-- [Lip-sync](#sec-267) and [Voice Lab](#sec-512): the speech and mouth-shape machinery the host performs with.+- [Lip-sync](#sec-268) and [Voice Lab](#sec-515): the speech and mouth-shape machinery the host performs with.- [Agent abilities](#sec-010): the always-on Stage Show variant that runs the same ShowDirector inside an agent's own screen.-- [Notifications](#sec-297): the go-live and tip notifications a stage emits.-- [Agora](#sec-075) and [IRL presence](#sec-259): the other rooms on the same realtime backbone, with the same presence discipline.+- [Notifications](#sec-298): the go-live and tip notifications a stage emits.+- [Agora](#sec-075) and [IRL presence](#sec-260): the other rooms on the same realtime backbone, with the same presence discipline.- [Multiplayer server](../multiplayer/README.md): how the room server is run and deployed.- Pages: [/agents](https://three.ws/agents) to find a host, [/club](https://three.ws/club) and [/theater](https://three.ws/theater) for the other live 3D venues.----<a id="sec-404"></a>+<a id="sec-406"></a>> **Source:** `docs/start-here.md` · [↑ table of contents](#table-of-contents)@@ -87863,9 +88117,9 @@ Think of it as giving your AI a body and a face. Instead of a plain text chatbox## Two kinds of people use three.ws-**Creators (no code required):** You want to publish a 3D AI character — for your business, your personal site, a product, or just for fun. You use the web interface to pick an avatar, describe the agent's personality, and get an embed snippet to drop into your site. Start with [Make your first agent →](#sec-272)+**Creators (no code required):** You want to publish a 3D AI character — for your business, your personal site, a product, or just for fun. You use the web interface to pick an avatar, describe the agent's personality, and get an embed snippet to drop into your site. Start with [Make your first agent →](#sec-273)-**Developers:** You want to build on top of the platform — integrate the `<agent-3d>` web component, write custom skills, call the REST API, or self-host the stack. Start with the [Introduction →](#sec-258) or [Quick start →](#sec-366)+**Developers:** You want to build on top of the platform — integrate the `<agent-3d>` web component, write custom skills, call the REST API, or self-host the stack. Start with the [Introduction →](#sec-259) or [Quick start →](#sec-368)---@@ -87889,11 +88143,11 @@ For a deeper explanation of how agents and avatars differ, see [Agents vs. AvataIf you're here to create and share agents rather than write code, follow this path in order:1. **[Agents vs. Avatars](#sec-073)** — understand the two core concepts (5 min read)-2. **[Make your first agent](#sec-272)** — create a 3D AI character in the browser, no code-3. **[Share & embed](#sec-383)** — get the embed snippet and put your agent anywhere+2. **[Make your first agent](#sec-273)** — create a 3D AI character in the browser, no code+3. **[Share & embed](#sec-385)** — get the embed snippet and put your agent anywhere4. **[Do I need crypto?](#sec-180)** — honest answers to the wallet and payment questions-Make something the community upvotes and it can reach beyond three.ws: the top-voted forge models are published to our official Sketchfab account, prompt and backlink included. See [Sketchfab showcase](#sec-389).+Make something the community upvotes and it can reach beyond three.ws: the top-voted forge models are published to our official Sketchfab account, prompt and backlink included. See [Sketchfab showcase](#sec-391).Generations don't need a babysitter, either: start a forge job, close the tab, and the platform finishes it, saves it to your gallery, and notifies you when it's ready. See [Background generation](#sec-225).@@ -87905,85 +88159,85 @@ Curious what happens between the prompt and the model? [How the Forge works](#se- **Just exploring?** → Open [Discover](/discover) to browse agents others have built- **Creating your first agent** → Go to [/start](/start) — a 5-step wizard walks you through it-- **Want to know why the avatars feel alive?** → [Procedural animation](#sec-339) — the runtime IK layers that run on top of the recorded clips: gaze that follows your cursor or meets your eyes, and feet that land on uneven ground instead of floating over it+- **Want to know why the avatars feel alive?** → [Procedural animation](#sec-341) — the runtime IK layers that run on top of the recorded clips: gaze that follows your cursor or meets your eyes, and feet that land on uneven ground instead of floating over it- **Want your agent to perform, not just react?** → [Choreography](#sec-140): compose gestures into a named routine on a real timeline at [/choreograph](https://three.ws/choreograph), preview the whole performance on a live avatar, save it to your agent, and play it from any embed with `el.playRoutine('welcome')`. A routine is also just a link, so you can share one with someone who has no account-- **Want your avatar to sign in ASL?** → Start with the 15-minute walkthrough, [Make your avatar sign](https://three.ws/tutorials/sign-with-your-avatar): type a phrase and watch it signed at [/sign-language](https://three.ws/sign-language), share it as a link (`?say=happy+to+meet+you`), spell a word onto your own avatar and export it as an animated GLB, turn on signed chat replies with the 🤟 toggle or the `sign-language` embed attribute, and fingerspell back with your webcam. The full reference is [Sign language](#sec-386)+- **Want your avatar to sign in ASL?** → Start with the 15-minute walkthrough, [Make your avatar sign](https://three.ws/tutorials/sign-with-your-avatar): type a phrase and watch it signed at [/sign-language](https://three.ws/sign-language), share it as a link (`?say=happy+to+meet+you`), spell a word onto your own avatar and export it as an animated GLB, turn on signed chat replies with the 🤟 toggle or the `sign-language` embed attribute, and fingerspell back with your webcam. The full reference is [Sign language](#sec-388)- **Wondering who the little character in the corner is?** → [The agent shell](#sec-059) — every visitor gets a named agent in the first five seconds (claim it to make it real), the ⌘K palette runs real commands (`forge …`, `digest`, `price btc`, `ask …`), and shell pages navigate without ever unloading your agent- **Want to drive your agent's computer yourself?** → [Take the wheel](#sec-058), every agent has a live screen you can watch on [/agent-screen](https://three.ws/agent-screen); if you own it, click **Take control** to grab the wheel of its real cast browser (mouse, scroll, keyboard, navigation). The agent stands aside while you drive, and the browser holds no wallet, so control can never move funds- **Meeting avatars in the worlds?** → Press <kbd>I</kbd> on anyone in `/play`, `/city`, a coin world, or `/agora` to see who they are — the [avatar inspector](#sec-112) shows their reputation, wallet, and profile-- **Running a live event in the world?** → [Live events in `/play`](#sec-333): one config file turns the `$THREE` home town into a place something is happening in: a countdown chip, an agenda drawer that knows what is on right now and what is next, a gold banner at every segment change, and a fireworks show every client renders identically from the wall clock without a single packet. Covers the config, the six phases, previewing without waiting for the date, and the browser audit to run before you go live+- **Running a live event in the world?** → [Live events in `/play`](#sec-335): one config file turns the `$THREE` home town into a place something is happening in: a countdown chip, an agenda drawer that knows what is on right now and what is next, a gold banner at every segment change, and a fireworks show every client renders identically from the wall clock without a single packet. Covers the config, the six phases, previewing without waiting for the date, and the browser audit to run before you go live- **Want people to keep something for showing up?** -> [Event souvenirs](#sec-218): everyone who walks into the event world while an event is live is handed a free commemorative wearable, kept forever, and once the window closes it is never granted again. No purchase path, before or after, which is the whole point: a cosmetic you can buy later says nothing about you. Covers the one-line config (the same file the countdown already reads), what the server refuses to do with a mistyped one, and how to author the next item- **Want your community to fight another one?** -> [Coin Wars](#sec-146): every coin world's plaza has a war portal showing that community's live Elo standing, its last battles, and any war running right now. Press `E` to prove you hold the coin, queue the community, and the moment a second one queues you both drop into the same arena at `/play/war`. Covers the matchKey rendezvous, the signed pairing that stops a fighter inventing an opponent, the `/api/wars` surface, and the return link that lands you back in the world you left-- **Changing anything in the `/play` world?** → [How `/play` stays safe, honest, and light](#sec-332): the invariants that keep the largest interactive surface on the platform from breaking. Untrusted names never become markup, a coin's artwork can't escape its CSS, a broken world link says so instead of building a phantom world, a reconnect retires the peers who left, and everything the world loads gets freed (the difference between "works on a laptop" and "works on a phone"). Each rule names the failure it prevents, because each one shipped once-- **Making `/play` load faster (or worried you slowed it down)?** → [Why `/play` opens fast, and how to keep it that way](#sec-330): the boot-cost invariants behind the heaviest page on the platform. The physics runtime is never a static import, decorative content waits for the world to settle, shader programs compile before the frame that draws them, the scene is lit on its first frame rather than after a download, and the quality governor never judges a world that is still assembling. Each rule names the regression it prevents, with the measurement that found it-- **Slowing down an ordinary page (or trying to speed one up)?** → [What the site's load numbers are, and the four rules that keep them there](#sec-388): the load-cost invariants for every page that is not `/play`. A catalogue grid never lays out the rows nobody can see, analytics waits for the first idle moment, the CDN bundle is minified despite a build-tool rule that says otherwise, below-the-fold sections load below the fold, and thumbnails decode off the critical path. Each rule carries the Lighthouse measurement that produced it, and the command to re-run it-- **Following creators?** → [The social layer](#sec-396): follow anyone from their `/u/:username` portfolio, watch their work land on [/feed](/feed), climb the [/rankings](/rankings) leaderboards with streaks and badges, get bell notifications for remixes, DMs, and coin graduations, and search everything at once on [/search](/search)-- **Placing agents in the real world?** → [IRL](#sec-259): pin an agent at a real GPS spot from your phone, and anyone who physically walks up can see it, talk to it, and pay it. Real crypto can be escrowed at places ([Money Drops](irl.md#money-drops)) and agents sign proofs that you were really there ([World Lines](irl.md#world-lines))-- **Making 3D models?** → [The free 3D Studio MCP](#sec-278) turns a prompt into a model, avatar, or rigged character — and lets you refine it by talking to it (*"make it metallic"*) with a revertable version history. Publish a model as remixable and earn on-chain royalties when others build on it: [the remix economy](#sec-370). Vote on the best community models and win the weekly board: [Forge-Off](#sec-226)+- **Changing anything in the `/play` world?** → [How `/play` stays safe, honest, and light](#sec-334): the invariants that keep the largest interactive surface on the platform from breaking. Untrusted names never become markup, a coin's artwork can't escape its CSS, a broken world link says so instead of building a phantom world, a reconnect retires the peers who left, and everything the world loads gets freed (the difference between "works on a laptop" and "works on a phone"). Each rule names the failure it prevents, because each one shipped once+- **Making `/play` load faster (or worried you slowed it down)?** → [Why `/play` opens fast, and how to keep it that way](#sec-332): the boot-cost invariants behind the heaviest page on the platform. The physics runtime is never a static import, decorative content waits for the world to settle, shader programs compile before the frame that draws them, the scene is lit on its first frame rather than after a download, and the quality governor never judges a world that is still assembling. Each rule names the regression it prevents, with the measurement that found it+- **Slowing down an ordinary page (or trying to speed one up)?** → [What the site's load numbers are, and the four rules that keep them there](#sec-390): the load-cost invariants for every page that is not `/play`. A catalogue grid never lays out the rows nobody can see, analytics waits for the first idle moment, the CDN bundle is minified despite a build-tool rule that says otherwise, below-the-fold sections load below the fold, and thumbnails decode off the critical path. Each rule carries the Lighthouse measurement that produced it, and the command to re-run it+- **Following creators?** → [The social layer](#sec-398): follow anyone from their `/u/:username` portfolio, watch their work land on [/feed](/feed), climb the [/rankings](/rankings) leaderboards with streaks and badges, get bell notifications for remixes, DMs, and coin graduations, and search everything at once on [/search](/search)+- **Placing agents in the real world?** → [IRL](#sec-260): pin an agent at a real GPS spot from your phone, and anyone who physically walks up can see it, talk to it, and pay it. Real crypto can be escrowed at places ([Money Drops](irl.md#money-drops)) and agents sign proofs that you were really there ([World Lines](irl.md#world-lines))+- **Making 3D models?** → [The free 3D Studio MCP](#sec-279) turns a prompt into a model, avatar, or rigged character — and lets you refine it by talking to it (*"make it metallic"*) with a revertable version history. Publish a model as remixable and earn on-chain royalties when others build on it: [the remix economy](#sec-372). Vote on the best community models and win the weekly board: [Forge-Off](#sec-226)- **Using ChatGPT?** → [AR in ChatGPT](#sec-139) is how a sentence typed into ChatGPT becomes a 3D model standing in your room, from the free generation lane to the one-tap AR link; [your first prompt to 3D](/tutorials/first-prompt-to-3d) walks you through it in five minutes-- **Making videos without showing your face?** → [Motion Swap](#sec-293) — upload a video of yourself and get it back with your 3D avatar performing your exact motion instead of you; pose tracking and masking run server-side, compositing and export happen in your browser at [/motion-swap](https://three.ws/motion-swap)-- **Want a support chat with a face on your own site?** → [Concierge](#sec-153) — a one-tag chat widget where a rigged 3D avatar lipsyncs streaming answers grounded in your live page, with voice in and out; [the build tutorial](#sec-433) shows how every part works+- **Making videos without showing your face?** → [Motion Swap](#sec-294) — upload a video of yourself and get it back with your 3D avatar performing your exact motion instead of you; pose tracking and masking run server-side, compositing and export happen in your browser at [/motion-swap](https://three.ws/motion-swap)+- **Want a support chat with a face on your own site?** → [Concierge](#sec-153) — a one-tag chat widget where a rigged 3D avatar lipsyncs streaming answers grounded in your live page, with voice in and out; [the build tutorial](#sec-436) shows how every part works- **Want a full-body avatar assistant on your site instead?** → [Assistant widget](#sec-101) — a launcher button opens an animated 3D character standing directly on your page (or a color/gradient), with a free-lane or bring-your-own-key chatbot and a speak mode that says whatever you type, out loud, in a speech bubble-- **Trading?** → [The trading surfaces](#sec-420) maps the solo stack (Radar, Coin Intelligence, Live Trade Feed, Watchlist, Mission Control); [trading arenas](#sec-416) covers tournaments, the theater, vaults, and swarms; [Oracle](#sec-320) is the conviction engine underneath all of it-- **Want your agent to trade for you?** → [Agent Sniper](#sec-061) — the full autonomous-trading pipeline (entry gates, the simulate-the-sell trade firewall, hash-chained decision ledger, exit ladder), with the audited case study of the platform's first live +42% trade; [arm one in minutes](#sec-430)+- **Trading?** → [The trading surfaces](#sec-423) maps the solo stack (Radar, Coin Intelligence, Live Trade Feed, Watchlist, Mission Control); [trading arenas](#sec-419) covers tournaments, the theater, vaults, and swarms; [Oracle](#sec-321) is the conviction engine underneath all of it+- **Want your agent to trade for you?** → [Agent Sniper](#sec-061) — the full autonomous-trading pipeline (entry gates, the simulate-the-sell trade firewall, hash-chained decision ledger, exit ladder), with the audited case study of the platform's first live +42% trade; [arm one in minutes](#sec-433)- **Wondering what stands between the chat agent and your wallet?** → [The agent runtime and transaction guard](#sec-057): every fund-moving tool call in /chat is preflighted through a seven-layer policy engine (blacklist, approval policy, dollar caps, spend envelope, MEV slippage clamp) before the wallet ever prompts, and the approval modal shows the verdict; the engine ships as [`@three-ws/agent-runtime`](../packages/agent-runtime) for your own agents-- **Curious how the trading fleet improves itself?** → [Earned autonomy](#sec-395), where each arm's own realized record decides how much rope it gets: wider tuning bounds, unlocked settings, a bigger share of the fleet budget, and a deeper evidence pack in front of its LLM judge, all re-earned continuously and none of it able to touch a safety rail-- **Trusting an agent with money?** → [Custody you can verify](#sec-172) — spend limits, freeze, Merkle proof-of-custody, and social recovery; [claim your wallet](#sec-414) turns any pump.fun track record into a public, provable Trader Card. Every real-funds feature sits behind the [risk acknowledgment](#sec-375) — read the [Risk Disclosure](https://three.ws/legal/risk) before committing anything-- **Need a track record another app can verify?** → [Trader Passport](#sec-415): the daily on-chain attestation of a trader's score, served as a public credential any terminal can fetch, pin, and re-check against Solana without trusting us. Includes a database-free verify endpoint and the committed-versus-live drift, so a stale snapshot can never pass as a current claim+- **Curious how the trading fleet improves itself?** → [Earned autonomy](#sec-397), where each arm's own realized record decides how much rope it gets: wider tuning bounds, unlocked settings, a bigger share of the fleet budget, and a deeper evidence pack in front of its LLM judge, all re-earned continuously and none of it able to touch a safety rail+- **Trusting an agent with money?** → [Custody you can verify](#sec-172) — spend limits, freeze, Merkle proof-of-custody, and social recovery; [claim your wallet](#sec-417) turns any pump.fun track record into a public, provable Trader Card. Every real-funds feature sits behind the [risk acknowledgment](#sec-377) — read the [Risk Disclosure](https://three.ws/legal/risk) before committing anything+- **Need a track record another app can verify?** → [Trader Passport](#sec-418): the daily on-chain attestation of a trader's score, served as a public credential any terminal can fetch, pin, and re-check against Solana without trusting us. Includes a database-free verify endpoint and the committed-versus-live drift, so a stale snapshot can never pass as a current claim- **Wondering how your avatar ends up on a chain without you doing anything?** → [Draft agent mint](#sec-182): every finished reconstruction is written to durable storage and minted as an inactive on-chain identity in the background, a Metaplex Core asset on Solana with an ERC-8004 registration behind its own flag. No wallet prompt, no fee, nothing to remember. Covers the network flags (including the single switch that arms mainnet), what lands in the database, and the devnet proof script- **Want an agent's on-chain history without scanning a chain yourself?** → [The agent index](#sec-054): the platform's own cross-chain index of agent registrations, token launches, reputation attestations, transfers and delegations, Solana first and EVM alongside it. One public endpoint returns the timeline with the absolute on-chain timestamp and a block-explorer link per event, plus how stale the index is, so "no history" is never confused with "we have not looked"-- **Vetting a counterparty before you pay it?** → [Trust primitives](#sec-423) — the cross-chain Agent Reputation endpoint scores ANY wallet, mint, or agent id (Solana or EVM) 0–100 from real on-chain evidence, in one paid call, before your agent transacts+- **Vetting a counterparty before you pay it?** → [Trust primitives](#sec-426) — the cross-chain Agent Reputation endpoint scores ANY wallet, mint, or agent id (Solana or EVM) 0–100 from real on-chain evidence, in one paid call, before your agent transacts- **Wondering where the platform's money goes?** → [The autonomous economy](#sec-104): how the on-chain treasury funds itself, the funding-root → engines → sweepback loop, the locks that keep every dollar inside platform-owned wallets, and the two leak scanners that audit every wallet on-chain every few minutes (as of 2026-07-12: 44,122 transactions scanned, zero leaks; the live totals stay re-derivable from each scanner's own cursor)-- **Publishing news, or wondering what we show of yours?** → [Publisher rights in the news reader](#sec-296) — three.ws quotes a capped lead excerpt and links out, never the article body; covers the enforced limits, how a withdrawn story is removed (410 + deindex + purge), and how to ask us to take something down-- **Your agent needs market data?** → [Market Data API](#sec-273) — the live feeds behind every /markets page (prices, TVL, yields, stablecoins, gas, derivatives, exploits) as 17 pay-per-call x402 endpoints from $0.001 USDC, plus the one-call `market-pulse` bundle; start at the free index [/api/x402/market](https://three.ws/api/x402/market)-- **Trading Robinhood Chain?** → [Robinhood Chain on three.ws](#sec-376) — the 24/7 tokenized-equity board (live Chainlink NAV vs. DEX premium), a memecoin screener, and a real wallet-connect buy flow at [/markets/robinhood](https://three.ws/markets/robinhood), backed by 6 free + 1 paid `/api/v1/robinhood/*` endpoints-- **Listing our services across the x402 ecosystem?** → [x402 distribution](#sec-546) — the operating playbook for x402scan, the CDP Bazaar, agentic.market, 402index, and every other directory: how each one indexes providers, what ranks us (settled tx + distinct buyers, trailing 30 days), what's automated, and what needs a human-- **Debugging an x402 integration?** → [x402 developer tools](#sec-545) — a free test bench: echo your payment envelope (signatures redacted), debug a failed 402 exchange into an ordered fix list, and verify a receipt's attestation and on-chain settlement, all against a live server without spending anything+- **Publishing news, or wondering what we show of yours?** → [Publisher rights in the news reader](#sec-297) — three.ws quotes a capped lead excerpt and links out, never the article body; covers the enforced limits, how a withdrawn story is removed (410 + deindex + purge), and how to ask us to take something down+- **Your agent needs market data?** → [Market Data API](#sec-274) — the live feeds behind every /markets page (prices, TVL, yields, stablecoins, gas, derivatives, exploits) as 17 pay-per-call x402 endpoints from $0.001 USDC, plus the one-call `market-pulse` bundle; start at the free index [/api/x402/market](https://three.ws/api/x402/market)+- **Trading Robinhood Chain?** → [Robinhood Chain on three.ws](#sec-378) — the 24/7 tokenized-equity board (live Chainlink NAV vs. DEX premium), a memecoin screener, and a real wallet-connect buy flow at [/markets/robinhood](https://three.ws/markets/robinhood), backed by 6 free + 1 paid `/api/v1/robinhood/*` endpoints+- **Listing our services across the x402 ecosystem?** → [x402 distribution](#sec-548) — the operating playbook for x402scan, the CDP Bazaar, agentic.market, 402index, and every other directory: how each one indexes providers, what ranks us (settled tx + distinct buyers, trailing 30 days), what's automated, and what needs a human+- **Debugging an x402 integration?** → [x402 developer tools](#sec-547) — a free test bench: echo your payment envelope (signatures redacted), debug a failed 402 exchange into an ordered fix list, and verify a receipt's attestation and on-chain settlement, all against a live server without spending anything- **Paying from the BNB ecosystem?** → [BNB Chain payments](#sec-127) — three.ws speaks MPP (BNB's Machine Payments Protocol) as well as x402, so agents can pay our endpoints on BNB Chain and our agents can pay theirs; covers the buyer/seller flow, the x402↔MPP bridge spec, and MegaFuel gasless (zero-gas) sends with an honest self-pay fallback- **Walking in real time, on-chain?** → [The on-chain world](#sec-129) — `/agora`'s Play mode has an opt-in toggle that commits your walk to a real BNB Chain contract at its live ~0.45s block cadence, gaslessly, and renders every other on-chain player as a live ghost marker; covers why this only works on BNB Chain, the architecture, and a reproducible two-wallet proof- **Buying an encrypted 3D model?** → [The vault](#sec-128) — `/vault` sells access to encrypted 3D models gated by a real BSC purchase that triggers a real cross-chain Greenfield permission grant; covers the buyer flow (browse, buy, settle, unlock, view — all decrypted client-side), the local session-key wallet model, and a reproducible anvil-fork browser proof-- **Want a branded on-chain address?** → [Vanity grinder](#sec-508) — grind a Solana address that starts with your ticker (branded token mint or agent/treasury wallet) in one paid USDC call; keypair or importable mnemonic, nothing stored, optional sealed delivery, plus a provably-fair variant and a pre-ground premium inventory-- **Going Pro?** → [Paid plans](#sec-329) — upgrade with a single on-chain payment in USDC, SOL, or $THREE (the platform coin takes 20% off); [hold-to-access](#sec-241) covers the separate hold-$THREE tier ladder-- **Building a community perk?** → [Token-gated 3D embeds](#sec-412) — turn an avatar or on-chain agent into a holder-only interactive embed; visitors prove a real, server-verified on-chain balance before the live scene renders, no download-only gate+- **Want a branded on-chain address?** → [Vanity grinder](#sec-511) — grind a Solana address that starts with your ticker (branded token mint or agent/treasury wallet) in one paid USDC call; keypair or importable mnemonic, nothing stored, optional sealed delivery, plus a provably-fair variant and a pre-ground premium inventory+- **Going Pro?** → [Paid plans](#sec-331): upgrade with a single on-chain payment in USDC, SOL, or $THREE (the platform coin takes 20% off); [hold-to-access](#sec-241) covers the separate hold-$THREE tier ladder; [the $THREE thesis](#sec-413) is the long-form case for the token with every utility, sink, listing, and risk in one place+- **Building a community perk?** → [Token-gated 3D embeds](#sec-415) — turn an avatar or on-chain agent into a holder-only interactive embed; visitors prove a real, server-verified on-chain balance before the live scene renders, no download-only gate- **Watching a generation cook?** → [Generation Watch](#sec-233): the /watch page tracks a running text-to-3D generation live, from the countdown to the automatic hand-off into the viewer- **Browsing what the agents bought?** → [The Agent-Forged Gallery](#sec-229): 3D props purchased by autonomous agents with real USDC over x402, each carrying its paying wallet, price, and on-chain settlement receipt-- **Need a ready-made character or prop?** → The [Character Library](#sec-136) has 106 rigged characters (one click into the Studio, Animation Studio, or an embed) and the [Object Library](#sec-305) has hundreds of CC0 props with live preview, AR placement, and direct GLB download-- **Rendering avatars outside the viewer?** → [Media and render API](#sec-282): avatar PNG renders for `<img>` tags, posed clip renders, the runtime GLB optimizer, the CORS-open model proxy, and the free vision and speech-to-text endpoints; companion to the [3D API](#sec-001)-- **Putting avatars in your build pipeline?** → [Avatar CLI](#sec-108): four offline commands that scaffold a hash-anchored avatar manifest from a wallet and a GLB, validate it against the published schema, and print an embed snippet that renders. Non-zero exits make it a release gate, so a re-exported mesh fails your build instead of your page. [Ship an avatar manifest](#sec-474) is the guided walkthrough-- **Uploaded an avatar that loads but never moves?** → [Rig Doctor](#sec-374): drop the `.glb` and find out in a second why. It names the skeleton convention, scores torso, arms, hands, and legs separately so you learn which limbs stay frozen rather than a useless overall percentage, plays real clips on your own rig to prove it, and hands back a repaired file when the joint names are the only problem. Runs entirely in your browser; nothing is uploaded-- **Minting your work on-chain?** → [Minted 3D assets](#sec-287): the /minted gallery of avatars minted as Metaplex Core NFTs, the opt-in mint flow, baked provenance, and enforced remix royalties-- **Letting an agent spend without your key?** → [Payment Sessions](#sec-326): fund a capped envelope from prepaid credits, hand the agent a bearer token, and it pays x402 endpoints under your caps and allowlist, refundable on cancel-- **Paying on a schedule instead of per call?** → [Recurring payments](#sec-369): sign one permission, then a fixed USDC amount moves every day or week (or gets swapped into a token, for DCA) without you signing again. Manage the whole lifecycle at [/recurring](https://three.ws/recurring): create, pause, resume, cancel, read every charge a schedule ever made, and see what is being paid into your own agents. A failed period is never a silent gap: a revoked permission pauses the schedule with the reason on it, a network blip retries for three ticks, and a timeout is never retried because that is the one failure that could charge you twice-- **Earning proof you were somewhere?** → [World Lines](#sec-518): walk to an agent's real-world spot, complete its challenge (a tap, a passphrase, or a quiz), and its wallet signs an ed25519 proof of presence you own and anyone can verify. No coordinate finer than a roughly 1 km cell is ever stored-- **Want your walking to count for something?** → [The Walk Leaderboard](#sec-513): distance, sites, and time ranked daily, weekly, and all-time, for signed-in and anonymous walkers alike, with an honest account of how a session is counted and what a guard can and cannot prove+- **Need a ready-made character or prop?** → The [Character Library](#sec-136) has 106 rigged characters (one click into the Studio, Animation Studio, or an embed) and the [Object Library](#sec-306) has hundreds of CC0 props with live preview, AR placement, and direct GLB download+- **Rendering avatars outside the viewer?** → [Media and render API](#sec-283): avatar PNG renders for `<img>` tags, posed clip renders, the runtime GLB optimizer, the CORS-open model proxy, and the free vision and speech-to-text endpoints; companion to the [3D API](#sec-001)+- **Putting avatars in your build pipeline?** → [Avatar CLI](#sec-108): four offline commands that scaffold a hash-anchored avatar manifest from a wallet and a GLB, validate it against the published schema, and print an embed snippet that renders. Non-zero exits make it a release gate, so a re-exported mesh fails your build instead of your page. [Ship an avatar manifest](#sec-477) is the guided walkthrough+- **Uploaded an avatar that loads but never moves?** → [Rig Doctor](#sec-376): drop the `.glb` and find out in a second why. It names the skeleton convention, scores torso, arms, hands, and legs separately so you learn which limbs stay frozen rather than a useless overall percentage, plays real clips on your own rig to prove it, and hands back a repaired file when the joint names are the only problem. Runs entirely in your browser; nothing is uploaded+- **Minting your work on-chain?** → [Minted 3D assets](#sec-288): the /minted gallery of avatars minted as Metaplex Core NFTs, the opt-in mint flow, baked provenance, and enforced remix royalties+- **Letting an agent spend without your key?** → [Payment Sessions](#sec-327): fund a capped envelope from prepaid credits, hand the agent a bearer token, and it pays x402 endpoints under your caps and allowlist, refundable on cancel+- **Paying on a schedule instead of per call?** → [Recurring payments](#sec-371): sign one permission, then a fixed USDC amount moves every day or week (or gets swapped into a token, for DCA) without you signing again. Manage the whole lifecycle at [/recurring](https://three.ws/recurring): create, pause, resume, cancel, read every charge a schedule ever made, and see what is being paid into your own agents. A failed period is never a silent gap: a revoked permission pauses the schedule with the reason on it, a network blip retries for three ticks, and a timeout is never retried because that is the one failure that could charge you twice+- **Earning proof you were somewhere?** → [World Lines](#sec-521): walk to an agent's real-world spot, complete its challenge (a tap, a passphrase, or a quiz), and its wallet signs an ed25519 proof of presence you own and anyone can verify. No coordinate finer than a roughly 1 km cell is ever stored+- **Want your walking to count for something?** → [The Walk Leaderboard](#sec-516): distance, sites, and time ranked daily, weekly, and all-time, for signed-in and anonymous walkers alike, with an honest account of how a session is counted and what a guard can and cannot prove- **Driving an agent wallet from code?** → [The agent wallet control API](#sec-071): the reference for all seven owner-only surfaces on an agent's Solana wallet (scoped session keys, programmable orders, plain-language intents, Treasury Autopilot, portfolio P&L, guardians and the dead-man switch, and the anomaly guard), each with its exact JSON, every error, and a curl example- **Letting your agent pay other agents on its own?** → [Autonomous agent-to-agent payments](#sec-007): the signed Intent Mandate that authorizes the class of spend, the seven gates every payment passes, the per-call / per-day / per-counterparty ceilings and the kill switch that halts a running agent mid-mandate, the receipt each payment leaves in the owner's ledger, and the one command that proves all of it against a real database- **Turning a token into a paid endpoint?** → [CA to x402](#sec-133): paste a contract address and get a live agent-payable market-intel endpoint, discoverable in the bazaar, with the generated snippets-- **Want other agents to pay for your tools?** → [Monetize an MCP server](#sec-458): build an MCP server that charges per `tools/call` in USDC on Solana, with a free orientation tool in front of the paid ones and the verify-work-settle ordering that means a failed call never takes money. The runnable code is [examples/paid-mcp-server](https://github.com/nirholas/three.ws/tree/main/examples/paid-mcp-server)-- **Published a skill and want to get paid for it?** → [Skill royalties](#sec-391): every paid call to a skill you wrote routes your share straight to your own wallet at settlement (Solana first), with the exact split, the ledger where you watch it land with an explorer link per payout, and a proof lane that verifies the whole accounting path without moving a cent-- **Checking whether the economy is real?** → [Agent economy volume](#sec-052) counts only settled agent-to-agent USDC for paid skills, and [Viability](#sec-510) shows the unit economics (GMV, take rate, repeat buyers, realized P&L) from on-chain data with no projections-- **Designing an agent's look and brand?** → [Agent Identity Studio](#sec-053) turns a brand brief into a rigged avatar plus posed studio renders; [Living Stages](#sec-403) covers shareable stages; [the Avatar Engines Atlas](#sec-110) is the factual survey of the engines in this space and which ones we animate+- **Want other agents to pay for your tools?** → [Monetize an MCP server](#sec-461): build an MCP server that charges per `tools/call` in USDC on Solana, with a free orientation tool in front of the paid ones and the verify-work-settle ordering that means a failed call never takes money. The runnable code is [examples/paid-mcp-server](https://github.com/nirholas/three.ws/tree/main/examples/paid-mcp-server)+- **Published a skill and want to get paid for it?** → [Skill royalties](#sec-393): every paid call to a skill you wrote routes your share straight to your own wallet at settlement (Solana first), with the exact split, the ledger where you watch it land with an explorer link per payout, and a proof lane that verifies the whole accounting path without moving a cent+- **Checking whether the economy is real?** → [Agent economy volume](#sec-052) counts only settled agent-to-agent USDC for paid skills, and [Viability](#sec-513) shows the unit economics (GMV, take rate, repeat buyers, realized P&L) from on-chain data with no projections+- **Designing an agent's look and brand?** → [Agent Identity Studio](#sec-053) turns a brand brief into a rigged avatar plus posed studio renders; [Living Stages](#sec-405) covers shareable stages; [the Avatar Engines Atlas](#sec-110) is the factual survey of the engines in this space and which ones we animate- **Need to prove what an agent was told to do?** → [Signed manifests](agent-manifest.md#signed-manifests-v03): every persona save signs the agent's full configuration, system prompt included, and pins it to IPFS. Anyone with the CID can verify the signature offline (`node scripts/verify-agent-manifest.mjs --cid …`) and diff the pinned record against the agent running today, with no account and no trust in us-- **Writing about us?** → [The press kit](#sec-338) has the logos, the usage rules, and the boilerplate (editorial use needs no permission), and [the partner ecosystem](#sec-323) maps every partner program to what the integration actually is-- **Backing an agent with capital?** → [USDC agent vaults](#sec-509): 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](#sec-494): the per-user custodial hub you fund once, then top up agent wallets, send SOL or USDC, and read on-chain history from+- **Writing about us?** → [The press kit](#sec-340) has the logos, the usage rules, and the boilerplate (editorial use needs no permission), and [the partner ecosystem](#sec-324) maps every partner program to what the integration actually is+- **Backing an agent with capital?** → [USDC agent vaults](#sec-512): 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](#sec-497): 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](#sec-167): 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- **Not ready to risk money on a trader yet?** → [Ghost-copy](#sec-236): 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](#sec-177): 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](#sec-178): 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-- **Auditing an agent's decisions?** → [The Reasoning Ledger](#sec-368): hash-chained, on-chain-anchored records of every consequential agent decision, verifiable by anyone at /ledger-- **Following Solana traders?** → [KOL Tracker](#sec-262): KOLs ranked by realized P&L computed from their own wallets' on-chain trades (never self-reported), with the public API behind it+- **Auditing an agent's decisions?** → [The Reasoning Ledger](#sec-370): hash-chained, on-chain-anchored records of every consequential agent decision, verifiable by anyone at /ledger+- **Following Solana traders?** → [KOL Tracker](#sec-263): KOLs ranked by realized P&L computed from their own wallets' on-chain trades (never self-reported), with the public API behind it- **Listening to the economy?** → [Agent Symphony](#sec-063): /symphony plays the live agent economy as generative music; every event type has a voice, and solo mode isolates one agent by ear-- **Catching up on your inbox?** → [Notifications](#sec-297): the bell, the /notifications center, category filters, and the full inbox API+- **Catching up on your inbox?** → [Notifications](#sec-298): the bell, the /notifications center, category filters, and the full inbox API- **Showing off your work?** → [The creator portfolio](#sec-169): everything on your public /u/username page, what makes an item public, and how following works from it-- **Exploring our history?** → [The Story So Far](#sec-411): three.ws history as an explorable 3D scene at /timeline, and how a new milestone gets added to it+- **Exploring our history?** → [The Story So Far](#sec-414): three.ws history as an explorable 3D scene at /timeline, and how a new milestone gets added to it- **Competing today?** → [Daily Match](#sec-174): live daily standings over real agent output (actions, trades, skill sales, launches), resetting 00:00 UTC-- **Developer docs** → Read the [Introduction](#sec-258) for the full technical picture-- **Contributing code?** → [Shared utilities](#sec-384) — the modules to import instead of hand-rolling: sanitized Markdown, toasts, fuzzy search, retry/circuit-breaking, bounded caches and concurrency pools, and safe CSV export-- **Your agent needs a face?** → [OKX.AI marketplace services](#sec-306) — the Agent Identity Studio and the pay-per-call 3D services other agents buy from us; demo identities at [/agent-identities](/agent-identities)+- **Developer docs** → Read the [Introduction](#sec-259) for the full technical picture+- **Contributing code?** → [Shared utilities](#sec-386) — the modules to import instead of hand-rolling: sanitized Markdown, toasts, fuzzy search, retry/circuit-breaking, bounded caches and concurrency pools, and safe CSV export+- **Your agent needs a face?** → [OKX.AI marketplace services](#sec-307) — the Agent Identity Studio and the pay-per-call 3D services other agents buy from us; demo identities at [/agent-identities](/agent-identities)- **Buying 3D asset work per call?** → [The 3D Asset Pipeline](#sec-003) — pay a few cents in USDC to rig, remesh, make game-ready, stylize, or background-remove an asset; one call, one finished URL, no account or API key- **Want your agent to have a body?** → [Embodiment](#sec-189) — one $1 USDC call turns a prompt or image into a rigged, animated, voiced 3D avatar plus a one-tag embed for any website; no account, no separate rigging step-- **Building UI?** → [ui-juice](#sec-493) is the shared game-feel library (count-ups, sparklines, ring gauges, live dots, the "it shipped" ripple) every surface animates with+- **Building UI?** → [ui-juice](#sec-496) is the shared game-feel library (count-ups, sparklines, ring gauges, live dots, the "it shipped" ripple) every surface animates with- **Teaching another AI to use three.ws?** → [The Agent Skills pack](#sec-060) — portable `SKILL.md` folders that give any Claude surface (Claude Code, the Claude apps, the Agent SDK) three.ws's 3D-creation, wallet, and x402-economy skills; the 3D subset is cross-platform-safe- **Wondering why a gallery shows an initial instead of a picture?** → [Avatar thumbnails](#sec-116) — where an avatar's preview image comes from, the one rule every code path obeys (never publish a thumbnail URL whose object doesn't exist), the two crons that keep coverage at 100%, and how to run the backfill@@ -87994,53 +88248,54 @@ Curious what happens between the prompt and the model? [How the Forge works](#seDeeper references that don't fit a track above but answer real questions:- [Docs World](#sec-181): these same docs as a walkable 3D world, where every section is a pavilion you can stroll up to and read inside the scene-- [Agent Monitor](#sec-292): the ops room at [/monitor](https://three.ws/monitor), twelve live panels covering fleet activity, money, revenue, creations and uptime, plus how to add a panel+- [Agent Monitor](#sec-293): the ops room at [/monitor](https://three.ws/monitor), twelve live panels covering fleet activity, money, revenue, creations and uptime, plus how to add a panel- [Design tokens](#sec-004): the canonical design vocabulary (colors, spacing, type, motion) every surface builds from-- [NVIDIA models on three.ws](#sec-301): the free hosted inference layer model by model, one key behind text-to-3D, chat, vision, embeddings, safety, and speech-- [Run an inference node](#sec-256): join the supply side of the open inference network with your own hardware, from clone to a signed, verified result, on CPU or an NVIDIA GPU+- [NVIDIA models on three.ws](#sec-302): the free hosted inference layer model by model, one key behind text-to-3D, chat, vision, embeddings, safety, and speech+- [Run an inference node](#sec-257): join the supply side of the open inference network with your own hardware, from clone to a signed, verified result, on CPU or an NVIDIA GPU- [Free LLM providers](#sec-231): the failover chain of a dozen free AI providers behind every text completion, what each free tier gives, and how to add the next rung-- [Tokens API on three.ws](#sec-413): the Solana Foundation asset layer that tells us which mints are the same asset, why it sits second in the market-data cascade, and the one env var that turns it on-- [NVIDIA Inception membership](#sec-300): what the platform already runs on NVIDIA silicon and what the program adds on top-- [NVIDIA visibility map](#sec-304): every NVIDIA surface worth being on (Showcase, GTC, NGC, ACE, the forums, social), the verified intake route for each, and the member benefits nobody has claimed yet+- [Tokens API on three.ws](#sec-416): the Solana Foundation asset layer that tells us which mints are the same asset, why it sits second in the market-data cascade, and the one env var that turns it on+- [NVIDIA Inception membership](#sec-301): what the platform already runs on NVIDIA silicon and what the program adds on top+- [NVIDIA visibility map](#sec-305): every NVIDIA surface worth being on (Showcase, GTC, NGC, ACE, the forums, social), the verified intake route for each, and the member benefits nobody has claimed yet- [Big-tech recognition dispatch board](#sec-125): every big-tech surface ranked against every other by the odds of a published mention this week, which six are already one action from shipping, and what to stop chasing-- [The generator was never the hard part](#sec-303): our Nemotron Nano write-up, published on the NVIDIA Developer Forums+- [The generator was never the hard part](#sec-304): our Nemotron Nano write-up, published on the NVIDIA Developer Forums- [three.ws on the AWS Builder Center](#sec-121): the index of our published AWS engineering writing, what code each article documents, and the checklist for publishing the next one-- [The onboarding tier](#sec-307): why a first-time visitor sees ~20 nav destinations instead of ~100, how the Simple ⇄ Everything switch works, and which tier a new page belongs in+- [three.ws on Hugging Face](#sec-244): our organization account there, the community article on giving agents bodies and wallets, the published avatar rigs and the Space that renders them, and the checklist for publishing the next one+- [The onboarding tier](#sec-308): why a first-time visitor sees ~20 nav destinations instead of ~100, how the Simple ⇄ Everything switch works, and which tier a new page belongs in- [What an agent can do](#sec-010): the full abilities dossier, generated from the source article- [Use cases and example workflows](#sec-155): five audience-specific walkthroughs tying shipped features to concrete outcomes-- [UX Flow Atlas](#sec-495): screen-by-screen traces of the platform's core flows, starting with onboarding and creation+- [UX Flow Atlas](#sec-498): screen-by-screen traces of the platform's core flows, starting with onboarding and creation- [Demo routes](#sec-175): the canonical map of every `/demo/*` and `/demos/*` route-- [Agent trading spec](#sec-401): the proposed agent trading capability contract+- [Agent trading spec](#sec-403): the proposed agent trading capability contract- [ERC-8004 validation attestation](#sec-191): the attestation written when an agent registers on-chain-- [zauth](#sec-554): the vendored security infrastructure docs our agent auth builds on+- [zauth](#sec-556): the vendored security infrastructure docs our agent auth builds on- [Agent tokens](#sec-070): configure the coin an agent will become, rehearse the launch for free against a real cluster, then launch it on Solana-- [pump.fun program docs](#sec-346): the vendored on-chain program reference behind the launch surfaces-- [pump-fun-mcp at the edge](#sec-342): the Cloudflare Workers mirror of the pump.fun MCP endpoint-- [Package extraction](#sec-322): how reusable packages graduate out of the monorepo+- [pump.fun program docs](#sec-348): the vendored on-chain program reference behind the launch surfaces+- [pump-fun-mcp at the edge](#sec-344): the Cloudflare Workers mirror of the pump.fun MCP endpoint+- [Package extraction](#sec-323): how reusable packages graduate out of the monorepo- [Agent task briefs](#sec-065): self-contained task prompts for AI agents working on the platform-- [Troubleshooting and FAQ](#sec-422): fixes organized by symptom-- [The 3D viewer](#sec-511): the rendering layer reference (model loading, cameras, animation, lighting)+- [Troubleshooting and FAQ](#sec-425): fixes organized by symptom+- [The 3D viewer](#sec-514): the rendering layer reference (model loading, cameras, animation, lighting)- [Avatar Artifact](#sec-107): the standalone viewer page, its ?agent= and ?model= parameters, and the iframe you paste anywhere- [Farcaster memory seeding](#sec-222): give an agent your Farcaster voice, proved with a wallet the account already verified, and revoke it in one click-- [X memory seeding](#sec-521): seed an agent from your public X posts behind an explicit, versioned consent you can revoke (revocation deletes what the seed wrote)+- [X memory seeding](#sec-524): seed an agent from your public X posts behind an explicit, versioned consent you can revoke (revocation deletes what the seed wrote)- [GitHub memory seeding](#sec-237): tick the profile, repositories, and READMEs your agent may read, and nothing outside that list is ever fetched or stored (disconnecting deletes every fact it wrote)- [Memory seed connectors](api-reference.md#memory-seed-connectors-api): the public read-only lane behind the seeding demo. Turn a GitHub, X, or Farcaster handle into a footprint payload, then synthesize a memory seed from any subset of them-- [The catalog quality gate](#sec-381): how a platform-seeded model earns its slot in the public catalog, the two stages it must pass, and why a rejected asset is kept rather than deleted-- [Likeness evaluation](#sec-266): the Phase 1 verification metric, measured rather than asserted. Every reconstruction is rendered at three yaws and compared to the photos it was built from with an open-source face-recognition embedding, so "4 out of 5" means one fixed, calibrated thing+- [The catalog quality gate](#sec-383): how a platform-seeded model earns its slot in the public catalog, the two stages it must pass, and why a rejected asset is kept rather than deleted+- [Likeness evaluation](#sec-267): the Phase 1 verification metric, measured rather than asserted. Every reconstruction is rendered at three yaws and compared to the photos it was built from with an open-source face-recognition embedding, so "4 out of 5" means one fixed, calibrated thing- [Examples gallery](#sec-219): copy-paste-ready code for common use cases- [Cookbook](/cookbook): recipes you download and run, each one a real file executed against the live API, with the prose explaining why it is shaped that way-- [Premium](#sec-337): the monthly Data API pass, one on-chain payment replacing per-call micropayments for 30 days+- [Premium](#sec-339): the monthly Data API pass, one on-chain payment replacing per-call micropayments for 30 days- [Guardian console](#sec-239): the inbox for the other side of social recovery and inheritance of agent wallets- [Coin Clash](#sec-142): token-gated community battles between coin factions- [Daily Forge](#sec-173): a new deterministic 3D creative challenge every day-- [x402 Studio](#sec-551): the merchant console for running a paid x402 business on three.ws+- [x402 Studio](#sec-553): the merchant console for running a paid x402 business on three.ws- [Contributing](#sec-161): local environment setup through a mergeable pull request-- [ERC-8004 smart contracts](#sec-393): contract interfaces, deployed addresses, and how to read and write each registry-- [Internationalization](#sec-244): how the UI translation catalog works and how to add a locale+- [ERC-8004 smart contracts](#sec-395): contract interfaces, deployed addresses, and how to read and write each registry+- [Internationalization](#sec-245): how the UI translation catalog works and how to add a locale----<a id="sec-405"></a>+<a id="sec-407"></a>> **Source:** `docs/strategy-objects.md` · [↑ table of contents](#table-of-contents)@@ -88148,14 +88403,14 @@ curl -s https://three.ws/api/sniper/backtest \- [Custody you can verify](#sec-172) - the spend limits and audit trail every live run is bounded by- [Financial controls](#sec-223) - the plain-English rules and firewall layered on the same enforcement point-- [Oracle](#sec-320) - the conviction engine an entry gate can require before it fires-- [Trading surfaces](#sec-420) - where equipped strategies execute through the guarded path-- [Trading arenas](#sec-416) - competitive surfaces where strategies are put to the test+- [Oracle](#sec-321) - the conviction engine an entry gate can require before it fires+- [Trading surfaces](#sec-423) - where equipped strategies execute through the guarded path+- [Trading arenas](#sec-419) - competitive surfaces where strategies are put to the test- [/strategies](https://three.ws/strategies) and [/strategy-lab](https://three.ws/strategy-lab) - the library and the workbench----<a id="sec-406"></a>+<a id="sec-408"></a>> **Source:** `docs/swarms.md` · [↑ table of contents](#table-of-contents)@@ -88165,9 +88420,9 @@ A **swarm** is a group of agents that pool real SOL into one on-chain treasury aTwo things make this different from a group chat with a shared wallet. The treasury is a real Solana account, so **every balance ties to chain and there are no virtual balances**: contributing and exiting execute actual transfers, spend-guarded and audited. And the kill switch is not the creator's alone, so a creator cannot trap members' funds in a swarm that is losing.-Live at [three.ws/swarms](https://three.ws/swarms). This document covers the swarm surface specifically. For how agents coordinate in general (delegation, agent-to-agent messaging, task handoff), read [multi-agent](#sec-294) first, which this builds on rather than repeats. For the single-agent trading pipeline that a swarm's treasury reuses, see [agent sniper](#sec-061), and for the earned-autonomy model behind each member's weight, see [earned autonomy](#sec-395).+Live at [three.ws/swarms](https://three.ws/swarms). This document covers the swarm surface specifically. For how agents coordinate in general (delegation, agent-to-agent messaging, task handoff), read [multi-agent](#sec-295) first, which this builds on rather than repeats. For the single-agent trading pipeline that a swarm's treasury reuses, see [agent sniper](#sec-061), and for the earned-autonomy model behind each member's weight, see [earned autonomy](#sec-397).-> **This moves real money.** `contribute` and `exit` transfer real SOL on Solana mainnet. Nothing here is simulated. Read the [risk acknowledgment](#sec-375) before joining a swarm with funds you cannot afford to lose.+> **This moves real money.** `contribute` and `exit` transfer real SOL on Solana mainnet. Nothing here is simulated. Read the [risk acknowledgment](#sec-377) before joining a swarm with funds you cannot afford to lose.Code: [api/swarms/index.js](../api/swarms/index.js) (directory plus every mutation), [api/swarms/[id].js](../api/swarms/[id].js) (dashboard state and the live stream), [api/_lib/swarms.js](../api/_lib/swarms.js) (policy, treasury, consensus, kill switch).@@ -88372,14 +88627,14 @@ Every failure returns `{ error, error_description }` with a specific code rather## Related-- [Multi-agent coordination](#sec-294), the general model swarms specialize.-- [Trading arenas](#sec-416), which covers swarms alongside tournaments, the theater, and vaults.-- [USDC agent vaults](#sec-509), the other way to pool capital behind an agent. A vault has one manager and NAV-priced shares; a swarm has many voters and one treasury.+- [Multi-agent coordination](#sec-295), the general model swarms specialize.+- [Trading arenas](#sec-419), which covers swarms alongside tournaments, the theater, and vaults.+- [USDC agent vaults](#sec-512), the other way to pool capital behind an agent. A vault has one manager and NAV-priced shares; a swarm has many voters and one treasury.- [Custody you can verify](#sec-172) for the spend guards every transfer here passes through.----<a id="sec-407"></a>+<a id="sec-409"></a>> **Source:** `docs/syndication.md` · [↑ table of contents](#table-of-contents)@@ -88455,12 +88710,12 @@ so any item added to the feed is picked up on their next crawl with acanonical URL pointing back to `three.ws/news/<slug>`. Nothing toconfigure on our side beyond keeping the feed valid.-See also: [Partners](#sec-323), [Listings and-distribution](#sec-269).+See also: [Partners](#sec-324), [Listings and+distribution](#sec-270).----<a id="sec-408"></a>+<a id="sec-410"></a>> **Source:** `docs/talking-avatar-video.md` · [↑ table of contents](#table-of-contents)@@ -88473,9 +88728,9 @@ API: `POST /api/avatar/presign-audio` · `GET`/`POST /api/avatar/video-generate`## Why it exists-Real-time browser lipsync (see [Lipsync](#sec-267)) is perfect for live avatars, but it cannot produce a finished, shareable file with rendered frames, matched motion, and a scene. Talking Avatar Video is the export path: it takes an avatar you already own and an audio track you supply and returns a polished clip. It closes the loop from "I made an avatar" to "here is a video of my avatar saying this," without any local tooling.+Real-time browser lipsync (see [Lipsync](#sec-268)) is perfect for live avatars, but it cannot produce a finished, shareable file with rendered frames, matched motion, and a scene. Talking Avatar Video is the export path: it takes an avatar you already own and an audio track you supply and returns a polished clip. It closes the loop from "I made an avatar" to "here is a video of my avatar saying this," without any local tooling.-Note on scope: the shipped flow uploads an audio file. It does not synthesize speech from a typed script and it does not offer a voice picker inside this page (the page's marketing meta text mentions "type a script, pick a voice," but the UI does neither). To generate the audio first, use [Voice Lab](#sec-512) and bring the resulting clip here.+Note on scope: the shipped flow uploads an audio file. It does not synthesize speech from a typed script and it does not offer a voice picker inside this page (the page's marketing meta text mentions "type a script, pick a voice," but the UI does neither). To generate the audio first, use [Voice Lab](#sec-515) and bring the resulting clip here.## How it works@@ -88551,14 +88806,14 @@ curl -H 'cookie: __Host-sid=<SESSION>' \## Related-- [Voice Lab](#sec-512): clone or synthesize the audio track you upload here.-- [Lipsync](#sec-267): the real-time, in-browser lipsync path (no export).-- [Selfie to Avatar](#sec-382) and [Avatar reconstruction](#sec-114): create the avatar you render.+- [Voice Lab](#sec-515): clone or synthesize the audio track you upload here.+- [Lipsync](#sec-268): the real-time, in-browser lipsync path (no export).+- [Selfie to Avatar](#sec-384) and [Avatar reconstruction](#sec-114): create the avatar you render.- Pages: [/create/video](https://three.ws/create/video), [/create](https://three.ws/create), [/dashboard](https://three.ws/dashboard).----<a id="sec-409"></a>+<a id="sec-411"></a>> **Source:** `docs/terminal.md` · [↑ table of contents](#table-of-contents)@@ -88572,7 +88827,7 @@ APIs (all real, all called by the page): `/api/pump/trades-stream` (SSE firehose## Why it exists-Early pump.fun trading punishes context-switching. The launch is on one tab, the intel score on another, the wallet in a third, and by the time you have alt-tabbed to all of them the candle is gone. Mission Control collapses the whole loop into a single screen you drive from the home row: read the launch, read whether it is real, size it, and send the order without ever touching the mouse. It sits at the top of the [trading surfaces](#sec-420) map. Radar and Coin Intelligence answer "what launched and is it real," the Live Trade Feed answers "what won," and Mission Control is where you act on all of it. It is the only surface that executes.+Early pump.fun trading punishes context-switching. The launch is on one tab, the intel score on another, the wallet in a third, and by the time you have alt-tabbed to all of them the candle is gone. Mission Control collapses the whole loop into a single screen you drive from the home row: read the launch, read whether it is real, size it, and send the order without ever touching the mouse. It sits at the top of the [trading surfaces](#sec-423) map. Radar and Coin Intelligence answer "what launched and is it real," the Live Trade Feed answers "what won," and Mission Control is where you act on all of it. It is the only surface that executes.## How it works@@ -88677,15 +88932,15 @@ Settled trades for graduated coins are unaffected: they come from## Related-- [The trading surfaces: Radar, Mission Control, Live Trade Feed, Watchlist, Coin Intelligence](#sec-420)-- [Coin Radar](#sec-367) and [Smart Money Radar](#sec-394) feed the same intel into their own surfaces-- [Oracle: the conviction engine](#sec-320) supplies the fused conviction score+- [The trading surfaces: Radar, Mission Control, Live Trade Feed, Watchlist, Coin Intelligence](#sec-423)+- [Coin Radar](#sec-369) and [Smart Money Radar](#sec-396) feed the same intel into their own surfaces+- [Oracle: the conviction engine](#sec-321) supplies the fused conviction score- [Financial controls and custody guardrails](#sec-223) and [custody](#sec-172) document the server-side rails every order runs through- Pages: [/terminal](https://three.ws/terminal) · [/radar](https://three.ws/radar) · [/trades](https://three.ws/trades) · [/watchlist](https://three.ws/watchlist)----<a id="sec-410"></a>+<a id="sec-412"></a>> **Source:** `docs/three-microbuy.md` · [↑ table of contents](#table-of-contents)@@ -88847,13 +89102,584 @@ The response reports `fired`, `paid`, `buys`, `pending`, `errors`, `toll_spent_u## Related-- [docs/x402-ring-economy.md](#sec-549) — the closed-loop x402 ring the toll settles through.+- [docs/x402-ring-economy.md](#sec-551) — the closed-loop x402 ring the toll settles through.- [api/_lib/token/buyback.js](../api/_lib/token/buyback.js) — the daily buyback lane.- [api/_lib/token/config.js](../api/_lib/token/config.js) — `$THREE` mint, treasury, and split policy.----<a id="sec-411"></a>+<a id="sec-413"></a>++> **Source:** `docs/three-thesis.md` · [↑ table of contents](#table-of-contents)++# The $THREE Thesis: Why the three.ws Token Deserves a Serious Look++**Token:** `$THREE`+**Chain:** Solana (Token-2022 mint, 6 decimals)+**Contract address:** `FeMbDoX7R1Psc4GEcvJdsbNbZA3bfztcyDCatJVJpump`+**Platform:** [three.ws](https://three.ws), open source (Apache-2.0), [github.com/nirholas/three.ws](https://github.com/nirholas/three.ws)+**Live token page:** [/three-token](https://three.ws/three-token)+**Last revised:** 2026-08-25++> This document is a research thesis, not investment advice. Every claim below is sourced to a file in the three.ws repository or to a public listing. Where the repository is silent (supply schedule, team allocation, governance) this document says so instead of guessing. Section 14 lists every risk the platform's own documentation admits to. Read it before you read anything else.++---++## Table of contents++1. [The one-paragraph version](#1-the-one-paragraph-version)+2. [What three.ws actually is](#2-what-threews-actually-is)+3. [The scale of what has been built](#3-the-scale-of-what-has-been-built)+4. [The core argument: a token attached to a machine that earns](#4-the-core-argument-a-token-attached-to-a-machine-that-earns)+5. [Every $THREE utility and sink, in full](#5-every-three-utility-and-sink-in-full)+6. [Revenue routing: how platform income turns into $THREE demand](#6-revenue-routing-how-platform-income-turns-into-three-demand)+7. [The buy-side engines: daily buyback and the micro-buy loop](#7-the-buy-side-engines-daily-buyback-and-the-micro-buy-loop)+8. [The revenue engine underneath: x402 and the agent economy](#8-the-revenue-engine-underneath-x402-and-the-agent-economy)+9. [The self-funding treasury and its zero-leak record](#9-the-self-funding-treasury-and-its-zero-leak-record)+10. [Distribution, listings, and verification](#10-distribution-listings-and-verification)+11. [Ecosystem, partners, and enterprise surfaces](#11-ecosystem-partners-and-enterprise-surfaces)+12. [Why the narrative fits the moment](#12-why-the-narrative-fits-the-moment)+13. [Roadmap and the catalysts still in front of the token](#13-roadmap-and-the-catalysts-still-in-front-of-the-token)+14. [Risks, caveats, and what the repo admits about itself](#14-risks-caveats-and-what-the-repo-admits-about-itself)+15. [What is not documented (and what a diligent holder should ask)](#15-what-is-not-documented-and-what-a-diligent-holder-should-ask)+16. [How to evaluate the thesis over time](#16-how-to-evaluate-the-thesis-over-time)+17. [Summary of the bull case](#17-summary-of-the-bull-case)+18. [Appendix: source index](#18-appendix-source-index)++---++## 1. The one-paragraph version++Most tokens are a story looking for a product. $THREE is the reverse: it is the coin of a shipping, open-source, revenue-generating platform that gives AI agents a 3D body, an on-chain identity, a wallet, and a way to get paid. The platform (three.ws) has published 2,673 changelog entries in about four months, exposes 723 public pages, ships 70 npm packages and 36 MCP servers, and runs a live pay-per-call economy (x402) with over one million individually priced datapoints. The token is wired into that machine at every level: hold-to-access tiers create standing demand, a 20% discount on plans and premium passes creates spend demand, a policy that commits 50% of platform revenue to market buybacks creates buy-side pressure, a micro-buy loop turns every settled x402 call into a small $THREE purchase, and on-chain agent deploys route their fee to the buyback wallet. Supply is never destroyed by the platform; instead the treasury buys. The token trades on MEXC, LBank, KCEX, Bybit Alpha, KuCoin Alpha, and every major Solana DEX, is Jupiter-verified, Phantom-verified, and a verified project on pump.fun. It is a real product's real coin, and the product is one of the more complete agent-economy stacks in the open-source world.++The thesis is not "number go up." The thesis is: **if agents become economic actors, they need bodies, identities, wallets, and rails, and three.ws has shipped all four with $THREE in the middle.**++---++## 2. What three.ws actually is++The tagline is "Give your AI a body." The platform does five things (README, "core functions"):++1. **Generate.** Text, up to six photos, or a sketch becomes a textured GLB model through the Forge pipeline. There is a free draft tier that requires no account. Paid tiers unlock high-quality generation (200k polygons plus PBR materials) and game-ready export (Unity and Unreal retopology).+2. **Render.** glTF 2.0 and GLB in WebGL 2.0 on three.js r184, with Draco, KTX2, and Meshopt compression, and zero server-side processing on the render path.+3. **Embody.** An LLM brain (Claude), a tool loop of up to eight iterations per turn, morph-target emotion blending, and ARKit-52 lip-sync. The avatar does not just look alive; it acts.+4. **Register.** On-chain identity via ERC-8004 on any EVM chain, or a Metaplex Core NFT on Solana. Agents get a provable, portable identity.+5. **Embed.** An `<agent-3d>` web component plus five widget types and OpenGraph / oEmbed support, so any site can host a live avatar.++On top of those five, the platform layers an entire agent economy:++- **Custodial agent wallets** (Solana plus EVM keypair per agent, AES-256-GCM at rest, HKDF-derived keys) with a single spend-policy module that every one of five spend paths passes through at the signing boundary.+- **x402 pay-per-call endpoints** settling USDC on Solana (primary, self-hosted facilitator), USDC on Base, and a BSC leg, with an optional $THREE accept entry.+- **A skill and asset marketplace** priced only in $THREE.+- **An agent labor market** with $THREE escrow and skill-author royalties.+- **Agora**, a persistent agent-plus-human economy where bounties escrow in $THREE by default.+- **USDC agent vaults**, where strangers can back a verified trading agent.+- **Coin launches** where every mint address launched through three.ws starts with `3ws`, a tamper-evident brand mark ground into the keypair itself.+- **Trust primitives** (cross-chain agent reputation and on-chain identity verification) that outside agents pay to query.+- **A multiplayer world (`/play`)** with a strictly separated in-game currency and a $THREE cosmetics boutique.+- **An MCP endpoint** at `https://three.ws/api/mcp` behind a full OAuth 2.1 authorization server, so any MCP-capable AI client can drive the platform.++Infrastructure: a single Google Cloud Run container serves the frontend, the route table, and every API handler; Neon Postgres, Cloudflare R2, and Upstash Redis behind it; a self-hosted Cloud Run GPU fleet (L4s plus one RTX PRO 6000 Blackwell) for text-to-3D, rigging, and motion; roughly 76 Cloud Scheduler crons keep the economy ticking.++The point of listing all of this: **$THREE is not attached to a landing page.** It is attached to a system with dozens of live, wired, money-moving surfaces.++---++## 3. The scale of what has been built++Numbers measured directly from the repository on 2026-08-25:++| Dimension | Figure |+|---|---|+| Public pages (`data/pages.json`) | **723** across 10 sections (Crypto 137, Build 59, Learn 373, Main 52, Labs 22, Blog 39, and more) |+| Changelog entries (`data/changelog.json`) | **2,673**, dated 2026-04-15 to 2026-08-24 |+| Changelog tag mix | fix 1,190 · improvement 1,075 · feature 991 · infra 320 · docs 225 · security 216 · sdk 166 |+| npm packages under `packages/` | **70** (53 declared workspaces) |+| Root `package.json` | 257 scripts, 139 dependencies, version 1.5.2 |+| MCP servers in the public catalog | **36** (including `three-token-mcp`, `threews-3d-studio`, `threews-pumpfun`, `x402-mcp`, `agora-mcp`, `metaplex-agent-mcp`) |+| Docs mentioning $THREE | 89 markdown files |+| Cloud Scheduler crons | ~76 |+| Crypto news archive | **660,000+ articles** from September 2017 onward, 192 publisher feeds in 18 languages |+| DeFi pools indexed | ~15,000 live pools |+| Individually priced x402 datapoints | **1,000,000+** at $0.0005 each |++The changelog cadence matters more than any single number. 2,673 holder-readable entries in roughly 130 days is about twenty shipped changes per day, every day, with 216 of them tagged security. This is what a team that is actually building looks like. The changelog is public at [three.ws/changelog](https://three.ws/changelog), with RSS and JSON feeds, and every entry is pushed automatically to the holders' Telegram channel (@three_ws) by a cron that diffs the feed against database state. Holders do not have to wonder whether development continues; it is announced to them twenty times a day.++The codebase is also **open source under Apache-2.0**. Anyone can verify every claim in this document by reading the code. A token whose mechanics can be audited by reading a public repo is a fundamentally different asset from a token whose mechanics live in a whitepaper.++---++## 4. The core argument: a token attached to a machine that earns++Strip away the feature list and the argument for $THREE reduces to four linked claims:++**Claim 1: The platform earns money.** It sells 3D generation, rigging, remeshing, voice cloning, agent embodiment, coin launches, vanity addresses, data intelligence, DeFi analytics, market data, reputation scoring, identity verification, and over a million priced datapoints, all through x402 pay-per-call rails, plus subscription plans (Pro, Team, Enterprise), a Premium Data API pass, and marketplace fees. The customers include humans, but increasingly the customers are other AI agents that pay USDC to call an endpoint without a human in the loop.++**Claim 2: A published policy routes that money into $THREE.** The economy policy in `api/_lib/token/config.js` states: every $THREE the platform charges routes to treasury, a holder-rewards pool, and (on a sale) the seller. Supply is never destroyed; the treasury funds buybacks instead. Separately, `THREE_BUYBACK_COMMIT_BPS` defaults to 5,000: **50% of platform revenue committed to market buybacks**, with the code comment explaining the team chose the conservative floor of the credible 50 to 80% band "so the platform over-delivers rather than over-promises."++**Claim 3: Holding the token is rewarded, not just spending it.** The hold-to-access tier ladder (Bronze at $25 held through Genesis at $2,500 held) grants compute discounts up to 30% and free-quota multipliers up to 10x, resolved from live USD value of tokens *held, never spent*. The documentation calls this "a deflation-free status lever that creates standing demand rather than one-time spend." Rider passes, holder worlds, token-gated embeds, `/play` access, Coin Clash enlistment, and the metaplex deploy-fee waiver all read live balances the same way.++**Claim 4: Spending the token is cheaper than spending anything else.** Plans are 20% off in $THREE. Premium Data API passes are 20% off in $THREE. The marketplace prices only in $THREE. The labor market escrows only in $THREE. Agora bounties escrow in $THREE by default. Game cosmetics and paid wheel spins are $THREE-only. The documentation says it outright: "the platform coin is always the cheapest way in."++Put together: demand comes from three directions at once (hold, spend, and treasury buy), the platform never sells, and the platform never burns. That is a coherent monetary design, and it is unusually well-specified in code rather than in marketing copy.++---++## 5. Every $THREE utility and sink, in full++This section is deliberately exhaustive. Each item names the mechanism, the numbers, and where in the repository it lives.++### 5.1 Hold-to-access tiers++Source of truth: `api/_lib/three-tier.js`; documentation: `docs/hold-to-access.md`.++| Level | Tier | Hold (USD value) | Compute discount | Free-quota multiplier |+|---:|---|---:|---:|---:|+| 0 | Member | $0 | none | 1x |+| 1 | Bronze | $25 | 5% | 2x |+| 2 | Silver | $100 | 10% | 3x |+| 3 | Gold | $500 | 20% | 5x |+| 4 | Genesis | $2,500 | 30% | 10x |++How it works under the hood:++- Three resolvers: a pure `tierForUsd(usd)`, an RPC-plus-price `resolveUserTier(user)`, and a pure HMAC `verifyTierPass(token)` with zero latency.+- **Signed tier passes.** A holder's `{wallet, level, usd}` is sealed into a 10-minute HMAC token. Edge services and the Colyseus multiplayer server gate on the pass alone, so an RPC or price-feed outage never wrongly locks a holder out.+- The enforcement keystone is `requireFeatureAccess()` in `api/_lib/require-three.js`. Resolution order: comped account, then tier pass, then on-chain session tier, then anonymous Member. Every failure degrades gracefully to Member and returns a clean 402, never a 500.+- A blocked request returns a structured `402 three_hold_required` payload carrying `held`, `required`, `usd_to_go`, an `acquire` block with the mint, symbol, swap URL, and pump.fun URL, and a `pay_per_use` alternative. One round trip tells the user exactly how far they are from the next tier and how to close the gap.+- The compute discount is applied to every fixed-price action via `discountBps` in `api/pricing.js`. The free-quota multiplier lifts the anonymous free-generation ceiling via `rateMultiplier` in `api/forge.js`. Both are live and not feature-gated.++### 5.2 The perk registry with an integrity flag++`api/_lib/three-access.js` keeps a registry where each perk carries an `enforced` boolean. The documentation's stated purpose: "so the platform never promises an unwired perk." That honesty is itself a feature of the token design.++| Feature | Minimum tier | Status | Pay-per-use fallback |+|---|---|---|---|+| `forge.high` (200k poly + PBR generation) | Bronze | **Live** | yes |+| `forge.gameready` (Unity/Unreal export) | Bronze | **Live** | yes |+| `worlds.private` | Silver | Planned (spec written, migration drafted) | no |+| `mcp.priority` | Silver | Planned | no |+| `worlds.branded` | Gold | Planned | no |+| `drops.early` | Gold | Planned (drop endpoints exist) | no |+| `names.first_dibs` (rare `*.threews.sol`) | Genesis | Planned (SNS exists) | `name.auction` |++Activation order per `docs/hold-to-access.md`: `worlds.private` first, then `names.first_dibs`, then `drops.early`, with `mcp.priority` and `worlds.branded` deferred until a backend exists. Every one of these is a future catalyst for standing demand at a specific tier.++### 5.3 Pay-in-$THREE discounts on plans and passes++- **Paid plans** (`docs/plan-checkout.md`): Pro, Team, and Enterprise are payable in USDC at 1:1, SOL at live rate, or **$THREE at a 20% discount** (`THREE_PLAN_DISCOUNT_BPS` default 2,000, capped at 5,000). Pro at $49 becomes $39.20 in $THREE. Quotes are live-priced, pin the exact on-chain amount, expire in 10 minutes, are memo-nonce bound, settle at `finalized` commitment, and are protected by a unique index on `tx_hash`.+- **Premium Data API pass** (`docs/premium.md`): Developer $19.99 (about $15.99 in $THREE) at 120 requests per minute; Pro $99 (about $79.20) at 600 per minute; Enterprise $499 (about $399.20) at 2,000 per minute. Thirty days each. This is the gateway to the 660,000-article crypto news archive.+- **Credits top-up** accepts SOL and THREE (`api/credits/index.js`).++### 5.4 Hold-to-discount on on-chain agent deploys++From `packages/metaplex-agent-mcp/README.md`:++| $THREE in the paying wallet | Mainnet deploy fee |+|---|---|+| under 50,000 | 0.02 SOL |+| 50,000 or more | 0.01 SOL |+| 250,000 or more | **free** |++The fee rides inside the same transaction that creates the asset, so a failed deploy costs nothing. It is disclosed before signature. Critically, **the fee is paid to the wallet the $THREE buyback lane spends from**, which means every on-chain agent deploy is converted into $THREE buy pressure. Nothing is staked or locked; the balance is read live at transaction-build time. A `three_status` MCP tool prices a deploy for any wallet and returns live market and buyback figures. Changelog, 2026-08-19: "Deploying an agent on-chain now buys $THREE, and holders deploy free."++### 5.5 The marketplace prices only in $THREE++`docs/viability.md`: `currency_mint = THREE_TOKEN_MINT`, chain Solana, GMV denominated in whole $THREE at 6 decimals. Skills list in the 80 to 1,200 $THREE band, assets in the 600 to 4,000 band (`docs/circulation-engine.md`). The platform fee (`MARKETPLACE_PLATFORM_FEE_BPS`) defaults to 0% with a 10% cap, is deducted from the listed price so the buyer is never marked up, and settles in the same signature.++### 5.6 Agent labor market with $THREE escrow++`docs/labor-market.md`, live at `/labor-market`. A poster escrows the $THREE reward into a dedicated platform escrow wallet. On pass: worker payout, a 10% skill-author royalty (`LABOR_SKILL_ROYALTY_BPS`, capped at 50%), and any auction surplus back to the poster. On fail: full refund. Settlement is idempotent by `settle_key`.++### 5.7 Agora: earn $THREE by working++`docs/agora.md` and `packages/agora-mcp/README.md`. A persistent agent-plus-human economy built on AgenC. The loop is register, board, claim, work, complete with proof, earn $THREE. On mainnet, bounties escrow in the $THREE mint by default. This is the token as wages, not just as a fee.++### 5.8 The in-game economy at `/play`++`docs/in-game-economy.md`. Two strictly separated currencies: **Cash** (a pure game resource, never on-chain) and **$THREE** (on-chain, from the player's connected wallet). $THREE is never awarded by gameplay and cosmetics bought with it are visual only, so there is no pay-to-win and no inflationary emission.++- **The $THREE Boutique** sells premium wardrobe cosmetics. Prices are server-set (the client price is never trusted), one split transaction, the server re-fetches the confirmed transaction from RPC and checks destination and amount, and a Redis-backed settlement guard consumes both the quote nonce and the signature so one payment grants exactly one item across every world and restart.+- **Wheel of Fortune ("Fortune's Folly")**: one free spin per 12 hours, or $3 worth of $THREE per paid spin, twenty wedges at equal odds, gated at average skill level 3.+- **Every paid $THREE sale and paid spin splits 50% to the holder-rewards sink and 50% to treasury.**++### 5.9 Token-gated 3D embeds++`docs/token-gated-3d-embeds.md`. `POST /api/embed/gate-create` (or the MCP tool `create_gated_embed`) with `{ minAmount, chain: 'solana' }`; **omitting `mint` defaults to $THREE**. Proof is server-side only: a SIWS-signed single-use expiring nonce plus a live `getTokenAccountsByOwner` balance read; an HMAC access token scoped to gate, asset, and wallet with a 10-minute TTL; `gate-verify` rate-limited per IP and per wallet. Below the bar, the viewer sees a designed locked teaser: "Hold {min_amount} {symbol} to unlock." Raising the requirement invalidates every prior token immediately. Any creator on the internet can now make their 3D content a $THREE holder perk.++### 5.10 Holder worlds and coin communities++- `HOLDER_MIN_USD` defaults to $8, the USD floor to enter a coin's holder world (`api/_lib/holder-pass.js`). Passes are 10-minute HMAC tokens verified byte-for-byte by the Colyseus server.+- `/play` gate: `PLAY_GATE_MINT` falls back to the $THREE mint, `PLAY_GATE_MIN` defaults to one whole token (`api/_lib/play-pass.js`).+- **Coin Clash** (`docs/clash.md`): enlistment gated on a live on-chain holding, described as "an early demo of a bigger community-warfare idea the platform is building for $THREE."++### 5.11 The Rider pass++`api/_lib/rider.js`: `REQUIRED_AMOUNT = 8000` $THREE. Granted two ways: by holding, or by paying 8,000 $THREE into the rider vault (recorded by a Helius webhook), so a payer who later sells is not revoked. Both sources are honored by `GET /api/rider/check`.++### 5.12 x402 rail acceptance++`X402_ACCEPT_THREE_SOLANA` advertises $THREE alongside USDC as a second accept entry on the same 402 challenge (`docs/x402-endpoints.md`). Agents paying for services can pay in the platform's own coin.++### 5.13 One-signature spend allowances++`src/three-allowance.js`: a holder authorizes a $THREE spending cap once, via Solana's native Subscriptions and Allowances program. Non-custodial, tokens stay in the wallet, the cap is the hard ceiling the platform delegate can touch. This removes the per-purchase signing friction that kills micro-spend economies.++### 5.14 The user-invoked burn primitive++`packages/three-token-mcp/README.md` calls it "the first MCP server whose actions burn a token." Tools: `three_price`, `three_balance`, and `three_burn` (marked destructive). The default split is 50% to the incinerator and 50% to treasury; `burnBps = 10000` burns everything. Bounded by `MAX_BURN_USD` (default $100) and gated by `REQUIRE_CONFIRM` (default on). The mint is asserted canonical before signing so a compromised endpoint cannot redirect the burn, and destinations are read at runtime from `/api/token/config`, never hardcoded. Note the distinction: the **platform** never burns; **users and their agents** can choose to.++### 5.15 Circulation engine demand++`docs/circulation-engine.md`. A pool of real platform-owned agents with custodial wallets runs real actions through the same code paths a user-owned agent uses: `buy_skill` (the buyer acquires $THREE via the trade engine and pays the seller in $THREE SPL), `buy_asset` (real $THREE SPL), tips and payments in real SOL, real pump.fun launches (fewer than eight per day), and real ERC-8004 registrations. `ensureThree()` sizes each $THREE purchase to the shortfall plus 8% headroom. This produces genuine on-chain $THREE buys and marketplace GMV, with the honesty constraint the doc itself states: manufactured demand only reaches platform-owned sellers, never user wallets, so nothing leaves the loop as a payout. It is real money and real buys; it is not third-party demand, and the platform says so.++---++## 6. Revenue routing: how platform income turns into $THREE demand++`api/_lib/token/config.js` defines the split policies. Every basis-point set sums to 10,000 and the rounding remainder goes to the highest leg so per-leg atomics reconcile exactly.++| Policy | Applies to | Seller / creator | Treasury (funds buybacks) | Rewards (holder reflections) |+|---|---|---:|---:|---:|+| `consumption` | Forge paid tiers, voice clone, MCP-3D, Granite, selfie-to-avatar | none | **70%** | **30%** |+| `spin` | paid wheel spins | none | **50%** | **50%** |+| `marketplace_sale` | skills, animations, avatars, assets, collectible resales | **90%** | 5% | 5% |+| `scarcity_mint` | scarcity drops, rare-name auctions, pay-to-mint | none | **80%** | **20%** |+| `copy_performance_fee` | copy-trading fee on realized profit only | leader **80%** | 15% | 5% |++Two things to notice. First, the treasury leg is explicitly "funds buybacks," so consumption revenue in $THREE is recycled into market demand rather than sitting idle. Second, the rewards leg funds holder reflections: the public `GET /api/three-token/revenue-share` endpoint exposes `revenue_share_pool_pct` (currently 10), `revenue_share_pool_usd`, and `per_token_yield` alongside price, supply, and holder count.++The wallets fail closed in production. If `THREE_TREASURY_WALLET` or `THREE_REWARDS_WALLET` is unset, the platform returns a typed 503 rather than routing real funds to a placeholder. Nobody's money goes to a default address by accident.++---++## 7. The buy-side engines: daily buyback and the micro-buy loop++### 7.1 The daily buyback (`api/_lib/token/buyback.js`)++- Converts accumulated platform USDC revenue into market buys of $THREE on Jupiter, then routes the bought tokens to the treasury. The code states plainly: "NO platform burn: supply is never destroyed by this lane."+- **Published commitment: 50% of platform revenue** (`THREE_BUYBACK_COMMIT_BPS` default 5,000).+- Per-run maximum $250 (`THREE_BUYBACK_MAX_USD`), dust floor $10, slippage 3%.+- Custody and accounting are deliberately decoupled: the spend is driven by the buyback wallet's live USDC balance, while the public "revenue earned" figure reads the `agent_revenue_events` fee ledger. This keeps the earned-versus-deployed ratio honest and auditable.+- Execution is gated by `THREE_BUYBACK_ENABLED`. Until an operator funds the wallet and opts in, a scheduled run is a recorded no-op. (See risk 4 in section 14.)++### 7.2 The micro-buy loop (`docs/three-microbuy.md`)++| | Daily buyback | Micro-buy loop |+|---|---|---|+| Cadence | a few large buys per day | many tiny buys per minute (target ~60/min) |+| Ticket | $10 to $250 | ~$0.01 |+| Trigger | scheduled cron | a settled x402 call |+| Direction | buy-only | buy-only |++"Neither ever sells $THREE." Each micro-buy is triggered by a paid x402 call to `/api/x402/three-buy` (a $0.001 toll that goes to the ring treasury), after which the endpoint executes exactly one USDC-to-$THREE Jupiter market buy from a dedicated micro-buy wallet. Bought tokens sweep to the treasury every 30 ticks.++Safety design: off by default; a $50 daily cap reserved atomically in Redis before any broadcast; a fail-closed `cap_unverifiable` state if neither Redis nor the ledger can confirm today's spend; a fail-closed toll so a direct payer can never amplify past the cap; `three-buy` is marked `autobuy: false` in the ring catalog so generic rotation never fires real buys; an immutable row per call in `three_microbuy_runs`; and a 0 to 255 atomic jitter per buy so byte-identical Jupiter transactions never collide on signature.++Public accountability: `/api/three-token/stats` exposes `token.microbuy` with lifetime and today's buys, $THREE bought, USDC deployed, and cap used. Anyone can check whether the loop is running and how much it has bought.++### 7.3 Why "buyback, never burn" is the right design++Burn-based tokenomics look good on a slide and bad in a treasury. A burn permanently converts revenue into nothing; a buyback converts revenue into an asset the platform still controls, which can fund liquidity, reflections, holder rewards, or future buybacks. The three.ws policy chooses buy pressure without deflation and says so in code. The user-invoked burn remains available for anyone who wants deflation on their own terms.++### 7.4 External buyback precedent++On 2026-06-08, three.ws won the DEXTools Social Boost. DEXTools executed a **$5,543 buyback** and its wallet subsequently held **2.47M $THREE** (`blog/three-ws-dextools-social-boost-buyback.html`). Third-party capital has already been deployed into the token on the strength of the community.++---++## 8. The revenue engine underneath: x402 and the agent economy++The buyback and micro-buy engines are only as strong as the revenue behind them. This is what feeds them.++### 8.1 The x402 price catalog (`docs/x402-endpoints.md`)++All defaults, all overridable per endpoint via `X402_PRICE_<SLUG>`:++- Intelligence: `token-intel`, `crypto-intel`, `three-intel` at $0.01; `fact-check` at $0.10+- DeFi composites: `defi-radar`, `yield-scan`, `stablecoin-health` at $0.005; `market-pulse` at $0.005+- Market data: about 17 `market-*` endpoints at $0.001+- Trust: `agent-reputation` $0.01; `onchain-identity-verify` $0.005; `pump-agent-audit` $0.02+- 3D and agents: `embody` $1.00; `pipeline-rig` $0.05; `pipeline-remesh`, `gameready`, `stylize` $0.03; `remix-asset` $0.25 with a creator royalty of up to 20% on-chain+- Launch and vanity: `pump-launch` $5.00; vanity addresses $0.01 to $0.50 for 3 characters or fewer, $2.50 to $10 for 4 to 5, premium $1 to $50 by rarity+- Micro: `billboard` $0.05, `tutor` $0.01 per answer, `llm-proxy` $0.005, `club-cover` $0.01, `dance-tip`, `three-buy`, `pay-by-name`, `notify` at $0.001+- **The datapoint fabric**: `/api/x402/d/<family>/...` exposes over one million individually priced datapoints at $0.0005 each++### 8.2 Money routing on those endpoints (`docs/money-map.md`)++Generic x402 endpoints route 100% to the platform. Creator-facing endpoints route 0% to the platform: `skill-call`, `service`, `asset-download`, `animation-download`, and `pay-by-name` pay the author or creator directly via `payTo` override; `cosmetic-purchase` gives creators 50% (cap 90%); `dance-tip` gives 100% to the dancer. The platform takes its cut where it does the work and passes through where a creator does.++### 8.3 The autonomous x402 loop (`docs/autonomous-x402.md`)++The platform pays real USDC to call its own and bazaar-discovered endpoints on a cadence, feeding the sniper oracle and keeping the rails exercised. A daily USDC spend cap is enforced and every call is logged to `x402_autonomous_log`. The documentation is explicit: "Payments are real on chain, no mocks, no simulations."++### 8.4 The agent economy volume ledger++`/agent-economy-volume` publishes all-time USDC settled between agents from `agent_hires`, counted only where `status = 'completed'`, meaning the USDC settled on-chain and the signature is on file. Public, unauthenticated, cached for 15 to 30 seconds. The doc notes that an empty ledger returns "a real zero shape": the platform would rather show zero than show a fabricated number.++### 8.5 Trust primitives: why an outside agent pays us (`docs/trust-primitives.md`)++- **`agent-reputation`** ($0.01 per call): a cross-chain 0 to 100 score for a Solana wallet, SPL or pump.fun mint, EVM address, ERC-8004 id, or three.ws agent. Deterministic, available-weighted across six dimensions (activity, age, counterparties, holdings, reliability, attestations), with unreadable dimensions surfaced as explicit caveats rather than silently zeroed. Batch mode handles up to 25 subjects, plus fleet-wide sweep, leaderboard, and decay-report modes.+- **`onchain-identity-verify`** ($0.005 per call): verifies an identity-to-address claim across ENS, SNS, EVM deployer and owner, SPL mint and freeze authority, Metaplex update authority, ERC-8004 `ownerOf` and `getAgentWallet`, and the three.ws index. Three-valued verdict (`true`, `false`, `"unverifiable"`), "never a false positive."++The stated moat: "Competing reputation endpoints only know agents minted on their own platform, useless the moment the counterparty is from somewhere else." Cross-chain trust data is a product every agent economy will need and few will build.++### 8.6 USDC agent vaults (`docs/vaults.md`)++Strangers stake USDC behind a verified trading agent. The opening gate is real: at least 12 closed trades, net-positive realized P&L, at least 5 distinct coins, churn share at most 40%. Terms: performance fee 0 to 50% (default 10%) charged only on a backer's realized gain at redemption; max drawdown 1 to 90% (default 25%); required per-trade and daily budgets. A fresh keypair per vault, AES-256-GCM at rest, every decrypt audit-logged; exact BigInt accounting; NAV re-derived on every read; later deposits priced against pre-deposit NAV so nobody is diluted; seven ordered guards run before the key is decrypted; a share-price drawdown breaker with a ratcheting high-water mark; and a fully public audit ledger written before funds move. The documented example trade buys the $THREE mint.++---++## 9. The self-funding treasury and its zero-leak record++`docs/autonomous-economy.md` and `docs/money-map.md` describe a closed-loop wallet system:++| Wallet | Role |+|---|---|+| Funding root (`WwwuGbqHrwF5...T3WwW`) | Reserve; funder only; never trades, launches, or settles |+| Engine wallet (`wwwqv...HGUn`) | pump.fun launcher, buyback relayer, reflection and lottery payouts |+| Treasury / receiver (`wwwwwDxFWRn7grgr3Esrsg5C6NvDoDHSA4gaCffccrU`) | All inbound x402 |+| Ring payer (`X4o2...astML`) | The autonomous x402 payment ring |+| a2a-payer (`Huch...Lmh6Z`) | Co-signs agent-to-agent USDC |+| Fee-payer (`GGf9...5XQj`) | Network fees on x402 settlements |++The loop is root to engines to work to surplus to root. A `treasury-topup` cron runs every 30 minutes; surplus above operating float sweeps back. Two rules are enforced in code, not convention: **top-up is allowlist-locked** to the `SOLANA_SIGNERS` registry, and **sweepback is destination-locked** to the funding root. "Money can only move inside the set of wallets the platform owns."++The system audits itself. A `wallets-leak-scan` runs every 15 minutes, an `x402-ring-leak-scan` every 10 minutes, and an `economy-reconcile` every 30 minutes. **As of 2026-07-12 the scanners had examined 44,122 transactions across every wallet and found zero leaks, ever.** The figure is not a frozen marketing number; it is re-derivable from `wallet_scan_cursor.scanned_total` and `.leaks_total` at any time.++For a token holder this matters in a specific way: the treasury that is supposed to buy $THREE is protected by machinery designed to make it impossible for funds to leave the platform's own wallet set without a recorded verdict.++---++## 10. Distribution, listings, and verification++A token can have perfect mechanics and no liquidity. $THREE has both real venues and real trust badges.++### 10.1 Centralized exchanges++| Venue | Status | Notes |+|---|---|---|+| **MEXC** spot THREE/USDT | Live since 2026-06-02 | Confirmed via MEXC exchange info: contract address, full name "three.ws", spot trading allowed. Roughly $56.5k 24h quote volume at time of the August review. |+| **LBank** THREE/USDT | Live | $600,824 in 24h volume on 2026-08-16 per CoinGecko |+| **KCEX** THREE/USDT | Live | Tracked by CoinGecko |+| **Bybit Alpha** | Live | Official announcement |+| **KuCoin Alpha** | Live | Official announcement |+| **Binance Web3** (web3.binance.com) | Live | Wallet aggregator |+| **Coinbase** | Listed (2026-05-05) | Visible in Coinbase Wallet |++### 10.2 Solana DEX liquidity (CoinGecko-tracked, 24h USD volume on 2026-08-16)++PumpSwap three/SOL $48,861 · Meteora three/SOL $18,130 · Orca three/SOL $13,445 · a second Meteora pool. GeckoTerminal pool: `5ByL7MZoLABYnwMPZKPKjf4MGkZ7FeBzrAnos19Pre2z`.++### 10.3 Derivatives++**derp.trade** offers leverage on $THREE. A perpetuals market is a meaningful maturity signal for a Solana token.++### 10.4 Trust badges and data aggregators++- **Jupiter Verified** (the default Solana swap router's trust list)+- **Phantom Verified** (the default Solana wallet's trust list)+- **pump.fun verified project** badge on the coin page, plus a pump.fun-published feature article, "Three Builds With Tech Giants," on the official coin page. The platform reads pump.fun's verification status live on every request to `/api/three-token/stats` rather than hardcoding it; the same shared badge component renders on `/three-token` and the dashboard so the two can never disagree. The copy is deliberately precise: "verified project," not partner, endorsement, or investment.+- **CoinGecko** (id `three-ws`) and **CoinMarketCap** (live since 2026-05-17, with a community profile)+- **Investing.com**+- **DEXTools** (Social Boost winner)++### 10.5 The August 2026 listing update++`docs/coingecko-listing-update-2026-08.md` documents a disciplined sweep. The team confirmed the MEXC market through the exchange's own API and submitted it to CoinGecko (request CU1608260002, filed 2026-08-16). It swept nineteen other exchanges and confirmed no market on each, traced a WEEX rumor to SEO pages and declined to submit it, and explained why Alpha venues cannot be submitted under their parent exchanges without misstating where liquidity sits. That is the same honesty discipline that shows up in the codebase, applied to listings.++Official channels: X `@trythreews`, Telegram `@three_ws` and community `t.me/three_ws_community`.++---++## 11. Ecosystem, partners, and enterprise surfaces++The pump.fun article title ("Three Builds With Tech Giants") is earned. From `docs/listings.md` and `docs/partners.md`:++**Named program statuses (the only two the platform claims):**+- **OpenAI Select Partner**+- **NVIDIA Inception member** (2026-07), with a self-hosted Cloud Run GPU fleet (L4s plus an RTX PRO 6000 Blackwell) behind text-to-3D, rigging, and motion, surfaced at `/nvidia`++**Cloud marketplaces:**+- **Alibaba Cloud International Marketplace**: live, with a product listing, storefront, and an editorial blog feature+- **AWS Marketplace**: integration built, deployed, and conformant with the Concurrent Agreements rules AWS made mandatory 2026-06-01; the product listing itself is not yet created in the management portal+- **Google Cloud Marketplace**: open to partnership; production already runs on Cloud Run, and three.ws is a Google Cloud for Web3 Startups member with a grant of up to $200k in credits over two years+- **Azure Marketplace**: roadmap only++**Infrastructure and credits:** Quicknode Startup Program (accepted 2026-07), Google Cloud for Web3 Startups, NVIDIA Inception.++**Directories and registries:** BNB Chain Dappbay (live, categories AI Agent Launchpad, AI Data, AI Infra); x402scan; the MCP Registry (`io.github.nirholas`); VS Code Marketplace and Open VSX (`threews.vscode-x402`); OpenAI Plugin Directory (gating requirement already met via the public OAuth 2.1 MCP server); OpenAI Cookbook PR #2874 submitted 2026-07-21 (unmerged).++**Media:** IBM Community blog, HackerNoon (auto-imported from the three.ws announcements RSS), Alibaba Cloud Marketplace Blog, pump.fun coin-page article.++**Partner cards on `/partners` (eight):** OpenAI, IBM, AWS, Google Cloud, Alibaba Cloud, NVIDIA, HackerNoon, Quicknode. The partner doc itself draws the boundary: no endorsement is claimed anywhere, and only the two program statuses above come from the partner side.++**OKX:** three.ws is agent #2632 "three.ws 3D Studio" on OKX.AI with A2MCP endpoints. The listing was rejected in review on 2026-07-04 for not yet matching the OKX Agent Payments Protocol standard; resubmission is pending. The endpoints are reachable directly meanwhile.++**MetaMask:** SIWE sign-in, MetaMask and Consensys named as ERC-8004 co-authors, and MetaMask Agent Wallet early access listed among distribution posts.++What this adds up to: a Solana memecoin-launched token whose platform has a foothold in the OpenAI, NVIDIA, Google, AWS, Alibaba, IBM, and BNB ecosystems. That combination is rare.++---++## 12. Why the narrative fits the moment++Three converging trends make three.ws the right shape of product for 2026:++**1. Agents are becoming economic actors.** x402 (HTTP 402 pay-per-call) has moved from proposal to production. Agents now pay for data, compute, and services without a human clicking approve. three.ws is on both sides of that trade: it sells services to agents and its own agents buy from others. Its self-hosted Solana facilitator means it does not depend on a third party to settle.++**2. Agents need identity and trust.** ERC-8004 (co-authored by MetaMask and Consensys) and Metaplex Core give agents portable on-chain identities. three.ws registers on both, and sells the cross-chain reputation and identity-verification primitives that let strangers decide whether to transact. This is the credit-bureau layer of the agent economy, and it is priced at a penny a call.++**3. Agents need bodies.** Text chat is not the end state of AI interaction. Voice, expression, and presence are. three.ws's core competence, rigged and animated 3D avatars with emotion blending and lip-sync that any site can embed, is the interface layer. The pipeline runs on its own GPU fleet, not a rented API.++$THREE sits at the intersection: it is the fee token, the discount token, the access token, the escrow token, the wage token, and the buyback target for a platform that does all three.++**Solana-first is a deliberate advantage.** The platform's operating rules state that Solana is the home chain and every EVM chain is secondary. Low fees and fast finality are what make $0.0005 datapoints and $0.01 micro-buys economically possible in the first place. A pay-per-call agent economy at these price points cannot run on mainnet Ethereum.++**Open source is a deliberate advantage.** Anyone can audit the split policies, the buyback logic, the cap enforcement, the leak scanners, and the tier resolvers. Trust that can be verified compounds; trust that must be taken on faith decays.++---++## 13. Roadmap and the catalysts still in front of the token++From the README roadmap:++| Phase | Theme | Status |+|---|---|---|+| 0 | Foundations: viewer, runtime, ERC-8004 and Metaplex Core identity, embed layer | Shipped |+| 1 | Selfie-to-avatar engine | Capture, reconstruction, rigging, storage, and draft mint wired end to end; likeness fidelity is the open track |+| 2 | Agent personalization and voice cloning | Voice clone, persona, and memory seeds shipped behind `/demos`; main-flow integration next |+| 3 | **On-chain economy**: agent tokens, reputation markets, royalties | Bonding-curve sim, EAS reputation viewer, 0xsplits and EAS SDKs landed; per-call skill royalties accrue in `royalty_ledger`; contracts and audits next |+| 4 | Open inference network (decentralized GPU) | Node-operator client (CPU and CUDA) and `/api/nodes` job queue with signed, server-recomputed receipts shipped; Livepeer federation behind a flag |++Token-specific catalysts, in rough order of proximity:++1. **Buyback and micro-buy activation.** Both engines are built, tested, capped, and publicly accountable via `/api/three-token/stats`. Flipping `THREE_BUYBACK_ENABLED` and `THREE_MICROBUY_ENABLED` with funded wallets turns published policy into daily on-chain buys.+2. **Perk activation.** `worlds.private` at Silver is fully specified (migration drafted, gate written, test planned). `names.first_dibs` at Genesis and `drops.early` at Gold follow. Each activation gives a specific tier a specific reason to exist.+3. **CoinGecko MEXC market addition** (request filed 2026-08-16).+4. **Listing follow-through**: AWS Marketplace product creation, OKX.AI resubmission, OpenAI Plugin Directory submission, Cookbook PR merge.+5. **Phase 3 contracts and audits**: agent tokens, reputation markets, and royalty contracts on-chain would make $THREE the settlement asset of a far larger economy.+6. **Phase 4 open inference network**: independent node operators serving production traffic would turn three.ws from a platform into a protocol.+7. **Coin Clash** expanding into "a bigger community-warfare idea the platform is building for $THREE."++Phase targets stated in the README: 10k avatars per day at launch; 1,000 test users end to end at 4/5 likeness or better; 30% week-2 retention on minted agents; 1,000 agents minted with active on-chain reputation; 50% of production agent traffic served by independent nodes.++---++## 14. Risks, caveats, and what the repo admits about itself++A thesis that hides the risks is a pitch. These are the risks the three.ws documentation states about itself, plus the structural ones any holder should weigh.++1. **Most holder perks are Planned, not Live.** Only two of seven registered gated features (`forge.high`, `forge.gameready`) are enforced today. The compute discount and quota multiplier are live. The `enforced` flag exists precisely so the platform never promises an unwired perk, but a holder buying for `worlds.private` or `names.first_dibs` is buying a roadmap.++2. **The burn policy is internally inconsistent.** `api/_lib/token/config.js` states "NO PLATFORM BURNS, supply is never destroyed," while `api/three-token/[action].js` ships an `AGENT_DEPLOY_BURN = 1000` constant and a `/burns` ledger reporting 1,000 $THREE burned per agent deploy. Blog posts from May and June 2026 describe a "planned buyback-and-burn." No document reconciles these. A holder should treat the current code policy (buyback, no platform burn) as authoritative and the deploy-burn ledger as an open question.++3. **Older blog claims predate current mechanics.** The May 2026 listing and CoinMarketCap posts describe buyback-and-burn and the Rider VR gate as the token's utility; the current code implements buyback-without-burn plus the tier ladder. The direction of travel is toward more utility, but the public record has drift.++4. **The buyback and micro-buy engines are off by default and operator-gated.** The 50% commitment is policy independent of whether any given run is enabled or funded. Until the flags are on and the wallets funded, the buy-side pressure described in section 7 is designed, tested, and dormant. The public stats endpoint will show exactly when that changes.++5. **Circulation-engine activity is platform-owned by design.** The buys are real and on-chain, but the sellers are platform agents. It is not organic third-party demand and the documentation says so explicitly.++6. **The marketplace platform fee and pump trade fee default to 0%.** The take-rate exists as a knob but is off unless configured. Marketplace GMV does not currently produce platform revenue.++7. **Several distribution milestones are pending, not done.** AWS Marketplace listing not yet created, OKX.AI rejected 2026-07-04 with resubmission pending, OpenAI Cookbook PR unmerged since 2026-07-21, Azure roadmap-only.++8. **Alpha venue liquidity is invisible to CoinGecko.** Bybit Alpha and KuCoin Alpha volume cannot be submitted, so aggregator volume understates real liquidity. This cuts both ways: the token is more liquid than CoinGecko shows, and that liquidity is harder to verify.++9. **Historical accounting corrections.** The platform has published its own mistakes: marketplace analytics once counted 10,454 free trials as "sales" and reported 6.2M $THREE of volume against zero confirmed purchases (fixed; money aggregates now gate on `status = 'confirmed'`); the circulation engine once bought too little $THREE to afford its own listings, so GMV read zero while fees went out (fixed by shortfall sizing). These are to the team's credit as disclosures, and to the holder's attention as evidence that reported metrics have needed correction before.++10. **Vault risk, in the platform's words:** "the platform can sign for the vault," "a vault owner can change the performance fee and the risk terms after you have deposited," and "there is no server-side 'are you sure' step, no preview mode, and no undo."++11. **A fail-open path exists.** The older `three-gate.js` returns `eligible: true` on an RPC failure. The newer tier-pass path fails to Member (closed). Gating that relies on the older path can be bypassed during an RPC outage.++12. **Funding is not secured.** The README states plainly that inference GPUs, training compute, multi-firm smart-contract audits, token-launch liquidity, indexer infrastructure, node-operator credits, and engineering headcount are "required for the vision; neither is funded yet." The Google Cloud credit grant (up to $200k over two years) covers a meaningful part of the compute line but not the audits or headcount.++13. **The mandatory risk disclosure applies to $THREE payments.** Before any first real-funds action, including `$THREE token payments`, users must acknowledge that "three.ws is experimental software, losses can be total, autonomous agents act without asking again." The platform requires that acknowledgment from its users; a holder should hold the same view.++14. **General token risk.** A pump.fun-launched Solana token is a high-volatility asset. Liquidity is concentrated on a handful of venues. The platform's revenue, while real, is early. The buyback commitment is a policy the operator controls, not a smart contract the operator cannot change.++---++## 15. What is not documented (and what a diligent holder should ask)++The repository is silent on the following. Their absence is a fact, not a red flag by itself, but a serious holder should seek answers from the team's official channels.++- **No supply, distribution, allocation, vesting, or emissions table.** The only supply-shaped number in the repo is an illustrative example response in `docs/api-reference.md` for the token-security endpoint: supply of about 999.68M tokens, mint authority revoked, freeze authority revoked, top-1 holder 6.6%, top-5 14.7%, top-10 22.3%, liquidity about $196.7k. Treat these as a documentation sample, not a live assertion. Live figures come from `/api/three-token/stats` and the on-chain mint.+- **No team or treasury allocation, lockups, or LP-burn statement.**+- **No governance, staking, or voting mechanism.** $THREE is a utility and access token, not a governance token, and the repo does not claim otherwise.+- **No documented emissions to users.** The in-game economy is explicit that $THREE is never awarded by gameplay. Agora and the labor market pay $THREE, but from escrow funded by posters, not from inflation.+- **No cumulative revenue, cumulative buyback USD, or holder count in the docs.** All of these are read live from public endpoints (`/api/three-token/stats`, `/revenue-share`, `/leaderboard`, `/agent-economy-volume`) rather than quoted in prose. That is the correct design, and it means the numbers in this document are a snapshot that the endpoints will outdate.++Questions worth asking: What is the treasury's current $THREE and USDC balance? When will `THREE_BUYBACK_ENABLED` and `THREE_MICROBUY_ENABLED` be flipped on? How is the deploy-burn ledger reconciled with the no-platform-burn policy? What is the team's own holding and is it locked?++---++## 16. How to evaluate the thesis over time++Because the platform exposes its economy through public endpoints, the thesis is falsifiable. A holder can track it without trusting anyone:++| Signal | Where to look | What confirms the thesis |+|---|---|---|+| Buybacks are running | `GET /api/three-token/stats` (`buyback` summary) | Non-zero USDC deployed, rising lifetime $THREE bought |+| Micro-buy loop is running | same endpoint, `token.microbuy` | Today's buys greater than zero, cap-used percentage moving |+| Platform revenue is growing | `GET /api/three-token/revenue-share` (`platform_revenue_usd`) and `/agent-economy-volume` | Month-over-month growth in settled USDC |+| Holder base is growing | `GET /api/three-token/leaderboard`, `total_holders` in stats | Rising holder count, falling top-10 concentration |+| Perks are activating | `api/_lib/three-access.js` `enforced` flags | More entries flip to `true` |+| Development continues | [three.ws/changelog](https://three.ws/changelog), @three_ws Telegram | Daily entries keep landing |+| Treasury stays clean | `wallet_scan_cursor` figures cited in `docs/autonomous-economy.md` | Scanned total rising, leaks total stays zero |+| Listings expand | CoinGecko `three-ws` markets tab | MEXC added, new venues appear |+| Verification holds | `verified` field in `/api/three-token/stats` | Stays `true` |++If buybacks never turn on, perks never activate, or revenue does not grow, the thesis weakens and the endpoints will show it. If they do, the endpoints will show that too.++---++## 17. Summary of the bull case++1. **A real, shipping, open-source product** with 723 pages, 70 packages, 36 MCP servers, and 2,673 changelog entries in four months. The code is public and every mechanic in this document can be read.+2. **A complete agent-economy stack**: bodies (3D avatars), identities (ERC-8004 and Metaplex Core), wallets (custodial with a single spend-policy boundary), rails (x402 with a self-hosted Solana facilitator), trust (cross-chain reputation and identity verification), and markets (skills, assets, labor, bounties, vaults).+3. **The token is wired into every layer**: hold-to-access tiers, 20% discounts on plans and passes, marketplace-only currency, labor and bounty escrow, game cosmetics, gated embeds, holder worlds, rider passes, deploy-fee waivers, x402 acceptance, and one-signature allowances.+4. **Three simultaneous demand vectors**: standing demand from holding, spend demand from discounts, and buy-side demand from a published 50%-of-revenue buyback commitment plus a per-call micro-buy loop. The platform never sells and never burns.+5. **Every deploy buys $THREE.** On-chain agent deploy fees are paid to the buyback wallet, and large holders deploy free.+6. **Real liquidity and real trust**: MEXC, LBank, KCEX, Bybit Alpha, KuCoin Alpha, Binance Web3, Coinbase Wallet, PumpSwap, Meteora, Orca, perps on derp.trade, Jupiter Verified, Phantom Verified, pump.fun verified project, CoinGecko, CoinMarketCap, a DEXTools Social Boost win with a $5,543 third-party buyback.+7. **Enterprise and ecosystem footprint**: OpenAI Select Partner, NVIDIA Inception, Google Cloud for Web3 Startups, Alibaba Cloud Marketplace live, AWS Marketplace conformant, BNB Dappbay, MCP Registry, x402scan, IBM and HackerNoon coverage, a pump.fun feature article.+8. **A treasury that audits itself**: 44,122 transactions scanned, zero leaks ever, with allowlist-locked top-ups and destination-locked sweepbacks enforced in code.+9. **A team that publishes its own mistakes** (trial-counting, under-sized buys, listing rumors it declined to submit) and gates every perk behind an integrity flag so it cannot promise what it has not wired.+10. **A narrative that matches the moment**: agents becoming economic actors need exactly what three.ws sells, on the only chain where sub-cent pricing works.++And the honest counterweight: the buy engines are dormant until switched on, most perks are still roadmap, the burn story has drift, supply and allocation are undocumented, and the platform itself tells every user that losses can be total.++$THREE is a good choice to *look at* because it is one of the very few tokens where looking is possible. The mechanics are in the code, the numbers are on public endpoints, and the risks are written down by the people who built it. Do the looking.++---++## 18. Appendix: source index++Every file referenced in this thesis, relative to the repository root:++- `README.md` (core functions, roadmap, funding needs)+- `STRUCTURE.md` (surface map, marketplace accounting correction)+- `CLAUDE.md` (promoted-coin policy, Solana-first policy)+- `package.json`, `data/pages.json`, `data/changelog.json`, `public/mcp-catalog.json`+- `api/_lib/token/config.js` (economy policy, split policies)+- `api/_lib/token/buyback.js` (daily buyback)+- `api/_lib/three-tier.js`, `api/_lib/three-access.js`, `api/_lib/require-three.js`, `api/_lib/comp-access.js`, `api/_lib/three-gate.js`+- `api/_lib/holder-pass.js`, `api/_lib/world-gate.js`, `api/_lib/play-pass.js`, `api/_lib/rider.js`+- `api/_lib/economy-master.js`, `api/_lib/economy-sweepback.js`+- `api/three-token/[action].js`, `api/pricing.js`, `api/forge.js`, `api/credits/index.js`+- `src/three-access.js`, `src/three-lock.js`, `src/three-allowance.js`, `src/pump/verified-badge.js`, `src/solana/vanity/brand.js`+- `docs/hold-to-access.md`, `docs/plan-checkout.md`, `docs/premium.md`, `docs/viability.md`, `docs/money-map.md`+- `docs/circulation-engine.md`, `docs/three-microbuy.md`, `docs/autonomous-economy.md`, `docs/autonomous-x402.md`, `docs/x402-endpoints.md`, `docs/x402-revenue.md`, `docs/agent-economy-volume.md`+- `docs/labor-market.md`, `docs/agora.md`, `docs/in-game-economy.md`, `docs/token-gated-3d-embeds.md`, `docs/clash.md`, `docs/vaults.md`, `docs/trust-primitives.md`+- `docs/coin-launches.md`, `docs/mint-mark.md`, `docs/agent-wallets.md`, `docs/risk-acknowledgment.md`, `docs/exit-lab.md`+- `docs/listings.md`, `docs/partners.md`, `docs/coingecko-listing-update-2026-08.md`, `docs/okx-marketplace.md`, `docs/announcement-coverage.md`, `docs/api-reference.md`+- `packages/metaplex-agent-mcp/README.md`, `packages/three-token-mcp/README.md`, `packages/agora-mcp/README.md`+- `blog/three-token-listings.html`, `blog/three-ws-on-coinmarketcap.html`, `blog/three-ws-dextools-social-boost-buyback.html`+- `marketing/pumpfun-verified/`++---++<a id="sec-414"></a>> **Source:** `docs/timeline.md` · [↑ table of contents](#table-of-contents)@@ -88985,7 +89811,7 @@ server reads that route table on boot).----<a id="sec-412"></a>+<a id="sec-415"></a>> **Source:** `docs/token-gated-3d-embeds.md` · [↑ table of contents](#table-of-contents)@@ -88993,7 +89819,7 @@ server reads that route table on boot).> **Audience:** Creators who want a holder-only interactive 3D scene, and developers wiring the flow up themselves.-three.ws already lets you embed a live, interactive 3D avatar or on-chain agent on any page with one script tag ([Share & embed](#sec-383), [Embedding Guide](#sec-188)). Token gating adds one thing on top: **the scene only renders for a visitor who holds enough of a specific token** — verified with a real on-chain balance read, not a client-side check anyone could fake.+three.ws already lets you embed a live, interactive 3D avatar or on-chain agent on any page with one script tag ([Share & embed](#sec-385), [Embedding Guide](#sec-188)). Token gating adds one thing on top: **the scene only renders for a visitor who holds enough of a specific token** — verified with a real on-chain balance read, not a client-side check anyone could fake.The canonical use case is **$THREE-holder-only content**: a private avatar, a branded scene, a preview only your community can see. The gate also accepts any SPL token at runtime — a project can gate with their own coin — but three.ws never markets or defaults to anything other than `$THREE`.@@ -89098,13 +89924,13 @@ Every check that matters happens on the server:- Spec (wire formats, resolver contract, token format): [specs/EMBED_SPEC.md § Token Gating](../specs/EMBED_SPEC.md#token-gating)- MCP tool: [docs/mcp.md § create_gated_embed](mcp.md#create_gated_embed)-- Embed runtime this builds on: [`<three-d>` / embed v1](https://three.ws/embed/v1/preview), [Share & embed](#sec-383)+- Embed runtime this builds on: [`<three-d>` / embed v1](https://three.ws/embed/v1/preview), [Share & embed](#sec-385)- Nothing rendering where you pasted the snippet? The [Embed Doctor](https://three.ws/embed-doctor) loads your page in a real browser and names the line to change. It checks a `<three-d>` gated snippet exactly like an ungated `<agent-3d>` one, and a locked embed reads as healthy: the lock is the product working, not a failure.- Related: [Hold-to-access tiers](#sec-241) (site-wide $THREE tiers, distinct from per-embed gates)----<a id="sec-413"></a>+<a id="sec-416"></a>> **Source:** `docs/tokens-xyz.md` · [↑ table of contents](#table-of-contents)@@ -89270,12 +90096,12 @@ The batch market read is deliberately **not** cached here. Its caller in the mar## Related-- [Market Data API](#sec-273) - the pay-per-call x402 endpoints behind every `/markets` page+- [Market Data API](#sec-274) - the pay-per-call x402 endpoints behind every `/markets` page- [Free LLM providers](#sec-231) - the same failover-chain pattern applied to text completion----<a id="sec-414"></a>+<a id="sec-417"></a>> **Source:** `docs/trader-card.md` · [↑ table of contents](#table-of-contents)@@ -89294,13 +90120,13 @@ The Wallet Intelligence view renders, for any base-58 address:## Where the numbers come from-Nothing here is typed in by the trader. The Oracle smart-money brain continuously indexes pump.fun trading: per-wallet, per-coin buy/sell aggregates observed on-chain, joined with each coin's outcome (graduated, rugged, ATH multiple). Rollup workers grade every indexed wallet into a reputation row — the same pedigree ledger that powers Oracle's WHO pillar ([the conviction engine](#sec-320)). Per-coin P&L is simply `sold − bought` in SOL, with USD as a live enrichment that hides itself rather than guessing when the price feed is down.+Nothing here is typed in by the trader. The Oracle smart-money brain continuously indexes pump.fun trading: per-wallet, per-coin buy/sell aggregates observed on-chain, joined with each coin's outcome (graduated, rugged, ATH multiple). Rollup workers grade every indexed wallet into a reputation row — the same pedigree ledger that powers Oracle's WHO pillar ([the conviction engine](#sec-321)). Per-coin P&L is simply `sold − bought` in SOL, with USD as a live enrichment that hides itself rather than guessing when the price feed is down.If a wallet hasn't been indexed yet (the engine tracks wallets it has observed trading pump.fun launches), the page says "not indexed yet" instead of rendering an empty scorecard. "Indexed" means the wallet has been *observed trading*, which happens well before the rollup workers grade it into a reputation row: a wallet with real trades and no grade yet still gets the full ledger and window aggregates, with the reputation panel honestly reading `unproven` until the scorer catches up.**Realized vs. open.** Win, loss, and win-rate figures count *closed* positions only, because an untouched bag is not a loss. A position counts as closed once effectively all of the bought supply has been sold. `realized_pnl_sol` is the sum over those closed positions; `net_pnl_sol` books every lamport in and out of the loaded window, so it charges an open bag's entry as if it were written off. For a wallet that is still holding, `net_pnl_sol` is the floor and `realized_pnl_sol` is the outcome so far.-**One precision worth knowing:** the pasted-wallet view reports *raw* on-chain aggregates. The platform's own [trader leaderboard](https://three.ws/leaderboard) — which ranks three.ws agents — applies a stricter pipeline on top: round-trips on coins the trader launched themselves are split out of the credited record ("self-dealing excluded"), snipe hit-rate only counts mints with a proven on-chain birth, and a verification badge requires minimum closed trades, unique coins, and a churn ceiling. Two truth layers, both honest about what they measure: external wallets get the raw read; verified agents get the audited one. Details in [trading-arenas](#sec-416).+**One precision worth knowing:** the pasted-wallet view reports *raw* on-chain aggregates. The platform's own [trader leaderboard](https://three.ws/leaderboard) — which ranks three.ws agents — applies a stricter pipeline on top: round-trips on coins the trader launched themselves are split out of the credited record ("self-dealing excluded"), snipe hit-rate only counts mints with a proven on-chain birth, and a verification badge requires minimum closed trades, unique coins, and a churn ceiling. Two truth layers, both honest about what they measure: external wallets get the raw read; verified agents get the audited one. Details in [trading-arenas](#sec-419).## Claiming: one signature, no gas@@ -89331,18 +90157,18 @@ Returns the identity summary, KPI aggregates, and the per-coin ledger (up to 60- `claimable` is true once there is a real on-chain record to claim, which includes an indexed-but-not-yet-graded wallet. A wallet with neither is the unindexed case.- `network` accepts `mainnet` (default) or `devnet`, and scopes both the reputation read and the coin ledger. Anything else falls back to `mainnet`.-The read is CDN-cacheable for two minutes. It never answers an empty record on a database fault: an unreachable brain returns `503 service_unavailable` with `Retry-After` and `Cache-Control: no-store`, so a transient outage can't be cached as "this trader has no track record". Agent-side, the same pedigree data flows through the intel MCP tools ([docs/mcp.md](#sec-281)).+The read is CDN-cacheable for two minutes. It never answers an empty record on a database fault: an unreachable brain returns `503 service_unavailable` with `Retry-After` and `Cache-Control: no-store`, so a transient outage can't be cached as "this trader has no track record". Agent-side, the same pedigree data flows through the intel MCP tools ([docs/mcp.md](#sec-282)).## Related-- [Trader Passport](#sec-415): the on-chain credential a claimed record earns, and how another app verifies it-- [Oracle](#sec-320) — the WHO pillar runs on this same wallet-reputation ledger-- [Trading arenas](#sec-416) — where a verified track record unlocks tournaments, vaults, and mirrors-- [Trading surfaces](#sec-420) — the solo trading stack+- [Trader Passport](#sec-418): the on-chain credential a claimed record earns, and how another app verifies it+- [Oracle](#sec-321) — the WHO pillar runs on this same wallet-reputation ledger+- [Trading arenas](#sec-419) — where a verified track record unlocks tournaments, vaults, and mirrors+- [Trading surfaces](#sec-423) — the solo trading stack----<a id="sec-415"></a>+<a id="sec-418"></a>> **Source:** `docs/trader-passport.md` · [↑ table of contents](#table-of-contents)@@ -89506,20 +90332,20 @@ The Proof tab of [`/trader/<agent_id>`](https://three.ws/trader) renders the pas## Related-- [Claim your wallet](#sec-414): the read-only track record that comes before any credential-- [Trading arenas](#sec-416): what a verified record unlocks+- [Claim your wallet](#sec-417): the read-only track record that comes before any credential+- [Trading arenas](#sec-419): what a verified record unlocks- [Copy trading](#sec-167): leaderboard weighting and performance fees- [API reference](#sec-096): every public endpoint----<a id="sec-416"></a>+<a id="sec-419"></a>> **Source:** `docs/trading-arenas.md` · [↑ table of contents](#table-of-contents)# Competitive & pooled trading: Arena, Sniper Arena, Theater, Vaults, Swarms-Solo trading has the [five-surface stack](#sec-420). This doc covers the five surfaces where trading becomes a *spectator sport or a team sport*: tournaments with $THREE prizes, a 3D floor of autonomous agents, a live theater with one-click copy trading, backable vaults, and capital-pooling swarms.+Solo trading has the [five-surface stack](#sec-423). This doc covers the five surfaces where trading becomes a *spectator sport or a team sport*: tournaments with $THREE prizes, a 3D floor of autonomous agents, a live theater with one-click copy trading, backable vaults, and capital-pooling swarms.One shared truth layer underneath all of them: every ranking, prize, and payout on these pages is computed from `agent_sniper_positions` — the table of real, transaction-signed agent trades — through one scoring module (`api/_lib/trader-stats.js`). Same numbers everywhere; wins are provable by Solscan link, and round-trips on a trader's own launched coins are split out of the credited record rather than counted (the anti-self-dealing rule).@@ -89581,18 +90407,18 @@ Honest limits: consensus trading runs in the long-lived sniper worker. On a depl## How they chain together-Prove yourself solo (the [trading surfaces](#sec-420) → the [leaderboard](https://three.ws/leaderboard)) → your agent earns the **verified-trader badge** → that badge is the key to bigger stages: enter **Arena** tournaments, get ranked on the **Sniper Arena** floor, perform in the **Theater** where others can mirror you, open a **Vault** so backers fund your size, or lead a **Swarm**. Reputation, computed from provable on-chain results, is the currency that moves you up — and [Oracle](#sec-320) conviction is the intelligence all of these agents are acting on.+Prove yourself solo (the [trading surfaces](#sec-423) → the [leaderboard](https://three.ws/leaderboard)) → your agent earns the **verified-trader badge** → that badge is the key to bigger stages: enter **Arena** tournaments, get ranked on the **Sniper Arena** floor, perform in the **Theater** where others can mirror you, open a **Vault** so backers fund your size, or lead a **Swarm**. Reputation, computed from provable on-chain results, is the currency that moves you up — and [Oracle](#sec-321) conviction is the intelligence all of these agents are acting on.## Related-- [Trading surfaces](#sec-420) — the solo stack (Radar, Mission Control, Trade Feed, Watchlist, Coin Intelligence)+- [Trading surfaces](#sec-423) — the solo stack (Radar, Mission Control, Trade Feed, Watchlist, Coin Intelligence)- [Custody](#sec-172) — the spend limits, freeze, and audit rails every mirrored/pooled trade runs through-- [Oracle](#sec-320) — the conviction engine · [Trading experiment](#sec-418) — one agent's journaled live run-- [Agent reputation](#sec-056) / [Solana reputation](#sec-398) — how the trust scores are computed+- [Oracle](#sec-321) — the conviction engine · [Trading experiment](#sec-421) — one agent's journaled live run+- [Agent reputation](#sec-056) / [Solana reputation](#sec-400) — how the trust scores are computed----<a id="sec-417"></a>+<a id="sec-420"></a>> **Source:** `docs/trading-copilot.md` · [↑ table of contents](#table-of-contents)@@ -89728,13 +90554,13 @@ plumbing — and never suggests, shills, or names another token on its own initi## Related-- [The trading surfaces: Radar, Mission Control, Feed, Watchlist, Intel](#sec-420)+- [The trading surfaces: Radar, Mission Control, Feed, Watchlist, Intel](#sec-423)- [Financial controls & custody guardrails](#sec-223)-- [The autonomous trading experiment](#sec-418)+- [The autonomous trading experiment](#sec-421)----<a id="sec-418"></a>+<a id="sec-421"></a>> **Source:** `docs/trading-experiment.md` · [↑ table of contents](#table-of-contents)@@ -89846,7 +90672,7 @@ arm API), **or** an arm earns the right to have it tuned: once the autonomyengine places an arm at `trusted` or above and its winners demonstrably run pastits average exit, the optimizer adjusts the multiple by itself within its boundsand records why. See-[Earned autonomy](#sec-395). A losing arm cannot reach the field at+[Earned autonomy](#sec-397). A losing arm cannot reach the field atall, so the ladder is only ever switched on for a strategy whose record shows itactually catches runners.@@ -90069,7 +90895,7 @@ much — and tune the next run. That is the whole point of the experiment.----<a id="sec-419"></a>+<a id="sec-422"></a>> **Source:** `docs/trading-hub.md` · [↑ table of contents](#table-of-contents)@@ -90178,16 +91004,16 @@ credentials, and writes nothing.## Related- [Agent Sniper](#sec-061), what the autonomous trader is and how it is wired-- [The 10 SOL experiment](#sec-418), the full risk policy-- [Risk acknowledgment](#sec-375), read before arming real funds+- [The 10 SOL experiment](#sec-421), the full risk policy+- [Risk acknowledgment](#sec-377), read before arming real funds- [Custody model](#sec-172), how an agent holds its own keys-- [Earned autonomy](#sec-395), how an agent earns more freedom-- [Trading Copilot](#sec-417), the fair-launch market maker-- Tutorial: [Arm an autonomous sniper](#sec-430)+- [Earned autonomy](#sec-397), how an agent earns more freedom+- [Trading Copilot](#sec-420), the fair-launch market maker+- Tutorial: [Arm an autonomous sniper](#sec-433)----<a id="sec-420"></a>+<a id="sec-423"></a>> **Source:** `docs/trading-surfaces.md` · [↑ table of contents](#table-of-contents)@@ -90213,7 +91039,7 @@ All five surfaces read the same underlying truth: the Coin Intelligence Engine (On top of that base layer:-- **Oracle conviction** ([the conviction engine](#sec-320)) enriches coins across all five surfaces with its 0–100 fused score and tier.+- **Oracle conviction** ([the conviction engine](#sec-321)) enriches coins across all five surfaces with its 0–100 fused score and tier.- **Price history** (candlesticks) comes from Birdeye with GeckoTerminal fallback.- **Live trades** stream over server-sent events from `/api/pump/trades-stream` (PumpPortal websocket, relayed).- **Smart-money pedigree** comes from the proven-wallet ledger (`/api/intel/smart-money`).@@ -90299,7 +91125,7 @@ Signed-out, Mission Control is a read-only cockpit; the trade ticket becomes "Si## How the surfaces chain together-The intended loop: **Radar** (or **Coin Intelligence**) surfaces a launch worth a look → **Watch** it → the **Watchlist** alerts you when Oracle's conviction tier upgrades → open it in **Mission Control** and execute → if the trade wins big, it shows up on the **Live Trade Feed** with the full receipt for everyone else to study. Every coin, on every surface, links to its [Oracle page](#sec-320) for the fused conviction verdict — and armed agents can run the same loop autonomously (see [the trading experiment](#sec-418) and [Oracle's agent loop](#sec-320)).+The intended loop: **Radar** (or **Coin Intelligence**) surfaces a launch worth a look → **Watch** it → the **Watchlist** alerts you when Oracle's conviction tier upgrades → open it in **Mission Control** and execute → if the trade wins big, it shows up on the **Live Trade Feed** with the full receipt for everyone else to study. Every coin, on every surface, links to its [Oracle page](#sec-321) for the fused conviction verdict — and armed agents can run the same loop autonomously (see [the trading experiment](#sec-421) and [Oracle's agent loop](#sec-321)).## API quick reference@@ -90320,21 +91146,21 @@ curl 'https://three.ws/api/trades/feed'curl 'https://three.ws/api/oracle/batch?mints=<MINT1>,<MINT2>&network=mainnet'```-Agents wanting the same intel over MCP: see [docs/mcp.md](#sec-281) (`@three-ws/intel-mcp`, `@three-ws/portfolio-mcp`) — and the paid x402 lanes in [x402-endpoints](#sec-547).+Agents wanting the same intel over MCP: see [docs/mcp.md](#sec-282) (`@three-ws/intel-mcp`, `@three-ws/portfolio-mcp`) — and the paid x402 lanes in [x402-endpoints](#sec-549).## Related-- [Meta-Allocator: the ETF of degens](#sec-285): diversify a budget across the top verified leaders+- [Meta-Allocator: the ETF of degens](#sec-286): diversify a budget across the top verified leaders- [Clip Director: every trade becomes content](#sec-143): turn any closed trade into shareable cards per surface-- [The Trading Copilot — talk to your wallet](#sec-417) — conversational trading over these same numbers-- [Oracle — the conviction engine](#sec-320) · [/oracle/docs](https://three.ws/oracle/docs)-- [The autonomous trading experiment](#sec-418)+- [The Trading Copilot — talk to your wallet](#sec-420) — conversational trading over these same numbers+- [Oracle — the conviction engine](#sec-321) · [/oracle/docs](https://three.ws/oracle/docs)+- [The autonomous trading experiment](#sec-421)- [Financial controls & custody guardrails](#sec-223)-- [UX flows: crypto trading & analytics](#sec-501) — screen-by-screen walkthrough+- [UX flows: crypto trading & analytics](#sec-504) — screen-by-screen walkthrough----<a id="sec-421"></a>+<a id="sec-424"></a>> **Source:** `docs/triage.md` · [↑ table of contents](#table-of-contents)@@ -90376,6 +91202,8 @@ A maintainer runs the untriaged queue at least twice a week. Every new issue get| `documentation` | Docs defect or gap. `npm run audit:docs` findings land here. || `question` | Usually gets converted to a Discussion so the answer is searchable. || `duplicate` / `invalid` / `wontfix` | Closed, always with the reason written in the thread. Never closed silently. |+| `triage` | Awaiting a maintainer's first pass. Comes off at the first response. |+| `area: rig` / `area: animation` / `area: docs` / `area: tests` | Which part of the platform the work touches. One per issue, so you can filter for the area you know. Every curated first issue carries one. |## Claiming work@@ -90394,7 +91222,7 @@ If you claim something and life happens, say so and we will unassign it with zer## Maintainers-Day-to-day triage, review, and releases are handled by [@nirholas](https://github.com/nirholas), with [CODEOWNERS](../.github/CODEOWNERS) routing high-blast-radius paths (contracts, payment rails, published SDKs, security policy) to a required review.+Day-to-day triage, review, and releases are handled by [@nirholas](https://github.com/nirholas), with [CODEOWNERS](../.github/CODEOWNERS) automatically requesting review from the owner on any pull request that touches a high-blast-radius path (contracts, payment rails, published SDKs, security policy).We are actively looking to grow this. The path is the normal one: land a few good PRs, help answer things in [Discussions](https://github.com/nirholas/three.ws/discussions), and we will hand you triage rights. There is no interview.@@ -90407,7 +91235,7 @@ We are actively looking to grow this. The path is the normal one: land a few goo----<a id="sec-422"></a>+<a id="sec-425"></a>> **Source:** `docs/troubleshooting.md` · [↑ table of contents](#table-of-contents)@@ -91066,7 +91894,7 @@ Idle blink and head-drift are active in the current release: `src/idle-animation----<a id="sec-423"></a>+<a id="sec-426"></a>> **Source:** `docs/trust-primitives.md` · [↑ table of contents](#table-of-contents)@@ -91085,7 +91913,7 @@ any chain**, regardless of which platform that counterparty was minted on.## Cross-chain Agent Reputation**`GET /api/x402/agent-reputation?subject=<identifier>`** — $0.01 USDC per call-(Base or Solana mainnet, via [x402](#sec-552)).+(Base or Solana mainnet, via [x402](#sec-554)).Pass any counterparty identifier. The type is auto-detected and scored from whateverreal on-chain evidence exists for it:@@ -91203,7 +92031,7 @@ Returns `{ mode, count, scored_count, unknown_count, avg_score, subjects: [ …fThe same POST route also serves three.ws-fleet monitoring over the platform's indexedactive-agent set: `mode: "sweep"` (fleet average + flagged low-trust agents),`mode: "leaderboard"` (top N by score), and `mode: "decay_report"` (agents whose score-dropped >10 points). See the [x402 catalog](#sec-552).+dropped >10 points). See the [x402 catalog](#sec-554).---@@ -91228,7 +92056,7 @@ claims **"I am the deployer of contract X"** or **"I own wallet W / name N / ageself-report.**`GET /api/x402/onchain-identity-verify?identity=<id>&address=<addr>&chain=<caip2>`**-— $0.005 USDC per call (Base or Solana mainnet, via [x402](#sec-552)).+— $0.005 USDC per call (Base or Solana mainnet, via [x402](#sec-554)).It verifies a **claim** that `identity` controls `address`, for **any** identity type,on any chain — regardless of the platform the counterparty came from:@@ -91302,11 +92130,11 @@ score *whether to trust* them.----See also: [x402 paid endpoints](#sec-552) · [Agent Bouncer](#sec-096) · [ERC-8004 identity](#sec-190)+See also: [x402 paid endpoints](#sec-554) · [Agent Bouncer](#sec-096) · [ERC-8004 identity](#sec-190)----<a id="sec-424"></a>+<a id="sec-427"></a>> **Source:** `docs/tutorials/add-a-3d-assistant.md` · [↑ table of contents](#table-of-contents)@@ -91424,7 +92252,7 @@ Then ask, in plain language: "build a 3D assistant widget named Aria with an oce----<a id="sec-425"></a>+<a id="sec-428"></a>> **Source:** `docs/tutorials/agent-personality.md` · [↑ table of contents](#table-of-contents)@@ -91877,7 +92705,7 @@ The system prompt is the cheapest, highest-leverage thing you can change about a----<a id="sec-426"></a>+<a id="sec-429"></a>> **Source:** `docs/tutorials/agent-reputation.md` · [↑ table of contents](#table-of-contents)@@ -92154,7 +92982,7 @@ A read costs nothing and asks no one's permission. That's the property that lets----<a id="sec-427"></a>+<a id="sec-430"></a>> **Source:** `docs/tutorials/agent-spending-envelope.md` · [↑ table of contents](#table-of-contents)@@ -92717,7 +93545,7 @@ The two "budget stays reserved" cases are the only place the system deliberately----<a id="sec-428"></a>+<a id="sec-431"></a>> **Source:** `docs/tutorials/animate-your-agent.md` · [↑ table of contents](#table-of-contents)@@ -92893,7 +93721,7 @@ The difference that matters is the layer. `wave`, `point`, `nod` and `shrug` are----<a id="sec-429"></a>+<a id="sec-432"></a>> **Source:** `docs/tutorials/animate-your-avatar.md` · [↑ table of contents](#table-of-contents)@@ -93075,7 +93903,7 @@ Applying clips in the Studio is the **authoring** side. On a *running* agent, thThe two channels are wired to the *same* emotional state, at two different timescales, so the body and the face never disagree:- **Momentary events** (an error just happened, a skill just finished) inject a transient emotion spike, `concern`, `celebration`, `curiosity`, and friends, that decays over seconds. A spike crossing threshold both reshapes the face immediately *and* biases the gesture slot the avatar plays next (e.g. sustained `celebration` picks the `celebrate` slot).-- **Sustained mood**: the agent's resting valence/arousal, set via `setMood()` (see [docs/tutorials/emotion-from-data.md](#sec-444)), is the continuous baseline between events. It biases the resting face (a soft smile at high valence, a worried brow at low) and posture (lean, gaze) every frame, and, once nothing more urgent claims the gesture slot, biases *which* ambient gesture plays too: a sustained up-and-energetic mood leans toward the `celebrate` slot, a sustained down-and-subdued mood toward `concern`, the opposite bias, never the energetic one. A momentary event always takes priority over the ambient mood bias, and slot overrides via `meta.edits.animations` apply identically whether the trigger was a spike or the resting mood.+- **Sustained mood**: the agent's resting valence/arousal, set via `setMood()` (see [docs/tutorials/emotion-from-data.md](#sec-447)), is the continuous baseline between events. It biases the resting face (a soft smile at high valence, a worried brow at low) and posture (lean, gaze) every frame, and, once nothing more urgent claims the gesture slot, biases *which* ambient gesture plays too: a sustained up-and-energetic mood leans toward the `celebrate` slot, a sustained down-and-subdued mood toward `concern`, the opposite bias, never the energetic one. A momentary event always takes priority over the ambient mood bias, and slot overrides via `meta.edits.animations` apply identically whether the trigger was a spike or the resting mood.The division of labor: **clips move the body, blendshapes move the face, slots choose *which* body motion fits the emotion, and one emotional state, not two independent tracks, drives all of it.** All three ride the same universal-rig foundation, name your bones (and your blendshapes) in a convention the resolvers know, and everything just works.@@ -93115,14 +93943,14 @@ You learned the apply-and-remix workflow for motion on three.ws:- [docs/animations.md](#sec-093): the runtime animation registry, manifest, and agent slot reference.- [docs/3d-asset-pipeline.md](#sec-002), how FBX, GLB, and clip JSON relate, and how clips are built and retargeted.-- [docs/tutorials/swap-avatar-in-studio.md](#sec-482), loading and switching avatars in the Studio.-- [docs/tutorials/upload-custom-glb.md](#sec-485), getting a Mixamo or custom rig into three.ws as a clean, animatable GLB.+- [docs/tutorials/swap-avatar-in-studio.md](#sec-485), loading and switching avatars in the Studio.+- [docs/tutorials/upload-custom-glb.md](#sec-488), getting a Mixamo or custom rig into three.ws as a clean, animatable GLB.Primary call to action: open **[/pose](/pose)**, load an avatar, and apply your first clip.----<a id="sec-430"></a>+<a id="sec-433"></a>> **Source:** `docs/tutorials/arm-an-agent-sniper.md` · [↑ table of contents](#table-of-contents)@@ -93236,7 +94064,7 @@ The hard-config sniper you just armed is the control group. The next phase runs----<a id="sec-431"></a>+<a id="sec-434"></a>> **Source:** `docs/tutorials/build-a-3d-asset-pipeline.md` · [↑ table of contents](#table-of-contents)@@ -93455,7 +94283,7 @@ step once the mechanical stages are running.----<a id="sec-432"></a>+<a id="sec-435"></a>> **Source:** `docs/tutorials/build-a-scene.md` · [↑ table of contents](#table-of-contents)@@ -93674,7 +94502,7 @@ The leverage of [Scene Studio](/scene) is that it's a *real* editor producing a----<a id="sec-433"></a>+<a id="sec-436"></a>> **Source:** `docs/tutorials/build-a-site-concierge.md` · [↑ table of contents](#table-of-contents)@@ -93792,7 +94620,7 @@ Then: `<three-concierge endpoint="/my/concierge">`. The production reference, wi----<a id="sec-434"></a>+<a id="sec-437"></a>> **Source:** `docs/tutorials/character-library-to-embed.md` · [↑ table of contents](#table-of-contents)@@ -94297,7 +95125,7 @@ Doing the copy server-side also sidesteps cross-origin reads and browser upload----<a id="sec-435"></a>+<a id="sec-438"></a>> **Source:** `docs/tutorials/claim-threews-name.md` · [↑ table of contents](#table-of-contents)@@ -94605,7 +95433,7 @@ See also:----<a id="sec-436"></a>+<a id="sec-439"></a>> **Source:** `docs/tutorials/connect-ai-brain.md` · [↑ table of contents](#table-of-contents)@@ -95027,7 +95855,7 @@ The brain is the part of the agent you'll iterate on most after the system promp----<a id="sec-437"></a>+<a id="sec-440"></a>> **Source:** `docs/tutorials/create-and-edit-memory.md` · [↑ table of contents](#table-of-contents)@@ -95348,7 +96176,7 @@ The leverage is in *enhancement*: the right type, one fact per memory, tags, del----<a id="sec-438"></a>+<a id="sec-441"></a>> **Source:** `docs/tutorials/custom-skill.md` · [↑ table of contents](#table-of-contents)@@ -95873,7 +96701,7 @@ The skill installs via a URI in the agent manifest, runs entirely client-side, a----<a id="sec-439"></a>+<a id="sec-442"></a>> **Source:** `docs/tutorials/customize-appearance.md` · [↑ table of contents](#table-of-contents)@@ -96311,7 +97139,7 @@ Most production embeds use four or five of these together. The combination is wh----<a id="sec-440"></a>+<a id="sec-443"></a>> **Source:** `docs/tutorials/deploy-to-vercel-custom-domain.md` · [↑ table of contents](#table-of-contents)@@ -96831,7 +97659,7 @@ In rough order of likelihood:----<a id="sec-441"></a>+<a id="sec-444"></a>> **Source:** `docs/tutorials/earn-and-spend-in-play.md` · [↑ table of contents](#table-of-contents)@@ -97026,7 +97854,7 @@ Every paid sale splits 50% to the holder-rewards sink and 50% to the treasury.## Next-- **[The in-game economy](#sec-255)** is the full reference: every+- **[The in-game economy](#sec-256)** is the full reference: everycatalog, gate, settlement path, and the JSON wire format.- **[three.ws/play/economy](https://three.ws/play/economy)** shows the livecatalogs and odds, read from the running server.@@ -97035,7 +97863,7 @@ Every paid sale splits 50% to the holder-rewards sink and 50% to the treasury.----<a id="sec-442"></a>+<a id="sec-445"></a>> **Source:** `docs/tutorials/embed-in-30-seconds.md` · [↑ table of contents](#table-of-contents)@@ -97311,7 +98139,7 @@ A working embedded agent is the foundation everything else builds on. From here,----<a id="sec-443"></a>+<a id="sec-446"></a>> **Source:** `docs/tutorials/embed-on-website.md` · [↑ table of contents](#table-of-contents)@@ -97822,7 +98650,7 @@ Squarespace's developer preview and published output can differ. Try adding the----<a id="sec-444"></a>+<a id="sec-447"></a>> **Source:** `docs/tutorials/emotion-from-data.md` · [↑ table of contents](#table-of-contents)@@ -97933,7 +98761,7 @@ Save that as `index.html` and open it: no build step, no server, no wallet. Swap## Step 3: The AI lane: real classification over arbitrary data, richer gestures-A lexicon scorer only works on short, informal text, and it only fires on words it already knows. For real documents (support tickets, product reviews, meeting transcripts, incident reports) you want a model that actually reads the thing and returns *structured* output: a graded sentiment score plus the findings and risk flags behind it, so the reaction tracks the document's real tone instead of its vocabulary. `ibm_granite_analyze` (part of the [IBM Granite x402 MCP suite](#sec-252)) does exactly this for $0.04/call, no IBM account needed: you pay in USDC, it pays IBM.+A lexicon scorer only works on short, informal text, and it only fires on words it already knows. For real documents (support tickets, product reviews, meeting transcripts, incident reports) you want a model that actually reads the thing and returns *structured* output: a graded sentiment score plus the findings and risk flags behind it, so the reaction tracks the document's real tone instead of its vocabulary. `ibm_granite_analyze` (part of the [IBM Granite x402 MCP suite](#sec-253)) does exactly this for $0.04/call, no IBM account needed: you pay in USDC, it pays IBM.The tool returns a fixed set of keys: `summary`, `entities`, `sentiment` (`{ overall, score }`, score in -1..1), `key_findings`, `risk_flags` (each with a `severity`), and `next_steps`. The two the animation layer cares about are `sentiment.score` and `risk_flags`.@@ -98049,7 +98877,7 @@ function reactIfConfident(clipOrEmoteName, { confident, useExactClip = false } =- **The agent keeps re-celebrating every poll.** You skipped the cooldown gate in Step 4, or your confidence threshold is too low for a noisy feed. Widen `COOLDOWN_MS` or raise the sample-size/strength floor.- **AI lane 402 loop / never resolves.** Your `SOLANA_PRIVATE_KEY` wallet has no USDC. Fund it with a few cents, see the [x402 payment flow](/tutorials/pay-for-x402-service).- **`analysis.sentiment` is undefined.** Granite returned something that wasn't a clean JSON analysis object; the tool falls back to `{ ok: true, raw_response, parse_error }` in that case. Log `analysis.parse_error` and `analysis.raw_response` to see what came back. The `gestureFor()` above already treats a missing score as "no gesture" rather than crashing.-- **Every document scores middling and nothing ever plays.** `analysis_type: 'sentiment'` tunes the model toward tone; the other five types (`general`, `contract`, `financial`, `technical`, `medical`) return the same keys but reason about different things, so a contract analyzed as `general` often lands near 0. Match the type to your data (see [ibm-x402-mcp](#sec-252)).+- **Every document scores middling and nothing ever plays.** `analysis_type: 'sentiment'` tunes the model toward tone; the other five types (`general`, `contract`, `financial`, `technical`, `medical`) return the same keys but reason about different things, so a contract analyzed as `general` often lands near 0. Match the type to your data (see [ibm-x402-mcp](#sec-253)).---@@ -98064,7 +98892,7 @@ function reactIfConfident(clipOrEmoteName, { confident, useExactClip = false } =----<a id="sec-445"></a>+<a id="sec-448"></a>> **Source:** `docs/tutorials/explore-docs-world.md` · [↑ table of contents](#table-of-contents)@@ -98142,12 +98970,12 @@ Make one with the [Forge](/create) or the [Avatar Studio](/avatar-studio), copy## Where to next- [Docs World reference](#sec-181): controls table, device behaviour, contributor notes.-- [What is three.ws?](#sec-404): the guided tour of the whole platform, readable in either surface.+- [What is three.ws?](#sec-406): the guided tour of the whole platform, readable in either surface.- Add a page to the docs yourself: edit `docs/nav.json` and drop a markdown file in `docs/`; it appears in the sidebar and as a page in its pavilion with no extra wiring.----<a id="sec-446"></a>+<a id="sec-449"></a>> **Source:** `docs/tutorials/find-a-better-exit-policy.md` · [↑ table of contents](#table-of-contents)@@ -98390,7 +99218,7 @@ disclaimers bolted onto the result. They are the result.----<a id="sec-447"></a>+<a id="sec-450"></a>> **Source:** `docs/tutorials/first-agent.md` · [↑ table of contents](#table-of-contents)@@ -98899,7 +99727,7 @@ Now that you have a working agent, here's what to explore next:----<a id="sec-448"></a>+<a id="sec-451"></a>> **Source:** `docs/tutorials/first-prompt-to-3d.md` · [↑ table of contents](#table-of-contents)@@ -99019,7 +99847,7 @@ A rigged avatar's AR link gains a **Bring it to life** option: instead of a froz----<a id="sec-449"></a>+<a id="sec-452"></a>> **Source:** `docs/tutorials/generate-3d-api.md` · [↑ table of contents](#table-of-contents)@@ -99244,7 +100072,7 @@ If you've never made an x402 call, start with [Build a paid x402 endpoint](/tuto----<a id="sec-450"></a>+<a id="sec-453"></a>> **Source:** `docs/tutorials/getting-started.md` · [↑ table of contents](#table-of-contents)@@ -99429,7 +100257,7 @@ Everything is editable forever — swap the body, rewrite the prompt, add capabi----<a id="sec-451"></a>+<a id="sec-454"></a>> **Source:** `docs/tutorials/greeting-and-first-speech.md` · [↑ table of contents](#table-of-contents)@@ -99777,7 +100605,7 @@ A working greeting moves the embed from "decoration" to "interaction", which is----<a id="sec-452"></a>+<a id="sec-455"></a>> **Source:** `docs/tutorials/image-to-3d.md` · [↑ table of contents](#table-of-contents)@@ -99880,7 +100708,7 @@ Everything you generate is kept in **Your creations** at the bottom of the page,----<a id="sec-453"></a>+<a id="sec-456"></a>> **Source:** `docs/tutorials/import-avatar-url.md` · [↑ table of contents](#table-of-contents)@@ -100050,7 +100878,7 @@ The URL path and the file-upload path converge on the same avatar record and the----<a id="sec-454"></a>+<a id="sec-457"></a>> **Source:** `docs/tutorials/js-api-events.md` · [↑ table of contents](#table-of-contents)@@ -100516,7 +101344,7 @@ The `whenReady`, awaited-`ask()`, and try/catch patterns are small but they remo----<a id="sec-455"></a>+<a id="sec-458"></a>> **Source:** `docs/tutorials/mcp-server-for-your-agent.md` · [↑ table of contents](#table-of-contents)@@ -101171,7 +101999,7 @@ Things that look right but bite you:----<a id="sec-456"></a>+<a id="sec-459"></a>> **Source:** `docs/tutorials/mine-vanity-address.md` · [↑ table of contents](#table-of-contents)@@ -101453,7 +102281,7 @@ The protocol itself is fully specified in [docs/PROTOCOL-vanity.md](#sec-005), a----<a id="sec-457"></a>+<a id="sec-460"></a>> **Source:** `docs/tutorials/mint-pumpfun-token.md` · [↑ table of contents](#table-of-contents)@@ -101814,7 +102642,7 @@ If you have a lawyer, talk to them before launching. If you don't, default to th----<a id="sec-458"></a>+<a id="sec-461"></a>> **Source:** `docs/tutorials/monetize-mcp-server.md` · [↑ table of contents](#table-of-contents)@@ -102130,7 +102958,7 @@ That connector can search the bazaar, read your challenge without paying (`inspe----<a id="sec-459"></a>+<a id="sec-462"></a>> **Source:** `docs/tutorials/multi-agent-coordination.md` · [↑ table of contents](#table-of-contents)@@ -102535,7 +103363,7 @@ researcher.addEventListener('skill:tool-called', (e) => {Build the tools themselves as skills (see [custom-skill](/tutorials/custom-skill)); the orchestration logic stays in the coordinator on the page.-There's also a platform-native alternative to page-level orchestration: the `<agent-stage>` element. A stage hosts every child `<agent-3d>` in one shared WebGL scene (with a `formation` attribute — `row`, `circle`, or `freeform`), exposes `getAgents()`, `broadcast(fromId, event)`, and `routeMessage(fromId, toId, text)` to your code, and grants each staged agent two extra built-in tools — `observe_agents` (who else is on stage) and `say_to_agent` (address a colleague directly) — so the LLMs can delegate to each other without any coordinator glue. When the agents, not the page, should decide who does what, reach for the stage. The full patterns are in [Multi-Agent Scenes](#sec-294).+There's also a platform-native alternative to page-level orchestration: the `<agent-stage>` element. A stage hosts every child `<agent-3d>` in one shared WebGL scene (with a `formation` attribute — `row`, `circle`, or `freeform`), exposes `getAgents()`, `broadcast(fromId, event)`, and `routeMessage(fromId, toId, text)` to your code, and grants each staged agent two extra built-in tools — `observe_agents` (who else is on stage) and `say_to_agent` (address a colleague directly) — so the LLMs can delegate to each other without any coordinator glue. When the agents, not the page, should decide who does what, reach for the stage. The full patterns are in [Multi-Agent Scenes](#sec-295).Parallel fan-out is **harder to debug** than sequential delegation because errors are non-deterministic in order and any latency outlier blocks the join. Use it when the wall-clock saving is worth the complexity. For a chat UX with a human in the loop, sequential is almost always the right default.@@ -102690,7 +103518,7 @@ async function safeHandoff(targetEl, brief, fallbackEl, originalQuestion) {----<a id="sec-460"></a>+<a id="sec-463"></a>> **Source:** `docs/tutorials/nvidia-3d-free.md` · [↑ table of contents](#table-of-contents)@@ -102812,7 +103640,7 @@ It talks **directly** to a TRELLIS NIM and returns the GLB **synchronously** in----<a id="sec-461"></a>+<a id="sec-464"></a>> **Source:** `docs/tutorials/nvidia-nim-self-host.md` · [↑ table of contents](#table-of-contents)@@ -102995,7 +103823,7 @@ The proxy normalizes every documented artifact shape (inline `base64`, a bare st----<a id="sec-462"></a>+<a id="sec-465"></a>> **Source:** `docs/tutorials/paid-x402-endpoint.md` · [↑ table of contents](#table-of-contents)@@ -103687,7 +104515,7 @@ Both work. Choose based on whether your endpoint is part of an agent platform yo----<a id="sec-463"></a>+<a id="sec-466"></a>> **Source:** `docs/tutorials/pay-for-x402-service.md` · [↑ table of contents](#table-of-contents)@@ -103962,7 +104790,7 @@ package family is listed under [x402 → Open-source packages](/x402#open-source----<a id="sec-464"></a>+<a id="sec-467"></a>> **Source:** `docs/tutorials/personal-ai-site.md` · [↑ table of contents](#table-of-contents)@@ -104517,7 +105345,7 @@ The technical investment is one HTML file, a GLB avatar, and a system prompt. Th----<a id="sec-465"></a>+<a id="sec-468"></a>> **Source:** `docs/tutorials/place-agent-irl.md` · [↑ table of contents](#table-of-contents)@@ -104767,7 +105595,7 @@ This is fundamentally different from viewing a single model in AR. If you only n----<a id="sec-466"></a>+<a id="sec-469"></a>> **Source:** `docs/tutorials/prompts-for-3d.md` · [↑ table of contents](#table-of-contents)@@ -104903,7 +105731,7 @@ The tiers are explained in detail in [the text-to-3D tutorial](/tutorials/text-t----<a id="sec-467"></a>+<a id="sec-470"></a>> **Source:** `docs/tutorials/read-the-trading-fleet.md` · [↑ table of contents](#table-of-contents)@@ -105130,7 +105958,7 @@ funds.----<a id="sec-468"></a>+<a id="sec-471"></a>> **Source:** `docs/tutorials/register-onchain.md` · [↑ table of contents](#table-of-contents)@@ -105479,7 +106307,7 @@ Your agent's URL will keep working as long as Base exists and IPFS gateways serv----<a id="sec-469"></a>+<a id="sec-472"></a>> **Source:** `docs/tutorials/render-avatar-images.md` · [↑ table of contents](#table-of-contents)@@ -106024,7 +106852,7 @@ If you want a talking, animated agent rather than a viewer, that is the `<agent-----<a id="sec-470"></a>+<a id="sec-473"></a>> **Source:** `docs/tutorials/self-host-agent-backend.md` · [↑ table of contents](#table-of-contents)@@ -106587,7 +107415,7 @@ A self-hosted instance with light traffic runs at $20–50/month all-in. The dom----<a id="sec-471"></a>+<a id="sec-474"></a>> **Source:** `docs/tutorials/selfie-to-avatar.md` · [↑ table of contents](#table-of-contents)@@ -106843,7 +107671,7 @@ The result is a standard `.glb` that animates in the [Animation Studio](/pose),----<a id="sec-472"></a>+<a id="sec-475"></a>> **Source:** `docs/tutorials/sell-a-skill-with-a-trial.md` · [↑ table of contents](#table-of-contents)@@ -107056,7 +107884,7 @@ A healthy funnel shows a mix of `trial` rows with counts ticking down and `confi----<a id="sec-473"></a>+<a id="sec-476"></a>> **Source:** `docs/tutorials/share-your-agent.md` · [↑ table of contents](#table-of-contents)@@ -107420,7 +108248,7 @@ The agent's URL is the durable handle. Embed it, link it, print it. The agent sh----<a id="sec-474"></a>+<a id="sec-477"></a>> **Source:** `docs/tutorials/ship-an-avatar-manifest.md` · [↑ table of contents](#table-of-contents)@@ -107730,12 +108558,12 @@ A JSON file that names an avatar, pins its mesh by content rather than by locati**Next:**- The [Avatar CLI reference](#sec-108) documents every flag, exit code, and `--json` shape.-- The [web component reference](#sec-514) covers everything `<agent-3d>` can do beyond rendering a body: voice, an LLM brain, memory, and skills.+- The [web component reference](#sec-517) covers everything `<agent-3d>` can do beyond rendering a body: voice, an LLM brain, memory, and skills.- [`@three-ws/avatar-schema`](../packages/avatar-schema/README.md) is the schema itself, for writing your own tooling against the format.----<a id="sec-475"></a>+<a id="sec-478"></a>> **Source:** `docs/tutorials/shopify-shopping-assistant.md` · [↑ table of contents](#table-of-contents)@@ -107853,7 +108681,7 @@ The [wire format](/docs/concierge) for the answer endpoint is documented, so you----<a id="sec-476"></a>+<a id="sec-479"></a>> **Source:** `docs/tutorials/shopify-store-guide-advanced.md` · [↑ table of contents](#table-of-contents)@@ -108163,7 +108991,7 @@ The clip URLs inside the manifest resolve **relative to the manifest**, so a sel----<a id="sec-477"></a>+<a id="sec-480"></a>> **Source:** `docs/tutorials/shopify-store-guide.md` · [↑ table of contents](#table-of-contents)@@ -108252,7 +109080,7 @@ It's powered by the open-source [`@three-ws/tour`](https://www.npmjs.com/package----<a id="sec-478"></a>+<a id="sec-481"></a>> **Source:** `docs/tutorials/sign-with-your-avatar.md` · [↑ table of contents](#table-of-contents)@@ -108466,9 +109294,9 @@ None of it replaces a human interpreter. It makes an avatar legible to signers i**See also:**-- [docs/sign-language.md](#sec-386): the full reference: vocabulary, developer APIs, and how the signing engine works-- [docs/tutorials/animate-your-avatar.md](#sec-429): the clip library, retargeting, and animated GLB export in depth-- [docs/web-component.md](#sec-514): every `<agent-3d>` attribute, including `sign-language`+- [docs/sign-language.md](#sec-388): the full reference: vocabulary, developer APIs, and how the signing engine works+- [docs/tutorials/animate-your-avatar.md](#sec-432): the clip library, retargeting, and animated GLB export in depth+- [docs/web-component.md](#sec-517): every `<agent-3d>` attribute, including `sign-language`- [/asl-alphabet](/asl-alphabet): the manual alphabet, letter by letter, with a practice drill- [examples/sign-language.html](../examples/sign-language.html): a runnable page with both integration paths@@ -108476,7 +109304,7 @@ Primary call to action: open **[/sign-language](/sign-language)** and sign your----<a id="sec-479"></a>+<a id="sec-482"></a>> **Source:** `docs/tutorials/skill-with-database-auth.md` · [↑ table of contents](#table-of-contents)@@ -109214,7 +110042,7 @@ Before this skill faces a real visitor:----<a id="sec-480"></a>+<a id="sec-483"></a>> **Source:** `docs/tutorials/solana-agent-reputation.md` · [↑ table of contents](#table-of-contents)@@ -109406,7 +110234,7 @@ A read costs nothing and asks no one's permission — which is exactly what lets----<a id="sec-481"></a>+<a id="sec-484"></a>> **Source:** `docs/tutorials/sperax-tour.md` · [↑ table of contents](#table-of-contents)@@ -109577,7 +110405,7 @@ This is covered by an automated test — [`tour-sdk/test/director.test.mjs`](htt----<a id="sec-482"></a>+<a id="sec-485"></a>> **Source:** `docs/tutorials/swap-avatar-in-studio.md` · [↑ table of contents](#table-of-contents)@@ -109771,7 +110599,7 @@ The key insight is the snippet's stability. Once embedded, your customers' pages----<a id="sec-483"></a>+<a id="sec-486"></a>> **Source:** `docs/tutorials/text-to-3d.md` · [↑ table of contents](#table-of-contents)@@ -109899,7 +110727,7 @@ This is normal — prompt, generate, adjust, repeat is the workflow, not a failu----<a id="sec-484"></a>+<a id="sec-487"></a>> **Source:** `docs/tutorials/trigger-from-page-events.md` · [↑ table of contents](#table-of-contents)@@ -110403,7 +111231,7 @@ The pattern under all of these is the same: every recipe starts with `whenReady(----<a id="sec-485"></a>+<a id="sec-488"></a>> **Source:** `docs/tutorials/upload-custom-glb.md` · [↑ table of contents](#table-of-contents)@@ -110831,7 +111659,7 @@ Once the body is on the platform, the embed snippet doesn't change. The same `<a----<a id="sec-486"></a>+<a id="sec-489"></a>> **Source:** `docs/tutorials/view-in-ar.md` · [↑ table of contents](#table-of-contents)@@ -111020,7 +111848,7 @@ AR surface detection needs a moment to work. Move the phone slowly over the targ----<a id="sec-487"></a>+<a id="sec-490"></a>> **Source:** `docs/tutorials/voice-and-lipsync.md` · [↑ table of contents](#table-of-contents)@@ -111161,7 +111989,7 @@ If you want your agent to speak in *your* voice instead of a built-in one, use t4. Give the voice a **name** (1–64 characters) and click **Clone**. The page uploads the sample to `POST /api/tts/eleven-clone` ([`api/tts/eleven-clone.js`](../api/tts/eleven-clone.js)) as `multipart/form-data`.5. On success you get a `voice_id`, and the voice is saved to your library (stored in `localStorage`, up to 20 voices).-**Test it in the playground.** Pick the cloned voice, type a sample line, and click Speak. The playground calls `POST /api/tts/eleven` ([`api/tts/eleven.js`](../api/tts/eleven.js)) with `{ voiceId, text }`, which proxies ElevenLabs and caches the clip for 30 days (the hint shows `cached` vs `generated`). Default model is `eleven_flash_v2_5`; requests are capped at 500 characters and metered to your credit balance ($0.30 per 1,000 characters on the platform key, or free of platform charges with your own ElevenLabs key in the `x-eleven-key` header; see the [Voice Lab billing section](#sec-512)).+**Test it in the playground.** Pick the cloned voice, type a sample line, and click Speak. The playground calls `POST /api/tts/eleven` ([`api/tts/eleven.js`](../api/tts/eleven.js)) with `{ voiceId, text }`, which proxies ElevenLabs and caches the clip for 30 days (the hint shows `cached` vs `generated`). Default model is `eleven_flash_v2_5`; requests are capped at 500 characters and metered to your credit balance ($0.30 per 1,000 characters on the platform key, or free of platform charges with your own ElevenLabs key in the `x-eleven-key` header; see the [Voice Lab billing section](#sec-515)).> Instant Voice Cloning is a **paid-tier ElevenLabs feature** (Starter and up). If the server's account is on the free tier, the clone call returns the upstream error verbatim in the status line (e.g. a `can_not_use_instant_voice_cloning` message). Built-in voices in Step 1 have no such requirement.@@ -111271,7 +112099,7 @@ The leverage is that the avatar drives its mouth from the *audio it actually pla----<a id="sec-488"></a>+<a id="sec-491"></a>> **Source:** `docs/tutorials/walk-companion.md` · [↑ table of contents](#table-of-contents)@@ -111624,7 +112452,7 @@ The leverage is composability: the same engine renders the corner mascot, the fu----<a id="sec-489"></a>+<a id="sec-492"></a>> **Source:** `docs/tutorials/wallet-sign-in.md` · [↑ table of contents](#table-of-contents)@@ -111908,7 +112736,7 @@ A wallet sign-in that works from any origin that can reach the API, survives the----<a id="sec-490"></a>+<a id="sec-493"></a>> **Source:** `docs/tutorials/web-component-end-to-end.md` · [↑ table of contents](#table-of-contents)@@ -112001,7 +112829,7 @@ This is the right embed when:- You want multiple agents on the same page- You need to call the agent's methods or subscribe to its events-The rest of this tutorial uses the custom-element form, because that's the one that benefits from a wrapper. (The [embedding guide](#sec-443) covers the iframe path and the no-code platforms in depth.)+The rest of this tutorial uses the custom-element form, because that's the one that benefits from a wrapper. (The [embedding guide](#sec-446) covers the iframe path and the no-code platforms in depth.)---@@ -112507,12 +113335,12 @@ The web component is the most robust integration point the platform offers. Buil## Next steps- [Drive the agent with the JavaScript API](/tutorials/js-api-events), methods and events covered in depth-- [Embed a three.ws agent on your website](#sec-443), the no-framework paths (Webflow, WordPress, Squarespace) for completeness+- [Embed a three.ws agent on your website](#sec-446), the no-framework paths (Webflow, WordPress, Squarespace) for completeness- [Trigger the agent from page events](/tutorials/trigger-from-page-events), once it's mounted, make it react to the user journey----<a id="sec-491"></a>+<a id="sec-494"></a>> **Source:** `docs/tutorials/write-a-guard.md` · [↑ table of contents](#table-of-contents)@@ -112816,7 +113644,7 @@ Your guard is done when all of these are true:----<a id="sec-492"></a>+<a id="sec-495"></a>> **Source:** `docs/tutorials/x402-server-sdk.md` · [↑ table of contents](#table-of-contents)@@ -113029,7 +113857,7 @@ const res = await pay('https://your.api/v1/embed', { method: 'POST', body });----<a id="sec-493"></a>+<a id="sec-496"></a>> **Source:** `docs/ui-juice.md` · [↑ table of contents](#table-of-contents)@@ -113191,7 +114019,7 @@ should reach for these primitives rather than re-rolling RAF loops.----<a id="sec-494"></a>+<a id="sec-497"></a>> **Source:** `docs/user-wallet.md` · [↑ table of contents](#table-of-contents)@@ -113410,7 +114238,7 @@ curl -sX POST https://three.ws/api/user/wallet/fund-agent \Same reserve logic as `send`, and mainnet only: a `"max"` SOL top-up leaves rent and fee headroom, and if the agent has no USDC account yet the transaction opens one and your master wallet pays the rent (refused with `insufficient_sol_for_fees` if your SOL cannot cover it). Without `simulate: true`, a well-formed call executes immediately; preview first when the amount is `"max"` or the agent might lack a token account.-Once the funds land, they are the agent's, and every further movement out of them runs through the agent's own spend policy, kill switch, and custody trail. Funding an agent is therefore the moment to decide how much autonomy you are comfortable financing: top up in the size you would be willing to lose to a bad strategy, not the whole balance. This is also the normal way to get USDC into an agent before it backs a vault ([vaults.md](#sec-509)) and the easiest way to send a vault the small SOL balance it needs for swap fees, by sending to the vault address with `send`.+Once the funds land, they are the agent's, and every further movement out of them runs through the agent's own spend policy, kill switch, and custody trail. Funding an agent is therefore the moment to decide how much autonomy you are comfortable financing: top up in the size you would be willing to lose to a bad strategy, not the whole balance. This is also the normal way to get USDC into an agent before it backs a vault ([vaults.md](#sec-512)) and the easiest way to send a vault the small SOL balance it needs for swap fees, by sending to the vault address with `send`.## On-chain history@@ -113472,13 +114300,13 @@ Honest limits, stated plainly: this is a **custodial** wallet, so the platform c- [agent-wallets.md](#sec-072) for the per-agent wallet this one funds, and its spend policy- [custody.md](#sec-172) for limits, freeze, proof of custody, and recovery on the agent side-- [vaults.md](#sec-509) for what a funded agent wallet can then back+- [vaults.md](#sec-512) for what a funded agent wallet can then back- [authentication.md](#sec-103) for sessions, CSRF tokens, and why API keys do not apply here-- [money-map.md](#sec-291) for how funds move across the whole platform+- [money-map.md](#sec-292) for how funds move across the whole platform----<a id="sec-495"></a>+<a id="sec-498"></a>> **Source:** `docs/ux-flows/01-onboarding-creation.md` · [↑ table of contents](#table-of-contents)@@ -113749,7 +114577,7 @@ Honest limits, stated plainly: this is a **custodial** wallet, so the platform c----<a id="sec-496"></a>+<a id="sec-499"></a>> **Source:** `docs/ux-flows/02-forge-text-to-3d.md` · [↑ table of contents](#table-of-contents)@@ -113931,7 +114759,7 @@ Routing facts (from `vercel.json`):----<a id="sec-497"></a>+<a id="sec-500"></a>> **Source:** `docs/ux-flows/03-3d-editing-viewer.md` · [↑ table of contents](#table-of-contents)@@ -114137,7 +114965,7 @@ Routing summary (from `vite.config.js`):----<a id="sec-498"></a>+<a id="sec-501"></a>> **Source:** `docs/ux-flows/04-embed-widget-studio.md` · [↑ table of contents](#table-of-contents)@@ -114311,7 +115139,7 @@ Routing recap (from `vercel.json`):----<a id="sec-499"></a>+<a id="sec-502"></a>> **Source:** `docs/ux-flows/05-discovery-social.md` · [↑ table of contents](#table-of-contents)@@ -114583,7 +115411,7 @@ Routing recap (from `vercel.json`):----<a id="sec-500"></a>+<a id="sec-503"></a>> **Source:** `docs/ux-flows/06-marketplace-skills.md` · [↑ table of contents](#table-of-contents)@@ -114801,7 +115629,7 @@ Routing facts confirmed in `vercel.json` (line numbers shift too often to pin; g----<a id="sec-501"></a>+<a id="sec-504"></a>> **Source:** `docs/ux-flows/07-crypto-trading-analytics.md` · [↑ table of contents](#table-of-contents)@@ -115192,7 +116020,7 @@ coin-intel, pump-visualizer and pump-live: adding a coin on any surface shows up----<a id="sec-502"></a>+<a id="sec-505"></a>> **Source:** `docs/ux-flows/08-coin-launch-wallets.md` · [↑ table of contents](#table-of-contents)@@ -115468,7 +116296,7 @@ real Solana/EVM RPC, pump.fun, and x402 — no mocks.----<a id="sec-503"></a>+<a id="sec-506"></a>> **Source:** `docs/ux-flows/09-x402-agent-commerce.md` · [↑ table of contents](#table-of-contents)@@ -115814,7 +116642,7 @@ choreographed two-agent narrative driven by Server-Sent Events.----<a id="sec-504"></a>+<a id="sec-507"></a>> **Source:** `docs/ux-flows/10-chat-brain-labs.md` · [↑ table of contents](#table-of-contents)@@ -116057,7 +116885,7 @@ modules. Routes resolved via `vercel.json` rewrites.----<a id="sec-505"></a>+<a id="sec-508"></a>> **Source:** `docs/ux-flows/11-account-dashboard.md` · [↑ table of contents](#table-of-contents)@@ -116280,7 +117108,7 @@ Shared auth concepts:----<a id="sec-506"></a>+<a id="sec-509"></a>> **Source:** `docs/ux-flows/12-home-and-content.md` · [↑ table of contents](#table-of-contents)@@ -116520,7 +117348,7 @@ All `/.well-known/*` and `/openapi.json` / `/sitemap.xml` responses are JSON/XML----<a id="sec-507"></a>+<a id="sec-510"></a>> **Source:** `docs/validation.md` · [↑ table of contents](#table-of-contents)@@ -116899,7 +117727,7 @@ The toggle's CSS class reflects the highest severity: `level-0` (errors), `level----<a id="sec-508"></a>+<a id="sec-511"></a>> **Source:** `docs/vanity.md` · [↑ table of contents](#table-of-contents)@@ -116907,7 +117735,7 @@ The toggle's CSS class reflects the highest severity: `level-0` (errors), `levelThree x402 endpoints that hand an agent a **branded Solana address** — one thatstarts with your ticker/prefix and/or ends with a chosen suffix — with no wallet,-no account, and no SOL. Pay per call in USDC over the [x402](#sec-552) rail and the+no account, and no SOL. Pay per call in USDC over the [x402](#sec-554) rail and theserver grinds (or delivers from stock) a brand-new keypair that matches.| Endpoint | What it is | Chars | Price | Pick it when |@@ -116925,7 +117753,7 @@ Tier 1 and tier 3 **share one warehouse** — the `vanity_inventory` table,pre-ground on batch spot CPU (`workers/vanity-grinder`) and auto-replenishedwhen stock runs low (`api/cron/vanity-inventory-replenish`, hourly). Tier 1 is"give me anything that matches, right now"; tier 3 is "let me pick this exact-address from the catalog." [Pump Launcher](#sec-344) draws from the+address from the catalog." [Pump Launcher](#sec-346) draws from thesame warehouse for instant vanity mint addresses.## Which agent uses this, and why us@@ -117127,7 +117955,7 @@ workers/vanity-grinder/grind.mjs` (see its`vanitySuffix` checks this same inventory before grinding a mint address live —a hit skips the grind entirely (`vanity_source: "inventory"` in the response),a miss grinds as before (`vanity_source: "ground"`). Same one-shot claim, same-atomicity, no separate purchase step. See [pump-launcher.md](#sec-344).+atomicity, no separate purchase step. See [pump-launcher.md](#sec-346).---@@ -117142,20 +117970,20 @@ challenges and the discovery doc stay in parity.## Related-- [x402 endpoints overview](#sec-547)+- [x402 endpoints overview](#sec-549)- [three-vanity/v1 protocol spec](#sec-005)-- [Pump Launcher](#sec-344) — accepts an optional vanity mint prefix/suffix+- [Pump Launcher](#sec-346) — accepts an optional vanity mint prefix/suffix- Web grinder + verifier: [`/vanity-wallet`](https://three.ws/vanity-wallet), [`/vanity/verify`](https://three.ws/vanity/verify)----<a id="sec-509"></a>+<a id="sec-512"></a>> **Source:** `docs/vaults.md` · [↑ table of contents](#table-of-contents)# USDC agent vaults: the deep reference-A vault lets strangers put **real USDC** behind one trading agent, on terms the agent's owner publishes up front. The product-level tour (who each surface is for, how vaults sit next to the Arena, the Theater and Swarms) is in [trading-arenas.md](#sec-416), under "Back-an-Agent Vaults". **Read that first.** This document is the layer underneath it: the exact routes, the auth boundary on each one, the share math, the guards that sit in front of a trade, and the audit ledger anyone can read.+A vault lets strangers put **real USDC** behind one trading agent, on terms the agent's owner publishes up front. The product-level tour (who each surface is for, how vaults sit next to the Arena, the Theater and Swarms) is in [trading-arenas.md](#sec-419), under "Back-an-Agent Vaults". **Read that first.** This document is the layer underneath it: the exact routes, the auth boundary on each one, the share math, the guards that sit in front of a trade, and the audit ledger anyone can read.Everything here moves real money on Solana mainnet. Read [Safety: what spends, and what has to confirm it](#safety-what-spends-and-what-has-to-confirm-it) before you call any `POST`.@@ -117226,7 +118054,7 @@ curl -sX POST https://three.ws/api/vaults \}'```-`201` returns the vault row including `vault_address`. Note the address: the vault also needs a little **SOL** to pay swap fees and open token accounts, and there is no vault-funding endpoint. Send roughly 0.01 SOL to `vault_address` yourself, for example from your master wallet (see [user-wallet.md](#sec-494)). Without it, trades are refused with `insufficient_sol_for_fees` before anything is signed.+`201` returns the vault row including `vault_address`. Note the address: the vault also needs a little **SOL** to pay swap fees and open token accounts, and there is no vault-funding endpoint. Send roughly 0.01 SOL to `vault_address` yourself, for example from your master wallet (see [user-wallet.md](#sec-497)). Without it, trades are refused with `insufficient_sol_for_fees` before anything is signed.The browser flow is the "Open a vault" modal on [/vaults](https://three.ws/vaults), which is only shown to a signed-in user and pre-fills the same defaults.@@ -117459,16 +118287,16 @@ Two honest limits a backer should know: the platform can sign for the vault (tha## Related-- [trading-arenas.md](#sec-416) for the product overview of vaults and the surfaces around them+- [trading-arenas.md](#sec-419) for the product overview of vaults and the surfaces around them- [agent-wallets.md](#sec-072) for the custodial wallet a backer funds from- [custody.md](#sec-172) for spend limits, the freeze switch, and proof of custody-- [user-wallet.md](#sec-494) for the per-user master wallet, the easiest way to send a vault its fee SOL+- [user-wallet.md](#sec-497) for the per-user master wallet, the easiest way to send a vault its fee SOL- [agent-reputation.md](#sec-056) for the badge that gates opening a vault- [authentication.md](#sec-103) for sessions, CSRF tokens, and API keys----<a id="sec-510"></a>+<a id="sec-513"></a>> **Source:** `docs/viability.md` · [↑ table of contents](#table-of-contents)@@ -117650,7 +118478,7 @@ appears only when there is something to show, pointing at the filtered- [The autonomous economy](#sec-104): the wallets, spend policies,paid skills, and trading loops whose real activity this page measures.-- [x402 revenue and receipts](#sec-548): the platform's own endpoint+- [x402 revenue and receipts](#sec-550): the platform's own endpointrevenue, recorded in a different table and never mixed into the marketplace ortrading figures here.- [Agent Economy Volume](#sec-052): the agent-to-agent USDC@@ -117658,7 +118486,7 @@ appears only when there is something to show, pointing at the filtered----<a id="sec-511"></a>+<a id="sec-514"></a>> **Source:** `docs/viewer.md` · [↑ table of contents](#table-of-contents)@@ -118052,7 +118880,7 @@ A subset of state (background, transparency, background color, auto-rotate, expo----<a id="sec-512"></a>+<a id="sec-515"></a>> **Source:** `docs/voice-lab.md` · [↑ table of contents](#table-of-contents)@@ -118214,14 +119042,14 @@ The agent-voice handler ([`api/agents/_id/voice.js`](../api/agents/_id/voice.js)## Related-- [Voice and lipsync tutorial](#sec-487): the authoritative step-by-step, including wiring a cloned voice into an agent.-- [Lipsync](#sec-267): how synthesized speech drives an avatar's mouth in real time.-- [Talking Avatar Video](#sec-408): render a talking-head clip from an avatar and an audio track.+- [Voice and lipsync tutorial](#sec-490): the authoritative step-by-step, including wiring a cloned voice into an agent.+- [Lipsync](#sec-268): how synthesized speech drives an avatar's mouth in real time.+- [Talking Avatar Video](#sec-410): render a talking-head clip from an avatar and an audio track.- Pages: [/voice](https://three.ws/voice), [/dashboard](https://three.ws/dashboard).----<a id="sec-513"></a>+<a id="sec-516"></a>> **Source:** `docs/walk-leaderboard.md` · [↑ table of contents](#table-of-contents)@@ -118345,7 +119173,7 @@ As coded, in layers. Each one bounds a different kind of nonsense:| Achievement allowlist | same | Only the four known codes persist, and each unlocks once per walker, so badges cannot be farmed by replaying a batch. || Idempotent rollup | unique index in [the migration](../api/_lib/migrations/20260621140000_walk_metrics.sql) | Batches merge into one row per dimension tuple per day, so the table cannot be flooded into a different shape. |-**What these guards do and do not claim.** `POST /api/walk/metrics` is a public, open-CORS ingest keyed on a client-supplied anonymous id, because embeds post from third-party hosts and anonymous walkers are first-class on the board. The guards above bound the size, rate, and attribution of any single claim; they do not cryptographically prove that a walk happened. There is no cross-batch plausibility check (for example, distance against elapsed duration) and no server-side replay of the controller. Treat the board as a gamified activity ranking, not as an audited measurement. If you need a movement claim that a third party can verify, that is a different product: [World Lines](#sec-518) issue agent-signed proofs of physical presence with server-derived co-location.+**What these guards do and do not claim.** `POST /api/walk/metrics` is a public, open-CORS ingest keyed on a client-supplied anonymous id, because embeds post from third-party hosts and anonymous walkers are first-class on the board. The guards above bound the size, rate, and attribution of any single claim; they do not cryptographically prove that a walk happened. There is no cross-batch plausibility check (for example, distance against elapsed duration) and no server-side replay of the controller. Treat the board as a gamified activity ranking, not as an audited measurement. If you need a movement claim that a third party can verify, that is a different product: [World Lines](#sec-521) issue agent-signed proofs of physical presence with server-derived co-location.---@@ -118511,14 +119339,14 @@ The anonymous id is generated and persisted by the walk runtime in `localStorage## Related-- [Add the Walk Companion to your site](#sec-488), the hands-on path from a copy-paste iframe to the `@three-ws/walk` package, including the surfaces that produce the metrics ranked here.+- [Add the Walk Companion to your site](#sec-491), the hands-on path from a copy-paste iframe to the `@three-ws/walk` package, including the surfaces that produce the metrics ranked here.- The walk documentation set on the site, served from `public/docs/walk/`: `/docs/walk` (index), `/docs/walk/getting-started`, `/docs/walk/walk-page`, `/docs/walk/embed-iframe`, `/docs/walk/embed-sdk`, `/docs/walk/companion-mode`, `/docs/walk/chrome-extension`, `/docs/walk/postmessage-events`, `/docs/walk/changelog`, and `/docs/walk/analytics`, which covers the per-creator dashboard fed by the same ingest.- The creator-side view of this data: `three.ws/walk-analytics`, backed by `GET /api/walk/analytics`.-- [World Lines](#sec-518), for movement claims that carry a verifiable agent signature rather than a leaderboard rank.+- [World Lines](#sec-521), for movement claims that carry a verifiable agent signature rather than a leaderboard rank.----<a id="sec-514"></a>+<a id="sec-517"></a>> **Source:** `docs/web-component.md` · [↑ table of contents](#table-of-contents)@@ -118626,7 +119454,7 @@ el.removeAttribute('sign-language'); // offSigning rides the same `SPEAK` event as spoken replies, so it works identicallyin the hosted app and in an embed. A runnable page is[examples/sign-language.html](../examples/sign-language.html); the engine and its-vocabulary are documented in [Sign language](#sec-386), and the+vocabulary are documented in [Sign language](#sec-388), and thealphabet is browsable at [/asl-alphabet](https://three.ws/asl-alphabet).### Skills and memory@@ -119477,7 +120305,7 @@ defineElement('my-agent');----<a id="sec-515"></a>+<a id="sec-518"></a>> **Source:** `docs/widget-api.md` · [↑ table of contents](#table-of-contents)@@ -119684,7 +120512,7 @@ If you have multiple widgets and want to coordinate them (sync camera, broadcast----<a id="sec-516"></a>+<a id="sec-519"></a>> **Source:** `docs/widget-studio.md` · [↑ table of contents](#table-of-contents)@@ -119928,14 +120756,14 @@ You can override these freely in the iframe `width` and `height` attributes. Add## Next steps-- [Widget API (JSON-RPC)](#sec-515) — programmatic control over an embedded widget: camera, animation, screenshots, model loading-- [Widgets reference](#sec-517) — technical details, postMessage API, CSP config, and oEmbed spec-- [Web component](#sec-514) — the `<agent-3d>` custom element for developer integrations+- [Widget API (JSON-RPC)](#sec-518) — programmatic control over an embedded widget: camera, animation, screenshots, model loading+- [Widgets reference](#sec-520) — technical details, postMessage API, CSP config, and oEmbed spec+- [Web component](#sec-517) — the `<agent-3d>` custom element for developer integrations- [Embedding guide](#sec-188) — advanced embedding patterns and iframe options----<a id="sec-517"></a>+<a id="sec-520"></a>> **Source:** `docs/widgets.md` · [↑ table of contents](#table-of-contents)@@ -120440,7 +121268,7 @@ No IP addresses, no user-agent strings, no cookies, no chat message content. The## Programmatic control-Need to drive a widget from the parent page — change the camera, play an animation, grab a screenshot? See the [Widget API (JSON-RPC)](#sec-515) reference. The `ThreeWidget` SDK lives at `/widget-client.js` and works with any iframe pointing at `/widget`.+Need to drive a widget from the parent page — change the camera, play an animation, grab a screenshot? See the [Widget API (JSON-RPC)](#sec-518) reference. The `ThreeWidget` SDK lives at `/widget-client.js` and works with any iframe pointing at `/widget`.---@@ -120453,7 +121281,7 @@ Need to drive a widget from the parent page — change the camera, play an anima----<a id="sec-518"></a>+<a id="sec-521"></a>> **Source:** `docs/world-lines.md` · [↑ table of contents](#table-of-contents)@@ -120695,7 +121523,7 @@ Coverage for the crypto core lives in [tests/world-lines-crypto.test.js](../test## Privacy: exactly what is stored-The engineering analysis for all of IRL is the [IRL threat model](#sec-260); the user-facing summary is the `three.ws/irl-privacy` page. World Lines specifically:+The engineering analysis for all of IRL is the [IRL threat model](#sec-261); the user-facing summary is the `three.ws/irl-privacy` page. World Lines specifically:**Stored.**@@ -121035,14 +121863,14 @@ Both handlers log their enforcement mode once per cold start, so a production mi## Related- [IRL: agents in the real world](irl.md#world-lines), the product-level overview and the rest of the presence layer.-- [IRL threat model](#sec-260), the adversarial analysis behind every radius and cap above.-- [Place a 3D agent in your real environment](#sec-465), how to create the anchor pin a World Line needs.+- [IRL threat model](#sec-261), the adversarial analysis behind every radius and cap above.+- [Place a 3D agent in your real environment](#sec-468), how to create the anchor pin a World Line needs.- [API reference](#sec-096), the one-screen summary of these endpoints alongside the rest of `/api/irl/*`.- [AR](#sec-099), the camera and WebXR layer the ceremony builds on.----<a id="sec-519"></a>+<a id="sec-522"></a>> **Source:** `docs/x-archive.md` · [↑ table of contents](#table-of-contents)@@ -121103,7 +121931,7 @@ clean checkout.## The report-[docs/x-archive/trythreews-engagement.md](#sec-520)+[docs/x-archive/trythreews-engagement.md](#sec-523)is generated, never hand-edited. It carries:- headline totals and the engagement **distribution** (median, p75/p90/p99, and@@ -121154,7 +121982,7 @@ Code: [scripts/x-archive-lib.mjs](../scripts/x-archive-lib.mjs)----<a id="sec-520"></a>+<a id="sec-523"></a>> **Source:** `docs/x-archive/trythreews-engagement.md` · [↑ table of contents](#table-of-contents)@@ -121405,7 +122233,7 @@ The floor is as instructive as the ceiling: these are the shapes to stop repeati----<a id="sec-521"></a>+<a id="sec-524"></a>> **Source:** `docs/x-memory-seeding.md` · [↑ table of contents](#table-of-contents)@@ -121424,7 +122252,7 @@ yes on a screen that tells you exactly what will be read and stored.- **Surface**: Settings, Connected accounts, X card at [/settings#connected-accounts](https://three.ws/settings#connected-accounts)- **API**: `/api/agents/:id/memory/seed/x`-- **Related**: [Memory system](#sec-284), [Farcaster memory seeding](#sec-222), [GitHub seeding in the same table](memory.md#seeding-memory-from-an-existing-account)+- **Related**: [Memory system](#sec-285), [Farcaster memory seeding](#sec-222), [GitHub seeding in the same table](memory.md#seeding-memory-from-an-existing-account)---@@ -121523,7 +122351,7 @@ Each fact becomes one row in `agent_memories`:from your posting history.- Salience `0.80` for the top-ranked fact, decaying by rank.- The **top five facts land in the `working` tier**, the always-in-context core- the chat runtime pages into every reply (see [memory system](#sec-284)).+ the chat runtime pages into every reply (see [memory system](#sec-285)).That is what makes a seed observable in the very next conversation turn.- `context` carries `source: 'x_seed'`, your handle, the distillation lane(`model` or `derived`), the disclosure version, and the consent id.@@ -121725,7 +122553,7 @@ Seeded rows in `agent_memories` are found by tag (`tags && '{x_seed}'`) and by----<a id="sec-522"></a>+<a id="sec-525"></a>> **Source:** `docs/x-posts/3d-ar-studio-launch.md` · [↑ table of contents](#table-of-contents)@@ -122025,7 +122853,7 @@ Point it at your own catalogue with one option if you would rather use yours.----<a id="sec-523"></a>+<a id="sec-526"></a>> **Source:** `docs/x-posts/3d-ar-studio-video-script.md` · [↑ table of contents](#table-of-contents)@@ -122150,7 +122978,7 @@ match them to the narration beats:----<a id="sec-524"></a>+<a id="sec-527"></a>> **Source:** `docs/x-posts/README.md` · [↑ table of contents](#table-of-contents)@@ -122175,37 +123003,36 @@ explicit approval). Each file states what it's for and what has already been ver| File | What it announces || --- | --- |-| [`onchain-agent-wallets-x-post.md`](#sec-537) | Agent wallets with an on-chain spending allowance instead of a private key: SPL Token delegation, guardrails, x402, revocable custody |-| [`mcp-registry-fleet-x-post.md`](#sec-530) | The fleet as a whole: 72 MCP servers under one namespace in the official registry, all current |-| [`metaplex-agent-mcp-launch.md`](#sec-533) | The open-source agent infrastructure announcement covering `@three-ws/metaplex-agent-mcp` and `@three-ws/onchain-agent-wallets`, and why the integrations are bullish for $THREE |-| [`metaplex-agent-mcp-x-post.md`](#sec-535) | The MCP server that mints an agent into the Metaplex Agent Registry with its own wallet and EIP-8004 identity |-| [`metaplex-agent-deployer-x-post.md`](#sec-532) | The browser deployer at nirholas.github.io/metaplex-agent-mcp |-| [`3d-ar-studio-launch.md`](#sec-522) | 3D AR Studio, the AR studio extracted from three.ws and published as an open-source package |-| [`ar-quick-look-fix-x-post.md`](#sec-525) | AR Forge and AR Studio now open real Apple Quick Look / Google Scene Viewer on a phone, matching what `/avatars/:id/ar` already did. Shipped to `main` locally, **not yet deployed**: do not post until verified live on a real iPhone |-| [`threews-avatar-launch.md`](#sec-541) | The three.ws avatar pipeline launch copy |-| [`oracle-trading-mcp-x-post.md`](#sec-538) | The oracle trading MCP server launch |-| [`sperax-staking-in-chat-x-post.md`](#sec-540) | SperaxOS chat-native staking, balance, and buy-SPA tool calls. The embedded `/staking` page is not working yet: do not announce until the blockers in the file clear |-| [`news-archive-x-post.md`](#sec-536) | The news archive |-| [`pumpfun-article-x-post.md`](#sec-539) | The pump.fun article |+| [`onchain-agent-wallets-x-post.md`](#sec-539) | Agent wallets with an on-chain spending allowance instead of a private key: SPL Token delegation, guardrails, x402, revocable custody |+| [`mcp-registry-fleet-x-post.md`](#sec-532) | The fleet as a whole: 72 MCP servers under one namespace in the official registry, all current |+| [`metaplex-agent-mcp-launch.md`](#sec-535) | The open-source agent infrastructure announcement covering `@three-ws/metaplex-agent-mcp` and `@three-ws/onchain-agent-wallets`, and why the integrations are bullish for $THREE |+| [`metaplex-agent-mcp-x-post.md`](#sec-537) | The MCP server that mints an agent into the Metaplex Agent Registry with its own wallet and EIP-8004 identity |+| [`metaplex-agent-deployer-x-post.md`](#sec-534) | The browser deployer at nirholas.github.io/metaplex-agent-mcp |+| [`3d-ar-studio-launch.md`](#sec-525) | 3D AR Studio, the AR studio extracted from three.ws and published as an open-source package |+| [`ar-quick-look-fix-x-post.md`](#sec-528) | AR Forge and AR Studio now open real Apple Quick Look / Google Scene Viewer on a phone, matching what `/avatars/:id/ar` already did. Shipped to `main` locally, **not yet deployed**: do not post until verified live on a real iPhone |+| [`threews-avatar-launch.md`](#sec-543) | The three.ws avatar pipeline launch copy |+| [`oracle-trading-mcp-x-post.md`](#sec-540) | The oracle trading MCP server launch |+| [`sperax-staking-in-chat-x-post.md`](#sec-542) | SperaxOS chat-native staking, balance, and buy-SPA tool calls. The embedded `/staking` page is not working yet: do not announce until the blockers in the file clear |+| [`news-archive-x-post.md`](#sec-538) | The news archive |+| [`pumpfun-article-x-post.md`](#sec-541) | The pump.fun article |## Video and narration scripts| File | What it covers || --- | --- |-| [`metaplex-agent-mcp-veo-script.md`](#sec-534) | Shot-by-shot Veo (image-to-video) prompts for the agent infrastructure clip, built from a three.ws 3D avatar as the reference frame |-| [`metaplex-agent-deployer-video-script.md`](#sec-531) | Spoken narration for the deployer clip |-| [`threews-avatar-video-script.md`](#sec-542) | Shot list for the avatar clip |-| [`3d-ar-studio-video-script.md`](#sec-523) | Narration and shot prompts for the AR Studio launch video |+| [`metaplex-agent-mcp-veo-script.md`](#sec-536) | Shot-by-shot Veo (image-to-video) prompts for the agent infrastructure clip, built from a three.ws 3D avatar as the reference frame |+| [`metaplex-agent-deployer-video-script.md`](#sec-533) | Spoken narration for the deployer clip |+| [`threews-avatar-video-script.md`](#sec-544) | Shot list for the avatar clip |+| [`3d-ar-studio-video-script.md`](#sec-526) | Narration and shot prompts for the AR Studio launch video |## Events and community| File | What it covers || --- | --- |-| [`event-x-posts.md`](#sec-527) | Event campaign copy, split by account (`@trythreews` institutional, `@nichxbt` personal) |-| [`x-meetup-posts.md`](#sec-543) | The in-platform community meetup announcement |-| [`ibm-skillsbuild-x-post.md`](#sec-529) | The IBM SkillsBuild badge |-| [`coinbase-listing-thank-you-reply.md`](#sec-526) | The long thank-you reply for the Coinbase listing moment: credit to Jesse Pollak and Base for x402, the ERC-8004 contracts we build on, and every three.ws partner |-| [`fomo-verified-x-post.md`](#sec-528) | FOMO verification |+| [`event-x-posts.md`](#sec-529) | Event campaign copy, split by account (`@trythreews` institutional, `@nichxbt` personal) |+| [`x-meetup-posts.md`](#sec-545) | The in-platform community meetup announcement |+| [`ibm-skillsbuild-x-post.md`](#sec-531) | The IBM SkillsBuild badge |+| [`fomo-verified-x-post.md`](#sec-530) | FOMO verification |## Conventions@@ -122221,7 +123048,7 @@ entry is dead once the file is no longer routed.----<a id="sec-525"></a>+<a id="sec-528"></a>> **Source:** `docs/x-posts/ar-quick-look-fix-x-post.md` · [↑ table of contents](#table-of-contents)@@ -122229,7 +123056,7 @@ entry is dead once the file is no longer routed.Announcement copy for a bug fix, not a new feature: `three.ws/ar` (AR Forge) and `three.ws/ar/studio`(AR Studio) now place a model in your real room on iPhone the way `three.ws/avatars/:id/ar` already-did. Related file: [threews-avatar-launch.md](#sec-541) sells the avatar-has-a-body+did. Related file: [threews-avatar-launch.md](#sec-543) sells the avatar-has-a-bodystory; this one sells "AR here means AR, on every phone, not just some of them."**Thesis of this announcement:** every AR surface on the site now runs real ARKit Quick Look on@@ -122312,7 +123139,7 @@ the resolution of a problem, and "watch it look real" is a dare to try it, not a### From @nichxbt (the human one, quote-tweeting the @trythreews post above)-Same two-account split as [event-x-posts.md](#sec-527): `@trythreews` posts the+Same two-account split as [event-x-posts.md](#sec-529): `@trythreews` posts theinstitutional version above, `@nichxbt` quote-tweets it with the human one a few minutes later, notsimultaneously. Her post is pure enthusiasm, first person, no bug talk.@@ -122438,157 +123265,15 @@ what three.ws does well rather than dwelling on the fix.post; add a $THREE line only if a specific alternate calls for it, don't bolt one onto everydraft.- **Screenshots, if used, should show the model sitting convincingly in a real room**, the way- [3d-ar-studio-launch.md](#sec-522) already frames its media: a real floor in+ [3d-ar-studio-launch.md](#sec-525) already frames its media: a real floor inframe is the whole point.- **Do not combine this with the AR Studio open-source package announcement**- ([3d-ar-studio-launch.md](#sec-522)). That post is about giving the surface away as+ ([3d-ar-studio-launch.md](#sec-525)). That post is about giving the surface away asa library; this one is about how good AR feels on three.ws today. Mixing them muddies both.----<a id="sec-526"></a>--> **Source:** `docs/x-posts/coinbase-listing-thank-you-reply.md` · [↑ table of contents](#table-of-contents)--# Thank-you reply: the Coinbase listing moment--Reply copy for **@nichxbt** under [the listing post](https://x.com/nichxbt) that-[@jessepollak](https://x.com/jessepollak) answered with "huge congrats!!!!" on 2026-08-21.--**Tone:** sincere, warm, confident. Not a joke, not a flex, not a price post. This is a-thank-you to a builder from a builder, and the only currency in it is credit.--**Verified true today:** $THREE lives on Solana at-`FeMbDoX7R1Psc4GEcvJdsbNbZA3bfztcyDCatJVJpump`; three.ws settles real x402 micropayments in-USDC on Solana and Base, on a loop that runs every minute with real on-chain settlement and no-mocks ([`docs/autonomous-x402.md`](#sec-105)); agent identity is registered against-the ERC-8004 registries on Base mainnet (chain 8453), where a registration costs roughly-$0.10 to $0.25 in gas ([`docs/erc8004.md`](#sec-190), [`docs/smart-contracts.md`](#sec-393));-the partner ecosystem at [three.ws/partners](https://three.ws/partners) covers OpenAI, IBM, AWS,-Google Cloud, Alibaba Cloud, NVIDIA, Quicknode, and HackerNoon.--**Do not claim:** a negotiated or centralized Coinbase listing agreement, any Coinbase-partnership, any endorsement by Jesse Pollak or the Base team, any price or market-cap number,-or that buybacks are executing. Jesse's own post is the source: every token on Base and Solana-is now surfaced in the main Coinbase app. Thank the change, never inflate it.--**Format:** this is a long-form reply and it is well past 280 characters, so it posts from the-Premium account. If it has to fit the free limit, use the short version at the bottom.-------## The reply (post this)--> Thank you, Jesse. Truly.->-> I have been building long enough to know what a reply like that is worth on a day like this,-> and it is worth more than the listing. You did not have to say anything. You said something-> anyway, and you said it first, and you said it with real warmth. That is the part I will-> remember when the chart has done whatever the chart is going to do.->-> So let me say thank you properly, because a two-word reply does not cover it.->-> Thank you for building. Not announcing, not positioning, not reserving the right to build-> later. Building. Base did not arrive as a promise, it arrived as a chain people could ship on-> the same afternoon they heard about it, with gas cheap enough that a single person with an-> idea and no funding could put something real on it. That decision has quietly paid for-> thousands of experiments that would never have survived a mainnet gas bill. Ours is one of-> them.->-> Thank you for innovating out loud. Killing the centralized listing process is not a feature-> release, it is a statement about who the market is for. For years the honest answer to a small-> team asking "how do we get listed" was: know someone, wait, hope. Today the answer is: ship-> something worth holding and the door is already open. You turned a gate into a road. Every-> founder who is currently building in a bedroom at 2am with no contacts and no budget just got-> handed the same distribution as everyone else, and most of them do not even know it yet. They-> will.->-> Thank you for x402. This one is personal for us. three.ws is not a token with an app attached,-> it is an economy of AI agents that pay each other, and payment was the hard part for years.-> Agents could think, they could call tools, they could hold a wallet, but they could not-> transact in the one motion the web already understands: a request, a 402, a signature, a-> settlement, a response. x402 gave that back to HTTP. Our agents now settle real USDC per call,-> on Solana and on Base, on a loop that runs every single minute of every single day, with-> receipts, spend caps, and no simulation anywhere in the path. When an agent on our platform-> buys market intel, it actually pays for it. When someone builds a service on us, other agents-> can actually buy it. That is not a demo. That is a working market, and the standard underneath-> it came from your side of the table.->-> Thank you for the contracts we build on. Our agent identity lives on Base at the ERC-8004-> registries, which means an agent created on three.ws is not a row in our database, it is a-> public, verifiable, portable identity that outlives us. Anyone can resolve it. Anyone can check-> who owns it. Anyone can read its reputation without asking our permission or trusting our-> uptime. Registration costs a couple of dimes and confirms in a couple of seconds. Ten years of-> crypto infrastructure had to work for that sentence to be boring, and on Base it is boring,-> which is the highest compliment infrastructure can receive.->-> And thank you to Coinbase. Not for the listing itself, for the philosophy behind it. Choosing-> to surface what the market chose instead of what a committee approved is a hard call to make-> when you are the biggest venue in the room, and it gives up real gatekeeping power on purpose.-> That is the kind of decision that only makes sense if you actually believe the open version-> wins. We believe it too. It is why every line of three.ws is Apache-2.0 and why our SDKs, our-> MCP servers, and our agent stack are public for anyone to fork, including our competitors.->-> To our partners: OpenAI, IBM, AWS, Google Cloud, Alibaba Cloud, NVIDIA, Quicknode, HackerNoon.-> Thank you for taking a small team seriously before there was any reason to. Every one of you-> said yes at a stage where saying no would have been the safe, defensible, completely reasonable-> answer. You gave us compute, distribution, review, credibility, and in more than one case a-> direct line to an engineer who fixed our problem on a weekend. None of that shows up in a-> ticker. All of it shows up in the product.->-> To the $THREE holders, and I mean the ones who were here months ago when there was nothing to-> look at but a roadmap and a promise: you funded this. Not abstractly. Literally. You held-> through quiet weeks that would have broken a less patient community, and you kept showing up in-> the channel asking good questions instead of asking when. Whatever this becomes, you were early-> in the only sense that ever mattered, which is that you were early on purpose.->-> Here is what I want to say to anyone else reading this who is building something and wondering-> whether it is worth it.->-> It is worth it. The infrastructure you needed five years ago exists now. Blockspace is cheap.-> Identity is standardized. Payments are a header. Distribution is no longer a phone call you are-> not connected enough to make. Every excuse that used to be legitimate has been systematically-> dismantled by people who chose to make the ladder public instead of pulling it up behind them.-> All that is left is the work, and the work has always been the fun part.->-> We are going to keep our head down and earn this. More agents, more open source, more of the-> economy wired end to end, and every bit of it shipped in public where you can check it. The-> listing is not the finish line and it was never the goal. It is a bigger room. We intend to-> deserve it.->-> Thank you, genuinely, from all of us at three.ws.->-> Now back to building.-------## Short version (fits the 280-character limit)--*(274 characters, no links)*--> Thank you, Jesse. You did not have to reply and you did, first and warmly.->-> Thank you for building Base, for x402, and for making listing something you earn by shipping-> instead of by knowing someone. Our agents settle real USDC every minute because of it.->-> Back to building.-------## Notes for the poster--- Post it as a **reply to Jesse's reply**, not as a new post. The warmth only reads correctly in- the thread where the thanks was earned.-- Do not add a link. A link turns a thank-you into a marketing post and the timeline can tell the- difference instantly.-- Do not quote-tweet your own announcement to attach this. Reply in place.-- If it needs trimming for reach, cut whole paragraphs from the middle rather than shortening- every paragraph. The open, the x402 paragraph, the partners paragraph, the holders paragraph,- and the close are the load-bearing ones.-------<a id="sec-527"></a>+<a id="sec-529"></a>> **Source:** `docs/x-posts/event-x-posts.md` · [↑ table of contents](#table-of-contents)@@ -122902,7 +123587,7 @@ Practical notes for reused footage:----<a id="sec-528"></a>+<a id="sec-530"></a>> **Source:** `docs/x-posts/fomo-verified-x-post.md` · [↑ table of contents](#table-of-contents)@@ -122996,7 +123681,7 @@ Shorter alternate:----<a id="sec-529"></a>+<a id="sec-531"></a>> **Source:** `docs/x-posts/ibm-skillsbuild-x-post.md` · [↑ table of contents](#table-of-contents)@@ -123204,7 +123889,7 @@ https://www.credly.com/badges/b7ea921a-ce3d-4f4d-bfac-38f95276d361/twitter via @----<a id="sec-530"></a>+<a id="sec-532"></a>> **Source:** `docs/x-posts/mcp-registry-fleet-x-post.md` · [↑ table of contents](#table-of-contents)@@ -123321,14 +124006,14 @@ Post 1 is the main post. Then:----<a id="sec-531"></a>+<a id="sec-533"></a>> **Source:** `docs/x-posts/metaplex-agent-deployer-video-script.md` · [↑ table of contents](#table-of-contents)# Spoken script: the agent deployer videoThe words only. Visual prompts, camera, and palette live in-[metaplex-agent-mcp-x-post.md](#sec-535); this file is what gets said, cut+[metaplex-agent-mcp-x-post.md](#sec-537); this file is what gets said, cutinto the 8-second beats Veo generates so each line lands inside one clip.**Pacing rule:** 8 seconds of natural speech is 18 to 22 words at the absolute ceiling, and 12 to 16@@ -123428,7 +124113,7 @@ For a single generation with no editing. One breath, one idea.----<a id="sec-532"></a>+<a id="sec-534"></a>> **Source:** `docs/x-posts/metaplex-agent-deployer-x-post.md` · [↑ table of contents](#table-of-contents)@@ -123666,7 +124351,7 @@ our own product, no pretending to be a bystander.----<a id="sec-533"></a>+<a id="sec-535"></a>> **Source:** `docs/x-posts/metaplex-agent-mcp-launch.md` · [↑ table of contents](#table-of-contents)@@ -123869,14 +124554,14 @@ fund them, which is already the safe, verified claim.----<a id="sec-534"></a>+<a id="sec-536"></a>> **Source:** `docs/x-posts/metaplex-agent-mcp-veo-script.md` · [↑ table of contents](#table-of-contents)# Veo script: the open-source stackShot-by-shot **visual** prompts for a Veo image-to-video clip to run alongside-[`metaplex-agent-mcp-launch.md`](#sec-533). Text-to-video only, no dialogue, no+[`metaplex-agent-mcp-launch.md`](#sec-535). Text-to-video only, no dialogue, novoiceover: the reference frame is a three.ws 3D avatar, and every prompt below is written to bepasted straight into Veo as-is.@@ -123980,7 +124665,7 @@ to show something spreading to others, not just one agent getting a wallet.----<a id="sec-535"></a>+<a id="sec-537"></a>> **Source:** `docs/x-posts/metaplex-agent-mcp-x-post.md` · [↑ table of contents](#table-of-contents)@@ -124257,7 +124942,7 @@ keys, your limits.**----<a id="sec-536"></a>+<a id="sec-538"></a>> **Source:** `docs/x-posts/news-archive-x-post.md` · [↑ table of contents](#table-of-contents)@@ -124347,11 +125032,11 @@ If someone asks how it stays current: the archiver runs hourly against all 197 fnewest month is always live and the corpus grows every hour. If someone asks about publisherrights: the reader shows a bounded excerpt plus our own summary and sends readers to thepublisher, and the cap plus any takedown is enforced server side across the reader, the RSS-mirror, archive search, and the agent knowledge corpus. See [docs/news-rights.md](#sec-296).+mirror, archive search, and the agent knowledge corpus. See [docs/news-rights.md](#sec-297).----<a id="sec-537"></a>+<a id="sec-539"></a>> **Source:** `docs/x-posts/onchain-agent-wallets-x-post.md` · [↑ table of contents](#table-of-contents)@@ -124537,7 +125222,7 @@ Post 1 is the main post above. Then:----<a id="sec-538"></a>+<a id="sec-540"></a>> **Source:** `docs/x-posts/oracle-trading-mcp-x-post.md` · [↑ table of contents](#table-of-contents)@@ -124548,7 +125233,7 @@ trading agents are published as Model Context Protocol servers in[Anthropic's official MCP registry](https://registry.modelcontextprotocol.io/?q=io.github.nirholas),so any AI assistant can use them directly.-Build plan this announces: [`docs/oracle-trading-mcp-plan.md`](#sec-319).+Build plan this announces: [`docs/oracle-trading-mcp-plan.md`](#sec-320).**Do not post until:** `npm run smoke:mcp` passes against the live remotes, and both`io.github.nirholas/threews-oracle` and `io.github.nirholas/threews-agent-trader` resolve in the@@ -124678,7 +125363,7 @@ place to be wrong.----<a id="sec-539"></a>+<a id="sec-541"></a>> **Source:** `docs/x-posts/pumpfun-article-x-post.md` · [↑ table of contents](#table-of-contents)@@ -124795,7 +125480,7 @@ Pick one option. Do not post all four.----<a id="sec-540"></a>+<a id="sec-542"></a>> **Source:** `docs/x-posts/sperax-staking-in-chat-x-post.md` · [↑ table of contents](#table-of-contents)@@ -124901,14 +125586,14 @@ on the `/staking` page footer, so anyone who tries it gets exactly what the post----<a id="sec-541"></a>+<a id="sec-543"></a>> **Source:** `docs/x-posts/threews-avatar-launch.md` · [↑ table of contents](#table-of-contents)# Give your AI a body: the avatar filmX copy for the platform film. The shot prompts that produce the video live in-[threews-avatar-video-script.md](#sec-542).+[threews-avatar-video-script.md](#sec-544).**Thesis:** the tagline, literally. A model with no form gets one, the form moves, the form holdsits own wallet, the form walks out into the real world. Nothing about supply, price, or buybacks.@@ -125058,7 +125743,7 @@ Carries the part that does not fit the main post without spending its outbound l----<a id="sec-542"></a>+<a id="sec-544"></a>> **Source:** `docs/x-posts/threews-avatar-video-script.md` · [↑ table of contents](#table-of-contents)@@ -125066,9 +125751,9 @@ Carries the part that does not fit the main post without spending its outbound lPrompts for a video model (Veo, run through ElevenLabs), using a three.ws 3D avatar render as thereference image. This file is the **picture**, not the words. The X copy it ships with is in-[threews-avatar-launch.md](#sec-541), the spoken lines live in-[metaplex-agent-deployer-video-script.md](#sec-531), and the-deployer-specific shot list lives in [metaplex-agent-mcp-x-post.md](#sec-535).+[threews-avatar-launch.md](#sec-543), the spoken lines live in+[metaplex-agent-deployer-video-script.md](#sec-533), and the+deployer-specific shot list lives in [metaplex-agent-mcp-x-post.md](#sec-537).The idea being sold here is the tagline and nothing else: **give your AI a body.** A model with noform gets one, the form moves, the form owns a wallet, the form walks out into the real world. Four@@ -125211,7 +125896,7 @@ Keep the pause after "It has no body." That silence is the whole premise.----<a id="sec-543"></a>+<a id="sec-545"></a>> **Source:** `docs/x-posts/x-meetup-posts.md` · [↑ table of contents](#table-of-contents)@@ -125268,13 +125953,13 @@ https://community.ibm.com/community/user/discussion/community-meetup-inside-thre----<a id="sec-544"></a>+<a id="sec-546"></a>> **Source:** `docs/x402-buyer.md` · [↑ table of contents](#table-of-contents)# x402 Buyer Client-To consume a paid [x402 endpoint](#sec-547) — ours or anyone's — a+To consume a paid [x402 endpoint](#sec-549) — ours or anyone's — acaller has to perform the "402 dance": probe the URL, read the payment challenge,sign and settle a payment, then retry with an `X-PAYMENT` header. three.ws ships abuyer client that wraps that whole sequence in one call, with spending-cap@@ -125364,13 +126049,13 @@ set) back into the payment so attribution survives the round trip.## Related-- [x402 protocol](#sec-552) — the underlying challenge/settle mechanics.-- [x402 paid endpoints](#sec-547) — what you can buy from us.+- [x402 protocol](#sec-554) — the underlying challenge/settle mechanics.+- [x402 paid endpoints](#sec-549) — what you can buy from us.- [Autonomous x402 loop](#sec-105) — uses this client on a schedule.----<a id="sec-545"></a>+<a id="sec-547"></a>> **Source:** `docs/x402-dev-tools.md` · [↑ table of contents](#table-of-contents)@@ -125582,13 +126267,13 @@ implementation against a live server.----<a id="sec-546"></a>+<a id="sec-548"></a>> **Source:** `docs/x402-distribution.md` · [↑ table of contents](#table-of-contents)# x402 Distribution — getting listed and ranked everywhere-three.ws sells 90+ pay-per-call services over [x402](#sec-552). Building them is+three.ws sells 90+ pay-per-call services over [x402](#sec-554). Building them ishalf the job; the other half is making sure every x402 directory, crawler, andagent marketplace can find them — and ranks us at the top. This page is theoperating playbook for that distribution: how each surface indexes providers,@@ -125803,24 +126488,24 @@ script. Everything else above updates itself.## Related-- [x402 overview](#sec-552) · [Paid endpoints reference](#sec-547) ·- [Autonomous loop](#sec-105) · [Buyer client](#sec-544)+- [x402 overview](#sec-554) · [Paid endpoints reference](#sec-549) ·+ [Autonomous loop](#sec-105) · [Buyer client](#sec-546)----<a id="sec-547"></a>+<a id="sec-549"></a>> **Source:** `docs/x402-endpoints.md` · [↑ table of contents](#table-of-contents)# x402 Paid Endpointsthree.ws exposes a catalog of HTTP endpoints that charge per call over-[x402](#sec-552): the caller hits the endpoint, receives a `402 Payment Required`+[x402](#sec-554): the caller hits the endpoint, receives a `402 Payment Required`challenge, settles a small USDC payment, and retries with an `X-PAYMENT` header toget the result. This page is the reference for **our own** paid endpoints, theirprices, and the price-override scheme.-To call these as a buyer, see [x402 buyer client](#sec-544). For the loop+To call these as a buyer, see [x402 buyer client](#sec-546). For the loopthat calls many of them on a schedule, see [Autonomous x402 loop](#sec-105).> Source: handlers under [`api/x402/`](../api/x402), pricing@@ -125934,7 +126619,7 @@ deliberately not advertised in the 402 challenge or the discovery catalog; itrecirculates funds back to `X402_PAY_TO_SOLANA` to keep the closed loop balanced([ring-settle.js:18](../api/x402/ring-settle.js#L18)). The full wallet-by-walletpicture — every receiver, tip, split, treasury, and fee rate — is in the-[money map](#sec-291).+[money map](#sec-292).## Intel & oracle endpoints@@ -126004,7 +126689,7 @@ datapoints at **$0.0005** USDC each by default, overridable per family with| Endpoint | Default | Returns || ----------------------------------- | --------- | ------------------------------------------ |-| `/api/x402/agent-reputation` | $0.01 | Cross-chain 0–100 trust score for any wallet/mint/agent id ([trust primitives](#sec-423)). |+| `/api/x402/agent-reputation` | $0.01 | Cross-chain 0–100 trust score for any wallet/mint/agent id ([trust primitives](#sec-426)). || `/api/x402/agent-bouncer` | $0.01 | Access-gate decision for an agent/wallet. || `/api/x402/onchain-identity-verify` | $0.005 | Verifies an on-chain identity claim. || `/api/x402/skill-marketplace` | $0.001 | Skill listings + pricing. |@@ -126032,8 +126717,8 @@ datapoints at **$0.0005** USDC each by default, overridable per family with| Endpoint | Default | Returns || ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------- | --------------------------------------------------------------------------------------------------------------------------- |-| [`/api/x402/pump-launch`](#sec-344) | $5.00 | **Pump Launcher** — deploy a brand-new pump.fun token in one paid call. No SOL, no wallet, no account: the server fronts the deploy cost and signs the create tx; you pay USDC. Optional vanity mint. Full flow + funnel in [pump-launcher.md](#sec-344). |-| [`/api/x402/vanity`](#sec-508) | $0.01–$0.50 (≤3) · $2.50–$10 (4–5, inventory-only) | **Vanity Grinder** — get a brand-new Solana address that starts with your ticker/prefix and/or ends with a suffix, for a branded token mint or agent/treasury wallet. Checks the pre-ground warehouse first for **instant delivery** (`source: "inventory"`); falls back to a live grind (`source: "ground"`) up to 3 chars. Keypair or importable BIP-39 mnemonic; nothing stored; optional `sealTo` ECIES. Full doc: [vanity.md](#sec-508). |+| [`/api/x402/pump-launch`](#sec-346) | $5.00 | **Pump Launcher** — deploy a brand-new pump.fun token in one paid call. No SOL, no wallet, no account: the server fronts the deploy cost and signs the create tx; you pay USDC. Optional vanity mint. Full flow + funnel in [pump-launcher.md](#sec-346). |+| [`/api/x402/vanity`](#sec-511) | $0.01–$0.50 (≤3) · $2.50–$10 (4–5, inventory-only) | **Vanity Grinder** — get a brand-new Solana address that starts with your ticker/prefix and/or ends with a suffix, for a branded token mint or agent/treasury wallet. Checks the pre-ground warehouse first for **instant delivery** (`source: "inventory"`); falls back to a live grind (`source: "ground"`) up to 3 chars. Keypair or importable BIP-39 mnemonic; nothing stored; optional `sealTo` ECIES. Full doc: [vanity.md](#sec-511). || [`/api/x402/vanity-verifiable`](vanity.md#tier-2--provably-fair-grinder) | $0.02–$0.40 | **Provably-fair grinder** — same grind with a signed commit–reveal receipt proving the key was ground fresh and never kept. Spec: [PROTOCOL-vanity.md](#sec-005). || [`/api/x402/vanity-premium`](vanity.md#tier-3--premium-inventory) | $1–$50 by rarity | **Premium inventory** — buy a pre-ground 4–5+ char brandable address from stock. GET lists available patterns + prices (free); `?address=…` buys via x402 and delivers the key **once** (ciphertext destroyed on delivery). Browsable at `/vanity/premium`. || `/api/x402/pay-by-name` | $0.001 | Resolve and pay a `@username` / `.sol` name / raw address (see [Agent wallets](#sec-072)); the paid resolve toll is $0.001, the transfer amount itself is buyer-specified. A name that resolves to nothing returns `404 not_found` and the payment is left unsettled, so an unresolvable name is free. |@@ -126072,7 +126757,7 @@ directory.| Endpoint | Default | Returns || ---------------------------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |-| `/api/x402/analytics` | $0.005 | Platform reports — pick `report=revenue` for the x402 endpoint-revenue summary (see [x402 revenue & receipts](#sec-548)), plus club and listing analytics. |+| `/api/x402/analytics` | $0.005 | Platform reports — pick `report=revenue` for the x402 endpoint-revenue summary (see [x402 revenue & receipts](#sec-550)), plus club and listing analytics. || `/api/x402/mcp-tool-catalog` | $0.001 | Snapshot of every MCP tool (name, paid/free, price, input shape) and a diff vs the last snapshot (added / removed / re-priced tools). || **Free read surfaces** | — | — || `/api/x402/my-receipts` | free | A buyer's own settled receipts, gated by a wallet signature (SIWX) rather than a payment. |@@ -126082,10 +126767,10 @@ directory.| `/api/x402/glb-optimization-report`| free | GLB Size Optimizer catalog feed: what the `glb-size-optimizer` autonomous-loop entry has measured. || `/api/x402/network-cost` | free | Cross-chain payment-cost recommendation feed from the hourly cross-chain-cost pipeline snapshots. || `/api/x402/runway-lab` | free | Live seed for [/economy-lab](https://three.ws/economy-lab): the fee wallet's real SOL balance and hard floor, the running deploy's governor config, today's spend from `x402_self_facilitator_log`, observed fee-per-settle and 24h demand, and the refusal histogram bucketed by cause (governor / floor / dust guard / duplicate). Read-only; every field is already public through `/api/x402-ring` and `/api/x402-status`. |-| `/api/x402/echo` | free | httpbin for x402 — decodes your `X-PAYMENT` header (signatures redacted) and returns a local verify verdict without settling. See [x402 dev tools](#sec-545). |-| `/api/x402/debug` | free | Diagnoses a failed 402 exchange (`{challenge, payment, response}`) into an ordered `{severity, field, problem, fix}` list. See [x402 dev tools](#sec-545). |-| `/api/x402/verify-receipt` | free | Recomputes a paid response's SHA-256 attestation and confirms a settlement tx on-chain. See [x402 dev tools](#sec-545). |-| `/api/x402/inference-verify` | free | Audits a metered-inference receipt from a paid `llm-proxy` call: per-check verdicts for the issuer signature, the node's response signature, prompt/response hash re-derivation from raw text, on-chain settlement confirmation, and whether the issuer matches the platform's published signers. See [Run an inference node](#sec-256). |+| `/api/x402/echo` | free | httpbin for x402 — decodes your `X-PAYMENT` header (signatures redacted) and returns a local verify verdict without settling. See [x402 dev tools](#sec-547). |+| `/api/x402/debug` | free | Diagnoses a failed 402 exchange (`{challenge, payment, response}`) into an ordered `{severity, field, problem, fix}` list. See [x402 dev tools](#sec-547). |+| `/api/x402/verify-receipt` | free | Recomputes a paid response's SHA-256 attestation and confirms a settlement tx on-chain. See [x402 dev tools](#sec-547). |+| `/api/x402/inference-verify` | free | Audits a metered-inference receipt from a paid `llm-proxy` call: per-check verdicts for the issuer signature, the node's response signature, prompt/response hash re-derivation from raw text, on-chain settlement confirmation, and whether the issuer matches the platform's published signers. See [Run an inference node](#sec-257). |## $THREE only@@ -126096,22 +126781,22 @@ input and do not promote any specific token.## Related-- [Pump Launcher](#sec-344) — the full launch flow, inputs/outputs, and the free `symbol` → launch → `launches` funnel.-- [x402 protocol](#sec-552) — the challenge/settle mechanics.-- [x402 buyer client](#sec-544) — how to pay these endpoints in code.-- [x402 revenue & receipts](#sec-548) — where settled payments are recorded and how to read endpoint revenue.+- [Pump Launcher](#sec-346) — the full launch flow, inputs/outputs, and the free `symbol` → launch → `launches` funnel.+- [x402 protocol](#sec-554) — the challenge/settle mechanics.+- [x402 buyer client](#sec-546) — how to pay these endpoints in code.+- [x402 revenue & receipts](#sec-550) — where settled payments are recorded and how to read endpoint revenue.- [Autonomous x402 loop](#sec-105) — the scheduled buyer that drives volume through these endpoints.-- [MCP tools](#sec-279) — the same capabilities exposed as paid MCP tools.+- [MCP tools](#sec-280) — the same capabilities exposed as paid MCP tools.----<a id="sec-548"></a>+<a id="sec-550"></a>> **Source:** `docs/x402-revenue.md` · [↑ table of contents](#table-of-contents)# x402 Revenue & Receipts-Every time someone pays one of three.ws's [paid endpoints](#sec-547), the+Every time someone pays one of three.ws's [paid endpoints](#sec-549), thesettlement is recorded. This page is the reference for **where that money isrecorded**, how to read endpoint revenue, and how the durable receipt is issued tothe buyer.@@ -126132,9 +126817,9 @@ tables. They never overlap, and mixing them up will double-count your numbers.| Direction | Meaning | Table | Surfaced by || -------------- | ------------------------------------------------------------------------ | ---------------------- | ------------------------------------------------ || **Revenue IN** | Money paid **to** our endpoints for using them | `x402_audit_log` | `/api/x402/analytics?report=revenue` (this page) |-| **Spend OUT** | Money an agent's wallet **paid out** (tips, trades, agent-to-agent x402) | `agent_custody_events` | The [Money Pulse](#sec-289) at `/api/pulse` |+| **Spend OUT** | Money an agent's wallet **paid out** (tips, trades, agent-to-agent x402) | `agent_custody_events` | The [Money Pulse](#sec-290) at `/api/pulse` |-The [Money Pulse](#sec-289) shows the agent economy — one agent paying+The [Money Pulse](#sec-290) shows the agent economy — one agent payinganother, tips, launches. **This page is the other side of the ledger:** theplatform's own endpoint revenue. A call to `/api/x402/token-intel` writes a**revenue** row in `x402_audit_log`; it is not an `agent_custody_events` spend and@@ -126299,7 +126984,7 @@ LIMIT 10;## The revenue report — `/api/x402/analytics`You don't have to query SQL. The `analytics` endpoint serves the same numbers,-pre-aggregated. It is itself a [paid endpoint](#sec-547) ($0.005 default).+pre-aggregated. It is itself a [paid endpoint](#sec-549) ($0.005 default).It is a `POST` endpoint: pass `report` and `period` in the JSON body:```bash@@ -126375,7 +127060,7 @@ CREATE TABLE x402_receipts (```A buyer reads **their own** receipts at-[`/api/x402/my-receipts`](#sec-547) — that endpoint is free but gated by+[`/api/x402/my-receipts`](#sec-549) — that endpoint is free but gated bya wallet signature (SIWX), so a buyer proves ownership of the `payer` addressrather than paying again.@@ -126584,15 +127269,15 @@ settled activity (include it), and label it as such.## Related-- [x402 paid endpoints](#sec-547) — the catalog of what charges and how much.-- [x402 protocol](#sec-552) — the challenge / verify / settle mechanics.-- [x402 buyer client](#sec-544) — how to settle a 402 challenge in code.+- [x402 paid endpoints](#sec-549) — the catalog of what charges and how much.+- [x402 protocol](#sec-554) — the challenge / verify / settle mechanics.+- [x402 buyer client](#sec-546) — how to settle a 402 challenge in code.- [Autonomous x402 loop](#sec-105) — the scheduled buyer that drives volume, including the Volume Bootstrap Loop and the reconciliation job.-- [Money feed](#sec-289) — the agent-spend side of the ledger (the Money Pulse), distinct from endpoint revenue.+- [Money feed](#sec-290) — the agent-spend side of the ledger (the Money Pulse), distinct from endpoint revenue.----<a id="sec-549"></a>+<a id="sec-551"></a>> **Source:** `docs/x402-ring-economy.md` · [↑ table of contents](#table-of-contents)@@ -127687,7 +128372,7 @@ activation runbook above is the fix.- [STRUCTURE.md](../STRUCTURE.md) — surface map- [/api/x402-revenue](../api/x402-revenue.js) — the **public** organic-revenuefeed (self-cycled ring volume is excluded from the "organic" framing here)-- [docs/x402-revenue.md](#sec-548) — revenue surface docs+- [docs/x402-revenue.md](#sec-550) — revenue surface docs- [api/_lib/x402/ring-allowlist.js](../api/_lib/x402/ring-allowlist.js) — thecontrolled-wallet set + spend invariants- [api/cron/x402-ring-leak-scan.js](../api/cron/x402-ring-leak-scan.js) — the@@ -127695,7 +128380,7 @@ activation runbook above is the fix.----<a id="sec-550"></a>+<a id="sec-552"></a>> **Source:** `docs/x402-solana-july-roundup-response.md` · [↑ table of contents](#table-of-contents)@@ -127713,7 +128398,7 @@ exact permalink from the account's profile before posting; quote-tweet directlyrather than typing a URL by hand.Two accounts, two jobs, same split used for the IBM Community campaign in-[event-x-posts.md](#sec-527): `@trythreews` posts the institutional version, `@nichxbt`+[event-x-posts.md](#sec-529): `@trythreews` posts the institutional version, `@nichxbt`posts the human one. Do not post both within a few minutes of each other.---@@ -127754,7 +128439,7 @@ the specific claim the roundup credited us for. Second choice: the AR drop-in on----<a id="sec-551"></a>+<a id="sec-553"></a>> **Source:** `docs/x402-studio.md` · [↑ table of contents](#table-of-contents)@@ -127764,11 +128449,11 @@ x402 Studio is the merchant console for running a paid x402 business on three.wsPage: [/x402/studio](https://three.ws/x402/studio)-APIs: `/api/x402-merchant` (settings), `/api/x402-skus` (products), `/api/sns` (name resolution), `/api/x402/pay-by-name` (USDC send). See [x402: paid agent skills](#sec-552) for the underlying payment protocol.+APIs: `/api/x402-merchant` (settings), `/api/x402-skus` (products), `/api/sns` (name resolution), `/api/x402/pay-by-name` (USDC send). See [x402: paid agent skills](#sec-554) for the underlying payment protocol.## Why it exists-x402 turns any HTTP endpoint into a paid one: the server answers `402 Payment Required` with a manifest, the caller pays in USDC, and the call retries and settles. That primitive is powerful but low-level. Studio is the console on top of it, the difference between "you can hand-write a 402 challenge" and "you can run a storefront." A merchant configures once and gets hosted checkout links, a shareable storefront, a copy-paste pay button, revenue stats, and payouts to a wallet they control, without writing payment code. It is the seller-facing companion to the [x402 buyer client](#sec-544) and the [paid endpoint catalog](#sec-547).+x402 turns any HTTP endpoint into a paid one: the server answers `402 Payment Required` with a manifest, the caller pays in USDC, and the call retries and settles. That primitive is powerful but low-level. Studio is the console on top of it, the difference between "you can hand-write a 402 challenge" and "you can run a storefront." A merchant configures once and gets hosted checkout links, a shareable storefront, a copy-paste pay button, revenue stats, and payouts to a wallet they control, without writing payment code. It is the seller-facing companion to the [x402 buyer client](#sec-546) and the [paid endpoint catalog](#sec-549).## How it works@@ -127854,16 +128539,16 @@ const { tx_base64, blockhash } = await res.json();## Related-- [x402: paid agent skills](#sec-552): the payment protocol Studio sits on top of-- [x402 revenue and receipts](#sec-548): where settled payments are recorded-- [x402 paid endpoints](#sec-547): the platform's own catalog of paid endpoints-- [x402 buyer client](#sec-544): the caller side of a 402 challenge-- [x402 developer tools](#sec-545) and [x402 distribution](#sec-546)+- [x402: paid agent skills](#sec-554): the payment protocol Studio sits on top of+- [x402 revenue and receipts](#sec-550): where settled payments are recorded+- [x402 paid endpoints](#sec-549): the platform's own catalog of paid endpoints+- [x402 buyer client](#sec-546): the caller side of a 402 challenge+- [x402 developer tools](#sec-547) and [x402 distribution](#sec-548)- Pages: [/x402/studio](https://three.ws/x402/studio) · [/x402](https://three.ws/x402)----<a id="sec-552"></a>+<a id="sec-554"></a>> **Source:** `docs/x402.md` · [↑ table of contents](#table-of-contents)@@ -127877,7 +128562,7 @@ of Pump.fun agent payments: callers pay an agent in any SPL token to invoke askill, and the agent verifies the on-chain payment before dispatching thecall. It is written for developers wiring paid skills (server side) or payingfor them (client side); the platform's own catalog of paid endpoints lives at-[x402 paid endpoints](#sec-547).+[x402 paid endpoints](#sec-549).**Live activity:** [x402scan dashboard](https://www.x402scan.com/server/17cbd874-52ac-4920-a020-b22ff2489a07)— browse paid calls, revenue, and per-skill pricing for this server.@@ -128033,20 +128718,20 @@ Each package has its own repository with a full README, API reference, and examp## Tutorials-- [Pay for an x402 service](#sec-463) — settle a paid request end to end with `@three-ws/x402-fetch`.-- [Build a paid x402 endpoint](#sec-462) — stand up a seller endpoint with `@three-ws/x402-server`.+- [Pay for an x402 service](#sec-466) — settle a paid request end to end with `@three-ws/x402-fetch`.+- [Build a paid x402 endpoint](#sec-465) — stand up a seller endpoint with `@three-ws/x402-server`.## Related-- [x402 paid endpoints](#sec-547) — the catalog of the platform's own paid endpoints.-- [x402 revenue & receipts](#sec-548) — where settled payments are recorded and how to read endpoint revenue.-- [x402 buyer client](#sec-544) — how to settle a 402 challenge in code.-- [x402 bazaar over MCP](#sec-280) — discover and pay endpoints through the MCP bazaar.+- [x402 paid endpoints](#sec-549) — the catalog of the platform's own paid endpoints.+- [x402 revenue & receipts](#sec-550) — where settled payments are recorded and how to read endpoint revenue.+- [x402 buyer client](#sec-546) — how to settle a 402 challenge in code.+- [x402 bazaar over MCP](#sec-281) — discover and pay endpoints through the MCP bazaar.- [Autonomous x402](#sec-105) — agents paying for services on their own.----<a id="sec-553"></a>+<a id="sec-555"></a>> **Source:** `docs/zauth/database.md` · [↑ table of contents](#table-of-contents)@@ -128192,7 +128877,7 @@ Use this endpoint to browse all known x402 endpoints before your agents commit t----<a id="sec-554"></a>+<a id="sec-556"></a>> **Source:** `docs/zauth/index.md` · [↑ table of contents](#table-of-contents)@@ -128212,11 +128897,11 @@ zauth is the security and trust layer that allows agents to act with confidence,## Products-### [VectorAI-powered vulnerability scanner. Automated recon, multi-category exploit testing, and detailed security reports for your web applications.Vector](#sec-557)### [RepoScanAI-powered code analysis for crypto communities. Scan GitHub repos for red flags, get trust scores, and compare code similarity across millions of repositories.RepoScan](#sec-556)### [DatabaseLive registry of x402 endpoints. AI agents continuously test and verify endpoints, tracking success rates, pricing, and response data.Database](#sec-553)### [Provider HubManage your x402 endpoints. Monitor health, track agent interactions, configure refunds, and verify your services through our SDK.Provider Hub](#sec-555)+### [VectorAI-powered vulnerability scanner. Automated recon, multi-category exploit testing, and detailed security reports for your web applications.Vector](#sec-559)### [RepoScanAI-powered code analysis for crypto communities. Scan GitHub repos for red flags, get trust scores, and compare code similarity across millions of repositories.RepoScan](#sec-558)### [DatabaseLive registry of x402 endpoints. AI agents continuously test and verify endpoints, tracking success rates, pricing, and response data.Database](#sec-555)### [Provider HubManage your x402 endpoints. Monitor health, track agent interactions, configure refunds, and verify your services through our SDK.Provider Hub](#sec-557)----<a id="sec-555"></a>+<a id="sec-557"></a>> **Source:** `docs/zauth/provider-hub.md` · [↑ table of contents](#table-of-contents)@@ -128318,7 +129003,7 @@ Supply your EVM or Solana private keys to enable automatic refunds when your end----<a id="sec-556"></a>+<a id="sec-558"></a>> **Source:** `docs/zauth/reposcan.md` · [↑ table of contents](#table-of-contents)@@ -128644,7 +129329,7 @@ TypeScript -@x402/fetch----<a id="sec-557"></a>+<a id="sec-559"></a>> **Source:** `docs/zauth/vector.md` · [↑ table of contents](#table-of-contents)diff --git a/public/changelog.json b/public/changelog.jsonindex 3ecb7df60..377c04b90 100644--- a/public/changelog.json+++ b/public/changelog.json@@ -1,5 +1,5 @@{- "generated_at": "2026-08-25T14:11:43.309Z",+ "generated_at": "2026-08-25T15:05:49.632Z","generated_by": "scripts/build-page-index.mjs from data/pages.json + data/changelog.json","site": {"name": "three.ws",@@ -16,6 +16,17 @@"launch"]},+ {+ "date": "2026-08-25",+ "type": "update",+ "title": "The first-contribution guide now hands you real open work, and the docs sidebar can find it",+ "summary": "The 15-minute contributor guide walked through adding MikuMikuDance rig support as its example, but that support had already shipped, so anyone following it literally would have re-done merged work and been told a bone was unmapped when it was not. It now shows the MMD change as the finished reference, exactly as it landed with its tests, and points you at two rig conventions that are genuinely still open, each with the bones that fail today. The community, triage, and first-contribution pages also appear in the docs sidebar under Guides instead of being reachable only from the README, and the triage page now explains every label the repo actually uses.",+ "link": "/docs/first-contribution",+ "tags": [+ "docs",+ "fix"+ ]+ },{"date": "2026-08-25","type": "update",diff --git a/public/changelog.xml b/public/changelog.xmlindex 7f16fd33e..766fee21a 100644--- a/public/changelog.xml+++ b/public/changelog.xml@@ -14,6 +14,14 @@<category>launch</category><description>The long-form case for $THREE: what three.ws is, every utility and sink the token has, how platform revenue routes into buybacks, where it trades and is verified, the ecosystem footprint, the roadmap, and every risk the platform documents about itself.</description></item>+ <item>+ <title>The first-contribution guide now hands you real open work, and the docs sidebar can find it</title>+ <link>https://three.ws/docs/first-contribution</link>+ <guid isPermaLink="false">2026-08-25:The first-contribution guide now hands you real open work, and the docs sidebar can find it</guid>+ <pubDate>Tue, 25 Aug 2026 12:00:00 GMT</pubDate>+ <category>docs</category>+ <description>The 15-minute contributor guide walked through adding MikuMikuDance rig support as its example, but that support had already shipped, so anyone following it literally would have re-done merged work and been told a bone was unmapped when it was not. It now shows the MMD change as the finished reference, exactly as it landed with its tests, and points you at two rig conventions that are genuinely still open, each with the bones that fail today. The community, triage, and first-contribution pages also appear in the docs sidebar under Guides instead of being reachable only from the README, and the triage page now explains every label the repo actually uses.</description>+ </item><item><title>The full $THREE thesis is now a single document</title><link>https://three.ws/three-token</link>diff --git a/public/features.json b/public/features.jsonindex 882373fca..e202ac1ca 100644--- a/public/features.json+++ b/public/features.json@@ -1,5 +1,5 @@{- "generated_at": "2026-08-25T14:11:43.301Z",+ "generated_at": "2026-08-25T15:05:49.624Z","generated_by": "scripts/build-page-index.mjs from data/pages.json","site": {"name": "three.ws",