bubblerumble4 source realm

 1const (
 2	MinWindow    int64 = 10                // seconds
 3	MaxWindow    int64 = 30 * 24 * 3600    // 30 days
 4	MinLife      int64 = 3600              // an hour
 5	MaxLife      int64 = 30 * 24 * 3600    // 30 days
 6	MinBasePrice int64 = 1_000             // ugnot, 0.001 GNOT
 7	MaxBasePrice int64 = 1_000_000_000_000 // ugnot, 1,000,000 GNOT
 8	MaxNameLen         = 40
 9	HistoryLen         = 50  // bids kept per pool for the feed
10	RosterMax          = 100 // distinct bidders a pool pays dividends, team shares and the close split to
11	MaxBoost     int64 = 10  // the shortest clock a bid can buy is window/MaxBoost...
12	MinClock     int64 = 300 // ...and never under five minutes: people must be able to answer
13
14	// where every bid goes, in percent
15	PotShare     int64 = 55
16	DivShare     int64 = 30 // to earlier bidders of the pool, pro-rata by weight
17	RefShare     int64 = 10 // to the bidder's inviter
18	CreatorShare int64 = 5
19	// of the pot at the close, to the other bidders under the winner's flag
20	TeamShare int64 = 35
21
22	ShotMaxBps    int64 = 100     // 1% a shot, whatever is paid
23	ShotFair      int64 = 8000    // chance in bps = ShotFair × shot / take (0.8 of fair odds)
24	ShotDelay     int64 = 3       // blocks after the shot was paid for before it can be revealed...
25	ShotWindow    int64 = 2       // ...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
26	MinShot       int64 = 100_000 // ugnot: no shot under 0.1 GNOT, so dust cannot make reveals cost more than they tip
27	RevealTip     int64 = 20_000  // ugnot: off every shot, to whoever reveals it
28	KeeperFresh   int64 = 300     // seconds: shots are sold only this soon after the keeper's last sign of life (it heartbeats every two minutes)
29	LiveFloor     int64 = 2500    // 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)
30	MaxCommits          = 500     // unused commitments the queue holds at most
31	CommitBatch         = 100     // hashes one Commit may bring
32	CommitCompact       = 200     // used commitments kept before the queue is compacted
33)

1func Bid(cur realm, id int64, ref string, flag string, shot int64)

1func Cancel(cur realm, id int64)

1func Claim(cur realm, id int64)

1func ClockFor(window, price, sent int64) int64

1func Commit(cur realm, hashes string)

1func CreatePool(cur realm, name string, window int64, basePrice int64, life int64) int64

1func GNOT(ugnot int64) string

1func Heartbeat(cur realm)

1func Owed(a address) int64

1func Price(base, n int64) int64

1func Render(path string) string

1func Retire(cur realm, n int64)

1func Reveal(cur realm, reveals string)

1func SetKeeper(cur realm, addr address)

1func SetShots(cur realm, on bool)

1func Settle(cur realm, id int64)

1func ShotBps(shot, take int64) int64

1func Withdraw(cur realm) int64

 1type Entry struct {
 2	N      int64
 3	Bidder address
 4	Flag   string
 5	Price  int64 // what was paid for the bid itself; at least the price at the time
 6	Shot   int64 // extra paid for a chance to pop the bubble
 7	Clock  int64 // seconds this bid had to stand
 8	Pot    int64 // pot right after this bid
 9	At     time.Time
10}

1type Member struct {
2	Addr   address
3	Flag   string
4	Paid   int64 // gross paid into this pool (bids and shots)
5	Earned int64 // dividends received from this pool
6}

 1type Player struct {
 2	Referrer  address // set by the first bid, permanent
 3	Recruits  int64
 4	Flag      string
 5	Bids      int64
 6	Paid      int64
 7	DivEarned int64
 8	RefEarned int64
 9	Won       int64 // pots, team shares, close splits and shot slices received
10	Shots     int64
11	Hits      int64
12	Owed      int64 // credited and not yet withdrawn
13	Withdrawn int64
14}

 1type Pool struct {
 2	ID          int64
 3	Name        string
 4	Creator     address
 5	Window      int64 // seconds the last bid must stand to win
 6	Life        int64 // seconds from the first bid to the last day
 7	BasePrice   int64 // ugnot; the Nth bid costs BasePrice·√N
 8	Seed        int64
 9	Pot         int64
10	Bids        int64
11	LastBidder  address
12	LastBidAt   time.Time
13	FirstBidAt  time.Time
14	Clock       int64 // seconds the current top bid has to stand
15	CreatedAt   time.Time
16	Paid        bool // the pot went out, or the seed back to the creator
17	Cancelled   bool
18	Popped      bool // a shot ended it
19	PoppedAt    time.Time
20	DivPaid     int64 // dividends paid out of this pool so far
21	RefPaid     int64
22	CreatorPaid int64
23	ShotPaid    int64 // slices paid to hits while the pool went on
24	Misses      int64 // shots resolved and lost, voids included: the scars on the bubble
25	Voided      int64 // of those, the shots nobody revealed in time
26	Late        int64 // shots revealed in their window but not at its first block: a keeper choosing its block would show here
27	ShotEscrow  int64 // shots paid for and not yet resolved: in the pot once they are
28	WinnerFlag  string
29	TeamPaid    int64 // what the winner's team received at the close
30	SharedPaid  int64 // the pro-rata part of the close
31	WinnerPaid  int64
32	History     []Entry
33	Roster      []*Member
34	Shots       []*Shot
35	Settled     int // shots before this index are all resolved (they resolve strictly in order): where settleShots starts
36}

 1type Shot struct {
 2	N        int64 // 1-based within the pool
 3	Bidder   address
 4	Paid     int64  // ugnot paid for it (the tip comes out of this at the reveal)
 5	Take     int64  // what a pop would have paid the shooter when the odds were set
 6	Bps      int64  // chance, in basis points
 7	CommitH  int64  // block height when paid; revealable at CommitH+ShotDelay and the ShotWindow blocks after
 8	Hash     string // the commitment it took: sha256 of the secret that decides it, 32 raw bytes
 9	Resolved bool
10	Won      bool
11	Void     bool // not revealed in its window, or the pool closed first: a miss
12	DrawH    int64
13	Revealer address
14}