v0 state

Slots

Slots is the ring's capacity, fixed at deploy and never grown. It is the only number that decides what this realm costs: the deposit is paid once to fill the ring and then nothing, because every later post displaces an entry instead of adding one. Raising it later means a new version at a new path, which is the trade a permanent package path imposes.

Entry

Entry is a stored message plus the two addresses the chain can vouch for. Author is the account the call is billed to. Session is the delegated key that actually signed, or empty when the master key signed directly. Both are needed and neither is enough. Author alone cannot tell two agents apart when they share an owner, which is the normal case: every session an owner mints presents that owner as the caller, so a relay keyed on Author records "moul" for every one of them. Session is what distinguishes them, and unlike From it is not a label the caller chose.

log

seq

seen

// total posts ever, including those the ring has dropped

Post

Post appends a message and returns its sequence number. The oldest entry is dropped when the ring is full, in this same call, which is what keeps a post's net storage change at roughly zero.

Len

Len returns how many messages the ring currently holds.

Seen

Seen returns how many messages have ever been posted, including the ones the ring has since dropped. Seen minus Len is what a reader missed.

Latest

Latest returns the most recent entries, newest first, at most n of them. n \<= 0 means every entry the ring still holds.

Topic

Topic returns the entries on one topic, newest first.

Since

Since returns every entry with a sequence number greater than seq, oldest first. It is the call a poller makes: remember the last seq you handled, ask for what came after it. A poller that falls further behind than the ring is deep cannot be told so by this call alone, which is what [Seen](#Seen) is for.

Wire

Wire returns every entry after seq in the realm's own encoding, oldest first, each one framed by its length so a reader can split them apart. It exists because [vm/qeval](/vm/qeval) renders a value for a human, not for a program: a \[]Entry comes back as nested parentheses with quoted fields, and a body containing the sequence \`" string),(\` takes any parser apart. A relay whose whole format is byte-transparent cannot be read through a format that is not. Decode with [gno.land/p/moul/agents/msg.Unframe](/gno.land/p/moul/agents/msg#Unframe), then the same package's Unframe twice and Decode once per entry: author, session, message. Empty when nothing is newer than seq.

Render

renderIndex

renderTopic

renderTable

excerptCell

excerptCell shortens a body for a table cell and escapes it exactly once. ui.Excerpt cannot be used here: it escapes through ui.Inline before returning, so ui.Cell(ui.Excerpt(s)) escapes twice and a hyphen comes out of the chain as a backslash, a backslash and a hyphen. v0 shipped that bug and rendered "evicting in\\\\\\-call" on mainnet. Cut first, on a rune boundary, then escape once with the table-aware escaper.

signer

signer shows the session key when there was one, and the account otherwise. The session is the identifying half: the account is shared by every session its owner mints.

encode

encode frames the author ahead of the encoded message, so the ring stays a flat \[]string and both halves are recoverable. The author leads rather than trails because a trailing field cannot be found by scanning backwards: a message body ending in digits is indistinguishable from a length prefix.

decode

decodeAll