Enum Error 

#[non_exhaustive]
pub enum Error {
    InvalidPublicKeyLength {
        expected: usize,
        actual: usize,
    },
    InvalidSignatureLength {
        actual: usize,
        min: usize,
        max: usize,
    },
    VerificationFailed {
        index: usize,
    },
    SignerIndexOutOfRange {
        index: usize,
        total: usize,
    },
    DuplicateSignature {
        index: usize,
    },
    InvalidThreshold {
        required: usize,
        total_keys: usize,
    },
    CommitteeTooSmall {
        count: usize,
    },
    ThresholdNotMet {
        have: usize,
        need: usize,
    },
    PublicKeyParseError {
        index: usize,
    },
    SignatureParseError {
        index: usize,
    },
}

All errors that can be produced by this library.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

InvalidPublicKeyLength

The supplied public key has an incorrect byte length.

Falcon-512 public keys must be exactly crate::PUBLIC_KEY_BYTES bytes.

Fields

expected: usize

The required length.

actual: usize

The actual length received.

InvalidSignatureLength

The supplied signature has an incorrect or out-of-range byte length.

Fields

actual: usize

Actual length received.

min: usize

Inclusive minimum valid length.

max: usize

Inclusive maximum valid length.

VerificationFailed

Cryptographic verification of a Falcon-512 signature failed.

This is returned by crate::verify::verify_partial and crate::session::SigningSession::add_signature when the raw Falcon-512 check does not pass.

Fields

index: usize

Zero-based index of the signer whose signature failed.

SignerIndexOutOfRange

The public key provided during signing does not belong to the configured committee.

Fields

index: usize

The index that was supplied.

total: usize

The total number of committee members.

DuplicateSignature

A signature for this index has already been recorded in the session.

Fields

index: usize

The index that was supplied twice.

InvalidThreshold

The threshold configuration is invalid.

required must be in the range 1..=total_keys.

Fields

required: usize

The requested number of required signatures.

total_keys: usize

The total number of keys in the committee.

CommitteeTooSmall

The committee must have at least two members.

Fields

count: usize

Number of keys provided.

ThresholdNotMet

The signing session has not yet collected enough valid signatures to satisfy the configured threshold.

Fields

have: usize

Number of valid signatures currently held.

need: usize

Number required by the threshold policy.

PublicKeyParseError

Failed to parse a Falcon-512 public key from raw bytes.

Fields

index: usize

Zero-based committee index of the key that failed to parse.

SignatureParseError

Failed to parse a Falcon-512 signature from raw bytes.

Fields

index: usize

Zero-based committee index of the failing signature.

Trait Implementations

impl Clone for Error

fn clone(&self) -> Error

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl PartialEq for Error

fn eq(&self, other: &Error) -> 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 Eq for Error

impl StructuralPartialEq for Error