Struct Scheme 

pub struct Scheme<P: PublicKey, V: Variant> { /* private fields */ }

BLS12-381 threshold signature scheme wrapper.

Implementations

impl<P: PublicKey, V: Variant> Scheme<P, V>

pub fn signer( namespace: &[u8], participants: Set<P>, polynomial: Sharing<V>, share: Share, ) -> Option<Self>

Creates a new signer instance with a private share and evaluated public polynomial.

pub fn verifier( namespace: &[u8], participants: Set<P>, polynomial: Sharing<V>, ) -> Self

Creates a verifier that can authenticate partial signatures.

pub fn certificate_verifier(namespace: &[u8], identity: V::Public) -> Self

Creates a lightweight verifier that only checks recovered certificates.

pub fn identity(&self) -> &V::Public

Returns the public identity of the committee (constant across reshares).

pub const fn share(&self) -> Option<&Share>

Returns the local share if this instance can generate partial signatures.

Trait Implementations

impl<P: Clone + PublicKey, V: Clone + Variant> Clone for Scheme<P, V>

fn clone(&self) -> Scheme<P, V>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<P: Debug + PublicKey, V: Debug + Variant> Debug for Scheme<P, V>

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

Formats the value using the given formatter.

impl<P: PublicKey, V: Variant> Scheme for Scheme<P, V>

type Subject<'a, D: Digest> = &'a Item<D>

Subject type for signing and verification.

type PublicKey = P

Public key type for participant identity used to order and index the participant set.

type Signature = <V as Variant>::Signature

Signature emitted by individual participants.

type Certificate = Certificate<V>

Certificate assembled from a set of attestations.

fn me(&self) -> Option<Participant>

Returns the index of “self” in the participant set, if available. Returns None if the scheme is a verifier-only instance.

fn participants(&self) -> &Set<Self::PublicKey>

Returns the ordered set of participant public identity keys managed by the scheme.

fn sign<D: Digest>( &self, subject: Self::Subject<'_, D>, ) -> Option<Attestation<Self>>

Signs a subject. Returns None if the scheme cannot sign (e.g. it’s a verifier-only instance).

fn verify_attestation<R, D>( &self, _rng: &mut R, subject: Self::Subject<'_, D>, attestation: &Attestation<Self>, _strategy: &impl Strategy, ) -> bool

where R: CryptoRngCore, D: Digest,

Verifies a single attestation against the participant material managed by the scheme.

fn verify_attestations<R, D, I>( &self, rng: &mut R, subject: Self::Subject<'_, D>, attestations: I, strategy: &impl Strategy, ) -> Verification<Self>

where R: CryptoRngCore, D: Digest, I: IntoIterator<Item = Attestation<Self>>, I::IntoIter: Send,

Batch-verifies attestations and separates valid attestations from signer indices that failed verification.

fn assemble<I, M>( &self, attestations: I, strategy: &impl Strategy, ) -> Option<Self::Certificate>

where I: IntoIterator<Item = Attestation<Self>>, I::IntoIter: Send, M: Faults,

Assembles attestations into a certificate, returning None if the threshold is not met.

fn verify_certificate<R, D, M>( &self, rng: &mut R, subject: Self::Subject<'_, D>, certificate: &Self::Certificate, _strategy: &impl Strategy, ) -> bool

where R: CryptoRngCore, D: Digest, M: Faults,

Verifies a certificate that was recovered or received from the network.

fn verify_certificates<'a, R, D, I, M>( &self, rng: &mut R, certificates: I, strategy: &impl Strategy, ) -> bool

where R: CryptoRngCore, D: Digest, I: Iterator<Item = (Self::Subject<'a, D>, &'a Self::Certificate)>, M: Faults,

Verifies a stream of certificates, returning false at the first failure.

fn is_attributable() -> bool

Returns whether per-participant fault evidence can be safely exposed.

fn is_batchable() -> bool

Returns whether this scheme benefits from batch verification.

fn certificate_codec_config(&self) -> <Self::Certificate as Read>::Cfg

Encoding configuration for bounded-size certificate decoding used in network payloads.

fn certificate_codec_config_unbounded() -> <Self::Certificate as Read>::Cfg

Encoding configuration that allows unbounded certificate decoding.