utils

Documentation

Index

• Constants
• func DisplayInfo(info PrintInfo) error
• func GenerateSEDAKeys(valAddr sdk.ValAddress, dirPath string) ([]pubkeytypes.IndexedPubKey, error)
• func GetProof(entries [][]byte, index int) ([][]byte, error)
• func LoadSEDAPubKeys(loadPath string) ([]pubkeytypes.IndexedPubKey, error)
• func PubKeyToEthAddress(uncompressed []byte) ([]byte, error)
• func RootFromEntries(entries [][]byte) []byte
• func RootFromLeaves(leaves [][]byte) []byte
• func ValidateSEDAPubKeys(indPubKeys []pubkeytypes.IndexedPubKey) error
• func VerifyProof(proof [][]byte, root, entry []byte) bool
• type PrintInfo
  • func NewPrintInfo(moniker, chainID, nodeID, seeds string) PrintInfo
• type SEDAKeyIndex
• type SEDASigner
  • func LoadSEDASigner(keyFilePath string) (SEDASigner, error)

Constants

const (
	SEDASeparatorDataRequest byte = iota
	SEDASeparatorSecp256k1
)

SEDA domain separators

const SEDAKeyFileName = "seda_keys.json"

SEDAKeyFileName defines the SEDA key file name.

Functions

func DisplayInfo

func DisplayInfo(info PrintInfo) error

func GenerateSEDAKeys

func GenerateSEDAKeys(valAddr sdk.ValAddress, dirPath string) ([]pubkeytypes.IndexedPubKey, error)

GenerateSEDAKeys generates a new set of SEDA keys and saves them to the SEDA key file, along with the provided validator address. It returns the resulting index-public key pairs. The key file is stored in the directory given by dirPath.

func GetProof

func GetProof(entries [][]byte, index int) ([][]byte, error)

GetProof returns the merkle proof for the entry at the given index.

func LoadSEDAPubKeys

func LoadSEDAPubKeys(loadPath string) ([]pubkeytypes.IndexedPubKey, error)

LoadSEDAPubKeys loads the SEDA key file from the given path and returns a list of index-public key pairs.

func PubKeyToEthAddress

func PubKeyToEthAddress(uncompressed []byte) ([]byte, error)

PubKeyToAddress converts a public key in the 65-byte uncompressed format into the Ethereum address format, which is defined as the rightmost 160 bits of Keccak hash of an ECDSA public key without the 0x04 prefix.

func RootFromEntries

func RootFromEntries(entries [][]byte) []byte

RootFromEntries computes the root of a merkle tree whose leaves are the hashes of the given entries.

• It uses Keccak-256 hashing algorithm.
• The leaves are sorted.
• Each hash pair is sorted to make proofs more succinct.

func RootFromLeaves

func RootFromLeaves(leaves [][]byte) []byte

RootFromLeaves computes the root of a merkle tree with the given leaves.

func ValidateSEDAPubKeys

func ValidateSEDAPubKeys(indPubKeys []pubkeytypes.IndexedPubKey) error

ValidateSEDAPubKeys ensures that the provided indexed public keys conform to SEDA keys specifications. It first sorts the provided slice for deterministic results.

func VerifyProof

func VerifyProof(proof [][]byte, root, entry []byte) bool

Types

type PrintInfo

type PrintInfo struct {
	Moniker string `json:"moniker" yaml:"moniker"`
	ChainID string `json:"chain_id" yaml:"chain_id"`
	NodeID  string `json:"node_id" yaml:"node_id"`
	Seeds   string `json:"seeds" yaml:"seeds"`
}

func NewPrintInfo

func NewPrintInfo(moniker, chainID, nodeID, seeds string) PrintInfo

type SEDAKeyIndex

type SEDAKeyIndex uint32

SEDAKeyIndex enumerates the SEDA key indices.

const (
	SEDAKeyIndexSecp256k1 SEDAKeyIndex = iota
)

type SEDASigner

type SEDASigner interface {
	GetValAddress() sdk.ValAddress
	Sign(input []byte, index SEDAKeyIndex) (signature []byte, err error)
	ReloadIfMismatch(pubKeys []pubkeytypes.IndexedPubKey) error
	IsLoaded() bool
}

func LoadSEDASigner

func LoadSEDASigner(keyFilePath string) (SEDASigner, error)

LoadSEDASigner loads the SEDA keys from a given file path and returns a SEDASigner interface.