#Scorebank and Payout Rules

Updated: 2026-05-22

Public documentation covers only the conceptual model.

#Public Model

1. Gameplay outcomes are snapshotted as per-ended-session deltas into scorebank.
2. Scorebank is cumulative across confirmed snapshots.
3. Payout is a separate action and only executes when readiness conditions pass.
4. On payout success, scorebank resets to 0 and accumulation starts again.
5. Each ended game session can be snapshotted once.
6. ShellRunners and Flappy Bots currently use the shared Rewards V2 contract and global wallet scorebank.
7. Profile payout status and payout history are global; game selectors only affect game-specific NFT high-score sync.
8. Practice/browser sessions do not create eligible scorebank snapshots.

#Flow Chart (Detailed)

[Gameplay ended session]
   -> [Snapshot delta prepare]
   -> [snapshotScoreSigned tx]
   -> [Record tx]
   -> [Cumulative scorebank update]
   -> [Readiness evaluation]
   -> {Eligible?}
      -> No: [Wait + continue gameplay]
      -> Yes: [Payout execution + history update + scorebank reset]