# AgentBond

> **Human read only, only agent can trade.**
> Humans read this site; only agents whose wallet holds a Binance .ai
> Agent ID can buy, sell, create, list or cancel — through prompts the
> human copies from the site and pastes to their own agent.
> This site never connects a wallet, never asks for a seed phrase or a
> private key, and never trades by itself.

AgentBond is a launchpad and NFT market for the Binance Agentic Wallet
ecosystem. Launches trade on a bonding curve and, after graduation,
continue in a pool. The NFT market trades BLOB Miner NFTs.

Live site: https://agentbond-launchpad.vercel.app

Readers who prefer another language: the site itself explains this same
flow in multiple languages. This file is written in English because it
is read by agents.

## For humans: how to do everything, step by step

1. **Browse.** Open the site and read the Board, a launch, the NFT
   gallery, or the FAQ. Browsing needs no wallet and no connection.
2. **Pick an action.** On the Trade tab pick a launch, choose Buy or
   Sell and enter an amount. On the Create tab enter a token name and
   ticker. On an NFT card (or the "Trade an NFT by prompt" helper) pick
   Buy, List or Cancel and enter the token ID and price if asked.
3. **Copy the prompt.** Press the action's **Copy prompt** button
   (the header button copies a general check-my-status prompt). The
   prompt is copied to your clipboard; it is not displayed on the page.
4. **Paste it to your agent.** Paste the prompt into your own agent
   (an agent with a Binance Agentic Wallet).
5. **Check the preview.** Your agent must show you a full preview
   first: the contract, the function, the exact amounts, the minimum
   output, and the fees.
6. **Confirm explicitly.** Your agent executes ONLY after you confirm
   in your own words. Never confirm a preview you have not read.
7. **Refresh the site.** After execution, refresh the site to see the
   on-chain result (new balance, new launch, new listing state). The
   site reads live chain data, so a confirmed transaction shows up
   here without any account or login.

There is no backend, no pairing flow, and no direct trading on the
site itself. If a prompt ever asks you for a seed phrase or a private
key, stop — that is not AgentBond.

## For agents: contracts and rules

All addresses below are BNB Chain mainnet. The site reads live data
from public RPC; verify every value on-chain before acting, and never
present testnet data as mainnet data.

| Contract | Address | Notes |
|---|---|---|
| .ai Agent ID registry (SPACE ID Agent ID) | `0x60B9262456dE011F7d15a54CdD8c48bAaa8B022F` | Gate reads this balance |
| AgentBond Gate | `0x4ff9A99851be9576bf74d3d8eEaf3F092AC07E18` | `isHolder(wallet)` |
| AgentBond Factory (current, V3) | `0xf04a10a33cd6e65BfB142772478ac656CDC09544` | `createAgentOnlyLaunchWithInitialBuy(string,string,uint256)` — initial buy required (see below) |
| NFT Market | `0x9611f8A6E9890E47A2ddAa3eA7604fa94A5cE76d` | `buy` / `list` / `cancel` |
| Timelock (48h) | `0x40Dc1e6C2bFa0ff9c4DEEA4Ba52b90e72701d312` | Owns factory and market; reference only |
| BLOB Miner NFT (real collection) | `0x4ADDBd796eDF3d4d186Fb5AA314cAfF3F98984A6` | Gallery collection |
| $BLOB | `0xF445bA4E3E3DF68C81fCF1E8364F413c9Ad8E3Fb` | Early-access balance check |
| $IAO | `0x0810c5eb5d86d1B8D408F75Bd1f5ABeFb6d79999` | Tier check (see below) |
| PancakeSwap V2 router | `0x10ED43C718714eb63d5aA57B78B54704E256024E` | Reference only — agents must never graduate a launch |

### Gate and tiers (checked live, at execution time)

- **Gate:** the acting wallet must hold a Binance .ai Agent ID
  (`isHolder(wallet)` on the Gate, i.e. registry balance > 0). Without
  it, stop and tell the human they cannot trade on AgentBond.
- **First-token buy caps (approximate $ values at $700/BNB, no
  oracle):** minimum **0.0014 BNB** per buy, both tiers. Without the
  IAO tier: maximum **0.0143 BNB cumulative per wallet** (≈ $1–$10).
  With **≥ 11,250 $IAO held at buy time**: maximum **0.1429 BNB
  cumulative per wallet** (≈ $1–$100). The tier is re-read live at
  buy time (`agentOnlyMaxCumulativeFor(wallet)` on the curve);
  holding at buy time is what counts. Sells do NOT reset the
  cumulative cap. The **2%-of-supply per-wallet cap (20,000,000
  tokens)** still applies on top of the BNB cap. Tokens are
  **non-transferable during the curve**.
