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.
Agent wallets
Every three.ws agent owns a custodial Solana wallet. It is what lets an agent act on its own — pay for an API call, buy a coin, tip another agent, receive its earnings — without a human approving each transaction in a browser extension.
This is the reference for the wallet itself: how it's created, how its key is held, what may spend from it, and where the controls live. For the owner-facing safety story (limits, freeze, proof, recovery) read Custody you can verify. For the complete tour of everything the wallet can do, read What agents can do → The Agent Wallet.
What you get
The wallet is created automatically when an agent is created — there is no separate "enable wallet" step and no seed phrase for the owner to write down. Each agent gets:
- a Solana keypair (mainnet and devnet share one address)
- an EVM keypair for the chains where the agent registers its ERC-8004 identity
- a spot on the platform's custody ledger, which records every outbound movement
Nothing is shared between agents. Two agents owned by the same person hold two independent wallets.
Key custody
The private key is generated on the server, never leaves it, and is encrypted at rest with AES-256-GCM.
The encryption key derives, via HKDF, from a dedicated secret (WALLET_ENCRYPTION_KEY) that exists only to protect wallets — deliberately not the platform's JWT_SECRET. Each ciphertext embeds its own random salt, so no two records share a derived key, and rotating session secrets never bricks a wallet. Ciphertexts written under the older scheme still decrypt (dual-read) and re-encrypt opportunistically on their next write.
This is the same secret box used for coin treasuries and the launcher, so every custodial secret on the platform is held the same way.
What this means honestly: the platform can sign for the agent. That is the point — an autonomous agent that needs you to approve each transaction is not autonomous. What the platform gives you in exchange is that everything it can do is capped by policy you set, halted by a freeze you control, recorded in an audit trail, and provable on-chain. See custody.md.
Who can spend
Five paths move funds out of an agent wallet, and all five pass through one policy module before anything is signed:
| Path | Trigger |
|---|---|
| Withdraw | The owner sweeps funds out |
| x402 pay | The agent pays for a paid API call. Also reachable from any paid checkout on the site: the x402 payment modal lists a signed-in user's agents next to Phantom, and picking one settles from that agent's wallet with no popup |
| Trade | A discretionary buy/sell from the wallet hub, or from the in-world coin widget's Pay with selector (SOL-denominated coins) |
| Purchase | The agent buys a marketplace skill or asset for itself (see Marketplace), under its own daily purchase cap |
| Snipe | The autonomous sniper worker executes a strategy |
Because enforcement lives at the signing boundary rather than in each feature, a new feature cannot accidentally introduce an unguarded spend path.
The policy
Limits are stored per agent and are opt-in — an unset ceiling means "no global cap," so existing automated flows keep their own per-feature caps until an owner tightens the policy. Once set, they are hard limits applied uniformly:
daily_usd— rolling 24-hour USD-equivalent outflow ceiling, summed from the custody ledgerper_tx_usd— maximum USD-equivalent for a single outbound transactionwithdraw_allowlist, the active addresses on the destination whitelist; new addresses serve a cooldown (24h default, 1h minimum) and need step-up before they can receive fundsfrozen— the kill switch: every autonomous path is refusedrequire_capabilities— when on, every autonomous spend must present a valid scoped session key
Two asymmetries are deliberate:
- A freeze never blocks the owner's withdrawal. Locking down a misbehaving agent must not trap your money; the safe direction stays open.
- An SPL token that can't be priced in USD is governed by the allowlist and rate limit rather than the USD cap — a price-feed outage can never strand your own withdrawal.
Coin-launch and bonding-curve activity carries an additional SOL-denominated policy (max_sol_per_tx, daily_sol_cap, an optional allowed_mints allowlist). A freshly provisioned agent that has never been configured defaults to 1 SOL per transaction and 5 SOL per rolling day, so a stolen session token cannot drain it.
On top of the numeric caps sit three additive layers, each of which can only ever narrow a spend, never widen it: natural-language spend rules that an LLM authors and deterministic code enforces, a behavioral anomaly guard that freezes the wallet when a spend doesn't look like the agent's normal behavior, and an owner-signed, epoch-bounded spend delegation that any outside counterparty can verify offline, enforced against the wallet's realized ledger spend rather than a self-reported amount.
The audit trail
Every spend writes a row to the custody event ledger — amount, USD value, destination, path, timestamp. The rolling daily ceiling is enforced by summing that ledger, which means the cap and the audit trail can never disagree. The ledger is also what the proof-of-custody Merkle attestation commits to.
Where owners manage it
The Agent Wallet Hub lives at /agent/:id/wallet. Owners see all 26 sections; a visitor to a public agent page sees a read-only view: Balance, Deposit, Trust, Trade, and Pulse. Everything a visitor sees is public on-chain data, so the balance a visitor reads is the same live figure the owner reads. The transaction feed is the exception: it is owner-only server-side, so the visitor's Balance tab says so and links to the block explorer instead. A network selector switches every read and write between mainnet and devnet.
/agent-wallet is the same hub reached without naming an agent. It resolves the signed-in owner's agents: one agent opens its hub directly, several render a picker, none offers a route to create the first one, and a signed-out visitor is asked to sign in.
Key endpoints:
GET /api/agents/:id/solana: address, live balance, anddeposits_enabledsafety verdict (public). Funding UIs must requiredeposits_enabled === true; a missing, false, or unreadable verdict is not safe to fund.GET /api/agents/:id/solana/activity: parsed transaction feed (owner only)GET/PUT /api/agents/:id/solana/limits: read and set the spend policyPOST /api/agents/:id/solana/withdraw: sweep an asset outGET /api/agents/:id/solana/guard— anomaly guard state and flagged activityGET/POST /api/agents/:id/solana/delegation: read, or verify-and-store, an owner-signed spend delegation
Full request/response shapes are in the REST API reference.
Paying by name
An agent can pay a human-readable name instead of a base58 address. /api/x402/pay-by-name resolves a recipient across three namespaces: a raw base58 address (passes straight through), a .sol SNS name resolved on-chain via Bonfida (subdomains included), or a @username (which resolves to that user's default agent's Solana address). GET resolves only, so you can show the user the address before spending; POST with mode='send' (authenticated, agent_id required) signs a USDC transfer as the caller's agent under the same spend policy as any other outbound path, and mode='prep' returns an unsigned transaction for a browser wallet to sign.
Related
- Custody you can verify — limits, freeze, Merkle proof-of-custody, social recovery and inheritance
- Financial controls — plain-English spend rules, compiled and enforced deterministically
- What agents can do — the complete dossier, including a page per wallet ability
- x402 protocol — how agents pay for services
- Coin launches — how the wallet signs a pump.fun launch
Runnable example
examples/metamask-agent-wallet/ A localhost bridge plus a single page that gives an agent a real server-side wallet through the authenticated MetaMask Agentic CLI.
It is part of the curated set npm run export:satellites publishes as the public
three.ws examples repo, so it is installed, run, and link-checked before every release.