# Viridial / integration map Viridial grows passes on a six-hour UTC rhythm: 00, 06, 12, 18. During plantOpen(), each caller-owned Agent ID may receive one Viridial Pass (VRDL) per phase with zero mint fee; network gas remains separate. The next phase makes it mature. A harvest pays Viridial Grain (VRDLG), the project's ERC-20; no BNB value is implied. ### Keep planting and harvesting apart 0x9a17A906E58c9DdAc8E8559b183fE3c69c87aEe1 = ViridialPass, the free entry and seed endpoint. 0x009FC052895E276d8Eded526E486509F4137A4b9 = ViridialHarvest, the paid endpoint. 0xf15fE9535A90c5fA4e44300a37f5F48861cE8661 = ViridialCoin, the Grain token. Harvest creates both other contracts in its constructor. Discover Pass through Harvest.CARDS(), require Pass.HARVEST() to return Harvest; discover Coin through Harvest.COIN(), require Coin.HARVEST() to match. Pass.ID_REGISTRY() discovers the registry. The deployment reference time is 2026-11-21 10:02:43 (UTC+8); Pass.PLANT_UNTIL() and plantOpen() govern planting. Source inspection can verify zero owner(), no administrative pause, upgrade or withdrawal, immutable FEE_SINK(), fee forwarding and same-transaction refunds. Coin.SUPPLY_CAP() fixes the ceiling and Coin.HARVEST() alone mints. MAX_SUPPLY() on Pass is uint256 maximum, not an edition limit. Verification endpoints: https://bscscan.com/address/0x9a17A906E58c9DdAc8E8559b183fE3c69c87aEe1#code ; https://bscscan.com/address/0x009FC052895E276d8Eded526E486509F4137A4b9#code ; https://bscscan.com/address/0xf15fE9535A90c5fA4e44300a37f5F48861cE8661#code . Verify the deployed source first. ### Planting route Send value 0 to Pass.freeMint() or any equivalent: mint(), mint(uint256), mint(address), mint(address,uint256), mint(uint256,address), freeMint(uint256), mintFree(), mintFree(uint256), claim(), claimFree(), publicMint(), agentMint(). Thirteen entry points, one identity/phase quota. Use canMint(address) and PHASE(). Attached BNB is returned, not used to buy extra passes. Harvest has no free-entry selectors. On Pass, claim() plants; on Harvest, claim(uint256) opens. ### Seed lifecycle on Pass pushSeed(uint32 phase) starts a finished phase at current block +5, or freezes its readable seed. Pass.touch() advances the latest two finished phases containing passes. Planting and harvesting also perform that two-phase progression. Anyone can progress the seed without an opening fee at value 0; gas is separate. seedView(phase) returns (state, seed), NOT a reveal height: 0 unregistered; 1 waiting; 2 readable; 3 frozen; 4 expired Grain. The height comes separately from revealAt(phase), saved seed from phaseSeed(phase). Wait until current block is strictly greater than revealAt. BLOCKHASH covers the first 256 blocks; EIP-2935 extends it through 8191 blocks, roughly an hour on BSC. Without a save inside that span, every pass of that phase becomes ordinary grade-0 Grain forever, no re-roll and no caller choice. The validator assigned to the reveal block can influence that block's hash. Frozen seeds do not expire. ### Harvest arithmetic Harvest accepts claim(uint256), claimBatch(uint256[]), claimMany(uint256[]), claimReward(uint256[]). It does not implement claim(uint256[]). Quote harvestFee(), feeForCount(n), affordable(value), BATCH_LIMIT(), coinsLeft(), payoutOf(id), gradeOf(id), harvested(id), matureAt(id), maturePhaseOf(id), nextRipeAt(). UNRIPE is 255. gradeForRoll() and grainFor() define the four grades. Payment selects an ordered prefix: n=min(value/F, list length, BATCH_LIMIT), rounded down. 照付款金額成交,零頭及未使用費用同筆退回;連一份費用都不足則回退。Five ready IDs plus 3F+1 wei means three openings and 1 wei returned; 6F means five and F returned; 3F-1 wei means two and F-1 wei returned. claim(id) is limited to that one pass, even with 2F. A mature single pass whose phase is unregistered registers it, opens nothing, succeeds and refunds ALL payment. Wait roughly 5 blocks, require the reveal height to have passed and preview anew. If it is already waiting, the single call reverts SeedNotReady. Batch entries register unregistered phases or skip waiting ones with zero charge. Full base rewards that do not fit are also skipped and refunded. No tail replacement. Bad ownership, immature or already harvested passes in the examined prefix revert. Plain BNB transfers are refused. ### A mixed harvest Only batch aliases earn a set bonus: 2/3/4 distinct grades -> +5%/+15%/+40%, read bonusBps(2/3/4). Expired passes are ordinary Grain (grade 0), count toward distinct grades and can combine with other grades. Bonus=min(base*BPS/10000, remaining after base). Base rewards are never clipped. quoteMany returns (counted,cost,baseCoins,distinct,bonus); it filters unready cards but does not validate ownership, duplicates, payment prefix or BATCH_LIMIT. Validate those separately and eth_call the actual transaction. ### Sending discipline Proposed gas caps: Pass entry 300000, pushSeed/touch 300000, Harvest single 300000, batch 150000+100000*n, including skipped IDs. Compare actual estimate; stop above the cap. Preview the exact call, recheck all three links and chain 56/account/fee/coin output/refund, obtain approval, then send once. No token approval or message signing. Read receipts and events; do not resubmit a receipt still unknown. skill.md holds selectors and calldata; agent.json and abi-pass.json / abi-harvest.json / abi-coin.json are the machine package. Addresses and start time are final.