{
  "name": "Voltrune",
  "description": "Route rigs to the collection, paid shifts to the Forge, and track VTRNC issued in the successful work receipt.",
  "contractNames": {
    "collection": "VoltruneRigs",
    "mining": "VoltruneForge",
    "reward": "VoltruneCoin"
  },
  "collectionToken": {
    "name": "Voltrune Rigs",
    "symbol": "VTRN"
  },
  "displaySymbol": "VTRNC",
  "identityStatus": "Frozen source names and symbols; deployed on BNB Smart Chain.",
  "status": "deployed",
  "chain": {
    "id": 56,
    "hex": "0x38",
    "name": "BNB Smart Chain",
    "nativeCurrency": "BNB"
  },
  "contracts": {
    "collection": "0x145C5B3Ab1268dbf5F86192bcE390c9c60076FFF",
    "mining": "0xdaa7B0fd23fb9EAd3e6687AB5383C3e1ca489c5f",
    "rewardToken": "0x931beFc4e4fEc9bE674B0d101938132c199a1DcB",
    "registry": "0x60B9262456dE011F7d15a54CdD8c48bAaa8B022F"
  },
  "verification": {
    "sourceUrlTemplate": "https://bscscan.com/address/{address}#code",
    "owner": "owner() == address(0)",
    "permissions": [
      "no admin",
      "no pause",
      "no upgrade",
      "no withdraw"
    ],
    "payee": "immutable RECIPIENT() on mining contract",
    "settlement": "Forge forwards completed-shift fees to RECIPIENT and returns the unused native value before the transaction finishes. Ordinary work leaves no BNB behind; forced transfers are outside this guarantee.",
    "links": {
      "collectionToMining": "FORGE()",
      "miningToToken": "COIN_TOKEN()",
      "tokenToIssuer": "FORGE()"
    },
    "registryGetter": "ID_LEDGER()",
    "keyGetter": "rigKeyOf(address)"
  },
  "claim": {
    "target": "0x145C5B3Ab1268dbf5F86192bcE390c9c60076FFF",
    "canonical": "claim()",
    "aliases": [
      {
        "signature": "claim()",
        "selector": "0x4e71d92d"
      },
      {
        "signature": "mint()",
        "selector": "0x1249c58b"
      },
      {
        "signature": "freeMint()",
        "selector": "0x5b70ea9f"
      },
      {
        "signature": "mintFree()",
        "selector": "0x8ab53447"
      },
      {
        "signature": "claimFree()",
        "selector": "0xf366afc9"
      },
      {
        "signature": "publicMint()",
        "selector": "0x26092b83"
      },
      {
        "signature": "agentMint()",
        "selector": "0x1be3587a"
      },
      {
        "signature": "mint(uint256)",
        "selector": "0xa0712d68"
      },
      {
        "signature": "freeMint(uint256)",
        "selector": "0x7c928fe9"
      },
      {
        "signature": "mintFree(uint256)",
        "selector": "0xa4146733"
      },
      {
        "signature": "claim(uint256)",
        "selector": "0x379607f5"
      }
    ],
    "valueWei": "0",
    "cost": "Rig issue has zero protocol price; budget network gas. Rigs returns any attached native value in the same call.",
    "eligibility": "An Agent ID is a lifetime rig ticket. Rigs checks the handle hash against ID_LEDGER ownership, rigOfAgent, the claim clock and remaining inventory. Aliases and ignored numeric arguments do not create another ticket.",
    "readyGetter": "rigClaimable(address)",
    "remainingFormula": "RIG_CAP() - rigsMinted()",
    "gasLimit": 314000
  },
  "tierResolution": {
    "claim": "Records claim block; tier is initially sealed",
    "targetBlock": "claimBlock+1",
    "ready": "block.number > targetBlock and the target hash is readable; check tierKnown(uint256)",
    "entry": "settleRank(uint256)",
    "selector": "0x40173f20",
    "target": "0x145C5B3Ab1268dbf5F86192bcE390c9c60076FFF",
    "valueWei": "0",
    "gasLimit": "max(250000,ceil(1.2*eth_estimateGas)) after exact eth_call",
    "hashSpanGetter": "HASH_SPAN()",
    "hashSpanBlocks": 8191,
    "historyGetter": "BLOCKHASH_STORE()",
    "history": "BLOCKHASH through age 256; EIP-2935 history contract for ages 257..8191. Missing or unreadable history leaves the rig pending within this span.",
    "fallback": "If still unfixed and block.number > targetBlock + 8191, permanent Standard. About 61 minutes on BNB Smart Chain, not a wall-clock deadline.",
    "automatic": "Each claim attempts 1 older rig; each Forge work call attempts 2 older rigs, with no gas floor; the first successful shift fixes its own rig.",
    "draw": "keccak256(abi.encode(targetHash,rigId,chainid)) % 100: <5 Prime, <30 Tuned, otherwise Standard. Block producers can slightly influence the target hash.",
    "counts": "tierKnown means readable, not necessarily fixed; tierCount(uint256) and settledCount() count fixed tiers only; sweepFrom() is the settling cursor.",
    "sweep": "sweep() attempts at most 4 rigs; settleSome(uint256,uint256) caps steps at 4 and honors its caller-provided gas floor."
  },
  "mining": {
    "target": "0xdaa7B0fd23fb9EAd3e6687AB5383C3e1ca489c5f",
    "signatures": [
      "mine(uint256[])",
      "mine(uint256)",
      "mine()",
      "mineRepeat(uint256,uint256)"
    ],
    "feeGetter": "shiftFee()",
    "quote": "shiftPrice(uint256)",
    "dailyLimitGetter": "SHIFTS_PER_DAY()",
    "callLimitGetter": "MAX_SHIFTS_PER_CALL()",
    "leftGetter": "shiftsLeft(uint256)",
    "settlement": "Let F=shiftFee(). Funded shifts=floor(value/F), then restrict by daily room, call capacity and the submitted array length. A full rig is skipped; unused funding returns atomically. Less than F or no completed shifts reverts.",
    "examples": [
      "Let F = shiftFee(), N = 3, and assume the caller owns the miner, it has at least 3 uses left today (larger-payment examples remain bounded by the actual daily remainder), the window is open and rewards remain.",
      "- shiftPrice(3) = 3*F wei. For mine(id), pay 3*F: 3 uses. Pay 3*F+1: 3 uses, refund 1 wei. Pay 6*F: up to 6 uses, bounded by the daily limit (so a lower daily remainder means a larger refund). Pay 3*F-1: 2 uses, refund F-1. Pay F-1: revert, cannot buy one use.",
      "- For mine([id,id,id]), pay 6*F: at most 3 uses because the list has only 3 entries; refund the unused payment. For the same list, pay 3*F-1: at most 2 uses. Each repeated ID consumes one daily use. A full miner is skipped without a charge. The loop checks ownership only for entries reached before paid uses are exhausted; any reached non-owned/nonexistent ID reverts the entire transaction.",
      "- Concrete deployment illustration ONLY IF shiftFee() returns 200000000000000 wei (0.0002 BNB): shiftPrice(3) returns 600000000000000 wei (0.00060 BNB). Read again rather than assume this illustration is live pricing.",
      "- mineRepeat(id,times) ignores times for execution: pay 3*F with times=1 and get up to 3 shifts; times=0 does not mean zero shifts. Payment, not times, controls execution."
    ],
    "gasLimitFormula": "Single rig: (first shift ? 491000 : 325000) + 5700 * (N - 1). For arrays, simulate and use max(491000 + 5700*(N-1), ceil(1.2*estimateGas)); no fixed distinct-ID formula.",
    "ownership": "Each reached rig must be held by the caller. For transferred-in inventory select mine(id) or an array. The no-argument entry looks up the rig claimed through the caller Agent ID.",
    "rewardDelivery": "The work receipt contains Coin issuance to the worker; a separate reward-claim transaction is unnecessary."
  },
  "reward": {
    "symbol": "VTRNC",
    "token": "0x931beFc4e4fEc9bE674B0d101938132c199a1DcB",
    "decimalsGetter": "decimals()",
    "baseUnitFormula": "SHIFT_BASE() * tierPct(rankOf(id)) * streakBps(streakLive(id) or 1) / 1000000. Base 450 VTRNC; tiers 1/2/4; streak 1.00x on days 1-2, 1.25x on 3-6, 1.50x from 7.",
    "nextYieldGetter": "nextShiftPay(uint256) ignores cap",
    "remainingGetter": "left()",
    "capGetter": "COIN_CAP()",
    "capBehavior": "Coin.left() bounds actual issuance. The last work batch can yield less while still charging completed shifts. No remaining Coin causes CoinGone() before any shift fee is taken.",
    "asset": "VTRNC is Voltrune Coin, a project token; it is not BNB and has no BNB quote or liquidity pool.",
    "dailyReset": "floor(block.timestamp / 86400); 00:00 UTC. One whole missed UTC day resets streak to 1.",
    "name": "Voltrune Coin"
  },
  "windows": "Collection claiming: [collection.startAt(), collection.shutAt()). Mining: [Forge.startAt(), Forge.shutAt()); Forge.shutAt() = collection.shutAt() + TAIL() (current source: 7 days). Claiming can be closed while paid mining remains open.",
  "plainTransfers": {
    "collectionRevert": "FreeEntryOnly()",
    "miningRevert": "OnlyShifts()",
    "unsupportedSelectors": "Always revert, including when BNB is attached."
  },
  "preflight": [
    "Use only the three listed addresses; reject any other address.",
    "On chain 56, inspect verified source and bytecode, zero owner, ID_LEDGER and the Rigs/Forge/Coin links.",
    "For issue, read rigClaimable(address) and the collection clock; for work, verify ownerOf(id), the Forge clock, shiftsLeft(id) and Coin.left().",
    "Wait for tierKnown(id). Pending target hash means wait and re-read; tierKnown is readability rather than proof of fixation.",
    "Use integer wei for shiftPrice(N); read nextShiftPay(id) and cap the expected issuance by Coin.left().",
    "Simulate the exact target, caller, calldata and value, then estimate gas against the first/subsequent shift budget.",
    "Show the complete transaction for approval. No ERC-20 allowance is required.",
    "After approval submit once, wait for status=1 and reconcile fees, refund, issued Coin and daily room. A pending hash does not justify resubmission."
  ],
  "files": {
    "human": "index.html",
    "agent": "skill.md",
    "discovery": "llms.txt",
    "collectionAbi": "abi-entry.json",
    "tokenAbi": "abi-token.json",
    "miningAbi": "abi-action.json",
    "selectors": "selectors.json"
  }
}
