{
  "schema_version": "1.0",
  "name": "Cinnavault",
  "symbol": "CNVLT",
  "publication_state": "live",
  "network": {
    "name": "BNB Smart Chain",
    "chain_id": 56,
    "currency": "BNB"
  },
  "contract_names": {
    "collection": "CinnavaultSeals",
    "claims": "CinnavaultVault",
    "reward": "CinnavaultShard"
  },
  "token_metadata": {
    "collection": {
      "name": "Cinnavault Seals",
      "symbol": "CNVLT"
    },
    "reward": {
      "name": "Cinnavault Shard",
      "symbol": "CNVLTS"
    }
  },
  "canonical_contracts": {
    "collection": "0x20744dE03186789Ff15D2901d788cDF11a059B46",
    "claims": "0xdA90dF250242215DB85aCE5AbCf13aeD9aFff5Cf",
    "reward": "0xf42b5556d1FB548Aec06756b1Fc07683aE95416e"
  },
  "abi": {
    "CinnavaultVault": "abi/CinnavaultVault.json",
    "CinnavaultSeals": "abi/CinnavaultSeals.json",
    "CinnavaultShard": "abi/CinnavaultShard.json"
  },
  "source_links": {
    "collection": "https://bscscan.com/address/0x20744dE03186789Ff15D2901d788cDF11a059B46#code",
    "claims": "https://bscscan.com/address/0xdA90dF250242215DB85aCE5AbCf13aeD9aFff5Cf#code",
    "reward": "https://bscscan.com/address/0xf42b5556d1FB548Aec06756b1Fc07683aE95416e#code"
  },
  "opened_at": "2026-11-21 12:59:46 (UTC+8)",
  "verification": {
    "recipient": "PROCEEDS()",
    "registry": "IDENTITY_BOOK()",
    "identity": "identityKey(address)",
    "registry_address": "0x60B9262456dE011F7d15a54CdD8c48bAaa8B022F",
    "reward_address": "DISTRIBUTOR().SHARD()",
    "reward_minter": "reward.ISSUER() == claims",
    "claim_address": "collection.DISTRIBUTOR(); verify claims.SEALS() == collection",
    "bnb_flow": "Seals remits the filled slots to PROCEEDS and sends unspent wei back atomically; Vault is for Shard claims and rejects plain BNB."
  },
  "permissions": {
    "owner": "owner() == address(0)",
    "admin": false,
    "upgrade": false,
    "pause": false,
    "withdrawal": false,
    "token_approvals_required": false
  },
  "read_first": {
    "opens": "saleStarts()",
    "closes": "saleEnds()",
    "utc_day": "dayNumber()",
    "reset": "tollResetAt()",
    "entry_ready": "tollReady(address)",
    "paid_left": "gildedLeft(address)",
    "fee": "tollFee()",
    "paid_price": "gildedPrice()",
    "paid_quote": "previewBuy(address,uint256)",
    "entry_quote": "quoteTollValue(address,uint256)",
    "batch_cap": "BUY_BATCH()",
    "wallet_cap": "GILDED_PER_WALLET()",
    "entry_cap": "PLAIN_CAP()",
    "daily_cap": "PLAIN_PER_DAY()",
    "paid_cap": "GILDED_CAP()"
  },
  "paid_entry": {
    "target": "0x20744dE03186789Ff15D2901d788cDF11a059B46",
    "price_getter": "gildedPrice()",
    "quantity_price_getter": "priceOf(uint256)",
    "source_launch_reference_bnb": "0.001",
    "entries": [
      {
        "signature": "mint(uint256)",
        "selector": "0xa0712d68"
      },
      {
        "signature": "mint(uint256,address)",
        "selector": "0x94bf804d"
      },
      {
        "signature": "receive()",
        "calldata": "0x"
      }
    ],
    "settlement": "The paid ledger fills floor(value/gildedPrice) slots, clipped by BUY_BATCH, gildedLeft and inventory; argument qty does not fix the delivered count. Unused BNB returns during execution.",
    "ordinary_fallback": "When the paid ledger can fill no slot, a live Plain slot may take tollFee instead. Preview quantity 1 can therefore describe Plain: classify with tollReady and quoteTollValue before simulating.",
    "availability": "The paid ledger operates throughout the sale independently of Plain daily availability, within its own stock and wallet allowance."
  },
  "fee_entry": {
    "target": "0x20744dE03186789Ff15D2901d788cDF11a059B46",
    "fee_getter": "tollFee()",
    "zero_value": "reverts",
    "source_launch_reference_bnb": "0.0001",
    "reference_is_not_live_quote": true,
    "entries": [
      {
        "signature": "mintFree(uint256)",
        "selector": "0xa4146733"
      },
      {
        "signature": "mintFree()",
        "selector": "0x8ab53447"
      },
      {
        "signature": "mint()",
        "selector": "0x1249c58b"
      },
      {
        "signature": "freeMint()",
        "selector": "0x5b70ea9f"
      },
      {
        "signature": "freeMint(uint256)",
        "selector": "0x7c928fe9"
      },
      {
        "signature": "claim()",
        "selector": "0x4e71d92d"
      },
      {
        "signature": "claim(uint256)",
        "selector": "0x379607f5"
      },
      {
        "signature": "claimFree()",
        "selector": "0xf366afc9"
      },
      {
        "signature": "publicMint()",
        "selector": "0x26092b83"
      },
      {
        "signature": "agentMint()",
        "selector": "0x1be3587a"
      }
    ],
    "ignored_arguments": "The daily key belongs to the caller. Passing a numeric ID does not select another holder.",
    "availability": "Plain admission is limited by Agent ID and UTC date; tollReady(caller) must be true for its daily seal.",
    "settlement": "A live Plain slot consumes tollFee first. Any balance is exchanged for paid editions at gildedPrice. Without a Plain slot the payment buys only paid editions. All unspent wei return to the sender; no seal means a revert."
  },
  "settlement_zh": "照付款金额成交。付款能买几枚就给几枚（受每日额度、每钱包上限、单笔上限与剩余量限制），不足一枚的零头与被上限截掉的部分在同一笔交易退回；连一枚都买不起时才 revert，并在错误中写明价格。",
  "rewards": {
    "token": "Shard",
    "currency": "Cinnavault Shard, the capped ERC-20 issued by this Vault; not BNB",
    "bnb_valuation": null,
    "pool_created": false,
    "target": "0xdA90dF250242215DB85aCE5AbCf13aeD9aFff5Cf",
    "value_wei": "0",
    "entries": [
      {
        "signature": "claim(uint256[])",
        "selector": "0x6ba4c138"
      },
      {
        "signature": "claimReward(uint256[])",
        "selector": "0xc94c7ff4"
      }
    ],
    "pending": "owedTo(uint256)",
    "batch_cap": "MAX_IDS()",
    "rate": "SHARD_DAILY() * weightOfKind(sealInfo(id).kind)",
    "duration": "SHARD_SPAN()",
    "schedule": "A seal receives one fixed-rate credit at each UTC midnight after its mint day, until SHARD_SPAN days. No halving applies.",
    "headroom": "headroom()",
    "hard_cap": "reward.MAX_SUPPLY()",
    "ownership": "The current Seals holder presents IDs to the Vault. Repeated IDs add no second payout; remaining Shard capacity bounds issuance.",
    "warning": "Reward arrays belong at Vault. The zero-argument claim() on Seals charges the toll and mints a seal."
  },
  "examples": {
    "definitions": "Use wei: F=tollFee(), P=gildedPrice(). Each illustration requires a valid Agent ID, an active sale and sufficient unused capacity.",
    "cases": [
      {
        "call": "mint(1)",
        "value": "6 * P",
        "paid_nfts": 6,
        "refund": "0"
      },
      {
        "call": "mint(5)",
        "value": "3 * P",
        "paid_nfts": 3,
        "refund": "0"
      },
      {
        "call": "mint(2)",
        "value": "2 * P - 1",
        "paid_nfts": 1,
        "refund": "P - 1"
      },
      {
        "call": "mint(1)",
        "value": "P + 1",
        "paid_nfts": 1,
        "refund": "1 wei"
      },
      {
        "call": "mintFree(0)",
        "value": "F + 2 * P",
        "ordinary_nfts": 1,
        "paid_nfts": 2,
        "when": "ordinary available"
      },
      {
        "call": "mintFree(0)",
        "value": "F + 2 * P",
        "ordinary_nfts": 0,
        "paid_nfts": 2,
        "refund": "F",
        "when": "ordinary unavailable and F < P"
      }
    ]
  },
  "gas_limit": {
    "fee_or_fallback": "300000 + 50000 * actualPaidCount",
    "paid": "150000 + 50000 * actualPaidCount",
    "reward": "100000 + 35000 * uniqueIds.length",
    "receive": "max(400000, applicable formula)",
    "estimate_margin": "max(formula, ceil(eth_estimateGas * 1.20))"
  },
  "execution": [
    "Require published Seals, Vault and Shard addresses",
    "Check BNB Smart Chain 56 and bytecode at each address",
    "Match DISTRIBUTOR, SEALS, SHARD, ISSUER and the identity book",
    "Read the sale ledger at one fresh block",
    "Calculate the toll flag, paid slots, Founder split and change for this value",
    "Simulate as payer and measure gas",
    "Present the exact inscription transaction for review",
    "Refresh allocation; discard confirmation if any class or amount changed",
    "Ask the wallet to confirm the reviewed transaction",
    "Broadcast once and reconcile its receipt and minted IDs"
  ],
  "links": {
    "overview": "llms.txt",
    "reference": "skill.md",
    "website": "index.html"
  }
}
