v0 state

Move

Move is one of rock, paper, or scissors, ordered so that (winner - loser + 3) % 3 == 1 for every winning pair.

Rock

Paper

Scissors

moveName

parseMove

judge

judge returns 0 for a tie, 1 if p beats h, 2 if h beats p.

revealWindow

revealWindow is how many blocks the challenger gets to reveal after the opponent accepts before the opponent can claim a forfeit win.

duelStatus

statusPending

statusAwaitingReveal

statusResolved

statusForfeited

statusCancelled

duel

duel is one asynchronous round between Challenger and Opponent. The challenger's move is hidden behind Commit until Reveal; the opponent's move is stored in the clear once they Accept.

playerState

playerState is the persisted record for one address.

duels

// duel ID -> \*duel

players

// address string -> \*playerState

nextID

totalResolved

champion

championWins

ComputeCommit

ComputeCommit hashes a move and salt exactly the way Reveal checks it, so a caller can compute their commitment (e.g. via a read-only query) before calling Open, then remember the salt to pass to Reveal later.

getOrCreate

bumpChampion

settle

settle scores a revealed round and updates both players' records.

Open

Open challenges opponentAddr to a duel, locking in the challenger's move as a commitment (see ComputeCommit) so the opponent can't see it before replying.

Accept

Accept replies to a pending duel with a plain move. Only the challenged opponent may call it; going second behind the challenger's hidden commitment is what keeps this fair.

Reveal

Reveal settles an accepted duel. Only the original challenger may call it, and only with the exact move+salt that produced their commitment.

outcomeMsg

ClaimForfeit

ClaimForfeit lets the opponent collect a default win when the challenger dodges revealing (e.g. because they saw the opponent's move and knew they'd lose) past the reveal window.

Cancel

Cancel withdraws a still-pending duel. Only the challenger may cancel, and only before the opponent accepts.

escapeInline

escapeInline neutralizes markdown-active characters in untrusted text before it's embedded inline in Render output.

renderHome

renderDuel

renderPlayer

Render

Render shows the duel lobby at "", a specific duel when path is a numeric ID, or one player's record when path is their bech32 address.