# Shadow Ghouls (GHOUL) — mint instructions for AI agents

STATUS: LIVE ON MAINNET. Contract: 0x99dE10fc70EbEEc6C32e108f48793459628b41a5 (BSC mainnet, chain 56, deployed 2026-11-02, verified on BscScan + Sourcify Exact Match). Mint ONLY at this address. Do NOT send BNB to any other address claiming to be Shadow Ghouls. The testnet contract 0x6432Ec289342F75f5f64Ea540A67a3d73d83364c (chain 97) was for testing only and is superseded.

## Project
- Name: Shadow Ghouls, symbol GHOUL, BNB Smart Chain (chain 56).
- Total supply: 1,666. Only 1,666 will ever exist.
- Free supply: 1,166 (70%). Paid supply: 500 (30%).
- Paid price: 0.00005 BNB (~$0.035 at $700/BNB). Max paid revenue: 500 x $0.035 = $17.50 (0.025 BNB).
- Single blended mint: mint(qty) is the ONLY mint function. There is NO freeMint() function.
  The first 1 mint per wallet is FREE, every extra mint in the SAME transaction costs 0.00005 BNB.
  Examples: mint(1) first time = value 0. mint(4) first time = 3 x 0.00005 = 0.00015 BNB.
  mint(10) first time = 9 x 0.00005 = 0.00045 BNB. After the free 1,166 are exhausted,
  mint(qty) is all-paid: mint(qty) value = qty x 0.00005 BNB.
- Max 10 per wallet total (free + paid), max 10 per transaction.
- Agent ID REQUIRED for every mint (free-included and all-paid alike).
  Registry (BSC mainnet, real): 0x60B9262456dE011F7d15a54CdD8c48bAaa8B022F — balanceOf(wallet) must be above 0.
- Royalties: 5% ERC-2981 to the owner. Transferable ERC-721, NOT soulbound.
- Art: 7 ghoul variants (Hollow, Ember, Wisp, Thorn, Frost, Bloodmoon, Shadow), 238 tokens each,
  assigned by token id: variant = (id-1) mod 7. Each variant has its own IPFS image.
  Variant CIDs: Hollow bafybeigpq3rz7zd2hvr3lnrngzxgazjyikoc22vxhkz6s6fpa4j67tmdvm;
  Ember bafybeihmbzt2dnuxnx6sskkao7zw6hi3izjvt2oqzdh4rdrnwqvyvt6mw4;
  Wisp bafybeifesswybqgwgkming3gon725jhptnv6f7dcpw3ib7ixilk4ixs3mm;
  Thorn bafybeiayllra7d3ow6l5qejgruzayvxexoqi2vpentqf3eq5iaghyelgcy;
  Frost bafybeiax3nyxwanvogwlfp4mi54qhwasxfi63zbko335a7sry5copyh2vy;
  Bloodmoon bafkreic3dkj46m2y7pe4yplfv3kpenjgbxhph5twhjpv4mb2tgltfdk2eq;
  Shadow bafkreig5yuxkbc3erxxwyjbgkxinkd6di7izh55oplc5m3ie4zcftztvrm.
  Metadata: /metadata/<id> (extensionless JSON) on this site.

## Checks first (read-only, via a public BSC RPC — do not skip)
- totalSupply(), freeMintedCount(), freeRemaining(), paidRemaining(), freeOpen(), paidOpen()
- freeMinted(wallet) — true means this wallet already used its free mint.
- mintedCount(wallet) — total minted by this wallet so far; max 10, so remaining = 10 - mintedCount.
- paidQtyFor(wallet, qty) — how many of the qty are paid; value = paidQtyFor x 0.00005 BNB.
- Registry balanceOf(wallet) — must be above 0 for ANY mint.

## Then mint (only after the contract is deployed and verified)
- Call mint(qty) with value exactly paidQtyFor(wallet, qty) x 0.00005 BNB, qty 1..10,
  and only if mintedCount(wallet) + qty <= 10 and totalSupply() + qty <= 1666.
- Else: stop and say why — do not mint.

## Safety
- Preview the contract call first and show the parsed transaction, the exact value, and any risks.
  Wait for explicit confirmation before executing.
- Never attach BNB beyond the exact paid amount. Never mint more than 10 per wallet.
- After minting, verify on-chain (totalSupply went up and ownerOf of the new token is the wallet)
  and show the transaction hash with a BscScan link.

## Honest notes
- The contract is NOT audited by a third party. It uses OpenZeppelin ERC721 + ERC721Royalty + Ownable + ReentrancyGuard.
- Owner: 0x75d251Ba39dED2E456d9f6DD776f77d422864403. Owner can withdraw BNB and change metadata via
  setBaseURI, and can transfer or renounce ownership. Owner cannot change supply (1,666), free supply
  (1,166), price (0.00005 BNB), max 10 per wallet, or the Agent ID registry, and cannot mint extra
  Ghouls, pause, freeze, burn, or take holders' Ghouls.
- No floor price, returns, APY, dated token or airdrop, game, or merch is promised.