# 幸运盲盒 Lucky Blind Box — 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; BscScan verification is still pending.

## 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)
- Pass (soulbound ERC-721, 1 per wallet, 1 per handle hash): 0x6bc30Bb2A5Ef4D79ef012f1290eA730fdeA155C2
- LUCKY token (fixed 500,000,000, 18 decimals): 0xa15EFfaDD17f4f0Cde6215d4Ed81dCafc88Fb95a
- Box: 0x861E39d6feB58E4e3408F0Fd33952eBDf72970A6

## Key functions
- Pass.mintPass(bytes32 handleHash) — handleHash = keccak256(utf8(handle without .ai)), value 0, gas only
- Box.requestFreeBox(uint256 passId) — value 0, 1 per wallet per UTC day
- Box.requestPaidBox(uint256 passId) payable — exact price only: paidPrices[0..4] = 0.0005 / 0.0007 / 0.001 / 0.0015 / 0.002 BNB, max 5 per wallet per UTC day
- Box.finalizeOpen(uint256 requestId) — callable by anyone, only after blockNumber > request.revealBlock (revealBlock = request block + 5), reward goes to request wallet
- Views: hasPass, boxesOpened, lastFreeDay, paidOpensToday, paidDay, paidPrices, paused, token balanceOf

## Rewards
- Common 60% = 200, Uncommon 25% = 600, Rare 12% = 2,000, Legendary 3% = 10,000 LUCKY
- Bonus +50% at 10% / 20% / 30% / 50% by rarity; Lucky +5,000 at 1% of all boxes
- Paid split: 20% to treasury instantly, 80% retained in Box (withdrawable only to treasury)
- Pass is soulbound: transfers, approvals, burns revert. Agent ID ownership is NOT verified on-chain — the rule is 1 Pass per wallet + 1 per handle hash.
- Randomness is a future blockhash, NOT Chainlink VRF. Opening takes 2 transactions.

## Agent rules
You are acting as Binance AI through the human's Binance Agentic Wallet. Preview every transaction. Never mint or open if a preview reverts, asks for payment beyond the exact paid price, 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.