v0 state

realmPath

realmPath is this realm's own path, the one its gnomod.toml module line declares. Render builds its links from it rather than from unsafe.CurrentRealm(), which in a plain read reports the CALLER.

Denom

Deposit

ChallengeBlocks

list

list is every entry and the credit ledger behind them. A redeploy would wipe it while leaving the coins at the address, which is what the note in gnomod.toml is about.

Apply

Apply lists an entry under key, in exchange for exactly [Deposit](#Deposit) ugnot. The entry is on the list the moment this returns: there is no application period in v0, and the check on a bad entry is that anybody can challenge it. The deposit comes back through [Unlist](#Unlist) and [Withdraw](#Withdraw) if nobody ever does. key is a slug: lowercase ASCII letters, digits, '-', '\_' and '.', starting alphanumeric. A key whose entry was removed is free to apply for again.

Challenge

Challenge objects to an entry, in exchange for a bond equal to that entry's own deposit, and opens a vote that closes [ChallengeBlocks](#ChallengeBlocks) blocks later. An owner cannot challenge their own entry: it would cost them nothing and would make the entry immune to a real challenge for the whole window.

Vote

Vote takes a side on an open challenge: keep the entry, or remove it. One address, one vote, unweighted, and it cannot be changed. An address is free, so this is cheap to manufacture; see the package doc.

Resolve

Resolve closes a challenge whose window has passed. Anyone may call it, so neither party can stall the other by sitting still. A majority of keep votes keeps the entry and credits its owner the bond. Otherwise the entry is removed and the challenger is credited the bond plus the deposit. A tie, including nobody voting at all, keeps the entry: the incumbent is the one already at risk, so a challenge that convinced nobody loses, which is what makes being wrong cost something.

Unlist

Unlist takes the caller's own entry off the list and credits them the deposit back, which [Withdraw](#Withdraw) then pays out. It is refused while a challenge is open: an owner who could walk away mid-challenge would be risking nothing, which is the one thing the deposit exists to prevent.

Withdraw

Withdraw pays the caller everything credited to them and returns it. This is the only way coins leave the realm. The credit is zeroed before the transfer, so a reentrant call finds nothing left to take.

Get

Count

Count is how many entries are on the list right now. A challenged entry counts: a challenge is an objection, not a verdict.

Listed

Listed is every key on the list, oldest first.

IsListed

IsListed reports whether key is on the list right now.

ChallengeOf

CreditOf

CreditOf is what who can collect with [Withdraw](#Withdraw) right now.

caller

Render

Render routes two views: the list itself, and one entry. A key never contains a slash, so "entry/\<key>" is a prefix strip rather than a path element that would have to be rejoined.

renderIndex

renderEntry

listing

listing renders the entries as the list itself: the key links to its page, the description links to the thing it describes.

challengeTable

challengeTable renders the open challenge against each of entries. An entry with none is skipped rather than shown blank.

entryURL

entryURL is the gnoweb path of one entry's page. The chain domain is the first element of a package path and a gnoweb path is the rest of it, so this is a prefix strip and not a hostname to hardcode.

applyURL

applyURL is the Apply form with the deposit already attached, so a reader never has to work out what -send should say.

challengeURL

challengeURL is the same for Challenge, carrying that entry's own bond.

send