# Cinnavault ? instructions for the inscription desk

CinnavaultSeals issues **Cinnavault Seals / CNVLT**. CinnavaultVault handles reward claims; its CinnavaultShard token is **Cinnavault Shard / CNVLTS**. Use BNB Smart Chain 56. The three addresses are final; the sale opened at `2026-11-21 12:59:46 (UTC+8)`. No token approval, off-chain signature request or referral registration belongs to this native-BNB workflow.

## Check the three seals of authenticity

| Role | Canonical address | Reciprocal check |
|---|---|---|
| CinnavaultSeals: sales | `0x20744dE03186789Ff15D2901d788cDF11a059B46` | `DISTRIBUTOR()` equals the Vault |
| CinnavaultVault: claims | `0xdA90dF250242215DB85aCE5AbCf13aeD9aFff5Cf` | `SEALS()` equals Seals; `SHARD()` equals reward |
| CinnavaultShard: reward token | `0xf42b5556d1FB548Aec06756b1Fc07683aE95416e` | `ISSUER()` equals the Vault |

Inspect the published [Seals source](https://bscscan.com/address/0x20744dE03186789Ff15D2901d788cDF11a059B46#code), [Vault source](https://bscscan.com/address/0xdA90dF250242215DB85aCE5AbCf13aeD9aFff5Cf#code) and [Shard source](https://bscscan.com/address/0xf42b5556d1FB548Aec06756b1Fc07683aE95416e#code). Those links require deployed addresses and explorer verification. Compiled interfaces: [Seals ABI](abi/CinnavaultSeals.json), [Vault ABI](abi/CinnavaultVault.json), [Shard ABI](abi/CinnavaultShard.json).

All three return zero from `owner()`. There is no administrative, pause, upgrade or withdrawal path. Caps are constants; Seals.`PROCEEDS()` has no setter. Ordinary mint payments remit filled-slot costs to PROCEEDS and refund unspent wei atomically. Forced BNB is outside that normal-call invariant. Vault rejects plain BNB.

Seals.`IDENTITY_BOOK()` must equal `0x60B9262456dE011F7d15a54CdD8c48bAaa8B022F` ([registry source](https://bscscan.com/address/0x60B9262456dE011F7d15a54CdD8c48bAaa8B022F#code)). Every mint checks `identityKey(caller).ok`: the caller must own the token keyed by the hash of its registry handle. This also applies to paid and empty-calldata entries.

## Open the ledger at one fresh block

Read `saleStarts()`, `saleEnds()`, `dayNumber()`, `tollResetAt()`, `tollFee()`, `gildedPrice()`, `tollReady(caller)`, `gildedLeft(caller)`, `plainMinted()`, `gildedMinted()`, `tollsToday()` and `foundersLeft()`. The active interval includes saleStarts and excludes saleEnds. Getter values, rather than the listed opening time, determine eligibility.

Plain provides one slot per Agent ID per UTC day while daily and total capacity remain. Its source caps are 8,000 total and 1,000/day. Paid slots operate concurrently: 2,000 total, 20/wallet and 20/transaction. Query `PLAIN_CAP()`, `PLAIN_PER_DAY()`, `GILDED_CAP()`, `GILDED_PER_WALLET()`, `BUY_BATCH()` and `FOUNDER_COUNT()` for the terms. The earliest 300 paid slots issue Founder; later slots issue Gilded. Class follows paid-sale order, so one purchase can include both. Nothing in a quote reserves Founder slots.

The reviewed constructor prices are `tollFee() = 100000000000000` wei (0.0001 BNB) and `gildedPrice() = 1000000000000000` wei (0.001 BNB). These are reference parameters. Before executing, obtain both getters anew and re-review any discrepancy.

## Toll desk: Plain first, then extra paid seals

Call Seals.`mintFree(uint256)` (`0xa4146733`) with argument 0; the number is ignored. The caller's identity supplies the daily key. The alternative spellings below enter this same **paid** desk:

| Signature | Selector |
|---|---|
| `mintFree()` | `0x8ab53447` |
| `mint()` | `0x1249c58b` |
| `freeMint()` | `0x5b70ea9f` |
| `freeMint(uint256)` | `0x7c928fe9` |
| `claim()` | `0x4e71d92d` |
| `claim(uint256)` | `0x379607f5` |
| `claimFree()` | `0xf366afc9` |
| `publicMint()` | `0x26092b83` |
| `agentMint()` | `0x1be3587a` |

A live Plain slot consumes `tollFee()` and mints Plain, then the remaining value buys paid seals at `gildedPrice()`. If Plain is unavailable, the entire value may buy paid seals. `quoteTollValue(caller,value)` returns `(bool tollSeal,uint256 gildedQty,uint256 cost,uint256 refund)`; follow it with `eth_call` from the payer. Paying exactly the toll requests Plain alone; zero or less than the toll reverts `TollRequired(required,sent)`. When no Plain or paid allocation is possible, `TollUsedToday(resetAt)` or `TollFull` explains the failed entry.

## Paid ledger: money determines the filled slots

Use Seals.`mint(uint256)` (`0xa0712d68`), Seals.`mint(uint256,address)` (`0x94bf804d`), or empty-calldata `receive()` on Seals. The numeric argument requests a price but does not restrict delivery; the address argument is ignored and adds no referral benefit. `priceOf(qty)` returns qty ? `gildedPrice()`. `previewBuy(caller,value)` returns `(qty,cost,refund)` for the actual value.

For a paid allocation, count is `min(floor(value/gildedPrice()), BUY_BATCH(), gildedLeft(caller))`. Unspent value returns during execution, including amounts trimmed by caps. When no paid slot can be filled but value covers the toll and Plain is available, the call supplies Plain and refunds the rest. This includes payments below a paid seal's price and payments made after the paid wallet/supply allowance reaches zero. In that fallback, previewBuy quantity 1 describes **Plain**. Check `tollReady` and `quoteTollValue` to label it, then simulate. If neither tier can fill, expect `SealsWalletCap(0)` / `GildedGone(0)` or the toll allocation error. Below the toll, the paid ledger rejects `EitherPrice(tollFee,gildedPrice,sent)`.

中文摘要：照付款金额成交。付款能买几枚就给几枚（受每日额度、每钱包上限、单笔上限与剩余量限制），不足一枚的零头与被上限截掉的部分在同一笔交易退回；连一枚都买不起时才 revert，并在错误中写明价格。

The following arithmetic assumes a valid identity, an open window, unused capacity and the reference prices. F means tollFee, P means gildedPrice; amounts in the value column are wei.

| Entry and value | Filled allocation and change |
|---|---|
| `mint(1)`, 6P | Six paid seals |
| `mint(5)`, 3P | Three paid seals |
| `mint(2)`, 2P+1 | Two paid seals; 1 wei returned |
| `mint(2)`, 4P | Four paid seals |
| `mint(2)`, 2P-1 | One paid seal; P-1 returned |
| `mint(1)`, P-1; Plain available | Plain; P-F-1 returned |
| `mintFree(0)`, F+2P; Plain available | Plain plus two paid seals |
| `mintFree(0)`, F+2P; Plain unavailable | Two paid seals; F returned |
| `mintFree(0)`, F+1 | Plain; 1 wei returned |
| `mintFree(0)`, 2F (reference F < P/2) | Plain; F returned |
| `mintFree(0)`, F-1 | Revert; no seal |

## Redeem elapsed days at the Vault

Shard accrues at UTC midnights after mint day for 45 days. The flat daily amount is 120 Shard ? weight: Plain 1, Gilded 5, Founder 10. There is no halving. Read Vault.`SHARD_DAILY()`, `SHARD_SPAN()`, `weightOfKind(kind)`, `dayRate(id)`, `paidThrough(id)` and `owedTo(id)`, with Seals.`sealInfo(id)` for class. Shard is Cinnavault's own ERC-20, not BNB. The contracts create no pool and supply no BNB valuation. Shard.`MAX_SUPPLY()` is 120,000,000 tokens (18 decimals); `headroom()` bounds remaining issuance, first claimed first issued.

Submit **Vault.`claim(uint256[])`** (`0x6ba4c138`) or Vault.`claimReward(uint256[])` (`0xc94c7ff4`), with **value 0**. Current Seals holders may present IDs; unclaimed accrual follows ownership. Verify `ownerOf(id)`, query `owedTo(id)`, remove duplicate IDs and respect Vault.`MAX_IDS()` (40 in reviewed source). Duplicate IDs receive no second payout. Empty/oversized arrays fail `VaultBatch`; an empty entitlement fails `NothingOwed`. Existing seals may continue accruing and claiming after sales close, until their emission periods end.

Seals.`claim()` is a paid mint entry. Seals does not implement the reward-array overload: sending the Vault call to Seals fails. Plain BNB belongs at Seals, never at Vault.

## Estimate, inspect, sign once

| Operation | Suggested gas floor |
|---|---|
| Toll desk, including fallback | `300000 + 50000 * actualPaidSealCount` |
| Paid ledger | `150000 + 50000 * actualPaidSealCount` |
| Vault redemption | `100000 + 35000 * uniqueIds.length` |
| Empty-calldata mint | `max(400000, applicable formula)` |

Choose at least `max(formula, ceil(eth_estimateGas * 1.20))`. Network gas is additional to value; a 2,300-gas transfer cannot mint. Verify addresses and reciprocal links, read one coherent snapshot, quote the exact payment and Founder split, simulate from the payer and estimate gas. Present target, calldata, value, allocation and refund for wallet confirmation. Re-read allocation immediately before signing; changed Founder slots or other allocation changes require a new preview. Submit once, inspect receipt status and ERC-721 Transfer logs, and resolve a pending hash before any retry.

A request to copy:

> Inspect Cinnavault on BSC 56: Seals 0x20744dE03186789Ff15D2901d788cDF11a059B46, DISTRIBUTOR 0xdA90dF250242215DB85aCE5AbCf13aeD9aFff5Cf, and that Vault's SHARD 0xf42b5556d1FB548Aec06756b1Fc07683aE95416e. Validate reciprocal links and my Agent ID, then read current toll and paid terms. Preview mintFree(uint256) with argument 0 and value tollFee(), including class allocation and change. Simulate and estimate; request wallet confirmation only if the preview remains unchanged and no token approval or permission change is requested. Send reward-array calls only to the Vault.
