v0 state

reg

caller

must

resolveName

Register

Register records that pkgPath was built from dir of repo at commit. Calling it again for the same path replaces the caller's own claim and nobody else's, so moving a claim to a new commit after a redeploy is one call with no read first. ref is optional and is never the thing verified: a ref moves, a commit does not. It is recorded so a reader can tell a claim pinned to a released tag from one pinned to a commit on nobody's branch, and so a verifier can report a commit that has since been orphaned by a force-push. dir is empty when the package sits at the repository root.

Withdraw

Withdraw removes the caller's own claim about pkgPath.

PackageCount

PackageCount is how many package paths carry at least one claim.

ClaimCount

ClaimCount is the total number of claims across every path.

HasClaims

HasClaims reports whether anything has been said about pkgPath. Cheap enough for another realm or an indexer to ask per package.

OwnerClaim

OwnerClaim returns the repository, commit and directory claimed by the party that owns pkgPath's namespace, and whether such a claim exists. This is the only read that filters, and it filters on the one signal the chain can actually prove. Everything else a caller wants is in Render or in the events.

pageSize

pageSize bounds every listing: a Render that walks unbounded state is a Render that eventually stops rendering.

Render

Render routes gnoweb paths: / every claimed package path /<package path> the claims about one package /help what this realm is, and how to write to it

base

pkgURL

link

link does not escape its text, because every call site passes a field that is charset-validated at write time (see the note above). Escaping here would turn "gno.land/p/moul/md/v1" into "gno\\.land/p/moul/md/v1" on every row of every listing, for no safety anyone gains.

join

join glues blocks with exactly one blank line between them. gno collapses two consecutive blank lines inside an example's // Output: block, exactly as Go does, so a Render that ever emits them cannot be pinned by an example at all. Appending "\\n" by hand as sections are built is how a Render acquires them; assembling a list of blocks and joining once is how it stops. Every block arrives without its own leading or trailing blank.

pageOf

notFound

notFound echoes the requested path, which is the only untrusted string this file handles: it comes from the URL and has already failed validation by the time we are here. It is escaped rather than dropped, because "that is not a package path" without saying which one is an unhelpful error.

renderHome

pager

renderPackage

claimBlock

renderHelp