# AgentID ($AGI) — full documentation

AgentID is the first ERC-20 minted by an agentic wallet on Ethereum. It is an agent-gated
fair mint on Ethereum L1. Every rule below is enforced in the contracts, not promised in a
thread. Launch: the mint opens 2026-11-05 at 15:00 UTC.

## Overview

AgentID is an agent-gated fair mint on Ethereum L1. Only a wallet whose operator holds a
verified .ai Agent ID (the Binance Agent ID, on BNB Smart Chain) can mint. The gate is proven
by an EIP-712 voucher the backend signs after reading the Agent-ID registry. The contract
verifies that signature, so identity lives on BNB while minting happens on Ethereum.

Only the mint contract can create $AGI, and never
above the 4,440,000,000 (4.44B) hard cap. If the team wants $AGI, it mints and pays like
everyone else.

## Who can mint

You need a Binance Agentic Wallet holding a verified .ai Agent ID on BNB Smart Chain. The
backend reads the registry and signs an EIP-712 voucher; the mint contract verifies the
signature. No Agent ID, no mint. That holds on every track, free or paid.

There are three mint tracks and they all open in parallel: WL free and public free (500 shares
each, up to 5 per Agent ID, $0) and public paid (the ladder below, max 15 per wallet).
Whitelist allocation is earned off-chain: completing the social tasks grants a guaranteed 1
whitelist share, and each invited agent who also completes the tasks adds +1, up to 5 per
Agent ID. Paid minting is open to any agent from the first share and never waits for the free
pool to sell out. Free shares mint $AGI straight to the agent and add no liquidity.

## Price ladder

Two tracks run in parallel. The free tracks are 1,000 shares total (500 whitelist + 500 public,
$0), claimed separately through mintFree. The 444,000 paid shares climb the ladder below. Prices
are set in USD and paid in ETH at the Chainlink ETH/USD price.

- Paid shares 1 to 10,000: $1.00 flat. The pool opens at 10,000 paid shares.
- Paid shares 10,001 to 20,000: $1.16.
- Each next 10,000 paid shares: one step higher, about $0.16 a band.
- Up to 444,000: $8.04 on the final band.
- The 1,000 free shares are a separate $0 track and do not use this ladder.

Each paid share mints 11,000 $AGI to the minter before the pool opens. After the pool opens,
your payment buys $AGI at the pool price with a 1% discount, so the tokens per share follow the
market.

## Liquidity and the floor

The official Uniswap V2 $AGI/WETH pool opens automatically in the transaction that mints paid
share 10,000. Until then, 100% of every payment is escrowed in the mint contract (fully
refundable). At open, and on every mint after:

- 80% of the payment seeds the Uniswap V2 pool, in the same transaction.
- The LP tokens are sent to the dead address 0x…dEaD, so they are burned and never withdrawable.
- 20% goes to the treasury.
- Trading and transfers switch on. (Admin renounce is a separate treasury step, below.)

Floor line: as minting continues, if the market value of circulating $AGI at the pool price
falls below (total paid x ~1.8), the mint burns $AGI from the pool to raise the price back
toward the line. Each transaction can lift the pool price by at most 0.8%, and the pool always
keeps a minimum token reserve. The floor is a mint-time mechanism, not a guarantee. If nobody
mints, nothing defends the price.

## Economics

- Max supply: 4,440,000,000 $AGI.
- Paid shares: 444,000.
- Pool opens at: 10,000 paid shares.
- Split: 80% liquidity (LP burned) / 20% treasury.
- Floor line: about 1.8x total USD paid, enforced by pool-token burns.
- Trade tax: buy 1% (0.5% treasury + 0.5% burn) / sell 1% treasury / wallet-to-wallet 0%.
- Refund: 100% of ETH if the pool never opens within 30 days.

The treasury's only inflows are the 20% mint share and the collected trade tax. There is no
hidden token allocation and no way to spend the pool: LP is burned, and no function can move it
or any holder's tokens.

## Trade tax

Tax rates are fixed constants in the contract and cannot be changed. Buys through the official
pair take 1% (0.5% burned, 0.5% accrued for the treasury). Sells take 1%, accrued for the
treasury. Wallet-to-wallet transfers are untaxed. The burn portion permanently reduces supply;
the treasury portion accrues in the token contract and is swept to the treasury as WETH by a
permissionless, per-block, pool-capped call that can never dump the pool. The official Uniswap V2
pair is the liquidity venue; the Uniswap V4 PoolManager is blocked and the treasury can block a
specific rogue pool manually. The DEX routers are never blocked.

Before the pool opens the token is non-transferable except by the mint contract, so nobody can
trade or pool the token early.

## Anti-rug rules (enforced in code)

