game9 state

admin

minterAddr

// authorized minter realm (minter5) — set via SetMinter

pendingMints

// addr+":"+coinId → amount string

balances

// addr+":"+coinId → amount string

veinSupply

// coinId → "remaining:max"

casinoRounds

// roundId → JSON string

pvpLobbies

// lobbyId → JSON string

pvpWagers

// lobbyId → "coinId:amount:creator:challenger" (challenger="" until joined)

ownedTools

// addr → comma-separated tool IDs

toolLife

// addr+":"+toolId → remaining life string

lifetimeMined

// addr+":"+coinId → total mined string

achievements

// addr+":"+achId → "1"

dailyCheckins

// addr → unix seconds string

skillRanks

// addr+":"+skillId → rank string

miners

// addr → total mined all-time string

lastClaim

// addr → unix timestamp of last ClaimMine/ClaimAndMint (velocity limit)

blacklist

// addr → "reason:timestamp"

banExpiries

// addr → unix expiry (0 = permanent)

paused

toolCosts

toolCosts maps toolId → slice of \[coinId, amount] pairs. Copied from catalog.ts TOOLS array. Amounts are for qty=1. Phase 5: expanded tool costs — each tool requires more ingredient types at higher tiers. Matches catalog.ts TOOLS array exactly.

skillBaseCosts

skillBaseCosts maps skillId → base cost at rank 0. Actual cost at rank N = base × 2^N (doubles per rank).

skillMaxRanks

skillMaxRanks maps skillId → maximum rank allowed. Most skills cap at 3 or 4 — see catalog.ts SKILLS\[\*].max.

toolMaxLife

toolMaxLife maps toolId → maximum durability (from catalog.ts tool.life). Tools with life=0 are indestructible (hands, twig).

init.23

isAdmin

SetMinter

SetMinter registers the authorized minter realm address so it can call ClearPendingMints. Called once after minter5 is deployed.

UpdateConfig

SetPaused

requireNotPaused

BanAddress

BanAddress bans a player address. durationSecs=0 means permanent.

UnbanAddress

UnbanAddress removes a ban.

BlacklistStatus

BlacklistStatus returns the ban status of an address as a JSON string.

isBlacklisted

isBlacklisted checks if an address is currently banned (unexpired).

ClaimMine

ClaimMine records mined coins into pending mints for the caller. coinsJson format: \[\["coinId","amount"],...]

ClearPendingMints

ClearPendingMints is called by the treasury server after successful GRC20 minting. Removes pending balance and credits the player's spendable balances tree.

ClaimAndMint

ClaimAndMint records mined coins AND immediately credits them to balances. The caller pays their own gas (~0.03 GNOT). No treasury involvement. Replaces the two-step ClaimMine → mintPending flow for new players. Phase 6: treasury burn-rate fix — at 100 players using ClaimAndMint, the treasury pays ~0 GNOT/day (down from ~12 GNOT/day with the old two-step flow).

CommitCasinoSeed

PlaceCasinoBet

RevealCasinoSeed

RefundCasinoBet

CreatePvpLobby

CreatePvpLobby creates a new PvP lobby and escrows the creator's wager from balances. Phase 6: wager > 0 deducts from balances and records the escrow in pvpWagers.

JoinPvpLobby

JoinPvpLobby joins an existing PvP lobby and escrows the challenger's matching wager. Phase 6: deducts challenger's matching wager from balances and updates pvpWagers.

CommitPvpMove

RevealPvpMove

RevealPvpMove requires both players to have committed before either can reveal. Phase 6: when both players have revealed, determines the RPS winner and pays out 2× wager minus 2% rake to the winner. Draw = full refund to both players. pvpWagers.Remove is called after payout to prevent double-payouts.

ClaimPvpTimeout

ClaimPvpTimeout allows a lobby participant to claim a timeout win. Only the creator or challenger may call this. Phase 6: refunds the escrowed wager to all parties who contributed.

ExpireLobbies

BuyTool

RepairTool

TrainSkill

ClaimAchievement

DailyCheckin

CreateTask

CreateTask registers a new task on-chain.

CompleteTask

RegisterVein

PendingMints

AllBalances

VeinSupply

CasinoRound

CasinoHistory

PvpLobby

OpenLobbies

JackpotPool

PlayerProfile

OwnedTools

LifetimeMined

AllMiners

GetMedals

DailyCheckinStatus

ListTasks

SkillRanks

ToolLife

Render

deductBalances

deductBalances atomically checks all balances then deducts them. Panics if any balance is insufficient — no partial deductions. costs is a slice of \[coinId, amount] pairs.

splitJsonArray