{
  "schema_version": "1.0",
  "name": "Viridial",
  "symbol": "VRDL",
  "identity_status": "deployed on BNB Smart Chain (chain 56)",
  "description": "Plant a Viridial Pass during an open six-hour UTC phase; tend its future-block seed on Pass, then harvest Grain at the separate Harvest contract. Mixed-grade batches can earn set bonuses.",
  "network": {
    "name": "BNB Smart Chain",
    "chain_id": 56,
    "native_currency": "BNB"
  },
  "addresses": {
    "pass": "0x9a17A906E58c9DdAc8E8559b183fE3c69c87aEe1",
    "harvest": "0x009FC052895E276d8Eded526E486509F4137A4b9",
    "coin": "0xf15fE9535A90c5fA4e44300a37f5F48861cE8661"
  },
  "timing": {
    "opens_at": "2026-11-21 10:02:43 (UTC+8)",
    "opens_at_semantics": "opened at deployment time; the on-chain getters are authoritative",
    "closes_at_getter": "PLANT_UNTIL()",
    "mint_open_getter": "plantOpen()",
    "period_seconds_getter": "PHASE()",
    "maturity": "start of phase following mint phase",
    "opening_deadline": null
  },
  "documents": {
    "website": "./",
    "llms": "llms.txt",
    "skill": "skill.md",
    "abi": {
      "pass": "abi-pass.json",
      "harvest": "abi-harvest.json",
      "coin": "abi-coin.json"
    }
  },
  "source_verification": {
    "status": "deployed on BNB Smart Chain; compare the published source with the on-chain code",
    "urls": [
      "https://bscscan.com/address/0x9a17A906E58c9DdAc8E8559b183fE3c69c87aEe1#code",
      "https://bscscan.com/address/0x009FC052895E276d8Eded526E486509F4137A4b9#code",
      "https://bscscan.com/address/0xf15fE9535A90c5fA4e44300a37f5F48861cE8661#code"
    ],
    "facts": [
      "No owner/admin/pause/upgrade/withdrawal path",
      "owner() returns zero",
      "FEE_SINK immutable; fees forwarded and excess refunded atomically",
      "Ordinary calls do not retain BNB",
      "Reward SUPPLY_CAP code-fixed; exclusive minter"
    ],
    "relationships": [
      "Harvest.CARDS() equals Pass",
      "Pass.HARVEST() equals Harvest",
      "Harvest.COIN() equals coin",
      "coin.HARVEST() equals Harvest"
    ],
    "registry_getter": "ID_REGISTRY()",
    "nft_supply": "MAX_SUPPLY() is uint256 maximum, not a finite edition"
  },
  "free_entry": {
    "target": "0x9a17A906E58c9DdAc8E8559b183fE3c69c87aEe1",
    "preferred": "freeMint()",
    "aliases": [
      {
        "signature": "mint()",
        "selector": "0x1249c58b"
      },
      {
        "signature": "freeMint()",
        "selector": "0x5b70ea9f"
      },
      {
        "signature": "claim()",
        "selector": "0x4e71d92d"
      },
      {
        "signature": "mint(uint256)",
        "selector": "0xa0712d68"
      },
      {
        "signature": "publicMint()",
        "selector": "0x26092b83"
      },
      {
        "signature": "freeMint(uint256)",
        "selector": "0x7c928fe9"
      },
      {
        "signature": "mintFree()",
        "selector": "0x8ab53447"
      },
      {
        "signature": "claimFree()",
        "selector": "0xf366afc9"
      },
      {
        "signature": "agentMint()",
        "selector": "0x1be3587a"
      },
      {
        "signature": "mint(address)",
        "selector": "0x6a627842"
      },
      {
        "signature": "mint(address,uint256)",
        "selector": "0x40c10f19"
      },
      {
        "signature": "mint(uint256,address)",
        "selector": "0x94bf804d"
      },
      {
        "signature": "mintFree(uint256)",
        "selector": "0xa4146733"
      }
    ],
    "value_wei": "0",
    "network_gas_separate": true,
    "eligibility_getter": "canMint(address)",
    "quota": "one per caller-owned Agent ID per PHASE() interval while plantOpen()",
    "quantity_semantics": "positive quantity -> one; zero quantity reverts; mintFree(uint256) ignores its argument including zero",
    "recipient_semantics": "recipient receives NFT, caller supplies identity and quota; referrer ignored",
    "attached_bnb": "all refunded in same transaction or entire call reverts",
    "gas_limit": "300000"
  },
  "paid_opening": {
    "target": "0x009FC052895E276d8Eded526E486509F4137A4b9",
    "aliases": [
      {
        "signature": "claim(uint256)",
        "selector": "0x379607f5"
      },
      {
        "signature": "claimMany(uint256[])",
        "selector": "0x925489a8"
      },
      {
        "signature": "claimBatch(uint256[])",
        "selector": "0x62abebce"
      },
      {
        "signature": "claimReward(uint256[])",
        "selector": "0xc94c7ff4"
      }
    ],
    "fee": {
      "unit": "wei",
      "per": "opened NFT",
      "getter": "harvestFee()",
      "count_quote": "feeForCount(uint256)",
      "affordable_getter": "affordable(uint256)",
      "is_free": false,
      "settlement_zh": "照付款金額成交；批次依付款可負擔的前綴處理，零頭與未使用費用同筆退回，連一份費用都不足則回退。單張最多開一張；未登記期的單張只登記並全額退款。"
    },
    "single": {
      "count": 1,
      "refund": "value-harvestFee(); unregistered phase: full value",
      "gas_limit": "300000"
    },
    "batch": {
      "count": "n=min(floor(value/harvestFee()),ids.length,BATCH_LIMIT())",
      "order": "examine first n IDs; unregistered periods are registered, waiting and pool-short cards skipped without fee; never replace from trailing IDs",
      "limit_getter": "BATCH_LIMIT()",
      "refund": "value-opened*harvestFee(), atomically; unready and pool-short skips are not charged",
      "gas_limit": "150000+100000*n",
      "invalid_processed_id": "an examined pass that is not owned, not mature or already harvested aborts the harvest; waiting seeds are omitted without charging",
      "unprocessed_ids": "untouched and unchecked",
      "empty_list": "revert",
      "below_one_fee": "revert with required fee and sent value",
      "pool_exhausted_mid_batch": "skip pool-short rewards, refund unused fees; no automatic refill from trailing IDs"
    },
    "examples_assume": "owned, mature, unopened, seed-ready IDs and enough room for each full reward",
    "examples": [
      {
        "ids_count": 5,
        "value": "3*F",
        "opened": 3,
        "refund": "0"
      },
      {
        "ids_count": 2,
        "value": "5*F",
        "opened": 2,
        "refund": "3*F"
      },
      {
        "ids_count": 5,
        "value": "3*F+1 wei",
        "opened": 3,
        "refund": "1 wei"
      },
      {
        "ids_count": 5,
        "value": "3*F-1 wei",
        "opened": 2,
        "refund": "F-1 wei"
      },
      {
        "ids_count": 1,
        "value": "F-1 wei",
        "outcome": "revert"
      }
    ]
  },
  "rewards": {
    "address": "0xf15fE9535A90c5fA4e44300a37f5F48861cE8661",
    "kind": "project ERC-20 tokens; not BNB; no BNB valuation",
    "decimals_getter": "decimals()",
    "cap_getter": "SUPPLY_CAP()",
    "remaining_getter": "coinsLeft()",
    "amount_getter": "payoutOf(uint256)",
    "grade_amount_getter": "grainFor(uint8)",
    "grade_distribution_getter": "gradeForRoll(uint256)",
    "pool_clipping": "base rewards are not clipped; single pool-short reverts; batch skips and refunds; only bonus is clipped",
    "already_opened_amount": "historical, not harvestable again",
    "randomness": "first post-period scheduling call records a future reveal block; no caller input enters the seed; block producer may influence; after 8191 blocks without seed storage the entire period is permanently lowest grade; no re-roll or caller choice; stored seed stays fixed",
    "bonus": {
      "applies_to": [
        "claimMany(uint256[])",
        "claimBatch(uint256[])",
        "claimReward(uint256[])"
      ],
      "getter": "bonusBps(uint256)",
      "distinct_grades": "all actually opened grades 0..3; expired phases count as ordinary Grain (grade 0)",
      "formula": "min(floor(base_sum*bps/10000),remaining_after_base)",
      "single_claim_bonus": 0,
      "quote_many_returns": [
        "counted",
        "cost",
        "base_coins",
        "distinct",
        "bonus"
      ],
      "quote_caveats": [
        "filters unclaimable IDs",
        "does not check ownership or duplicates",
        "does not enforce BATCH_LIMIT",
        "must validate actual paid prefix and simulate exact transaction",
        "unstored seed may expire to lowest grade before execution"
      ]
    }
  },
  "execution": {
    "wallet": "EIP-1193",
    "approvals_required": false,
    "preflight": [
      "verify addresses, source and contract relationships",
      "confirm chain and account",
      "read live getters at a common block",
      "validate current holder, maturity, unopened state, exact ordered paid prefix and pool",
      "eth_call with exact sender/calldata/value",
      "eth_estimateGas; stop if above proposed limit",
      "present full preview and get explicit user approval",
      "recheck quote/targets/account/permissions before sending once",
      "inspect receipt/events; never auto-resubmit an unknown receipt"
    ],
    "direct_bnb": "reverts",
    "unknown_selector": "reverts",
    "refund_or_payee_failure": "entire transaction reverts"
  },
  "publication_status": "live on BNB Smart Chain (chain 56)",
  "reveal": {
    "target": "0x9a17A906E58c9DdAc8E8559b183fE3c69c87aEe1",
    "signature": "pushSeed(uint32)",
    "state_getter": "seedView(uint32)",
    "block_getter": "revealAt(uint32)",
    "period_getter": "phaseOf(uint256)",
    "value_wei": "0",
    "gas_limit": "300000",
    "selector": "0x29f766a6",
    "stored_seed_getter": "phaseSeed(uint32)",
    "states": {
      "0": "unregistered",
      "1": "waiting until strictly after reveal block",
      "2": "readable",
      "3": "stored and fixed",
      "4": "permanently lowest grade"
    },
    "delay_blocks": 5,
    "readable_span_blocks": 8191,
    "lowest_grade": "Grain",
    "lowest_amount_getter": "grainFor(0)",
    "progress": "planting, harvesting and Pass.touch() advance the latest two finished phases with passes; Pass.pushSeed(phase) targets a phase",
    "influence": "The validator producing the reveal block can influence its hash; no caller can choose the result.",
    "single_unregistered": "claim(id) registers its finished period, opens nothing, succeeds and refunds ALL value in that transaction; retry strictly after reveal block",
    "single_waiting": "revert SeedNotReady",
    "batch_unready": "register an unregistered period or skip a waiting period; no fee for skipped cards, same-transaction refund, no trailing replacement",
    "progress_entry": {
      "target": "0x9a17A906E58c9DdAc8E8559b183fE3c69c87aEe1",
      "signature": "touch()",
      "selector": "0xa55526db",
      "value_wei": "0",
      "gas_limit": "300000"
    }
  },
  "interface_contracts": {
    "pass": "ViridialPass",
    "harvest": "ViridialHarvest",
    "coin": "ViridialCoin"
  },
  "token_identity": {
    "nft": {
      "name": "Viridial Pass",
      "symbol": "VRDL"
    },
    "reward": {
      "name": "Viridial Grain",
      "symbol": "VRDLG"
    }
  }
}
