Enum ClientError 

pub enum ClientError {
    MissingUserPassword,
    Server(i32, String),
    Parse(String),
    Param(String),
    Body(String),
    Status(u16, String),
    MalformedResponse(String),
    Connection(String),
    Timeout,
    HttpRedirect(String),
    ReqBuilder(String),
    MaxRetriesExceeded(u8),
    Request(String),
    WrongNetworkAddress(Network),
    UnexpectedServerVersion(UnexpectedServerVersionError),
    Sign(SignRawTransactionWithWalletError),
    Xpriv,
    Other(String),
}

The error type for errors produced in this library.

Variants

MissingUserPassword

Missing username or password for the RPC server

Server(i32, String)

RPC server returned an error

Note

These errors are ABSOLUTELY UNDOCUMENTED. Check https://github.com/bitcoin/bitcoin/blob/96b0a8f858ab24f3672360b8c830553b963de726/src/rpc/protocol.h#L24 and good luck!

Parse(String)

Error parsing the RPC response, unlikely to be recoverable by retrying

Param(String)

Error creating the RPC request, retry might help

Body(String)

Body error, unlikely to be recoverable by retrying

Status(u16, String)

HTTP status error.

Server-side failures may be retriable, while client-side failures usually indicate configuration or authorization problems.

MalformedResponse(String)

Error decoding the response, retry might not help

Connection(String)

Connection error, retry might help

Timeout

Timeout error, retry might help

HttpRedirect(String)

Redirect error, not retryable

ReqBuilder(String)

Error building the request, unlikely to be recoverable

MaxRetriesExceeded(u8)

Maximum retries exceeded, not retryable

Request(String)

General request error, retry might help

WrongNetworkAddress(Network)

Wrong network address

UnexpectedServerVersion(UnexpectedServerVersionError)

Server version is unexpected or incompatible

Sign(SignRawTransactionWithWalletError)

Could not sign raw transaction

Xpriv

Could not get a Xpriv from the wallet

Other(String)

Unknown error, unlikely to be recoverable

Implementations

impl ClientError

pub fn is_tx_not_found(&self) -> bool

Returns true when the RPC server reports an invalid address, key, or missing transaction/block identifier (RPC_INVALID_ADDRESS_OR_KEY, code -5).

pub fn is_block_not_found(&self) -> bool

Returns true when the RPC server reports an invalid address, key, or missing transaction/block identifier (RPC_INVALID_ADDRESS_OR_KEY, code -5).

pub fn is_rpc_verify_error(&self) -> bool

Returns true when the RPC server reports a general transaction or block submission verification error (RPC_VERIFY_ERROR, code -25).

pub fn is_rpc_verify_rejected(&self) -> bool

Returns true when the RPC server reports a transaction or block rejected by network rules (RPC_VERIFY_REJECTED, code -26).

pub fn is_rpc_verify_already_in_utxo_set(&self) -> bool

Returns true when the RPC server reports a transaction already present in the UTXO set (RPC_VERIFY_ALREADY_IN_UTXO_SET, code -27).

pub fn is_retriable(&self) -> bool

Returns true when retrying the same RPC request may succeed later.

This classifies transport failures, timeouts, request-construction failures that can depend on transient client state, exhausted client-side retries, and HTTP 5xx responses as retriable. Bitcoin Core JSON-RPC server errors are operation-specific and return false; callers should handle those according to the RPC they invoked.

pub fn is_missing_or_invalid_input(&self) -> bool

👎Deprecated since 0.10.4:

use is_rpc_verify_error() to detect RPC_VERIFY_ERROR (-25)

Returns true when the RPC server reports missing or invalid transaction inputs (RPC_VERIFY_ERROR, code -25).

Trait Implementations

impl Clone for ClientError

fn clone(&self) -> ClientError

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ClientError

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ClientError

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for ClientError

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

Formats the value using the given formatter.

impl Error for ClientError

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<BitcoinRpcError> for ClientError

fn from(value: BitcoinRpcError) -> Self

Converts to this type from the input type.

impl From<Error> for ClientError

fn from(value: BitreqError) -> Self

Converts to this type from the input type.

impl From<Error> for ClientError

fn from(value: SerdeJsonError) -> Self

Converts to this type from the input type.

impl From<SignRawTransactionWithWalletError> for ClientError

fn from(source: SignRawTransactionWithWalletError) -> Self

Converts to this type from the input type.

impl From<UnexpectedServerVersionError> for ClientError

fn from(source: UnexpectedServerVersionError) -> Self

Converts to this type from the input type.

impl PartialEq for ClientError

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for ClientError

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ClientError