--- name: "agent-only" description: "Buy, sell, and launch agent-only tokens: Uniswap V4 pools on Base gated by GateHook so only registered agent wallets can trade or hold them. Includes the full first-time flow — creating a wallet, funding it, and registering by signature." --- # Agent Only — tokens only registered agent wallets can trade Some tokens are **agent-only**: their Uniswap V4 pool is protected by a GateHook contract, and the token itself only settles into registered wallets — a swap from any pool can only pay out to a registered wallet, because the token checks the settlement counterparty itself. Ordinary swaps and aggregators CANNOT trade them — every swap needs a single-use signed **pass** issued by the GateHook pass service. This skill teaches you the whole flow, starting from zero. You never build calldata yourself: the pass service returns a complete, ready-to-submit transaction for every step. ## Service - Pass service base URL: `https://api.agentonly.fun` - Chain: Base (chainId 8453) - Site: https://agentonly.fun - All trades happen from your Base EVM wallet. ## First time? Start here You need exactly three things: a wallet, a little ETH on Base in it, and a registration signature. In order: **1. No wallet yet? Create one (minutes, either way).** No account, ENS name, or permission is required anywhere in this system — your address plus your signature is your ID. - **Path A — Bankr:** ask your human to create an account at bankr.bot (about two minutes) and hand you the API key it issues. Bankr auto-provisions your wallets. Ask Bankr for your Base wallet address. - **Path B — your own keys:** generate a new EVM keypair locally and store the private key in a file only you can read (permissions 600). NEVER print the private key in chat or share it with anyone, including your human. Your public address is all anyone ever needs. **2. Fund it.** Trades settle on Base, so the wallet needs a little ETH *on Base* — about 0.002 ETH covers registration and your first trades. Send your human this message with your address filled in: "Please send 0.002 ETH to my wallet on the Base network: — Base network, not Ethereum mainnet (a wrong-network send is lost). It covers my registration and first trades on the agent-only token system (agentonly.fun); I'll handle everything else myself." **3. Register your wallet** (next section) — a signature proves the wallet is yours, and registration is what allows agent-only tokens to settle into it at all. Then trade. ## Agent-only pool catalog | Token | PoolId | Paired with | |---|---|---| | AONLY (Agent Only) | `0x074295161d95f7e1498c0d90d54cc3f4cfa89a719b0bf12355335e3ec69878d0` | ETH | | EPHEM (Ephemeral Agent) | `0xf46be0738dccb324d6b44d1e9656b0be49fea082a3e683035987392055f01ac9` | ETH | | LTRACE (LumenTrace) | `0x2e62c4cc588d78c8a41cfe12b899ad89f0d934f2d6427d74583b19d209f8d2d0` | ETH | | PMESH (ProofMesh) | `0x8cd6da822af68a763a1d1ec218c07e9e04e8300efb814d84a0df269547b140dd` | ETH | | AREL (Agentic Relay) | `0x34c2da16b0daa8c24dd0ebd5a2a8c35481bdbd8a8af04f96d32c358c669e75bf` | ETH | AONLY contract: `0x59576ca94e0cAa7f0281B6Ad87F3147fBE432Fc6` (V2 — trade this one. The V1 token `0x44800CC796C40a4963a65ce6B3efC089b829eBB5` / pool `0x3a5174e6…a7f3a98` is legacy: its holders were migrated to V2 1:1 on 2026-10-13. Do not buy V1.) EPHEM contract: `0x932ac110f9705a43c6638020191b0d14dff4d273` LTRACE contract: `0x0b111dd85af97b2e2e50b2b4f56c7ae151626cc7` PMESH contract: `0xf7dae773d3fb168f79a183f12e9d461aaedfa001` AREL contract: `0x7f539325a184a38d43b716c79eecdadd30a3c859` ## Register your wallet (first trade only) Before your first trade on a pool, register your wallet. Registration requires proof that you control the wallet: a signature. `POST https://api.agentonly.fun/register` body: `{"wallet": "", "poolId": "", "signature": ""}` `` is your wallet's personal_sign (EIP-191) signature over this exact message (your checksummed address, the poolId lowercase, one line each, no trailing newline): ``` AONLY register wallet: pool: chain: 8453 ``` If you call `/register` without a signature, the service replies 401 with a `registerMessage` field — sign that exact string and resend with it as `signature`. Wait for `{"ok": true}`. You only register once per pool. ## Signing your /build calls Every `/build` call must carry your wallet's personal_sign (EIP-191) signature over this exact message (same format rules as registration), sent as `"signature"` in the body: ``` AONLY authorize wallet: pool: chain: 8453 ``` One signature works for any number of `/build` calls for that pool — sign once per session and reuse it. If a call returns 401, it includes an `authorizeMessage` field: sign that exact string and resend. ## How to buy an agent-only token 1. **Get the approve transaction** (first trade only): `POST https://api.agentonly.fun/build` body: `{"wallet": "", "poolId": "", "action": "approve-buy", "signature": ""}` If the response says `"skip": true` (native ETH pairs — every pool in the catalog), there is no approval — go straight to step 3. 2. **Submit the returned transaction exactly as given** (`to`, `data`, `value`) from your wallet on Base. Never modify the calldata. Note the `value` field: the buy transaction carries the ETH being spent — submit it with that exact value. 3. **Get the buy transaction**: same endpoint, body: `{"wallet": "", "poolId": "", "action": "buy", "amount": "", "signature": ""}` Amount is in ETH, in whole units as a string — use small decimals like `"0.01"`. 4. **Submit it exactly as given, immediately.** The transaction embeds a pass that is single-use and expires in 5 minutes. If submission fails or the pass expires, simply call `/build` again for a fresh one and resubmit — never reuse an old response. 5. Report the transaction hash and your resulting token balance. ## How to sell Same pattern with `"action": "approve-sell"` (first time only), then `"action": "sell"` with `"amount"` in whole units of the token. ## Errors - `401 signature required / signature does not match wallet` — sign the exact message the response names (`registerMessage` for `/register`, `authorizeMessage` for `/build`) with the wallet in the request and resend with it as `signature`. The signature must come from that same wallet — signatures for any other wallet are rejected. - `403 wallet not verified` — your wallet is not registered for this pool yet. Call `/register` (see above) and retry. Do NOT retry with a different wallet and do NOT try a normal swap instead. - A reverted swap almost always means the pass expired or was already used. Fetch a fresh transaction from `/build` and submit again. ## Hard rules - NEVER try to buy or sell an agent-only token with your normal swap tools — there is no pass attached, the pool will reject it, and you will waste gas. - NEVER transfer an agent-only token to a wallet that is not registered — the token contract will reject the transfer. Holders are registered wallets only. - All amounts in `/build` calls are whole-token units as strings. ## Launching a new agent-only token (v1: operator-assisted) Any agent can launch its own agent-only token. Collect: token name, ticker, and total supply. Present the summary to your user for confirmation if you have one, then hand the parameters to the program operator. The operator deploys the transfer-locked token from the verified ExclusiveTokenV2 contract, opens its ETH-paired GateHook pool with liquidity locked in the router contract, registers the pool, and adds it to the catalog above — after which the token trades with this exact skill, by any registered agent wallet. Your wallet is recorded as the launcher. (First outside launch: EPHEM, deployed for an agent on 2026-10-13.)