Enum SlhDsaError 

pub enum SlhDsaError {
    RngFailure,
    InvalidKey,
    InvalidSignature,
    VerificationFailed,
    FaultDetected,
}

Errors that can occur in SLH-DSA operations.

These errors cover failures in random number generation, malformed keys or signatures, and verification mismatches. All variants are non-recoverable in the sense that retrying with the same inputs will produce the same error.

Variants

RngFailure

The cryptographic random number generator failed to produce bytes.

This typically indicates an OS-level failure (e.g., /dev/urandom unavailable).

InvalidKey

The provided key has an invalid format or unexpected length.

Public keys must be 2*n bytes and secret keys 4*n bytes, where n is the security parameter (Params::N).

InvalidSignature

The provided signature has an invalid format or unexpected length.

Signatures must be exactly SlhDsa::signature_size bytes for the chosen parameter set.

VerificationFailed

The signature did not verify against the given message and public key.

FaultDetected

Signing-side fault redundancy detected a mismatch between the two independent signing runs (item T1-C of the SLH-DSA SCA roadmap).

Gated by the sca-fors-redundancy cargo feature, the signer produces the FORS signature twice and aborts before emission if the two results disagree — single-fault grafting-tree forgeries (Castelnovi 2018, Adiletta 2025) cannot then propagate out of the device. The error is non-recoverable; a retry on the same inputs will either succeed (the fault was transient) or surface the same error again.

Trait Implementations

impl Clone for SlhDsaError

fn clone(&self) -> SlhDsaError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SlhDsaError

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

Formats the value using the given formatter.

impl Display for SlhDsaError

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

Formats the value using the given formatter.

impl Eq for SlhDsaError

impl Error for SlhDsaError

Available on crate feature std only.

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 SlhDsaError

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