Enum SignerError 

pub enum SignerError {
    Lwk(String),
    LwkDetailed {
        operation: String,
        context: String,
        error_message: String,
    },
    InvalidMnemonic(String),
    HexParse(FromHexError),
    HexParseDetailed {
        parsing_context: String,
        hex_preview: String,
        hex_error: String,
    },
    InvalidTransaction(String),
    InvalidTransactionDetailed {
        txid: String,
        validation_details: String,
        error_message: String,
    },
    Network(Error),
    Serialization(Error),
    SerializationDetailed {
        operation: String,
        data_type: String,
        context: String,
        serde_error: String,
    },
    FileIo(Error),
}

Comprehensive error types for signer operations

This enum covers all possible error scenarios that can occur during transaction signing operations, providing detailed context for debugging and proper error handling in client applications.

Variants

Lwk(String)

LWK-specific errors from the Liquid Wallet Kit

This variant captures errors from LWK operations including:

• SwSigner creation failures
• Transaction signing failures
• PSET (Partially Signed Element Transaction) operations
• Key derivation and cryptographic operations

LwkDetailed

Fields

operation: String

The LWK operation that failed (e.g., “sign_transaction”, “create_signer”)

context: String

Additional context about the operation

error_message: String

The error message from LWK

InvalidMnemonic(String)

Invalid mnemonic phrase errors

This variant captures mnemonic-related errors including:

• Invalid word count (not 12, 15, 18, 21, or 24 words)
• Invalid characters or formatting
• BIP39 checksum validation failures
• Empty or malformed mnemonic phrases

HexParse(FromHexError)

Hex string parsing and decoding errors

This variant captures errors when parsing hex-encoded data including:

• Invalid hex characters
• Odd-length hex strings
• Empty hex strings
• Malformed transaction hex data

HexParseDetailed

Fields

parsing_context: String

Context about what was being parsed

hex_preview: String

Preview of the hex string that failed to parse

hex_error: String

The original hex parsing error

InvalidTransaction(String)

Invalid transaction structure or content errors

This variant captures transaction validation errors including:

• Malformed transaction structure
• Missing inputs or outputs
• Invalid transaction serialization
• PSET conversion failures
• Transaction size or format issues

InvalidTransactionDetailed

Fields

txid: String

The transaction ID if available

validation_details: String

Specific validation failure details

error_message: String

The error message

Network(Error)

Network-related communication errors

This variant captures network errors that may occur during remote operations or API calls (reserved for future use).

Serialization(Error)

JSON serialization and deserialization errors

This variant captures JSON processing errors including:

• Mnemonic file parsing failures
• Invalid JSON structure in storage files
• Serialization failures when writing storage

SerializationDetailed

Fields

operation: String

The serialization operation (serialize/deserialize)

data_type: String

The data type being processed

context: String

Additional context about the operation

serde_error: String

The original serde error message

FileIo(Error)

File system I/O operation errors

This variant captures file operation errors including:

• Mnemonic file read/write failures
• Permission denied errors
• Disk space or filesystem issues
• Atomic write operation failures

Trait Implementations

impl Debug for SignerError

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

Formats the value using the given formatter.

impl Display for SignerError

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

Formats the value using the given formatter.

impl Error for SignerError

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 SignerError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for SignerError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for SignerError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for SignerError

Convert BIP39 mnemonic errors to SignerError

This conversion handles all BIP39-related errors including:

• Invalid word count
• Invalid words not in BIP39 wordlist
• Checksum validation failures
• Language detection issues

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for SignerError

Convert Elements transaction encoding errors to SignerError

This conversion handles transaction serialization/deserialization errors from the Elements library including:

• Consensus encoding failures
• Invalid transaction structure
• Serialization format errors

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<FromHexError> for SignerError

fn from(source: FromHexError) -> Self

Converts to this type from the input type.

impl From<SignerError> for AmpError

fn from(source: SignerError) -> Self

Converts to this type from the input type.