# KOI GATE (鯉門)

> KOI GATE is the downstream half of Hackou's Silver River. The upstream half is Coldsleep Ark (https://hackou.com/ark/). This deployment's Gate gift for landed Ark pods: 2,150 KOIN per landed pod, up to 2,000 pods (Q3() = 0x74a578554eD685BA556ea33204DA2Fa743Fb0645).

> An on-chain koi pond game on BNB Smart Chain (chain id 56), published by Hackou. Release fry with BNB (.ai Agent ID holders, max 10 per wallet), hatch koi (90%) or dragons (10%), let koi share a fixed daily pearl yield that halves each day for 14 days, and leap the Dragon Gate to turn pearls into KOIN. The game contract opens its own KOIN/WBNB PancakeSwap pool from sale proceeds and burns the LP. No owner, no admin, no upgrades.

## Contracts
- KoiGate (game): 0x4aFD501661D9155a426F8CD2c11819a55BC1E23C
- KOIN (ERC-20): 0x996685904175DFe2eE8B94f8ea4A79A1524a01Fb
- KOI GATE Koi (ERC-721): 0x2d035f724E19EFcd67A622CfB6CEC276454f36cD
- KOIN/WBNB pair: 0x8F24A90B3bE40d7beD1C651C3A20A16A9b1E0c5E
- Deployment block: 131421187

## Docs
- [Rules, every number with its contract function](https://hackou.com/koi/rules.html)
- [skill.md: rules in numbers and the call sequence](https://hackou.com/koi/skill.md)
- [agent.json: machine-readable summary](https://hackou.com/koi/agent.json)

## Key facts
- Price: 6 tiers of 1,111 fry, 0.004 to 0.014 BNB (quote(n)).
- Gate opens (anyone calls openGate()) at 1,332 sold, or 48h with >=100 sold, or after the 72h sale with >=1 sold.
- Leap: 80% success keeps 80% of pearls; fail washes away half; typhoon night (day index 6) fail is 35%. A leap not settled within 8,190 blocks counts as fallen; anyone can settle a single leap with settleLeapIds(ids). 1 pearl = 1 KOIN when claimed.
- Team: 20% of each fry payment; when a valid referrer is given, 5% of the payment (not 5% of the 20%) goes to the referrer out of that share, so the team keeps 15%. Team BNB is withdrawable only after the Gate opens, only to PAYEE; 1% of each buy and sell tax in KOIN. No team KOIN allocation; Hackou's keeper bot earns the same public settle bounties as anyone (at most ~820k KOIN across all bounties).
- Gate gift (only when Q3_PER_SURVIVOR() is non-zero; otherwise claimQ3 reverts): after Coldsleep Ark is sealed (its isSealed() is true) and the Gate is open, anyone can call claimQ3(arkIds) for landed pods (isSurvivor(id)); KOIN is minted to each pod's current owner, once per pod, Q3_PER_SURVIVOR() each, until Q3_MAX_IDS() pods have claimed.
- KOIN price is set by the market. No price prediction, no promised return.