home state

admin

admin is the only address allowed to write. Deliberately a constant and not transferable ownership: this realm is one person's profile page, and the same address is the only one the chain lets redeploy it.

layoutSlug

layoutSlug names the slot used as the page template.

maxSlugLen

maxSlugLen bounds a slug so an index row stays readable and a key stays cheap.

slots

// slug -> \*slot

rev

// total number of writes, bumped by every mutation

slot

reservedSlugs

reservedSlugs are placeholder names computed at render time from chain state. A slot may not take one, because it would shadow the computed value and make the page depend on callback registration order.

assertAdmin

validSlug

validSlug reports whether slug is a legal slot name: 1..maxSlugLen bytes of \[a-z0-9.\_-]. The character set excludes ':' so a slug can never break out of its own :slug: placeholder, and excludes uppercase so a slot has one name.

assertWritableSlug

Set

Set creates or replaces the slot named slug. This is the ordinary update: one slot, one transaction. Passing the empty body keeps the slot but empties it; use Delete to remove it.

Append

Append adds to the end of a slot, creating it when absent. It exists for content too large to fit in one transaction: Set the first chunk, Append the rest. Ordinary updates should use Set, which is idempotent.

Delete

Delete removes a slot. Deleting the layout slot restores the built-in default layout.

Get

Get returns a slot body, or "" when the slot does not exist.

Revision

Revision returns the total number of writes this realm has accepted. It changes on every mutation, so a client can cheaply tell "nothing moved".

Manifest

Manifest returns one tab-separated line per slot: <slug>\t<rev>\t<len>\t<sha256 of body, hex> It is the diff surface tools/gnohome queries with vm/qeval: one read tells it exactly which local file is out of date, without downloading any body.

defaultLayout

defaultLayout is what renders before a layout slot exists, i.e. right after the very first deploy. It uses only computed placeholders, so it never shows an unresolved :slug: of its own.

chainHeight

Render

Render serves three views: "" the assembled page, what https://gno.land/u/moul shows "slots" the slot index: name, size, revision, last write "slots/<slug>" one slot's raw markdown, fenced

renderPage

renderPage fills the layout. dynreplacer only invokes the callbacks whose placeholder actually occurs in the layout, so an unused slot is never even read out of the tree.

slotLinks

slotLinks is the :slots: placeholder: a bullet list of every slot, linking to its raw view.

renderIndex

renderSlot