# 金库抢礼盒 Vault Boxes (VBOX) · 3D 像素金库盲盒 > Fully on-chain pixel constellation cards on BNB Smart Chain (chain id 56). Boxes come in waves of 1000 that all look identical; a box is claimed sealed and its rarity is drawn on-chain from a block hash that does not exist yet when the claim is sent. Claiming needs a wallet that holds a .ai Agent ID. Art (SVG) is generated by the contract. > 收藏品,不是投资,不承诺任何价值或收益。A collectible, not an investment; no promise of value or return. ## Status (read it live, do not trust this text for numbers) - Opening: startTime() = 1795006800 = 2026-11-18 21:00:00 Beijing (UTC+8) = 13:00:00 UTC. Before that every claim() reverts NotStarted and /pass answers not_started. started() tells you. - Live numbers: currentWave(), remaining() -> (wave, left), remainingCounts(wave) (rarities left in the pool), totalMinted(), soldOut(). ## Pages - Site (3D vault, needs WebGL): https://vaultboxes.pages.dev/ - Pass signer health: https://vaultboxes.pages.dev/health -> {"ok":true,"contract":"0xbCDD…e4D4","chainId":56} - This file: https://vaultboxes.pages.dev/llms.txt ## Contracts (BNB Smart Chain 56) - VaultBoxes (ERC721 + ERC2981, name "金库抢礼盒 Vault Boxes", symbol VBOX): 0xbCDD900857e5d8cc87C45764E61373CA1992e4D4 (Sourcify exact match) - VaultBoxesArt (renderer, pure): 0x53a7633784877D33DAeF19a3957F23853DbE47dD - Agent ID (SPACE ID .ai, required to claim): 0x60B9262456dE011F7d15a54CdD8c48bAaa8B022F (balanceOf(wallet) > 0) - Creator (receives payments + 1% royalty): 0x7e6465EaE3Bc8c162b36206581f40a7F88888888 - Public RPCs: https://bsc-rpc.publicnode.com, https://bsc-dataseed.bnbchain.org ## Supply, waves, prices (from the contract constants) - 10 waves x 1000 boxes = 10,000 total (MAX_WAVES 10, TOTAL_CAP 10000). The next wave opens in the transaction that claims the last box of the current wave. tokenId = wave*1000 + index (index 0..999). - Waves 1-2: free (gas only), 1 box per wallet per wave (FREE_LIMIT). - Wave 3+: 0.001 BNB per box (PRICE), or 0.0005 BNB (HOLDER_PRICE) if the wallet currently holds a box from any EARLIER wave (free or paid). Boxes of the current wave do not count; a box that was sold no longer counts. 3 boxes per wallet per wave (PAID_LIMIT). Payment goes to the creator in the same transaction. - Every wave has the same fixed pool: 1 Legendary / 9 Epic / 90 Rare / 900 Common (12 constellations, 83-84 each). Rarity codes: 0 Legendary, 1 Epic, 2 Rare, 3 Common. - Only externally owned wallets can claim (msg.sender == tx.origin). Sealed boxes cannot be transferred. ## ABI (human-readable, ethers v6) function claim(uint256 wave, uint256 index, uint256 deadline, bytes sig) payable function reveal(uint256 id) function revealPending(uint256 n) returns (uint256 opened) function startTime() view returns (uint256) function started() view returns (bool) function currentWave() view returns (uint256) function remaining() view returns (uint256 wave, uint256 left) function soldOut() view returns (bool) function hasAgentId(address wallet) view returns (bool) function hasEarlierBox(address wallet) view returns (bool) // true = half price in the current wave (wave 3+) function priceFor(address wallet) view returns (uint256) // wei for the current wave; 0 in waves 1-2 function priceAt(address wallet, uint256 wave) view returns (uint256) function limitFor(uint256 wave) pure returns (uint256) // 1 in waves 1-2, 3 after function mintedBy(uint256 wave, address wallet) view returns (uint256) function isClaimed(uint256 wave, uint256 index) view returns (bool) function claimedBits(uint256 wave) view returns (uint256[4]) // bit i = index i claimed function remainingCounts(uint256 wave) view returns (uint256[4]) // [legendary, epic, rare, common] still in the pool function pendingCount() view returns (uint256) // sealed boxes waiting in the relay queue function boxInfo(uint256 id) view returns (bool revealed, uint8 rarity, uint8 sign, uint256 slot, uint256 claimedAt, uint256 commitBlock, uint256 revealableFrom, bool expired) // rarity/sign 255 while sealed function tokenURI(uint256 id) view returns (string) // data:application/json;base64, sealed or opened card event BoxClaimed(address indexed to, uint256 indexed wave, uint256 indexed index, uint256 paid) event BoxOpened(uint256 indexed tokenId, uint256 indexed wave, address indexed opener, uint256 slot, uint8 rarity, uint8 sign, bool expired, bool relay) event WaveOpened(uint256 indexed wave) ## How an agent claims (only with the wallet owner's explicit approval for each transaction) 1. Checks (eth_call, free): started() == true; hasAgentId(wallet) == true; w = currentWave(); mintedBy(w, wallet) < limitFor(w); soldOut() == false. 2. Pick a free box: read claimedBits(w) and choose an index whose bit is 0 (or check isClaimed(w, index)). Position in the vault has nothing to do with rarity. 3. Get a pass (EIP-712 signature by the pass signer, bound to wallet + wave + index, short-lived): POST https://vaultboxes.pages.dev/pass content-type: application/json {"wallet":"0x","wave":,"index":<0..999>} 200 -> {"wallet":"0x","wave":w,"index":i,"deadline":,"sig":"0x<65 bytes>"} Errors (JSON {"error":code,"msg":...}): 409 not_started (also returns startTime) · 409 no_agent_id · 409 sold_out · 409 wave_closed (returns currentWave) · 409 already_claimed · 409 wallet_limit · 400 bad_wallet / bad_box / bad_json · 429 rate_limited (about 20 requests per minute per IP) · 403 human_check_failed (only if a human check is switched on). Only POST is accepted; GET /pass returns 404 not_found. 4. value = priceFor(wallet) (0 in waves 1-2). Simulate claim(w, index, deadline, sig) with eth_call from the wallet and that value; send only if the simulation succeeds and before deadline. msg.value must equal the price exactly. Gas is roughly 0.2-0.3M (the claim may also open up to 3 older sealed boxes); use eth_estimateGas. 5. The box is minted sealed: tokenId = w*1000 + index, BoxClaimed event. ## Opening (reveal) - Random source: hash of block (claim block + 1); not known when the claim is signed, so nobody can pick the result. The box takes the first unused pool slot at or after keccak256(hash, contract, id) % 1000, so pool counts are always exact. - Relay: every claim() first opens up to 3 of the oldest ready sealed boxes in the queue (never the caller's own). Usually your box is opened by the next claimers, at no cost to you. - Anyone may call reveal(id) from block claimBlock + 2 on (boxInfo(id).revealableFrom), or revealPending(n) to open up to n of the oldest ready boxes. Both cost gas only. - About 61 minutes rule: after 256 blocks the hash is read from the EIP-2935 history contract (8191 blocks, about 61 min at about 0.45 s blocks). If a box stays sealed longer than that, it opens as the most common rarity still left in its wave's pool (boxInfo.expired = true). Waiting never re-rolls a box. - After opening the card is a normal transferable ERC721 (constellation 0-11, rarity border, wave, box number and claim time in Beijing time). Marketplaces get an ERC-4906 MetadataUpdate. ## Errors (custom errors in VaultBoxes) NotStarted (before startTime) · NoAgentId (wallet has no .ai Agent ID) · OnlyEOA (called through a contract) · SoldOut (10,000 claimed) · WaveClosed (wave != currentWave) · BadIndex (index > 999 / unknown id) · AlreadyClaimed · WalletLimit · PassExpired (block time > deadline: get a new pass) · BadPass (pass not for this wallet/wave/index) · WrongPayment (value != price) · PayFailed · NotReady (reveal too early / nothing ready for revealPending) · AlreadyRevealed · Sealed (sealed boxes cannot be transferred). RPC errors (429, timeout): retry on another public RPC. A failed read means "unknown", not "no boxes". ## Rules - 1% EIP-2981 royalty. No token, no staking, no rewards, no buy-back. - Owner functions: setSigner (pass signer; address(0) would switch the pass check off) and setStartTime (only before the opening), plus standard Ownable ownership transfer. Prices, limits, supply and odds are constants; there is no pause and no withdraw. - 收藏品,不是投资,不承诺任何价值或收益。This is a digital collectible, not an investment; there is no promise of any value or return.