v1 state

maxMembers

Limits keep every page and every write small.

maxEntries

// per group

maxName

// a member's name, in bytes

maxGroup

// a group's name

maxTitle

// an entry's title

maxCurrency

Limits keep every page and every write small.

remindEvery

// seconds between two reminders to one member

Kind

Kind is what an entry records.

KindExpense

// Payer paid Total for Who

KindIncome

// Payer received Total that belongs to Who

KindTransfer

// Payer paid Total to Who\[0]

Member

Member is one person in a group. Bal is what they paid minus what they owe, in cents: > 0 the group owes them, \< 0 they owe the group.

Entry

Entry is one expense, income or transfer. Owe\[i] is the part of Who\[i]; the parts sum to Total. An income stores Total and Owe as negative amounts, so one rule applies every kind: Payer gains Total, each of Who loses its part.

Group

Group is one shared account.

groups

// key(ID) → \*Group

byAddr

// addr + "/" + key(ID) → true, the groups a wallet belongs to

nextID

self

self is this realm's pkgpath and hub its gnoweb path, read at init while this realm is current: every link follows from them.

hub

self is this realm's pkgpath and hub its gnoweb path, read at init while this realm is current: every link follows from them.

init.19

CreateGroup

CreateGroup opens a group named name, counting in currency, with the caller as member you (wallet linked) and others, comma-separated names, without wallets. It returns the group's ID.

AddMember

AddMember adds name to the group, with a wallet if addr is set: that member becomes an editor and is told by gnotif.

LinkMember

LinkMember links a wallet to a member who has none yet, making them an editor. A linked wallet is never replaced, so no editor can take over another's place.

AddExpense

AddExpense records that paidBy paid amount for forWhom (comma-separated names, "" for everyone), split equally. amount is "42.50", or a foreign amount with its rate, "50 USD x0.92". It returns the entry's ID.

AddByShares

AddByShares records an expense split by shares: shares is "Alice:2, Bob:1", so Alice owes two thirds.

AddByAmounts

AddByAmounts records an expense split by exact amounts: amounts is "Alice:12.50, Bob:7.50", and the expense is their sum.

AddIncome

AddIncome records money receivedBy got on behalf of forWhom (a refund, a deposit returned), split equally: it lowers what each of them paid.

AddTransfer

AddTransfer records that from paid amount to to, outside the chain.

Delete

Delete removes an entry and undoes its effect on every balance.

Remind

Remind sends member, who owes the group, a gnotif reminder: at most one every 12 hours, and only to a member with a wallet.

editable

editable is the one write check: the group exists, is still kept here, and the immediate caller is one of its members with a wallet.

getGroup

mustGroup

mustAmount

parseAddr

splitList

splitList cuts a comma-separated list, dropping blanks.

validText

validText is 1 to max bytes with no control character.

validName

validName also refuses the separators the forms use.

key

key pads an ID so the trees keep numeric order.

itoa

EventGroupCreated

Events. The first ones say what changed, for indexers and apps. The notify ones each carry "to", a wallet: gnotif turns them into a browser notification for whoever opted in with that address. A notify event goes only to members with a wallet, never to the member who acted.

EventMemberAdded

Events. The first ones say what changed, for indexers and apps. The notify ones each carry "to", a wallet: gnotif turns them into a browser notification for whoever opted in with that address. A notify event goes only to members with a wallet, never to the member who acted.

EventMemberLinked

Events. The first ones say what changed, for indexers and apps. The notify ones each carry "to", a wallet: gnotif turns them into a browser notification for whoever opted in with that address. A notify event goes only to members with a wallet, never to the member who acted.

EventEntryAdded

Events. The first ones say what changed, for indexers and apps. The notify ones each carry "to", a wallet: gnotif turns them into a browser notification for whoever opted in with that address. A notify event goes only to members with a wallet, never to the member who acted.

EventEntryDeleted

Events. The first ones say what changed, for indexers and apps. The notify ones each carry "to", a wallet: gnotif turns them into a browser notification for whoever opted in with that address. A notify event goes only to members with a wallet, never to the member who acted.

