# Vellumlot — fixed-price token subscription

BNB Smart Chain 56 (`0x38`). Unique sale **and ERC-20 token** contract: `0xb4EF58f108343e437Dd2107E7037915C974b5e71`. [Verify source](https://bscscan.com/address/0xb4EF58f108343e437Dd2107E7037915C974b5e71#code). There is no second reward contract or separate claim step. The sale opened at `2026-11-21 10:59:47 (UTC+8)`. Explorer hyperlinks do not establish that verification has already occurred.

This guide does not authorize spending. Simulate first and submit only within the wallet owner's authorization. Purchasing requires no token approval or message signature.

## Verifiable properties

No owner, admin, pause, upgrade, withdrawal or setter. `SALE_TO()` is immutable. Price, share ceiling, tokens per share and per-ID allowance are fixed constants. Supply is created only by paid shares, not by an arbitrary mint authority; unpurchased shares have no tokens. All entry paths call the same sale logic. Fees go to SALE_TO and unused BNB returns to the caller in the same transaction. `SaleToRejected` or `ChangeRefused` reverts the whole transaction. Unknown selectors revert `NoSuchCall(bytes4)` without keeping BNB. Transfers are untaxed, without a blacklist. The sale creates no pool and promises no token market price, liquidity or listing.

## Read before acting

Use current getters, preferably at one block tag:

- `SHARE_PRICE()`, `SHARES()`, `SHARES_PER_ID()`, `SHARE_TOKENS()`, `MAX_SUPPLY()`, `decimals()`.
- `sharesLeft()`, `sharesSold()`, `saleOpen()`, `saleStart()`, `saleEnd()`.
- `holderKeyOf(address) -> (uint256 key,bool ok)`, `leftFor(address)`, `sharesOfId(uint256)`, `balanceOf(address)` and `totalSupply()`.
- `SALE_TO()` and `AGENT_BOOK()`.

Reviewed constants, not live state: 0.001 BNB per share, 1,000,000 VLOT per share (18 decimals), 300 shares maximum, 10 cumulative shares per Agent ID, 300,000,000 token ceiling. Always read actual getters, not these reference numbers, for transactions.

The sender must currently own an Agent ID. `holderKeyOf` derives `uint256(keccak256(bytes(handle)))` and checks `ownerOf` in the registry `AGENT_BOOK` (`0x60B9262456dE011F7d15a54CdD8c48bAaa8B022F` in the reviewed source). The allowance follows the ID, not the token balance or recipient. Transferring tokens away does not restore allowance; moving an ID preserves its used quota. `leftFor` returns 0 when closed, no identity, sold out or quota used.

The window is `saleStart <= block.timestamp < saleEnd`, both derived from deployment timestamp plus constructor durations. Sales stop at sellout **or** close, even if shares remain. `costOfShares` alone does not check the window, identity or allowance.

## Every purchase entry and alias

| Full signature | Selector | Delivery |
|---|---|---|
| `mint(uint256)` | `0xa0712d68` | To caller; quantity is a quoting hint only. |
| `mint(uint256,address)` | `0x94bf804d` | To recipient; caller identity and quota apply. |
| `mint()` | `0x1249c58b` | To caller, settled by BNB value. |
| `publicMint()` | `0x26092b83` | Same as `mint()`. |
| `mint(address)` | `0x6a627842` | To recipient; caller identity and quota apply. |
| `receive()` (empty calldata) | — | Direct BNB transfer, same as `mint()`. |

All entries are payable; **there are no free shares**. In an otherwise eligible/open state, value 0 reverts `ShortPayment(SHARE_PRICE,0)`; identity/window/sellout checks may revert first. `claim()`, `claim(uint256)`, `freeMint()` and `mintFree(...)` are not supported entries and revert `NoSuchCall`. `mint(address,uint256)` is not an entry. Recipient must not be zero. Direct transfers require contract execution gas, not 21,000.

## Settlement follows payment value / 照付款金额成交

`shares = min(floor(msg.value / SHARE_PRICE), remaining ID quota, sharesLeft)`.
`cost = shares * SHARE_PRICE` and `refund = msg.value - cost`.
The remainder and any amount cut off by the caps are returned **in the same transaction to the caller**. Quantity arguments, even 0 or more than the cap, never limit settlement. If the payment cannot cover a single share, the transaction reverts `ShortPayment(price,sent)`. Used quota gives `IdAllowance(0)`; sold-out gives `ShareSoldOut()`. Other errors include `HolderRequired`, `SaleWindowShut`, `ZeroTarget`, `SaleToRejected`, `ChangeRefused`, `LockHeld`.

- `costOfShares(uint256 qty) -> uint256`: `qty*SHARE_PRICE`; it is a price calculation only and does **not** validate allowance or window.
- `sharesForValue(address wallet,uint256 value) -> (uint256 qty,uint256 cost,uint256 refund)`: current value-settled result. A zero-quantity return is not evidence that a real call will succeed and refund; actual ineligible/closed/underpaid calls revert. Read `leftFor`, identity and window, then simulate.

Examples with the reference price, valid identity, an open window and sufficient stock:

1. `mint(uint256)(1)` with `0.006 BNB` -> 6 shares / 6,000,000 tokens, no refund.
2. `mint(uint256)(5)` with `0.003 BNB` -> 3 shares / 3,000,000 tokens, no refund.
3. New ID, `mint(uint256)(11)` with `0.011 BNB` -> 10 shares / 10,000,000 tokens, `0.001 BNB` refunded.
4. Value `0.001000000000000001 BNB` -> 1 share, 1 wei refund. `0.000999999999999999 BNB` -> `ShortPayment`. `0.002 BNB` -> 2 shares, when room remains.
5. Only 2 shares left globally, value `0.005 BNB` -> 2 shares and `0.003 BNB` refunded, even if the ID has more quota.

The contract has no minimum-output or maximum-quantity parameter. A quote does not reserve shares. Re-read before submission; state can still change before mining. Actual received tokens = settled shares * `SHARE_TOKENS`, in base units. **The BNB share purchase price is not a market valuation or redemption value of the token.**

## Receive and transfer

Tokens are minted directly to the selected recipient **in the purchase transaction**. There is no reward accrual, claim fee, claim function or vesting. Verify receipt status 1, `SharesBought` and `Transfer` events, `balanceOf(recipient)` and `sharesOfId(key)`. The ERC-20 supports `transfer(address,uint256)`, `approve(address,uint256)`, `transferFrom(address,address,uint256)`, `allowance` and `balanceOf`. Token transfers have no contract transfer tax; network gas applies. Purchasing itself requests none of these approvals. Do not infer remaining purchase quota from token balance.

## Exact execution and gas

1. Verify chain/address/source; read identity, availability, price and token units.
2. `value = costOfShares(qty)`; inspect `sharesForValue(wallet,value)`. Quantity is not a settlement cap.
3. Encode the full overload and integer wei value (1 BNB = 10^18 wei); run `eth_call` with the exact sending wallet, calldata and value. Stop on revert.
4. Run `eth_estimateGas` for the same transaction. All purchase aliases and direct BNB: recommended floor 300,000 from the contract notes. Use `max(300000, ceil(estimate*1.2))`, not a gas-cost promise. This covers transaction overhead; node estimates remain authoritative.
5. Show full sender, destination, chain, value, actual shares/tokens, refund, calldata and gas limit. Recheck account, chain, quote and authorization. Submit only the reviewed transaction with no token approval or message signature.
6. A hash is pending, not a successful purchase. Verify receipt status 1 and re-read balances and quota. Failure must remain failure.

Ethers-style read/simulation example using the actual verified ABI in `api.json`:

```js
const qty = 3n;
const value = await token['costOfShares(uint256)'](qty);
const [actualShares, spent, refund] = await token['sharesForValue(address,uint256)'](wallet, value);
// Inspect actualShares/spent/refund and token.SHARE_TOKENS().
await token['mint(uint256)'].staticCall(qty, {value});
// Submit only when authorized, with reviewed value and gasLimit.
```

Copyable review request: “On BNB Smart Chain 56, inspect the unique Vellumlot token/sale at 0xb4EF58f108343e437Dd2107E7037915C974b5e71. Read Agent ID eligibility, current window, leftFor, SHARE_PRICE, SHARE_TOKENS, costOfShares and sharesForValue. Preview mint(uint256) at the quoted wei value and show actual shares, tokens, refund, full addresses, gas and any authority changes. Execute only if authorized and still matching; request no token approval.”
