Struct solana_libra_types::validator_verifier::ValidatorVerifier

pub struct ValidatorVerifier<PublicKey> { /* fields omitted */ }

Supports validation of signatures for known authors with individual voting powers. This struct can be used for all signature verification operations including block and network signature verification, respectively.

Methods

impl<PublicKey: VerifyingKey> ValidatorVerifier<PublicKey>

pub fn new(
    address_to_validator_info: HashMap<AccountAddress, ValidatorInfo<PublicKey>>
) -> Self

Initialize with a map of account address to validator info and set quorum size to default (2f + 1) or zero if address_to_validator_info is empty.

pub fn new_with_quorum_voting_power(
    address_to_validator_info: HashMap<AccountAddress, ValidatorInfo<PublicKey>>,
    quorum_voting_power: u64
) -> Result<Self>

Initializes a validator verifier with a specified quorum voting power.

pub fn new_single(author: AccountAddress, public_key: PublicKey) -> Self

Helper method to initialize with a single author and public key with quorum voting power 1.

pub fn verify_signature(
    &self,
    author: AccountAddress,
    hash: HashValue,
    signature: &PublicKey::SignatureMaterial
) -> Result<(), VerifyError>

Verify the correctness of a signature of a hash by a known author.

pub fn verify_aggregated_signature<T>(
    &self,
    hash: HashValue,
    aggregated_signature: &HashMap<AccountAddress, T>
) -> Result<(), VerifyError> where
    T: Into<PublicKey::SignatureMaterial> + Clone, 

This function will successfully return when at least quorum_size signatures of known authors are successfully verified. Also, an aggregated signature is considered invalid if any of the attached signatures is invalid or it does not correspond to a known author. The latter is to prevent malicious users from adding arbitrary content to the signature payload that would go unnoticed.

pub fn batch_verify_aggregated_signature<T>(
    &self,
    hash: HashValue,
    aggregated_signature: &HashMap<AccountAddress, T>
) -> Result<(), VerifyError> where
    T: Into<PublicKey::SignatureMaterial> + Clone, 

This function will try batch signature verification and falls back to normal iterated verification if batching fails.

pub fn check_voting_power<'a>(
    &self,
    authors: impl Iterator<Item = &'a AccountAddress>
) -> Result<(), VerifyError>

Ensure there is at least quorum_voting_power in the provided signatures and there are only known authors. According to the threshold verification policy, invalid public keys are not allowed.

pub fn get_public_key(&self, author: &AccountAddress) -> Option<PublicKey>

Returns the public key for this address.

pub fn get_voting_power(&self, author: &AccountAddress) -> Option<u64>

Returns the voting power for this address.

pub fn get_ordered_account_addresses(&self) -> Vec<AccountAddress>

Returns a ordered list of account addresses from smallest to largest.

pub fn len(&self) -> usize

Returns the number of authors to be validated.

pub fn is_empty(&self) -> bool

Is there at least one author?

pub fn quorum_voting_power(&self) -> u64

Returns quorum voting power.

Trait Implementations

impl<PublicKey: Clone> Clone for ValidatorVerifier<PublicKey>

fn clone(&self) -> ValidatorVerifier<PublicKey>

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.