game31 state

order

type

Link

Value

game31.order

padU

func(n uint64, w int) string

Link Copy Open

OID

0a9dd2…b5d8:3

padU details

Inspect func

hexDigits

untyped string

Link

Value

"0123456789abcdef"

priceKey

func(wantAmt uint64, giveAmt uint64) string

priceKey = want-per-give × 1e12 as a fixed-width 24-hex-digit number (96 bits; amounts ≤ 1e15 keep it \< 2^90). Lexicographic = numeric order, so ascending book keys are the cheapest asks first for takers.

Link Copy Open

OID

0a9dd2…b5d8:5

priceKey details

Inspect func

sideEntryLen

untyped bigint

// priceKey(24) + id(12) + maker address(40)

Link

Value

(76 <untyped> bigint)

sideSortLen

untyped bigint

// entries sort by priceKey then id (FIFO within a price)

Link

Value

(36 <untyped> bigint)

maxSideOrders

untyped bigint

// open orders per book side; bounds every string we rewrite

Link

Value

(256 <untyped> bigint)

encodeOrder

func(o *game31.order) string

maker record: id12|give|want|remGive|remWant|expiry|pk

Link Copy Open

OID

0a9dd2…b5d8:6

encodeOrder details

Inspect func

decodeOrder

func(maker string, rec string) *game31.order

Link Copy Open

OID

0a9dd2…b5d8:7

decodeOrder details

Inspect func

makerRecs

func(maker string) []string

Link Copy Open

OID

0a9dd2…b5d8:8

makerRecs details

Inspect func

setMakerRecs

func(maker string, recs []string)

Link Copy Open

OID

0a9dd2…b5d8:9

setMakerRecs details

Inspect func

loadOrderOf

func(maker string, id uint64) *game31.order

loadOrderOf finds one of maker's open orders (≤ 20 records scanned).

Link Copy Open

OID

0a9dd2…b5d8:10

loadOrderOf details

Inspect func

saveOrder

func(o *game31.order)

Link Copy Open

OID

0a9dd2…b5d8:11

saveOrder details

Inspect func

sideKey

func(want string, give string) string

Link Copy Open

OID

0a9dd2…b5d8:12

sideKey details

Inspect func

sideEntry

func(o *game31.order) string

Link Copy Open

OID

0a9dd2…b5d8:13

sideEntry details

Inspect func

sideStr

func(k string) string

Link Copy Open

OID

0a9dd2…b5d8:14

sideStr details

Inspect func

sideSearch

func(s string, key string) int

sideSearch returns the index of the first entry whose sort key is ≥ key.

Link Copy Open

OID

0a9dd2…b5d8:15

sideSearch details

Inspect func

sideInsert

func(o *game31.order)

Link Copy Open

OID

0a9dd2…b5d8:16

sideInsert details

Inspect func

sideRemove

func(o *game31.order)

Link Copy Open

OID

0a9dd2…b5d8:17

sideRemove details

Inspect func

iterSide

func(pay string, get string, fn func(...))

iterSide walks a taker's side (pays \`pay\`, gets \`get\`) best price first.

Link Copy Open

OID

0a9dd2…b5d8:18

iterSide details

Inspect func

sideCount

func(pay string, get string) int

Link Copy Open

OID

0a9dd2…b5d8:19

sideCount details

Inspect func

grinValueMilli

func(coin string, amt uint64) uint64

grinValueMilli = amt × reference value (milli-grin), saturating at 2^64-1.

Link Copy Open

OID

0a9dd2…b5d8:20

grinValueMilli details

Inspect func

openOrderCount

func(maker string) uint64

Link Copy Open

OID

0a9dd2…b5d8:21

openOrderCount details

Inspect func

PlaceOrder

func(give string, giveAmt uint64, want string, wantAmt uint64, expirySecs int64) uint64

