shots state

Impl

Impl is the rules engine. Declared here so every version agrees on one type identity. The methods are non-crossing: this realm threads its own cur in, so an implementation reaching Store is seen as this realm. The caller's address and the coins received are established by the entry points below and passed in; an implementation cannot be invoked with forged ones from elsewhere, because without this realm's live cur it cannot reach the state at all.

Denom

Denom is the coin pots are held in.

Admin

Admin may accept, roll back or freeze an implementation. The value is the standard test1 account so the tests run unedited; set your own address before deploying (TransferAuthority moves it afterwards).

proxy

selfPath

init.5

CreateGame

CreateGame opens a game. Send the initial pot with the call (ugnot). config overrides the default constants as "key=value,..." ("" for the defaults; see penalty.ParseConfig). timeoutBlocks 0 picks the default. Returns the game id.

JoinGame

JoinGame starts a shootout in an open game. Send exactly its entry fee.

TopUp

TopUp adds the coins sent to a game's pot.

TakeShot

TakeShot plays the player's kick for the current round against the chain's keeper: aim point on the goal plane (mm), contact offset on the ball (milli-radii) and power (per-mille). Returns the kick as JSON.

SubmitKeeperPlan

SubmitKeeperPlan plays the player's keeper plan against the chain's kick for the current round: four uint16 (see penalty.DecodePlan). Returns the kick as JSON.

Forfeit

Forfeit ends the current shootout as a loss: the player may resign at any time, anyone else once the player has been idle for the game's timeout.

CancelGame

CancelGame refunds the pot to the creator of a game nobody has played yet.

SimulateShot

SimulateShot runs the live outcome function on ten inputs, without touching any state: the taker's aim, contact, power and 48-hex-char mishit seed, and the keeper's four uint16, under config ("" for the defaults). Returns JSON.

GameJSON

GameJSON returns game id as JSON ("" if it does not exist).

SessionJSON

SessionJSON returns session no of a game, kicks included, as JSON.

ListGames

ListGames returns up to limit games as a JSON array, newest first, optionally filtered by status ("open", "playing", "won", "cancelled"; "" for all).

VerifySession

VerifySession re-runs every recorded kick of a shootout through the live outcome function and reports whether all of them reproduce, so anyone can check a result from the ten recorded inputs alone.

GameCount

GameCount returns how many games have been created.

receivePayment

receivePayment returns the ugnot sent with a direct user call. The coin envelope is credited to this realm only when this realm is the message's target, so a payment from any other call shape is refused rather than trusted.

assertFreeDirectCall

assertFreeDirectCall requires a direct user call that sends no coins.

assertDirect

Register

Register records the calling realm as a candidate implementation; an implementation calls it from its own init. Nothing serves until Accept.

Accept

Accept makes the candidate at pkgPath live. Authority only.

Withdraw

Withdraw drops a candidate. Authority only, or the candidate itself.

Rollback

Rollback restores the previous implementation. Authority only.

Forget

Forget drops the rollback history. Authority only.

Freeze

Freeze ends upgradeability permanently. Authority only.

AddExtension

AddExtension lets another realm act as this one. Authority only.

DropExtension

DropExtension revokes one. Authority only.

TransferAuthority

TransferAuthority hands the power to upgrade to another address.

TransferAuthorityToRealms

TransferAuthorityToRealms hands it to governance realms (comma-separated).

LivePath

Frozen

Authority

Extensions

PendingPaths

HistoryPaths

live

itoa

games

// gameKey(id) -> \*shootout.Game

sessions

// sessionKey(id, no) -> \*shootout.Session

lastID

gameKey

sessionKey

getGame

getSession

StateRef

StateRef is a permission to read and write the game state, handed to code running on this realm's cur. It carries the caller's realm value and re-checks it on every operation, so it cannot be stashed (the VM refuses to persist a realm value) or replayed after its frame returns.

Store

Store hands a StateRef to the live implementation, or to a registered extension. Any other realm presents its own cur and is refused.

assertStateAccess

assertStateAccess panics unless rlm is a live cur belonging to this realm or to a registered extension.

q

kv

obj

gameJSON

resultJSON

shotJSON

planJSON

kickJSON

sessionJSON

Render

Render shows the games list, one game ("game/\<id>") or one shootout ("game/\<id>/\<session>").

ugnot

renderHome

renderGame

score

renderSession