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( 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(participants: Set<P>, polynomial: Sharing<V>) -> Self

Creates a verifier that can authenticate partial signatures.

pub const fn certificate_verifier(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 + Send + Sync> 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 = <V as Variant>::Signature

Certificate assembled from a set of attestations.

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

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, namespace: &[u8], subject: Self::Subject<'_, D>, ) -> Option<Attestation<Self>>

Signs a subject using the supplied namespace for domain separation. Returns None if the scheme cannot sign (e.g. it’s a verifier-only instance).

fn verify_attestation<D: Digest>( &self, namespace: &[u8], subject: Self::Subject<'_, D>, attestation: &Attestation<Self>, ) -> bool

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

fn verify_attestations<R, D, I>( &self, rng: &mut R, namespace: &[u8], subject: Self::Subject<'_, D>, attestations: I, ) -> Verification<Self>

where R: Rng + CryptoRng, D: Digest, I: IntoIterator<Item = Attestation<Self>>,

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

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

where I: IntoIterator<Item = Attestation<Self>>,

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

fn verify_certificate<R: Rng + CryptoRng, D: Digest>( &self, rng: &mut R, namespace: &[u8], subject: Self::Subject<'_, D>, certificate: &Self::Certificate, ) -> bool

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

fn verify_certificates<'a, R, D, I>( &self, rng: &mut R, namespace: &[u8], certificates: I, ) -> bool

where R: Rng + CryptoRng, D: Digest, I: Iterator<Item = (Self::Subject<'a, D>, &'a Self::Certificate)>,

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

fn is_attributable(&self) -> bool

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

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.