cosmos-sdk/x/ibc/23-commitment/exported/exported.go

74 lines
1.8 KiB
Go

package exported
import ics23 "github.com/confio/ics23/go"
// ICS 023 Types Implementation
//
// This file includes types defined under
// https://github.com/cosmos/ics/tree/master/spec/ics-023-vector-commitments
// spec:Path and spec:Value are defined as bytestring
// Root implements spec:CommitmentRoot.
// A root is constructed from a set of key-value pairs,
// and the inclusion or non-inclusion of an arbitrary key-value pair
// can be proven with the proof.
type Root interface {
GetCommitmentType() Type
GetHash() []byte
Empty() bool
}
// Prefix implements spec:CommitmentPrefix.
// Prefix represents the common "prefix" that a set of keys shares.
type Prefix interface {
GetCommitmentType() Type
Bytes() []byte
Empty() bool
}
// Path implements spec:CommitmentPath.
// A path is the additional information provided to the verification function.
type Path interface {
GetCommitmentType() Type
String() string
Empty() bool
}
// Proof implements spec:CommitmentProof.
// Proof can prove whether the key-value pair is a part of the Root or not.
// Each proof has designated key-value pair it is able to prove.
// Proofs includes key but value is provided dynamically at the verification time.
type Proof interface {
GetCommitmentType() Type
VerifyMembership([]*ics23.ProofSpec, Root, Path, []byte) error
VerifyNonMembership([]*ics23.ProofSpec, Root, Path) error
Empty() bool
ValidateBasic() error
}
// Type defines the type of the commitment
type Type byte
// Registered commitment types
const (
Merkle Type = iota + 1 // 1
)
// string representation of the commitment types
const (
TypeMerkle string = "merkle"
)
// String implements the Stringer interface
func (ct Type) String() string {
switch ct {
case Merkle:
return TypeMerkle
default:
return ""
}
}