Struct diem_sdk::types::validator_verifier::ValidatorVerifier
pub struct ValidatorVerifier { /* private fields */ }
Expand description
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.
Implementations§
§impl ValidatorVerifier
impl ValidatorVerifier
pub fn new(
address_to_validator_info: BTreeMap<AccountAddress, ValidatorConsensusInfo, Global>
) -> ValidatorVerifier
pub fn new( address_to_validator_info: BTreeMap<AccountAddress, ValidatorConsensusInfo, Global> ) -> ValidatorVerifier
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: BTreeMap<AccountAddress, ValidatorConsensusInfo, Global>,
quorum_voting_power: u64
) -> Result<ValidatorVerifier, Error>
pub fn new_with_quorum_voting_power( address_to_validator_info: BTreeMap<AccountAddress, ValidatorConsensusInfo, Global>, quorum_voting_power: u64 ) -> Result<ValidatorVerifier, Error>
Initializes a validator verifier with a specified quorum voting power.
pub fn new_for_testing(
address_to_validator_info: BTreeMap<AccountAddress, ValidatorConsensusInfo, Global>,
quorum_voting_power: u64,
total_voting_power: u64
) -> ValidatorVerifier
pub fn new_for_testing( address_to_validator_info: BTreeMap<AccountAddress, ValidatorConsensusInfo, Global>, quorum_voting_power: u64, total_voting_power: u64 ) -> ValidatorVerifier
Initializes a validator verifier with a specified quorum voting power and total power.
pub fn new_single(
author: AccountAddress,
public_key: Ed25519PublicKey
) -> ValidatorVerifier
pub fn new_single( author: AccountAddress, public_key: Ed25519PublicKey ) -> ValidatorVerifier
Helper method to initialize with a single author and public key with quorum voting power 1.
pub fn verify<T>(
&self,
author: AccountAddress,
message: &T,
signature: &Ed25519Signature
) -> Result<(), VerifyError>where
T: Serialize + CryptoHash,
pub fn verify<T>( &self, author: AccountAddress, message: &T, signature: &Ed25519Signature ) -> Result<(), VerifyError>where T: Serialize + CryptoHash,
Verify the correctness of a signature of a message by a known author.
pub fn verify_aggregated_struct_signature<T>(
&self,
message: &T,
aggregated_signature: &BTreeMap<AccountAddress, Ed25519Signature, Global>
) -> Result<(), VerifyError>where
T: CryptoHash + Serialize,
pub fn verify_aggregated_struct_signature<T>( &self, message: &T, aggregated_signature: &BTreeMap<AccountAddress, Ed25519Signature, Global> ) -> Result<(), VerifyError>where T: CryptoHash + Serialize,
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_signatures<T>(
&self,
message: &T,
aggregated_signature: &BTreeMap<AccountAddress, Ed25519Signature, Global>
) -> Result<(), VerifyError>where
T: CryptoHash + Serialize,
pub fn batch_verify_aggregated_signatures<T>( &self, message: &T, aggregated_signature: &BTreeMap<AccountAddress, Ed25519Signature, Global> ) -> Result<(), VerifyError>where T: CryptoHash + Serialize,
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>
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<Ed25519PublicKey>
pub fn get_public_key(&self, author: &AccountAddress) -> Option<Ed25519PublicKey>
Returns the public key for this address.
pub fn get_voting_power(&self, author: &AccountAddress) -> Option<u64>
pub fn get_voting_power(&self, author: &AccountAddress) -> Option<u64>
Returns the voting power for this address.
pub fn get_ordered_account_addresses_iter(
&self
) -> impl Iterator<Item = AccountAddress>
pub fn get_ordered_account_addresses_iter( &self ) -> impl Iterator<Item = AccountAddress>
Returns an ordered list of account addresses as an Iterator
.
pub fn quorum_voting_power(&self) -> u64
pub fn quorum_voting_power(&self) -> u64
Returns quorum voting power.
Trait Implementations§
§impl Arbitrary for ValidatorVerifier
impl Arbitrary for ValidatorVerifier
§type Parameters = (<BTreeMap<AccountAddress, ValidatorConsensusInfo, Global> as Arbitrary>::Parameters, <u64 as Arbitrary>::Parameters, <u64 as Arbitrary>::Parameters)
type Parameters = (<BTreeMap<AccountAddress, ValidatorConsensusInfo, Global> as Arbitrary>::Parameters, <u64 as Arbitrary>::Parameters, <u64 as Arbitrary>::Parameters)
arbitrary_with
accepts for configuration
of the generated Strategy
. Parameters must implement Default
.§type Strategy = Map<(<BTreeMap<AccountAddress, ValidatorConsensusInfo, Global> as Arbitrary>::Strategy, <u64 as Arbitrary>::Strategy, <u64 as Arbitrary>::Strategy), fn(_: (BTreeMap<AccountAddress, ValidatorConsensusInfo, Global>, u64, u64)) -> ValidatorVerifier>
type Strategy = Map<(<BTreeMap<AccountAddress, ValidatorConsensusInfo, Global> as Arbitrary>::Strategy, <u64 as Arbitrary>::Strategy, <u64 as Arbitrary>::Strategy), fn(_: (BTreeMap<AccountAddress, ValidatorConsensusInfo, Global>, u64, u64)) -> ValidatorVerifier>
Strategy
used to generate values of type Self
.§fn arbitrary_with(
_top: <ValidatorVerifier as Arbitrary>::Parameters
) -> <ValidatorVerifier as Arbitrary>::Strategy
fn arbitrary_with( _top: <ValidatorVerifier as Arbitrary>::Parameters ) -> <ValidatorVerifier as Arbitrary>::Strategy
§impl Clone for ValidatorVerifier
impl Clone for ValidatorVerifier
§fn clone(&self) -> ValidatorVerifier
fn clone(&self) -> ValidatorVerifier
1.0.0 · source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source
. Read more§impl Debug for ValidatorVerifier
impl Debug for ValidatorVerifier
§impl<'de> Deserialize<'de> for ValidatorVerifier
impl<'de> Deserialize<'de> for ValidatorVerifier
§fn deserialize<__D>(
__deserializer: __D
) -> Result<ValidatorVerifier, <__D as Deserializer<'de>>::Error>where
__D: Deserializer<'de>,
fn deserialize<__D>( __deserializer: __D ) -> Result<ValidatorVerifier, <__D as Deserializer<'de>>::Error>where __D: Deserializer<'de>,
§impl Display for ValidatorVerifier
impl Display for ValidatorVerifier
§impl From<&ValidatorSet> for ValidatorVerifier
impl From<&ValidatorSet> for ValidatorVerifier
§fn from(validator_set: &ValidatorSet) -> ValidatorVerifier
fn from(validator_set: &ValidatorSet) -> ValidatorVerifier
§impl From<&ValidatorVerifier> for ValidatorSet
impl From<&ValidatorVerifier> for ValidatorSet
§fn from(verifier: &ValidatorVerifier) -> ValidatorSet
fn from(verifier: &ValidatorVerifier) -> ValidatorSet
§impl PartialEq<ValidatorVerifier> for ValidatorVerifier
impl PartialEq<ValidatorVerifier> for ValidatorVerifier
§fn eq(&self, other: &ValidatorVerifier) -> bool
fn eq(&self, other: &ValidatorVerifier) -> bool
self
and other
values to be equal, and is used
by ==
.§impl Serialize for ValidatorVerifier
impl Serialize for ValidatorVerifier
§fn serialize<__S>(
&self,
__serializer: __S
) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>where
__S: Serializer,
fn serialize<__S>( &self, __serializer: __S ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>where __S: Serializer,
impl Eq for ValidatorVerifier
impl StructuralEq for ValidatorVerifier
impl StructuralPartialEq for ValidatorVerifier
Auto Trait Implementations§
impl RefUnwindSafe for ValidatorVerifier
impl Send for ValidatorVerifier
impl Sync for ValidatorVerifier
impl Unpin for ValidatorVerifier
impl UnwindSafe for ValidatorVerifier
Blanket Implementations§
source§impl<Q, K> Equivalent<K> for Qwhere
Q: Eq + ?Sized,
K: Borrow<Q> + ?Sized,
impl<Q, K> Equivalent<K> for Qwhere Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,
source§fn equivalent(&self, key: &K) -> bool
fn equivalent(&self, key: &K) -> bool
key
and return true
if they are equal.