Enum WalletError 

#[non_exhaustive]
pub enum WalletError {
    FileMissing(String),
    Io {
        path: String,
        source: Error,
    },
    Pem(String),
    NoCertificates,
    Sso(String),
    SsoNotEnabled,
    Pkcs12(String),
    KeyDecrypt(String),
    PasswordRequired {
        format: &'static str,
    },
    UnsupportedFormat {
        format: &'static str,
    },
}

Errors raised while resolving or reading a wallet.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

FileMissing(String)

The wallet directory did not contain the expected file.

Io

An I/O error occurred reading the wallet.

Fields

path: String

source: Error

Pem(String)

The PEM content could not be parsed.

NoCertificates

The wallet contained no usable trust-anchor certificates.

Sso(String)

SSO (cwallet.sso) outer-container parsing failure.

SsoNotEnabled

Historical: SSO support compiled out. No longer returned as of 0.7.x (the cwallet.sso reader is always available); the variant is kept so existing match arms keep compiling.

Pkcs12(String)

PKCS#12 (ewallet.p12, or the PKCS#12 embedded in cwallet.sso) parsing or decryption failure. The message names OIDs/structures only — never paths or passwords.

KeyDecrypt(String)

An encrypted private key could not be decrypted (wrong wallet password, or an unsupported encryption scheme — only PKCS#8 PBES2 with PBKDF2-HMAC-SHA1/SHA256 + AES-CBC is supported).

PasswordRequired

The wallet (or its private key) is encrypted and requires a wallet password, but none was supplied. Machine-classifiable remediation: supply wallet_password, or use an auto-login cwallet.sso / unencrypted ewallet.pem wallet.

Fields

format: &'static str

UnsupportedFormat

A recognized wallet file is present but this thin build does not support the format.

Fields

format: &'static str

Trait Implementations

impl Debug for WalletError

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

Formats the value using the given formatter.

impl Display for WalletError

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

Formats the value using the given formatter.

impl Error for WalletError

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.