Enum MppError 

pub enum MppError {
    AmountExceedsMax {
        required: u128,
        max: u128,
    },
    InvalidAmount(String),
    InvalidConfig(String),
    Http(String),
    ChainIdMismatch {
        expected: u64,
        got: u64,
    },
    Json(Error),
    UnsupportedPaymentMethod(String),
    MissingHeader(String),
    InvalidBase64Url(String),
    MalformedCredential(Option<String>),
    InvalidChallenge {
        id: Option<String>,
        reason: Option<String>,
    },
    VerificationFailed(Option<String>),
    PaymentExpired(Option<String>),
    PaymentRequired {
        realm: Option<String>,
        description: Option<String>,
    },
    InvalidPayload(Option<String>),
    BadRequest(Option<String>),
    InsufficientBalance(Option<String>),
    InvalidSignature(Option<String>),
    SignerMismatch(Option<String>),
    AmountExceedsDeposit(Option<String>),
    DeltaTooSmall(Option<String>),
    ChannelNotFound(Option<String>),
    ChannelClosed(Option<String>),
    Io(Error),
    InvalidUtf8(FromUtf8Error),
    SystemTime(SystemTimeError),
}

Variants

AmountExceedsMax

Required amount exceeds user’s maximum allowed

Fields

required: u128

max: u128

InvalidAmount(String)

Invalid amount format

InvalidConfig(String)

Configuration is invalid

Http(String)

HTTP request/response error

ChainIdMismatch

Chain ID mismatch between challenge and provider

Fields

expected: u64

got: u64

Json(Error)

JSON serialization/deserialization error

UnsupportedPaymentMethod(String)

Unsupported payment method

MissingHeader(String)

Missing required header

InvalidBase64Url(String)

Invalid base64url encoding

MalformedCredential(Option<String>)

Credential is malformed (invalid base64url, bad JSON structure).

InvalidChallenge

Challenge ID is unknown, expired, or already used.

Fields

id: Option<String>

reason: Option<String>

VerificationFailed(Option<String>)

Payment proof is invalid or verification failed.

PaymentExpired(Option<String>)

Payment has expired.

PaymentRequired

No credential was provided but payment is required.

Fields

realm: Option<String>

description: Option<String>

InvalidPayload(Option<String>)

Credential payload does not match the expected schema.

BadRequest(Option<String>)

Request is malformed or contains invalid parameters.

InsufficientBalance(Option<String>)

Insufficient balance in payment channel.

InvalidSignature(Option<String>)

Invalid cryptographic signature.

SignerMismatch(Option<String>)

Signer does not match expected address.

AmountExceedsDeposit(Option<String>)

Voucher amount exceeds channel deposit.

DeltaTooSmall(Option<String>)

Voucher delta is below the minimum threshold.

ChannelNotFound(Option<String>)

Payment channel not found.

ChannelClosed(Option<String>)

Payment channel has been closed.

Io(Error)

IO error

InvalidUtf8(FromUtf8Error)

Invalid UTF-8 in response

SystemTime(SystemTimeError)

System time error

Implementations

impl MppError

pub fn unsupported_method(method: &impl Display) -> Self

Create an unsupported payment method error

pub fn malformed_credential(reason: impl Into<String>) -> Self

Create a malformed credential error.

pub fn malformed_credential_default() -> Self

Create a malformed credential error without a reason.

pub fn invalid_challenge_id(id: impl Into<String>) -> Self

Create an invalid challenge error with ID.

pub fn invalid_challenge_reason(reason: impl Into<String>) -> Self

Create an invalid challenge error with reason.

pub fn invalid_challenge( id: impl Into<String>, reason: impl Into<String>, ) -> Self

Create an invalid challenge error with ID and reason.

pub fn invalid_challenge_default() -> Self

Create an invalid challenge error without details.

pub fn verification_failed(reason: impl Into<String>) -> Self

Create a verification failed error.

pub fn verification_failed_default() -> Self

Create a verification failed error without a reason.

pub fn payment_expired(expires: impl Into<String>) -> Self

Create a payment expired error with expiration timestamp.

pub fn payment_expired_default() -> Self

Create a payment expired error without timestamp.

pub fn payment_required_realm(realm: impl Into<String>) -> Self

Create a payment required error with realm.

pub fn payment_required_description(description: impl Into<String>) -> Self

Create a payment required error with description.

pub fn payment_required( realm: impl Into<String>, description: impl Into<String>, ) -> Self

Create a payment required error with realm and description.

pub fn payment_required_default() -> Self

Create a payment required error without details.

pub fn invalid_payload(reason: impl Into<String>) -> Self

Create an invalid payload error.

pub fn invalid_payload_default() -> Self

Create an invalid payload error without a reason.

pub fn bad_request(reason: impl Into<String>) -> Self

Create a bad request error.

pub fn bad_request_default() -> Self

Create a bad request error without a reason.

pub fn problem_type_suffix(&self) -> Option<&'static str>

Returns the RFC 9457 problem type suffix if this is a payment problem.

pub fn is_payment_problem(&self) -> bool

Returns true if this error is an RFC 9457 payment problem.

Trait Implementations

impl Debug for MppError

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

Formats the value using the given formatter.

impl Display for MppError

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

Formats the value using the given formatter.

impl Error for MppError

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 MppError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for MppError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<FromUtf8Error> for MppError

fn from(source: FromUtf8Error) -> Self

Converts to this type from the input type.

impl From<SystemTimeError> for MppError

fn from(source: SystemTimeError) -> Self

Converts to this type from the input type.

impl PaymentError for MppError

fn to_problem_details(&self, challenge_id: Option<&str>) -> PaymentErrorDetails

Convert this error to RFC 9457 Problem Details format.