Enum Error 

#[non_exhaustive]
pub enum Error {
    ParamsMismatch,
    InvalidLength,
    NonCanonicalField,
    VerificationFailed,
}

The error type returned by crate::verify and the byte parsers.

Error is intentionally coarse-grained. Verification failure produces a single Error::VerificationFailed variant regardless of which check failed — this is by design, so that a verifier cannot reveal partial information about why a forged signature was rejected. Parser-only errors (length mismatch, non-canonical field element) carry their own variants so honest callers can distinguish bad I/O from cryptographic failure.

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.

ParamsMismatch

The Params supplied to crate::verify disagree with the public key — typically because the verifier was given the wrong n_star.

InvalidLength

A serialised signature did not contain the leading K · 32 y-bytes, or crate::verify was handed a crate::Signature whose y_values.len() differs from Params::K. (The 36-byte public key parser cannot fail with this — its input is a fixed-size array.)

NonCanonicalField

A 32-byte chunk of Signature::y_values did not decode to a canonical Goldilocks-extension element (some 8-byte limb was ≥ the prime).

VerificationFailed

The signature failed verification. This is the catch-all cryptographic failure mode: it covers tampered y-values, malformed proofs, wrong messages, and any internal WHIR-level check that rejected.

Trait Implementations

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