bubblerumble5 state

MinWindow

// seconds

MaxWindow

// 30 days

MinLife

// an hour

MaxLife

// 30 days

MinBasePrice

// ugnot, 0.001 GNOT

MaxBasePrice

// ugnot, 1,000,000 GNOT

MaxNameLen

HistoryLen

// bids kept per pool for the feed

RosterMax

// distinct bidders a pool pays dividends, team shares and the close split to

MaxBoost

// the shortest clock a bid can buy is window/MaxBoost...

MinClock

// ...and never under five minutes: people must be able to answer

PotShare

DivShare

// to earlier bidders of the pool, pro-rata by weight

RefShare

// to the bidder's inviter

CreatorShare

TreasuryShare

// to the BUBBLE treasury: the token realm's sub-realm, spent only by the holders' vote

TeamShare

ShotMaxBps

// 1% a shot, whatever is paid

ShotFair

// chance in bps = ShotFair × shot / take (0.8 of fair odds)

ShotDelay

// blocks after the shot was paid for before it can be revealed...

ShotWindow

// ...and how many more blocks it may still be revealed in: three blocks, as v3 drew; three rolls at most for the secret's holder

MinShot

// ugnot: no shot under 0.1 GNOT, so dust cannot make reveals cost more than they tip

RevealTip

// ugnot: off every shot, to whoever reveals it

KeeperFresh

// seconds: shots are sold only this soon after the keeper's last sign of life (it heartbeats every two minutes)

LiveFloor

// bps: no shots once the winner's live share has slid under a quarter (which also keeps every reveal window clear of the last day)

MaxCommits

// unused commitments the queue holds at most

CommitBatch

// hashes one Commit may bring

CommitCompact

// used commitments kept before the queue is compacted

admin

admin is the realm's deployer: the only address that may turn shots off.

pkgPath

pkgPath must match gnomod.toml: the realm's own address derives from it.

bubblePath

The BUBBLE treasury is the token realm's sub-realm for its \`treasury:spend\` kind (the realm bubbletreasury publishes the kind and says the same address): a distinct address the token's governor alone can spend from, after a vote of the holders. Derived here from the two paths, as the chain derives it.

treasurySubpath

The BUBBLE treasury is the token realm's sub-realm for its \`treasury:spend\` kind (the realm bubbletreasury publishes the kind and says the same address): a distinct address the token's governor alone can spend from, after a vote of the holders. Derived here from the two paths, as the chain derives it.

Entry

Member

Member is a distinct bidder of a pool: dividends, team shares and the close split go to the roster. The flag is the one flown at the first bid here.

Shot

Shot is a shot at the bubble waiting to be revealed, or resolved.

Pool

Player

Player is what the realm remembers about an address across pools.

shotsOn

keeper

// who commits and heartbeats (SetKeeper); the admin may too

keeperSeen

// the keeper's last Commit or Heartbeat

commits

// the hashes of the keeper's secrets (32 raw bytes each), in order; the first head are used

head

voided

// shots voided over all pools

late

// shots revealed after the first block of their window, over all pools

pools

players

teamPaid

// flag -> gross bid volume under it

teamWon

// flag -> pots closed under it

teamSize

// flag -> players flying it

realmAddr

treasuryAddr

treasuryPaid

// the royalty over all pools

TreasuryAddr

TreasuryPaid

TreasuryPaid is what every pool of this realm has sent there.

Price

Price of the next bid in a pool with the given base price and n bids so far.

ClockFor

ClockFor is the clock a bid buys by paying sent against a price: the window divided by the multiple paid, never below window/MaxBoost.

mulDiv

mulDiv is a×b/c without overflowing on the way: pots and paid-ins are both in ugnot and their product passes int64 at a few thousand GNOT each.

ShotBps

ShotBps is the chance a shot buys against what a pop would pay, in basis points.

CreatePool

CreatePool opens a pool. Any ugnot sent with the call seeds its pot. The creator earns CreatorShare of every bid. life is the pool's life in seconds from its first bid; 0 means ten windows (at least an hour, at most 30 days).

newPool

Bid

