Struct Notarization 

pub struct Notarization<S: Scheme, D: Digest> {
    pub proposal: Proposal<D>,
    pub certificate: S::Certificate,
}

Aggregated notarization certificate recovered from notarize votes. When a proposal is notarized, it means at least 2f+1 validators have voted for it.

Some signing schemes embed an additional randomness seed in the certificate (used for leader rotation), it can be accessed via Scheme::seed.

Fields

proposal: Proposal<D>

The proposal that has been notarized.

certificate: S::Certificate

The recovered certificate for the proposal.

Implementations

impl<S: Scheme, D: Digest> Notarization<S, D>

pub fn from_notarizes<'a>( scheme: &S, notarizes: impl IntoIterator<Item = &'a Notarize<S, D>>, ) -> Option<Self>

Builds a notarization certificate from notarize votes for the same proposal.

pub fn round(&self) -> Round

Returns the round associated with the notarized proposal.

impl<S: Scheme, D: Digest> Notarization<S, D>

pub fn verify<R: Rng + CryptoRng>( &self, rng: &mut R, scheme: &S, namespace: &[u8], ) -> bool

Verifies the notarization certificate against the provided signing scheme.

This ensures that the certificate is valid for the claimed proposal.

Trait Implementations

impl<S: Clone + Scheme, D: Clone + Digest> Clone for Notarization<S, D>

where S::Certificate: Clone,

fn clone(&self) -> Notarization<S, D>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<S: Debug + Scheme, D: Debug + Digest> Debug for Notarization<S, D>

where S::Certificate: Debug,

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<S: Scheme, D: Digest> EncodeSize for Notarization<S, D>

fn encode_size(&self) -> usize

Returns the encoded size of this value (in bytes).

impl<S: Scheme, D: Digest> Epochable for Notarization<S, D>

type Epoch = u64

Epoch is the type used to indicate a contiguous sequence of views in which the set of validators is constant.

fn epoch(&self) -> Epoch

Returns the epoch associated with this object.

impl<S: Scheme, D: Digest> Hash for Notarization<S, D>

fn hash<H: Hasher>(&self, state: &mut H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<S: Scheme, D: Digest> PartialEq for Notarization<S, D>

fn eq(&self, other: &Self) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<S: Scheme, D: Digest> Read for Notarization<S, D>

type Cfg = <<S as Scheme>::Certificate as Read>::Cfg

The Cfg type parameter allows passing configuration during the read process. This is crucial for safely decoding untrusted data, for example, by providing size limits for collections or strings.

fn read_cfg(reader: &mut impl Buf, cfg: &Self::Cfg) -> Result<Self, Error>

Reads a value from the buffer using the provided configuration cfg.

impl<P: PublicKey, V: Variant, D: Digest> Seedable<V> for Notarization<Scheme<P, V>, D>

fn seed(&self) -> Seed<V>

Returns the seed associated with this object.

impl<S: Scheme, D: Digest> Viewable for Notarization<S, D>

type View = u64

View is the type used to indicate the in-progress consensus decision.

fn view(&self) -> View

Returns the view associated with this object.

impl<S: Scheme, D: Digest> Write for Notarization<S, D>

fn write(&self, writer: &mut impl BufMut)

Writes the binary representation of self to the provided buffer buf.

impl<S: Scheme, D: Digest> Eq for Notarization<S, D>