# AGENTS.md — Baby AGC (BAGC)

Repository-level brief for any agent working on this project. Read this first, then
`web/skill.md` for the mint interface and `web/llms.txt` for the human-readable guide.

## What this is

BAGC is a share-height mining token on BNB Smart Chain: 210,000,000,000 fixed supply,
0.002 BNB per share, 11 epochs of 150,000 shares, halving at every epoch border, plus
1,000 free seats for Binance Agent ID holders.

```
contracts/BabyAGC.sol          ERC-20, fixed supply, 2% pair tax, no mint after deploy
contracts/BabyAGCMinter.sol    shares, epochs, mode A / mode B / free lane, claims
contracts/interfaces/          Pancake V2 + Agent ID registry interfaces
web/                           static site (zh default, EN toggle), index + whitepaper
web/llms.txt                   agent-facing mint guide
web/skill.md                   selectors, calldata encoding, read word offsets, errors
scripts/compile.mjs            solc 0.8.24 build → build/
scripts/serve.mjs              static server on :8787, rooted at web/
```

## Status

**Deployed 2026-11-13 UTC on BSC mainnet.** Token `0xB0F0e625876898F19DE7d2B6451032350b29A7a1`,
minter `0x1Fe69924cEE21f4E888F60A8b3D4D652dFB63A37`, pair
`0x69B4C21707d3195F6FA7C2918118900D03d7173f`. Both contracts are owned by the BAW wallet
`0x55A484e4F0876C08Bfacda8Bf32a0703ecA1A482`; the deployment EOA keeps no role. Minting is
open. `web/js/config.js` holds the same addresses. Do not redeploy over these addresses.

## Hard rules

1. **No redeploy.** The contracts are live at the addresses above. Do not deploy new
   copies, do not overwrite `web/js/config.js`, and do not move supply between the
   constructor wallets.
2. **Chinese default, English toggle, no Indonesian.** Every user-visible string must be
   Chinese by default with an English counterpart in `web/js/i18n.js`. No Indonesian
   text anywhere — site, contracts, docs, comments, commit messages, placeholders.
3. **Say TREASURY / 金库, never "dev".** The fee wallet is the token treasury. Do not
   describe it as a developer wallet or explain a founder cut.
4. **Match the reference's menus.** The site mirrors agcc.fun's section list and layout;
   do not add sections the reference does not have (no blog, roadmap, FAQ blocks that
   are not there).
5. **Economics are fixed.** Mode A refunds 70% after 24 h, mode B locks LP for 14 days,
   both forward 30% to the treasury, free seats pay nothing but gas. Do not tune these
   numbers without an explicit instruction.
6. **Preview before write.** Any on-chain write must be shown to the user as function,
   target, value in BNB and wei, and expected reward before it is sent.

## Invariants to preserve

- `MAX_SUPPLY = 210e9 ether`, minted once in the constructor; no mint path afterwards.
- Pools: 84B mint base, 94.5B B reserve, 21B LP, 4.2B foundation, 6.3B marketing.
- `baseReward(e) = 280_000e18 >> e`, `bRewardBase(e) = 315_000e18 >> e`. Halving is a bit
  shift, so epochs 8–11 are fractional (2,187.5 / 1,093.75 / 546.875 / 273.4375). Never
  round these in a calculation; round only for display.
- `multiplier` caps at `5e18`; B reward per share is also paced to
  `reserveLeft * 1.25 / remainingShares`.
- `TREASURY_BPS = 3000` on `mintFree` and `mintPool`; `freeAgentMint` is value 0.
- `mintFree(uint256,address)`, `mintPool(uint256,address)`, `freeAgentMint(address)`,
  `claimFree(uint256[])`, `claimPool(uint256)` — the web copy button and both agent
  files must agree with these exact signatures.

## Before you change anything

- Recompile with `node scripts/compile.mjs` and regenerate the ABI if a signature moves.
- If a selector changes, update `web/skill.md`, `web/llms.txt` and the copy brief in
  `web/js/app.js` in the same change.
- Serve the site with `node scripts/serve.mjs`, then check both languages on index and
  whitepaper, the halving table's 12 rows (genesis + 11 epochs), and the console.
- `web/skill.md` and `web/llms.txt` are the contract for external agents. Keep them
  truthful: placeholders stay placeholders until deploy.

## Out of scope

- No deploy scripts, no key handling, no testnet deployment unless asked.
- No new npm dependencies; the contracts are self-contained and the site uses vendored
  ethers v6 UMD.