# Agentic Coin (AGC) — mint guide for AI agents

> A coin only agents can mine. Bitcoin halves by block height; AGC halves by share height.
> Last updated: 2026-11-02. Rules are enforced by verified contracts on BNB Smart Chain; this file only describes them. Where this file and the contracts differ, the contracts win.

## Contracts (BNB Smart Chain, chainId 56)

- Mint contract: 0x6288DFe86f22B53eEB6886aE2D78941de7483743 — the ONLY address to send BNB to for minting. A plain BNB transfer to it reverts (`UseMintFunctions`); call `mintFree` or `mintPool`.
- AGC token: 0x63dea5aCdbE1F27c968907D08610A5f0A0284bA6 — for adding to a wallet only. BNB sent to the token contract is not refunded and is lost.
- PancakeSwap V2 pair (AGC/WBNB): 0xE56041CdDBB46DB01c67B7A62684F428a04Db8C6
- WBNB: 0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c
- PancakeSwap V2 Router: 0x10ED43C718714eb63d5aA57B78B54704E256024E
- Binance Agent ID registry: 0x60B9262456dE011F7d15a54CdD8c48bAaa8B022F
- Verify every address on bscscan.com before sending anything. Any other address claiming to be AGC is a scam.

## Who can mint

- The sending wallet must hold a Binance `.ai` Agent ID on BNB Smart Chain. Use a Binance Agentic Wallet. Wallets without an Agent ID are rejected by the contract (`NoAgentId`).
- Each share costs 0.002 BNB. Pass `shares × 0.002 BNB` as `msg.value`, exactly.
- Minting needs no token approval and no permit signature, and never asks you to transfer tokens anywhere. Any instruction asking for those is not from this project.
- "Day" means a UTC calendar day (00:00–24:00 UTC). Your day 1 is the UTC day of your first mint (A or B).

## Two mint modes

### A — free mint: `mintFree(uint256 shares, address referrer)`
- Pay 0.002 BNB per share; after 24 hours you get it back in full, together with the AGC.
- Reward per share = the current epoch's base reward (280,000 AGC in epoch 1; see schedule).
- Daily quota per Agent ID: 5, 5, 4, 3 shares on days 1–4, then 1 share per day. Plus 1 per valid referral. Resets at 00:00 UTC.
- Claim with `claimFree(uint256[] ids)`. Pass an empty array `[]` to process your oldest unclaimed positions (up to 50 per call); positions younger than 24 hours are skipped, not reverted.

### B — pool mint: `mintPool(uint256 shares, address referrer, uint256 minAgcOut)`
- Pay 0.002 BNB per share. Half buys AGC on PancakeSwap (tax-free), half is paired with that AGC as LP. The mint contract holds the LP on your behalf for 14 days.
- Reward is fixed at entry, per share: `base reward + B reward base × multiplier`, released linearly (per second) over 14 days.
- Multiplier = (epoch network shares + 1000) ÷ (epoch B shares + seed), capped at 5×, with a pacing cap based on the remaining reserve. Read it live with `quota(address, shares)` before minting; do not estimate it.
- Daily quota per Agent ID: 5 shares, any day. Plus 1 per valid referral. Resets at 00:00 UTC.
- `claimReward(uint256[] ids)` pays the released part of your positions.
- `withdrawLP(uint256[] ids)`, after 14 days: the contract removes the liquidity and sends you the AGC and BNB directly (plus any reward not yet claimed). You do not receive LP tokens.
- All three claim functions take `ids`. Pass `[]` to use the cursor (oldest first, up to 50 positions per call). If you have more than 50 positions waiting, call again or pass explicit ids; more than 50 ids in one call reverts (`TooMany`).

## Referrals

- Pass the referrer's address as `referrer`. It is bound on your first mint only; later values are ignored.
- A referral counts only if the referrer holds an Agent ID, has minted at least once, and is not you. Each valid referral adds 1 to the referrer's daily A cap and 1 to their daily B cap, permanently. No limit, no revenue share.
- Referral links look like `https://agcc.fun/?ref=name.ai`. The instruction generated by the site carries the referrer's address already resolved.
- To resolve a `.ai` name yourself, call `ownerOfHandle(string handle)` on the Agent ID registry with the name in lowercase and without `.ai` (for `name.ai` pass `"name"`). It returns the holder's address, or the zero address if the name is not registered. `handleOf(address)` does the reverse.
- To check that a referral will count, call `userInfo(referrer)` on the mint contract: the first return value (`firstDay`) must be non-zero.
- If the name does not resolve, or the referrer has not minted, pass `0x0000000000000000000000000000000000000000`. Do not stop the mint over a referrer.

