common state

AssertIsNotHandleNativeCoin

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

errNotRegistered

errNotHandleNativeCoin

newErrorWithDetail

newErrorWithDetail creates an error message with additional context in format "\<original\_error> || \<detail>".

GetToken

GetToken returns a grc20.Token instance for the specified tokenKey, panicking if not registered. Parameters: - tokenKey: GRC20 registry key Returns a pointer to the grc20.Token instance. Panics if the token is not registered in grc20reg.

GetTokenTeller

GetTokenTeller returns a CallerTeller for the specified tokenKey, panicking if not registered. Parameters: - tokenKey: GRC20 registry key Returns a grc20.Teller whose write methods derive the actor from the caller realm. Panics if the token is not registered in grc20reg.

IsRegistered

IsRegistered checks if a token is registered in grc20reg, returning nil if registered or error if not. Parameters: - tokenKey: GRC20 registry key Returns nil if the token is registered, or an error describing the issue.

MustRegistered

MustRegistered checks if all provided tokens are registered, panicking if any is not registered. Parameters: - tokenKeys: variable number of GRC20 registry keys to check Panics if any of the provided tokens is not registered in grc20reg.

TotalSupply

TotalSupply returns the total supply of the specified token. Parameters: - tokenKey: GRC20 registry key Returns the total supply of the token as int64.

BalanceOf

BalanceOf returns the token balance for the specified address. Parameters: - tokenKey: GRC20 registry key - addr: address to query the balance for Returns the token balance as int64.

Allowance

Allowance returns the token allowance from owner to spender. Parameters: - tokenKey: GRC20 registry key - owner: address of the token owner - spender: address of the spender Returns the allowance amount as int64.

Transfer

Transfer crosses into common before forwarding to grc20.Teller.Transfer. CallerTeller uses cur.Previous() as the token actor, so this helper must remain a crossing adapter called with cross(cur). Parameters: - cur: current realm - tokenKey: GRC20 registry key - to: recipient address - amount: amount of tokens to transfer Returns an error if the transfer fails, nil otherwise.

TransferFrom

TransferFrom crosses into common before forwarding to grc20.Teller.TransferFrom. CallerTeller uses cur.Previous() as the spender, so this helper must remain a crossing adapter called with cross(cur). Parameters: - cur: current realm - tokenKey: GRC20 registry key - from: sender address - to: recipient address - amount: amount of tokens to transfer Returns an error if the transfer fails, nil otherwise.

Approve

Approve crosses into common before forwarding to grc20.Teller.Approve. CallerTeller uses cur.Previous() as the approver, so this helper must remain a crossing adapter called with cross(cur). Parameters: - cur: current realm - tokenKey: GRC20 registry key - spender: address allowed to spend the tokens - amount: amount of tokens to approve Returns an error if the approval fails, nil otherwise.

SafeGRC20Transfer

SafeGRC20Transfer crosses into common, transfers tokens, and panics if it fails. CallerTeller uses cur.Previous() as the token actor, so this helper must remain a crossing adapter called with cross(cur). Parameters: - cur: current realm - tokenKey: GRC20 registry key - to: recipient address - amount: amount of tokens to transfer Panics if the transfer fails.

SafeGRC20TransferFrom

SafeGRC20TransferFrom crosses into common, transfers tokens, and panics if it fails. CallerTeller uses cur.Previous() as the spender, so this helper must remain a crossing adapter called with cross(cur). Parameters: - cur: current realm - tokenKey: GRC20 registry key - from: sender address - to: recipient address - amount: amount of tokens to transfer Panics if the transfer fails.

SafeGRC20Approve

SafeGRC20Approve crosses into common, approves tokens, and panics if it fails. CallerTeller uses cur.Previous() as the approver, so this helper must remain a crossing adapter called with cross(cur). Parameters: - cur: current realm - tokenKey: GRC20 registry key - spender: address allowed to spend the tokens - amount: amount of tokens to approve Panics if the approval fails.