Skip to content

Open-source platform for 3D AI agents. Turn text or a photo into a rigged, animated GLB avatar, give it an LLM brain, memory and a wallet, and embed it anywhere with one web component. Remote MCP server, x402 payments, Three.js, browser-native.

docs(launch): document the /launch launchpad and its 1% dev-buy fee, and announce the rebuild in the changelog

Nicholas6903fb8355ff
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 4fcd8de70..ad3dd4f1d 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -4,6 +4,11 @@
Public history for [three.ws](https://three.ws), newest first. New pages come from `added` dates in data/pages.json; everything else is curated in data/changelog.json. Also available as [JSON](https://three.ws/changelog.json) and [RSS](https://three.ws/changelog.xml), live at [three.ws/changelog](https://three.ws/changelog).
+## 2026-09-16
+
+- **Docs · The /launch launchpad** (`/docs/launchpad`): How three.ws/launch launches a pump.fun coin for a 3D agent: agent-linked metadata, the 1% dev-buy fee, v0 lookup-table and Solana transaction v1 formats, claiming creator rewards on three.ws, and the API behind it.
+- **A cleaner launchpad for your 3D agent's coin, with rewards you claim right here**: three.ws/launch is rebuilt around one flow: pick one of your 3D agents, name the coin, and launch it on pump.fun from your wallet or from the agent's own wallet. The coin's metadata links your agent's page and 3D body, a live preview and cost panel show exactly what you will pay (including a 1% three.ws fee on the dev buy), and a new My coins tab shows unclaimed creator rewards and claims them in one click, no pump.fun app needed. Launches now fit in a single transaction thanks to pump.fun's lookup table, and larger ones, like USDC-paired coins with a dev buy, use Solana transaction v1 automatically when your wallet supports it. This also fixes launches that were failing because an on-chain buyback program stopped accepting new agents. (`/launch`) `[feature, improvement, fix]`
+
## 2026-09-15
- **Atomic - Solana V1 Inspector** (`/atomic`): 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.
@@ -3546,7 +3551,7 @@ And all of it is public. Oracle Lab publishes the actual model: every weight, th
- **Coin Intelligence** (`/coin-intel`): Every pump.fun launch watched and classified in real time: organic vs bundle, the wallets behind it, a transparent quality score, and a model that learns which signals predict winners.
- **Coin Radar** (`/radar`): Live pump.fun launch intelligence: every new coin scored in its first ~90 seconds: bundle vs organic, wallet concentration, dev behaviour, and risk flags from the Coin Intelligence Engine.
-- **Launch a Coin** (`/launch`): Mint a coin for your 3D AI agent in one flow: pick an agent, set the name, symbol, and image, then launch on pump.fun straight from your wallet with an optional three.ws-branded vanity mint.
+- **Launch a Coin** (`/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.
- **Smart Money Radar: follow the wallets that win on pump.fun** (`/smart-money`): A live first-party reputation graph of every pump.fun wallet. We cross each coin's buyers with the coins that actually graduated, so you can see which wallets keep picking winners: and what the proven money is buying right now.
- **Sniper Arena: autonomous AI agents trading live** (`/play/arena`): Watch three.ws AI agents trade pump.fun autonomously in real time. Live P&L leaderboard, each trade signed by the agent's own wallet and verifiable on-chain.
- **Trader Leaderboard** (`/leaderboard`): Pump.fun traders ranked by a provable, on-chain track record: realized P&L, win rate, and drawdown, with every number traceable to its transaction.
diff --git a/STRUCTURE.md b/STRUCTURE.md
index c284c29f2..021ef9501 100644
--- a/STRUCTURE.md
+++ b/STRUCTURE.md
@@ -209,6 +209,7 @@ bottom.
| Agent token plans (the coin an agent will become) | Rules + storage [api/_lib/agent-token-plan.js](api/_lib/agent-token-plan.js) (migration [api/_lib/migrations/20260811130000_agent_token_plans.sql](api/_lib/migrations/20260811130000_agent_token_plans.sql)), API actions `plan` + `plan-dry-run` in [api/agents/tokens/[action].js](api/agents/tokens/%5Baction%5D.js) `→ /api/agents/tokens/{plan,plan-dry-run}`, profile panel [src/agent-token-plan.js](src/agent-token-plan.js) on `/agents/:id` | In-repo · Live | The launch configuration bound to the agent record: one saved, editable plan per (agent, network) carrying the coin's name, ticker, story, artwork, pairing, buyback share and dev buy, with a derived readiness verdict and SOL cost estimate. Saving costs nothing and mints nothing. `plan-dry-run` is the free proof lane: it builds the SAME pump.fun create instructions the real launch builds from the SAME plan, compiles them against a real blockhash and simulates them on the cluster (devnet by default), never signing and never broadcasting, and separates `funding_required` from a genuinely broken plan. Both launch paths (`/api/agents/tokens/launch-confirm` from the owner's wallet, `/api/pump/launch-agent` from the agent's custodial wallet) call `markPlanLaunched` and write a `pump_agent_mints` row, which is also what finally puts user-wallet launches into `/launches` and the profile's launch history. Docs: [docs/agent-tokens.md](docs/agent-tokens.md). Tests: [tests/agent-token-plan.test.js](tests/agent-token-plan.test.js), [tests/agent-token-plan-api.test.js](tests/agent-token-plan-api.test.js), [tests/agent-token-plan-render.test.js](tests/agent-token-plan-render.test.js) |
| Agent token market data (what the coin looks like on the profile) | Cluster read [api/_lib/pump-curve-view.js](api/_lib/pump-curve-view.js) `→ GET /api/pump/curve` + `GET /api/v1/pump/curve`, view model [src/widgets/bonding-curve.js](src/widgets/bonding-curve.js) (`computeView`), normalization + widget [src/pump/coin-status-card.js](src/pump/coin-status-card.js) (`mapCoin` / `mapCurve` / `mountCoinStatus`), profile wiring [src/agent-detail.js](src/agent-detail.js) (token chip + launch history) | In-repo · Live | The live market half of an agent token. Two sources, one normalized shape: pump.fun's indexer (`/api/pump/coin`, mainnet, carries logo + 24h volume) and the bonding curve read straight off the cluster (`/api/pump/curve`), which is the ONLY source on devnet and the fallback whenever the indexer has not indexed a fresh mint or cannot be reached. A devnet coin renders in SOL and is badged `DEVNET` (devnet SOL has no dollar value) and links to the explorer instead of a pump.fun page that does not exist for that cluster, so the free rehearsal path renders exactly like a real launch. The curve gate accepts a pump.fun-ground `pump` suffix, a three.ws `3ws` mark, any plausible devnet address, and otherwise asks `pump_agent_mints` whether the mint is one of ours: a coin launched from a user's own wallet carries no mark and used to be refused with a cached `not_a_pump_mint` 404. Market cap is derived as price × supply because the SDK's `price.marketCap` goes negative on live curves. Free proof: [scripts/agent-token-market-proof.mjs](scripts/agent-token-market-proof.mjs) (reads only, signs nothing). Docs: [docs/agent-tokens.md](docs/agent-tokens.md). Tests: [tests/pump-curve-mint-gate.test.js](tests/pump-curve-mint-gate.test.js), [tests/agent-detail-launch-history.test.js](tests/agent-detail-launch-history.test.js), [src/pump/coin-status-card.curve.dom.test.js](src/pump/coin-status-card.curve.dom.test.js) |
| Launch Studio (coin-launch use cases) | [api/_lib/launch/](api/_lib/launch) `→ /launch-studio`, [api/pump/launch-studio.js](api/pump/launch-studio.js), [public/launch-studio/launch-studio.js](public/launch-studio/launch-studio.js) | In-repo | Engine + catalog of 50 declarative launch recipes: reward coins for trending GitHub repos/creators ([github-trending.js](api/_lib/github-trending.js)) and coins riding live narratives ([launcher-trends.js](api/_lib/launcher-trends.js)). Live preview, then a `/launch` handoff that carries the recipe's fee routing as `?reward=` and pre-fills the fee split after the mint. Docs: [docs/launch-usecases.md](docs/launch-usecases.md), [api/_lib/launch/README.md](api/_lib/launch/README.md) |
+| Coin launchpad for 3D agents (`/launch`) | [pages/launch.html](pages/launch.html) + [src/launch/launch-page.js](src/launch/launch-page.js) `→ /launch`, logic [src/launch/launch-model.js](src/launch/launch-model.js), wallet signing [src/launch/launch-wallet.js](src/launch/launch-wallet.js), tx assembly [api/_lib/pump-launch-tx.js](api/_lib/pump-launch-tx.js), endpoints in [api/pump/[action].js](api/pump/%5Baction%5D.js) (`launch-config`, `my-coins`, `build-metadata`, `launch-prep`, `launch-confirm`, `launch-agent`, `collect-creator-fee-*`) | Live | Pick one of your agents, name the coin, launch on pump.fun from your wallet or the agent's wallet, then claim creator rewards under My coins. Metadata links the agent page and (for public avatars) its GLB. A disclosed 1% fee on the dev buy rides in the launch transaction and is verified at confirm. Transactions compile v0 against pump.fun's lookup table, or Solana transaction v1 when v0 overflows and the wallet supports it. `?reward=` recipe links mount the studio launch panel ([public/launch/launch.js](public/launch/launch.js)). Docs: [docs/launchpad.md](docs/launchpad.md) |
| Native launchpad (three.ws's own bonding curve) | Curve economics [api/_lib/native-launch/config.js](api/_lib/native-launch/config.js), curve wrapper [api/_lib/native-launch/dbc.js](api/_lib/native-launch/dbc.js), dispatcher [api/native-launch/[action].js](api/native-launch/%5Baction%5D.js) `→ /api/native-launch/{config,quote,pool,launch-prep,launch-confirm,launches}`, lane toggle in [public/studio/launch-panel.js](public/studio/launch-panel.js) | In-repo (devnet-verified; mainnet config not yet deployed) | The second launch lane beside pump.fun: a coin launch on a bonding curve three.ws configures and owns, so the platform earns a share of every trade instead of only creator fees. Runs on Meteora's audited Dynamic Bonding Curve program with three.ws as the on-chain partner — 1B supply, SOL-quoted, immutable metadata, 1% trading fee split 50/50 creator/platform, graduating at ~85 SOL raised into a DAMM v2 pool with **100% of LP permanently locked** (un-ruggable, both sides keep earning). Same custody model as the pump lane (server builds an unsigned tx, the launcher's wallet + mint keypair sign client-side, confirm verifies on-chain that the curve program actually ran before recording). The lane hides itself entirely until a partner config is pinned for that network (`NATIVE_LAUNCH_CONFIG_KEY[_DEVNET]`), so launches fall back to pump.fun rather than half-working. Not to be confused with `/api/launchpad/*` (Launchpad Studio, the page builder). Storage: [native_launches](api/_lib/migrations/20260726100000_native_launchpad.sql). Setup: [scripts/native-launchpad-create-config.mjs](scripts/native-launchpad-create-config.mjs). E2E: [scripts/native-launchpad-e2e-devnet.mjs](scripts/native-launchpad-e2e-devnet.mjs). Docs: [docs/native-launchpad.md](docs/native-launchpad.md). Tests: [tests/native-launch-curve.test.js](tests/native-launch-curve.test.js), [tests/native-launch-endpoint.test.js](tests/native-launch-endpoint.test.js) |
| Memetic Launcher (per-user autonomous coin launcher) | [pages/launcher.html](pages/launcher.html) `→ /launcher` + [src/user-launcher.js](src/user-launcher.js), API [api/launcher/me.js](api/launcher/me.js), engine [api/_lib/launcher-engine.js](api/_lib/launcher-engine.js) (cron [api/cron/launcher-tick.js](api/cron/launcher-tick.js)), trends [api/_lib/launcher-trends.js](api/_lib/launcher-trends.js) | In-repo | Every user designs their own autonomous pump.fun launcher: mode (trend/meme/hybrid/random), trend sources, cadence, network. Preview (default) records picks without moving SOL; **Live** mints for real, SELF-FUNDED - each launch paid by the user's own agent wallet (base ~0.022 SOL + dev buy), never master SOL, with typed go-live confirm, dev-buy + daily-SOL-cap clamps, unfunded-wallet skips (breaker-immune), and an agent-wallet funding panel with live balances. Docs: [docs/memetic-launcher.md](docs/memetic-launcher.md). Tests: [tests/user-launcher.test.js](tests/user-launcher.test.js), [tests/launcher-engine.test.js](tests/launcher-engine.test.js) |
| pump.fun first-claims Telegram channel (@pumpfunclaims) | Delivery lane [api/_lib/pump-claims-push.js](api/_lib/pump-claims-push.js), cron [api/cron/pump-claims-push.js](api/cron/pump-claims-push.js) (every 5 min), shared scanner [api/_lib/pump-claims.js](api/_lib/pump-claims.js) (also backs `GET /api/pump/first-claims` and the `pumpfun_first_claims` MCP tool) | In-repo · lane wired, channel dark pending `PUMPFUN_BOT_URL` + `TELEGRAM_PUMP_CLAIMS_CHAT_ID` | A live feed of first-time pump.fun creator fee claims, one message per claim: the first time a creator ever pulls accrued rewards out of the fee vault is an irreversible on-chain signal that they are engaged with their coin. Mirrors the commit-feed lane's safety properties (DB lock, seed-without-posting on first run, per-message state writes, oldest-first drain, 3h replay cutoff) but dedupes by transaction signature rather than timestamp, because claims routinely share a second and a timestamp cursor drops the second one. No fallback to the holder changelog channel on purpose. The RPC fallback inside the scanner cannot serve this feed (the pump program clears a 200-signature page in under one second, so a scan covers no useful window); an indexer is required. Docs: [docs/pump-claims-channel.md](docs/pump-claims-channel.md). Tests: [tests/pump-claims-push.test.js](tests/pump-claims-push.test.js) |
diff --git a/data/changelog.json b/data/changelog.json
index 0bc0ef7b1..0706581dd 100644
--- a/data/changelog.json
+++ b/data/changelog.json
@@ -1,6 +1,17 @@
{
"$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-16",
+ "title": "A cleaner launchpad for your 3D agent's coin, with rewards you claim right here",
+ "summary": "three.ws/launch is rebuilt around one flow: pick one of your 3D agents, name the coin, and launch it on pump.fun from your wallet or from the agent's own wallet. The coin's metadata links your agent's page and 3D body, a live preview and cost panel show exactly what you will pay (including a 1% three.ws fee on the dev buy), and a new My coins tab shows unclaimed creator rewards and claims them in one click, no pump.fun app needed. Launches now fit in a single transaction thanks to pump.fun's lookup table, and larger ones, like USDC-paired coins with a dev buy, use Solana transaction v1 automatically when your wallet supports it. This also fixes launches that were failing because an on-chain buyback program stopped accepting new agents.",
+ "tags": [
+ "feature",
+ "improvement",
+ "fix"
+ ],
+ "link": "/launch"
+ },
{
"date": "2026-09-15",
"title": "Show and tell now captures projects people can actually try",
diff --git a/data/pages.json b/data/pages.json
index 0e7fc83c6..68196665a 100644
--- a/data/pages.json
+++ b/data/pages.json
@@ -1466,7 +1466,7 @@
{
"path": "/launch",
"title": "Launch a Coin",
- "description": "Mint a coin for your 3D AI agent in one flow: pick an agent, set the name, symbol, and image, then launch on pump.fun straight from your wallet with an optional three.ws-branded vanity mint.",
+ "description": "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.",
"priority": 0.8,
"changefreq": "monthly",
"added": "2026-06-15"
@@ -2981,6 +2981,14 @@
"changefreq": "monthly",
"added": "2026-08-11"
},
+ {
+ "path": "/docs/launchpad",
+ "title": "Docs · The /launch launchpad",
+ "description": "How three.ws/launch launches a pump.fun coin for a 3D agent: agent-linked metadata, the 1% dev-buy fee, v0 lookup-table and Solana transaction v1 formats, claiming creator rewards on three.ws, and the API behind it.",
+ "priority": 0.6,
+ "changefreq": "monthly",
+ "added": "2026-09-16"
+ },
{
"path": "/docs/analytics-retention",
"title": "Docs · Week-2 retention on minted agents",
diff --git a/docs/launchpad.md b/docs/launchpad.md
new file mode 100644
index 000000000..082300bba
--- /dev/null
+++ b/docs/launchpad.md
@@ -0,0 +1,111 @@
+# The /launch launchpad
+
+[three.ws/launch](https://three.ws/launch) is the pump.fun launchpad for 3D AI agents. A creator
+picks one of their agents, names a coin, and launches it on pump.fun from their own wallet or from
+the agent's wallet. Creator rewards stay claimable on the same page under **My coins**.
+
+Solana is the home chain: every coin here is a pump.fun bonding-curve launch on Solana mainnet.
+
+## What a launch does
+
+1. **Link a 3D agent.** The coin belongs to one of your agents. `POST /api/pump/build-metadata`
+ pins the image and metadata JSON and links the agent into it:
+ - `website` and `external_url` point at `https://three.ws/agents/<agent_id>`
+ - `attributes` carries a `3D Agent` trait with that URL
+ - `animation_url`, `properties.files` and `agent.model` carry the avatar GLB, but only when the
+ avatar is `public` or `unlisted` (token metadata is permanent and public)
+2. **Name it.** Name (32 characters), ticker (2 to 10 letters or digits), optional description and
+ social links. The image defaults to the agent's portrait.
+3. **Choose settings.**
+ - Launch from **your wallet** (you sign; rewards go to that wallet) or **the agent's wallet**
+ (the custodial agent wallet signs and earns; no wallet prompt).
+ - Pair with **SOL** or **USDC**.
+ - Creator rewards to the **creator** or to **holders** (pump.fun holder rewards; not claimable
+ here, they pay out to holders).
+ - Optional **dev buy**, **Mayhem mode**, and the **transaction format**.
+4. **Launch.** The server builds the transaction, the wallet signs it, the page confirms it on
+ Solana and records it (`launch-confirm`), and the coin appears on
+ [/launches](https://three.ws/launches) and its coin page `/launches/<mint>`.
+
+The mint address is ground server-side to carry the `3ws` mark and co-signs before the transaction
+reaches the browser, so the wallet adds exactly one signature.
+
+## Fees
+
+| Cost | Paid to | Amount |
+| --- | --- | --- |
+| Create + rent | pump.fun / Solana | about 0.022 SOL |
+| Dev buy | the bonding curve | whatever you choose, 0 by default |
+| three.ws launch fee | platform treasury | 1% of the dev buy (`PUMP_LAUNCH_FEE_BPS`) |
+
+The launch fee rides in the same transaction and is shown in the cost panel before you sign. No dev
+buy, no fee. Details and env vars: [pump-platform-fee.md](./pump-platform-fee.md#launch-fee-on-by-default).
+
+## Transaction formats
+
+A pump.fun create with a dev buy measured 1,229 bytes against Solana's 1,232-byte legacy limit, so
+anything added to it used to overflow. `api/_lib/pump-launch-tx.js` fixes that two ways:
+
+- **v0 with pump.fun's address lookup table** (`7mFD2mUtRS65XstiSAvCJuYmdesZoQwCwRJhq1p3eRMe` on
+ mainnet). A SOL launch with a dev buy and the fee compiles to about 1,030 bytes. Every wallet
+ signs v0.
+- **Solana transaction v1** (feature `txv1aq4pp281K9um3tnPgkfX8UqtFT6wcVW3hNezGLL`, active on mainnet
+ since slot 447,120,000). A 4,096-byte envelope with explicit compute and data limits. USDC-paired
+ launches with a dev buy only fit here (about 1,600 bytes).
+
+The **Auto** format (default) uses v0 when it fits and v1 only when v0 overflows and the connected
+wallet advertises v1 through Wallet Standard (`solana:signTransaction` with
+`supportedTransactionVersions` including `1`). A launch that needs v1 on a wallet without it gets a
+clear error instead of a failed signature. You can pin v0 or v1 under **Transaction format**.
+
+## Claiming creator rewards
+
+pump.fun pools creator rewards per creator wallet, not per coin. **My coins**
+(`GET /api/pump/my-coins`) groups your coins by the wallet that earns their rewards and reads the
+live unclaimed balance for every quote mint (bonding curve and PumpSwap vaults both).
+
+- **Your wallet:** Claim builds `collect-creator-fee-prep` with `all_quotes: true`, your wallet signs,
+ the page confirms it.
+- **Agent wallet:** Claim calls `collect-creator-fee-agent`; the agent wallet signs server-side.
+- Coins with rewards routed to holders, split by a fee-sharing config, or created by a wallet not
+ linked to your account are listed separately with the reason.
+
+You do not need the pump.fun app to claim: any coin launched here can be claimed here.
+
+## API
+
+All endpoints live under `/api/pump/`. Money-moving calls need a signed-in session and a wallet
+linked to it (`/api/auth/wallets/link-solana`).
+
+| Endpoint | Purpose |
+| --- | --- |
+| `GET launch-config` | Live launch fee bps, fee recipient, create-cost estimate, v1 activation, whether the PumpAgent buyback binding is available. Public. |
+| `POST build-metadata` | Pin image + metadata linked to the agent. Returns `metadata_url`, `agent_url`, `agent_model_url`. |
+| `POST launch-prep` | Build the launch transaction. New fields: `transaction_version` (`'auto'`, `0`, `1`), `v1_capable`. Returns `transaction_version`, `tx_bytes`, `tx_limit_bytes`, `platform_fee`, `mint_presigned`. |
+| `POST launch-confirm` | Verify the confirmed transaction (pump.fun program invoked, launch fee paid) and record the launch. |
+| `POST launch-agent` | Launch signed by the agent's custodial wallet. Returns `platform_fee` with `settlement`. |
+| `GET my-coins` | Your coins plus unclaimed rewards per creator wallet. |
+| `POST collect-creator-fee-prep` | Claim transaction for a wallet creator. `all_quotes: true` sweeps SOL and USDC vaults. |
+| `POST collect-creator-fee-agent` | Server-signed claim for an agent-wallet creator. |
+
+```bash
+curl -s https://three.ws/api/pump/launch-config
+```
+
+## Agent buyback binding
+
+Older launches bound an on-chain PumpAgent with a buyback share. The PumpAgent program currently
+rejects new agents (custom error 6015, `AgentInitializationNotSupported`, simulated on mainnet
+2026-09-16), which reverted every launch that included it. The binding is skipped unless an operator
+sets `PUMP_AGENT_INIT_ENABLED=1` after confirming the program accepts it again; `launch-prep`
+reports `buyback_available`.
+
+## Deep links
+
+`/launch` accepts `?avatar=<id|slug>`, `?name=`, `?symbol=`, `?description=`, `?initialBuy=`,
+`?image=<https url>`, `?imageSession=1` (image from the viewer snapshot) and `?tab=coins`.
+Launch Studio recipes that route rewards (`?reward=github:<login>|x:<handle>|wallet:<address>`)
+open the full studio launch panel, which owns the fee-split handoff.
+
+Related: [agent tokens](./agent-tokens.md), [Launch Studio](https://three.ws/launch-studio),
+[STRUCTURE.md](../STRUCTURE.md).
diff --git a/docs/pump-platform-fee.md b/docs/pump-platform-fee.md
index 749afd5f4..4f10db6b4 100644
--- a/docs/pump-platform-fee.md
+++ b/docs/pump-platform-fee.md
@@ -52,3 +52,25 @@ The fee is **never** charged silently. When `platform_fee_bps > 0`:
4. Set `PUMP_PLATFORM_FEE_BPS=100`.
5. Confirm the modal shows the fee line and a test trade routes the fee to the
wallet.
+
+## Launch fee (on by default)
+
+Coins launched through three.ws (`/launch`, `/api/pump/launch-prep`, `/api/pump/launch-agent`)
+carry a separate **launch fee on the dev buy**, set by the owner at 1%.
+
+| Env var | Effect |
+|---|---|
+| `PUMP_LAUNCH_FEE_BPS` | Rate in basis points on the dev buy. **Default `100` (1%).** `0` turns it off. Hard-capped at 500. |
+| `PUMP_PLATFORM_FEE_WALLET` | Same recipient as the trade fee (falls back to the platform treasury pubkey). |
+
+- A launch with no dev buy pays no launch fee.
+- The fee is a transfer inside the launch transaction itself (SOL for SOL-paired coins, USDC for
+ USDC-paired ones). `launch-prep` returns it as `platform_fee` and `/launch` shows it in the cost
+ panel before the wallet prompt.
+- `launch-confirm` reads the recipient's balance delta from the confirmed transaction
+ (`txPaidPlatformFee`) and refuses to list a launch whose transaction did not pay it.
+- On the agent-wallet path, a USDC launch plus the fee can exceed the v0 packet; the coin then
+ launches first and the fee follows in its own transaction (`platform_fee.settlement: 'separate'`,
+ or `'failed'` if that transfer did not land, in which case nothing was charged).
+- `GET /api/pump/launch-config` reports the live `launch_fee_bps` (0 when no recipient resolves).
+- Terms: section 8 of `/legal/tos` discloses platform fees on Real-Funds Features.
diff --git a/docs/start-here.md b/docs/start-here.md
index f8fe39e09..2b189882e 100644
--- a/docs/start-here.md
+++ b/docs/start-here.md
@@ -215,6 +215,7 @@ Deeper references that don't fit a track above but answer real questions:
- [Agent trading spec](./specs/agent-trading.md): the proposed agent trading capability contract
- [ERC-8004 validation attestation](./erc8004/validation-attestation.md): the attestation written when an agent registers on-chain
- [zauth](./zauth/index.md): the vendored security infrastructure docs our agent auth builds on
+- [The /launch launchpad](./launchpad.md): launch a pump.fun coin for a 3D agent from your wallet or the agent's wallet, pay a disclosed 1% dev-buy fee, and claim creator rewards on three.ws, with automatic Solana transaction v1 for launches that overflow v0
- [Agent tokens](./agent-tokens.md): 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](./pumpfun-program/README.md): the vendored on-chain program reference behind the launch surfaces
- [pump-fun-mcp at the edge](./pump-fun-mcp-edge.md): the Cloudflare Workers mirror of the pump.fun MCP endpoint
diff --git a/pages/launch.html b/pages/launch.html
index b20bff78c..706cbe8c3 100644
--- a/pages/launch.html
+++ b/pages/launch.html
@@ -44,6 +44,7 @@
<body>
<header><div id="nav-container"></div></header>
<script src="/nav.js"></script>
+ <script src="/model-viewer-meshopt.js"></script>
<main class="lx" id="main-content">
<div class="lx-head">
diff --git a/public/changelog-recent.json b/public/changelog-recent.json
index 842397764..04c90a967 100644
--- a/public/changelog-recent.json
+++ b/public/changelog-recent.json
@@ -1,14 +1,36 @@
{
- "generated_at": "2026-09-16T16:27:18.321Z",
+ "generated_at": "2026-09-16T16:41:04.225Z",
"generated_by": "scripts/build-page-index.mjs from data/pages.json + data/changelog.json",
"site": {
"name": "three.ws",
"url": "https://three.ws"
},
- "total": 3682,
+ "total": 3684,
"complete": false,
"full_feed": "/changelog.json",
"entries": [
+ {
+ "date": "2026-09-16",
+ "type": "launch",
+ "title": "Docs · The /launch launchpad",
+ "summary": "How three.ws/launch launches a pump.fun coin for a 3D agent: agent-linked metadata, the 1% dev-buy fee, v0 lookup-table and Solana transaction v1 formats, claiming creator rewards on three.ws, and the API behind it.",
+ "link": "/docs/launchpad",
+ "tags": [
+ "launch"
+ ]
+ },
+ {
+ "date": "2026-09-16",
+ "type": "update",
+ "title": "A cleaner launchpad for your 3D agent's coin, with rewards you claim right here",
+ "summary": "three.ws/launch is rebuilt around one flow: pick one of your 3D agents, name the coin, and launch it on pump.fun from your wallet or from the agent's own wallet. The coin's metadata links your agent's page and 3D body, a live preview and cost panel show exactly what you will pay (including a 1% three.ws fee on the dev buy), and a new My coins tab shows unclaimed creator rewards and claims them in one click, no pump.fun app needed. Launches now fit in a single transaction thanks to pump.fun's lookup table, and larger ones, like USDC-paired coins with a dev buy, use Solana transaction v1 automatically when your wallet supports it. This also fixes launches that were failing because an on-chain buyback program stopped accepting new agents.",
+ "link": "/launch",
+ "tags": [
+ "feature",
+ "improvement",
+ "fix"
+ ]
+ },
{
"date": "2026-09-15",
"type": "launch",
@@ -1596,28 +1618,6 @@
"fix",
"improvement"
]
- },
- {
- "date": "2026-09-07",
- "type": "update",
- "title": "A sharper cutout for images with hair, fur, or fine edges",
- "summary": "Background removal now offers BiRefNet as an optional model alongside the fast default. The default model smears wispy boundaries into a soft halo, and because every image-to-3D lane rebuilds geometry from the cut-out subject, that halo turned into real polygons on the finished mesh. BiRefNet keeps hair strands, fur, foliage, and thin straps intact. It takes about six seconds against the default's one, so it stays opt-in: pass model \"birefnet\" on the background-removal endpoint or pick it from the MCP tool when the edge is what matters.",
- "link": null,
- "tags": [
- "improvement",
- "feature"
- ]
- },
- {
- "date": "2026-09-07",
- "type": "update",
- "title": "Archived news stories with emoji in their summary keep their search listing",
- "summary": "Google Search Console flagged an archived story page for unparsable structured data. The cause: the archive trims a publisher summary to a fixed length before serving it, and the cut landed in the middle of an emoji, leaving half a character in the page data that search engines read. Trimming is now character-aware, so it never splits an emoji, a flag, or an accented letter, and the page data is checked for half characters before it is written. Around one archived story in seven thousand carried the flaw; all of them serve a valid listing now. The same fix covers the story summaries shown in link previews and the shared page descriptions across the site.",
- "link": "/markets/news",
- "tags": [
- "fix",
- "infra"
- ]
}
]
}
diff --git a/public/changelog.json b/public/changelog.json
index 8644dd765..73752db5e 100644
--- a/public/changelog.json
+++ b/public/changelog.json
@@ -1,11 +1,33 @@
{
- "generated_at": "2026-09-16T16:27:18.295Z",
+ "generated_at": "2026-09-16T16:41:04.189Z",
"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-16",
+ "type": "launch",
+ "title": "Docs · The /launch launchpad",
+ "summary": "How three.ws/launch launches a pump.fun coin for a 3D agent: agent-linked metadata, the 1% dev-buy fee, v0 lookup-table and Solana transaction v1 formats, claiming creator rewards on three.ws, and the API behind it.",
+ "link": "/docs/launchpad",
+ "tags": [
+ "launch"
+ ]
+ },
+ {
+ "date": "2026-09-16",
+ "type": "update",
+ "title": "A cleaner launchpad for your 3D agent's coin, with rewards you claim right here",
+ "summary": "three.ws/launch is rebuilt around one flow: pick one of your 3D agents, name the coin, and launch it on pump.fun from your wallet or from the agent's own wallet. The coin's metadata links your agent's page and 3D body, a live preview and cost panel show exactly what you will pay (including a 1% three.ws fee on the dev buy), and a new My coins tab shows unclaimed creator rewards and claims them in one click, no pump.fun app needed. Launches now fit in a single transaction thanks to pump.fun's lookup table, and larger ones, like USDC-paired coins with a dev buy, use Solana transaction v1 automatically when your wallet supports it. This also fixes launches that were failing because an on-chain buyback program stopped accepting new agents.",
+ "link": "/launch",
+ "tags": [
+ "feature",
+ "improvement",
+ "fix"
+ ]
+ },
{
"date": "2026-09-15",
"type": "launch",
@@ -34498,7 +34520,7 @@
"date": "2026-06-15",
"type": "launch",
"title": "Launch a Coin",
- "summary": "Mint a coin for your 3D AI agent in one flow: pick an agent, set the name, symbol, and image, then launch on pump.fun straight from your wallet with an optional three.ws-branded vanity mint.",
+ "summary": "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.",
"link": "/launch",
"tags": [
"launch"
diff --git a/public/changelog.xml b/public/changelog.xml
index 8f99aee2b..1430b7372 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>Docs · The /launch launchpad</title>
+ <link>https://three.ws/docs/launchpad</link>
+ <guid isPermaLink="false">2026-09-16:Docs · The /launch launchpad</guid>
+ <pubDate>Wed, 16 Sep 2026 12:00:00 GMT</pubDate>
+ <category>launch</category>
+ <description>How three.ws/launch launches a pump.fun coin for a 3D agent: agent-linked metadata, the 1% dev-buy fee, v0 lookup-table and Solana transaction v1 formats, claiming creator rewards on three.ws, and the API behind it.</description>
+ </item>
+ <item>
+ <title>A cleaner launchpad for your 3D agent's coin, with rewards you claim right here</title>
+ <link>https://three.ws/launch</link>
+ <guid isPermaLink="false">2026-09-16:A cleaner launchpad for your 3D agent's coin, with rewards you claim right here</guid>
+ <pubDate>Wed, 16 Sep 2026 12:00:00 GMT</pubDate>
+ <category>feature</category>
+ <description>three.ws/launch is rebuilt around one flow: pick one of your 3D agents, name the coin, and launch it on pump.fun from your wallet or from the agent's own wallet. The coin's metadata links your agent's page and 3D body, a live preview and cost panel show exactly what you will pay (including a 1% three.ws fee on the dev buy), and a new My coins tab shows unclaimed creator rewards and claims them in one click, no pump.fun app needed. Launches now fit in a single transaction thanks to pump.fun's lookup table, and larger ones, like USDC-paired coins with a dev buy, use Solana transaction v1 automatically when your wallet supports it. This also fixes launches that were failing because an on-chain buyback program stopped accepting new agents.</description>
+ </item>
<item>
<title>Atomic - Solana V1 Inspector</title>
<link>https://three.ws/atomic</link>
@@ -26236,7 +26252,7 @@ And all of it is public. Oracle Lab publishes the actual model: every weight, th
<guid isPermaLink="false">2026-06-15:Launch a Coin</guid>
<pubDate>Mon, 15 Jun 2026 12:00:00 GMT</pubDate>
<category>launch</category>
- <description>Mint a coin for your 3D AI agent in one flow: pick an agent, set the name, symbol, and image, then launch on pump.fun straight from your wallet with an optional three.ws-branded vanity mint.</description>
+ <description>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.</description>
</item>
<item>
<title>Smart Money Radar: follow the wallets that win on pump.fun</title>
diff --git a/public/features.json b/public/features.json
index 4bed67135..62698847b 100644
--- a/public/features.json
+++ b/public/features.json
@@ -1,5 +1,5 @@
{
- "generated_at": "2026-09-16T16:27:18.279Z",
+ "generated_at": "2026-09-16T16:41:04.170Z",
"generated_by": "scripts/build-page-index.mjs from data/pages.json",
"site": {
"name": "three.ws",
@@ -1770,7 +1770,7 @@
{
"path": "/launch",
"title": "Launch a Coin",
- "description": "Mint a coin for your 3D AI agent in one flow: pick an agent, set the name, symbol, and image, then launch on pump.fun straight from your wallet with an optional three.ws-branded vanity mint.",
+ "description": "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.",
"added": "2026-06-15",
"auth": null,
"indexable": true,
@@ -3628,6 +3628,16 @@
"tags": [],
"showcase": false
},
+ {
+ "path": "/docs/launchpad",
+ "title": "Docs · The /launch launchpad",
+ "description": "How three.ws/launch launches a pump.fun coin for a 3D agent: agent-linked metadata, the 1% dev-buy fee, v0 lookup-table and Solana transaction v1 formats, claiming creator rewards on three.ws, and the API behind it.",
+ "added": "2026-09-16",
+ "auth": null,
+ "indexable": true,
+ "tags": [],
+ "showcase": false
+ },
{
"path": "/docs/analytics-retention",
"title": "Docs · Week-2 retention on minted agents",
diff --git a/public/llms-full.txt b/public/llms-full.txt
index 43e18447d..2344140c4 100644
--- a/public/llms-full.txt
+++ b/public/llms-full.txt
@@ -1086,7 +1086,7 @@ The agents you’re trusted to protect. Approve a recovery or confirm an inherit
URL: https://three.ws/launch
-Mint a coin for your 3D AI agent in one flow: pick an agent, set the name, symbol, and image, then launch on pump.fun straight from your wallet with an optional three.ws-branded vanity mint.
+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
@@ -2224,6 +2224,12 @@ URL: https://three.ws/docs/agent-tokens
Turn an agent into an economic object: a Solana coin whose identity belongs to the agent rather than to whoever filled in the launch form. Covers configuring a coin before it exists, rehearsing the launch for free, and the single command that launches it for real.
+### Docs · The /launch launchpad
+
+URL: https://three.ws/docs/launchpad
+
+How three.ws/launch launches a pump.fun coin for a 3D agent: agent-linked metadata, the 1% dev-buy fee, v0 lookup-table and Solana transaction v1 formats, claiming creator rewards on three.ws, and the API behind it.
+
### Docs · Week-2 retention on minted agents
URL: https://three.ws/docs/analytics-retention
diff --git a/public/llms.txt b/public/llms.txt
index 04ca70542..9bd1017f7 100644
--- a/public/llms.txt
+++ b/public/llms.txt
@@ -203,7 +203,7 @@ On-chain features: pay-per-call, token launches, vanity wallets.
- [Agent Activity: Oracle conviction in real time](https://three.ws/activity): The trading floor: every Oracle conviction action from every autonomous 3D agent on pump.fun, live. Filter by tier and mode, track outcomes, and copy the winners.
- [Recording Pipeline: the data loop, live](https://three.ws/pipeline): One-glance health of the closed loop that turns every pump.fun launch into a trade signal: the launch recorder, signal intel, ground-truth outcomes, Oracle conviction, the wallet reputation graph, trained weights, and the agents trading on the result. Every stage, in real time.
- [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): Mint a coin for your 3D AI agent in one flow: pick an agent, set the name, symbol, and image, then launch on pump.fun straight from your wallet with an optional three.ws-branded vanity mint.
+- [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.
- [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.
@@ -386,6 +386,7 @@ Docs, tutorials, and reference.
- [Docs · Trader Wrapped](https://three.ws/docs/trader-wrapped): How the shareable season recap for a pump.fun trading agent is built: what each of the eight slides reads, where its numbers come from, and why the whole page is read-only arithmetic over round-trips that already settled on-chain.
- [Docs · pump.fun first-claims channel](https://three.ws/docs/pump-claims-channel): A live Telegram feed of first-time pump.fun creator fee claims: how the delivery lane scans, dedupes by transaction signature, and drains a backlog in order, plus the configuration it needs and why the direct on-chain fallback cannot serve the feed.
- [Docs · Agent tokens](https://three.ws/docs/agent-tokens): Turn an agent into an economic object: a Solana coin whose identity belongs to the agent rather than to whoever filled in the launch form. Covers configuring a coin before it exists, rehearsing the launch for free, and the single command that launches it for real.
+- [Docs · The /launch launchpad](https://three.ws/docs/launchpad): How three.ws/launch launches a pump.fun coin for a 3D agent: agent-linked metadata, the 1% dev-buy fee, v0 lookup-table and Solana transaction v1 formats, claiming creator rewards on three.ws, and the API behind it.
- [Docs · Week-2 retention on minted agents](https://three.ws/docs/analytics-retention): How three.ws measures the one number that gates phase 2 of the roadmap: whether users come back to converse with the agent they minted. Defines the cohort, the return event, and the query behind the reported figure.
- [Docs · GitHub memory seeding](https://three.ws/docs/github-memory-seeding): Give an agent your work: your public GitHub profile plus the repositories and READMEs you pick, distilled into long-term memory so the agent speaks concretely about what you build instead of guessing. Consent is explicit and revoking it deletes every memory the grant produced.
- [Docs · Reputation Staking Market](https://three.ws/docs/reputation-staking-market): Stake conviction on an agent and earn from its attested action history. Principal sits in a market escrow, yield is derived per epoch from the agent's signed on-chain attestations, and positions build on the existing threews.stake.v1 conviction signal.
diff --git a/public/sitemap/index.html b/public/sitemap/index.html
index 59b558730..7f80112eb 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 936 pages on three.ws, grouped by purpose. Looking for the machine-readable versions?</p>
+ <p>All 937 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 936 pages by name, path, or description…" aria-label="Filter pages" autocomplete="off" spellcheck="false" />
+ <input id="sm-filter-input" type="search" placeholder="Filter 937 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 &rarr;</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="/docs/launchpad">
+ <span class="sm-new-date">Sep 16, 2026</span>
+ <span class="sm-title">Docs · The /launch launchpad</span>
+ <span class="sm-path">/docs/launchpad</span>
+ <span class="sm-desc">How three.ws/launch launches a pump.fun coin for a 3D agent: agent-linked metadata, the 1% dev-buy fee, v0 lookup-table and Solana transaction v1 formats, claiming creator rewards on three.ws, and the API behind it.</span>
+ </a>
+ </li>
<li>
<a href="/contributors">
<span class="sm-new-date">Sep 15, 2026</span>
@@ -180,14 +188,6 @@
<span class="sm-desc">How the Fade Radar scores a coin's buy side: what makes a wallet a reverse indicator, the 0 to 100 fade score, the verdict bands, and the out-of-sample measurement behind them.</span>
</a>
</li>
- <li>
- <a href="/docs/rivalries">
- <span class="sm-new-date">Sep 9, 2026</span>
- <span class="sm-title">Docs · Rivalries</span>
- <span class="sm-path">/docs/rivalries</span>
- <span class="sm-desc">What changed on the trader board: who passed whom, who just arrived, and who is closing. Derived from close timestamps rather than a snapshot table, so the matchups work retroactively and cannot disagree with the leaderboard.</span>
- </a>
- </li>
</ul>
</section>
<nav class="sm-toc" aria-label="Sections">
@@ -1451,7 +1451,7 @@
<a href="/launch">
<span class="sm-title">Launch a Coin</span>
<span class="sm-path">/launch</span>
- <span class="sm-desc">Mint a coin for your 3D AI agent in one flow: pick an agent, set the name, symbol, and image, then launch on pump.fun straight from your wallet with an optional three.ws-branded vanity mint.</span>
+ <span class="sm-desc">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.</span>
</a>
</li>
<li>
@@ -2583,7 +2583,7 @@
<section class="sm-section" id="learn">
<header>
- <h2>Learn<span class="sm-count" data-count>432</span></h2>
+ <h2>Learn<span class="sm-count" data-count>433</span></h2>
<p class="sm-section-desc">Docs, tutorials, and reference.</p>
</header>
<ul class="sm-list">
@@ -2762,6 +2762,13 @@
<span class="sm-desc">Turn an agent into an economic object: a Solana coin whose identity belongs to the agent rather than to whoever filled in the launch form. Covers configuring a coin before it exists, rehearsing the launch for free, and the single command that launches it for real.</span>
</a>
</li>
+ <li>
+ <a href="/docs/launchpad">
+ <span class="sm-title">Docs · The /launch launchpad</span>
+ <span class="sm-path">/docs/launchpad</span>
+ <span class="sm-desc">How three.ws/launch launches a pump.fun coin for a 3D agent: agent-linked metadata, the 1% dev-buy fee, v0 lookup-table and Solana transaction v1 formats, claiming creator rewards on three.ws, and the API behind it.</span>
+ </a>
+ </li>
<li>
<a href="/docs/analytics-retention">
<span class="sm-title">Docs · Week-2 retention on minted agents</span>
diff --git a/src/launch/launch-page.js b/src/launch/launch-page.js
index 838d5b2f2..1b628a942 100644
--- a/src/launch/launch-page.js
+++ b/src/launch/launch-page.js
@@ -790,13 +790,14 @@ function walletBlocker(c) {
if (state.user === null) return { field: 'wallet', text: 'Sign in to launch', blocking: false };
if (state.form.launcher === 'agent') {
if (!state.agentWallet) return { field: 'wallet', text: state.agentWalletError || "Loading the agent's wallet", blocking: true };
- if (c.quote === 'SOL' && state.agentWallet.sol != null && state.agentWallet.sol < c.totalSol) {
+ // USDC coins still pay rent and network fees in SOL (totalSol covers both lanes).
+ if (state.agentWallet.sol != null && state.agentWallet.sol < c.totalSol) {
return { field: 'wallet', text: `The agent's wallet needs ~${formatAmount(c.totalSol - state.agentWallet.sol, 4)} more SOL`, blocking: true };
}
return null;
}
if (!state.wallet) return null;
- if (c.quote === 'SOL' && state.balance != null && state.balance < c.totalSol) {
+ if (state.balance != null && state.balance < c.totalSol) {
return { field: 'wallet', text: `Your wallet needs ~${formatAmount(c.totalSol - state.balance, 4)} more SOL`, blocking: true };
}
return null;
diff --git a/tests/api/pump.test.js b/tests/api/pump.test.js
index 4e669e5a1..ea453efef 100644
--- a/tests/api/pump.test.js
+++ b/tests/api/pump.test.js
@@ -59,6 +59,16 @@ const mockPumpAgent = {
})),
};
+const launchTxState = vi.hoisted(() => ({ buybackAvailable: true }));
+
+// ── launch transaction assembly (lookup tables / v1 need a live RPC) ─────────
+vi.mock('../../api/_lib/pump-launch-tx.js', () => ({
+ buildLaunchTransaction: vi.fn(async () => ({ tx_base64: 'BASE64TX', transaction_version: 0, bytes: 900, limit_bytes: 1232 })),
+ getPumpLookupTables: vi.fn(async () => []),
+ pumpAgentBuybackAvailable: vi.fn(() => launchTxState.buybackAvailable),
+ transactionV1Status: vi.fn(async () => ({ active: true, activation_slot: 1 })),
+}));
+
vi.mock('../../api/_lib/pump.js', () => ({
getConnection: vi.fn(() => ({})),
solanaPubkey: vi.fn((s) => (s ? { toBase58: () => s, toString: () => s } : null)),
@@ -238,6 +248,27 @@ describe('POST /api/pump/launch-prep', () => {
expect(mockPumpAgentOffline.create).toHaveBeenCalledOnce();
expect(mockPumpAgentOffline.create.mock.calls[0][0].buybackBps).toBe(500);
});
+
+ it('launches without the buyback binding while PumpAgent refuses new agents', async () => {
+ launchTxState.buybackAvailable = false;
+ authState.session = { id: 'user-1' };
+ sqlState.queue = [[{ id: 'wallet-1' }], [{ id: 'agent-1', name: 'Foo' }], []];
+ mockPumpAgentOffline.create.mockClear();
+ const { res, json } = await invoke(pumpAction('launch-prep'), {
+ method: 'POST', url: '/api/pump/launch-prep',
+ body: {
+ agent_id: '00000000-0000-0000-0000-000000000001',
+ wallet_address: walletB58,
+ name: 'Foo', symbol: 'FOO', uri: 'https://x/m.json',
+ network: 'devnet', buyback_bps: 500,
+ },
+ });
+ launchTxState.buybackAvailable = true;
+ expect(res.statusCode).toBe(201);
+ expect(json.buyback_bps).toBe(0);
+ expect(json.buyback_available).toBe(false);
+ expect(mockPumpAgentOffline.create).not.toHaveBeenCalled();
+ });
});
describe('POST /api/pump/accept-payment-prep', () => {
diff --git a/tests/launch-mark-enforcement.test.js b/tests/launch-mark-enforcement.test.js
index 936028507..f56f3ba17 100644
--- a/tests/launch-mark-enforcement.test.js
+++ b/tests/launch-mark-enforcement.test.js
@@ -121,6 +121,16 @@ vi.mock('../api/_lib/execution-engine.js', () => ({
submitProtected: vi.fn(async () => ({ signature: 'a'.repeat(88), slot: 1, route: 'protected' })),
}));
+const launchTxState = vi.hoisted(() => ({ buybackAvailable: true }));
+
+// ── launch transaction assembly (lookup tables / v1 need a live RPC) ─────────
+vi.mock('../api/_lib/pump-launch-tx.js', () => ({
+ buildLaunchTransaction: vi.fn(async () => ({ tx_base64: 'BASE64TX', transaction_version: 0, bytes: 900, limit_bytes: 1232 })),
+ getPumpLookupTables: vi.fn(async () => []),
+ pumpAgentBuybackAvailable: vi.fn(() => launchTxState.buybackAvailable),
+ transactionV1Status: vi.fn(async () => ({ active: true, activation_slot: 1 })),
+}));
+
// ── pump.js SDK ───────────────────────────────────────────────────────────────
vi.mock('../api/_lib/pump.js', () => ({
getConnection: vi.fn(() => ({})),