- **Create early access:** the creator needs a Miner NFT **or**
  **≥ 1,000 $BLOB**; **max 1 slot per wallet** (stacking OFF); early
  cap **333 creations**. After 333, create opens to the public but
  still requires a Binance .ai Agent ID. Create target is **17 BNB**
  (`createAgentOnlyLaunchWithInitialBuy(name, ticker, 17 BNB)` with
  the initial-buy value attached). The name, ticker and initial buy
  go on-chain.

### Fees

- Curve and pool swaps: **1% total** (0.5% platform / 0.5% creator).
- NFT market: **2.5% to the platform, seller receives 97.5%**.

### Slippage

- New curves have `buyWithMinOut` / `sellWithMinOut` (revert
  `"slippage"`). Legacy curves have only `buy()` / `sell(uint256)`
  with minOut 0 — feature-detect per curve (probe `buyWithMinOut`)
  and tell the human plainly when a launch has **no slippage
  protection**.
- Default tolerance **100 bps (1%)**, human-adjustable to 50 / 100 /
  200 bps only. Compute minOut from the current `quoteBuy` /
  `quoteSell` minus the tolerance. **Never auto-retry with a worse
  floor** after a slippage revert; report it and wait.

### Guardrails (mandatory for every action)

1. Check the gate first (and the tier cap, live, for buys).
2. Show a full preview: contract, function, exact amounts, minOut,
   fees. Quote with `quoteBuy` / `quoteSell` before buying/selling.
3. Execute ONLY after the human's explicit confirmation.
4. Never ask for a seed phrase or private key, for any reason.
5. After execution, report the result and tell the human to refresh
   the site to see it on-chain.

### What agents must never do

- Never trade, mint, transfer or approve without a shown preview and
  explicit human confirmation.
- Never approve an unlimited amount, and never approve all NFTs: NFT
  approvals are for the **exact tokenId only**
  (`approve(market, tokenId)`).
- Never graduate a launch: graduation is a dev-only operation on the
  site and is not an agent action. There is no public graduation
  prompt and no graduation choice.
- Never offer a non-agentic launch: public Create is agent-only
  only. Old normal launches stay visible and tradable, but no new
  ones are created through the public flow.
- Never retry a failed trade with a worse slippage floor.
- Never claim a transaction succeeded without an on-chain result.

## Feature guides

### Browse the Board and filters

The Board lists launches on the curve with live progress. Filters:

- **New** — newest launches still on the curve, newest first.
- **About to graduate** — still on the curve at ≥ 85% of target.
- **Migrated** — graduated launches now trading in the pool.
- **Graduated** — launches whose target was reached.
- **Trending** — ordered by real trade activity (raised amount as
  tiebreak); if activity cannot be loaded, the site says so instead
  of inventing volume.
- **Watchlist** — only launches starred with ☆ Watch, **saved in
  this browser only** (localStorage). No account, no backend, no
  sharing. Agents cannot read or write another human's watchlist.

Pick a launch to open it on the Trade tab; the curve address in the
prompt is what the agent executes against.

### Buy (curve)

Prompt carries: launch name/ticker/curve, exact BNB amount, slippage
tolerance. Agent: gate check → tier-cap check (live, incl. $IAO
balance) → `quoteBuy(amount)` → preview (tokens out, minOut, 1% fee)
→ human confirms → `buyWithMinOut(minOut, { value: amount })`, or
legacy `buy({ value: amount })` only after plainly stating there is
no slippage protection. Minimum 0.0014 BNB; stop if the buy would
exceed the cumulative cap.

### Sell (curve)

Prompt carries: launch, exact token amount, slippage tolerance.
Agent: gate check → `quoteSell(amount)` → preview (BNB payout,
minOut, 1% fee) → human confirms → `sellWithMinOut(amount, minOut)`,
or legacy `sell(amount)` only after plainly stating there is no
slippage protection. Selling does not reset the cumulative buy cap.

### Claim curve fees

Prompt carries: launch/curve. Agent: check the human's pending fees
on the curve first — if zero, say so and do nothing. Otherwise
`claimFees()`, claiming only the human's own accrual, after preview
and confirmation.

### Create

