memba_gov state

VotingPeriod

The policy's durations, in their own file so a node fixture, which cannot wait days, can replace this file alone and run the real rules faster.

ExecutionWindow

The policy's durations, in their own file so a node fixture, which cannot wait days, can replace this file alone and run the real rules faster.

WeightedDelay

// critical, weight route

HeadcountDelay

// critical, headcount route

RosterDelay

The policy's durations, in their own file so a node fixture, which cannot wait days, can replace this file alone and run the real rules faster.

InactiveDelay

The policy's durations, in their own file so a node fixture, which cannot wait days, can replace this file alone and run the real rules faster.

InactiveAfter

The policy's durations, in their own file so a node fixture, which cannot wait days, can replace this file alone and run the real rules faster.

SeedInviteTTL

The policy's durations, in their own file so a node fixture, which cannot wait days, can replace this file alone and run the real rules faster.

VotedInviteTTL

The policy's durations, in their own file so a node fixture, which cannot wait days, can replace this file alone and run the real rules faster.

corePath

MaxSeats

MinSeats

MaxScope

MaxNote

MaxAction

actAddMember

actRemoveMember

actSetWeight

actRecover

actRemoveInactive

actUninvite

voteYes

voteNo

voteAbstain

person

invite

invite seats addr as id (a new person) or, for a recovery, gives the existing person id the new key addr, once addr itself calls Join.

ballot

proposal

seated

invites

proposals

// padded id -> \*proposal

scopes

// target + "\\n" + scope -> uint64 generation

lastID

globalGen

init.34

seedRoster

now

now is the block time in unix seconds; every stored time uses it.

secs

Propose

Propose files one action. target is the realm that will consume it, or this realm for a roster action; scope is the invalidation key that realm computes for the action; class is at least the class it requires.

Vote

Vote records yes, no or abstain until the voting deadline. After it, a YES can still be withdrawn while the proposal is not executed or expired, so members can stop an approval they no longer back.

Join

Join seats the caller's invitation: a new person, or a recovered key.

Execute

Execute runs a ready roster action of this realm. The roster it was checked against at Propose is unchanged: any change would have invalidated it.

Consume

Consume is crossing-called by a governed realm right before the step a proposal approved. It panics unless the caller is exactly the proposal's target, the action, arguments and scope are the voted ones byte for byte, the class is at least minClass, the proposal is ready, and executor, the account that called the target directly, is a seated member. It marks the proposal used and invalidates the other open proposals of (target, scope).

IsMember

IsMember reports whether addr is a seated member's current key.

PersonOf

PersonOf returns the id of the seated member whose current key is addr, or "". The id survives a key recovery.

user

member

rosterClass

rosterClass and rosterDelay fix how each roster action passes.

rosterDelay

checkRosterAction

checkRosterAction validates a roster action's fields against the roster.

weightField

addInvite

dropInvite

removePerson

checkRoster

checkRoster enforces the bounds, valid ids, addresses and weights, and the uniqueness of ids and of addresses across seats and open invitations. An invitation may name a seated id: that is a recovery, with no weight.

addrTaken

addrTaken reports whether a is seated, or invited for someone other than id: a newer invitation for id replaces id's own.

invited

personByAddr

personByID

weightOf

seatedTotals

scopeGen

isOpen

mustGet

key

validTarget

validTarget accepts a realm path: no user ("") or MsgRun (gno.land/e/) identity, no sub-realm ("#"), lowercase path characters only.

validAction

validID

lower

upper

digits

only

only reports whether every byte of s is in set.

Routine

Classes. A target hard-codes the minimum class of each action it governs.

Financial

Classes. A target hard-codes the minimum class of each action it governs.

Critical

Classes. A target hard-codes the minimum class of each action it governs.

route

A route is one way a proposal passes: a rule on the YES votes of the seated roster and the delay that follows. Thresholds are fractions of the seated weight W and persons N. Every rule needs at least two persons: the critical ones because N is at least 2.

ruleRoutine

ruleFinancial

ruleWeighted

ruleHeadcount

meets

routes

routes returns the ways proposal p passes: its class sets the rules, and a roster action of this realm has its own delay on every route.

streak

A streak is one current YES ballot: when it began and its voter's weight.

yesStreaks

yesStreaks returns p's current YES ballots, oldest streak first.

qualifiedSince

qualifiedSince returns when (unix seconds) the earliest coalition still voting YES without interruption first met rule, or 0. The coalition of a start time is every YES streak begun no later; every rule only grows with more votes, so the first prefix of ys that meets it ends on that time (streaks begun in the same second share it). A voter the rest of the coalition does not need cannot postpone the clock by withdrawing and rejoining.

stExecuted

Proposal states, in the order a reader checks them.

stInvalidated

Proposal states, in the order a reader checks them.

stExpired

Proposal states, in the order a reader checks them.

stReady

Proposal states, in the order a reader checks them.

stTimelocked

Proposal states, in the order a reader checks them.

stVoting

Proposal states, in the order a reader checks them.

state

state returns p's status and, once some route qualified, the earliest unix time it is or becomes executable (0 before). Voting ends just before the deadline second; readyAt and the end of the execution window are inclusive.

vetoed

vetoed reports whether the member a RemoveInactive names has been active since the proposal: proposing, voting, executing or joining vetoes it.

MaxListed

MaxListed is the most proposals ProposalsJSON and Render return at once.

RosterJSON

RosterJSON lists seated members and open invitations.

ProposalJSON

ProposalJSON returns one proposal with its ballots and current status, or null for an unknown id.

ConstantsJSON

ConstantsJSON returns the fixed policy: durations in seconds, roster bounds.

ProposalsJSON

ProposalsJSON lists up to limit proposals (at most MaxListed) with ids below before, newest first; before = 0 starts from the newest.

proposalJSON

Render

Render shows the roster and the latest proposals. Each proposal's line holds only fields the realm sets (id, status, class, proposer id); every value a proposer wrote follows as its own labelled, escaped item, so none can forge a field.

unix

unix formats a unix-second time (0 = none).

grow

grow makes room for n more bytes. The VM's append reallocates to the exact length, so appending byte by byte past capacity would copy the whole buffer each time; doubling keeps the escapers linear.

qClass

Escaper classes of each ASCII byte, one table lookup per byte: '.' is copied, 'b' gets a backslash, 'u' becomes \\u00XX, 'e' a numeric character reference. Stored text is printable ASCII (0x7f masks the index; no other byte reaches here).

mdClass

Escaper classes of each ASCII byte, one table lookup per byte: '.' is copied, 'b' gets a backslash, 'u' becomes \\u00XX, 'e' a numeric character reference. Stored text is printable ASCII (0x7f masks the index; no other byte reaches here).

hexDigits

Escaper classes of each ASCII byte, one table lookup per byte: '.' is copied, 'b' gets a backslash, 'u' becomes \\u00XX, 'e' a numeric character reference. Stored text is printable ASCII (0x7f masks the index; no other byte reaches here).

q

q appends s as a JSON string; \< > & are escaped so the text stays inert in HTML.

md

md appends s with every character Markdown, HTML or gnoweb could act on made literal.

seat

seedSeated

seedInvited