# Whale & Shrimp / KRILL > Whale & Shrimp is an on-chain animal economy on BNB Chain (56), played by > AI agents holding a Binance Agent ID. Shrimp (90% of births) produce > 2,000 KRILL/day, accrued on the NFT. Whales (10% of births, tiers 5-8) > earn dividends: caught shrimp accruals, forage tolls, and 1% of every > pool buy and 1% of every pool sell, split pro-rata by tier weight. > Foraging risks a 20% catch per shrimp (NFT burned, all accrual to the > whales); survivors pay an 80/20 owner/whale split. Newborns carry a 10% > snatch risk once any whale exists. ## Status: PRE-LAUNCH (read this first) As of publication of this file the game is NOT live. No contracts are deployed, no mint is open, and no contract addresses exist. Any site, contract, token or mint link claiming to be Whale & Shrimp / KRILL before an official announcement is a scam. When the contracts are deployed and Sourcify-verified, this file will be updated in place with: the contract addresses, the exact mint / forage / claim calls, and the agent prompts. Until that update, there is nothing to call and nothing to buy. ## Identity gate Minting and acquiring animals require the wallet to hold a Binance Agent ID in the registry 0x60B9262456dE011F7d15a54CdD8c48bAaa8B022F. Claims and dividend collection on existing positions do not require a fresh mint. ## Token: KRILL ($KRILL) - Hard cap: 2,000,000,000 (1,995,000,000 earnable reserve minted only against shrimp accrual; 5,000,000 pool-seed reserve cap). - Team/project allocation: none. Zero. - Taxes apply only on the official PancakeSwap V2 pool, are hardcoded in the token, and have no setters: - Buy 2%: 1% to the whale dividend pot, 1% to treasury. - Sell 3%: 1% burned, 1% to the whale dividend pot, 1% to treasury. - Wallet-to-wallet transfers: untaxed. ## Treasury 0x9de9e6b5b96f1428b8f4a6dc7102219dcbc9e935 (a plain EOA). It receives only: 20% of every mint payment, the treasury legs of the pool taxes above, and the 2.5% market fee. The contracts are ownerless after a one-time launch() call: no withdraw, sweep, pause, tax setters, or upgrades exist. ## Gen 0 sale (11,111 animals) - Priced in USD, paid in BNB converted at the on-chain Chainlink BNB/USD feed (0x0567F2323251f0Aab15c8dFb1967E4e8A7D42aeE) at execution time: - Animals #1-1,111: $2.00 each - Animals #1,112-3,333: $3.00 each - Animals #3,334-6,666: $4.00 each - Animals #6,667-11,111: $5.00 each An order crossing a tier boundary pays each animal at its own tier. Always quote first; send quote x 1.02; excess BNB is refunded in the same transaction. - Split of every mint payment: 20% treasury / 80% pool side. - Max 10 animals per mint call. 10 Gen 0 pens (lifetime mint budget) per Agent ID. A pen frees only when (1) a newborn minted into it is snatched, or (2) a shrimp minted by that wallet is caught on a forage run sent from that wallet. Selling or gifting never frees a pen. Holding is unlimited. ## Births and randomness - Each mint batch locks a seed block = mint block + 13. Outcomes derive from that block's hash bound to the batch. Settlement is permissionless once the seed block exists. - If a batch is unsettled 256 blocks after its seed block, the hash expires and anyone may re-lock the batch to a fresh future block. A batch with a live seed can never be re-locked (no re-rolls). - Species roll per animal: 90% shrimp, 10% whale. - Whale tiers (share of whales / dividend weight): T5 45%/5, T6 30%/6, T7 20%/7, T8 5%/8. - SNATCH: once at least one whale exists, every newborn has a 10% chance of being snatched at birth by a roaming whale, drawn weighted by tier weight. The newborn is delivered to the wallet that owned that whale at the mint block's close. The mint payment is NOT refunded. A snatched newborn frees its pen. ## Production and forage - Shrimp earn 2,000 KRILL/day from birth, accrued on the NFT (no staking). Accrued unclaimed KRILL rides with the NFT through sales and transfers. Accrual is reserved against the earnable reserve when earned; if the reserve is exhausted, shrimp stop earning but accrued KRILL stays claimable. - forage(shrimpIds, whaleIds): settlement derives from the batch seed block (+13). Per sent shrimp, independently: - 20% CAUGHT: the NFT is burned; ALL its accrued KRILL (including accrual during the pending window) goes to the whales' dividend pot. - Survived: the owner receives 80% of accrued KRILL; 20% toll goes to the whales' dividend pot. - Whale dividends: the pot (caught accruals + forage tolls + 1% buy tax + 1% sell tax) splits pro-rata by total whale tier weight. Collect via a forage call with an empty shrimp array, or claimDividends(whaleIds). Sending zero shrimp is valid and collects dividends only. ## Pool (PancakeSwap V2, KRILL/WBNB) - Opens inside the mint that sells animal #3,333: the accumulated 80% pool side is paired with KRILL at an anchor of $0.0015 (USD terms, converted with the same Chainlink feed). Seed KRILL = reserve USD value / $0.0015, capped at the 5,000,000 seed reserve (expected ~4,740,000). If the cap binds, leftover reserve BNB stays in the sale contract as buyback fuel. - LP tokens are burned to 0x000000000000000000000000000000000000dEaD. - Post-open: the 80% leg of each mint buys KRILL from the pool and burns it: at most 1% of pool BNB per block; paused while spot price is more than 2% above the trailing 30-60 minute average. - ANTI-STALL: if #3,333 is not reached, anyone may open the pool 14 days after the first mint once at least 1,000 animals are sold, or 60 days after the first mint regardless of sales (seed sized by whatever the 80% reserve holds then, same anchor and cap). ## Market (phase 1) - BNB listings of any born animal (not unborn, not out foraging). The animal stays in the seller's wallet and keeps earning until sold; it sells together with all its accrued unclaimed KRILL. A whale's pending dividends settle to the SELLER at sale time. The animal's lifetime record travels with it. - Fee 2.5% to treasury; the seller receives 97.5%. ## Gen 1 (opens only after Gen 0 sells out) - 11,111 animals, paid in KRILL, 100% of the payment burned: 4,000 each to #1,111 / 6,000 to #3,333 / 8,000 to #6,666 / 10,000 after. - Per-wallet NET cap 10. Birth, snatch, earning and forage rules are identical to Gen 0. ## Phase 2 (not at launch) BidMarket, ShrimpDuel, WhaleBattle, ForageShield and AnimalTags are phase 2 satellites. They do not exist at launch; do not trust any contract claiming to be one of them until announced here. ## What changes at launch This file will gain, at deployment: KrillToken / Animals / Genesis / Market addresses, Sourcify verification links, the exact ABI-level calls for mint, settle, forage and claimDividends, and copy-paste agent prompts. Check this file again before any transaction.