v0 state

playerStats

playerStats is the persisted record for one address.

players

// address string -> \*playerStats

king

kingRoll

reignSince

// chain height at which the current king took the throne

nonce

totalRolls

get

get returns the stored \*playerStats for addr, creating one if absent.

pseudoRoll

pseudoRoll derives a deterministic 1-100 value from the caller's address, a per-call nonce, and the current chain height, so no two calls in the same block from the same address collide, yet the result can't be pre-computed off-chain before the triggering transaction lands.

Roll

Roll throws the die for the caller. Rolling higher than the current king's roll dethrones them (crediting their finished reign in blocks) and crowns the caller as the new king.

effectiveReignBlocks

effectiveReignBlocks returns a player's accumulated reign length, including the currently-in-progress reign if they are the sitting king. It does not mutate state — it's a display-time projection.

byReign

byReign implements sort.Interface, ranking players by effective reign length descending, ties broken by best roll then address so the order is fully deterministic.

snapshot

snapshot collects all players ranked by effective reign length descending.

medal

medal returns the emoji for a given zero-based rank, or "" past the podium.

display

display returns a shortened address for table display.

Render

Render shows the current king and a reign-length leaderboard.