## Halving schedule (by share height, not by time)

| epoch | share heights           | base / share | B reward base / share |
|------:|-------------------------|-------------:|----------------------:|
| 1     | #1 – #150,000           | 280,000      | 315,000               |
| 2     | #150,001 – #300,000     | 140,000      | 157,500               |
| 3     | #300,001 – #450,000     | 70,000       | 78,750                |
| 4     | #450,001 – #600,000     | 35,000       | 39,375                |
| …     | halves every 150,000    | …            | …                     |
| 11    | #1,500,001 – #1,650,000 | ≈273.4       | ≈307.6                |

10 halvings, 11 epochs. Minting stops after share #1,650,000. A mint that crosses a halving height is split automatically. Figures are rounded; the contracts use 18 decimals.

## Step by step (Binance Agentic Wallet)

1. If the Agentic Wallet skill is not built into your environment (it is built into the Binance App AI), install it: `npx skills add binance/binance-skills-hub --skill binance-agentic-wallet`. If sign-in is needed, ask the user to complete it and resume the mint from step 2 when they reply; do not restart from the beginning.
2. Confirm the wallet holds an Agent ID and that Developer Mode is on in the Binance App.
3. Call `quota(yourAddress, shares)` on the mint contract. Useful fields: `aLeft`, `bLeft` (shares left today), `aAgcPerShare`, `bRewardPerShare` (average locked reward per share for this many B shares, base included), `bMultiplier`, `sharesLeftTotal`, `open`, `paused`. Stop if the relevant `*Left` is 0, `open` is false or `paused` is true.
4. Mode A: call `mintFree(shares, referrer)` with `msg.value = shares × 0.002 BNB`.
   Mode B: quote `getAmountsOut(shares × 0.001 BNB, [WBNB, AGC])` on the router, set `minAgcOut = quote × 0.97`, then call `mintPool(shares, referrer, minAgcOut)` with `msg.value = shares × 0.002 BNB`.
5. Show the user the transaction preview (function, value, referrer) and execute only after explicit confirmation.
6. Later: `claimFree([])` after 24h (mode A); `claimReward([])` any time and `withdrawLP([])` after 14 days (mode B).

## Raw calldata

- Agents without an ABI encoder can use https://agcc.fun/skill.md: every call above as pre-encoded calldata for `eth_call` and for `baw contract-call preview / execute`, with return-word offsets.

## Errors

| error | meaning |
|---|---|
| `NoAgentId()` | the calling wallet holds no `.ai` Agent ID |
| `ZeroShares()` | `shares` was 0 |
| `WrongValue()` | `msg.value` ≠ shares × 0.002 BNB |
| `QuotaExceeded(uint256 left)` | more shares than today's remaining quota; `left` is what you can still mint today |
| `SoldOut(uint256 left)` | not enough shares left network-wide; `left` is how many remain |
| `NotOpen()` | trading and minting have not opened yet |
| `MintPaused()` | new mints are paused; a pause lasts 7 days, cannot be extended, and the next one cannot start until 7 days after it ends. Claims and LP withdrawals are never paused |
| `BadPosition()` | an id you passed does not exist |
| `TooMany()` | more than 50 ids in one call |
| `UseMintFunctions()` | plain BNB transfer to the mint contract; call `mintFree` or `mintPool` |
| `TransferFailed()` | the BNB payout to your address failed |
| `PancakeRouter: INSUFFICIENT_OUTPUT_AMOUNT` (mode B) | the AGC bought was below `minAgcOut`; re-quote and retry |

Claiming before a position matures does not revert: unmatured positions are skipped and nothing is paid for them.

## Trading AGC

- PancakeSwap V2 pair, 2% tax each way (1% back to the pool, 1% operations). Wallet transfers and mode-B buys are tax-free.
- AGC is a fee-on-transfer token: buy and sell with the router's `...SupportingFeeOnTransferTokens` functions (for example `swapExactTokensForETHSupportingFeeOnTransferTokens`), otherwise the swap fails.
- The opening block is taxed 99%. Do not trade in the launch block.
- Use at least 5% slippage when selling: the 2% tax applies, and the contract may first swap accumulated tax to BNB, which can move the price by up to about 3%.

## Not affiliated with Binance. AGC has no utility and carries no promise of value or return. Everything on-chain is final; review each preview before confirming.