Struct LightClient 

pub struct LightClient { /* private fields */ }

Light client that verifies block headers against a trusted validator set.

Implementations

impl LightClient

pub fn new( trusted_validator_set: ValidatorSet, trusted_height: Height, chain_id_hash: [u8; 32], ) -> Self

Create a new light client with a trusted validator set and height.

pub fn verify_header( &self, header: &BlockHeader, qc: &QuorumCertificate, verifier: &dyn Verifier, ) -> Result<()>

Verify a block header against the given QC and the trusted validator set.

Checks:

1. QC’s block_hash matches the header’s hash
2. The QC has quorum (>= 2f+1 voting power)
3. The QC’s aggregate signature is valid against the validator set

pub fn update_validator_set(&mut self, new_vs: ValidatorSet, new_height: Height)

Update the trusted validator set after an epoch transition.

pub fn trusted_height(&self) -> Height

Return the current trusted height.

pub fn trusted_validator_set(&self) -> &ValidatorSet

Return a reference to the current trusted validator set.

pub fn verify_state_proof( app_hash: &[u8; 32], expected_key: &[u8], proof: &MptProof, ) -> Result<bool>

Verify an MPT state proof against a trusted app_hash.

The app_hash should come from a verified block header (after verify_header succeeds). The proof_bytes are the serialized MptProof nodes (as returned by the query RPC proof field). The expected_key is the raw key the caller expects the proof to cover.

Returns Ok(true) if the proof is valid against the given root.