package coreutil provides functions to describe interface of the core contract in a compact way.

AddressFromAgentID returns the L1 address of the AgentID, if applicable.

AgentIDFromString parses the human-readable string representation.

ChainIDFromAliasID creates new chain ID from alias address.

ChainIDFromBytes reconstructs a ChainID from its binary representation.

ContractIDFromEventBytes is used by blocklog to filter out specific events per contract For performance reasons it is working directly with the event bytes.

EmptyChainID returns an empty ChainID.

Hn calculates the hname for the given string.

HnameFromAgentID returns the hname of the AgentID, or HnameNil if not applicable.

IsBaseToken return whether a given tokenID represents the base token.

NewAgentID creates an AddressAgentID if the address is not an AliasAddress; otherwise a ContractAgentID with hname = HnameNil.

NewRandomAgentID creates random AgentID.

only for testing.

RandomChainID creates a random chain ID.

RequestsInTransaction parses the transaction and extracts those outputs which are interpreted as a request to a chain.

VMErrorIs returns true if the error includes a VMErrorCode in its chain that matches the given code.

VMErrorMustBe panics unless the error includes a VMErrorCode in its chain that matches the given code.

FuncInit is a name of the init function for any smart contract.

HnameNil is the value used to represent a non-existent Hname.

don't process any request which deadline will expire within 1 minute.

VMCoreErrorContractID defines that all errors with a MaxUint32 contract id will be considered as core errors.

well known hnames.

AddressAgentID is an AgentID backed by a non-alias address.

CallTarget the target representation of the request.

ChainInfo is an API structure containing the main parameters of the chain.

ContractAgentID is an AgentID formed by a ChainID and a contract Hname.

EthereumAddressAgentID is an AgentID formed by an Ethereum address.

IRC27NFTMetadata represents an NFT metadata according to IRC27.

IRC30NativeTokenMetadata represents the Native Token metadata according to IRC30.

Receipt represents a blocklog.RequestReceipt with a resolved error string.

RequestParameters represents parameters of the on-ledger request.

SendMetadata represents content of the data payload of the output.

StateAnchor contains properties of the anchor output/transaction in the current context.

AgentID represents any entity that can hold assets on L2 and/or call contracts.

AgentIDWithL1Address is an AgentID backed by an L1 address (either AddressAgentID or ContractAgentID).

KVDecoder is interface with all kind of utility functions extracting and decoding values from the key/value map.

Privileged is a sub-interface for core contracts.

Request wraps any data which can be potentially be interpreted as a request.

Sandbox is an interface given to the processor to access the VMContext and virtual state, transaction builder and request parameters through it.

SandboxBase is the common interface of Sandbox and SandboxView.

SandboxView is an interface for read only call.

Utils implement various utilities which are faster on host side than on wasm VM Implement deterministic stateless computations.

VMErrorBase is the common interface of UnresolvedVMError and VMError.

VMProcessor is an interface to the VM processor instance.

VMProcessorEntryPoint is an abstract interface by which VM is called by passing the Sandbox interface.

ChainID represents the global identifier of the chain It is wrapped AliasAddress, an address without a private key behind.

ChainID represents the global identifier of the chain It is wrapped AliasAddress, an address without a private key behind.

Hname is calculated as the first 4 bytes of the BLAKE2b hash of a string, interpreted as a little-endian uint32.

RequestLookupDigest is shortened version of the request id.