Enum JwtError 

pub enum JwtError {
    MalformedCompact,
    Base64Decode {
        segment: &'static str,
        source: DecodeError,
    },
    JsonDecode {
        segment: &'static str,
        source: Error,
    },
    JsonEncode(Error),
    SignatureLength {
        actual: usize,
    },
    InvalidSignatureScalar,
    UnsupportedAlg {
        alg: String,
    },
    SignatureVerify(AnySignatureError),
}

Errors from JWT encode/decode.

Not user-rendered: these errors only surface inside tests and library helpers. They deliberately do NOT derive miette::Diagnostic with stable codes — the stage converts any failure into a CreateReportStageError::Transport or a specific check SpecViolation before rendering. If a future caller needs one of these variants rendered to the user, they must wrap it in a stage-local diagnostic with a proper code = "labeler::..." string.

Variants

MalformedCompact

Compact form was not three .-separated base64url segments.

Base64Decode

A base64url segment failed to decode.

Fields

segment: &'static str

Which segment failed: “header”, “claims”, or “signature”.

source: DecodeError

Underlying base64 error.

JsonDecode

A segment decoded to valid bytes but invalid JSON.

Fields

segment: &'static str

Which segment failed: “header” or “claims”.

source: Error

Underlying serde_json error.

JsonEncode(Error)

JSON serialization of header or claims failed (should not happen for well-formed structs).

SignatureLength

Signature was not exactly 64 bytes.

Fields

actual: usize

Actual length in bytes.

InvalidSignatureScalar

Signature had the correct length but invalid scalar values (e.g., r or s is 0 or exceeds the curve order).

UnsupportedAlg

The algorithm identifier in the header is not recognized.

Fields

alg: String

The unrecognized algorithm string.

SignatureVerify(AnySignatureError)

Underlying ECDSA verification failure (e.g., curve mismatch).

Trait Implementations

impl Debug for JwtError

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

Formats the value using the given formatter.

impl Display for JwtError

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

Formats the value using the given formatter.

impl Error for JwtError

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 From<AnySignatureError> for JwtError

fn from(source: AnySignatureError) -> Self

Converts to this type from the input type.