transfer state

App

PortID

V1

EncodingProtobuf

denomPrefix

escrowAddressVersion

init.6

consumePendingVoucherSend

consumePendingGRC20Send

validatePendingSend

validateBaseDenomNoSlash

validateBaseDenomNoSlash rejects base denominations containing a slash. IBC v2 packets do not carry channel identifiers, so denomination traces cannot be unambiguously separated from a slashed base denomination.

unmarshalPayload

Denom

Denom holds the base denom of a Token and a trace of the chains it was sent through.

NewDenom

NewDenom creates a new Denom instance given the base denomination and a variable number of hops.

ExtractDenomFromPath

ExtractDenomFromPath returns the denom from the full path.

Hop

Hop defines a port ID, client ID pair specifying a unique "hop" in a trace

NewHop

NewHop creates a Hop with the given port ID and client ID.

EventTypeTimeout

IBC transfer events

EventTypePacket

IBC transfer events

EventTypeTransfer

IBC transfer events

EventTypeDenom

IBC transfer events

AttributeKeySender

IBC transfer events

AttributeKeyReceiver

IBC transfer events

AttributeKeyDenom

IBC transfer events

AttributeKeyDenomHash

IBC transfer events

AttributeKeyAmount

IBC transfer events

AttributeKeyRefundReceiver

IBC transfer events

AttributeKeyRefundTokens

IBC transfer events

AttributeKeyAckSuccess

IBC transfer events

AttributeKeyAck

IBC transfer events

AttributeKeyAckError

IBC transfer events

AttributeKeyMemo

IBC transfer events

FungibleTokenPacketData