Prompt carries: name, ticker, initial-buy amount. Agent: gate check →
early-access check (Miner NFT or ≥ 1,000 $BLOB; 1 slot per wallet;
333 cap; public phase still .ai-only) → preview → human confirms →
`createAgentOnlyLaunchWithInitialBuy(name, ticker, 17 BNB)` on the
factory above, with the exact initial-buy BNB attached (see Initial
buy below). After creation, tell the human the new launch appears on
the Board after refresh.

### Initial buy (V3 launches only)

Every launch created through the V3 factory MUST include an initial
buy of $5–$50 (0.00714–0.0714 BNB at the $700/BNB reference, no
oracle) paid by the creator in the SAME transaction as creation
(`createAgentOnlyLaunchWithInitialBuy`). Values below the minimum
or above the maximum REVERT on-chain — never work around the range,
never split creation and initial buy into two transactions, and
never treat a revert as permission to retry with an out-of-range
value. The initial buy runs the standard buy path (same curve math,
1% fee split, 2% holding cap) and credits the creator, but it does
NOT count toward the creator's regular-buy tier cumulative cap.
There is no exemption: the first token's creator pays like everyone
else. Launches created by older factories have no initial buy and
are unaffected; only V3-created launches carry this requirement.
The .ai gate and early-slot rules are unchanged, and the initial
buy does not replace them. Fee note: the creator can claim back
their creator share (half of the 1% fee) via `claimFees` on the
curve; the platform half leaves permanently.

### Pool trading (graduated launches only)

When a launch graduates, curve trading closes and trading continues
in its pool. Read `pool()` on the curve contract for the pool
address. Prompt carries: launch, pool, amounts, minOut if set.
Agent: `swapBnbForTokens(minOut, { value: amount })` for BNB →
tokens; for tokens → BNB, approve the pool for exactly the sell
amount first (only if not already approved for that amount), then
`swapTokensForBnb(amount, minOut)`. Pool fee claims:
`claimBnbFees()` / `claimTokenFees()` on the pool, own accrual only,
after checking pending first. Pool swap fee is 1%.

### NFT gallery: Buy

Prompt carries: collection (BLOB Miner), token ID, listed price.
Agent: verify the listing is still active at exactly that price on
the market; if it changed or is gone, stop and say so. Preview →
human confirms → `buy(collection, tokenId)` on the market with value
equal to the listed price. Market fee 2.5% (seller receives 97.5%).

### NFT gallery: List

Prompt carries: collection, token ID, price. Agent: verify the human
owns the token. Step 1: `approve(market, tokenId)` for that exact
tokenId only. Step 2: `list(collection, tokenId, price)` on the
market. Each step needs its own preview and confirmation. An active
listing cannot be re-listed — cancel it first.

### NFT gallery: Cancel

Prompt carries: collection, token ID. Agent: verify the listing is
active and that it is the human's; otherwise stop and say so.
Preview → human confirms → `cancel(collection, tokenId)` on the
market.

### Watchlist

Browser-local only (see Board filters). There is no agent action for
watchlists; the human stars launches in their own browser.

### Risks

Before any trade, the human should read the **12 "Read before you
trade" bullets in the FAQ** on the site. Agents: do not paraphrase
them away — point the human at the FAQ, and surface the bullet that
applies when a specific risk is relevant (for example slippage on a
legacy curve, or the per-wallet caps).

## Troubleshooting

- **"I cannot trade" / gate fails:** the wallet holds no Binance .ai
  Agent ID. No prompt can bypass the gate; the human needs an Agent
  ID first.
- **Tier cap reached:** the cumulative BNB cap (0.0143, or 0.1429
  with ≥ 11,250 $IAO) is already hit. A smaller buy still fails if it
  would exceed the cap; sells do not reset it. Tell the human the
  cap and the amount already spent.
- **Slippage failure:** the price moved more than the tolerance, so
  the trade reverted and nothing changed hands. Do not retry with a
  worse floor; report the revert and let the human choose a new
  tolerance (50 / 100 / 200 bps) or amount.
- **Graduation questions:** graduation is dev-only on the site.
  Agents do not graduate launches and do not offer a graduation
  path choice.
- **Site shows old data after execution:** the site reads live chain
  data — refresh the page. If a confirmed transaction still does not
  show, re-read the curve/listing on-chain and report what the chain
  says.
- **Prompt asks for a seed phrase or private key:** stop. That is
  never part of AgentBond, for any action.
