Enum WalletError 

pub enum WalletError {
    Internal(String),
    InvalidParameter {
        parameter: String,
        must_be: String,
    },
    NotImplemented(String),
    BadRequest(String),
    Unauthorized(String),
    NotActive(String),
    InvalidOperation(String),
    MissingParameter(String),
    InsufficientFunds {
        message: String,
        total_satoshis_needed: i64,
        more_satoshis_needed: i64,
    },
    BroadcastUnavailable,
    NetworkChain(String),
    InvalidPublicKey {
        message: String,
        key: String,
    },
    ReviewActions {
        message: String,
        review_action_results: Vec<ReviewActionResult>,
        send_with_results: Vec<SendWithResult>,
        txid: Option<String>,
        tx: Option<Vec<u8>>,
        no_send_change: Vec<OutpointString>,
    },
    InvalidMerkleRoot {
        message: String,
        block_hash: String,
        block_height: u32,
        merkle_root: String,
        txid: Option<String>,
    },
    Sqlx(Error),
    Io(Error),
    SerdeJson(Error),
}

Unified error type for all wallet operations.

Each variant maps to a WERR error code from the TypeScript wallet-toolbox. Display output always includes the WERR prefix (e.g., “WERR_INTERNAL: description”).

Variants

Internal(String)

An internal error with a descriptive message.

InvalidParameter

A parameter has an invalid value.

Fields

parameter: String

The name of the invalid parameter.

must_be: String

Description of the valid value constraint.

NotImplemented(String)

The requested operation is not yet implemented.

BadRequest(String)

The request was malformed or invalid.

Unauthorized(String)

The caller is not authenticated or authorized.

NotActive(String)

The wallet or resource is not in an active state.

InvalidOperation(String)

The operation is not valid in the current state.

MissingParameter(String)

A required parameter was not provided.

InsufficientFunds

The wallet does not have enough funds for the operation.

Fields

message: String

Human-readable description of the shortfall.

total_satoshis_needed: i64

Total satoshis required for the operation.

more_satoshis_needed: i64

Additional satoshis needed beyond available balance.

BroadcastUnavailable

No broadcast service is currently available.

NetworkChain(String)

A network or chain-related error occurred.

InvalidPublicKey

A public key value is invalid.

Fields

message: String

Description of why the key is invalid.

key: String

The invalid key value.

ReviewActions

Undelayed broadcast results require review (code=5).

Fields

message: String

Human-readable message describing the review requirement.

review_action_results: Vec<ReviewActionResult>

Results from the undelayed broadcast review.

send_with_results: Vec<SendWithResult>

Results from batch sending.

txid: Option<String>

The transaction ID, if available.

tx: Option<Vec<u8>>

The raw transaction bytes, if available.

no_send_change: Vec<OutpointString>

Outpoints of change outputs for noSend transactions.

InvalidMerkleRoot

Invalid merkle root detected during chain validation (code=8).

Fields

message: String

Human-readable message describing the invalid merkle root.

block_hash: String

The hash of the block with the invalid merkle root.

block_height: u32

The height of the block with the invalid merkle root.

merkle_root: String

The invalid merkle root value.

txid: Option<String>

The transaction ID involved, if available.

Sqlx(Error)

A database error from sqlx.

Io(Error)

An I/O error.

SerdeJson(Error)

A JSON serialization/deserialization error.

Implementations

impl WalletError

pub fn code(&self) -> &'static str

Returns the WERR string code for wire serialization.

pub fn to_wallet_error_object(&self) -> WalletErrorObject

Converts this error into a WalletErrorObject suitable for JSON wire format.

This matches the TypeScript WalletError.toJson() output format.

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.

impl From<Error> for WalletError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for WalletError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for WalletError

fn from(source: Error) -> Self

Converts to this type from the input type.