bubblerumble3 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

TeamShare

ShotCap

// ugnot: the most a shot can take, 10 GNOT

ShotMaxBps

// 1% a shot, whatever is paid

ShotFair

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

ShotDelay

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

ShotWindow

// ...and how many more blocks it may still be drawn in

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.

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 drawn, or drawn.

Pool

Player

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

shotsOn

pools

players

teamPaid

// flag -> gross bid volume under it

teamWon

// flag -> pots closed under it

teamSize

// flag -> players flying it

realmAddr

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 a prize, 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.

Draw

Draw draws the shots at a pool that are due. Anyone may call it; every bid and claim on the pool does the same first.

seedFor

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

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

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