host

Documentation

Index

• Constants
• Variables
• func ChannelCapabilityPath(portID, channelID string) string
• func ChannelIdentifierValidator(id string) error
• func ChannelKey(portID, channelID string) []byte
• func ChannelPath(portID, channelID string) string
• func ClientConnectionsKey(clientID string) []byte
• func ClientConnectionsPath(clientID string) string
• func ClientIdentifierValidator(id string) error
• func ClientStateKey() []byte
• func ConnectionIdentifierValidator(id string) error
• func ConnectionKey(connectionID string) []byte
• func ConnectionPath(connectionID string) string
• func ConsensusStateKey(height exported.Height) []byte
• func ConsensusStatePath(height exported.Height) string
• func FullClientKey(clientID string, path []byte) []byte
• func FullClientPath(clientID string, path string) string
• func FullClientStateKey(clientID string) []byte
• func FullClientStatePath(clientID string) string
• func FullConsensusStateKey(clientID string, height exported.Height) []byte
• func FullConsensusStatePath(clientID string, height exported.Height) string
• func NextSequenceAckKey(portID, channelID string) []byte
• func NextSequenceAckPath(portID, channelID string) string
• func NextSequenceRecvKey(portID, channelID string) []byte
• func NextSequenceRecvPath(portID, channelID string) string
• func NextSequenceSendKey(portID, channelID string) []byte
• func NextSequenceSendPath(portID, channelID string) string
• func PacketAcknowledgementKey(portID, channelID string, sequence uint64) []byte
• func PacketAcknowledgementPath(portID, channelID string, sequence uint64) string
• func PacketAcknowledgementPrefixPath(portID, channelID string) string
• func PacketCommitmentKey(portID, channelID string, sequence uint64) []byte
• func PacketCommitmentPath(portID, channelID string, sequence uint64) string
• func PacketCommitmentPrefixPath(portID, channelID string) string
• func PacketReceiptKey(portID, channelID string, sequence uint64) []byte
• func PacketReceiptPath(portID, channelID string, sequence uint64) string
• func ParseChannelPath(path string) (string, string, error)
• func ParseConnectionPath(path string) (string, error)
• func ParseIdentifier(identifier, prefix string) (uint64, error)
• func PortIdentifierValidator(id string) error
• func PortPath(portID string) string

Constants

const (
	ModuleName = "ibc"

	StoreKey = ModuleName

	RouterKey string = ModuleName
)

const (
	KeyClientState             = "clientState"
	KeyConnectionPrefix        = "connections"
	KeyChannelEndPrefix        = "channelEnds"
	KeyChannelPrefix           = "channels"
	KeyPortPrefix              = "ports"
	KeyChannelCapabilityPrefix = "capabilities"
	KeyNextSeqSendPrefix       = "nextSequenceSend"
	KeyNextSeqRecvPrefix       = "nextSequenceRecv"
	KeyNextSeqAckPrefix        = "nextSequenceAck"
	KeyConsensusStatePrefix    = "consensusStates"
	KeyPacketCommitmentPrefix  = "commitments"
	KeySequencePrefix          = "sequences"
	KeyPacketReceiptPrefix     = "receipts"
	KeyPacketAckPrefix         = "acks"
)

const DefaultMaxCharacterLength = 64

DefaultMaxCharacterLength defines the default maximum character length used in validation of identifiers including the client, connection, port and channel identifiers.

NOTE: this restriction is specific to this golang implementation of IBC. If your use case demands a higher limit, please open an issue and we will consider adjusting this restriction.

const SubModuleName = "host"

SubModuleName defines the ICS 24 host

Variables

var (
	ErrInvalidID     = sdkerrors.Register(SubModuleName, 2, "invalid identifier")
	ErrInvalidPath   = sdkerrors.Register(SubModuleName, 3, "invalid path")
	ErrInvalidPacket = sdkerrors.Register(SubModuleName, 4, "invalid packet")
)

IBC client sentinel errors

var IsValidID = regexp.MustCompile(`^[a-zA-Z0-9\.\_\+\-\#\[\]\<\>]+$`).MatchString

var (
	KeyClientStorePrefix = []byte("clients")
)

KVStore key prefixes for IBC

Functions

func ChannelCapabilityPath

func ChannelCapabilityPath(portID, channelID string) string

ChannelCapabilityPath defines the path under which capability keys associated with a channel are stored

func ChannelIdentifierValidator

func ChannelIdentifierValidator(id string) error

ChannelIdentifierValidator is the default validator function for Channel identifiers. A valid Identifier must be between 8-64 characters and only contain alphanumeric and some allowed special characters (see IsValidID).

func ChannelKey

func ChannelKey(portID, channelID string) []byte

ChannelKey returns the store key for a particular channel

func ChannelPath

func ChannelPath(portID, channelID string) string

ChannelPath defines the path under which channels are stored

func ClientConnectionsKey

func ClientConnectionsKey(clientID string) []byte

ClientConnectionsKey returns the store key for the connections of a given client

func ClientConnectionsPath

func ClientConnectionsPath(clientID string) string

ClientConnectionsPath defines a reverse mapping from clients to a set of connections

func ClientIdentifierValidator

func ClientIdentifierValidator(id string) error

ClientIdentifierValidator is the default validator function for Client identifiers. A valid Identifier must be between 9-64 characters and only contain alphanumeric and some allowed special characters (see IsValidID).

