Enum StatusError 

#[non_exhaustive]
pub enum StatusError {
    Unsupported(String),
    Unavailable {
        uri: String,
        reason: String,
        source: Option<Box<dyn Error + Send + Sync>>,
    },
    InvalidList {
        uri: String,
        reason: String,
        source: Option<Box<dyn Error + Send + Sync>>,
    },
    UnresolvedKey {
        uri: String,
        key: String,
        source: KeyResolutionError,
    },
    Expired {
        uri: String,
        expired_at: DateTime<Utc>,
        now: DateTime<Utc>,
    },
    IndexOutOfRange {
        uri: String,
        idx: u64,
        len: usize,
    },
    Invalid(String),
}

Available on crate feature vc only.

Why a StatusCheck did not pass.

The variants tell apart what a caller may want to handle differently: an Unavailable list may be fetched on a later attempt, an Expired one may be valid once its provider has refreshed it, and an UnresolvedKey depends on why the resolver failed, which its source says. An InvalidList or an IndexOutOfRange will not pass by trying again.

Where a variant has a source, Error::source returns it, and the message ends with it.

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.

Unsupported(String)

The check does not understand the status type.

Unavailable

The status list could not be fetched: the request failed, the server answered with an error status, or the check refused a redirect. The source is the client’s error, when there is one.

Fields

uri: String

The status list URI the credential references.

reason: String

What went wrong, naming the URL of a redirect hop where it is not uri.

source: Option<Box<dyn Error + Send + Sync>>

The underlying error.

InvalidList

The reference or the status list is not one the check can read or trust: a URI that is not a URL, a body that is not a status list token, a sub other than the URI, a signature that does not verify, a key that is not the issuer’s. The source is the underlying error, when there is one.

Fields

uri: String

The status list URI the credential references.

reason: String

What is wrong.

source: Option<Box<dyn Error + Send + Sync>>

The underlying error.

UnresolvedKey

The key that signed the status list could not be resolved; the source is the resolver’s error.

Fields

uri: String

The status list URI the credential references.

key: String

The key reference, as the token’s header names it.

source: KeyResolutionError

The resolver’s error.

Expired

The status list has expired.

Fields

uri: String

The status list URI the credential references.

expired_at: DateTime<Utc>

Its exp.

now: DateTime<Utc>

The validation time.

IndexOutOfRange

The credential’s index is beyond the end of the status list.

Fields

uri: String

The status list URI the credential references.

idx: u64

The credential’s index.

len: usize

The number of entries in the list.

Invalid(String)

The credential’s status makes it unusable: revoked, suspended, …

Trait Implementations

impl Debug for StatusError

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

Formats the value using the given formatter.

impl Display for StatusError

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

Formats the value using the given formatter.

impl Error for StatusError

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<StatusError> for ValidationError

fn from(source: StatusError) -> Self

Converts to this type from the input type.