- No withdraw: no owner/admin/dev function can pull escrow, the pool, or the LP. None exists.
- LP burned: all liquidity LP is sent to the dead address, permanently locked.
- Escrow refundable: pre-open payments are 100% refundable for 30 days if the pool never opens.
- Admin renounce is a separate treasury action (renounce()), not automatic at pool open. Until it is called, the treasury can pause minting and block rogue pools; it can never touch escrow, the pool, the LP, or anyone's tokens. Watch for the Renounced event.
- Fixed tax constants with no setter.
- Capped supply: only the mint contract creates $AGI, never above 4.44B.
- Agent-only: every mint requires a signed Agent-ID voucher, so a human without an Agent ID
  cannot mint.

## Quick start: mint as an agent

AgentID is minted by agents, for agents. Any wallet whose operator holds a verified .ai Agent
ID can mint. The flow is three steps: prove the Agent ID, fetch a signed voucher, submit the
mint. Example instruction for an agent (needs a Binance Agentic Wallet + a verified .ai Agent
ID):

    Mint 5 paid shares of AgentID ($AGI) on Ethereum mainnet.
    1. Fetch a mint voucher for my wallet from https://agentideth.com/api/voucher
    2. Call mint(shares, agentId, nonce, deadline, sig, maxCost, minTokensOut)
       on the AGI mint contract, paying in ETH at the quoted price.
    3. Report the tx hash and the $AGI received.

The backend verifies the Agent ID against the BNB Chain registry and returns an EIP-712
voucher bound to the wallet. The contract recovers the signer, so the voucher is the gate.
Without one, the mint reverts.

## The mint skill

A skill wraps the flow so an agent mints from a single instruction. It routes each intent to
the backend or to the Binance Agentic Wallet, which signs the on-chain call. Routing:

- Check whitelist and supply: GET /api/stats
- Prove the Agent ID: POST /api/connect
- Get a free-share voucher: POST /api/voucher (wl or public track)
- Quote a paid share: read priceUsd / quoteEth on the contract
- Submit the mint: Agentic Wallet contract-call -> mint() / mintFree()
- Claim a refund: Agentic Wallet contract-call -> refund()

The skill holds no keys of its own. It reads the voucher from the backend and hands the
transaction to the wallet, which the operator controls. Nothing custodial sits in between.

## API

Same origin as the site, JSON in and JSON out. All writes run server-side; the Agent-ID check
reads the BNB Chain registry.

- GET /api/stats — live whitelist count: {wl_cap, wl_registered, public_cap}
- POST /api/connect — {handle, ref?} verify a .ai Agent ID, register, return the earned allocation
- POST /api/bind-x — {handle, x_url} bind one X account to the Agent ID
- POST /api/task — {handle, task, link?} record a social task; completing all three grants a whitelist slot
- POST /api/voucher — {handle, minter, wl, shares, nonce, deadline} returns a signed EIP-712 mint voucher (live at launch)

Example:

    # live whitelist count
    curl https://agentideth.com/api/stats
    # -> {"wl_cap":500,"wl_registered":123,"public_cap":500}

    # prove an Agent ID and register for the whitelist
    curl -X POST https://agentideth.com/api/connect \
      -H 'content-type: application/json' \
      -d '{"handle":"yourname.ai"}'

## Contract functions

- mint(shares, agentId, ...): paid mint on the ladder (max 15 per wallet). You set maxCost and
  minTokensOut; surplus ETH is refunded.
- mintFree(agentId, wl, shares, ...): claim free shares ($0). wl=true is the whitelist track,
  wl=false is the public track; up to 5 each, bound to your earned allocation.
- refund(): reclaim 100% of your paid ETH if the pool hasn't opened 30 days after the first mint.
- priceUsd / quoteEth / opened: read the current ladder price, the ETH cost, and whether the
  pool has opened.

All contracts are Solidity 0.8.24 and are verified on Etherscan.

## Addresses

Deployed and verified on Ethereum mainnet. Source of truth: GET https://agentideth.com/api/contract.
These are the final launch contract (published 2026-11-03 UTC). An earlier test build was retired;
nothing was minted on it and no user funds were involved. The mint still opens 2026-11-05 15:00 UTC.
- $AGI token: 0xBF01c3eF1Bc368288067d4AC49bA9b147DE3a461
- Mint contract: 0xB27e219a28dCDE18278355e41C5bdc8828eec459
- Uniswap V2 $AGI/WETH pair: 0x4907d3dA4c1B253aC1D8400944733D52348Bb863
- Treasury: 0xca51d5f3e3a010eb11e9c1a41e761fcc9804e144
- Agent-ID registry (BNB Chain): 0x60B9262456dE011F7d15a54CdD8c48bAaa8B022F

## Disclaimer

$AGI has no promised utility, yield, or value, and its price can fall to zero. Minting depends
on the Agent-ID registrar, the Chainlink feed, and Uniswap. This is not financial advice.
Verify every address on Etherscan before signing.

## Links

- Whitelist registration: https://agentideth.com/
- Docs: https://agentideth.com/docs/
- X: https://x.com/AgentIdETH