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(launchpad): document the $THREE-quoted lane, swap-prep and the quote-token-program patch, and announce it in the changelog
ni3a888cf83443bc
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex 32ad249e8..447cccbec 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -6,6 +6,8 @@ Public history for [three.ws](https://three.ws), newest first. New pages come fr## 2026-09-20+- **$THREE Launchpad** (`/three-launchpad`): A bonding-curve launchpad priced in $THREE: every coin launched for a 3D agent is bought with $THREE, creators earn their fees in $THREE, and each graduation locks the $THREE it raised in a pool nobody can withdraw. Launch a coin or trade the live curves.+- **A launchpad where every coin is bought with $THREE**: The three.ws bonding-curve launchpad is now priced in $THREE instead of SOL. A coin launched there for a 3D agent can only be bought with $THREE, its creator earns half of every trading fee in $THREE, and when it graduates, the roughly 12.3 million $THREE it raised is locked in its pool permanently. The new launchpad page shows the live curves with buy and sell straight from your wallet. The curve has been verified against Solana mainnet and opens for launches as soon as its settings are published on-chain. (`/three-launchpad`) `[feature]`- **Agent reputation on Base and other EVM chains now shows real on-chain reviews**: Reputation panels, the passport widget and the trust scores behind agent-to-agent gating were asking the shared ERC-8004 reputation registry a question it does not answer, so agents with dozens of on-chain reviews showed none. They now read the registry the way it actually works: an agent with 41 reviews from 22 reviewers on Base shows 4.1 out of 5 and its recent reviews, and the panel loads in a few seconds on free public RPCs. Staked vouches are only offered on chains whose registry supports them. `[fix, improvement]`- **Paid $THREE purchases say what is wrong instead of failing silently**: Every $THREE-priced purchase is sealed into one signed quote before you pay. If the platform side of that rail is not fully configured, the quote now comes back with a clear, retryable message and a named reason rather than an opaque internal error, and the platform status page reports the condition itself. Nobody has to be mid-checkout for the problem to be visible. (`/status`) `[fix, infra]`- **The @trythreews account now posts three times a day, every day**: The reviewed content queue that runs the @trythreews account moved to three posts a day, eight hours apart, on every day of the week including weekends. It used to hold its flagship slot for weekdays and pack all three posts into an eight-hour afternoon window, which meant a weekend could only ever carry two. Three posts went out under the new cadence today: the $THREE token MCP server, Forge Max, and the free object library. The Forge Max post also gained a check that proves the high-quality tier is a real, gated lane before it can be published, rather than only proving its page loads. (`/changelog`) `[improvement]`diff --git a/STRUCTURE.md b/STRUCTURE.mdindex c4fc9e667..95c34cc23 100644--- a/STRUCTURE.md+++ b/STRUCTURE.md@@ -266,6 +266,7 @@ bottom.| Market detail pages (exchange, category) + DeFi yields | [pages/exchange.html](pages/exchange.html) + [src/exchange-page.js](src/exchange-page.js) `→ /exchange/:id` over [api/coin/exchange.js](api/coin/exchange.js), [pages/category.html](pages/category.html) + [src/category-page.js](src/category-page.js) `→ /category/:id` over [api/coin/category.js](api/coin/category.js) + [api/coin/markets.js](api/coin/markets.js) (`?category=`), [pages/yields.html](pages/yields.html) + [src/yields.js](src/yields.js) `→ /yields` over [api/defi/yields.js](api/defi/yields.js) | In-repo | Rich detail pages that turn list rows into full profiles. Exchange: trust badge, normalized-volume stat, BTC-volume history chart, and a per-pair markets table (spot + derivatives fallback), reached from `/exchanges` and the new Derivatives Exchanges table. Category: rank, sector stats, the full sortable coins table for that sector, and related categories, reached from `/categories`. Yields: an explorer over ~15k live DeFiLlama pools with chain/project/stablecoin/min-TVL filters, APY/TVL sort, URL-synced state, and a per-pool APY+TVL history chart on row expand. Docs: [docs/coin-pages.md](docs/coin-pages.md) || Crypto news + archive + markets hub | [pages/markets.html](pages/markets.html) + [src/markets-page.js](src/markets-page.js) `→ /markets`, [pages/markets-news.html](pages/markets-news.html) + [src/markets-news.js](src/markets-news.js) `→ /markets/news`, [pages/news-article.html](pages/news-article.html) + [src/news-article.js](src/news-article.js) `→ /markets/news/article`, [pages/news-archive.html](pages/news-archive.html) + [src/news-archive.js](src/news-archive.js) `→ /markets/archive`, [pages/news-digest.html](pages/news-digest.html) + [src/news-digest.js](src/news-digest.js) `→ /markets/digest`; backend [api/news/](api/news) (feed, article, knowledge, archive, digest, rss, image) over [api/_lib/article-extract.js](api/_lib/article-extract.js) (page→reader→feed→preview ladder) and [api/_lib/news-rights.js](api/_lib/news-rights.js) (publisher rights layer, enforced at every read path), [api/_lib/news-coins.js](api/_lib/news-coins.js) (ticker→live market snapshot), [api/_lib/news-knowledge-store.js](api/_lib/news-knowledge-store.js) (durable `news_knowledge` corpus) + hourly archiver [api/cron/news-archive-append.js](api/cron/news-archive-append.js) over [api/_lib/news.js](api/_lib/news.js) + [api/_lib/news-sources.js](api/_lib/news-sources.js), corpus on `gs://three-ws-news-archive`, purge tooling [scripts/news-takedown-purge.mjs](scripts/news-takedown-purge.mjs) | In-repo | The Markets news wing + front door: /markets/news is “Your briefing”: live news aggregated natively from 197 publisher feeds (Featured/Trending/Saved tabs, breaking ticker, AI briefing card, top-stories hero + rail, search, sentiment, ticker chips, og:image preview resolution for imageless feeds), a rich article reader that shows a bounded lead excerpt plus our own summary/key points/entities/market context and sends the reader to the publisher for the rest (the excerpt cap and any rightsholder takedowns are enforced server-side across the reader, RSS mirror, archive search, and agent knowledge corpus, never just hidden client-side), and renders **live coin cards** (price/24h/7d/sparkline→/coin/:id) for detected tickers, and related coverage. Every read story is recorded to a durable **news knowledge base** (`GET /api/news/knowledge`) that grounds the 3D agents, itself subject to the same excerpt limit. Plus the largest open crypto-news archive (662,047 enriched articles, Sept 2017 → today, EN+中文, GCS-hosted) and the /markets hub aggregating global stats, the top-100 table, breaking news, and every market surface as a hero card. Docs: [docs/coin-pages.md](docs/coin-pages.md), [docs/api-reference.md](docs/api-reference.md), [docs/news-rights.md](docs/news-rights.md) (publisher takedown path) || Robinhood Chain markets + buy flow | Hub + detail pages [pages/markets-robinhood.html](pages/markets-robinhood.html) + [src/markets-robinhood.js](src/markets-robinhood.js) `→ /markets/robinhood`, [pages/robinhood-stock.html](pages/robinhood-stock.html) + [src/robinhood-stock.js](src/robinhood-stock.js) `→ /markets/robinhood/stock/:symbol`, [pages/robinhood-coin.html](pages/robinhood-coin.html) + [src/robinhood-coin.js](src/robinhood-coin.js) `→ /markets/robinhood/coin/:address`, buy flow [src/robinhood-purchase.js](src/robinhood-purchase.js), wallet desk [pages/hood-desk.html](pages/hood-desk.html) + [src/hood-desk.js](src/hood-desk.js) + [src/hood-desk.css](src/hood-desk.css) `→ /markets/robinhood/desk`; backend [api/_lib/robinhood.js](api/_lib/robinhood.js) + `api/v1/robinhood/{chain,stocks,stocks-detail,coins,coins-detail,launches,desk,wallet}.js` (free, the last two composed for the desk over [api/_lib/robinhood-desk.js](api/_lib/robinhood-desk.js)) + [api/x402/robinhood-portfolio.js](api/x402/robinhood-portfolio.js) (x402 paid) | In-repo | The 24/7 tokenized-equity board for Robinhood Chain (4663): live Chainlink NAV vs. Uniswap DEX premium for every Stock Token (one multicall, never 95 RPC calls), a memecoin screener across NOXA/The Odyssey launchpads (CoinGecko categories + on-chain launch logs via Blockscout), and chain TVL/gas/block stats. Detail pages add NAV history, holders, transfers, and contract links. Coin pages carry a real buy panel: injected-wallet connect, chain-switch to 4663, live Uniswap v3 `QuoterV2` quote + `SwapRouter02` swap with slippage, LI.FI bridge deep-link; Stock Tokens are display-only (tokenized securities, not offered to US persons) with an eligibility-gated outbound DEX link instead. Paid `portfolio` endpoint returns ERC-8056 `uiMultiplier`-correct holdings. The Hood Desk (`/markets/robinhood/desk`) is the wallet-first view of the same chain: paste or connect any address and it loads that wallet's book (native + priced ERC-20 positions), its native balance curve rebuilt from Blockscout's daily and per-transaction feeds (the public RPC is not an archive node), an activity tape that folds token transfers onto the transaction that emitted them, the NAV premium ridge layered by liquidity floor, counterparty flow, and memecoin movers. Read-only and signature-free; the trade ticket reuses the coin pages' swap panel and the Stock Token eligibility gate. Tests: [tests/robinhood-desk.test.js](tests/robinhood-desk.test.js) (the derivations) and [tests/e2e/hood-desk.spec.js](tests/e2e/hood-desk.spec.js) (the panels, the empty states, the ladder collapse and the trade ticket). Docs: [docs/robinhood-chain-markets.md](docs/robinhood-chain-markets.md) |+| $THREE launchpad (native bonding curve) | Page [pages/three-launchpad.html](pages/three-launchpad.html) + [src/three-launchpad/](src/three-launchpad) `→ /three-launchpad`; backend [api/_lib/native-launch/](api/_lib/native-launch) + [api/native-launch/[action].js](api/native-launch/%5Baction%5D.js); lane toggle in [public/studio/launch-panel.js](public/studio/launch-panel.js); config + devnet scripts `scripts/native-launchpad-*.mjs` | In-repo · code-complete, mainnet config creation owner-gated (about 0.006 SOL) | Solana. Every coin launched on the lane is quoted in $THREE on Meteora's Dynamic Bonding Curve: buys are made with $THREE, creators earn 50% of the 1% fee in $THREE, and graduation (60M $THREE market cap, about 12.3M $THREE raised) locks 100% of LP in a DAMM v2 pool against $THREE. Public buy and sell via `swap-prep`, no session needed. Verified by a keyless mainnet simulation that creates the config and a $THREE-quoted pool against the live program. Docs: [docs/native-launchpad.md](docs/native-launchpad.md) || Uniswap v4 hooks (EVM) | [contracts/v4-hooks/](contracts/v4-hooks): `SkinHook` + `SkinToken` (wearable 3D items as coins), `AgentTierHook` (ERC-8004 reputation fee tiers), CREATE2 address mining and deploy scripts; hook census [scripts/uniswap-v4-hook-census.mjs](scripts/uniswap-v4-hook-census.mjs) | In-repo · contracts code-complete and tested against real v4-core and a live Base fork, not deployed (owner-gated) | Additional EVM surface, Solana stays the home chain. `SkinHook`: every wearable is a fixed-supply ERC-20 with its own ETH pool; equipping locks one whole token in the hook so each wearer shrinks the float, a 2% ETH-side fee is split creator / referrer (named in `hookData`, the embed that sold it) / treasury as ERC-6909 claims, and the whole supply is seeded as one permanent single-sided position. `AgentTierHook`: dynamic LP fee by ERC-8004 standing, read from the canonical registries with a pool-configured reviewer set, cached by a permissionless `refreshTier`, every registry failure resolving to the base fee. v4-core vendored at v4.0.0 under `contracts/v4-hooks/lib`. Docs: [contracts/v4-hooks/README.md](contracts/v4-hooks/README.md), [docs/uniswap-v4-hooks.md](docs/uniswap-v4-hooks.md) || Robinhood Portfolios (generated index portfolios) | Generator [pages/hood-portfolios.html](pages/hood-portfolios.html) + [src/hood-portfolios.js](src/hood-portfolios.js) + [src/hood-portfolios.css](src/hood-portfolios.css) `→ /markets/robinhood/portfolios`, universe board [pages/hood-portfolios-universe.html](pages/hood-portfolios-universe.html) + [src/hood-portfolios-universe.js](src/hood-portfolios-universe.js) `→ /markets/robinhood/portfolios/universe`; backend [api/_lib/hood-portfolios.js](api/_lib/hood-portfolios.js) + `api/v1/hood-portfolios/{universe,generate,health}.js` (free, keyless); universe snapshot [data/hood-portfolios-universe.json](data/hood-portfolios-universe.json) built by [scripts/build-hood-portfolios-universe.mjs](scripts/build-hood-portfolios-universe.mjs) (`npm run hood:universe`); contracts [contracts/hood-portfolios/](contracts/hood-portfolios) | In-repo · contracts code-complete and fork-proven against live chain 4663, mainnet deploy owner-gated | Describe a portfolio in a sentence and get a real basket of Robinhood Chain assets. The screen ranks the whole holdable universe (727 assets: 167 tokenized equities, majors, and the chain-native long tail) through the platform free-first LLM chain, and every token it returns is validated back against that universe before it is shown. The result is committed as an immutable content-addressed manifest (`PortfolioRegistry`), held in kind by an ERC-20 share vault (`Portfolio`) whose backing is derived from balances rather than tracked, and rebalanced to published targets by a descending-price auction any address can fill: there is no function that lets a manager trade the fund. Needs no price oracle on any code path, which is what makes it work on a chain where only 34 of 95 registry equities have a Chainlink feed. Halt-aware: a paused tokenized equity stops issuance, redemption and rebalancing, and the UI says so. Ticker impersonation is resolved by contract address at build time (12 contracts on this chain call themselves USDG), so an impostor can never be selected. Backtests run the basket twice, on its schedule and never rebalanced, and report the difference: history comes from Chainlink round data (chunked into multicalls of 40, because this RPC silently drops calls out of a larger one) and a daily snapshot whose coverage compounds, with uncovered legs named rather than dropped. A generated portfolio shares as a deflate-compressed manifest in the URL, its hash re-derived server-side rather than trusted from the link. 38 offline contract tests incl. fuzz + 4 stateful invariants, 5 against a fork of live chain 4663, and 56 vitest across the screen, backtest engine, history reduction and SDK. Docs: [docs/robinhood-portfolios.md](docs/robinhood-portfolios.md), [contracts/hood-portfolios/README.md](contracts/hood-portfolios/README.md) || Premium Data API pass | [api/premium/](api/premium) + [api/_lib/premium.js](api/_lib/premium.js), dashboards [src/dashboard-next/pages/data-api.js](src/dashboard-next/pages/data-api.js) `→ /dashboard/data-api` + [src/dashboard-next/pages/billing.js](src/dashboard-next/pages/billing.js) `→ /dashboard/billing` | In-repo | Monthly pass in three tiers (Developer $19.99, Pro $99, Enterprise $499 per 30d, tiered rate limits) paid on Solana in $THREE (20% off), SOL, or USDC — replaces per-call x402 on the news archive with an `x402_live_` API key (existing access-control lane) + SIWX browser grants. Quote→sign→verify flow with on-chain balance-delta verification; tables `premium_passes`/`premium_quotes`. Docs: [docs/premium.md](docs/premium.md) |diff --git a/data/changelog.json b/data/changelog.jsonindex 1f7604924..286ef6381 100644--- a/data/changelog.json+++ b/data/changelog.json@@ -1,6 +1,15 @@{"$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-09-20",+ "title": "A launchpad where every coin is bought with $THREE",+ "summary": "The three.ws bonding-curve launchpad is now priced in $THREE instead of SOL. A coin launched there for a 3D agent can only be bought with $THREE, its creator earns half of every trading fee in $THREE, and when it graduates, the roughly 12.3 million $THREE it raised is locked in its pool permanently. The new launchpad page shows the live curves with buy and sell straight from your wallet. The curve has been verified against Solana mainnet and opens for launches as soon as its settings are published on-chain.",+ "tags": [+ "feature"+ ],+ "link": "/three-launchpad"+ },{"date": "2026-09-20","title": "Two Uniswap v4 hooks: wearable 3D items as coins, and fees that reward agent reputation",diff --git a/docs/native-launchpad.md b/docs/native-launchpad.mdindex 2ffc3346c..1a6b6701d 100644--- a/docs/native-launchpad.md+++ b/docs/native-launchpad.md@@ -1,8 +1,8 @@-# The three.ws launchpad: our own bonding curve+# The three.ws launchpad: a bonding curve priced in $THREEthree.ws has always been able to launch a coin for an agent. Until now, every one of those launches went out on pump.fun: their program, their curve, their fee schedule. That lane still exists and still matters, because that is where the buyers are.-This document covers the second lane: **the native launchpad**, a coin launch that runs on a bonding curve three.ws configures and owns. Same launch button, same 3D agent identity attached to the coin, different economics underneath.+This document covers the second lane: **the native launchpad**, a coin launch that runs on a bonding curve three.ws configures and owns, and that is **quoted in $THREE**. Same launch button, same 3D agent identity attached to the coin, different economics underneath. The public page is [three.ws/three-launchpad](https://three.ws/three-launchpad).Related surfaces: [the pump.fun lane](./api-reference.md) (`/api/pump/*`), [agent wallets](./agent-wallets.md) (custody), and [the launch page](https://three.ws/launch).@@ -14,6 +14,18 @@ A launchpad's revenue is a share of trading fees. On the pump.fun lane, three.wsThe tradeoff is honest and worth stating plainly: pump.fun brings order flow that a new curve does not have. Trading terminals and aggregators index pump.fun natively. So the two lanes are not a migration, they are a choice the launcher makes per coin: **reach, or economics.**+## Why the curve is priced in $THREE++A SOL-quoted curve makes three.ws one more launchpad. A $THREE-quoted curve makes every coin launched here part of $THREE's own economy:++- **Buying any coin is buying $THREE first.** The curve accepts nothing else, so every new buyer of every coin on the lane is a $THREE buyer.+- **Creators are paid in $THREE.** Half of every trade's fee goes to the agent's creator, in $THREE, for as long as the coin trades. Launching here makes you a $THREE holder with a reason to stay one.+- **Graduation locks $THREE away.** A coin that fills its curve moves to a Meteora pool against $THREE with all of its liquidity permanently locked: about 12.3M $THREE per graduated coin, roughly 1.2% of $THREE's supply, out of circulation for good.++SOL-quoted launches are what the pump.fun lane is for. This lane exists to put $THREE in the middle.++$THREE is a Token-2022 mint carrying only the metadata-pointer and token-metadata extensions, with no mint or freeze authority, and the DBC program accepts it as a quote mint. That is verified, not assumed: `node scripts/native-launchpad-create-config.mjs --simulate` creates the config and a $THREE-quoted pool against the live mainnet program in simulation, with no key and no spend.+## What the native lane does not doBuilding our own bonding-curve program from scratch would mean writing, auditing, and maintaining custody-grade Solana code, and then bootstrapping liquidity for graduated coins with no venue to graduate into. We did not do that.@@ -28,15 +40,15 @@ All of it lives in one file, [`api/_lib/native-launch/config.js`](../api/_lib/na| Property | Value ||---|---|-| Quote asset | SOL |+| Quote asset | $THREE (`FeMbDoX7R1Psc4GEcvJdsbNbZA3bfztcyDCatJVJpump`) || Supply | 1,000,000,000 (6 decimals) || Metadata authority | Immutable at launch |-| Starting market cap | ~28 SOL |-| Graduation market cap | ~410 SOL (≈85 SOL raised on the curve) |-| Trading fee | 1%, taken in SOL, plus a volatility-scaled dynamic fee during spikes |+| Starting market cap | 4,000,000 $THREE |+| Graduation market cap | 60,000,000 $THREE (about 12.3M $THREE raised on the curve) |+| Trading fee | 1%, taken in $THREE, plus a volatility-scaled dynamic fee during spikes || Trading fee split | 50% coin creator / 50% three.ws |-| Migration fee | 1% of the raised SOL, split 50/50 |-| Graduates into | A Meteora DAMM v2 pool |+| Migration fee | 1% of the raised $THREE, split 50/50 |+| Graduates into | A Meteora DAMM v2 pool against $THREE || LP at graduation | 100% permanently locked (50% creator / 50% platform) |Two of these deserve emphasis:@@ -45,7 +57,11 @@ Two of these deserve emphasis:**All liquidity is permanently locked at graduation.** Neither the creator nor the platform can withdraw the pool. A graduated native coin cannot be rugged by liquidity removal, and both sides keep earning LP fees on it for as long as it trades.-The graduation target deliberately mirrors the shape traders already recognise from pump.fun (~85 SOL raised), so the lane feels familiar rather than novel where novelty would only add friction.+The curve deliberately mirrors the shape traders already recognise from pump.fun (28 to 410 SOL of market cap, about 85 SOL raised), converted to $THREE at the price on 2026-09-20. The thresholds are fixed in the on-chain config. If $THREE's price moves far enough that they no longer fit, the fix is a new config and a re-pinned env key; coins already launched keep the curve they launched on.++### The quote-token-program patch++The DBC program takes the quote mint's token program as an ordinary account, so a Token-2022 quote is supported on-chain. SDK 1.5.x nevertheless hardcodes the legacy SPL Token program into `token_quote_program` when it builds a pool-initialize instruction, and with a Token-2022 quote the instruction fails with `IncorrectProgramId` as soon as the program creates the quote vault. `withQuoteTokenProgram` in [`dbc.js`](../api/_lib/native-launch/dbc.js) rewrites that one account, located by its position in the program's own IDL. Swaps are unaffected: the SDK reads the token program from the config for those. Remove the patch when the SDK is fixed upstream.### Why `leftover: 1`@@ -74,12 +90,12 @@ Requires a session and a Solana wallet linked to that account."name": "Native Coin","symbol": "NTV","uri": "https://three.ws/metadata.json",- "sol_buy_in": 0.05,+ "three_buy_in": 50000,"network": "mainnet"}```-`agent_id` may be sent instead of `avatar_id`. `sol_buy_in` is an optional first buy bundled into the same transaction. `mint_address` may carry a client-ground vanity mint; omit it and the server grinds one.+`agent_id` may be sent instead of `avatar_id`. `three_buy_in` is an optional first buy, in $THREE, bundled into the same transaction. The signing wallet must hold it. `mint_address` may carry a client-ground vanity mint; omit it and the server grinds one.Returns `201` with the unsigned transaction and the deterministic pool address:@@ -121,10 +137,20 @@ The second guard is the important one: without it, a confirmed memo or transferAll public, no auth:- `GET /api/native-launch/config[?network=]` — the lane's live economics and whether it is deployed. This is what the launch UI renders, so the fee story on the page always comes from the same source as the on-chain config.-- `GET /api/native-launch/pool?mint=…[&network=]` — pool address, curve progress (0..1), SOL raised, graduation threshold, migration status.-- `GET /api/native-launch/quote?mint=…&sol_in=…[&network=]` — a live buy quote off the curve: tokens out, minimum out, and the fee breakdown.+- `GET /api/native-launch/pool?mint=…[&network=]`: pool address, curve progress (0..1), `quote_reserve_three` ($THREE held in the curve), `migration_quote_threshold_three`, migration status.+- `GET /api/native-launch/quote?mint=…&three_in=…[&network=]`: a live buy quote off the curve: tokens out, minimum out, and the fee breakdown in $THREE. Pass `tokens_in=…` instead for a sell quote (`three_out`, `min_three_out`).- `GET /api/native-launch/launches[?network=&agent_id=&limit=&offset=]`: the native launch directory, each row carrying its agent and avatar thumbnail. `agent_id` must be a uuid: anything else answers `400 validation_error` instead of reaching the database. `limit` is clamped to 1..100 (default 24), `offset` to a non-negative integer.+### `POST /api/native-launch/swap-prep`++Public, no session: trading a curve needs only the trader's signature.++```json+{ "mint": "3ws…", "wallet_address": "<trader>", "side": "buy", "amount": 50000, "slippage_bps": 100, "network": "mainnet" }+```++A `buy` spends `amount` $THREE; a `sell` spends `amount` of the coin's tokens. The quote is taken in the same call, so the slippage floor inside the transaction is the one returned as `min_out`. Returns `tx_base64` (an unsigned v0 transaction for the trader's wallet), `expected_out`, `min_out`, and the pool address.+---## Deploying the lane on a network@@ -132,19 +158,24 @@ All public, no auth:The partner config is created once per network and then pinned in the environment. Until it is pinned, the lane reports itself unavailable, the launch UI hides the lane toggle entirely, and every launch stays on pump.fun. There is no half-configured state.```bash-# devnet (the partner wallet needs ~0.05 SOL for rent + fees)-node scripts/native-launchpad-create-config.mjs --network devnet --airdrop+# mainnet dry run: no key, no spend. Creates the config and a $THREE-quoted pool in simulation.+node scripts/native-launchpad-create-config.mjs --simulate++# devnet: $THREE exists on mainnet only, so this first mints a Token-2022 stand-in+# shaped like it, then creates the config against that+node scripts/native-launchpad-create-config.mjs --network devnet --create-quote-mint --airdrop-# mainnet+# mainnet: spends about 0.006 SOL of rent from the partner wallet. Owner-approved only.node scripts/native-launchpad-create-config.mjs --network mainnet```-The script prints the config pubkey. Pin it:+The script prints the config pubkey (and on devnet the stand-in quote mint). Pin them:| Variable | Meaning ||---|---|| `NATIVE_LAUNCH_CONFIG_KEY` | Mainnet partner config pubkey || `NATIVE_LAUNCH_CONFIG_KEY_DEVNET` | Devnet partner config pubkey |+| `NATIVE_LAUNCH_QUOTE_MINT_DEVNET` | Devnet stand-in for $THREE, the mint the devnet config is quoted in || `NATIVE_LAUNCH_FEE_WALLET` | Platform fee claimer + leftover receiver (defaults to the treasury wallet) || `NATIVE_LAUNCH_PARTNER_SECRET_BASE58` | Signer that creates the config (falls back to the treasury secret) |@@ -152,13 +183,13 @@ On production these live on the Cloud Run service, not in a file.### Verifying a deployment end to end-`scripts/native-launchpad-e2e-devnet.mjs` drives the real modules the API uses: it builds a create-pool transaction, signs and lands it on devnet, reads the pool back, quotes a buy, executes that buy, and asserts the curve moved.+`scripts/native-launchpad-e2e-devnet.mjs` drives the real modules the API uses: it builds a create-pool transaction with a first buy in the stand-in $THREE, signs and lands it on devnet, reads the pool back, then builds, signs and lands a buy and a sell through `buildSwapTx`, asserting after each that the curve and its $THREE reserve moved the right way.```bashnode scripts/native-launchpad-e2e-devnet.mjs```-The devnet run that shipped this feature created config `FK3HQrWG5y6rh3SC8ew5WVUfo31bfmkm2Z1nwuZaKcam`, launched a pool, and confirmed the fee math on-chain: a 0.5 SOL buy moved the pool's reserve by exactly 0.49499951 SOL, i.e. precisely the 1% fee.+The SOL-quoted v1 of this lane was proven end to end on devnet (config `FK3HQrWG5y6rh3SC8ew5WVUfo31bfmkm2Z1nwuZaKcam`). The $THREE-quoted v2 has been proven against **mainnet in simulation** (config plus pool creation succeed against the live program with the real $THREE mint). Its devnet run was not possible on the day it shipped because the devnet faucet was dry, so the buy and sell transactions have not yet landed on any chain. Run the devnet script before opening the lane on mainnet.---@@ -167,7 +198,8 @@ The devnet run that shipped this feature created config `FK3HQrWG5y6rh3SC8ew5WVU| Piece | Path ||---|---|| Curve economics (single source of truth) | [`api/_lib/native-launch/config.js`](../api/_lib/native-launch/config.js) |-| DBC wrapper (build tx, read pool, quote) | [`api/_lib/native-launch/dbc.js`](../api/_lib/native-launch/dbc.js) |+| DBC wrapper (build launch and swap txs, read pool, quote) | [`api/_lib/native-launch/dbc.js`](../api/_lib/native-launch/dbc.js) |+| Public page (lane facts, coin directory, buy and sell, launch) | [`pages/three-launchpad.html`](../pages/three-launchpad.html) + [`src/three-launchpad/`](../src/three-launchpad) `→ /three-launchpad` || HTTP dispatcher | [`api/native-launch/[action].js`](../api/native-launch/%5Baction%5D.js) || Launch table | `native_launches` (migration `20260726100000_native_launchpad.sql`) || Launch UI (lane toggle) | [`public/studio/launch-panel.js`](../public/studio/launch-panel.js) |@@ -185,4 +217,6 @@ Stated plainly, because a half-built feature that claims to be finished is worse- **No custodial launch path.** The pump.fun lane can launch from an agent's own server-signed wallet; the native lane is always signed by the launcher's connected wallet. The lane toggle switches the signer back to the connected wallet automatically rather than offering an option that would fail.- **No coin-detail page yet.** `/launches/<mint>` reads price history, trades, safety, and smart-money data from pump-specific endpoints, so it cannot render a native coin. The launch success screen links to Solscan and the agent page instead of a link that would 404.-- **No coin variants.** Mayhem, USDC pairing, buyback binding, and delegated reward splits are pump.fun program features. The native lane is SOL-quoted and variant-free, so that picker is withheld on this lane rather than shown with dead options.+- **No coin variants.** Mayhem, USDC pairing, buyback binding, and delegated reward splits are pump.fun program features. The native lane is $THREE-quoted and variant-free, so that picker is withheld on this lane rather than shown with dead options.+- **No one-click buy from SOL.** A buyer who holds only SOL swaps to $THREE first (the page links to [/three-token](https://three.ws/three-token)). Bundling a Jupiter SOL to $THREE swap in front of the curve buy is the obvious next step.+- **Thin $THREE liquidity cuts both ways.** A graduation needs about 12.3M $THREE bought through the curve. That is the point, and it also means early curves fill slowly until $THREE's own liquidity deepens.diff --git a/public/changelog-recent.json b/public/changelog-recent.jsonindex 67230fdc4..4108e8415 100644--- a/public/changelog-recent.json+++ b/public/changelog-recent.json@@ -1,14 +1,34 @@{- "generated_at": "2026-09-20T04:32:12.785Z",+ "generated_at": "2026-09-20T04:55:28.651Z","generated_by": "scripts/build-page-index.mjs from data/pages.json + data/changelog.json","site": {"name": "three.ws","url": "https://three.ws"},- "total": 3715,+ "total": 3717,"complete": false,"full_feed": "/changelog.json","entries": [+ {+ "date": "2026-09-20",+ "type": "launch",+ "title": "$THREE Launchpad",+ "summary": "A bonding-curve launchpad priced in $THREE: every coin launched for a 3D agent is bought with $THREE, creators earn their fees in $THREE, and each graduation locks the $THREE it raised in a pool nobody can withdraw. Launch a coin or trade the live curves.",+ "link": "/three-launchpad",+ "tags": [+ "launch"+ ]+ },+ {+ "date": "2026-09-20",+ "type": "update",+ "title": "A launchpad where every coin is bought with $THREE",+ "summary": "The three.ws bonding-curve launchpad is now priced in $THREE instead of SOL. A coin launched there for a 3D agent can only be bought with $THREE, its creator earns half of every trading fee in $THREE, and when it graduates, the roughly 12.3 million $THREE it raised is locked in its pool permanently. The new launchpad page shows the live curves with buy and sell straight from your wallet. The curve has been verified against Solana mainnet and opens for launches as soon as its settings are published on-chain.",+ "link": "/three-launchpad",+ "tags": [+ "feature"+ ]+ },{"date": "2026-09-20","type": "update",@@ -1597,28 +1617,6 @@"improvement","infra"]- },- {- "date": "2026-09-08",- "type": "update",- "title": "Avatars of people now come off the stronger lane, and stop standing on a slab of their own backdrop",- "summary": "Two things were quietly holding avatars back. The first: our own docs said that asking for a 3D person always ran on the strongest engine we host, the one that is best at faces and bodies. The code was still sending those requests to the faster, weaker engine, so every avatar came back off the wrong lane. Side by side on the same six descriptions, the weaker lane returned smeared, faceless figures with mitten hands and once no figure at all, while the stronger one returned people you can recognise. Avatars now go where the docs always said they did. The second: when you describe a person in words, we paint a reference picture first and sculpt the model from it. That picture has a plain background, and we had assumed plain was harmless. It is not. The sculptor was treating the backdrop as part of the scene and building it in, so four of six test figures came out standing on a full-size slab of their own background and two were swallowed by it entirely. Written descriptions now get the same background cutout that uploaded photos already got.",- "link": null,- "tags": [- "improvement",- "fix"- ]- },- {- "date": "2026-09-08",- "type": "update",- "title": "Buttons that looked dead now respond, and the whole site paints from one palette",- "summary": "A consistency pass across the platform. Fifty controls set the clickable cursor but had no hover styling at all, so the pointer changed shape and the button did not, which made working controls read as broken; the marketplace, Widget Studio, the brain workspace, the pump dashboard, agent detail and the on-chain deploy panel now all answer under the pointer, on the same timing. The retry buttons on an agent page were the worst case, because they only appear after something already failed. Separately, 73 colours were still typed in by hand across 24 stylesheets instead of coming from the shared palette, which is why a handful of panels stayed dark when you switched to the light theme and why some captions drifted a shade off everywhere else; they now all read from one source. Eight standalone pages that had quietly grown their own private palette (the demos, Widget Studio, the dashboard sub-pages, the print insert, agent detail) were folded back onto the shared one, so they also pick up the site-wide keyboard focus ring and the reduced-motion setting for the first time. Two new checks keep both from creeping back.",- "link": "/marketplace",- "tags": [- "improvement",- "fix"- ]}]}diff --git a/public/changelog.json b/public/changelog.jsonindex c69c79a28..cd3b4a1d4 100644--- a/public/changelog.json+++ b/public/changelog.json@@ -1,11 +1,31 @@{- "generated_at": "2026-09-20T04:32:12.761Z",+ "generated_at": "2026-09-20T04:55:28.627Z","generated_by": "scripts/build-page-index.mjs from data/pages.json + data/changelog.json","site": {"name": "three.ws","url": "https://three.ws"},"entries": [+ {+ "date": "2026-09-20",+ "type": "launch",+ "title": "$THREE Launchpad",+ "summary": "A bonding-curve launchpad priced in $THREE: every coin launched for a 3D agent is bought with $THREE, creators earn their fees in $THREE, and each graduation locks the $THREE it raised in a pool nobody can withdraw. Launch a coin or trade the live curves.",+ "link": "/three-launchpad",+ "tags": [+ "launch"+ ]+ },+ {+ "date": "2026-09-20",+ "type": "update",+ "title": "A launchpad where every coin is bought with $THREE",+ "summary": "The three.ws bonding-curve launchpad is now priced in $THREE instead of SOL. A coin launched there for a 3D agent can only be bought with $THREE, its creator earns half of every trading fee in $THREE, and when it graduates, the roughly 12.3 million $THREE it raised is locked in its pool permanently. The new launchpad page shows the live curves with buy and sell straight from your wallet. The curve has been verified against Solana mainnet and opens for launches as soon as its settings are published on-chain.",+ "link": "/three-launchpad",+ "tags": [+ "feature"+ ]+ },{"date": "2026-09-20","type": "update",diff --git a/public/changelog.xml b/public/changelog.xmlindex 514debe6d..16f447cfb 100644--- a/public/changelog.xml+++ b/public/changelog.xml@@ -6,6 +6,22 @@<atom:link href="https://three.ws/changelog.xml" rel="self" type="application/rss+xml"/><description>What's new on three.ws: features, improvements, and releases, newest first.</description><language>en</language>+ <item>+ <title>$THREE Launchpad</title>+ <link>https://three.ws/three-launchpad</link>+ <guid isPermaLink="false">2026-09-20:$THREE Launchpad</guid>+ <pubDate>Sun, 20 Sep 2026 12:00:00 GMT</pubDate>+ <category>launch</category>+ <description>A bonding-curve launchpad priced in $THREE: every coin launched for a 3D agent is bought with $THREE, creators earn their fees in $THREE, and each graduation locks the $THREE it raised in a pool nobody can withdraw. Launch a coin or trade the live curves.</description>+ </item>+ <item>+ <title>A launchpad where every coin is bought with $THREE</title>+ <link>https://three.ws/three-launchpad</link>+ <guid isPermaLink="false">2026-09-20:A launchpad where every coin is bought with $THREE</guid>+ <pubDate>Sun, 20 Sep 2026 12:00:00 GMT</pubDate>+ <category>feature</category>+ <description>The three.ws bonding-curve launchpad is now priced in $THREE instead of SOL. A coin launched there for a 3D agent can only be bought with $THREE, its creator earns half of every trading fee in $THREE, and when it graduates, the roughly 12.3 million $THREE it raised is locked in its pool permanently. The new launchpad page shows the live curves with buy and sell straight from your wallet. The curve has been verified against Solana mainnet and opens for launches as soon as its settings are published on-chain.</description>+ </item><item><title>Agent reputation on Base and other EVM chains now shows real on-chain reviews</title><link>https://three.ws/changelog</link>diff --git a/public/features.json b/public/features.jsonindex 912f3e6fa..47dfd2b92 100644--- a/public/features.json+++ b/public/features.json@@ -1,5 +1,5 @@{- "generated_at": "2026-09-20T04:32:12.748Z",+ "generated_at": "2026-09-20T04:55:28.609Z","generated_by": "scripts/build-page-index.mjs from data/pages.json","site": {"name": "three.ws",@@ -1787,6 +1787,16 @@"tags": [],"showcase": false},+ {+ "path": "/three-launchpad",+ "title": "$THREE Launchpad",+ "description": "A bonding-curve launchpad priced in $THREE: every coin launched for a 3D agent is bought with $THREE, creators earn their fees in $THREE, and each graduation locks the $THREE it raised in a pool nobody can withdraw. Launch a coin or trade the live curves.",+ "added": "2026-09-20",+ "auth": null,+ "indexable": true,+ "tags": [],+ "showcase": false+ },{"path": "/launches","title": "Agent Launches",diff --git a/public/llms-full.txt b/public/llms-full.txtindex 1d5574481..68a0199c5 100644--- a/public/llms-full.txt+++ b/public/llms-full.txt@@ -1094,6 +1094,12 @@ URL: https://three.ws/launch-studioA catalog of 50 coin-launch use cases: reward coins for trending GitHub repos and creators, and coins riding live cultural, news, and onchain narratives. Preview what each would mint right now from live data, then launch on pump.fun in one click.+### $THREE Launchpad++URL: https://three.ws/three-launchpad++A bonding-curve launchpad priced in $THREE: every coin launched for a 3D agent is bought with $THREE, creators earn their fees in $THREE, and each graduation locks the $THREE it raised in a pool nobody can withdraw. Launch a coin or trade the live curves.+### Agent LaunchesURL: https://three.ws/launchesdiff --git a/public/llms.txt b/public/llms.txtindex ccd596a54..97c6b900f 100644--- a/public/llms.txt+++ b/public/llms.txt@@ -205,6 +205,7 @@ On-chain features: pay-per-call, token launches, vanity wallets.- [Guardian console: recover & inherit agent wallets](https://three.ws/guardian): The agents you’re trusted to protect. Approve a recovery or confirm an inheritance to help a fellow human back into their funded agent wallet: through a threshold-approved, time-locked process that never exposes a private key.- [Launch a Coin](https://three.ws/launch): The pump.fun launchpad for 3D AI agents: pick your agent, name the coin, launch it from your wallet or the agent's wallet, and claim creator rewards on three.ws.- [Launch Studio: 50 ways to mint a coin](https://three.ws/launch-studio): A catalog of 50 coin-launch use cases: reward coins for trending GitHub repos and creators, and coins riding live cultural, news, and onchain narratives. Preview what each would mint right now from live data, then launch on pump.fun in one click.+- [$THREE Launchpad](https://three.ws/three-launchpad): A bonding-curve launchpad priced in $THREE: every coin launched for a 3D agent is bought with $THREE, creators earn their fees in $THREE, and each graduation locks the $THREE it raised in a pool nobody can withdraw. Launch a coin or trade the live curves.- [Agent Launches](https://three.ws/launches): Live public feed of every coin launched by a three.ws agent: market caps, graduation status, and the agent behind each launch.- [3D Drops](https://three.ws/drops): Launch a supply-capped collection of AI-forged 3D characters. Pick a style, define weighted trait layers, and three.ws rolls the whole supply from a published seed: verifiable rarity, rigged animation-ready art, forged on reveal.- [Minted 3D Assets](https://three.ws/minted): Live public gallery of every generated 3D avatar minted as a Metaplex Core NFT through three.ws: interactive viewer, baked provenance, and enforced creator royalties on every card.diff --git a/public/sitemap/index.html b/public/sitemap/index.htmlindex 3937f6ffb..507feae87 100644--- a/public/sitemap/index.html+++ b/public/sitemap/index.html@@ -96,7 +96,7 @@<main class="sm-wrap"><div class="sm-hero"><h1>Sitemap</h1>- <p>All 942 pages on three.ws, grouped by purpose. Looking for the machine-readable versions?</p>+ <p>All 943 pages on three.ws, grouped by purpose. Looking for the machine-readable versions?</p><div class="sm-formats"><a href="/sitemap.xml"><code>sitemap.xml</code> · for search engines</a><a href="/llms.txt"><code>llms.txt</code> · for AI agents</a>@@ -108,7 +108,7 @@</div><div class="sm-filter"><svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" aria-hidden="true"><circle cx="11" cy="11" r="7"/><path d="m21 21-4.3-4.3"/></svg>- <input id="sm-filter-input" type="search" placeholder="Filter 942 pages by name, path, or description…" aria-label="Filter pages" autocomplete="off" spellcheck="false" />+ <input id="sm-filter-input" type="search" placeholder="Filter 943 pages by name, path, or description…" aria-label="Filter pages" autocomplete="off" spellcheck="false" /><kbd id="sm-filter-kbd" aria-hidden="true">/</kbd></div><p class="sm-filter-count" role="status" aria-live="polite"><span id="sm-filter-count"></span><span id="sm-filter-hint" aria-hidden="true"></span></p>@@ -116,6 +116,14 @@<h2 id="sm-new-title">Newest<a class="sm-new-more" href="/changelog">full changelog →</a></h2><p class="sm-section-desc">The 9 most recently launched pages, straight to the live surface.</p><ul class="sm-list">+ <li>+ <a href="/three-launchpad">+ <span class="sm-new-date">Sep 20, 2026</span>+ <span class="sm-title">$THREE Launchpad</span>+ <span class="sm-path">/three-launchpad</span>+ <span class="sm-desc">A bonding-curve launchpad priced in $THREE: every coin launched for a 3D agent is bought with $THREE, creators earn their fees in $THREE, and each graduation locks the $THREE it raised in a pool nobody can withdraw. Launch a coin or trade the live curves.</span>+ </a>+ </li><li><a href="/docs/doc-freshness"><span class="sm-new-date">Sep 17, 2026</span>@@ -180,14 +188,6 @@<span class="sm-desc">A live Solana Transaction V1 observatory and pre-sign inspector. Paste a mainnet signature or base64 wire transaction to see exact bytes, resource caps, compute use, and sponsor safety.</span></a></li>- <li>- <a href="/onchain">- <span class="sm-new-date">Sep 15, 2026</span>- <span class="sm-title">Onchain Viewer</span>- <span class="sm-path">/onchain</span>- <span class="sm-desc">Open an image or text written into a public Solana Memo. Paste a transaction signature or Solscan link to preview the signed data without copying a data URI.</span>- </a>- </li></ul></section><nav class="sm-toc" aria-label="Sections">@@ -1373,7 +1373,7 @@<section class="sm-section" id="crypto"><header>- <h2>Crypto<span class="sm-count" data-count>146</span></h2>+ <h2>Crypto<span class="sm-count" data-count>147</span></h2><p class="sm-section-desc">On-chain features: pay-per-call, token launches, vanity wallets.</p></header><ul class="sm-list">@@ -1461,6 +1461,13 @@<span class="sm-desc">A catalog of 50 coin-launch use cases: reward coins for trending GitHub repos and creators, and coins riding live cultural, news, and onchain narratives. Preview what each would mint right now from live data, then launch on pump.fun in one click.</span></a></li>+ <li>+ <a href="/three-launchpad">+ <span class="sm-title">$THREE Launchpad</span>+ <span class="sm-path">/three-launchpad</span>+ <span class="sm-desc">A bonding-curve launchpad priced in $THREE: every coin launched for a 3D agent is bought with $THREE, creators earn their fees in $THREE, and each graduation locks the $THREE it raised in a pool nobody can withdraw. Launch a coin or trade the live curves.</span>+ </a>+ </li><li><a href="/launches"><span class="sm-title">Agent Launches</span>