Struct Payment 

pub struct Payment<S> { /* private fields */ }

A payment moving through the verify → settle lifecycle.

The type parameter S tracks the current state at compile time. The struct is transparent (zero overhead) around the underlying request.

Implementations

impl<S> Payment<S>

pub const fn request(&self) -> &VerifyRequest

Returns a reference to the wire-level verify request this payment was constructed from.

impl Payment<Unverified>

pub const fn new(request: VerifyRequest) -> Self

Wraps a raw verify request as an unverified payment.

pub async fn verify<F: Facilitator>( self, facilitator: &F, request: VerifyRequest, ) -> Result<(Payment<Verified>, VerifyResponse), FacilitatorError>

Runs facilitator verification.

On success, returns the verified payment together with the facilitator’s VerifyResponse. On failure, the payment is consumed and a FacilitatorError is returned.

Errors

Propagates any FacilitatorError raised by the underlying facilitator. A Valid verification that returns VerifyResponse::Invalid is surfaced as Err(FacilitatorError::Verification(VerificationError::InvalidFormat)).

impl Payment<Verified>

pub async fn settle<F: Facilitator>( self, facilitator: &F, request: SettleRequest, ) -> Result<(Payment<Settled>, SettleResponse), FacilitatorError>

Runs facilitator settlement on a previously verified payment.

Errors

Propagates any FacilitatorError raised by the facilitator; a SettleResponse::Failure is surfaced as Err(FacilitatorError::Onchain(...)).

impl Payment<Settled>

pub fn into_request(self) -> VerifyRequest

Extracts the underlying wire-level request.

Trait Implementations

impl<S: Clone> Clone for Payment<S>

fn clone(&self) -> Payment<S>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<S: Debug> Debug for Payment<S>

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

Formats the value using the given formatter.