adstation source realm

 1const (
 2	pkgPath = "gno.land/r/g1leu8d2vsplhehcfkjg50mwgdpxdkt8tztu95wr/adstation" // must match gnomod.toml
 3	coldKey = address("g1ecsuj0q572jr0dhu29q9njtnmw03hyu7tyyvv6")             // Jae's: the first owner and approver
 4	GNOT    = "ugnot"
 5
 6	WeekLen    = int64(7 * 86400)
 7	Monday0    = int64(4 * 86400) // 1970-01-05 00:00 UTC, the first Monday after the epoch
 8	CloseAhead = int64(86400)     // a week's bidding closes a day before it starts
 9	AheadWeeks = int64(8)         // weeks open for bidding, counting from the next one
10
11	MaxPanels         = 1024 // the most panels a week may have
12	MaxBidsWeek       = 200  // bids a week holds (Settle ranks them all in one call); a full week takes a larger bid in place of its smallest
13	MaxBidsBidderWeek = 10   // open bids one wallet may hold in one week
14	MaxOpenBidsAd     = 32   // open bids one ad may carry (a turn-down refunds them in one call)
15	MaxPending        = 100  // ads waiting for an approver with a bid at stake, at once
16	MaxPendingOwner   = 5    // … of them one advertiser's
17	maxRejectMany     = 10   // ads one RejectMany turns down: ten with 32 open bids each in full weeks cost ~0.94B gas on a node, fifty ~3.57B, more than a block (review round 2, R2-3)
18	maxTitle          = 60
19	maxLink           = 200
20	maxReason         = 120
21	maxPanelsSpec     = 2000
22	listMax           = 50
23	defaultPanels     = 108         // the ring: 27 columns × 2 rows × 2 faces
24	defaultMinBid     = 100_000_000 // 100 GNOT (jae: "100 GNOT (~$7)")
25)

1func AcceptOwner(cur realm)

1func AddApprover(cur realm, a address)

1func Approve(cur realm, adID int64)

1func Bid(cur realm, week int64, panelSpec string, image, link, title string) int64

1func BidAd(cur realm, adID int64, week int64, panelSpec string) int64

1func Closes(week int64) int64

1func Earned() int64

1func IsApprover(a address) bool

1func MinBid() int64

1func NextWeek() int64

1func Owed(a address) int64

1func Panels() int

1func Paused() bool

1func PayOut(cur realm, to address) int64

1func Raise(cur realm, bidID int64)

1func Reject(cur realm, adID int64, reason string)

1func RejectMany(cur realm, adIDs string, reason string) int

1func RemoveApprover(cur realm, a address)

1func Render(path string) string

1func SetMinBid(cur realm, ugnot int64)

1func SetOwner(cur realm, to address)

1func SetPanels(cur realm, n int)

1func SetPaused(cur realm, p bool)

1func Settle(cur realm, week int64) int64

1func ThisWeek() int64

1func Unsettled() []int64

1func WeekOf(t int64) int64

1func Winners(week int64) []int64

1func Withdraw(cur realm) int64

1func GetAd(id int64) Ad

1func GetBid(id int64) Offer

 1type Ad struct {
 2	ID      int64
 3	Owner   address // the advertiser who made it with their first bid
 4	Image   string  // sha256 hex of the picture as the site stores it
 5	Link    string  // https://…
 6	Title   string
 7	State   string // "pending", "approved", "rejected"
 8	Reason  string // why it was turned down
 9	By      address
10	At      int64 // when it was decided
11	Created int64
12	open    []int64 // its open bids
13	queued  bool    // counted in pending: waiting, with a bid at stake
14}

 1type Offer struct {
 2	ID     int64
 3	Week   int64 // the week's start
 4	Ad     int64
 5	Bidder address
 6	Panels string // canonical: "0-8,27-35"
 7	Count  int    // panels in it
 8	Amount int64  // ugnot
 9	Placed int64
10	State  string // "open", "won", "lost", "refunded" (its ad was turned down), "bumped" (a full week gave its place up)
11	bits   []uint64
12}

 1type Week struct {
 2	Start   int64
 3	N       int // its panel count, fixed at its first bid
 4	Settled bool
 5	Paid    int64 // to the treasury
 6	bids    []int64
 7	amts    []int64 // each listed bid's amount, beside bids: a full week finds its smallest bid without reading every bid
 8	appr    []bool  // beside bids: its ad is approved, so a full week never gives its place up (review round 2, R2-1)
 9	won     []int64
10	per     map[address]int // each bidder's open bids in it, until it settles (a bid counts its bidder's without a scan)
11}