Enum SealError 

pub enum SealError {
    Locked,
    Custody(KeyError),
    UnknownVersion(u8),
    UnknownKey(String),
    Crypto(EncryptionError),
}

Why sealing or opening a host’s app-data failed.

Sealing can only fail before the cipher runs — the store has no master key to seal under. Opening adds the failures a stored payload can carry: a version this build does not read, a generation this keyring holds no key for, or an AEAD rejection (a wrong aad, a tampered or truncated payload).

Variants

Locked

Custody unlocked no keyring: the store is locked, or a master key was never established. The app-data counterpart of the sync engine’s master-key gate — unlock returning None is refused here, never treated as an empty keyring to seal under.

Custody(KeyError)

Custody could not produce the keyring — a wrong passphrase, an unreadable backing store. Distinct from Self::Locked, which is a legitimate absence rather than a failure.

UnknownVersion(u8)

The payload’s leading version byte is not one this build seals or reads.

UnknownKey(String)

The payload names a key (by fingerprint) this keyring does not hold: the keyring predates the payload, or the payload was sealed under a foreign one.

Crypto(EncryptionError)

The AEAD rejected the payload — a wrong aad, or a tampered or truncated ciphertext. Surfaced as it happened, never masked.

Trait Implementations

impl Debug for SealError

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

Formats the value using the given formatter.

impl Display for SealError

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

Formats the value using the given formatter.

impl Error for SealError

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<EncryptionError> for SealError

fn from(source: EncryptionError) -> Self

Converts to this type from the input type.

impl From<KeyError> for SealError

fn from(source: KeyError) -> Self

Converts to this type from the input type.