v0 state

Name

Path

Link

Denom

Denom is the full chain denom, "/" + [Path](#Path) + ":" + [Name](#Name). This is the string a wallet, an explorer or a \`-send\` flag needs; the bank knows nothing about the realm behind it.

ClaimAmount

ClaimEvery

MaxPerAccount

MaxSupply

MaxNote

MaxTips

account

tip

Tip is one entry of the public board written by [Tip](#Tip).

accounts

// address string -> \*account

issued

burned

tips

// most recent last, at most MaxTips

Claim

Claim issues [ClaimAmount](#ClaimAmount) of moultest to the caller and returns it. It never issues to an address the caller names. That is deliberate: a faucet that mints to a third party is a way to spray a denom nobody asked for into strangers' wallets, and their account page then carries it forever.

Burn

Burn destroys \`amount\` of the CALLER's moultest, and only the caller's. The banker this realm holds could remove coins from any address on the chain without asking, so the \`who\` here is read from the call frame and is never a parameter. A clawback is what an issuing realm is always able to write; the choice not to is made here, once, and cannot be revisited without a redeploy. Burning lowers what circulates and does not return any cap headroom: see [MaxPerAccount](#MaxPerAccount).

Tip

Tip forwards the moultest attached to THIS transaction to \`to\`, and writes the note on a public board. The coin arrives in the \`-send\` envelope of the call, credited to this realm's address before a line of this function runs, and leaves through a BankerTypeOriginSend banker, whose whole authority is that envelope: it can spend what this message paid in and not one coin more, not even out of the realm's own balance. So the realm can route a payment it was handed while being structurally unable to touch anything else. A GRC20 has no equivalent. Its tokens cannot ride a message, so the same flow costs an Approve, then a call, then an allowance that outlives both. Anything else in the envelope (the GNOT covering a storage deposit, say) is left alone and stays with the realm.

BalanceOf

BalanceOf returns what the bank holds of moultest for \`who\`. It reads the chain, not this realm: a balance this realm never saw counts the same.

Circulating

Circulating returns how much moultest exists right now, from the bank.

Issued

Issued returns how much this realm has ever issued. It only grows, and it is what [MaxSupply](#MaxSupply) caps.

Burned

Burned returns how much has been destroyed through [Burn](#Burn).

NextClaim

NextClaim returns the block height at which \`who\` may claim again, and whether they have ever claimed at all.

ClaimedBy

ClaimedBy returns the lifetime total issued to \`who\` by this realm, which is what [MaxPerAccount](#MaxPerAccount) caps.

Accounts

Accounts returns how many addresses have ever claimed.

accountOf

caller

Render

Render shows the coin, what is left under each cap, and the tip board. \`?\<address>\` adds that address's balance and claim state.

renderSupply

renderAccount

renderTips

renderUsage