Struct Error 

pub struct Error {
    pub kind: ErrorKind,
    pub phase: Phase,
    pub status_word: Option<StatusWord>,
    pub application_status: Option<u8>,
    pub reference: Option<SecretReference>,
    pub retries_remaining: Option<u8>,
}

Owned, cloneable protocol failure with no secret payload. Display is diagnostic English; applications own localization and transport errors.

Fields

kind: ErrorKind

Semantic failure category.

phase: Phase

Command/parser context used to classify the error.

status_word: Option<StatusWord>

Original status when the failure came from a card status word.

application_status: Option<u8>

Applet-level non-ISO status byte reported in the response payload (e.g. the CTAP status byte), when the failure came from such a status. Distinct from status_word, which is always an ISO 7816 SW1-SW2.

reference: Option<SecretReference>

Credential reference when known; absent for non-authentication failures.

retries_remaining: Option<u8>

Retry count from an authentication 63Cx status; absent when not reported.

Implementations

impl Error

pub fn new(kind: ErrorKind) -> Self

Construct a failure in Construction phase with no card status or credential.

pub fn at(self, phase: Phase) -> Self

Replace the phase while retaining all other error details.

pub fn status( sw: StatusWord, phase: Phase, reference: Option<SecretReference>, ) -> Self

Classify a card status using its phase and optional credential reference.

SELECT 6A82/6A88 maps to UnsupportedDevice; elsewhere it maps to NotFound. 63Cx is AuthenticationFailed only with a credential reference. Unknown statuses remain UnexpectedStatusWord with their raw value. This function is for failure paths: even 9000 maps to UnexpectedStatusWord here.

Trait Implementations

impl Clone for Error

fn clone(&self) -> Error

Returns a duplicate of the value.

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

Performs copy-assignment from source.

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 Eq for Error

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

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for Error