Internal representation

For convenience, each entity (namespace, primid, ahid, currency or account) is identified internally by a unique number (its FPH) serving as the primary key in an SQLite table. (NB, these numbers have now been made fully compatible with the FPH (Full Path Hash) used in NESTS.

These global mappings are:

• namespace: namespace_hrns ↔ namespace_fph
• currency: currency_hrns ↔ currency_fph
• primid: primid_hrns ↔ primid_fph
• ahid: ahid_hrns ↔ ahid_fph
• account: account_hrns ↔ account_fph

Furthermore, the unique currency|ahid pairings each map to one account, the name of which is usually hidden.

• currency_hrns|ahid_hrns → account_hrns

As in NESTS, each entity (namespace, currency, agent or account) is identified by a human-readable name string (HRNS) placing it within a namespace.

Each namespace contains the names of namespaces, currencies and primary identities (a.k.a. primids or login identities) and account-holder identities (ahids).

Upon registration, an initial account is created in the currency specified in the registration form. The name of this account is contained in the private namespaces of this new agent.

Ledger files

Currency journal

Each currency has an associated journal in which all payments are recorded, listing)

• a unique payment number
• the date and time of the payment
• the payer account
• the payee account
• the amountem>
• an (optional) annotation (if provided by the payer

The currency's journal can be exported at any time (either as a CSV file or as a pretty-printed table) by one of its stewards or by a global system administrator.

Agents' ledgers

Each account has an associated journal in which all payments and receipts are recorded.

Each ahid (and, by extension, the primid that owns it) has access to at least one account (generally more), and a separate ledger for each of these. The accounts' ledgers list all transaction (payments and receipts). These ledgers each comprise fields listing

• a unique payment number
• the date and time of the payment
• the name of the other account (whether a payer or a payee)
• the amount paid or received (+ or -)
• the balance following this payment
• an annotation (if specified by the payer)

For each payment made

• the payer's balance in this currency is reduced by amount
• the payee's balance in this currency is increased by amount
• the payment is recorded in the this currency's journal

Each primary identity (primid) can export the account ledger/journal, of any account belonging to one of its ahids.