core state

RelayerRole

RelayerRole mirrors Union deployer's RELAYER role id. Reference: [https://github.com/unionlabs/union/blob/8cff0ff34f6baa4cdb1e4650a08985dd05de0c5a/cosmwasm/deployer/src/main.rs#L65](https://github.com/unionlabs/union/blob/8cff0ff34f6baa4cdb1e4650a08985dd05de0c5a/cosmwasm/deployer/src/main.rs#L65)

SelectorUpdateImpl

SelectorForceUpdateClient

SelectorForceConnectionTry

SelectorForceConnectionAck

SelectorForceConnectionConfirm

SelectorForceChannelTry

SelectorForceChannelAck

SelectorForceChannelConfirm

SelectorChannelCloseInit

SelectorChannelCloseConfirm

SelectorCommitMembershipProof

SelectorCommitNonMembershipProof

SelectorSetEventConfig

SelectorRegisterClient

SelectorCreateClient

SelectorUpdateClient

SelectorMisbehaviour

SelectorConnectionOpenInit

SelectorConnectionOpenTry

SelectorConnectionOpenAck

SelectorConnectionOpenConfirm

SelectorChannelOpenInit

SelectorChannelOpenTry

SelectorChannelOpenAck

SelectorChannelOpenConfirm

SelectorPacketRecv

SelectorIntentPacketRecv

SelectorPacketAck

SelectorPacketTimeout

SelectorBatchSend

SelectorBatchAcks

RegisterApp

RegisterApp registers an IBC application at the caller realm's package path, delegating to the installed mustGetImpl().

HasApp

HasApp reports whether an app is registered at portId.

assertIsRlmCurrent

assertIsProxyRealm

ChannelOpenInit

ChannelOpenTry

ForceChannelOpenTry

ChannelOpenAck

ForceChannelOpenAck

ChannelOpenConfirm

ForceChannelOpenConfirm

ChannelCloseInit

ChannelCloseConfirm

HasClient

HasClient reports whether a light client is registered for a client type.

RegisterClient

RegisterClient stores a factory function for typ in the client registry.

CreateClient

