v0 state

Render

Render serves three shapes: /r/nym-moultest123/vesting/v0 the seeded schedules /r/nym-moultest123/vesting/v0:g1... one address, its declared schedule /r/nym-moultest123/vesting/v0:g1...?o=&s=&e=&d= one address, a schedule you supply The query form stores nothing. It exists so an address that has not declared anything can still get a real answer: paste the schedule out of \`gnokey query auth/accounts/\<addr>\` and the balance is still read from chain.

source

Where a schedule came from. This is the distinction the whole page turns on, so it is a value and not a boolean buried in a branch.

sourceSeeded

// a source constant in this realm

sourceDeclared

// written by the address itself

sourceQuery

// typed into the URL by whoever is looking

sourceNone

// there is none

header

pageSize

pageSize bounds the declared table. vm/qrender runs on a gas meter and a large return value fails with OutOfGasError{Descriptor:"CPUCycles"} rather than answering slowly, so an unbounded index is a page that eventually stops rendering for everyone. Anyone may Declare, so "eventually" is somebody else's choice unless it is capped here.

renderIndex

curPage

curPage is the page renderIndex is currently building, set by Render before it delegates. A parameter would be cleaner; Render's signature is fixed by the VM, and threading it through every helper for one value is worse.

pageOffset

rowFor

rowFor builds one table row. Shared so the seeded and declared tables cannot drift apart in what they show.

pager

pager renders the page links, and nothing at all when everything fits.

renderAccount

renderUnknown

sourceNote

lookupForm

scheduleFromQuery

scheduleFromQuery reads a one-off schedule out of the URL. It returns a human-readable reason rather than an error value, because every caller turns it straight into page text.

orZero

lockedCapped

lockedCapped is what the account cannot move, which is never more than it holds. The schedule alone can say otherwise once coins have been spent.

tstamp

tstamp renders a unix second as a plain UTC date, which is all a two-year term needs. gno has no time formatting worth the dependency here.

civil

civil converts a day count since 1970-01-01 to a calendar date, by Howard Hinnant's civil\_from\_days. Integer only, no time package, no locale.

ufmtDate

pad2

Path

Link

Denom

seeded

seeded are the schedules this realm ships with, restored by init() after every redeploy. They are source constants and not registry rows on purpose: the realm is private = true, so a redeploy wipes realm state, and the one schedule the page exists to show should not need a transaction to come back. Each is copied from the genesis allocation sheet that built mainnet, which is the public, pinned input named in misc/deployments/mainnet.gno.land/gen-genesis.sh. An address is seeded here only when its LABEL is public too. The addresses are all on chain, but naming one is a claim about who holds it, and this realm is public and permanent. gen-genesis.sh names the investors-vesting multisig outright, so that one ships; the treasuries and the other buckets are identified nowhere public, so they do not, and the URL form serves anyone who wants to check them anyway.

declared

declared maps an address to the schedule that address declared for itself. Seeded schedules are NOT in here: they are read from the seeded slice, which is what lets the index render them in full while paging everything else. Anyone may Declare, so this tree is unbounded and the page that shows it cannot be.

seedIndex

seedIndex resolves a seeded address without walking the slice twice.

entry

entry is one row of the registry.

init.31

reset

reset restores the registry to exactly what the source declares. init() is its only caller on chain; a test calls it to render a page that does not depend on what the test before it wrote, since an Example runs after every Test in the package and sees the state they left.

Declare

Declare records the caller's own vesting schedule, replacing any previous one. It cannot write a row for anybody else, which is what keeps the registry honest without the realm being able to verify a thing. Pass original = 0 to declare that the address has no schedule at all.

Forget

Forget removes the caller's own declaration.

Count

Count returns how many schedules addresses have declared for themselves. Seeded schedules are not included; SeededCount reports those.

SeededCount

SeededCount returns how many schedules this realm ships in its source.

ScheduleOf

ScheduleOf returns the declared schedule for addr, and whether there is one.

SpendableOf

SpendableOf returns what addr can move right now, and whether the answer rests on a declared schedule. With ok false the figure is the whole balance, which is correct only if the address really has no schedule.

LockedOf

LockedOf returns what addr cannot move right now, and whether the answer rests on a declared schedule.

lookup

lookup reads a row, seeded first so a seeded address can never be shadowed. avl's Get returns ONE value and nil for a miss, unlike Remove which returns two; that asymmetry is a documented gno-vs-Go trap.

balanceOf

balanceOf reads the address's TOTAL ugnot, locked included. That is what banker.GetCoins reports and the only balance figure a realm can obtain. A readonly banker takes no realm, so this works from inside Render.

gnot

gnot renders a ugnot amount as GNOT with six decimals and no float.

pad6

pad6 left-pads to six digits. ufmt has no width flags, so this is by hand.

permille

permille renders tenths of a percent as a percentage with one decimal.

duration

duration renders a span of seconds as days and hours, which is the only resolution worth reading on a two-year schedule.

isAddr

isAddr is a cheap shape check, so a typo renders as "not an address" rather than as an account with a zero balance.

now

now is the chain's own clock, in unix seconds. time.Now() in a realm returns the BLOCK time, not a wall clock, which is exactly the value the ante handler compares a vesting schedule against.

chainHeight