v0 state

Render

renderIndex

renderOne

entry

entry is one issued token: either a wrapper over a single underlying, or a fusion over several. Exactly one of vault/basket is set.

ids

byName

// symbol -> \*entry

created

// symbols, in creation order, for a stable Render

home

// this realm's address: the escrow account

init.8

Home

NewWrapper

NewWrapper issues a token wrapping \`tokenKey\`, a key in grc20reg, under the given mode, and registers it. It returns the new token's own registry key. \`symbol\` is yours to choose, must be unique in this realm, and follows the GRC20 rules: 1 to 11 characters of \[A-Za-z0-9\_-].

NewFusion

NewFusion issues a meta-token backed by two registered tokens at a fixed proportion: one smallest unit of the meta-token is always worth \`perA\` smallest units of A plus \`perB\` of B. It returns the new token's registry key. The proportion never changes, and the meta-token is minted and burned only against the real thing, so it cannot drift from its backing or be arbitraged. What it can do is make the pair one transferable object.

Deposit

Deposit escrows \`amount\` of the underlying and mints \`symbol\` to the caller. It returns how much was minted, which is not \`amount\` unless the mode is plain. Approve Home() on the underlying first.

Withdraw

Withdraw burns \`amount\` of \`symbol\` and returns the underlying to the caller. It returns how much came back.

Donate

Donate escrows \`amount\` of the underlying for \`symbol\` and mints nothing. Under a pool or sticky mode this is a gift to every current holder at once, and it is irreversible: there is no share to redeem it with. Under any other mode it is a gift to nobody, since the rate ignores the escrow.

Fuse

Fuse escrows every leg of \`symbol\` and mints \`units\` of it to the caller. Approve Home() on BOTH legs first.

Defuse

Defuse burns \`units\` of \`symbol\` and returns every leg to the caller.

Transfer

Transfer moves the caller's own units of \`symbol\`. A soulbound wrapper refuses here, and nowhere else.

Approve

Approve lets \`spender\` draw \`amount\` of \`symbol\` from the caller's balance.

TransferFrom

TransferFrom spends an allowance the caller was granted on \`symbol\`.

Key

Key returns the grc20reg key of the token this realm issued as \`symbol\`.

TotalSupply

TotalSupply returns how much of \`symbol\` is outstanding.

BalanceOf

BalanceOf returns \`owner\`'s balance of \`symbol\`.

Allowance

Allowance returns what \`owner\` let \`spender\` draw of \`symbol\`.

Escrow

Escrow returns the underlying escrowed behind a wrapper.

Legs

Legs returns how many components a fusion has.

Leg

Leg describes the i-th component of a fusion: its symbol, the units escrowed per meta unit, and the units escrowed so far.

Count

Count is how many tokens this realm has issued.

modePolicy

modePolicy maps a mode name to its policy and to the extra decimals the wrapped token needs to represent the same value.

record

requireFree

must

mustVault

mustBasket

caller

checkErr