EventGroupMoved

Events. The first ones say what changed, for indexers and apps. The notify ones each carry "to", a wallet: gnotif turns them into a browser notification for whoever opted in with that address. A notify event goes only to members with a wallet, never to the member who acted.

EventOwnerOffered

Events. The first ones say what changed, for indexers and apps. The notify ones each carry "to", a wallet: gnotif turns them into a browser notification for whoever opted in with that address. A notify event goes only to members with a wallet, never to the member who acted.

EventOwnerChanged

Events. The first ones say what changed, for indexers and apps. The notify ones each carry "to", a wallet: gnotif turns them into a browser notification for whoever opted in with that address. A notify event goes only to members with a wallet, never to the member who acted.

EventSuccessorSet

Events. The first ones say what changed, for indexers and apps. The notify ones each carry "to", a wallet: gnotif turns them into a browser notification for whoever opted in with that address. A notify event goes only to members with a wallet, never to the member who acted.

NotifyExpense

// to, group, gname, by, title, share

NotifyIncome

// to, group, gname, by, title, share

NotifyTransfer

// to, group, gname, from, peer, amount

NotifyReminder

// to, group, gname, by, amount

NotifyJoined

// to, group, gname, by

declareTriggers

declareTriggers registers the notify events with gnotif at deploy. The registry marks them verified, since this realm declares its own. ponytail: gnotif is a v0 on onyx; a new registry version means a new release of this realm, which is why every gnotif call lives in this file.

notifyEntry

notifyReminder

notifyJoined

owner

// "" once renounced

pending

// the address a Transfer offered the role to

successor

// the pkgpath of the next release, "" until named

setUp

setUp is init's owner half. Only \`gno test\` (chain "dev") runs with no signer, and an owner "" holds no power.

Owner

Successor

Successor is the pkgpath of the release that takes groups over, "" if none.

isOwner

Transfer

Transfer offers the role to another address, which takes it with Accept.

Accept

Accept takes the role a Transfer offered the caller.

Renounce

Renounce gives the role up for good.

SetSuccessor

SetSuccessor names the release that takes groups over, once: a realm under this one's namespace, like gno.land/r/\<ns>/gnosplit/v2. From then on that realm can move a group with MoveOut; nothing moves by itself.

MoveOut

MoveOut marks a group as taken over and returns it, as Export writes it. Only the successor realm can call it, which decides when a group moves (when one of its editors asks). The group stays readable here, frozen.

categories

categories are an expense's kinds, in the order ByCat counts them. The last one is the default. A form sends the name.

categoryOf

pageSize

// entries per history page

latest

// entries on a group's page

Render

Render serves "" (home), "u/\<address>" (a wallet's groups) and a group's pages: "\<id>", then "/add", "/settle", "/settle/\<from>/\<to>/\<cents>", "/members", "/stats", "/history\[/\<page>]", "/e/\<entry>" and "/csv".

renderHome

renderWallet

renderGroup

transfers

transfers lists the payments that settle the group, each with a link that fills in the form to record it.

renderAdd

renderSettle

renderMembers

renderStats

renderHistory

renderEntry

entryTable

entryTable writes count entries, newest first, from offset.

header

Export

Export writes a group as CSV: its members, then every entry, oldest first. MoveOut hands it to the successor, and the /csv page shows it.

input

readonly

groupField

selectOpt

selectOpt is one option of a select; gnoweb reads the description off the first one, so only that one carries it.

memberSelect

first

first is s for the first item of a list, "" after.

memberChecks

categorySelect

balanceBar

balanceBar draws a balance against the largest one: right and teal when the group owes the member, left and orange when they owe.

categoryBar

categoryBar is one bar split by category, in the table's order.

swatch

svg

link

entryIcon

verb

forWhom

date

short

percent

plural

cents

cents writes an amount for CSV: "42.50", no thousands separator.

csv

attr

cellText

cellText is link text inside a table cell: InlineText leaves "|" alone, and a bare one would end the cell.

abs

atoi

atoi is a non-negative number, -1 for anything else.