{
  "schema_version": "1.0",
  "name": "Vellumlot",
  "display_name": "\u7eb8\u5e8f",
  "symbol": "VLOT",
  "chain_id": 56,
  "deployment_state": "deployed",
  "contracts": {
    "sale_and_token": {
      "address": "0xb4EF58f108343e437Dd2107E7037915C974b5e71",
      "standard": "ERC-20 with payable sale",
      "verification": "https://bscscan.com/address/0xb4EF58f108343e437Dd2107E7037915C974b5e71#code",
      "contract_name": "Vellumlot",
      "token_name": "Vellumlot",
      "symbol": "VLOT"
    }
  },
  "documents": {
    "site": "index.html",
    "guide": "skill.md",
    "discovery": "llms.txt",
    "abi": "api.json"
  },
  "security": {
    "owner": false,
    "admin": false,
    "pause": false,
    "upgrade": false,
    "withdrawal": false,
    "setters": false,
    "payee": "immutable SALE_TO()",
    "arbitrary_mint_authority": false,
    "issuance": "Only bought shares create tokens; all purchase entries share one settlement path",
    "bnb_settlement": "Cost forwarded to SALE_TO and excess refunded to caller in the same transaction; failure reverts. No BNB retained by normal sale paths. Forced BNB is not a sale payment.",
    "unknown_selectors": "revert NoSuchCall(bytes4)",
    "transfer_tax": false,
    "blacklist": false,
    "pool_created": false
  },
  "eligibility": {
    "getter": "holderKeyOf(address) returns (uint256 key,bool ok)",
    "registry_getter": "AGENT_BOOK()",
    "key": "uint256(keccak256(bytes(handle))) with current registry ownership check",
    "allowance": "SHARES_PER_ID() - sharesOfId(key), clipped by available stock; ID quota follows the ID, not token balance",
    "transfers_restore_quota": false,
    "gift_variants": "Tokens to recipient, caller's identity/quota applies",
    "free_shares": false
  },
  "live_getters": [
    "SHARE_PRICE()",
    "SHARES()",
    "SHARES_PER_ID()",
    "SHARE_TOKENS()",
    "MAX_SUPPLY()",
    "decimals()",
    "sharesLeft()",
    "sharesSold()",
    "saleOpen()",
    "leftFor(address)",
    "holderKeyOf(address)",
    "sharesOfId(uint256)",
    "saleStart()",
    "saleEnd()",
    "SALE_TO()",
    "AGENT_BOOK()",
    "totalSupply()",
    "balanceOf(address)"
  ],
  "time": {
    "opened_at": "2026-11-21 10:59:47 (UTC+8)",
    "authoritative": "saleStart <= block.timestamp < saleEnd, and sharesLeft > 0",
    "origin": "deployment timestamp plus constructor durations",
    "closes_even_if_unsold": true
  },
  "reference_snapshot_not_live": {
    "share_price_wei": "1000000000000000",
    "tokens_per_share_base_units": "1000000000000000000000000",
    "share_ceiling": 300,
    "shares_per_id": 10,
    "token_supply_ceiling_base_units": "300000000000000000000000000",
    "decimals": 18,
    "network_gas_separate": true
  },
  "entries": [
    {
      "signature": "mint(uint256)",
      "selector": "0xa0712d68",
      "recipient": "caller",
      "mode": "by_value"
    },
    {
      "signature": "mint(uint256,address)",
      "selector": "0x94bf804d",
      "recipient": "argument",
      "mode": "by_value",
      "quota": "caller"
    },
    {
      "signature": "mint()",
      "selector": "0x1249c58b",
      "recipient": "caller",
      "mode": "by_value"
    },
    {
      "signature": "publicMint()",
      "selector": "0x26092b83",
      "recipient": "caller",
      "mode": "by_value"
    },
    {
      "signature": "mint(address)",
      "selector": "0x6a627842",
      "recipient": "argument",
      "mode": "by_value",
      "quota": "caller"
    },
    {
      "signature": "receive()",
      "calldata": "0x",
      "recipient": "caller",
      "mode": "by_value",
      "note": "Execution gas required"
    }
  ],
  "unsupported_entries": [
    "claim()",
    "claim(uint256)",
    "freeMint()",
    "mintFree()",
    "mintFree(uint256)",
    "mint(address,uint256)"
  ],
  "settlement": {
    "rule": "shares = min(floor(value/SHARE_PRICE()), remaining ID allowance, sharesLeft()); cost = shares*SHARE_PRICE(); refund = value-cost",
    "quantity_argument": "Quote hint only, never a limit on actual settled shares; even 0 or above-cap quantity does not change settlement",
    "refund": "Remainder and cap-truncated amount returned to msg.sender in the same transaction",
    "quantity_quote": "costOfShares(uint256) returns qty*SHARE_PRICE; does not validate window, identity or allowance",
    "value_quote": "sharesForValue(address,uint256) returns (qty,cost,refund)",
    "zero_quote_result": "Not a successful refundable transaction; actual calls may revert",
    "zero_value": "ShortPayment(SHARE_PRICE(),0) when otherwise eligible/open; earlier window/identity/stock/quota checks can fail first",
    "no_output_slippage_guard": true,
    "errors": [
      "HolderRequired()",
      "SaleWindowShut(uint256,uint256)",
      "ShortPayment(uint256,uint256)",
      "IdAllowance(uint256)",
      "ShareSoldOut()",
      "ZeroTarget()",
      "SaleToRejected()",
      "ChangeRefused()",
      "LockHeld()",
      "NoSuchCall(bytes4)"
    ]
  },
  "examples_reference_values": [
    {
      "state": "Fresh valid ID, open, ample supply",
      "signature": "mint(uint256)",
      "quantity": "1",
      "value_wei": "6000000000000000",
      "shares": 6,
      "tokens": "6000000",
      "refund_wei": "0"
    },
    {
      "state": "Fresh valid ID, open, ample supply",
      "signature": "mint(uint256)",
      "quantity": "5",
      "value_wei": "3000000000000000",
      "shares": 3,
      "tokens": "3000000",
      "refund_wei": "0"
    },
    {
      "state": "Fresh valid ID, open, ample supply",
      "quantity": "11",
      "value_wei": "11000000000000000",
      "shares": 10,
      "refund_wei": "1000000000000000"
    },
    {
      "state": "Valid ID, open, allowance/stock remain",
      "value_wei": "1000000000000001",
      "shares": 1,
      "refund_wei": "1"
    },
    {
      "state": "Valid ID, open, allowance/stock remain",
      "value_wei": "999999999999999",
      "revert": "ShortPayment"
    },
    {
      "state": "Valid ID with room, open, only 2 shares left",
      "value_wei": "5000000000000000",
      "shares": 2,
      "refund_wei": "3000000000000000"
    }
  ],
  "delivery": {
    "asset": "Own ERC-20 token VLOT, not BNB",
    "tokens": "settled shares * SHARE_TOKENS() base units",
    "when": "In the purchase transaction",
    "claim_required": false,
    "rewards_accrue": false,
    "vesting": false,
    "freely_transferable": true,
    "purchase_needs_approval": false,
    "bnb_valuation": null,
    "liquidity_promised": false,
    "listing_promised": false,
    "returns_promised": false,
    "verification": [
      "receipt status 1",
      "SharesBought and Transfer events",
      "balanceOf(recipient)",
      "sharesOfId(key)"
    ]
  },
  "token_functions": [
    "transfer(address,uint256)",
    "approve(address,uint256)",
    "transferFrom(address,address,uint256)",
    "allowance(address,address)",
    "balanceOf(address)"
  ],
  "gas_limit": {
    "all_purchase_entries_and_receive": "300000",
    "final": "max(300000, ceil(eth_estimateGas * 1.2)) after eth_call with exact from/data/value",
    "gas_cost_guaranteed": false
  },
  "workflow": [
    "Match actual chain/address/code/source",
    "Read identity, window, stock, quota, price and token units",
    "Read costOfShares and sharesForValue",
    "Simulate exact overload/value/from with eth_call",
    "Estimate gas and show full reviewed transaction",
    "Recheck account/chain/quote/authorization",
    "Submit without token approval or message signing",
    "Check receipt status 1, token delivery and ID quota"
  ],
  "limitations": [
    "Quote is not a stock reservation; actual output can change before mining",
    "BNB share purchase price is not token market or redemption value"
  ]
}
