# Prismfolio — transaction reference

BNB Smart Chain, chain ID 56. NFT: Prismfolio Cards / PRFOL; reward: Prismfolio Dust / PRFOLD. Addresses are final. The sale opened at `2026-11-21 11:59:47 (UTC+8)`; use `startsAt()` and `endsAt()` for eligibility. Never execute against an address not listed here. All amounts below are in BNB unless explicitly marked wei. No token approvals, off-chain signature requests or referral registrations are required.

## Canonical contracts and verifiable facts

Compiled ABI: [PrismfolioCards](abi/PrismfolioCards.json), [PrismfolioDust](abi/PrismfolioDust.json).

- Cards, sales AND reward claims: `0x59F5578cF663a2228aed77c254019e3c71816E72`.
- Dust ERC-20: `0xB53B7dd6A4ADA69B3Eb2e86845535d0a0946CE84`; verify it equals Cards.`DUST()`.
- Fee recipient: read Cards.`SINK()`; immutable, no setter. Fees go there in the same transaction and change returns to the caller. Normal minting retains no BNB. Forced BNB transfers are outside this invariant; no withdrawal function exists.
- Contracts have no owner/admin, pause, upgrade or withdrawal mechanism; `owner()` returns zero. Supply and issuance caps are constants. Only Cards can mint Dust: verify Dust.`MINTER()` equals Cards.
- [Cards verified source](https://bscscan.com/address/0x59F5578cF663a2228aed77c254019e3c71816E72#code), [Dust verified source](https://bscscan.com/address/0xB53B7dd6A4ADA69B3Eb2e86845535d0a0946CE84#code). These links become valid after address substitution and explorer verification.
- Agent ID registry: `0x60B9262456dE011F7d15a54CdD8c48bAaa8B022F`. [Registry source](https://bscscan.com/address/0x60B9262456dE011F7d15a54CdD8c48bAaa8B022F#code). `ID_ROOT()` must match. `idKeyFor(caller)` must return `ok=true`: the contract checks `handleOf(caller)` and ownership of `uint256(keccak256(bytes(handle)))`.

## A fresh snapshot of the card window

Use a fresh BSC block for a coherent snapshot: `startsAt()`, `endsAt()`, `utcDay()`, `dayTurnsAt()`, `entryFee()`, `premiumPrice()`, `entryReady(caller)`, `premiumLeft(caller)`, `entryMinted()`, `premiumMinted()`, `entriesOnDay(utcDay())`, `MAX_ENTRY_CARDS()`, `MAX_PREMIUM_CARDS()`, `ENTRY_PER_DAY()`, `PREMIUM_PER_WALLET()`, `MAX_BUY_BATCH()`. Eligibility is `startsAt <= block.timestamp < endsAt`. All mint entries, including Premium and direct BNB, require a valid Agent ID. One Common per Agent ID per UTC day, only while daily/total allocation remains. Premium is available concurrently while supply and wallet allowance remain.

Constructor fee values approved for this launch are **0.00005 BNB** (`50000000000000` wei) for Common and **0.0005 BNB** (`500000000000000` wei) per Premium. These are reference values, not live quotes. Read current immutable getters; if values differ, re-review the transaction instead of relying on examples. Read limits from getters too; the reviewed source has Common total/daily caps 12,000/1,500 and Premium total/wallet/batch caps 3,000/20/20.

## Fee-tier entry — NOT a zero-value mint

Canonical: `mintFree(uint256)` selector `0xa4146733`, payable. The uint256 argument is ignored: identity always comes from the caller's own Agent ID. Use zero for this ignored argument.

Every alias below is the SAME paid entry, with the same allocation rules:

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

`value=0` reverts `FeeRequired(required,sent)`. Pay exactly `entryFee()` to request Common only. With entry available, the contract first mints one Common, then uses `value-entryFee` to buy as many Premium as possible. If Common is unavailable, the whole payment may buy Premium, provided it can buy at least one. Otherwise revert (`AlreadyEnteredToday` or `EntryExhausted`). Use **`quoteEntryValue(caller,value)` → `(bool entryCard,uint256 premiumQty,uint256 cost,uint256 refund)`**, then simulate the actual call with `eth_call`. The quote is not a reservation.

## Premium entry — allocation follows payment

`mint(uint256)` (`0xa0712d68`), `mint(uint256,address)` (`0x94bf804d`) and empty-calldata BNB `receive()` share the same rules. The quantity and address arguments are ignored for settlement; there is no referral mechanism. `cardPriceFor(qty)` returns `qty*premiumPrice()`, a price request only. For payments at least one Premium price, read **`settleQuote(caller,value)` → `(qty,cost,refund)`**. Actual quantity is `min(floor(value/premiumPrice), MAX_BUY_BATCH, wallet allowance, stock)`. Change returns in the same transaction.

**Below-premium exception:** when `entryFee <= value < premiumPrice`, `mint(uint256)` and `receive()` route to Common instead. `settleQuote` returns quantity 1 and the entry fee for that Common allocation. Classify the result with `entryReady`/`premiumLeft`, or use `quoteEntryValue`, then simulate. Do not label that quantity as Premium. Below entry fee reverts `PayRequired(entryFee,premiumPrice,sent)`. If wallet or stock limits permit zero Premium, an available Common is issued instead and excess refunded; if no Common is available either, revert `WalletLimit` or `PremiumSoldOut`. This fallback also applies when value is at least premiumPrice.

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

Illustrations ONLY, assuming reference fees and enough allowance:

| Actual call/payment | Result |
|---|---|
| `mint(1)`, 0.003 BNB | 6 Premium, no change |
| `mint(5)`, 0.0015 BNB | 3 Premium, no change |
| `mint(2)`, 0.000999999999999999 BNB | 1 Premium; 0.000499999999999999 BNB change |
| `mint(1)`, 0.000500000000000001 BNB | 1 Premium; 1 wei change |
| `mintFree(0)`, 0.00105 BNB; Common available | 1 Common + 2 Premium |
| Same fee entry, Common unavailable | 2 Premium + 0.00005 BNB change |
| `mint(1)`, 0.00005 BNB; Common available | 1 Common |
| `mintFree(0)`, 0.000050000000000001 BNB | 1 Common; 1 wei change |
| `mintFree(0)`, 0.0001 BNB | 1 Common; 0.00005 BNB change |
| `mintFree(0)`, 0.000049999999999999 BNB | Revert FeeRequired; no card |
| `mint(2)`, 0.002 BNB | 4 Premium; no change |

If a cap reduces the allocation, the unspent balance also returns. No action grants more than the contract permits.

## Dust claims — correct overload and target

Call **Cards.`claim(uint256[])`** (`0x6ba4c138`) or Cards.`claimReward(uint256[])` (`0xc94c7ff4`), **value 0**. `claim()` without arguments is paid minting, not a reward claim.

Check `ownerOf(id)` and `pending(id)` for each ID. Only current holders can claim; unclaimed rewards follow transfers. Deduplicate IDs. Batch limit is `MAX_CLAIM_BATCH()` (reviewed source: 50). An empty/oversized batch reverts `ClaimBatch`; no accrued reward reverts `DustNone`. Duplicate IDs pay once. Claims can continue after sales close, until the card's emission ends.

Dust is this collection's own capped ERC-20; it is **not BNB**. No liquidity pool is created, no BNB valuation is provided, and no monetary value is promised. Source schedule: Common 100 Dust per UTC day after mint day, Premium weight 8; 60 emission days, days 31–60 at half rate. Read `DUST_PER_DAY()`, `PREMIUM_WEIGHT()`, `DUST_DAYS()`, `HALVING_DAY()`, `kindOf(id)`, Dust.`MAX_SUPPLY()` and Dust.`room()`. `dailyRate(id)` is the initial full-rate daily value, NOT a current-age rate; use `pending(id)` for claimable amount. Dust cap in reviewed source is 200,000,000 tokens, 18 decimals. If necessary actual claims are clipped to remaining issuance capacity, first claimed first issued.

## From card preview to receipt

- Fee-tier call: `gasLimit = 300000 + 50000 * actualPremiumQty`, including the fallback to this entry.
- Premium call: `150000 + 50000 * actualPremiumQty`.
- Reward claim: `100000 + 12000 * uniqueIds.length`.
- Empty-calldata BNB mint: `max(400000, applicable formula)`. A 2,300-gas transfer is insufficient; batches still require the formula.
- Use at least `max(formula, ceil(eth_estimateGas * 1.20))`. Network gas is additional to value.

Execution sequence: verify chain/addresses/code/registry/minter, read fresh getters, quote the exact value, `eth_call` from the actual payer, estimate gas, show target/calldata/value/allocation/change, obtain wallet confirmation, then submit once. Re-quote immediately before submission; changed allocation requires a new preview. Check receipt status and ERC-721 Transfer logs for minted IDs. Do not retry a pending transaction blindly. Never use token approvals or permission changes for these native-BNB actions.

Copyable agent request:

> On BSC 56, inspect 0x59F5578cF663a2228aed77c254019e3c71816E72 and its DUST() contract 0xB53B7dd6A4ADA69B3Eb2e86845535d0a0946CE84. Verify canonical addresses and read entryFee/premiumPrice and eligibility. Preview mintFree(uint256) with argument 0 and value exactly entryFee(), show the actual allocation and any refund, simulate and estimate gas. Execute only after confirmation and only if no approval or permission change is requested.
