Enum VerifyResponse 

#[non_exhaustive]
pub enum VerifyResponse {
    Valid {
        payer: CompactString,
        extensions: Extensions,
    },
    Invalid {
        reason: ErrorReason,
        message: Option<CompactString>,
        payer: Option<CompactString>,
        extensions: Extensions,
    },
}

Verification outcome returned by a facilitator.

Serialised as a flat boolean-discriminated JSON object (matching the x402 wire format). Consumers get a safe, pattern-matchable Rust enum.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Valid

Payload passed all verification checks.

Fields

payer: CompactString

Address of the verified payer.

extensions: Extensions

Facilitator-attached extension data.

Invalid

Payload was well-formed but failed verification.

Fields

reason: ErrorReason

Wire-level reason code.

message: Option<CompactString>

Optional human-readable message.

payer: Option<CompactString>

Optional payer address if identifiable from the payload.

extensions: Extensions

Facilitator-attached extension data.

Implementations

impl VerifyResponse

pub fn valid(payer: impl Into<CompactString>) -> Self

Convenience: constructs a Valid response with no extensions.

pub fn invalid(payer: Option<CompactString>, reason: ErrorReason) -> Self

Convenience: constructs an Invalid response without a human message.

pub fn invalid_with_message( payer: Option<CompactString>, reason: ErrorReason, message: impl Into<CompactString>, ) -> Self

Convenience: constructs an Invalid response with a message.

pub const fn is_valid(&self) -> bool

Returns true for Valid outcomes.

pub fn from_facilitator_error(error: &FacilitatorError) -> Self

Converts a FacilitatorError into an Invalid response for the HTTP boundary, preserving the structured reason code.

Trait Implementations

impl Clone for VerifyResponse

fn clone(&self) -> VerifyResponse

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for VerifyResponse

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for VerifyResponse

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for VerifyResponse

impl PartialEq for VerifyResponse

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for VerifyResponse

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 VerifyResponse