func ClientStateKey

func ClientStateKey() []byte

ClientStateKey returns a store key under which a particular client state is stored in a client prefixed store

func ConnectionIdentifierValidator

func ConnectionIdentifierValidator(id string) error

ConnectionIdentifierValidator is the default validator function for Connection identifiers. A valid Identifier must be between 10-64 characters and only contain alphanumeric and some allowed special characters (see IsValidID).

func ConnectionKey

func ConnectionKey(connectionID string) []byte

ConnectionKey returns the store key for a particular connection

func ConnectionPath

func ConnectionPath(connectionID string) string

ConnectionPath defines the path under which connection paths are stored

func ConsensusStateKey

func ConsensusStateKey(height exported.Height) []byte

ConsensusStateKey returns the store key for a the consensus state of a particular client stored in a client prefixed store.

func ConsensusStatePath

func ConsensusStatePath(height exported.Height) string

ConsensusStatePath returns the suffix store key for the consensus state at a particular height stored in a client prefixed store.

func FullClientKey

func FullClientKey(clientID string, path []byte) []byte

FullClientKey returns the full path of specific client path in the format: "clients/{clientID}/{path}" as a byte array.

func FullClientPath

func FullClientPath(clientID string, path string) string

FullClientPath returns the full path of a specific client path in the format: "clients/{clientID}/{path}" as a string.

func FullClientStateKey

func FullClientStateKey(clientID string) []byte

FullClientStateKey takes a client identifier and returns a Key under which to store a particular client state.

func FullClientStatePath

func FullClientStatePath(clientID string) string

func FullConsensusStateKey

func FullConsensusStateKey(clientID string, height exported.Height) []byte

FullConsensusStateKey returns the store key for the consensus state of a particular client.

func FullConsensusStatePath

func FullConsensusStatePath(clientID string, height exported.Height) string

func NextSequenceAckKey

func NextSequenceAckKey(portID, channelID string) []byte

NextSequenceAckKey returns the store key for the acknowledgement sequence of a particular channel binded to a specific port.

func NextSequenceAckPath

func NextSequenceAckPath(portID, channelID string) string

NextSequenceAckPath defines the next acknowledgement sequence counter store path

func NextSequenceRecvKey

func NextSequenceRecvKey(portID, channelID string) []byte

NextSequenceRecvKey returns the store key for the receive sequence of a particular channel binded to a specific port

func NextSequenceRecvPath

func NextSequenceRecvPath(portID, channelID string) string

NextSequenceRecvPath defines the next receive sequence counter store path.

func NextSequenceSendKey

func NextSequenceSendKey(portID, channelID string) []byte

NextSequenceSendKey returns the store key for the send sequence of a particular channel binded to a specific port.

func NextSequenceSendPath

func NextSequenceSendPath(portID, channelID string) string

NextSequenceSendPath defines the next send sequence counter store path

func PacketAcknowledgementKey

func PacketAcknowledgementKey(portID, channelID string, sequence uint64) []byte

PacketAcknowledgementKey returns the store key of under which a packet acknowledgement is stored

func PacketAcknowledgementPath

func PacketAcknowledgementPath(portID, channelID string, sequence uint64) string

PacketAcknowledgementPath defines the packet acknowledgement store path

func PacketAcknowledgementPrefixPath

func PacketAcknowledgementPrefixPath(portID, channelID string) string

PacketAcknowledgementPrefixPath defines the prefix for commitments to packet data fields store path.

func PacketCommitmentKey

func PacketCommitmentKey(portID, channelID string, sequence uint64) []byte

PacketCommitmentKey returns the store key of under which a packet commitment is stored

func PacketCommitmentPath

func PacketCommitmentPath(portID, channelID string, sequence uint64) string

PacketCommitmentPath defines the commitments to packet data fields store path

func PacketCommitmentPrefixPath

func PacketCommitmentPrefixPath(portID, channelID string) string

PacketCommitmentPrefixPath defines the prefix for commitments to packet data fields store path.

func PacketReceiptKey

func PacketReceiptKey(portID, channelID string, sequence uint64) []byte

PacketReceiptKey returns the store key of under which a packet receipt is stored

func PacketReceiptPath

func PacketReceiptPath(portID, channelID string, sequence uint64) string

PacketReceiptPath defines the packet receipt store path

func ParseChannelPath

func ParseChannelPath(path string) (string, string, error)

ParseChannelPath returns the port and channel ID from a full path. It returns an error if the provided path is invalid.

func ParseConnectionPath

func ParseConnectionPath(path string) (string, error)

ParseConnectionPath returns the connection ID from a full path. It returns an error if the provided path is invalid.

func ParseIdentifier

func ParseIdentifier(identifier, prefix string) (uint64, error)

ParseIdentifier parses the sequence from the identifier using the provided prefix. This function does not need to be used by counterparty chains. SDK generated connection and channel identifiers are required to use this format.

func PortIdentifierValidator

func PortIdentifierValidator(id string) error

PortIdentifierValidator is the default validator function for Port identifiers. A valid Identifier must be between 2-64 characters and only contain alphanumeric and some allowed special characters (see IsValidID).

func PortPath

func PortPath(portID string) string

PortPath defines the path under which ports paths are stored on the capability module