03 — Whisp docs

Settlement

Rounds resolve in aggregate. Each player settles later, and claims never block.

The round log

A resolve or refund writes one 64-byte entry into a ring of 8,192 rounds: the winning square, the keep rates, the stake on the winning square, the ZEC for winners, the WHISP pool and flags. The ring is a separate account of 524,296 bytes (about 2.66 SOL of rent), created by the operator because it is too large for a PDA. At about 97 s a round it holds about 9 days.

The checkpoint

Your miner account remembers the round you last played and your stake per square. The next time you act, the program reads that round's entry and credits you: SOL to the game balance, ZEC to your owed amount, WHISP to your claimable amount. Per-square credits are floored, and the aggregates booked at resolve use the same floors, so the vault always covers every claim.

Settling is automatic: your next bet or a withdraw does it, and the balance shown already counts it. Only a round left unsettled for about a day shows under the bet box with [ claim ] to settle it now.

checkpoint is permissionless: anyone can settle anyone. The crank sweeps idle players long before their round leaves the ring. If nobody settles a position in time, that round's credit is lost and the rest of the balance stays usable.

Why claims never block

  • SOL is in the vault from the moment it was staked. A credit is a bookkeeping move.
  • ZEC is owed at the posted rate. A claim pays what the vault holds and leaves the rest owed; after a day without a restock it can be taken in SOL (Liveness).
  • WHISP is credited only once the crank has booked the round's purchase, and booked tokens are already in the vault. Your SOL and ZEC from that round never wait for it.

Explain this page withClaudeChatGPTGrok