Bid pays at least the current price and resets the clock. ref is the address that invited the bidder ("" for none; only the first bid ever sets it), flag a two-letter country to play under ("" keeps the last one; the flag is locked per pool at the first bid there), shot how much of the money sent is a shot at popping the bubble (0 for none): the rest must cover the price, and paying more than the price shortens the clock.

SetShots

SetShots turns shots off (or on again); only the deployer may.

SetKeeper

SetKeeper names the address that commits and heartbeats; only the deployer may. Every unused commitment is dropped with it: a rotated or compromised keeper's secrets never decide a shot.

keeperCaller

keeperOrAdmin

Heartbeat

Heartbeat is the keeper's sign of life: shots are sold only within KeeperFresh of the last one (a Commit counts too).

Commit

Commit queues the hashes of secrets the keeper will reveal later, in order, as a comma-separated list of 64 hex characters each; only the keeper, whose box holds the secrets. A hash still in the queue (used or not) is refused: a repeated secret would be public after its first reveal (a safety net against the keeper repeating itself; compaction forgets the oldest). The queue holds at most MaxCommits unused; the used ones in front of it are compacted away past CommitCompact.

Retire

Retire drops the first n unused commitments: a keeper that lost the secrets behind them (the box rebuilt, the file gone) clears them so shots can go on. The deployer may too. It is not a sign of life.

Reveal

Reveal draws shots with the secrets behind their commitments: a comma-separated list of pool:shot:secretHex, any pools, in one transaction — the keeper sends every shot that is due in one call, so a run of shots on one block never outpaces it. Anyone may call it; the secret is the proof, and the caller is tipped RevealTip out of each shot revealed. Shots go in order: an earlier one still pending must come first (in the list, or before). An entry not yet due is skipped, one with a wrong secret or already resolved is skipped with an event, so a stale entry never voids the rest; a malformed one (no such pool or shot, a cancelled pool, not pool:shot:secret) aborts the whole call, which only the keeper's own bug could send. The reveal must land in the blocks CommitH+ShotDelay through CommitH+ShotDelay+ShotWindow; later, or on a pool that has closed, the shot is already void (settleShots runs first): into the pot as a miss. A hit pops the bubble: the pool closes now with the shooter as its winner, settled at Claim.

Settle

Settle voids the shots at a pool that nobody revealed in time, or that its close overtook. Anyone may call it; every bid, reveal and claim on the pool does the same first.

jif

seedFor

seedFor is the draw's seed: the secret with the shot's own facts and the reveal block's height and time. Everything but the secret is public, and the secret is the keeper's until the reveal; the block's time is the validators'.

shotHits

shotHits is the draw: a uniform number in \[0, 10000) under the chance.

Claim

Claim settles a finished pool: everything is credited, and Withdraw sends it. TeamShare of the pot goes to the OTHER roster members flying the winner's flag, pro-rata by paid-in — or, when nobody else flew it, to all the other roster members. Of the rest, the live part (LiveBps) is the winner's and the shared part is split among the whole roster pro-rata by paid-in. A pool with a single bidder credits them everything. Rounding goes to the winner. Anyone may call it.

Cancel

Cancel lets the creator take the seed back from a pool nobody has bid on.

player

send

credit

credit books ugnot to an address; Withdraw pays it out.

Withdraw

Withdraw sends the caller everything credited to them: dividends, team shares, close splits, slices and won pots.

Owed

Owed is what an address could withdraw right now.

pool

userCaller

ugnotSent

cleanName

cleanFlag

cleanFlag accepts a two-letter country code, upper-cased; anything else is "".

itoa

parseID

parseNum

GNOT

GNOT formats ugnot as GNOT with the trailing zeros trimmed.

short

dur

Render

Render serves gnoweb ("" and "\<id>") and the page ("json", "json/\<id>", "me/\<address>", "teams").

unix

jbool

jsonCommits

jsonCommits lists the unused commitments in order, hex, so a keeper that starts can tell which of them it holds the secrets for and Retire the rest.

commitHead

commitHead is the next commitment a shot would take, hex, "" when none is free.

jsonAll

jsonTeams

jsonTeams is the country leaderboard: paid in, won, and players per flag.

jsonMe

jsonMe is what the page shows a connected wallet about itself.

markdownAll