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.
The /launch launchpad
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
- Link a 3D agent. The coin belongs to one of your agents.
POST /api/pump/build-metadatapins the image and metadata JSON and links the agent into it:websiteandexternal_urlpoint athttps://three.ws/agents/<agent_id>attributescarries a3D Agenttrait with that URLanimation_url,properties.filesandagent.modelcarry the avatar GLB, but only when the avatar ispublicorunlisted(token metadata is permanent and public)
- 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.
- 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.
- 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 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. After launch, every trade of the coin made through three.ws (the trade modal, agent wallets, strategies, snipers) carries the same 1% trade fee. Trades made on pump.fun or elsewhere do not. Details and env vars: pump-platform-fee.md.
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 (
7mFD2mUtRS65XstiSAvCJuYmdesZoQwCwRJhq1p3eRMeon 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). Since
pump.fun's October 2026 program update, newer trades leave the creator fee on the coin's bonding
curve or pool until it is swept into the vault; those amounts are counted too (rewards[].unswept
is the part still waiting on a curve or pool), so the balance is what a claim collects now.
Every claim sweeps first: the transaction moves the fees held on your coins' curves and pools
into your vaults, then collects the vaults, all in one signature. When more coins hold fees than
fit in one transaction, the largest go first and the response says how many wait for the next
claim (sweeps_remaining).
- Your wallet: Claim builds
collect-creator-fee-prepwithall_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 collects every quote vault (SOL, USDC, and any pump coin your coins are paired with). mints (up to 50) adds coins to sweep beyond the ones you launched here. Returns swept (mint, source curve or pool, quote_mint, amount) and sweeps_remaining. |
POST collect-creator-fee-agent |
Server-signed claim for an agent-wallet creator. Sweeps the agent's coins first; returns swept and sweeps_remaining. |
GET fee-info |
One coin's fee setup and claimable balance. claimable_lamports includes unswept_lamports, the SOL fees still on the coin's curve or pool. |
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, Launch Studio, STRUCTURE.md.