{
  "schema_version": "1.0",
  "name": "Ostrenne",
  "symbol": "OSTR",
  "chain_id": 56,
  "deployment_state": "deployed",
  "site": "https://ostrenne.pages.dev/",
  "contracts": {
    "cards_and_stubs": {
      "address": "0x9fEB50Ae2DBa712a3F121F65F07be8802AF39a5e",
      "standard": "ERC-721 (two kinds in one contract: card = 1, stub = 2)",
      "verification": "https://bscscan.com/address/0x9fEB50Ae2DBa712a3F121F65F07be8802AF39a5e#code"
    },
    "coin": {
      "address": "0xAd0aA61c74807f3005786CAa37735C32FB3E6AE4",
      "standard": "ERC-20",
      "name": "Ostrenne Mote",
      "symbol": "OSTRM",
      "verification": "https://bscscan.com/address/0xAd0aA61c74807f3005786CAa37735C32FB3E6AE4#code"
    },
    "agent_id_registry": "0x60B9262456dE011F7d15a54CdD8c48bAaa8B022F"
  },
  "documents": { "guide": "skill.md", "discovery": "llms.txt", "page": "index.html" },
  "security": {
    "owner": false, "admin": false, "pause": false, "upgrade": false, "withdrawal": false,
    "payee": "immutable TILL()",
    "coin_cap": "6000000000000000000000000000 base units, constant; only the Ostrenne contract can mint",
    "bnb_settlement": "Price forwarded to TILL and excess returned to the caller in the same transaction; failure reverts; contract keeps no BNB",
    "unknown_selectors": "revert NoSuchSelector(bytes4)",
    "bare_bnb": "revert BareSendRefused()",
    "price_or_return_promised": false
  },
  "time": {
    "entry_start": "ENTRY_START()", "entry_end": "ENTRY_END()",
    "opened_at": "2026-11-21 13:10:13 (UTC+8)", "closes_at": "2026-12-21 13:10:13 (UTC+8)",
    "slot_seconds": 21600, "slot_rule": "slot = floor(timestamp / 21600): starts at 00, 06, 12, 18 UTC",
    "reaping_deadline": false
  },
  "reference_snapshot_not_live": {
    "TOLL_wei": "300000000000000", "STUB_COST_wei": "780000000000000", "STUB_CAP": 20, "STUBS_PER_WALLET": 5,
    "STUB_USES": 3, "STUB_LIFE_seconds": 604800, "BATCH_MAX": 30, "SCAN_MAX": 60,
    "grades": [
      { "name": "Dust", "odds_percent": 75, "coins": "8000" },
      { "name": "Spark", "odds_percent": 20, "coins": "40000" },
      { "name": "Flare", "odds_percent": 4.5, "coins": "200000" },
      { "name": "Nova", "odds_percent": 0.5, "coins": "800000" }
    ]
  },
  "entries": {
    "target": "0x9fEB50Ae2DBa712a3F121F65F07be8802AF39a5e",
    "preferred": { "signature": "mint()", "selector": "0x1249c58b" },
    "equivalent": [
      "mint(uint256) 0xa0712d68", "mint(address) 0x6a627842", "mint(address,uint256) 0x40c10f19", "mint(uint256,address) 0x94bf804d",
      "freeMint() 0x5b70ea9f", "freeMint(uint256) 0x7c928fe9", "mintFree() 0x8ab53447", "mintFree(uint256) 0xa4146733",
      "claim() 0x4e71d92d", "claimFree() 0xf366afc9", "publicMint() 0x26092b83", "agentMint() 0x1be3587a"
    ],
    "recipient": "caller always; address and quantity arguments are ignored",
    "settlement": {
      "rule": "free card if caller holds an Agent ID and has not taken this slot's card; stubs = min(floor(value / STUB_COST), stubsLeft(), STUBS_PER_WALLET - stubsBoughtBy(caller)); kept = stubs * STUB_COST; everything else returned in the same transaction",
      "quote": "entryQuote(address,uint256) 0xa27eb117 -> (freeCard, sets, spent, refund)",
      "nothing_issued": "reverts: NeedHandleOrFunds, OncePerSlot, StubsGone, TooEarly or Shut",
      "gas_limit": "eth_estimateGas * 1.3"
    }
  },
  "reaping": {
    "single": { "signature": "claim(uint256)", "selector": "0x379607f5", "value": ">= TOLL()", "gas_limit": 150000, "note": "success with full refund means only the slot look block was recorded; repeat after about 5 blocks" },
    "batch": [
      { "signature": "claim(uint256[])", "selector": "0x6ba4c138" },
      { "signature": "claimReward(uint256[])", "selector": "0xc94c7ff4" }
    ],
    "batch_rule": "reaps up to floor(value / TOLL) cards (max 30) from the first 60 ids; skipped cards are free; only reaped cards are charged; rest returned",
    "stub": { "signature": "redeemStub(uint256,uint256[])", "selector": "0x0998e1dd", "value": 0, "rule": "reaps up to the stub's remaining uses; only an actual reap uses one" },
    "batch_gas_limit": "100000 + 100000 per listed card, or eth_estimateGas * 1.3"
  },
  "stubs": {
    "uses": 3, "valid_for": "7 days from purchase", "transferable": true,
    "transfer_carries": "remaining uses and expiry",
    "expiry_refund": false, "needs_agent_id_to_buy": false
  },
  "randomness": {
    "source": "hash of a block recorded after the slot ends (current block + 4), mixed with contract and slot",
    "validator_influence": true,
    "stale_rule": "if nobody touches a slot within 8191 blocks (about an hour), every card in that slot is the lowest grade; no re-roll"
  },
  "live_getters": [
    "TOLL()", "STUB_COST()", "STUB_CAP()", "STUBS_PER_WALLET()", "STUB_USES()", "STUB_LIFE()", "SLOT_SECS()", "ENTRY_START()", "ENTRY_END()",
    "TILL()", "entryOpen()", "currentSlot()", "nextSlotAt()", "stubsLeft()", "stubsSold()", "stubsBoughtBy(address)", "cardsIn(uint32)",
    "motesLeft()", "handleHashOf(address)", "typeOf(uint256)", "stubInfo(uint256)", "ripeAt(uint256)", "reapable(uint256)", "worthOf(uint256)",
    "gradeOfCard(uint256)", "reaped(uint256)", "slotState(uint32)"
  ],
  "workflow": [
    "Match chain 56, both addresses, owner() zero",
    "Read entryOpen, prices, stubsLeft, entryQuote",
    "Simulate the exact call with eth_call",
    "Estimate gas and add 30%",
    "Send once; no approval or signature needed",
    "Check the receipt and Reaped / StubUsed / CardIssued / StubIssued events"
  ]
}
