Enum DeviceError 

#[non_exhaustive]
pub enum DeviceError {
    NotConnected,
    ActionCancelled,
    PinRequired,
    InvalidPin,
    PinCancelled,
    PassphraseRequired,
    PassphraseCancelled,
    InvalidState,
    NotInitialized,
    FirmwareUpdateRequired,
    SeedNotBackedUp,
    NotSupported(String),
    Failure {
        code: Option<i32>,
        message: String,
    },
    DeviceError {
        code: i32,
        message: String,
    },
    ButtonRequest(String),
    ProtobufDecode(String),
    InvalidInput(String),
}

Device errors returned by the Trezor.

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.

NotConnected

Device not connected or session not acquired

ActionCancelled

Action cancelled on device

PinRequired

PIN is required

InvalidPin

Invalid PIN entered

PinCancelled

PIN entry cancelled

PassphraseRequired

Passphrase is required

PassphraseCancelled

Passphrase entry cancelled

InvalidState

The device’s derived session state did not match the expected state, i.e. a different passphrase was entered than the one that created the remembered wallet. Mirrors trezor-suite’s Device_InvalidState.

NotInitialized

Device is not initialized

FirmwareUpdateRequired

Device needs firmware update

SeedNotBackedUp

Seed is not backed up

NotSupported(String)

Feature not supported

Failure

Device returned failure

Fields

code: Option<i32>

message: String

DeviceError

Device returned error response

Fields

code: i32

message: String

ButtonRequest(String)

Button request (informational)

ProtobufDecode(String)

Protobuf decode error

InvalidInput(String)

Invalid input

Implementations

impl DeviceError

pub fn from_failure(code: Option<i32>, message: String) -> Self

Map a Trezor protocol Failure (a FailureType code plus message) into a typed DeviceError. Known PIN/action codes become their typed variants so callers (and downstream FFI consumers) can react to a wrong PIN, a cancelled PIN entry, etc.; unknown codes fall back to the generic DeviceError so existing behavior is preserved.

Codes match FailureType in proto/messages-common.proto.

Trait Implementations

impl Debug for DeviceError

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

Formats the value using the given formatter.

impl Display for DeviceError

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

Formats the value using the given formatter.

impl Error for DeviceError

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<DeviceError> for TrezorError

fn from(source: DeviceError) -> Self

Converts to this type from the input type.