FungibleTokenPacketData defines a struct for the packet payload See FungibleTokenPacketData spec: [https://github.com/cosmos/ibc/tree/master/spec/app/ics-020-fungible-token-transfer#data-structures](https://github.com/cosmos/ibc/tree/master/spec/app/ics-020-fungible-token-transfer#data-structures)

NewFungibleTokenPacketData

NewFungibleTokenPacketData constructs a new FungibleTokenPacketData instance

transferRealmPath

transferRealmPath is the package path of this realm; used to compute per-voucher GRC20 registry keys. Hardcoded because we cannot read it from runtime.CurrentRealm() in v2 without the unsafe package, and Render needs it from a non-crossing render handler.

Render

renderHome

renderDenoms

renderDenom

renderTotalEscrowForDenom

renderVouchers

renderVoucher

renderVoucherBalance

denomsByClientOrder

denomsByClientOrder returns the stored voucher denoms ordered to match the "Pick the client" listing (core.ClientIDs() order): each voucher is grouped under its source client (Trace\[0].ClientId), following the same client order as the client list, so the vouchers table lines up with it. Within a client, the underlying b+tree order is preserved. Denoms whose source client is not (or no longer) registered are appended last, in b+tree order, so nothing is dropped. Every stored denom is a minted voucher with a non-empty trace, so Trace\[0] is always safe to read.

renderTransferLinks

renderTransferLinks returns the "## Transfer" section: a set of txlinks that wallets can turn into MsgCalls to Transfer. Each link leaves at least one argument empty so the user fills it in their wallet.

newVoucherSendLink

newVoucherSendLink builds a txlink to VoucherSend with the ibc denom pre-filled. The user fills \`to\` and \`amount\` in their wallet.

newVoucherApproveLink

newVoucherApproveLink builds a txlink to VoucherApprove with the ibc denom pre-filled. The user fills \`spender\` and \`amount\` in their wallet.

newTransferLink

newTransferLink builds a txlink to the Transfer function with the given pre-filled arguments. Empty values are left wallet-settable. timeoutTimestamp defaults to one hour from now (in unix seconds), matching what the e2e tests use; the user can still override it in their wallet.

stripDomain

stripDomain removes the domain from a gno pkg path for use in URLs. "gno.land/r/demo/foo" → "/r/demo/foo"

shortDenom

shortDenom shortens an IBC denom hash for display. "ibc/CAEF9CABC…9D0F" (ibc/ + first 4 + … + last 4)

renderNode

grc20regKey

grc20regKey returns the grc20reg key for a voucher ibc denom. e.g. "ibc/CAEF9C..." → "gno.land/r/aib/ibc/apps/transfer.CAEF9C..."

nodeError

denoms

// ibcDenom:Denom

totalEscrow

// denom:chain.Coin

voucherTokens

// ibcDenom:\*voucher

nextVoucherID

voucher

voucher holds a voucher token and its private ledger for mint/burn.

init.58

hasDenom

setDenom

getDenom

addEscrowForDenom

subEscrowForDenom

VoucherSymbol

VoucherSymbol returns the grc20 token symbol for an IBC voucher denom: the IBC hash truncated to grc20's MaxSymbolLen. The full voucherDenom ("ibc/\<64-hex- hash>") can't be a symbol because v2 grc20 enforces MaxSymbolLen and \[A-Za-z0-9\_-] only. Since grc20reg keys tokens by rlmpath.symbol, this is also the symbol component of a voucher's registry key, so callers locate a voucher via grc20reg.Get(\<this realm's pkgpath> + "." + VoucherSymbol(ibcDenom)).

getOrCreateVoucher

getOrCreateVoucher returns the existing voucher instance for the given IBC denom, or creates a new one and registers it in grc20reg for DeFi discoverability. Non-crossing helper; rlm is needed to issue the cross call into grc20reg.Register from this realm's frame. The token symbol is a truncated IBC hash (see VoucherSymbol); its name is the base denom, and nextVoucherID keeps each token's grc20 id distinct. grc20reg keys the token by rlmpath.symbol (not the slug), so the full-hash slug is retained only as event metadata. Because the key is the truncated symbol, two vouchers whose hashes share an 11-char prefix would collide on the registry key (astronomically unlikely, but no longer guarded by the slug).

getVoucher

getVoucher returns the voucher instance for the given IBC denom, or nil if not found.

VoucherBalanceOf

VoucherBalanceOf returns the balance of a voucher token for a given address. Returns 0 if the token does not exist.

GRC20Alias

GRC20Alias returns a slash-free alias for a GRC20 denom (grc20reg key) by replacing "/" with ":". This is safe because grc20reg slugs are alphanumeric (enforced by grc20reg.Register), so colons never appear in grc20reg keys, making the replacement reversible. Examples: "gno.land/r/demo/foo" → "gno.land:r:demo:foo" "gno.land/r/demo/foo.FOO" → "gno.land:r:demo:foo.FOO"

resolveGRC20Alias

resolveGRC20Alias converts a GRC20 alias back to the grc20reg key by replacing ":" with "/".

isGRC20Alias

isGRC20Alias returns true if the denom is a GRC20 alias. GRC20 aliases always start with "gno.land:" (the colon form of "gno.land/").

Token

Token defines a struct which represents a token to be transferred.

NewToken

NewToken constructs a Token with the given native base denom and amount (no trace, no prefix hops). Provided so external callers — which cannot construct foreign-stamped composite literals under v2 borrow rule #1 — can still build Token values for tests and packet assembly.

Transfer

Transfer is the entry point for sending tokens to another chain using the IBC protocol. It supports three token types, detected automatically from the denom argument: - IBC voucher (denom starts with "ibc/"): burns the voucher GRC20 token. - Non-IBC GRC20 token (registered in grc20reg): escrows via TransferFrom. - Native coin (everything else): the coin must be sent with the transaction via the send field, and must match denom and amount. memo is included in the IBC packet payload.

VoucherSend

VoucherSend is a convenience helper to send an IBC voucher token from the caller to the provided recipient.

VoucherApprove

VoucherApprove is a convenience helper to set a spender allowance for an IBC voucher token on behalf of the caller.

transfer

refundPacketToken

refundPacketToken is a non-crossing helper; rlm is the caller's live cur, needed only by unescrowNative which constructs a Banker.

unescrowGRC20

unescrowGRC20 resolves the GRC20 alias and transfers the escrowed tokens back to the receiver via the token's RealmTeller. Non-crossing helper; rlm is needed by the grc20 teller API.

unescrowNative

unescrowNative sends the escrowed native coins back to the receiver via the banker. Non-crossing helper; rlm is the caller's live cur (transfer realm's own frame), needed to construct a Banker.

pendingSend

pendingSend records the token send that Transfer authorized for OnSendPacket.

pendingNativeEscrow

Gno persists package-level vars to the realm store at end of tx. These pending values must be cleared before Transfer returns to avoid leaking state into the next tx. Transfer uses defers to guarantee the reset on every exit path.

pendingVoucherSend

Gno persists package-level vars to the realm store at end of tx. These pending values must be cleared before Transfer returns to avoid leaking state into the next tx. Transfer uses defers to guarantee the reset on every exit path.

pendingGRC20Send

Gno persists package-level vars to the realm store at end of tx. These pending values must be cleared before Transfer returns to avoid leaking state into the next tx. Transfer uses defers to guarantee the reset on every exit path.