Enum Error 

pub enum Error {
    Encrypt(EncryptError),
    Decrypt(DecryptError),
}

The universal error type for this crate.

This enum represents every possible error that a function in this library can return. It is a thin wrapper around the domain‑specific error types:

• EncryptError for encryption‑related failures.
• DecryptError for decryption‑related failures.

The #[from] attribute generates From<EncryptError> and From<DecryptError> implementations, so conversions are automatic (see module documentation for details). This keeps the public API clean – all functions return a single error type, yet callers can still inspect the underlying cause.

Display format

Each variant prefixes the error message with the domain:

Encrypt error: Invalid recipient 'abc': reason
Decrypt error: Invalid identity: something

Example of error propagation with ?

use age_crypto::{encrypt_with_passphrase, Error};

fn safe_encrypt(plaintext: &[u8], passphrase: &str) -> Result<Vec<u8>, Error> {
    // encrypt_with_passphrase already returns Result<_, Error>
    // so we can use `?` directly for propagation
    let encrypted = encrypt_with_passphrase(plaintext, passphrase)?;
    Ok(encrypted.as_bytes().to_vec())
}

Variants

Encrypt(EncryptError)

An encryption‑related error occurred.

The inner EncryptError provides detailed information about missing recipients, invalid keys, or internal failures.

Decrypt(DecryptError)

A decryption‑related error occurred.

The inner DecryptError provides detailed information about invalid identities, broken ciphertext, or decryption mismatches.

Trait Implementations

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 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 From<DecryptError> for Error

fn from(source: DecryptError) -> Self

Converts to this type from the input type.

impl From<EncryptError> for Error

fn from(source: EncryptError) -> Self

Converts to this type from the input type.