v0 state

realmPath

realmPath is this realm's own path, the one its gnomod.toml module line declares. It is written out rather than read from the runtime, because every plain read this realm exports reports its CALLER and would build every link against the wrong realm.

denom

denom is the only coin a crew holds. ugnot and nothing else: a treasury that can hold several denominations needs a per-denomination share price, which is a different product.

IndexCrews

IndexCrews is how many crews the index page lists.

crews

crews holds every crew, every proposal and the credit ledger. A redeploy wipes it, which is the trade gnomod.toml's private = true makes: see the comment there.

Create

Create opens a crew and makes the caller its first member. Send ugnot with the call: the founder's shares are bought out of it at crew.InitialPricePerShare, and the whole amount, remainder included, becomes the treasury. Returns the new crew's id.

Join

Join mints the caller shares at what a share is worth right now and adds what they sent to the treasury. Returns the shares minted. The price is amount \* totalShares / treasury, rounded down, so somebody joining a crew that has tripled its money pays three times what the founders did. Send at least ValuePerShare ugnot, or there is no whole share to mint.

Fund

Fund adds what the caller sent to a crew's treasury and mints nothing, so every existing share is worth more afterwards. It is how revenue, a grant or a member topping the pot up arrives. Anyone may fund any crew, member or not: there is no way to refuse a transfer on this chain anyway, and pretending otherwise would only move the donation to a bank send the realm cannot account for.

Propose

Propose opens an advisory question on a crew. Any member may propose, and it stays open for crew.VoteBlocks blocks. Returns the proposal's id. A proposal EXECUTES NOTHING. Passing one records that the crew agreed by share weight, and moves no coins, changes no membership and binds no code. Executing a payout is the next step and it is not in v0.

Vote

Vote records the caller's ballot, weighted by the shares they hold at this moment. One ballot per member, changeable while the proposal is open.

Close

Close records a proposal as passed or failed once its deadline has gone by, and returns which. Anyone may call it: closing is bookkeeping, not authority.

Ragequit

Ragequit burns every share the caller holds, credits them their pro-rata slice of the treasury and removes them from the crew. Returns the amount credited, which [Withdraw](#Withdraw) collects. Nobody has to agree. That is what makes a share mean something: the exit is priced by the same number that votes, and a member outvoted on everything can still leave with what they put in plus their part of what the crew built.

Withdraw

Withdraw sends the caller everything they have been credited, and returns it. The credit is zeroed before the coins move, so a reentrant call finds nothing left to take. Nothing in this realm ever pushes value: one address that cannot be paid must not be able to wedge everybody else.

Get

Get returns a crew's name, the height it was created at, how many members it has, its total shares and its treasury in ugnot. Flat values rather than the crew itself: handing out a pointer to live state is a mutation handle nothing checks, and a struct is not something a wallet can decode anyway.

Count

Count is how many crews exist.

SharesOf

SharesOf is how many shares who holds in a crew.

MemberCount

MemberCount is how many people are in a crew.

Treasury

Treasury is what a crew holds, in ugnot. The coins themselves sit at this realm's single address: see the package doc on custody.

ValuePerShare

ValuePerShare is what one of a crew's shares is worth in ugnot, rounded down.

ProposalOf

Tally

Tally is a proposal's share-weighted yes and no.

CreditOf

CreditOf is what an address can withdraw right now, in ugnot.

TotalOwed

TotalOwed is every outstanding credit, which is the part of this realm's balance that belongs to people who have already left.

caller

Render

Render routes three views: the index, one crew, and one proposal.

renderIndex

renderCrew

renderProposal

crewTable

crewTable lists crews, newest first.

proposalTable

proposalTable lists a crew's proposals, newest first. The link title is the id and not the text, which is the opposite of crewTable and deliberate: a proposal's text is free prose and may contain a pipe, md.Link's escaper leaves pipes alone, and a pipe in a link title inside a table cell opens a column. So the chrome carries the link and the prose goes through ui.Cell, which is the escaper that knows it is in a table.

state

state is the one word a proposal is in at height now.

crewURL

crewURL is the gnoweb path of one crew.

proposalURL

proposalURL is the gnoweb path of one proposal.

realmURL

realmURL is this realm's gnoweb path. 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 the realm has to know.