Enum SafeError 

pub enum SafeError {
    VaultNotFound {
        path: String,
    },
    VaultAlreadyExists {
        path: String,
    },
    SecretNotFound {
        key: String,
    },
    SecretAlreadyExists {
        key: String,
    },
    ProfileNotFound {
        name: String,
    },
    DecryptionFailed,
    Crypto {
        context: String,
    },
    InvalidVault {
        reason: String,
    },
    ImportParse {
        file: String,
        reason: String,
    },
    NoSnapshotAvailable {
        profile: String,
    },
    SnapshotNotFound {
        path: String,
    },
    MigrationFailed {
        reason: String,
    },
    VaultCorrupted {
        reason: String,
    },
    StaleBiometricCredential,
    BiometricCanceled,
    BiometricFailed(String),
    Io(Error),
    Serialization(Error),
}

Top-level error type for all tsafe-core operations.

Variants

VaultNotFound

Fields

path: String

VaultAlreadyExists

Fields

path: String

SecretNotFound

Fields

key: String

SecretAlreadyExists

Fields

key: String

ProfileNotFound

Fields

name: String

DecryptionFailed

Crypto

Fields

context: String

InvalidVault

Fields

reason: String

ImportParse

Fields

file: String

reason: String

NoSnapshotAvailable

Fields

profile: String

SnapshotNotFound

Fields

path: String

MigrationFailed

Fields

reason: String

VaultCorrupted

Fields

reason: String

StaleBiometricCredential

The OS credential store entry for biometric/keyring unlock is stale.

This occurs when the vault password was rotated, a new fingerprint enrolled, or the biometric enrollment changed after tsafe biometric enable was run. The stored credential no longer matches — the user must re-enroll explicitly.

Callers MUST NOT silently fall through to another method. Surface this error with a clear message directing the user to tsafe biometric re-enroll.

BiometricCanceled

The Windows Hello verification dialog was dismissed by the user before completing. The vault unlock is not permitted; the caller must not fall through to another unlock method.

BiometricFailed(String)

A Windows Hello verification attempt failed for a reason other than user cancellation (device not ready, OS error, etc.).

Io(Error)

Serialization(Error)

Trait Implementations

impl Debug for SafeError

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

Formats the value using the given formatter.

impl Display for SafeError

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

Formats the value using the given formatter.

impl Error for SafeError

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

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for SafeError

fn from(source: Error) -> Self

Converts to this type from the input type.