Struct ResourceServer 

pub struct ResourceServer { /* private fields */ }

Available on crate feature server only.

Server-side payment orchestrator.

Implementations

impl ResourceServer

pub async fn notify_verified_payment_canceled( &self, payload: &PaymentPayload<PaymentRequirements, Value>, requirements: &PaymentRequirements, reason: CancelReason, error: Option<&str>, response_status: Option<u16>, )

Fires on_verified_payment_canceled for every registered hook.

pub fn cancellation_guard( &self, payload: PaymentPayload<PaymentRequirements, Value>, requirements: PaymentRequirements, ) -> CancellationGuard

Builds a one-shot cancellation dispatcher (first call wins).

impl ResourceServer

pub fn find_matching_requirements<'a>( &self, available: &'a [PaymentRequirements], payload: &PaymentPayload<PaymentRequirements, Value>, ) -> Option<&'a PaymentRequirements>

First available accept that matches payload.accepted.

Scheme-declared crate::SchemeNetworkServer::dynamic_extra_fields are omitted from the extra-subset comparison.

impl ResourceServer

pub async fn create_payment_required_response( &self, accepts: Vec<PaymentRequirements>, ctx: PaymentRequiredBuildContext, ) -> Result<PaymentRequired, FacilitatorError>

One 402 body used for both unpaid challenges and paid matching.

After scheme enrich and extension advertise, each accept is resolved through the registered scheme table and written with apply_payment_flow_wire_extra. Unregistered schemes fail closed.

Errors

FacilitatorError::Internal when hook policy, unregistered scheme, or payment-flow resolution / wire extra application fails.

impl ResourceServer

pub fn new<F>(facilitator: Arc<F>) -> ResourceServer

where F: Facilitator + 'static,

Creates a resource server over any Facilitator.

pub fn from_dyn(facilitator: Arc<dyn DynFacilitator>) -> ResourceServer

Creates from an already-erased facilitator handle.

pub fn with_hook( self, hook: impl ResourceServerHooks + 'static, ) -> ResourceServer

Registers a lifecycle hook. Returns self for builder chaining.

pub fn add_hook(&mut self, hook: impl ResourceServerHooks + 'static)

Registers a lifecycle hook after construction.

pub fn hook_count(&self) -> usize

Number of registered resource-server hooks.

pub fn facilitator(&self) -> Arc<dyn DynFacilitator>

Returns a clone of the inner facilitator handle.

pub fn with_scheme( self, network: ChainIdPattern, scheme: impl SchemeNetworkServer + 'static, ) -> ResourceServer

Registers a scheme/network adapter. Returns self for builder chaining.

pub fn register_scheme( &mut self, network: ChainIdPattern, scheme: impl SchemeNetworkServer + 'static, )

Registers a scheme/network adapter after construction.

pub fn registered_scheme( &self, scheme: &str, network: &ChainId, ) -> Option<&dyn DynSchemeNetworkServer>

Registered adapter for scheme on network, if any.

Exact CAIP-2 registrations win over wildcard/set patterns.

pub fn get_payment_flow( &self, requirements: &PaymentRequirements, ) -> Result<PaymentFlowName, PaymentFlowError>

Resolves the payment-flow name for this accept from the scheme table.

Errors

PaymentFlowError::UnregisteredScheme when no adapter matches this accept, or ATM/flow errors from resolve_payment_flow.

pub async fn has_settle_on_cancel( &self, requirements: &PaymentRequirements, ) -> bool

Whether the registered scheme yields cancel-settle requirements.

Escrow accepts must return true before a transport will serve them.

pub fn with_extension( self, extension: impl Extension + 'static, ) -> ResourceServer

Registers a protocol extension advertised on 402 responses.

impl ResourceServer

pub async fn settle_payment( &self, payload: &PaymentPayload<PaymentRequirements, Value>, requirements: &PaymentRequirements, overrides: Option<&SettlementOverrides>, phase: SettlePhase, resource_url: Option<&str>, advertised: Option<&Extensions>, ) -> Result<SettleResponse, FacilitatorError>

Optional amount overrides → before hooks → facilitator → after hooks.

Facilitator settle is attempted twice only when the first Ok result is settlement_pending with a non-empty transaction; no sleep.

Errors

Propagates facilitator / abort / invalid-override errors unless a failure hook recovers.

impl ResourceServer

pub async fn verify_payment( &self, payload: &PaymentPayload<PaymentRequirements, Value>, requirements: &PaymentRequirements, advertised: Option<&Extensions>, ) -> Result<VerifyPaymentOutcome, FacilitatorError>

Before hooks → facilitator → after hooks.

Every accept must have a registered crate::SchemeNetworkServer. Empty schemes is crate::PaymentFlowError::UnregisteredScheme, not an always-facilitator fallback. When the resolved flow has !verify_before_handler, returns Valid without the facilitator and without after_verify.

Errors

Propagates facilitator errors (unless recovered), before-hook aborts, after-verify aborts (FacilitatorError::Aborted), and payment-flow resolution failures.

Trait Implementations

impl Clone for ResourceServer

fn clone(&self) -> ResourceServer

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ResourceServer

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

Formats the value using the given formatter.