ics23_mpt source pure

1const ClientType = "state-lens/ics23/mpt"

1var (
2	ErrNoL1Client              = errors.New("ics23mpt: l1 client not configured")
3	ErrInvalidHeight           = errors.New("ics23mpt: proof height above latest height")
4	ErrConsensusStateNotFound  = errors.New("ics23mpt: consensus state not found at height")
5	ErrInvalidCommitmentValue  = errors.New("ics23mpt: commitment value must be 32 bytes")
6	ErrStoredValueMismatch     = errors.New("ics23mpt: stored value mismatch")
7	ErrMisbehaviourUnsupported = errors.New("ics23mpt: misbehaviour is not supported for state-lens clients")
8)

1var (
2	ErrConsensusStateTooShort = errors.New("ics23mpt: l2 consensus state too short")
3	ErrInvalidCommitmentKey   = errors.New("ics23mpt: invalid commitment key")
4)

1func EncodeClientState(cs ClientState) ([]byte, error)

1func EncodeConsensusState(cs ConsensusState) ([]byte, error)

1func EncodeHeader(h Header) ([]byte, error)

1func VerifyCommitmentKey(path []byte, proofKey []byte) error

1func DecodeClientState(buf []byte) (ClientState, error)

1func DecodeConsensusState(buf []byte) (ConsensusState, error)

1func DecodeHeader(buf []byte) (Header, error)

1func NewStateLensIcs23MptLightClient(clientState *ClientState, consensusState *ConsensusState, getL1ClientFn func(types.ClientId) (lightclient.Interface, bool)) (*StateLensIcs23MptLightClient, error)

1type ClientState struct {
2	L2ChainID         string
3	L1ClientID        uint32
4	L2ClientID        uint32
5	L2LatestHeight    uint64
6	TimestampOffset   uint16
7	StateRootOffset   uint16
8	StorageRootOffset uint16
9}

1type ConsensusState struct {
2	Timestamp   uint64 // nanoseconds since Unix epoch
3	StateRoot   []byte // bytes32
4	StorageRoot []byte // bytes32
5}

1type Header struct {
2	L1Height              uint64
3	L2Height              uint64
4	L2ConsensusStateProof []byte
5	L2ConsensusState      []byte
6}

1type StateLensIcs23MptLightClient struct {
2	clientState            *ClientState
3	consensusStateByHeight *bptree.BPTree // height:*ConsensusState
4	// getL1ClientFn resolves the settlement-chain light client from the host store
5	// on every call, so the state-lens always sees the current L1 state without
6	// needing an explicit refresh step.
7	getL1ClientFn func(types.ClientId) (lightclient.Interface, bool)
8}