Enum FfiError 

pub enum FfiError {
    Cdk {
        code: u32,
        error_message: String,
    },
    Internal {
        error_message: String,
    },
}

FFI Error type that wraps CDK errors for cross-language use

This simplified error type uses protocol-compliant error codes from ErrorCode in cdk-common, reducing duplication while providing structured error information to FFI consumers.

Variants

Cdk

CDK error with protocol-compliant error code The code corresponds to the Cashu protocol error codes (e.g., 11001, 20001, etc.)

Fields

code: u32

Error code from the Cashu protocol specification

error_message: String

Human-readable error message

Internal

Internal/infrastructure error (no protocol error code) Used for errors that don’t map to Cashu protocol codes

Fields

error_message: String

Human-readable error message

Implementations

impl FfiError

pub fn internal(msg: impl ToString) -> Self

Create an internal error from any type that implements ToString

pub fn database(msg: impl ToString) -> Self

Create a database error (uses Unknown code 50000)

Trait Implementations

impl<UT> ConvertError<UT> for FfiError

fn try_convert_unexpected_callback_error( e: UnexpectedUniFFICallbackError, ) -> Result<Self>

impl Debug for FfiError

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

Formats the value using the given formatter.

impl Display for FfiError

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

Formats the value using the given formatter.

impl Error for FfiError

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<UT> FfiConverter<UT> for FfiError

const TYPE_ID_META: MetadataBuffer

Type ID metadata, serialized into a MetadataBuffer.

type FfiType = RustBuffer

The low-level type used for passing values of this type over the FFI.

fn lower(v: Self) -> RustBuffer

Lower a rust value of the target type, into an FFI value of type Self::FfiType.

fn try_lift(buf: RustBuffer) -> Result<Self>

Lift a rust value of the target type, from an FFI value of type Self::FfiType.

fn write(obj: Self, buf: &mut Vec<u8>)

Write a rust value into a buffer, to send over the FFI in serialized form.

fn try_read(buf: &mut &[u8]) -> Result<Self>

Read a rust value from a buffer, received over the FFI in serialized form.

impl From<Error> for FfiError

fn from(err: CdkError) -> Self

Converts to this type from the input type.

impl From<Error> for FfiError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for FfiError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for FfiError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl<UT> Lift<UT> for FfiError

type FfiType = <FfiError as FfiConverter<UT>>::FfiType

fn try_lift(v: Self::FfiType) -> Result<Self>

fn try_read(buf: &mut &[u8]) -> Result<Self>

fn try_lift_from_rust_buffer(v: RustBuffer) -> Result<Self, Error>

Convenience method

impl<UT> LiftRef<UT> for FfiError

type LiftType = FfiError

impl<UT> LiftReturn<UT> for FfiError

type ReturnType = <FfiError as Lift<UT>>::FfiType

FFI return type for trait interfaces

fn try_lift_successful_return(v: Self::ReturnType) -> Result<Self>

Lift a successfully returned value from a trait interface

fn lift_foreign_return( ffi_return: Self::ReturnType, call_status: RustCallStatus, ) -> Self

Lift a foreign returned value from a trait interface

fn lift_error(_buf: RustBuffer) -> Self

Lift a Rust value for a callback interface method error result

fn handle_callback_unexpected_error(e: UnexpectedUniFFICallbackError) -> Self

Lift a Rust value for an unexpected callback interface error

impl<UT> Lower<UT> for FfiError

type FfiType = <FfiError as FfiConverter<UT>>::FfiType

fn lower(obj: Self) -> Self::FfiType

fn write(obj: Self, buf: &mut Vec<u8>)

fn lower_into_rust_buffer(obj: Self) -> RustBuffer

Convenience method

impl<UT> LowerError<UT> for FfiError

fn lower_error(obj: Self) -> RustBuffer

Lower this value for scaffolding function return

impl<UT> LowerReturn<UT> for FfiError

type ReturnType = <FfiError as Lower<UT>>::FfiType

The type that should be returned by scaffolding functions for this type.

fn lower_return(v: Self) -> Result<Self::ReturnType, RustCallError>

Lower the return value from an scaffolding call

fn handle_failed_lift( error: LiftArgsError, ) -> Result<Self::ReturnType, RustCallError>

Lower the return value for failed argument lifts

impl<UT> TypeId<UT> for FfiError

const TYPE_ID_META: MetadataBuffer