Struct Notarize

pub struct Notarize<V: Variant, D: Digest> {
    pub proposal: Proposal<D>,
    pub proposal_signature: PartialSignature<V>,
    pub seed_signature: PartialSignature<V>,
}

Notarize represents a validator’s vote to notarize a proposal. In threshold_simplex, it contains a partial signature on the proposal and a partial signature for the seed. The seed is used for leader election and as a source of randomness.

Fields

proposal: Proposal<D>

The proposal that is being notarized

proposal_signature: PartialSignature<V>

The validator’s partial signature on the proposal

seed_signature: PartialSignature<V>

The validator’s partial signature on the seed (for leader election/randomness)

Implementations

impl<V: Variant, D: Digest> Notarize<V, D>

pub fn new( proposal: Proposal<D>, proposal_signature: PartialSignature<V>, seed_signature: PartialSignature<V>, ) -> Self

Creates a new notarize with the given proposal and signatures.

pub fn verify(&self, namespace: &[u8], polynomial: &[V::Public]) -> bool

Verifies the PartialSignatures on this Notarize.

This ensures that:

1. The notarize signature is valid for the claimed proposal
2. The seed signature is valid for the view
3. Both signatures are from the same signer

pub fn verify_multiple( namespace: &[u8], polynomial: &[V::Public], notarizes: Vec<Notarize<V, D>>, ) -> (Vec<Notarize<V, D>>, Vec<u32>)

Verifies a batch of Notarize messages using BLS aggregate verification.

This function verifies a batch of Notarize messages using BLS aggregate verification. It returns a tuple containing:

• A vector of successfully verified Notarize messages.
• A vector of signer indices for whom verification failed.

pub fn sign(namespace: &[u8], share: &Share, proposal: Proposal<D>) -> Self

Creates a PartialSignature over this Notarize.

Trait Implementations

impl<V: Variant, D: Digest> Attributable for Notarize<V, D>

fn signer(&self) -> u32

Returns the index of the signer (validator) who produced this message.

impl<V: Clone + Variant, D: Clone + Digest> Clone for Notarize<V, D>

fn clone(&self) -> Notarize<V, D>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<V: Debug + Variant, D: Debug + Digest> Debug for Notarize<V, D>

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

Formats the value using the given formatter.

impl<V: Variant, D: Digest> EncodeSize for Notarize<V, D>

fn encode_size(&self) -> usize

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

impl<V: Hash + Variant, D: Hash + Digest> Hash for Notarize<V, 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<V: PartialEq + Variant, D: PartialEq + Digest> PartialEq for Notarize<V, D>

fn eq(&self, other: &Notarize<V, D>) -> 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<V: Variant, D: Digest> Read for Notarize<V, D>

type 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, _: &()) -> Result<Self, Error>

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

impl<V: Variant, D: Digest> Viewable for Notarize<V, D>

fn view(&self) -> View

Returns the view associated with this object.

impl<V: Variant, D: Digest> Write for Notarize<V, D>

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

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

impl<V: Eq + Variant, D: Eq + Digest> Eq for Notarize<V, D>

impl<V: Variant, D: Digest> StructuralPartialEq for Notarize<V, D>