duebook_demo state

MinDelayBlocks

MaxDelayBlocks

MaxTTLBlocks

MaxOpen

MaxTextLen

MaxPublishedKept

MaxListed

book

book holds the scheduled announcements. It is unexported and never returned: handing a \*Book across a realm boundary would hand out the right to schedule, cancel and claim (duebook consumer contract 3).

publication

publication is one published announcement, kept for rendering.

published

// padded seq -> \*publication

publishedTotal

// every publication ever, including evicted

nextSeq

rejectStraySend

rejectStraySend aborts if an EOA attached coins to an entrypoint that has no use for them. This realm never holds value; without this guard a mistyped send would be silently absorbed by the realm bank.

Schedule

Schedule registers an announcement to be published no earlier than delayBlocks from the current height, and returns its deferral ID. ttlBlocks is how long after the due height the announcement stays publishable; 0 means it never expires. The caller becomes the owner and is the only account that may Cancel it.

Publish

Publish publishes a scheduled announcement once it is due. It is deliberately permissionless: duebook's exactly-once Claim is the only thing preventing a second publication, which is precisely what this realm exists to demonstrate. Aborts if the announcement does not exist, is not due yet, has expired, or has already been consumed by a publication or a cancellation.

Cancel

Cancel withdraws a scheduled announcement before it is published. Only the account that scheduled it may cancel, and only while it is still open — a cancellation that arrives after publication aborts.

Expire

Expire clears an announcement whose time-to-live has elapsed, freeing its slot against MaxOpen. It is permissionless because an expired announcement can never be published, so there is nothing left to protect and everything to gain from letting anyone tidy up.

Height

Height returns the chain height this realm is reading as "now".

OpenCount

OpenCount returns how many announcements are currently scheduled.

PublishedTotal

PublishedTotal returns how many announcements have ever been published, including ones since evicted from the rendered window.

NextID

NextID returns the deferral ID the next Schedule will allocate. It only ever increases; that is what makes a consumed ID permanently unusable.

Status

Status describes a scheduled announcement: its window, and whether it is publishable right now. Returns "unknown" when the ID was never issued or has already been consumed — duebook keeps no tombstone, so those two cases are indistinguishable by design.

DueNow

DueNow returns the IDs of announcements publishable at the current height, oldest first, capped at MaxListed.

ExpirableNow

ExpirableNow returns the IDs that Expire would accept at the current height, oldest first, capped at MaxListed.

realmPath

realmPath is this realm's gnoweb prefix, used to build view links.

Render

Render serves three views, selected by path. Anyone may Schedule, so the default view must not be something a stranger can inflate: it shows only what is publishable right now, capped at MaxListed. The full scheduled table lives behind :open and is capped too, so no view is unbounded and none of them is the landing page by default. (empty) summary + publishable now + recent publications open every scheduled announcement, up to MaxListed rows about what this realm is and why it exists

renderHeader

renderDue

renderDue lists only what can be published at this height. book.Due applies the cap itself, so the slice is at most MaxListed long.

renderOpen

renderOpen lists the whole book, stopping at MaxListed rows so this view has a fixed ceiling independent of MaxOpen.

renderRows

renderPublished

renderPublished shows the retained window, which evictOldest already holds at MaxPublishedKept entries.

renderAbout

normalizePath

normalizePath reduces a gnoweb render path to a bare view name, so "", "/", "open" and "/open/" all select the same view.

mustID

mustID converts an exported int64 ID to duebook's uint64 form. IDs start at 1, so anything below that was never issued.

evictOldest

evictOldest trims the rendered window to MaxPublishedKept, dropping the lowest sequence numbers first. Evicted publications remain in the emitted events.

seqKey

seqKey encodes a sequence number so avl's lexical order matches numeric order. Sequences are positive int64, at most 19 digits.

itoa

utoa