v0 state

Period

The economy. Ore is a bare integer: there is no token here, and nothing leaves the realm.

CapPeriods

The economy. Ore is a bare integer: there is no token here, and nothing leaves the realm.

UpgradeBase

The economy. Ore is a bare integer: there is no token here, and nothing leaves the realm.

PrestigeAt

The economy. Ore is a bare integer: there is no token here, and nothing leaves the realm.

MaxLevel

The economy. Ore is a bare integer: there is no token here, and nothing leaves the realm.

MaxPrestige

The economy. Ore is a bare integer: there is no token here, and nothing leaves the realm.

errNoMine

mine

mine is one player's state. pending and anchor are the accrual pair: what was in the mine, and as of when. Everything else is bookkeeping.

mines

// address string -> \*mine

now

now is the chain's own clock in unix seconds. time.Now() in a realm returns the block timestamp, so it is consensus-deterministic rather than wall time.

rate

rate is the accrual Rate for a level and prestige. It is rebuilt on each call rather than stored, so a mine's stored state cannot disagree with the economy after a redeploy changes a constant.

upgradeCost

upgradeCost is what it costs to leave the given level.

get

start

start opens a mine for owner. Non-crossing so tests can drive the clock.

mustGet

claim

claim banks everything the mine has dug.

upgrade

upgrade spends the bank to raise the level.

prestige

prestige trades the mine for a permanent multiplier.

Start

Start opens a mine for the caller. One per address, forever: Prestige is the only way to start over, and it keeps your lifetime total.

Claim

Claim banks whatever the mine has dug since the last claim. Claiming often and claiming rarely pay exactly the same, by construction: see accrual.

Upgrade

Upgrade spends banked ore to raise the level, which raises both the rate and the ceiling.

Prestige

Prestige resets a level-10 mine to level 1 for a permanent +1 multiplier. Banked and pending ore are burned; the lifetime total is not.

Pending

Pending reports what is sitting in an address's mine right now, unclaimed.

Banked

Banked reports an address's spendable ore.

Level

Level reports an address's level and prestige.

FullAt

FullAt reports the unix second at which an address's mine starts wasting what it digs, which is the only deadline in this game.

Render

Render shows every mine, or one mine's card at /r/.../idle:\<address>. The numbers move on their own: the same URL renders differently a minute later because the mine kept digging, and nothing wrote to the chain in between. That is the whole point of the accrual pair, and it is why every figure here comes from the read-only view rather than from stored state.

byLifetimeThenOwner

byLifetimeThenOwner ranks by lifetime ore, then by address so the order is identical on every node.

board

card

span

span renders a number of seconds the way a player reads it. It rounds down and stops at two units, because "2h 3m 11s to spill" is noise when the question is whether to claim now or after lunch.