Distribution
A Loot’s play style decides how the pool splits among claimers. It is fixed at creation and enforced by the contract, so the rules cannot change after launch.
Three play styles
Section titled “Three play styles”Custom. The verifier signs an exact allocation into each voucher — a precise amount for fungible assets, or specific token IDs for NFTs. The contract releases exactly that. Use it for precision airdrops and pre-planned allocations.
Equal. Every qualified claimer receives the same share. For fungible assets the contract divides the remaining balance by the remaining seats at claim time, so the pool drains evenly regardless of claim order. For NFTs, where counts may not divide cleanly, the remainder is distributed fairly across claimers.
Random. Luck-based amounts, computed on-chain at claim time, with an expected value of remaining ÷ remaining seats. Early and late claimers face the same odds; the pool is designed to distribute completely across the seats.
For Random and Equal, the voucher carries a zero allocation and the contract computes the amount when the claim is submitted — so the split is determined on-chain and cannot be tampered with off-chain. Only Custom carries a signed amount.
How the randomness works
Section titled “How the randomness works”Random (and the NFT remainder in Equal) draws from a seed the participant cannot control. The decisive ingredient is the single-use nonce the verifier issues per claim: it is unpredictable to the claimer, valid only briefly, and burned on use. The contract combines that nonce with block-level entropy to derive the amount.
Because a claimer never knows the nonce in advance and it can only be used once before its short deadline, there is no way to grind, preview, or replay a favorable outcome — the result is fixed the moment the claim lands and applies equally to everyone.
NFT selection
Section titled “NFT selection”When a Random or Equal NFT Loot owes a claimer N tokens, the contract selects which specific token IDs to send using reservoir sampling over the pool’s still-available tokens. Selection is uniform across what remains, and each token is marked claimed so it can never be sent twice.
Settlement and capacity
Section titled “Settlement and capacity”Each claim deducts from the remaining balance, marks the recipient as having claimed, and increments the claimer count. When the balance reaches zero or the last seat is filled, the Loot transitions to Ended and any remainder becomes available for reclaim.