v0 state

Render

Render serves three shapes: /r/moul/vesting/v0 the seeded schedules /r/moul/vesting/v0:g1... one address, its declared schedule /r/moul/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

renderIndex

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.

declared

declared maps an address to the schedule that address declared for itself.

entry

entry is one row of the registry.

init.25

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 the registry holds.

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. 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