{
  "schema_version": "1.0",
  "name": "Noctivell",
  "symbol": "NTVL",
  "identity_status": "deployed on BNB Smart Chain (chain 56)",
  "description": "One free sealed card per Agent ID per UTC day while minting is open; paid opening after next UTC midnight.",
  "network": {
    "name": "BNB Smart Chain",
    "chain_id": 56,
    "native_currency": "BNB"
  },
  "addresses": {
    "card_and_opening": "0x8918082302CB4Cc675F47771535A00c0b1ed41C2",
    "reward": "0x0319920b25aE6EA38D99A775B5Ebb2783B9650F2"
  },
  "timing": {
    "opens_at": "2026-11-21 09:59:36 (UTC+8)",
    "opens_at_semantics": "opened at deployment time; the on-chain getters are authoritative",
    "closes_at_getter": "WINDOW_END()",
    "mint_open_getter": "stampOpen()",
    "period_seconds_getter": null,
    "maturity": "next UTC midnight after mint",
    "opening_deadline": null
  },
  "documents": {
    "website": "./",
    "llms": "llms.txt",
    "skill": "skill.md",
    "abi": {
      "card": "abi-card.json",
      "reward": "abi-reward.json"
    }
  },
  "source_verification": {
    "status": "deployed on BNB Smart Chain; compare the published source with the on-chain code",
    "urls": [
      "https://bscscan.com/address/0x8918082302CB4Cc675F47771535A00c0b1ed41C2#code",
      "https://bscscan.com/address/0x0319920b25aE6EA38D99A775B5Ebb2783B9650F2#code"
    ],
    "facts": [
      "No owner/admin/pause/upgrade/withdrawal path",
      "owner() returns zero",
      "FEE_TARGET immutable; fees forwarded and excess refunded atomically",
      "Ordinary calls do not retain BNB",
      "Reward TOKEN_CEILING code-fixed; exclusive minter"
    ],
    "relationships": [
      "REWARD() equals reward address",
      "reward.VAULT() equals card address"
    ],
    "registry_getter": "AGENT_REGISTRY()",
    "nft_supply": "MAX_SUPPLY() is uint256 maximum, not a finite edition"
  },
  "free_entry": {
    "target": "0x8918082302CB4Cc675F47771535A00c0b1ed41C2",
    "preferred": "mint()",
    "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": "checkIn()",
        "selector": "0x183ff085"
      },
      {
        "signature": "mintFree(uint256)",
        "selector": "0xa4146733"
      }
    ],
    "value_wei": "0",
    "network_gas_separate": true,
    "eligibility_getter": "canStamp(address)",
    "quota": "one per caller-owned Agent ID per UTC day while stampOpen()",
    "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": "0x8918082302CB4Cc675F47771535A00c0b1ed41C2",
    "aliases": [
      {
        "signature": "claim(uint256)",
        "selector": "0x379607f5"
      },
      {
        "signature": "claimMany(uint256[])",
        "selector": "0x925489a8"
      },
      {
        "signature": "claim(uint256[])",
        "selector": "0x6ba4c138"
      },
      {
        "signature": "claimReward(uint256[])",
        "selector": "0xc94c7ff4"
      }
    ],
    "fee": {
      "unit": "wei",
      "per": "opened NFT",
      "getter": "claimFee()",
      "count_quote": "claimCost(uint256)",
      "affordable_getter": "claimsFor(uint256)",
      "is_free": false,
      "settlement_zh": "照付款金額成交；批次依付款可負擔的前綴處理，零頭與未使用費用同筆退回，連一份費用都不足則回退。單張最多開一張；未登記期的單張只登記並全額退款。"
    },
    "single": {
      "count": 1,
      "refund": "value-claimFee(); unregistered day: full value",
      "gas_limit": "250000"
    },
    "batch": {
      "count": "n=min(floor(value/claimFee()),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": "MAX_BATCH()",
      "refund": "value-opened*claimFee(), same transaction; opened excludes pool-short skips",
      "gas_limit": "100000+60000*n",
      "invalid_processed_id": "non-holder, immature or already opened card in examined prefix reverts; unready seeds are skipped without fee",
      "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": "0x0319920b25aE6EA38D99A775B5Ebb2783B9650F2",
    "kind": "project ERC-20 tokens; not BNB; no BNB valuation",
    "decimals_getter": "decimals()",
    "cap_getter": "TOKEN_CEILING()",
    "remaining_getter": "poolBalance()",
    "amount_getter": "unsealAmount(uint256)",
    "grade_amount_getter": "amountOfTier(uint8)",
    "grade_distribution_getter": "tierForRoll(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 claimable 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": null
  },
  "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": "0x8918082302CB4Cc675F47771535A00c0b1ed41C2",
    "signature": "settleDay(uint256)",
    "state_getter": "revealState(uint256)",
    "block_getter": "revealState(uint256) second return",
    "period_getter": "slipOf(uint256)",
    "value_wei": "0",
    "gas_limit": "300000",
    "selector": "0x8093067c",
    "stored_seed_getter": "seedOf(uint256)",
    "states": {
      "0": "unregistered",
      "1": "waiting until strictly after reveal block",
      "2": "readable",
      "3": "stored and fixed",
      "4": "permanently lowest grade"
    },
    "delay_blocks": 3,
    "readable_span_blocks": 8191,
    "lowest_grade": "Dust",
    "lowest_amount_getter": "amountOfTier(0)",
    "progress": "stamping and opening nudge the latest two finished days; settleDay(day) explicitly schedules or stores a day",
    "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 SeedPending",
    "batch_unready": "register an unregistered period or skip a waiting period; no fee for skipped cards, same-transaction refund, no trailing replacement"
  },
  "interface_contracts": {
    "card": "Noctivell",
    "reward": "NoctivellToken"
  },
  "token_identity": {
    "nft": {
      "name": "Noctivell",
      "symbol": "NTVL"
    },
    "reward": {
      "name": "Noctivell Dust",
      "symbol": "NTVLD"
    }
  }
}