PlaceOrder escrows giveAmt of \`give\` and lists it for wantAmt of \`want\` (any pair). No upfront posting fee — the 0.90% maker fee is deducted from the maker's proceeds at fill time. Returns the order id. expirySecs 0 = 72 h; max 7 days.

Link Copy Open

OID

0a9dd2…b5d8:22

PlaceOrder details

Inspect func

closeOrder

func(o *game31.order, reason string)

closeOrder refunds the remaining escrow to the MAKER (never anyone else) and deletes the order. Every close path goes through here.

Link Copy Open

OID

0a9dd2…b5d8:23

closeOrder details

Inspect func

CancelOrder

func(id uint64)

CancelOrder: the maker gets the remaining escrow back. Works while paused and for banned makers; only the maker can cancel.

Link Copy Open

OID

0a9dd2…b5d8:24

CancelOrder details

Inspect func

SweepExpiredOrders

func(pay string, get string) int

SweepExpiredOrders closes up to maxScanPerTx expired orders of one book side, refunding each maker. Anyone may call it (also while paused).

Link Copy Open

OID

0a9dd2…b5d8:25

SweepExpiredOrders details

Inspect func

fillStep

type

Link

Value

game31.fillStep

planFills

func(caller string, pay string, get string, budget uint64, maxFills int, now int64) ([]game31.fillStep, []*game31.order, uint64, uint64)

planFills walks the book for a taker (read-only). budget is the most the taker will spend INCLUDING the taker fee. Own orders are skipped (no self-match); expired orders are returned for closing.

Link Copy Open

OID

0a9dd2…b5d8:26

planFills details

Inspect func

executeFills

func(caller string, pay string, steps []game31.fillStep) uint64

executeFills applies a plan: the taker pays each maker x (plus taker fee), receives g from escrow. The maker receives x minus the 0.90% maker fee (deducted from proceeds, not from escrow). Returns total received by taker.

Link Copy Open

OID

0a9dd2…b5d8:27

executeFills details

Inspect func

FillOrders

func(pay string, get string, payAmt uint64, minGet uint64, maxFills int, deadline int64) uint64

FillOrders: spend at most payAmt of \`pay\` (taker fee included) on the best-priced orders that give \`get\`; receive at least minGet or revert. ≤ 10 fills and ≤ 20 scanned entries per call.

Link Copy Open

OID

0a9dd2…b5d8:28

FillOrders details

Inspect func

orderJSON

func(o *game31.order) string

Link Copy Open

OID

0a9dd2…b5d8:29

orderJSON details

Inspect func

Order

func(maker string, id uint64) string

Order shows one open order of \`maker\` (lookups are per maker by design).

Link Copy Open

OID

0a9dd2…b5d8:30

Order details

Inspect func

OrdersOf

func(addr string) string

OrdersOf lists an address's open orders (≤ 20 by construction).

Link Copy Open

OID

0a9dd2…b5d8:31

OrdersOf details

Inspect func

BookDepth

func(pay string, get string, limit int, offset int) string

BookDepth lists asks for a taker who pays \`pay\` and gets \`get\`, best price first (≤ 50 rows; offset \< maxSideOrders).

Link Copy Open

OID

0a9dd2…b5d8:32

BookDepth details

Inspect func

QuoteFill

func(caller string, pay string, get string, payAmt uint64, maxFills int) string

QuoteFill previews FillOrders for a budget (fee included): {"spent","got"}.

Link Copy Open

OID

0a9dd2…b5d8:33

QuoteFill details

Inspect func

hubCoin

untyped string

Link

Value

"grin"

poolFeeBps

uint64

Link

Value

50

protoFeeBps

uint64

Link

Value

15

minLiquidity

uint64

// first-deposit shares burned forever

Link

Value

1000

minOpenDepthGrin

uint64

// a pool takes swaps only once rGrin ≥ this

Link

Value

2000

warmupSecs

int64

// LP fee warm-up (principal always instant)

Link

Value

600

rootKScale

uint64

Link

Value

1000000000

takerFeeBps

uint64

Link

Value

50

makerFeeBps

uint64

Link

Value

90

minOrderGrinX1k

uint64

// 50 grin of value (reference table) — size floor only

Link

Value

50000

maxOpenOrders

uint64

Link

Value

20

defaultExpiry

int64

Link

Value

259200

maxExpiry

int64

Link

Value

604800

maxFillsPerTx

untyped bigint

Link

Value

(10 <untyped> bigint)

maxScanPerTx

untyped bigint

Link

Value

(20 <untyped> bigint)

maxViewLimit

untyped bigint

Link

Value

(50 <untyped> bigint)

maxAmount

uint64

// 1e15

Link

Value

1000000000000000

prefMilli

[7]uint64

Reference value per rarity in milli-grin (RARITY\_VALUE ×1000). Used ONLY for the 50-grin minimum order size — never for prices.

Link Copy Open

OID

0a9dd2…b5d8:35

prefMilli details

Inspect array

pools

v0.Tree

// coin → \*pool

Link Copy Open

OID

0a9dd2…b5d8:37

pools details

Inspect ref

lpPositions

v0.Tree

// coin+":"+addr → \*lpPos

Link Copy Open

OID

0a9dd2…b5d8:39

lpPositions details

Inspect ref

adminFees

v0.Tree

// coin → admin's accrued protocol fees (pull)

Link Copy Open

OID

0a9dd2…b5d8:41

adminFees details

Inspect ref

casinoPool

v0.Tree

// coin → casino pool balance (fees in, capped jackpots out)

Link Copy Open

OID

0a9dd2…b5d8:43

casinoPool details

Inspect ref

makerBooks

v0.Tree

// maker → ";"-joined compact order records (≤ maxOpenOrders)

Link Copy Open

OID

0a9dd2…b5d8:45

makerBooks details

Inspect ref

sides

v0.Tree

// want+">"+give → sorted fixed-width entries (≤ maxSideOrders)

Link Copy Open

OID

0a9dd2…b5d8:47

sides details

Inspect ref

openOrderTotal

uint64

Link

Value

0

nextOrderId

uint64

Link

Value

0

exPaused

bool

Link

Value

false

adminFeesWithdrawn

v0.Tree

// coin → lifetime withdrawn by the admin

Link Copy Open

OID

0a9dd2…b5d8:52

adminFeesWithdrawn details

Inspect ref

adminGnotWithdrawn

int64

// ugnot withdrawn by WithdrawFunds (≤ passRevenueUgnot)

Link

Value

0

addChk

func(a uint64, b uint64) uint64

Link Copy Open

OID

0a9dd2…b5d8:54

addChk details

Inspect func

subChk

func(a uint64, b uint64) uint64

Link Copy Open

OID

0a9dd2…b5d8:56

subChk details

Inspect func

mulDiv

func(a uint64, b uint64, c uint64) uint64

mulDiv = floor(a\*b/c) with a 128-bit product; panics if c == 0 or the quotient does not fit in 64 bits.

Link Copy Open

OID

0a9dd2…b5d8:57

mulDiv details

Inspect func

mulDivUp

func(a uint64, b uint64, c uint64) uint64

mulDivUp = ceil(a\*b/c).

Link Copy Open

OID

0a9dd2…b5d8:58

mulDivUp details

Inspect func

isqrt128

func(a uint64, b uint64) uint64

isqrt128 = floor(sqrt(a\*b)) for the 128-bit product (Newton, bounded).

Link Copy Open

OID

0a9dd2…b5d8:59

isqrt128 details

Inspect func

isqrt

func(n uint64) uint64

Link Copy Open

OID

0a9dd2…b5d8:60

isqrt details

Inspect func

mulLess

func(a uint64, b uint64, c uint64, d uint64) bool

mulLess reports a\*b \< c\*d using 128-bit products.

Link Copy Open

OID

0a9dd2…b5d8:61

mulLess details

Inspect func

requireBalance

func(addr string, coin string, amt uint64)

requireBalance checks a balance before any write, so a failing call changes nothing (validate-then-write).

Link Copy Open

OID

0a9dd2…b5d8:62

requireBalance details

Inspect func

requireAmount

func(name string, v uint64)

Link Copy Open

OID

0a9dd2…b5d8:63

requireAmount details

Inspect func

u

func(n uint64) string

Link Copy Open

OID

0a9dd2…b5d8:64

u details

Inspect func

exchangeCaller

func() string

exchangeCaller returns the caller for exchange writes. Only end users (an EOA MsgCall or the user's own MsgRun) may trade: other realms can't act through the exchange, so there is no cross-realm call surface at all.

Link Copy Open

OID

0a9dd2…b5d8:65

exchangeCaller details

Inspect func

requireMarketOpen

func(caller string)

requireMarketOpen gates NEW activity (swaps, deposits, orders, fills). Trading opens only after FinalizeMigration: MigrateBatch SETs balances, so trading before that could duplicate or lose escrowed coins.

Link Copy Open

OID

0a9dd2…b5d8:66

requireMarketOpen details

Inspect func

requireDeadline

func(deadline int64)

Link Copy Open

OID

0a9dd2…b5d8:67

requireDeadline details

Inspect func

requireCoin

func(coin string) int

Link Copy Open

OID

0a9dd2…b5d8:68

requireCoin details

Inspect func

accrueProtocolFee

func(coin string, amt uint64)

accrueProtocolFee splits amt of coin 50/50: the floor half to the admin's fee ledger, the rest to the casino pool. Both stay inside the realm.

Link Copy Open

OID

0a9dd2…b5d8:69

accrueProtocolFee details

Inspect func

WithdrawProtocolFees

func(coin string) uint64

WithdrawProtocolFees moves the admin's OWN accrued fees for \`coin\` into the admin's balance. It reads only adminFees (never reserves, escrow, the casino pool or anyone's balance) and works while paused.

Link Copy Open

OID

0a9dd2…b5d8:70

WithdrawProtocolFees details

Inspect func

SetExchangePaused

func(p bool)

SetExchangePaused stops NEW swaps, deposits, orders and fills. It can't stop RemoveLiquidity, CancelOrder, SweepExpiredOrders or fee withdrawals.

Link Copy Open

OID

0a9dd2…b5d8:71

SetExchangePaused details

Inspect func

ExchangeStatus

func() string

Link Copy Open

OID

0a9dd2…b5d8:72

ExchangeStatus details

Inspect func

ProtocolFees

func(coin string) string

Link Copy Open

OID

0a9dd2…b5d8:73

ProtocolFees details

Inspect func

pool

type

Link

Value

game31.pool

lpPos

type

Link

Value

game31.lpPos

getPool

func(coin string) *game31.pool

Link Copy Open

OID

0a9dd2…b5d8:74

getPool details

Inspect func

rootKPerShare

func(p *game31.pool) uint64

Link Copy Open

OID

0a9dd2…b5d8:76

rootKPerShare details

Inspect func

CreatePool

func(coin string)

CreatePool opens an empty COIN/GRIN pool (admin, per the launch schedule). It holds nothing until players deposit; the admin can't deposit for anyone, withdraw from it or close it.

Link Copy Open

OID

0a9dd2…b5d8:77

CreatePool details

Inspect func

OpenPool

func(coin string, coinAmt uint64, grinAmt uint64, minShares uint64, deadline int64) uint64

OpenPool creates a new COIN/GRIN pool and immediately deposits the first liquidity, atomically setting the opening price. Any player who holds the coin and enough Grin can call this — no admin required. coinAmt and grinAmt set the price ratio; whoever calls this first for a coin controls the opening price, so choose amounts that reflect the coin's real value. 1,000 shares are permanently burned as a sandwich-resistance seed. Returns the number of LP shares minted for the caller.

Link Copy Open

OID

0a9dd2…b5d8:78

OpenPool details

Inspect func

SetPoolPaused

func(coin string, p bool)

SetPoolPaused stops new swaps and deposits on one pool. Withdrawals stay open.

Link Copy Open

OID

0a9dd2…b5d8:79

SetPoolPaused details

Inspect func

AddLiquidity

func(coin string, coinMax uint64, grinMax uint64, minShares uint64, deadline int64) uint64

AddLiquidity deposits up to coinMax of \`coin\` and grinMax grin. The first deposit sets the price (open economy: any ratio) and burns minLiquidity shares; later deposits take the current ratio (never more than either cap). Reverts unless at least minShares are minted.

Link Copy Open

OID

0a9dd2…b5d8:80

AddLiquidity details

Inspect func

lpPayout

func(p *game31.pool, pos *game31.lpPos, shares uint64, now int64) (uint64, uint64)

lpPayout computes what \`shares\` of a position withdraw right now: pro-rata of CURRENT reserves (floor). Within the warm-up the fee growth since entry (√k/share above entry) stays in the pool for the other LPs; principal is never cut below its entry-value share.

Link Copy Open

OID

0a9dd2…b5d8:81

lpPayout details

Inspect func

RemoveLiquidity

func(coin string, shares uint64, minCoin uint64, minGrin uint64, deadline int64) (uint64, uint64)

RemoveLiquidity is instant and ALWAYS available: it works while the exchange or the pool is paused, before or after a ban, and needs no tool. Nobody but the position owner can call it for that position.

Link Copy Open

OID

0a9dd2…b5d8:82

RemoveLiquidity details

Inspect func

poolQuote

func(p *game31.pool, inIsHub bool, amountIn uint64) (uint64, uint64)

poolQuote returns (out, protoFee) for amountIn of the input side; no writes.

Link Copy Open

OID

0a9dd2…b5d8:83

poolQuote details

Inspect func

poolOpenForSwaps

func(p *game31.pool) bool

Link Copy Open

OID

0a9dd2…b5d8:84

poolOpenForSwaps details

Inspect func

poolSwap

func(p *game31.pool, inIsHub bool, amountIn uint64) uint64

poolSwap executes one hop (coin↔grin) for \`caller\`, crediting nothing to the caller: it returns the output so routes can chain hops. The caller's input must already have been debited.

Link Copy Open

OID

0a9dd2…b5d8:85

poolSwap details

Inspect func

SwapExactIn

func(coinIn string, coinOut string, amountIn uint64, minOut uint64, deadline int64) uint64

SwapExactIn swaps amountIn of coinIn for at least minOut of coinOut through one pool (one side must be grin). For X→Y via grin use SwapRoute.

Link Copy Open

OID

0a9dd2…b5d8:86

SwapExactIn details

Inspect func

poolJSON

func(p *game31.pool) string

Link Copy Open

OID

0a9dd2…b5d8:87

poolJSON details

Inspect func

PoolInfo

func(coin string) string

Link Copy Open

OID

0a9dd2…b5d8:88

PoolInfo details

Inspect func

Pools

func(limit int, offset int) string

Pools lists pools in coin order (paginated, ≤ 50 per call).

Link Copy Open

OID

0a9dd2…b5d8:89

Pools details

Inspect func

QuoteSwap

func(coinIn string, coinOut string, amountIn uint64) string

QuoteSwap quotes a single-pool swap; "0" if the pool can't take it.

Link Copy Open

OID

0a9dd2…b5d8:90

QuoteSwap details

Inspect func

LpPosition

func(coin string, addr string) string

LpPosition shows one position and what it would withdraw right now.

Link Copy Open

OID

0a9dd2…b5d8:91

LpPosition details

Inspect func

LpPositions

func(addr string, limit int, offset int) string

LpPositions lists an address's positions (bounded: at most one per pool, paginated by pool order, ≤ 50 pools scanned per call).

Link Copy Open

OID

0a9dd2…b5d8:92

LpPositions details

Inspect func

poolPathOut

func(coinIn string, coinOut string, amountIn uint64) (uint64, bool)

poolPathOut quotes amountIn of coinIn → coinOut through the grin pools (one hop if either side is grin, else coinIn→grin→coinOut). ok=false if a needed pool is missing or not open. Read-only.

Link Copy Open

OID

0a9dd2…b5d8:93

poolPathOut details

Inspect func

routePlan

func(caller string, coinIn string, coinOut string, amountIn uint64, maxFills int, now int64) ([]game31.fillStep, []*game31.order, uint64, uint64, uint64)

routePlan splits amountIn between book fills (direct pair) and the pool path. A book fill is taken while its rate is at least the pool path's average rate for the whole remainder; everything else goes to the pools.

Link Copy Open

OID

0a9dd2…b5d8:95

routePlan details

Inspect func

SwapRoute

func(coinIn string, coinOut string, amountIn uint64, minOut uint64, maxFills int, deadline int64) uint64

SwapRoute swaps up to amountIn of coinIn for at least minOut of coinOut, using the order book (direct pair) while it beats the pools and the grin pools for the rest. Coins not needed are never debited.

Link Copy Open

OID

0a9dd2…b5d8:96

SwapRoute details

Inspect func

QuoteRoute

func(caller string, coinIn string, coinOut string, amountIn uint64, maxFills int) string

QuoteRoute previews SwapRoute: how much goes to the book vs the pools and the expected output (fees included).

Link Copy Open

OID

0a9dd2…b5d8:97

QuoteRoute details

Inspect func

init.108

func()

Link Copy Open

OID

0a9dd2…b5d8:98

init.108 details

Inspect func

isAdmin

func() bool

Link Copy Open

OID

0a9dd2…b5d8:100

isAdmin details

Inspect func

requireAdmin

func()

Link Copy Open

OID

0a9dd2…b5d8:101

requireAdmin details

Inspect func

TransferAdmin

func(newAdmin string)

TransferAdmin hands the admin role to another address.

Link Copy Open

OID

0a9dd2…b5d8:102

TransferAdmin details

Inspect func

transferAdmin

func(newAdmin string)

Link Copy Open

OID

0a9dd2…b5d8:103

transferAdmin details

Inspect func

UpdateConfig

func(newAdmin string)

UpdateConfig is kept for game27/28 API compatibility (= TransferAdmin).

Link Copy Open

OID

0a9dd2…b5d8:104

UpdateConfig details

Inspect func

SetClaimSigner

func(pubKeyHex string)

SetClaimSigner registers the ed25519 public key (64 hex chars) of the server's claim signer. Pass "" to disable all vouchered calls (kill switch).

Link Copy Open

OID

0a9dd2…b5d8:105

SetClaimSigner details

Inspect func

ClaimSigner

func() string

Link Copy Open

OID

0a9dd2…b5d8:106

ClaimSigner details

Inspect func

Admin

func() string

Link Copy Open

OID

0a9dd2…b5d8:107

Admin details

Inspect func

SetPaused

func(p bool)

Link Copy Open

OID

0a9dd2…b5d8:108

SetPaused details

Inspect func

IsPaused

func() bool

Link Copy Open

OID

0a9dd2…b5d8:109

IsPaused details

Inspect func

requireNotPaused

func()

Link Copy Open

OID

0a9dd2…b5d8:110

requireNotPaused details

Inspect func

BanAddress

func(targetAddr string, reason string, durationSecs int64)

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

Link Copy Open

OID

0a9dd2…b5d8:111

BanAddress details

Inspect func

UnbanAddress

func(targetAddr string)

Link Copy Open

OID

0a9dd2…b5d8:112

UnbanAddress details

Inspect func

BlacklistStatus

func(addr string) string

Link Copy Open

OID

0a9dd2…b5d8:113

BlacklistStatus details

Inspect func

isBlacklisted

func(addr string) bool

Link Copy Open

OID

0a9dd2…b5d8:114

isBlacklisted details

Inspect func

requirePlayer

func() string

Link Copy Open

OID

0a9dd2…b5d8:115

requirePlayer details

Inspect func

veinMax

func(coinId string) uint64

Link Copy Open

OID

0a9dd2…b5d8:116

veinMax details

Inspect func

veinMintedOf

func(coinId string) uint64

Link Copy Open

OID

0a9dd2…b5d8:117

veinMintedOf details

Inspect func

takeFromVein

func(coinId string, amt uint64) uint64

takeFromVein returns how much of amt can still be minted for coinId and records it as minted.

Link Copy Open

OID

0a9dd2…b5d8:118

takeFromVein details

Inspect func

SetVeinMax

func(coinId string, maxSupply string)

SetVeinMax overrides a coin's vein size. It can't go below what was minted.

Link Copy Open

OID

0a9dd2…b5d8:119

SetVeinMax details

Inspect func

setVeinMax

func(coinId string, maxSupply string)

Link Copy Open

OID

0a9dd2…b5d8:120

setVeinMax details

Inspect func

RegisterVein

func(coinId string, maxSupply string)

RegisterVein is the game28 name for SetVeinMax.

Link Copy Open

OID

0a9dd2…b5d8:121

RegisterVein details

Inspect func

VeinSupply

func(coinId string) string

Link Copy Open

OID

0a9dd2…b5d8:122

VeinSupply details

Inspect func

SetPassPrice

func(ugnotPer30Days int64)

SetPassPrice sets the ugnot price per 30-day period.

Link Copy Open

OID

0a9dd2…b5d8:123

SetPassPrice details

Inspect func

PassPrice

func() int64

Link Copy Open

OID

0a9dd2…b5d8:124

PassPrice details

Inspect func

ActivateGnomePass

func(durationDays int64)

ActivateGnomePass buys durationDays (30..360, multiple of 30) of Gnome Pass. The tx must attach exactly passPrice × durationDays/30 ugnot (MsgCall send).

Link Copy Open

OID

0a9dd2…b5d8:125

ActivateGnomePass details

Inspect func

GnomePassExpiry

func(addr string) int64

Link Copy Open

OID

0a9dd2…b5d8:126

GnomePassExpiry details

Inspect func

HasActivePass

func(addr string) bool

Link Copy Open

OID

0a9dd2…b5d8:127

HasActivePass details

Inspect func

GnomePassCount

func() int

Link Copy Open

OID

0a9dd2…b5d8:128

GnomePassCount details

Inspect func

PassRevenue

func() int64

Link Copy Open

OID

0a9dd2…b5d8:129

PassRevenue details

Inspect func

TreasuryBalance

func() int64

TreasuryBalance returns the ugnot held by this realm (pass revenue not yet withdrawn).

Link Copy Open

OID

0a9dd2…b5d8:130

TreasuryBalance details

Inspect func

WithdrawFunds

func(to string, amountUgnot int64)

WithdrawFunds sends GNOT the admin is OWED — Gnome Pass revenue not yet withdrawn — to \`to\`. It can never touch other ugnot the realm holds (donations, anything a future feature would hold for players).

Link Copy Open

OID

0a9dd2…b5d8:131

WithdrawFunds details

Inspect func

WithdrawableFunds

func() int64

WithdrawableFunds = pass revenue the admin may still withdraw (ugnot).

Link Copy Open

OID

0a9dd2…b5d8:132

WithdrawableFunds details

Inspect func

MigrateBatch

func(batchId string, kind string, rowsJson string) int

── Migration (game27 / game28 → game29) ──────────────────────────────────── MigrateBatch(batchId, kind, rowsJson) imports one batch. rowsJson is a JSON array of string arrays. Kinds and row shapes: balance [addr, coinId, amount] → balances (SET, not add) lifetime [addr, coinId, amount] → lifetimeMined (SET) + miners total tools [addr, "t1,t2,..."] → ownedTools (SET, unknown ids dropped) toollife [addr, toolId, life] → toolLife (SET, clamped to max) skill [addr, skillId, rank] → skillRanks (SET, clamped to max) medal [addr, achievementId] → achievements (allowlisted ids only) pass [addr, expiryUnix] → gnomePasses (SET) guild [guildId, name, leader, "m1,m2,..."] → guilds + members ban [addr, reason, expiryUnix] → blacklist (expiry 0 = permanent) A batchId that was already applied is skipped, and every write is a SET, so re-running a whole migration is a no-op. FinalizeMigration locks it forever.

Link Copy Open

OID

0a9dd2…b5d8:133

MigrateBatch details

Inspect func

FinalizeMigration

func()

Link Copy Open

OID

0a9dd2…b5d8:134

FinalizeMigration details

Inspect func

MigrationStatus

func() string

Link Copy Open

OID

0a9dd2…b5d8:135

MigrationStatus details

Inspect func

MigrationBatch

func(batchId string) string

Link Copy Open

OID

0a9dd2…b5d8:136

MigrationBatch details

Inspect func

validAddr

func(s string) bool

Link Copy Open

OID

0a9dd2…b5d8:137

validAddr details

Inspect func

migrateRow

func(kind string, r []string) bool

Link Copy Open

OID

0a9dd2…b5d8:138

migrateRow details

Inspect func

casinoBets

v0.Tree

// roundId+":"+addr → \*casinoBet

Link Copy Open

OID

0a9dd2…b5d8:140

casinoBets details

Inspect ref

casinoReserved

v0.Tree

// coin → largest net payouts of unsettled bets (string)

Link Copy Open

OID

0a9dd2…b5d8:142

casinoReserved details

Inspect ref

casinoDay

v0.Tree

// coin → "day:snapshot:paid:received" (UTC day)

Link Copy Open

OID

0a9dd2…b5d8:144

casinoDay details

Inspect ref

casinoWinRange

uint64

// winning rolls per pick (of 100) for flip/wheel

Link

Value

49

rpsWinBelow

uint64

// rps: roll \< 33 player wins

Link

Value

33

rpsPushBelow

uint64

// rps: 33..64 push

Link

Value

65

casinoBetWindowSec

int64

// a committed round takes its bet within 1 h

Link

Value

3600

casinoSeedTimeoutSec

int64

// refunds open 30 min after the bet if s is never revealed

Link

Value

1800

casinoSecretTimeoutSec

int64

// the bet forfeits 24 h after s if c is never revealed

Link

Value

86400

casinoMaxBetBps

uint64

// flip / wheel / rps bet ≤ 0.5% of the free pool

Link

Value

50

slotsMaxBetPPM

uint64

// slots bet ≤ 0.004% of the free pool

Link

Value

40

casinoOpenBps

uint64

// open reservations on a coin ≤ 20% of the pool

Link

Value

2000

casinoDayBps

uint64

// daily net payout ≤ 10% of the day's snapshot

Link

Value

1000

casinoMinPoolMilli

uint64

// ≥ 20,000 grin-equivalent …

Link

Value

20000000

casinoMinPoolUnits

uint64

// … and ≥ 200 units of the coin

Link

Value

200

casinoMaxAmount

uint64

Link

Value

1000000000

casinoRefMilli

[7]uint64

Reference value per unit by rarity, in milli-grin (same table as the exchange plan): only used for the pool's opening threshold.

Link Copy Open

OID

0a9dd2…b5d8:146

casinoRefMilli details

Inspect array

casinoRound

type

Link

Value

game31.casinoRound

casinoBet

type

Link

Value

game31.casinoBet

isOperator

func() bool

isOperator: the casino operator key commits and reveals server seeds. Once an operator is set, only that key can; the admin (treasury) key only stands in while no operator has been named yet (bootstrap and tests).

Link Copy Open

OID

0a9dd2…b5d8:147

isOperator details

Inspect func

SetOperator

func(addr string)

SetOperator lets the admin name the server account that commits and reveals casino seeds. It must be its own key, never the admin/treasury key. The operator can't move anyone's coins.

Link Copy Open

OID

0a9dd2…b5d8:149

SetOperator details

Inspect func

Operator

func() string

Link Copy Open

OID

0a9dd2…b5d8:150

Operator details

Inspect func

casinoStats

v0.Tree

// coin:field or coin:game:field → uint (string)

Link Copy Open

OID

0a9dd2…b5d8:152

casinoStats details

Inspect ref

casStat

func(coin string, game string, field string, add uint64)

Link Copy Open

OID

0a9dd2…b5d8:153

casStat details

Inspect func

casRecord

func(coin string, game string, staked uint64, paid uint64)

Link Copy Open

OID

0a9dd2…b5d8:154

casRecord details

Inspect func

CasinoStats

func(coinId string) string

CasinoStats reports a coin's accounting: pool, reserved, jackpots, seeded, staked, paid, the conservation check and per-game rounds/staked/paid.

Link Copy Open

OID

0a9dd2…b5d8:155

CasinoStats details

Inspect func

casGet

func(t *v0.Tree, key string) uint64

Link Copy Open

OID

0a9dd2…b5d8:156

casGet details

Inspect func

casSet

func(t *v0.Tree, key string, v uint64)

Link Copy Open

OID

0a9dd2…b5d8:157

casSet details

Inspect func

casAdd

func(a uint64, b uint64) uint64

Link Copy Open

OID

0a9dd2…b5d8:158

casAdd details

Inspect func

casSub

func(a uint64, b uint64) uint64

Link Copy Open

OID

0a9dd2…b5d8:159

casSub details

Inspect func

casMulDiv

func(a uint64, b uint64, c uint64) uint64

casMulDiv = floor(a\*b/c) with a 128-bit product.

Link Copy Open

OID

0a9dd2…b5d8:160

casMulDiv details

Inspect func

casMul

func(a uint64, b uint64) uint64

Link Copy Open

OID

0a9dd2…b5d8:161

casMul details

Inspect func

casU

func(n uint64) string

Link Copy Open

OID

0a9dd2…b5d8:162

casU details

Inspect func

casBalOf

func(addr string, coin string) uint64

Link Copy Open

OID

0a9dd2…b5d8:163

casBalOf details

Inspect func

casCredit

func(addr string, coin string, amt uint64)

Link Copy Open

OID

0a9dd2…b5d8:164

casCredit details

Inspect func

casDebit

func(addr string, coin string, amt uint64)

Link Copy Open

OID

0a9dd2…b5d8:165

casDebit details

Inspect func

casGrinValueMilli

func(coin string, amt uint64) uint64

Link Copy Open

OID

0a9dd2…b5d8:166

casGrinValueMilli details

Inspect func

casIsHex64

func(s string) bool

Link Copy Open

OID

0a9dd2…b5d8:167

casIsHex64 details

Inspect func

casSafe

func(s string, maxLen int) bool

casSafe: a short \[A-Za-z0-9\_.-] token (no quotes, so it is JSON-safe).

Link Copy Open

OID

0a9dd2…b5d8:168

casSafe details

Inspect func

sha256Hex

func(s string) string

Link Copy Open

OID

0a9dd2…b5d8:169

sha256Hex details

Inspect func

CasinoRoll

func(serverSeed string, clientSecret string, roundId string, game string) uint64

CasinoRoll is the on-chain roll: uint32(sha256(s:c:roundId:game)\[0:4]) % 100.

Link Copy Open

OID

0a9dd2…b5d8:170

CasinoRoll details

Inspect func

CasinoOutcome

func(game string, roll uint64) string

CasinoOutcome maps a roll to what landed. For rps the outcome is "win" | "push" | "lose" (see rpsHouseMove for the move shown).

Link Copy Open

OID

0a9dd2…b5d8:171

CasinoOutcome details

Inspect func

rpsHouseMove

func(choice string, outcome string) string

rpsHouseMove: the house move that produces the outcome against the player's move.

Link Copy Open

OID

0a9dd2…b5d8:172

rpsHouseMove details

Inspect func

validCasinoChoice

func(game string, choice string) bool

Link Copy Open

OID

0a9dd2…b5d8:173

validCasinoChoice details

Inspect func

casinoExposure

func(game string, amt uint64) uint64

casinoExposure: the largest net amount a bet can take from the pool.

Link Copy Open

OID

0a9dd2…b5d8:174

casinoExposure details

Inspect func

casDayNow

func() int64

Link Copy Open

OID

0a9dd2…b5d8:175

casDayNow details

Inspect func

casinoDayState

func(coin string) (int64, uint64, uint64, uint64)

Link Copy Open

OID

0a9dd2…b5d8:176

casinoDayState details

Inspect func

setCasinoDay

func(coin string, day int64, snap uint64, paid uint64, recv uint64)

Link Copy Open

OID

0a9dd2…b5d8:177

setCasinoDay details

Inspect func

casinoIsOpen

func(coin string, pool uint64) bool

Link Copy Open

OID

0a9dd2…b5d8:178

casinoIsOpen details

Inspect func

casinoMaxBet

func(game string, free uint64) uint64

Link Copy Open

OID

0a9dd2…b5d8:179

casinoMaxBet details

Inspect func

casinoCheckBet

func(coin string, game string, amt uint64)

casinoCheckBet panics unless the pool can pay the bet's largest win in full (read-only).

Link Copy Open

OID

0a9dd2…b5d8:180

casinoCheckBet details

Inspect func

casinoReserve

func(coin string, exp uint64)

Link Copy Open

OID

0a9dd2…b5d8:181

casinoReserve details

Inspect func

casinoSettle

func(addr string, coin string, amt uint64, exposure uint64, payout uint64) uint64

casinoSettle releases the reservation and moves coins: the player receives \`payout\` (0 ≤ payout ≤ stake + exposure) and the pool keeps the rest of the stake or pays the difference. Returns payout.

Link Copy Open

OID

0a9dd2…b5d8:182

casinoSettle details

Inspect func

SeedCasinoPool

func(coinId string, amount string)

SeedCasinoPool moves the ADMIN'S OWN on-chain coins into a casino pool. Only ever the admin's own balance; nobody can withdraw a pool back.

Link Copy Open

OID

0a9dd2…b5d8:183

SeedCasinoPool details

Inspect func

CasinoPool

func(coinId string) string

CasinoPool reports a coin's pool, reservation, max bets and daily counters.

Link Copy Open

OID

0a9dd2…b5d8:184

CasinoPool details

Inspect func

casinoGrants

v0.Tree

// addr → \*freeSpinGrant

Link Copy Open

OID

0a9dd2…b5d8:186

casinoGrants details

Inspect ref

casinoJackpot

v0.Tree

// coin:tier → pool (string)

Link Copy Open

OID

0a9dd2…b5d8:188

casinoJackpot details

Inspect ref

casinoJpDust

v0.Tree

// coin:tier → contribution remainder in bet×bps units (string)

Link Copy Open

OID

0a9dd2…b5d8:190

casinoJpDust details

Inspect ref

casinoJpSeed

v0.Tree

// coin:tier → reset seed (string)

Link Copy Open

OID

0a9dd2…b5d8:192

casinoJpSeed details

Inspect ref

casinoJpRef

v0.Tree

// coin → reference bet (string)

Link Copy Open

OID

0a9dd2…b5d8:194

casinoJpRef details

Inspect ref

freeSpinMult

uint64

Link

Value

2

jpMajorBps

uint64

// 1.0% of each paid slots stake

Link

Value

100

jpGrandBps

uint64

// 0.5%

Link

Value

50

jpDefaultRefBet

uint64

Link

Value

100

jpResetFreeMultiple

uint64

Link

Value

20

hsMiniMult

uint64

Link

Value

20

hsMinorMult

uint64

Link

Value

75

freeSpinGrant

type

Link

Value

game31.freeSpinGrant

getGrant

func(addr string) *game31.freeSpinGrant

Link Copy Open

OID

0a9dd2…b5d8:195

getGrant details

Inspect func

jpKey

func(coin string, tier string) string

Link Copy Open

OID

0a9dd2…b5d8:197

jpKey details

Inspect func

jpRefBet

func(coin string) uint64

Link Copy Open

OID

0a9dd2…b5d8:198

jpRefBet details

Inspect func

casinoJackpotContribute

func(coin string, amt uint64)

casinoJackpotContribute moves 1.0% / 0.5% of a paid slots stake from the house pool into the MAJOR / GRAND pools (remainders carried, nothing rounded away).

Link Copy Open

OID

0a9dd2…b5d8:199

casinoJackpotContribute details

Inspect func

casinoJackpotPay

func(addr string, coin string, tier string, bet uint64) uint64

casinoJackpotPay pays a jackpot tier to addr: pool × min(1, bet/refBet).

Link Copy Open

OID

0a9dd2…b5d8:200

casinoJackpotPay details

Inspect func

slotsHSPayout

func(tiles *[20]uint16, full bool) (uint64, bool, bool)

slotsHSPayout turns Hold & Spin tiles into bet multiples (under the cap) and the jackpot tiers won (paid from their pools).

Link Copy Open

OID

0a9dd2…b5d8:201

slotsHSPayout details

Inspect func

PlaceCasinoFreeSpin

func(roundId string, clientHash string)

PlaceCasinoFreeSpin uses one free spin of the caller's grant in a committed round (no stake). One free spin in flight at a time.

Link Copy Open

OID

0a9dd2…b5d8:202

PlaceCasinoFreeSpin details

Inspect func

settleFreeSpin

func(b *game31.casinoBet, win uint64) uint64

settleFreeSpin pays a free spin's win out of its grant's reservation.

Link Copy Open

OID

0a9dd2…b5d8:203

settleFreeSpin details

Inspect func

FreeSpinGrant

func(addr string) string

FreeSpinGrant reports a player's open free spins (null when none).

Link Copy Open

OID

0a9dd2…b5d8:204

FreeSpinGrant details

Inspect func

CasinoJackpots

func(coinId string) string

CasinoJackpots reports the real MAJOR / GRAND pools and how they pay.

Link Copy Open

OID

0a9dd2…b5d8:205

CasinoJackpots details

Inspect func

validJpTier

func(tier string) bool

Link Copy Open

OID

0a9dd2…b5d8:206

validJpTier details

Inspect func

SeedCasinoJackpot

func(coinId string, tier string, amount string)

SeedCasinoJackpot adds the ADMIN'S OWN coins to a jackpot pool (never withdrawable).

Link Copy Open

OID

0a9dd2…b5d8:207

SeedCasinoJackpot details

Inspect func

SetCasinoJackpotSeed

func(coinId string, tier string, amount string)

SetCasinoJackpotSeed sets the level a jackpot is topped back up to after a hit.

Link Copy Open

OID

0a9dd2…b5d8:208

SetCasinoJackpotSeed details

Inspect func

SetCasinoJackpotRefBet

func(coinId string, amount string)

SetCasinoJackpotRefBet sets the bet that wins a full jackpot (smaller bets win the same share of the pool as their share of this bet).

Link Copy Open

OID

0a9dd2…b5d8:209

SetCasinoJackpotRefBet details

Inspect func

getCasinoRound

func(id string) *game31.casinoRound

Link Copy Open

OID

0a9dd2…b5d8:210

getCasinoRound details

Inspect func

mustCasinoRound

func(id string) *game31.casinoRound

Link Copy Open

OID

0a9dd2…b5d8:212

mustCasinoRound details

Inspect func

casinoRoundBet

func(r *game31.casinoRound, roundId string) *game31.casinoBet

Link Copy Open

OID

0a9dd2…b5d8:213

casinoRoundBet details

Inspect func

CommitCasinoSeed

func(roundId string, player string, seedHash string)

CommitCasinoSeed opens a round for one player with sha256(s). Operator only; a round id can be used once.

Link Copy Open

OID

0a9dd2…b5d8:214

CommitCasinoSeed details

Inspect func

PlaceCasinoBet

func(roundId string, game string, coinId string, betAmount string, choice string, clientHash string)

PlaceCasinoBet escrows the player's bet with sha256(c): only the round's player, only before s is revealed, and only if the pool can pay its largest win.

Link Copy Open

OID

0a9dd2…b5d8:215

PlaceCasinoBet details

Inspect func

RevealCasinoSeed

func(roundId string, serverSeed string)

RevealCasinoSeed publishes s (it must hash to the commit). It settles nothing: the bet settles when the player's secret is revealed.

Link Copy Open

OID

0a9dd2…b5d8:216

RevealCasinoSeed details

Inspect func

RevealCasinoSecret

func(roundId string, clientSecret string)

RevealCasinoSecret publishes the player's secret c (anyone may relay it: it must hash to the bet's hash) and settles the bet on chain. Works while paused.

Link Copy Open

OID

0a9dd2…b5d8:217

RevealCasinoSecret details

Inspect func

casinoResolve

func(roundId string, r *game31.casinoRound, b *game31.casinoBet)

casinoResolve rolls the bet from s and c, pays it, and records the result.

Link Copy Open

OID

0a9dd2…b5d8:218

casinoResolve details

Inspect func

RefundCasinoBet

func(roundId string)

RefundCasinoBet returns the stake only if s was never revealed and 30 minutes have passed since the bet. Never after s is revealed. Works while paused.

Link Copy Open

OID

0a9dd2…b5d8:219

RefundCasinoBet details

Inspect func

ForfeitCasinoBet

func(roundId string)

ForfeitCasinoBet settles a bet as a loss when s was revealed but the player's secret was not within 24 h (only the player could know the result). Anyone.

Link Copy Open

OID

0a9dd2…b5d8:220

ForfeitCasinoBet details

Inspect func

CasinoRound

func(roundId string) string

Link Copy Open

OID

0a9dd2…b5d8:221

CasinoRound details

Inspect func

CasinoBet

func(roundId string, addr string) string

CasinoBet returns one player's bet and its on-chain result.

Link Copy Open

OID

0a9dd2…b5d8:222

CasinoBet details

Inspect func

JackpotPool

func(coinId string) string

JackpotPool reports the GRAND jackpot pool (the casino bankroll is CasinoPool).

Link Copy Open

OID

0a9dd2…b5d8:223

JackpotPool details

Inspect func

CasinoHistory

func(string) string

Link Copy Open

OID

0a9dd2…b5d8:224

CasinoHistory details

Inspect func

realmPkgPath

untyped string

Link

Value

"gno.land/r/g138gdmwj6heduu3st796lw6qqdwylgaxf7ty5gz/game30"

admin

.uverse.address

// deployer; can set roles, prices, veins, migrate, withdraw

Link

Value

<gnolang.StringValue>

operator

.uverse.address

// server hot account for casino seeds (defaults to admin)

Link

Value

<gnolang.StringValue>

claimSignerPubKey

[]uint8 (len=32)

Link Copy Open

OID

0a9dd2…b5d8:1300

claimSignerPubKey details (len=32)

+32 more Inspect slice

claimNonces

v0.Tree

// addr → last used voucher nonce (decimal string)

Link Copy Open

OID

0a9dd2…b5d8:229

claimNonces details

Inspect ref

balances

v0.Tree

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

Link Copy Open

OID

0a9dd2…b5d8:231

balances details

Inspect ref

claimBuckets

v0.Tree

// addr → "m0:t0|m1:t1|m2:t2|m3:t3|m4:t4|m5:t5|m6:t6" (packed; lazy-migrated from old addr:r keys)

Link Copy Open

OID

0a9dd2…b5d8:233

claimBuckets details

Inspect ref

veinMinted

v0.Tree

// coinId → total ever credited by claims/rewards/migration

Link Copy Open

OID

0a9dd2…b5d8:235

veinMinted details

Inspect ref

veinMaxOverride

v0.Tree

// coinId → admin-set max (overrides the rarity default)

Link Copy Open

OID

0a9dd2…b5d8:237

veinMaxOverride details

Inspect ref

veinOverrideActive

bool

// true once any SetVeinMax has been called; gates the veinMaxOverride AVL read

Link

Value

false

casinoRounds

v0.Tree

// roundId → \*casinoRound

Link Copy Open

OID

0a9dd2…b5d8:240

casinoRounds details

Inspect ref

pvpLobbies

v0.Tree

// lobbyId and lobbyId+":field" → string (see game\_pvp.gno)

Link Copy Open

OID

0a9dd2…b5d8:242

pvpLobbies details

Inspect ref

pvpWagers

v0.Tree

// lobbyId → "coinId:amount:creator:challenger"

Link Copy Open

OID

0a9dd2…b5d8:244

pvpWagers details

Inspect ref

ownedTools

v0.Tree

// addr → comma-separated tool IDs

Link Copy Open

OID

0a9dd2…b5d8:246

ownedTools details

Inspect ref

toolLife

v0.Tree

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

Link Copy Open

OID

0a9dd2…b5d8:248

toolLife details

Inspect ref

lifetimeMined

v0.Tree

// addr+":"+coinId → total mined string (real claims only)

Link Copy Open

OID

0a9dd2…b5d8:250

lifetimeMined details

Inspect ref

rewarded

v0.Tree

// addr+":"+coinId → total credited by rewards (medals etc.)

Link Copy Open

OID

0a9dd2…b5d8:252

rewarded details

Inspect ref

achievements

v0.Tree

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

Link Copy Open

OID

0a9dd2…b5d8:254

achievements details

Inspect ref

dailyCheckins

v0.Tree

// addr → unix seconds string

Link Copy Open

OID

0a9dd2…b5d8:256

dailyCheckins details

Inspect ref

skillRanks

v0.Tree

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

Link Copy Open

OID

0a9dd2…b5d8:258

skillRanks details

Inspect ref

miners

v0.Tree

// addr → total mined all-time string

Link Copy Open

OID

0a9dd2…b5d8:260

miners details

Inspect ref

playerXp

v0.Tree

// addr → cumulative rarity-weighted XP (uint64 string)

Link Copy Open

OID

0a9dd2…b5d8:262

playerXp details

Inspect ref

lastClaim

v0.Tree

// addr → unix timestamp of last ClaimAndMint

Link Copy Open

OID

0a9dd2…b5d8:264

lastClaim details

Inspect ref

blacklist

v0.Tree

// addr → "reason:timestamp"

Link Copy Open

OID

0a9dd2…b5d8:266

blacklist details

Inspect ref

banExpiries

v0.Tree

// addr → unix expiry (0 = permanent)

Link Copy Open

OID

0a9dd2…b5d8:268

banExpiries details

Inspect ref

guilds

v0.Tree

// guildId → JSON{name, leader, memberCount, createdAt}

Link Copy Open

OID

0a9dd2…b5d8:270

guilds details

Inspect ref

guildMembers

v0.Tree

// guildId+":"+addr → "1"

Link Copy Open

OID

0a9dd2…b5d8:272

guildMembers details

Inspect ref

playerGuild

v0.Tree

// addr → guildId

Link Copy Open

OID

0a9dd2…b5d8:274

playerGuild details

Inspect ref

gnomePasses

v0.Tree

// addr → unix expiry timestamp string

Link Copy Open

OID

0a9dd2…b5d8:276

gnomePasses details

Inspect ref

paused

bool

Link

Value

false

passPriceUgnot

int64

Link

Value

5000000

passRevenueUgnot

int64

// lifetime ugnot received for passes (accounting only)

Link

Value

0

pvpCounter

uint64

// monotonically increasing lobby number

Link

Value

0

guildCounter

uint64

// monotonically increasing guild number

Link

Value

0

migrationFinalized

bool

Link

Value

false

migrationBatches

v0.Tree

// batchId → kind

Link Copy Open

OID

0a9dd2…b5d8:284

migrationBatches details

Inspect ref

toolOrder

[]string (len=15)

toolOrder is the canonical upgrade path from hands to omega.

Link Copy Open

OID

0a9dd2…b5d8:286

toolOrder details (len=15)

+15 more Inspect slice

toolRequires

map[string]string

toolRequires: BuyTool must panic unless the caller owns the prerequisite tool.

Link Copy Open

OID

0a9dd2…b5d8:288

toolRequires details

Inspect map

toolMaxRarity

map[string]int

toolMaxRarity: highest coin rarity each tool can mine (used by the claim rate cap).

Link Copy Open

OID

0a9dd2…b5d8:290

toolMaxRarity details

Inspect map

toolCosts

map[string][][2]string

toolCosts maps toolId → slice of \[coinId, amount] pairs. Matches catalog.ts TOOLS array exactly. Amounts are for qty=1.

Link Copy Open

OID

0a9dd2…b5d8:292

toolCosts details

Inspect map

skillBaseCosts

map[string][][2]string

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

Link Copy Open

OID

0a9dd2…b5d8:500

skillBaseCosts details

Inspect map

skillMaxRanks

map[string]uint64

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

Link Copy Open

OID

0a9dd2…b5d8:981

skillMaxRanks details

Inspect map

toolMaxLife

map[string]uint64

toolMaxLife maps toolId → maximum durability in blocks broken. 0 = indestructible (hands, starter-twig, twig). Matches catalog.ts tool.life.

Link Copy Open

OID

0a9dd2…b5d8:983

toolMaxLife details

Inspect map

coinRarity

map[string]int

Link Copy Open

OID

0a9dd2…b5d8:1299

coinRarity details

Inspect map

skillDustHeadroom

uint64

// ×175/100

Link

Value

175

skillDmgHeadroom

uint64

// ×200/100

Link

Value

200

skillDropHeadroom

uint64

// ×130/100

Link

Value

130

toolLifeSkillIds

[]string (len=11)

toolLifeSkillIds lists the on-chain skills that grant toolLifeBonus. Covers the Things branch (level 50) and the Nature-branch skills that also affect tool wear. Must stay in sync with catalog.ts SKILLS\[\*].toolLifeBonus.

Link Copy Open

OID

0a9dd2…b5d8:986

toolLifeSkillIds details (len=11)

+11 more Inspect slice

toolLifeSkillBonus

map[string]uint64

toolLifeSkillBonus maps each skill to its per-rank life bonus fraction × 1000. e.g. "tempered\_grip" → 100 means +10.0% per rank (100/1000 = 0.10).

Link Copy Open

OID

0a9dd2…b5d8:988

toolLifeSkillBonus details

Inspect map

claimBucketSecs

int64

── Claim rate cap tables (REPORT.md §5) ───────────────────────────────────── claimBucketSecs: how many seconds of allowance the bucket can bank (1 hour).

Link

Value

3600

claimRatePerMin

map[string][7]uint64

claimRatePerMin\[toolId]\[rarity] = max coins/min of that rarity the caller may claim (before skill headroom). Indexed 0=dust..6=mythic.

Link Copy Open

OID

0a9dd2…b5d8:990

claimRatePerMin details

Inspect map

veinDefaultMax

[7]uint64

── Vein caps (game29) ─────────────────────────────────────────────────────── Every coin in coinRarity has a vein from deploy: its max is the default for its rarity unless the admin overrides it. No per-coin init writes needed. Defaults: ≈1 year of demand per core coin × 1.5 headroom (see REPORT §6).

Link Copy Open

OID

0a9dd2…b5d8:1007

veinDefaultMax details

Inspect array

veinCoinDefault

map[string]uint64

Per-coin default overrides (static: no deploy-time writes).

Link Copy Open

OID

0a9dd2…b5d8:1009

veinCoinDefault details

Inspect map

coinAmt

type

── Achievement allowlist (game29) ─────────────────────────────────────────── Static ids with FIXED rewards. Grind ids "g.\<coin>.\<need>" are valid for any allowlisted coin and need ∈ grindRungs. The client can never choose a reward.

Link

Value

game31.coinAmt

achievementRewards

map[string][]game31.coinAmt

Link Copy Open

OID

0a9dd2…b5d8:1011

achievementRewards details

Inspect map

grindRungs

[]uint64 (len=5)

Link Copy Open

OID

0a9dd2…b5d8:1129

grindRungs details (len=5)

+5 more Inspect slice

grindPay

func(need uint64) uint64

Link Copy Open

OID

0a9dd2…b5d8:1130

grindPay details

Inspect func

pvpGames

map[string][]string

── PvP / casino allowlists ──────────────────────────────────────────────────

Link Copy Open

OID

0a9dd2…b5d8:1133

pvpGames details

Inspect map

pvpTimeoutSec

int64

// AFK window before ClaimPvpTimeout

Link

Value

600

pvpRakePct

uint64

// to admin balance

Link

Value

2

voucherMaxTTL

int64

// vouchers must expire within 15 min

Link

Value

900

claimCooldownSec

int64

// min seconds between ClaimAndMint

Link

Value

60

claimInitialGraceSec

int64

// a new rarity bucket starts with 5 min of allowance

Link

Value

300

init.307

func()

Link Copy Open

OID

0a9dd2…b5d8:1137

init.307 details

Inspect func

init.308

func()

Link Copy Open

OID

0a9dd2…b5d8:1139

init.308 details

Inspect func

init.309

func()

Link Copy Open

OID

0a9dd2…b5d8:1141

init.309 details

Inspect func

maxGuildMembers

untyped bigint

Link

Value

(10 <untyped> bigint)

maxGuildNameLen

untyped bigint

Link

Value

(24 <untyped> bigint)

guildJSON

func(guildId string, name string, leader string, members int, createdAt int64) string

Link Copy Open

OID

0a9dd2…b5d8:1143

guildJSON details

Inspect func

guildMemberCount

func(gid string) int

Link Copy Open

OID

0a9dd2…b5d8:1145

guildMemberCount details

Inspect func

guildMeta

type

Link

Value

game31.guildMeta

guildMetas

map[string]game31.guildMeta

guild meta is stored alongside the JSON so it can be re-rendered safely.

Link Copy Open

OID

0a9dd2…b5d8:1147

guildMetas details

Inspect map

rewriteGuild

func(gid string)

Link Copy Open

OID

0a9dd2…b5d8:1148

rewriteGuild details

Inspect func

CreateGuild

func(name string) string

Link Copy Open

OID

0a9dd2…b5d8:1149

CreateGuild details

Inspect func

JoinGuild

func(guildId string)

Link Copy Open

OID

0a9dd2…b5d8:1150

JoinGuild details

Inspect func

LeaveGuild

func()

Link Copy Open

OID

0a9dd2…b5d8:1151

LeaveGuild details

Inspect func

PlayerGuild

func(addr string) string

Link Copy Open

OID

0a9dd2…b5d8:1152

PlayerGuild details

Inspect func

GuildInfo

func(guildId string) string

Link Copy Open

OID

0a9dd2…b5d8:1153

GuildInfo details

Inspect func

TopGuilds

func(limit int) string

Link Copy Open

OID

0a9dd2…b5d8:1154

TopGuilds details

Inspect func

kvJSON

func(prefixAddr string, t *v0.Tree) string

Link Copy Open

OID

0a9dd2…b5d8:1155

kvJSON details

Inspect func

AllBalances

func(playerAddr string) string

Link Copy Open

OID

0a9dd2…b5d8:1156

AllBalances details

Inspect func

LifetimeMined

func(playerAddr string) string

Link Copy Open

OID

0a9dd2…b5d8:1157

LifetimeMined details

Inspect func

PlayerXp

func(playerAddr string) string

PlayerXp returns the caller's cumulative rarity-weighted XP earned from ClaimAndMint calls as a plain decimal string (e.g. "12345"). Returns "0" for players who have not yet minted anything on this realm version.

Link Copy Open

OID

0a9dd2…b5d8:1158

PlayerXp details

Inspect func

Rewarded

func(playerAddr string) string

Rewarded returns what rewards (medals etc.) credited, per coin. Separate from LifetimeMined.

Link Copy Open

OID

0a9dd2…b5d8:1159

Rewarded details

Inspect func

SkillRanks

func(playerAddr string) string

Link Copy Open

OID

0a9dd2…b5d8:1160

SkillRanks details

Inspect func

ToolLife

func(playerAddr string) string

Link Copy Open

OID

0a9dd2…b5d8:1161

ToolLife details

Inspect func

OwnedTools

func(playerAddr string) string

Link Copy Open

OID

0a9dd2…b5d8:1162

OwnedTools details

Inspect func

PlayerProfile

func(playerAddr string) string

Link Copy Open

OID

0a9dd2…b5d8:1163

PlayerProfile details

Inspect func

AllMiners

func(limit int, offset int) string

AllMiners returns the leaderboard sorted by total mined (desc), paginated. (game28 returned it in address order.)

Link Copy Open

OID

0a9dd2…b5d8:1164

AllMiners details

Inspect func

GetMedals

func(playerAddr string) string

Link Copy Open

OID

0a9dd2…b5d8:1165

GetMedals details

Inspect func

DailyCheckinStatus

func(playerAddr string) string

Link Copy Open

OID

0a9dd2…b5d8:1166

DailyCheckinStatus details

Inspect func

ListTasks

func(string) string

Link Copy Open

OID

0a9dd2…b5d8:1167

ListTasks details

Inspect func

Render

func(string) string

Link Copy Open

OID

0a9dd2…b5d8:1168

Render details

Inspect func

deductBalances

func(caller string, costs [][2]string)

deductBalances checks all balances, then deducts (no partial deductions).

Link Copy Open

OID

0a9dd2…b5d8:1169

deductBalances details

Inspect func

guildRow

type

Link

Value

game31.guildRow

guildRows

type

Link

Value

game31.guildRows

minerRow

type

Link

Value

game31.minerRow

minerRows

type

Link

Value

game31.minerRows

VoucherMessage

func(kind string, player string, nonce int64, expiry int64, payload string) string

VoucherMessage builds the canonical message that the server signs and the realm verifies. Format: gnomoji-voucher-v2|chainId|kind|player|nonce|expiry|compactPayload v2 changes from v1: realmPkgPath removed; payload is now compact (not raw JSON). For kind="claim": compactPayload = coinId:amount pairs sorted by coinId, comma-joined. e.g. [["grin","100"],["joy","50"]] → "grin:100,joy:50" For kind="ach": compactPayload = achievement IDs sorted, comma-joined. e.g. ["blocks_1","g.grin.10"] → "blocks_1,g.grin.10"

Link Copy Open

OID

0a9dd2…b5d8:1170

VoucherMessage details

Inspect func

compactClaimPayload

func(coinsJson string) string

compactClaimPayload builds the canonical compact payload for a "claim" voucher from a coinsJson string: \[\["coinId","amount"],...]. Output: "coinId:amount" pairs sorted alphabetically by coinId, comma-joined. Must produce the same output as the TypeScript claimVoucherPayload() function in src/lib/game/claim-voucher.ts.

Link Copy Open

OID

0a9dd2…b5d8:1172

compactClaimPayload details

Inspect func

compactAchPayload

func(idsJson string) string

compactAchPayload builds the canonical compact payload for an "ach" voucher from an idsJson string: \["achId",...]. Output: achievement IDs sorted alphabetically, comma-joined.

Link Copy Open

OID

0a9dd2…b5d8:1173

compactAchPayload details

Inspect func

LastNonce

func(addr string) int64

LastNonce returns the last voucher nonce used by addr (0 if none).

Link Copy Open

OID

0a9dd2…b5d8:1174

LastNonce details

Inspect func

useVoucher

func(kind string, player string, nonce int64, expiry int64, payload string, sigHex string)

Link Copy Open

OID

0a9dd2…b5d8:1175

useVoucher details

Inspect func

bestOwnedTool

func(callerAddr string) string

bestOwnedTool returns the highest-tier tool the caller owns that still has durability (or is indestructible). "hands" if none.

Link Copy Open

OID

0a9dd2…b5d8:1176

bestOwnedTool details

Inspect func

effectiveRateFor

func(tool string, r int) uint64

Link Copy Open

OID

0a9dd2…b5d8:1177

effectiveRateFor details

Inspect func

loadPackedBuckets

func(addr string, nowTs int64) [7][2]uint64

loadPackedBuckets reads the packed claimBuckets entry for addr, or creates a fresh one. Returns \[7]\[2]uint64 where \[r]\[0]=accruedMillis, \[r]\[1]=lastTs. Lazy-migrates from the old per-rarity key format (addr+":"+r) on first read after an upgrade.

Link Copy Open

OID

0a9dd2…b5d8:1178

loadPackedBuckets details

Inspect func

formatPackedBuckets

func(buckets [7][2]uint64) string

formatPackedBuckets serializes \[7]\[2]uint64 to "m0:t0|m1:t1|...|m6:t6".

Link Copy Open

OID

0a9dd2…b5d8:1179

formatPackedBuckets details

Inspect func

bucketState

func(allBuckets [7][2]uint64, r int, tool string, nowTs int64) (uint64, uint64)

bucketState returns (accruedMillis, capMillis) for rarity r at nowTs. allBuckets is the result of loadPackedBuckets — pass it in to avoid re-reading the AVL entry for each rarity check.

Link Copy Open

OID

0a9dd2…b5d8:1180

bucketState details

Inspect func

enforceClaimRate

func(callerAddr string, byRarity [7]uint64, nowTs int64, tool string)

enforceClaimRate checks every rarity first, then deducts (no partial writes). FIX 2A: reads claimBuckets once (packed format) instead of once per rarity.

Link Copy Open

OID

0a9dd2…b5d8:1181

enforceClaimRate details

Inspect func

decrementToolLife

func(callerAddr string, totalCoins uint64, tool string)

decrementToolLife wears the best tool by the number of non-dust coins. FIX 1A: accepts pre-computed tool to avoid a second bestOwnedTool call.

Link Copy Open

OID

0a9dd2…b5d8:1182

decrementToolLife details

Inspect func

parseCoinClaims

func(coinsJson string) ([]string, map[string]uint64, [7]uint64)

parseCoinClaims parses \[\["coinId","amount"],...]. Unknown ids panic (allowlist); duplicate ids are summed; at most 20 entries.

Link Copy Open

OID

0a9dd2…b5d8:1183

parseCoinClaims details

Inspect func

guildBonusPct

func(addr string) uint64

Link Copy Open

OID

0a9dd2…b5d8:1184

guildBonusPct details

Inspect func

creditMined

func(addr string, coinId string, amt uint64) uint64

creditMined credits a mined/reward amount to addr, capped by the vein, and records lifetime total. Returns the amount credited. FIX 1B: miners update removed — caller must addU(&miners, addr, total) after the loop.

Link Copy Open

OID

0a9dd2…b5d8:1185

creditMined details

Inspect func

creditReward

func(addr string, coinId string, amt uint64) uint64

creditReward credits a reward (medal/achievement or any future event). It still draws from the vein (so rewards can't exceed supply caps) but is tracked in its own counter: it never touches lifetimeMined or the miners leaderboard, so rewards can't unlock grind medals or inflate rankings.

Link Copy Open

OID

0a9dd2…b5d8:1186

creditReward details

Inspect func

ClaimAndMint

func(coinsJson string, nonce int64, expiry int64, sigHex string) string

ClaimAndMint credits mined coins to the caller's on-chain balance. coinsJson: \[\["coinId","amount"],...]. Requires a server voucher (see VoucherMessage) for exactly this coinsJson, plus the on-chain rate cap for the caller's best tool, the coin allowlist and the vein caps. Returns a JSON object of what was actually credited (after bonuses/veins).

Link Copy Open

OID

0a9dd2…b5d8:1187

ClaimAndMint details

Inspect func

ClaimMine

func(coinsJson string)

ClaimMine (game27/28 two-step flow) is retired: pending mints are gone.

Link Copy Open

OID

0a9dd2…b5d8:1188

ClaimMine details

Inspect func

PendingMints

func(playerAddr string) string

PendingMints is kept for client compatibility; game29 has no pending step.

Link Copy Open

OID

0a9dd2…b5d8:1189

PendingMints details

Inspect func

ClaimAllowance

func(playerAddr string) string

ClaimAllowance returns the current per-rarity allowance for addr.

Link Copy Open

OID

0a9dd2…b5d8:1190

ClaimAllowance details

Inspect func

lget

func(id string, f string) string

Link Copy Open

OID

0a9dd2…b5d8:1191

lget details

Inspect func

lset

func(id string, f string, v string)

Link Copy Open

OID

0a9dd2…b5d8:1193

lset details

Inspect func

renderLobby

func(id string)

Link Copy Open

OID

0a9dd2…b5d8:1194

renderLobby details

Inspect func

touch

func(id string)

Link Copy Open

OID

0a9dd2…b5d8:1195

touch details

Inspect func

lastAction

func(id string) int64

Link Copy Open

OID

0a9dd2…b5d8:1196

lastAction details

Inspect func

CreatePvpLobby

func(game string, coinId string, betAmount string) string

CreatePvpLobby escrows the creator's wager and opens a lobby.

Link Copy Open

OID

0a9dd2…b5d8:1197

CreatePvpLobby details

Inspect func

JoinPvpLobby

func(lobbyId string)

Link Copy Open

OID

0a9dd2…b5d8:1198

JoinPvpLobby details

Inspect func

pvpWagered

func(id string) bool

pvpWagered: a lobby that escrowed coins before wagers were switched off. It can only be cancelled or refunded after the timeout.

Link Copy Open

OID

0a9dd2…b5d8:1199

pvpWagered details

Inspect func

CancelPvpLobby

func(lobbyId string)

CancelPvpLobby lets the creator close an open lobby nobody joined (refund). Works while paused: a refund of the player's own escrow is never blocked.

Link Copy Open

OID

0a9dd2…b5d8:1200

CancelPvpLobby details

Inspect func

memberOf

func(lobbyId string, addr string) bool

Link Copy Open

OID

0a9dd2…b5d8:1201

memberOf details

Inspect func

CommitPvpMove

func(lobbyId string, moveHash string)

CommitPvpMove stores sha256(choice+":"+salt) for the caller. Members only, once per player per lobby, only while the lobby is joined.

Link Copy Open

OID

0a9dd2…b5d8:1202

CommitPvpMove details

Inspect func

validChoice

func(game string, choice string) bool

Link Copy Open

OID

0a9dd2…b5d8:1203

validChoice details

Inspect func

moveHash

func(choice string, salt string) string

Link Copy Open

OID

0a9dd2…b5d8:1204

moveHash details

Inspect func

RevealPvpMove

func(lobbyId string, choice string, salt string)

RevealPvpMove reveals a committed move. The tx fails unless sha256(choice+":"+salt) equals the stored commit. A matching reveal of an invalid choice forfeits the match. When both have revealed, it settles.

Link Copy Open

OID

0a9dd2…b5d8:1205

RevealPvpMove details

Inspect func

pvpWinner

func(game string, creator string, challenger string, cChoice string, chChoice string, cSalt string, chSalt string) string

pvpWinner: rps uses the usual rules. coin\_flip / higher\_lower flip a coin from sha256(creatorSalt:challengerSalt) — neither player controls it alone — and whoever alone called it wins (both or neither right = draw).

Link Copy Open

OID

0a9dd2…b5d8:1206

pvpWinner details

Inspect func

settlePvp

func(lobbyId string, result string)

settlePvp pays out the escrow. result = winner addr, "draw" or "refund".

Link Copy Open

OID

0a9dd2…b5d8:1207

settlePvp details

Inspect func

ClaimPvpTimeout

func(lobbyId string)

ClaimPvpTimeout resolves a stuck match after pvpTimeoutSec without action: - only one player committed → that player wins; - both committed, only one revealed → the revealer wins; - otherwise → both refunded. Any lobby member may call it. Escrow can never stay locked.

Link Copy Open

OID

0a9dd2…b5d8:1208

ClaimPvpTimeout details

Inspect func

ExpireLobbies

func()

ExpireLobbies is a no-op kept for API compatibility (timeouts are per lobby).

Link Copy Open

OID

0a9dd2…b5d8:1209

ExpireLobbies details

Inspect func

PvpLobby

func(lobbyId string) string

Link Copy Open

OID

0a9dd2…b5d8:1210

PvpLobby details

Inspect func

OpenLobbies

func() string

Link Copy Open

OID

0a9dd2…b5d8:1211

OpenLobbies details

Inspect func

sha256Sum

func(s string) string

Link Copy Open

OID

0a9dd2…b5d8:1212

sha256Sum details

Inspect func

zeroPad

func(n uint64, w int) string

zeroPad formats n with leading zeros to width w (ufmt has no %0Nd).

Link Copy Open

OID

0a9dd2…b5d8:1213

zeroPad details

Inspect func

effectiveMaxLife

func(callerAddr string, toolId string) uint64

effectiveMaxLife = toolMaxLife × (1000 + Σ rank × bonus‰) / 1000. FIX 1C: fast-path for players with no tool-life skills trained (the common case), avoiding 22 AVL reads (11 skills × Has+Get) that all return 0.

Link Copy Open

OID

0a9dd2…b5d8:1214

effectiveMaxLife details

Inspect func

ownsTool

func(addr string, toolId string) bool

Link Copy Open

OID

0a9dd2…b5d8:1216

ownsTool details

Inspect func

Transfer

func(coinId string, toAddr string, amountStr string)

Transfer sends coins to another player. It is a player's own money, so the admin can't stop it: it works while the game is paused and for banned addresses (bans only stop earning). It needs a finalized migration (MigrateBatch SETs balances). There is no receive cap: any coin can be sent to any player, whatever tools they own.

Link Copy Open

OID

0a9dd2…b5d8:1217

Transfer details

Inspect func

BuyTool

func(toolId string)

Link Copy Open

OID

0a9dd2…b5d8:1218

BuyTool details

Inspect func

RepairTool

func(toolId string)

Link Copy Open

OID

0a9dd2…b5d8:1219

RepairTool details

Inspect func

TrainSkill

func(skillId string)

Link Copy Open

OID

0a9dd2…b5d8:1220

TrainSkill details

Inspect func

parseGrindId

func(id string) (string, uint64, bool)

Link Copy Open

OID

0a9dd2…b5d8:1221

parseGrindId details

Inspect func

isValidAchievementId

func(id string) bool

Link Copy Open

OID

0a9dd2…b5d8:1222

isValidAchievementId details

Inspect func

achievementReward

func(addr string, id string) ([]game31.coinAmt, string)

achievementReward returns the fixed reward for id, checking any on-chain predicate (grind: lifetimeMined ≥ need; "\<tool>\_own": tool owned). ok=false means the id is unknown or not earned on chain.

Link Copy Open

OID

0a9dd2…b5d8:1223

achievementReward details

Inspect func

claimAchievementsFor

func(addr string, ids []string, strict bool) int

claimAchievementsFor claims ids for addr. strict=true panics on any bad id; otherwise bad/claimed ids are skipped. Returns the number claimed.

Link Copy Open

OID

0a9dd2…b5d8:1224

claimAchievementsFor details

Inspect func

ClaimAchievement

func(achievementId string, nonce int64, expiry int64, sigHex string)

ClaimAchievement claims one allowlisted achievement and credits its fixed reward. Needs a server voucher of kind "ach" with payload = \`\["\<id>"]\`.

Link Copy Open

OID

0a9dd2…b5d8:1225

ClaimAchievement details

Inspect func

BatchClaimAchievements

func(idsJson string, nonce int64, expiry int64, sigHex string) int

BatchClaimAchievements claims several ids (already-claimed / not-earned ids are skipped). idsJson must be exactly the voucher payload.

Link Copy Open

OID

0a9dd2…b5d8:1226

BatchClaimAchievements details

Inspect func

HasAchievement

func(addr string, id string) bool

Link Copy Open

OID

0a9dd2…b5d8:1227

HasAchievement details

Inspect func

parseDailyCheckin

func(raw string) (int64, int64)

parseDailyCheckin reads the stored value for an address and returns (lastDay, streak). It handles both the new "\<lastDay>:\<streak>" format and the legacy "\<unix seconds>" format (which stores raw epoch seconds; treated as lastDay = seconds/86400, streak = 1).

Link Copy Open

OID

0a9dd2…b5d8:1228

parseDailyCheckin details

Inspect func

DailyCheckin

func()

Link Copy Open

OID

0a9dd2…b5d8:1229

DailyCheckin details

Inspect func

CreateTask

func(taskId string, desc string)

Tasks: game28 let anyone mark any task done. In game29 tasks are created and completed for a player only by the operator (server) — no free medals.

Link Copy Open

OID

0a9dd2…b5d8:1230

CreateTask details

Inspect func

CompleteTask

func(taskId string)

Link Copy Open

OID

0a9dd2…b5d8:1231

CompleteTask details

Inspect func

CompleteTaskFor

func(player string, taskId string)

Link Copy Open

OID

0a9dd2…b5d8:1232

CompleteTaskFor details

Inspect func

slotsReels

untyped bigint

Link

Value

(5 <untyped> bigint)

slotsRows

untyped bigint

Link

Value

(4 <untyped> bigint)

slotsCells

untyped bigint

Link

Value

(20 <untyped> bigint)

slotsStripLen

untyped bigint

Link

Value

(40 <untyped> bigint)

slotsBetStep

uint64

// bet must be a multiple of the 25 lines

Link

Value

25

slotsMaxWinMult

uint64

Link

Value

500

symWild

uint8

Link

Value

0

symScatter

uint8

Link

Value

8

symVault

uint8

Link

Value

9

hsLandBelow

uint8

// a free cell lands a coin when its byte \< 8 (3.125%)

Link

Value

8

hsRespins

untyped bigint

Link

Value

(3 <untyped> bigint)

hsMini

uint16

Link

Value

101

hsMinor

uint16

Link

Value

102

hsMajor

uint16

Link

Value

103

hsGrand

uint16

Link

Value

104

slotsStrip

untyped string

One strip for all reels: wild 1, seven 3, diamond 4, trophy 5, star 6, clover 6, flame 7, coin 6, scatter 1, vault 1 (digits = symbol ids).

Link

Value

"8645732106457321645793216457326457364576"

slotsSymbolNames

[10]string

Link Copy Open

OID

0a9dd2…b5d8:1234

slotsSymbolNames details

Inspect array

slotsPays

[8][3]uint64

line-bet multiples for 3/4/5 of a kind, symbols 0..7

Link Copy Open

OID

0a9dd2…b5d8:1236

slotsPays details

Inspect array

slotsPaylines

[25][5]uint8

same 25 lines as src/lib/game/slots.ts PAYLINES (row per reel)

Link Copy Open

OID

0a9dd2…b5d8:1246

slotsPaylines details

Inspect array

slotsScatterPay

[6]uint64

// × bet, by scatter count

Link Copy Open

OID

0a9dd2…b5d8:1273

slotsScatterPay details

Inspect array

slotsFreeSpins

[6]uint64

Link Copy Open

OID

0a9dd2…b5d8:1275

slotsFreeSpins details

Inspect array

slotsStream

type

Link

Value

game31.slotsStream

newSlotsStream

func(serverSeed string, clientSecret string, roundId string) *game31.slotsStream

Link Copy Open

OID

0a9dd2…b5d8:1276

newSlotsStream details

Inspect func

slotsSpinGrid

func(s *game31.slotsStream) [20]uint8

slotsSpinGrid draws the 5 reel stops and returns the 20 visible symbols.

Link Copy Open

OID

0a9dd2…b5d8:1278

slotsSpinGrid details

Inspect func

slotsLineMult

func(g *[20]uint8) (uint64, int)

slotsLineMult = Σ line pays in line-bet units, and how many lines paid.

Link Copy Open

OID

0a9dd2…b5d8:1279

slotsLineMult details

Inspect func

slotsCount

func(g *[20]uint8, sym uint8) int

Link Copy Open

OID

0a9dd2…b5d8:1280

slotsCount details

Inspect func

hsDrawValue

func(s *game31.slotsStream) uint16

hsDrawValue: 1× 50%, 2× 28%, 3× 12%, 5× 6%, MINI 3%, MINOR 0.9%, MAJOR 0.08%, GRAND 0.02%.

Link Copy Open

OID

0a9dd2…b5d8:1281

hsDrawValue details

Inspect func

slotsHoldAndSpin

func(s *game31.slotsStream, g *[20]uint8) ([20]uint16, int, bool)

slotsHoldAndSpin resolves the whole bonus from the stream: the vault cells start locked with a value each; then while respins remain and the board isn't full, every empty cell (in index order) lands a coin when its byte \< 8, and a landing resets the respins to 3. Returns the 20 tiles (0 = empty), how many respins were played, and whether the board filled (blackout = GRAND).

Link Copy Open

OID

0a9dd2…b5d8:1282

slotsHoldAndSpin details

Inspect func

slotsGridString

func(g *[20]uint8) string

Link Copy Open

OID

0a9dd2…b5d8:1283

slotsGridString details

Inspect func

hsTilesString

func(t *[20]uint16) string

Link Copy Open

OID

0a9dd2…b5d8:1284

hsTilesString details

Inspect func

jsonStr

func(s string) string

jsonStr returns s as a quoted, escaped JSON string (game28 concatenated raw user strings into JSON, so a guild name with a quote broke every reader).

Link Copy Open

OID

0a9dd2…b5d8:1285

jsonStr details

Inspect func

sanitizeName

func(s string) string

sanitizeName trims and strips control characters from a display name.

Link Copy Open

OID

0a9dd2…b5d8:1287

sanitizeName details

Inspect func

isSafeId

func(s string, maxLen int) bool

isSafeId reports whether s is a short \[a-z0-9\_.-] identifier.

Link Copy Open

OID

0a9dd2…b5d8:1288

isSafeId details

Inspect func

isHex64

func(s string) bool

Link Copy Open

OID

0a9dd2…b5d8:1289

isHex64 details

Inspect func

parseStringRows

func(s string) [][]string

parseStringRows parses a JSON array of arrays of strings, e.g. \[\["g1..","grin","10"],\["g1..","joy","4"]]. Numbers are accepted unquoted. Panics on malformed input.

Link Copy Open

OID

0a9dd2…b5d8:1290

parseStringRows details

Inspect func

parseStringList

func(s string) []string

parseStringList parses \["a","b",...].

Link Copy Open

OID

0a9dd2…b5d8:1291

parseStringList details

Inspect func

jparser

type

Link

Value

game31.jparser

getU

func(t *v0.Tree, key string) uint64

Link Copy Open

OID

0a9dd2…b5d8:1292

getU details

Inspect func

setU

func(t *v0.Tree, key string, v uint64)

Link Copy Open

OID

0a9dd2…b5d8:1293

setU details

Inspect func

addU

func(t *v0.Tree, key string, d uint64) uint64

addU adds d to a stored counter; panics instead of wrapping on overflow.

Link Copy Open

OID

0a9dd2…b5d8:1294

addU details

Inspect func

balOf

func(addr string, coin string) uint64

Link Copy Open

OID

0a9dd2…b5d8:1295

balOf details

Inspect func

creditBal

func(addr string, coin string, amt uint64)

Link Copy Open

OID

0a9dd2…b5d8:1296

creditBal details

Inspect func

debitBal

func(addr string, coin string, amt uint64)

Link Copy Open

OID

0a9dd2…b5d8:1297

debitBal details

Inspect func