Enum WireError 

pub enum WireError {
    NotAnEncryptedLeaf,
    Base64 {
        field: &'static str,
    },
    UnknownDatatype(String),
    AeadOpen,
    DatatypeMismatch {
        ty: &'static str,
    },
    DataKeyLength(usize),
    MacMismatch,
    MacUndecryptable,
    NonStringKey,
    BadSelectorRegex {
        pattern: String,
        reason: String,
    },
    SelfDefeatingCommentRegex,
    Randomness(String),
}

Everything that can go wrong inside the wire border.

Note what is absent: there is no Other(String) arm and no #[from] anyhow::Error. A new failure mode has to be named here, which is what keeps a caller’s match honest.

Variants

NotAnEncryptedLeaf

The value is not in ENC[AES256_GCM,…] form at all.

Base64

One of the three base64 fields did not decode.

Fields

field: &'static str

UnknownDatatype(String)

The type: tag is not one sops can produce or consume.

AeadOpen

AES-GCM refused to open the leaf. Deliberately carries no detail: the distinction between “wrong key” and “tampered bytes” is exactly the oracle an attacker wants.

DatatypeMismatch

The recovered bytes are not a valid rendering of the declared type.

Fields

ty: &'static str

DataKeyLength(usize)

The data key is not 32 bytes.

MacMismatch

The MAC recorded in the file does not match the recomputed one.

MacUndecryptable

The MAC field itself would not decrypt, which usually means the data key is wrong or lastmodified was edited by hand.

NonStringKey

A mapping key was not a string. sops cannot represent one.

BadSelectorRegex

A selector regex from the metadata did not compile.

Fields

pattern: String

reason: String

SelfDefeatingCommentRegex

An encrypted comment would match unencrypted_comment_regex, which would make the file permanently undecryptable. Upstream refuses too.

Randomness(String)

No randomness available for an IV.

Trait Implementations

impl Debug for WireError

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

Formats the value using the given formatter.

impl Display for WireError

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

Formats the value using the given formatter.

impl Eq for WireError

impl Error for WireError

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 PartialEq for WireError

fn eq(&self, other: &WireError) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for WireError