common state

AssertIsNotHandleNativeCoin

AssertIsNotHandleNativeCoin validates that no native coins were sent with the transaction. Use this when a function should only work with GRC20 tokens and not accept native coins.

IsRegistered

IsRegistered checks whether a token key is registered. Parameters: - tokenKey: registry key identifying the GRC20 token to inspect. Returns: - error: nil when tokenKey is valid and registered; non-nil when the key is invalid or unregistered.

MustRegistered

MustRegistered checks whether all provided tokens are registered and panics if any is not registered. Parameters: - tokenKeys: token registry keys to check; an empty list performs no checks. Panics if any of the provided tokens is not registered.

ValidateRegistered

ValidateRegistered checks whether all provided tokens are registered, returning an error instead of panicking when a token is not registered. Parameters: - tokenKeys: token registry keys to check; an empty list is valid. Returns: - error: nil when every token is registered; otherwise the first registration failure.

TotalSupply

TotalSupply returns the total supply of the specified token. Parameters: - tokenKey: registry key identifying the GRC20 token. Returns: - totalSupply: current token supply for tokenKey, in the token's base units; panics if tokenKey is invalid or unregistered.

BalanceOf

BalanceOf returns the token balance for the specified address. Parameters: - tokenKey: registry key identifying the GRC20 token. - addr: address whose token balance is queried. Returns: - balance: token balance held by addr, in the token's base units; panics if tokenKey is invalid or unregistered.

Allowance

Allowance returns the token allowance from owner to spender. Parameters: - tokenKey: registry key identifying the GRC20 token. - owner: address that owns the tokens. - spender: address authorized to spend owner's tokens. Returns: - allowance: amount owner has approved spender to use, in the token's base units; panics if tokenKey is invalid or unregistered.

Transfer

Transfer forwards a token transfer to the implementation bound to the current realm. Parameters: - \_: leading integer discriminator for the realm-crossing ABI; pass 0. - rlm: propagated realm context used to resolve and invoke the registered token implementation. - tokenKey: registry key identifying the GRC20 token to transfer. - to: recipient address. - amount: number of token base units to transfer. Returns: - error: nil when the implementation completes the transfer; otherwise a token validation or transfer-rule error.

TransferFrom

TransferFrom forwards an allowance-backed token transfer to the implementation bound to the current realm. Parameters: - \_: leading integer discriminator for the realm-crossing ABI; pass 0. - rlm: propagated realm context used to resolve and invoke the registered token implementation. - tokenKey: registry key identifying the GRC20 token to transfer. - from: address whose allowance and balance are debited. - to: recipient address. - amount: number of token base units to transfer. Returns: - error: nil when the implementation completes the transfer; otherwise a token validation, allowance, or balance-rule error.

Approve

Approve forwards an allowance update to the implementation bound to the current realm. Parameters: - \_: leading integer discriminator for the realm-crossing ABI; pass 0. - rlm: propagated realm context used to resolve and invoke the registered token implementation. - tokenKey: registry key identifying the GRC20 token. - spender: address authorized to spend the caller's tokens. - amount: number of token base units to authorize. Returns: - error: nil when the implementation records the allowance; otherwise a token validation or approval-rule error.

SafeGRC20Transfer

SafeGRC20Transfer transfers tokens as the current realm and panics if it fails. Parameters: - \_: leading integer discriminator for the realm-crossing ABI; pass 0. - rlm: propagated realm context used to resolve and invoke the registered token implementation. - tokenKey: registry key identifying the GRC20 token to transfer. - to: recipient address. - amount: number of token base units to transfer. Panics if the underlying transfer returns an error.

SafeGRC20TransferFrom

SafeGRC20TransferFrom transfers tokens as the current realm and panics if it fails. Parameters: - \_: leading integer discriminator for the realm-crossing ABI; pass 0. - rlm: propagated realm context used to resolve and invoke the registered token implementation. - tokenKey: registry key identifying the GRC20 token to transfer. - from: address whose allowance and balance are debited. - to: recipient address. - amount: number of token base units to transfer. Panics if the underlying transfer returns an error.

SafeGRC20Approve

SafeGRC20Approve approves tokens as the current realm and panics if it fails. Parameters: - \_: leading integer discriminator for the realm-crossing ABI; pass 0. - rlm: propagated realm context used to resolve and invoke the registered token implementation. - tokenKey: registry key identifying the GRC20 token. - spender: address authorized to spend the caller's tokens. - amount: number of token base units to authorize. Panics if the underlying approval returns an error.

Render

Render delegates web rendering to the active implementation.

currentAddress

domainPath

kvStore

versionManager

implementation

init.19

initializeDomainStore

common keeps no domain state; implementations only resolve tokens.

getImplementation

updateImplementation

ICommon

RegisterInitializer

RegisterInitializer registers the versioned common implementation initializer and activates the implementation returned by it. Parameters: - cur: Current realm context; callers use cross(cur) when crossing into this realm. - initializer: callback invoked with discriminator 0 and the propagated implementation realm, returning the version's ICommon implementation

UpgradeImpl

UpgradeImpl changes the active common implementation package and refreshes the cached implementation. Parameters: - cur: Current realm context; callers use cross(cur) when crossing into this realm. - packagePath: fully qualified package path of the replacement implementation

GetImplementationPackagePath

GetImplementationPackagePath returns the package path of the currently selected common implementation. Returns: - packagePath: fully qualified current implementation package path