kewrchess_v2 state

ChallengeWindowSeconds

// 3-minute challenge window for settlement proposals

TurnTimeoutSeconds

// 2-minute move timeout when opponent is AFK (Abandonment)

getVerifiedCaller

games

Stores all chess games permanently on the blockchain

nextGameID

matchmakingQueue

On-chain matchmaking queue (FIFO)

init.6

CreateGame

CreateGame creates a new direct game challenge

CreateGameInternal

JoinQueue

JoinQueue registers a player into the on-chain matchmaking queue. If the queue is empty, the player is added to the queue. If another player is already waiting, both players are immediately matched into a new game.

JoinQueueInternal

LeaveQueue

LeaveQueue cancels and removes a player from the on-chain matchmaking queue

LeaveQueueInternal

makeMoveInternal

MakeMove

MakeMove moves a piece (defaults to Queen on promotion)

MakeMoveInternal

MakeMovePromote

MakeMovePromote moves a piece with a specified promotion piece (Q, R, B, N)

MakeMovePromoteInternal

Resign

Resign resigns the game for the calling player

ResignInternal

OfferDraw

OfferDraw offers a draw to the opponent

OfferDrawInternal

AcceptDraw

AcceptDraw accepts a draw offer from the opponent

AcceptDrawInternal

DeclineDraw

DeclineDraw declines a draw offer from the opponent

DeclineDrawInternal

ProposeSettlement

ProposeSettlement submits a victory claim for off-chain chess results. Prevents fraudulent opponent moves: proposal opens a challenge period. Opponent can confirm immediately (ConfirmSettlement), or dispute if cheated (DisputeSettlement). If opponent does not respond, winner can finalize after ChallengeWindowSeconds expires. ProposeSettlement submits a victory claim for off-chain chess results. Prevents fraudulent opponent moves: proposal opens a challenge period. Opponent can confirm immediately (ConfirmSettlement), or dispute if cheated (DisputeSettlement). If opponent does not respond, winner can finalize after ChallengeWindowSeconds expires.

ProposeSettlementInternal

ConfirmSettlement

ConfirmSettlement allows opponent to immediately approve final result without waiting for challenge window

ConfirmSettlementInternal

FinalizeSettlement

FinalizeSettlement officially finalizes the game after the challenge period has passed

FinalizeSettlementInternal

DisputeSettlement

DisputeSettlement allows opponent to dispute a fraudulent settlement proposal

DisputeSettlementInternal

SettleGame

SettleGame proposes settlement and finalizes immediately if challenge window is 0

SettleGameInternal

StartTurnTimer

StartTurnTimer is initiated when opponent goes AFK or closes browser (Rage Quit) during an off-chain game. Player submits current move history (currentMovesUCI). Smart contract validates the board and ensures it is the OPPONENT'S TURN.

StartTurnTimerInternal

ClaimTimeout

ClaimTimeout allows the challenger to win the game after the opponent goes AFK/rage quits and turnDeadline has passed without a response move from the opponent.

ClaimTimeoutInternal

GetGamesCount

GetGamesCount returns the total number of games

GetBoard

GetBoard returns the 8x8 board for a given game ID

GetWhitePlayer

GetBlackPlayer

IsWhiteTurn

IsWhiteTurn returns whether it is White's turn for a given game ID

GetGameStatus

GetGameStatus returns the game status for a given game ID

GetDrawOfferedBy

GetResignedBy

GetQueueCount

GetQueueCount returns the number of players waiting in the matchmaking queue

IsInQueue

IsInQueue checks if an address is currently waiting in the matchmaking queue

GetActiveGameForPlayer

GetActiveGameForPlayer searches for the latest active game ("PLAYING") for a given address. Returns -1 if no active game found.

GetLatestGameForPlayer

GetLatestGameForPlayer returns the latest game ID involving the player, or -1 if none.

GetSettledBy

GetProposedBy

GetPendingStatus

GetPendingStatus returns the pending status of settlement

GetChallengeDeadline

GetChallengeDeadline returns the deadline unix timestamp for challenging settlement

GetTurnDeadline

GetTurnDeadline returns the deadline unix timestamp for turn timeout

GetTurnChallengedBy

Render

Game

Game represents an on-chain chess game session

NewGame

NewGame initializes a new game with the standard chess starting layout