CreateClient assigns a client id, stores the submitted state bytes, then lets the light client verify creation against that freshly stored state. Union references: [https://github.com/unionlabs/union/blob/8cff0ff34f6baa4cdb1e4650a08985dd05de0c5a/cosmwasm/core/src/contract.rs#L867-L903](https://github.com/unionlabs/union/blob/8cff0ff34f6baa4cdb1e4650a08985dd05de0c5a/cosmwasm/core/src/contract.rs#L867-L903) [https://github.com/unionlabs/union/blob/8cff0ff34f6baa4cdb1e4650a08985dd05de0c5a/cosmwasm/core/src/contract.rs#L905-L972](https://github.com/unionlabs/union/blob/8cff0ff34f6baa4cdb1e4650a08985dd05de0c5a/cosmwasm/core/src/contract.rs#L905-L972)

UpdateClient

UpdateClient verifies a client message against the light client object, which updates its own state, and mirrors the resulting state bytes for queries and counterparty proofs. Union reference: [https://github.com/unionlabs/union/blob/8cff0ff34f6baa4cdb1e4650a08985dd05de0c5a/cosmwasm/core/src/contract.rs#L975-L1046](https://github.com/unionlabs/union/blob/8cff0ff34f6baa4cdb1e4650a08985dd05de0c5a/cosmwasm/core/src/contract.rs#L975-L1046)

ForceUpdateClient

ForceUpdateClient re-initializes a client from submitted state bytes, bypassing header proof verification. It is restricted to the admin and recovers expired or otherwise unrecoverable clients. The registered light client type for the existing client is reused. Union references: [https://github.com/unionlabs/union/blob/8cff0ff34f6baa4cdb1e4650a08985dd05de0c5a/cosmwasm/core/src/contract.rs#L146-L166](https://github.com/unionlabs/union/blob/8cff0ff34f6baa4cdb1e4650a08985dd05de0c5a/cosmwasm/core/src/contract.rs#L146-L166) [https://github.com/unionlabs/union/blob/8cff0ff34f6baa4cdb1e4650a08985dd05de0c5a/cosmwasm/core/src/contract.rs#L905-L972](https://github.com/unionlabs/union/blob/8cff0ff34f6baa4cdb1e4650a08985dd05de0c5a/cosmwasm/core/src/contract.rs#L905-L972)

Misbehaviour

Misbehaviour freezes a client after a valid misbehaviour proof, delegating to the installed impl. Union reference: [https://github.com/unionlabs/union/blob/8cff0ff34f6baa4cdb1e4650a08985dd05de0c5a/cosmwasm/core/src/contract.rs#L1048-L1093](https://github.com/unionlabs/union/blob/8cff0ff34f6baa4cdb1e4650a08985dd05de0c5a/cosmwasm/core/src/contract.rs#L1048-L1093)

ConnectionOpenInit

ConnectionOpenTry

ForceConnectionOpenTry

ConnectionOpenAck

ForceConnectionOpenAck

ConnectionOpenConfirm

ForceConnectionOpenConfirm

SendPacket

SendPacket commits a packet for the caller's port.

PacketRecv

PacketRecv proves and dispatches a batch of received packets.

IntentPacketRecv

IntentPacketRecv settles packets on the proofless market-maker fast path.

PacketAcknowledgement

PacketAcknowledgement proves the counterparty acks and notifies the app.

PacketTimeout

PacketTimeout proves a packet was never received and notifies the app.

CommitMembershipProof

CommitMembershipProof verifies and records a membership proof.

CommitNonMembershipProof

CommitNonMembershipProof verifies and records a non-membership proof.

BatchSend

BatchSend aggregates already-committed packets into a batch commitment.

BatchAcks

BatchAcks aggregates the acks of received packets into a batch receipt.

WriteAcknowledgement

WriteAcknowledgement commits a deferred acknowledgement for a received packet.

EmitRegisterClient

EmitRegisterClient emits the RegisterClient host event.

EmitCreateClient

EmitCreateClient emits the CreateClient host event.

EmitUpdateClient

EmitUpdateClient emits the UpdateClient host event.

EmitForceUpdateClient

EmitForceUpdateClient emits the ForceUpdateClient host event.

EmitMisbehaviour

EmitMisbehaviour emits the Misbehaviour host event.

EmitConnectionOpenInit

EmitConnectionOpenInit emits the ConnectionOpenInit host event.

EmitConnectionOpenTry

EmitConnectionOpenTry emits the ConnectionOpenTry host event.

EmitConnectionOpenAck

EmitConnectionOpenAck emits the ConnectionOpenAck host event.

EmitConnectionOpenConfirm

EmitConnectionOpenConfirm emits the ConnectionOpenConfirm host event.

ConnectionValue

ConnectionValue returns the H256 commitment value of a connection, exposed so the impl can build the expected counterparty value for membership proofs.

ChannelValue

ChannelValue returns the H256 commitment value of a channel, exposed so the impl can build the expected counterparty value for membership proofs.

EmitChannelOpenInit

EmitChannelOpenInit emits the ChannelOpenInit host event.

EmitChannelOpenTry

EmitChannelOpenTry emits the ChannelOpenTry host event.

EmitChannelOpenAck

EmitChannelOpenAck emits the ChannelOpenAck host event.

EmitChannelOpenConfirm

EmitChannelOpenConfirm emits the ChannelOpenConfirm host event.

EmitChannelCloseInit

EmitChannelCloseInit emits the ChannelCloseInit host event.

EmitChannelCloseConfirm

EmitChannelCloseConfirm emits the ChannelCloseConfirm host event.

EmitAppRegistered

EmitAppRegistered emits the AppRegistered host event.

CommitPacketHash

CommitPacketHash returns the union commitment hash of a single packet.

CommitPacketsHash

CommitPacketsHash returns the union commitment hash of a packet batch.

EmitPacketSend

EmitPacketSend emits the PacketSend host event.

EmitPacketRecv

EmitPacketRecv emits the PacketRecv host event.

EmitIntentPacketRecv

EmitIntentPacketRecv emits the IntentPacketRecv host event.

EmitPacketAck

EmitPacketAck emits the PacketAck host event.

EmitPacketTimeout

EmitPacketTimeout emits the PacketTimeout host event.

EmitWriteAck

EmitWriteAck emits the WriteAck host event.

EmitBatchSend

EmitBatchSend emits the BatchSend host event.

EmitBatchAcks

EmitBatchAcks emits the BatchAcks host event.

EmitCommitMembershipProof

EmitCommitMembershipProof emits the CommitMembershipProof host event.

EmitCommitNonMembershipProof

EmitCommitNonMembershipProof emits the CommitNonMembershipProof host event.

keccak

commitPacketHash

commitPacketsHash

packetCommitmentPath

packetAcknowledgementPath

channelValue

connectionValue

h256Bytes

h256Bytes returns a fresh byte slice containing h. Use it when passing package-level types.H256 values such as types.COMMITMENT\_MAGIC to foreign-realm light clients. ics23 may copy and append against the input, so callers should pass a freshly allocated slice.

cloneChannel

cloneChannel returns a core-realm-owned copy of c with its byte field laundered, so persisting the copy does not taint the caller's channel (and vice versa). Without this, storing the channel makes its shared CounterpartyPortId slice externally stored, and the caller's later use (e.g. event emission) panics with "illegal conversion of readonly or externally stored value". Bytes.Clone copies the bytes element-wise (the only laundering gno's borrow rules permit on a foreign slice).

hexString

hexAttr

hexAttr encodes b as a lowercase 0x-prefixed hexadecimal string for use in chain.Emit attributes. Use hexAttr for binary attribute values. Converting arbitrary \[]byte values directly to string is lossy for non-UTF-8 input.

hexAttrLen

hexAttrLen returns the length of b after hexAttr encoding. It avoids building the encoded string on validation paths that only need to compare against an event attribute size budget.

h256String

ErrClientNotActive

Error messages are defined as constants rather than package-level error values; build them with makeError at the call site (see above).

ErrInvalidConnectionState

Error messages are defined as constants rather than package-level error values; build them with makeError at the call site (see above).

ErrInvalidCounterpartyConnection

Error messages are defined as constants rather than package-level error values; build them with makeError at the call site (see above).

ErrInvalidChannelState

Error messages are defined as constants rather than package-level error values; build them with makeError at the call site (see above).

ErrInvalidCounterpartyChannelId

Error messages are defined as constants rather than package-level error values; build them with makeError at the call site (see above).

ErrSyncAckEmpty

Error messages are defined as constants rather than package-level error values; build them with makeError at the call site (see above).

ErrUnknownPacketStatus

Error messages are defined as constants rather than package-level error values; build them with makeError at the call site (see above).

ErrUnauthorizedAckWriter

Error messages are defined as constants rather than package-level error values; build them with makeError at the call site (see above).

ErrAcknowledgementAlreadyWritten

Error messages are defined as constants rather than package-level error values; build them with makeError at the call site (see above).

ErrAcknowledgementEmpty

Error messages are defined as constants rather than package-level error values; build them with makeError at the call site (see above).

ErrAcknowledgementMismatch

Error messages are defined as constants rather than package-level error values; build them with makeError at the call site (see above).

ErrUnauthorizedPacketSender

Error messages are defined as constants rather than package-level error values; build them with makeError at the call site (see above).

ErrTimeoutMustBeSet

Error messages are defined as constants rather than package-level error values; build them with makeError at the call site (see above).

ErrPacketCommitmentAlreadyExists

Error messages are defined as constants rather than package-level error values; build them with makeError at the call site (see above).

ErrPacketCommitmentNotFound

Error messages are defined as constants rather than package-level error values; build them with makeError at the call site (see above).

ErrPacketCombinedDataTooLarge

Error messages are defined as constants rather than package-level error values; build them with makeError at the call site (see above).

ErrPacketAlreadyAcknowledged

Error messages are defined as constants rather than package-level error values; build them with makeError at the call site (see above).

ErrPacketReceiptNotFound

Error messages are defined as constants rather than package-level error values; build them with makeError at the call site (see above).

ErrNotEnoughPackets

Error messages are defined as constants rather than package-level error values; build them with makeError at the call site (see above).

ErrBatchSameChannelOnly

Error messages are defined as constants rather than package-level error values; build them with makeError at the call site (see above).

ErrAcknowledgementCountMismatch

Error messages are defined as constants rather than package-level error values; build them with makeError at the call site (see above).

ErrTimeoutProofTimestampNotFound

Error messages are defined as constants rather than package-level error values; build them with makeError at the call site (see above).

ErrPortAlreadyRegistered

Error messages are defined as constants rather than package-level error values; build them with makeError at the call site (see above).

ErrBatchPacketsNotFound

Error messages are defined as constants rather than package-level error values; build them with makeError at the call site (see above).

ErrBatchReceiptsNotFound

Error messages are defined as constants rather than package-level error values; build them with makeError at the call site (see above).

ErrPacketAlreadyReceived

Error messages are defined as constants rather than package-level error values; build them with makeError at the call site (see above).

ErrPacketTimeoutExpired

Error messages are defined as constants rather than package-level error values; build them with makeError at the call site (see above).

ErrPacketTimeoutNotReached

Error messages are defined as constants rather than package-level error values; build them with makeError at the call site (see above).

ErrIntentNotSupported

Error messages are defined as constants rather than package-level error values; build them with makeError at the call site (see above).

ErrPortNotFound

Error messages are defined as constants rather than package-level error values; build them with makeError at the call site (see above).

ErrClientNotFound

Error messages are defined as constants rather than package-level error values; build them with makeError at the call site (see above).

ErrClientStateNotFound

Error messages are defined as constants rather than package-level error values; build them with makeError at the call site (see above).

ErrConsensusStateNotFound

Error messages are defined as constants rather than package-level error values; build them with makeError at the call site (see above).

ErrConnectionNotFound

Error messages are defined as constants rather than package-level error values; build them with makeError at the call site (see above).

ErrChannelNotFound

Error messages are defined as constants rather than package-level error values; build them with makeError at the call site (see above).

ErrMembershipProofNotFound

Error messages are defined as constants rather than package-level error values; build them with makeError at the call site (see above).

ErrSpoofedRealm

Error messages are defined as constants rather than package-level error values; build them with makeError at the call site (see above).

ErrNotProxyRealm

Error messages are defined as constants rather than package-level error values; build them with makeError at the call site (see above).

makeError

AppRegisteredEvent

RegisterClientEvent

CreateClientEvent

UpdateClientEvent

ForceUpdateClientEvent

MisbehaviourEvent

ConnectionOpenInitEvent

ConnectionOpenTryEvent

ConnectionOpenAckEvent

ConnectionOpenConfirmEvent

ChannelOpenInitEvent

ChannelOpenTryEvent

ChannelOpenAckEvent

ChannelOpenConfirmEvent

ChannelCloseInitEvent

ChannelCloseConfirmEvent

PacketSendEvent

BatchSendEvent

BatchAcksEvent

PacketRecvEvent

IntentPacketRecvEvent

WriteAckEvent

PacketAckEvent

PacketTimeoutEvent

CommitMembershipProofEvent

CommitNonMembershipEvent

channelOpenInitEventAttrs

channelOpenTryEventAttrs

channelOpenAckConfirmEventAttrs

channelCloseEventAttrs

emitChannelOpenInitEvent

emitChannelOpenTryEvent

emitChannelOpenAckEvent

emitChannelOpenConfirmEvent

emitChannelCloseInitEvent

emitChannelCloseConfirmEvent

emitConnectionOpenInitEvent

emitConnectionOpenTryEvent

emitConnectionOpenAckEvent

emitConnectionOpenConfirmEvent

connectionOpenEventAttrs

emitRegisterClientEvent

emitCreateClientEvent

emitUpdateClientEvent

emitForceUpdateClientEvent

emitMisbehaviourEvent

emitAppRegisteredEvent

emitBatchSendEvent

emitBatchAcksEvent

encodedEventAttrs

encodedEventAttrs returns the event attrs for an already-encoded value, splitting it into indexed columns when SplitEventAttrs is enabled.

eventAttrColumns

eventAttrColumns splits one encoded event attribute value into indexed columns. Callers decide whether splitting is enabled before calling this helper.

packetSendEventAttrs

emitPacketSendEvent

packetRecvEventAttrs

emitPacketRecvEvent

writeAckEventAttrs

emitWriteAckEvent

packetAckEventAttrs

emitPacketAckEvent

packetTimeoutEventAttrs

emitPacketTimeoutEvent

emitCommitMembershipProofEvent

emitCommitNonMembershipProofEvent

defaultMaxEventAttrValueLen

defaultMaxEventAttrPairs

eventConfig

EventConfig

EventConfig controls host event attribute splitting and sizing.

NewEventConfig

NewEventConfig constructs an EventConfig value. SetEventConfig validates the value before storing it.

DefaultEventConfig

DefaultEventConfig returns the default host event attribute policy.

GetEventConfig

GetEventConfig returns the current host event attribute policy.

SetEventConfig

SetEventConfig updates the host event attribute policy. The caller must be authorized for SelectorSetEventConfig.

SetSplitEventAttrs

SetSplitEventAttrs updates whether large event attributes are split. The caller must be authorized for SelectorSetEventConfig.

SetMaxEventAttrValueLen

SetMaxEventAttrValueLen updates the maximum value length for each split event attribute column. The caller must be authorized for SelectorSetEventConfig.

SetMaxEventAttrPairs

SetMaxEventAttrPairs updates the shared event attr-pair budget. The caller must be authorized for SelectorSetEventConfig.

setEventConfig

assertValidEventConfig

GetStatus

GetStatus returns the client's status, or an error when the client is missing.

GetLightClient

GetLightClient returns the stored light client object for clientId.

GetClientType

GetClientType returns the registered client type for a client, or an error when the client is missing.

GetClientImpl

GetClientImpl returns the factory stored for clientId.

GetRegisteredClientType

GetRegisteredClientType reports whether a client type is registered (best-effort).

GetClientState

GetClientState returns the mirrored client state bytes, or an error when the client state is missing.

GetConsensusState