Struct TokenLifecycleError 

pub struct TokenLifecycleError {
    pub reason: InvalidationReason,
    pub message: String,
}

Errors returned by TokenValidator when it rejects a token submission.

Carries the structured InvalidationReason (which itself embeds the vendor family + challenge class) and a short human-readable message suitable for operator logs. The diagnostic payload the runner exposes can switch on the InvalidationReason::kind tag to route the failure into the correct per-family audit log.

Fields

reason: InvalidationReason

Structured reason the validator rejected the token.

message: String

Human-readable message suitable for operator logs.

Implementations

impl TokenLifecycleError

pub fn new(reason: InvalidationReason, message: impl Into<String>) -> Self

Build a TokenLifecycleError from a reason + a human-readable message.

Example

use stygian_charon::token_lifecycle::{
    ChallengeClass, InvalidationReason, TokenLifecycleError,
};
use stygian_charon::vendor_classifier::VendorId;

let err = TokenLifecycleError::new(
    InvalidationReason::Expired {
        vendor: VendorId::Cloudflare,
        challenge_class: ChallengeClass::Interstitial,
        age_secs: 1900,
        ttl_secs: 1800,
    },
    "Cloudflare token expired",
);
assert_eq!(err.message, "Cloudflare token expired");
assert_eq!(err.reason.vendor_family(), VendorId::Cloudflare);

pub const fn vendor_family(&self) -> VendorId

Vendor family the error is attributed to.

Trait Implementations

impl Clone for TokenLifecycleError

fn clone(&self) -> TokenLifecycleError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TokenLifecycleError

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

Formats the value using the given formatter.

impl Display for TokenLifecycleError

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

Formats the value using the given formatter.

impl Error for TokenLifecycleError

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 TokenLifecycleError

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

impl StructuralPartialEq for TokenLifecycleError