Enum CryptoError 

pub enum CryptoError {
    KeyNotSet,
    Keychain(String),
    InvalidFormat,
    InvalidNonce,
    Base64(DecodeError),
    InvalidStoredKey,
    EncryptionFailed,
    DecryptionFailed,
    InvalidUtf8,
}

Errors returned by this crate.

Notes:

• Decryption failures are intentionally generic (see CryptoError::DecryptionFailed) to avoid leaking details useful for oracle-style attacks.
• Some errors are “format” errors (bad input string), others are environment errors (keychain), and others are cryptographic failures (auth/tag mismatch).

Variants

KeyNotSet

The key does not exist in the OS keychain.

This is expected if you call decrypt / decrypt_bytes before any successful call to encrypt / encrypt_bytes (or before init_keychain_key).

Keychain(String)

A keychain operation failed (read/write/permission/backing service failure).

InvalidFormat

The encrypted payload string was not in a recognized format.

Expected:

• v1:nonce:ciphertext (current)
• nonce:ciphertext (legacy)

InvalidNonce

The decoded nonce length was not 12 bytes (AES-GCM standard).

Base64(DecodeError)

Base64 decoding failed.

InvalidStoredKey

The stored key existed but was not the correct size (must be 32 bytes after decoding).

This can happen if the keychain entry is corrupted or replaced.

EncryptionFailed

Encryption failed.

In practice this is rare and usually indicates an internal library failure.

DecryptionFailed

Decryption failed.

This occurs when:

• the wrong key is used,
• the ciphertext is corrupted,
• the authentication tag does not verify,
• the AAD does not match.

InvalidUtf8

Decrypted bytes were not valid UTF-8 when calling decrypt.

Trait Implementations

impl Debug for CryptoError

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

Formats the value using the given formatter.

impl Display for CryptoError

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

Formats the value using the given formatter.

impl Error for CryptoError

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<DecodeError> for CryptoError

fn from(source: DecodeError) -> Self

Converts to this type from the input type.