# 硬币对决 FlipAi — machine-readable reference for AI agents

BSC Testnet only (chain 97). Mainnet contracts are NOT deployed. Contracts are verified on Sourcify (exact match) but unaudited.

## Safety first — official route only
Use this project only through the official Binance app: **Binance Agentic Wallet + Binance AI**. Never use a third-party wallet site, a lookalike app, or a link from an unknown source. Never share a seed phrase or private key with anyone — anyone asking for one is a scam. Check the contract address, function, and amount against the published addresses before signing anything.

## Contracts (BSC testnet)
- FLIP token (fixed 100,000,000, 18 decimals): 0xabAeCCbE823188d9dDBfCd325eB57fEDe1B3d54f
- CoinFlip: 0xC2213c31375E89b27A4B5a74faB4fa44095A8f5c

## Key functions
- CoinFlip.requestFlip(uint8 choice) payable — choice 0 = Heads, 1 = Tails; value EXACTLY 0.0002 BNB; max 10 flips per wallet per UTC day
- CoinFlip.finalizeFlip(uint256 flipId) — callable by anyone, only after blockNumber > flip.revealBlock (revealBlock = request block + 5); payout and FLIP reward go to the request wallet
- Views: flips, flipsToday, flipDay, consecutiveWins, openExposure, paused, nextFlipId, token balanceOf

## Odds and rewards
- 50% win: payout 0.00032 BNB total (1.6x the bet, stake included). 50% lose: bet lost.
- Player expectation −0.00004 BNB per flip — a 20% house edge, which accrues in the contract bankroll. Withdrawals to the treasury must leave at least 0.02 BNB in the bankroll.
- Every flip earns FLIP from the 60,000,000 reward pool held by the CoinFlip contract: 500 FLIP on a win, 50 FLIP consolation on a loss, +2,000 FLIP on a 3rd consecutive win (streak resets on a loss, and resets after the bonus is paid). Pool lifetime: about 143,000 flips at ~418 FLIP per flip on average.
- Open flips are capped: total potential payout of pending flips must stay under 25% of the bankroll balance.
- Randomness is a future blockhash, NOT Chainlink VRF. Flipping takes 2 transactions.
- FLIP supply is fixed at 100,000,000 (60,000,000 pool / 40,000,000 treasury); no mint after deploy, no tax.

## Agent rules
You are acting as Binance AI through the human's Binance Agentic Wallet. Preview every transaction. Never flip if a preview reverts, asks for payment beyond exactly 0.0002 BNB, or asks for an approval. Never ask for or share a seed phrase or private key. Report the transaction hash for every step. Read skill.md for the full procedure.