Struct X402Layer 

pub struct X402Layer<TSource> { /* private fields */ }

Available on crate feature server only.

Tower layer produced by super::X402Middleware::with_price_tag.

Implementations

impl X402Layer<StaticPriceTags>

pub fn with_price_tag(self, price_tag: PriceTag) -> Result<Self, BuildError>

Adds another static payment option.

Errors

BuildError when the appended tag (or the existing list with the current settlement mode) is invalid.

pub fn with_settlement_mode( self, mode: SettlementMode, ) -> Result<Self, BuildError>

After-handler settle scheduler for the authorization payment flow.

Not a paymentFlow. Sequential (default) is spec authorization: settle after the handler, then attach Payment-Response. Concurrent overlaps that settle with the handler and still waits. Background does not wait and does not attach a receipt. Concurrent and Background are illegal with upfront / escrow.

Errors

BuildError::Mode when mode is incompatible with a static tag’s flow.

pub fn with_siwx(self, gate: SiwxGate) -> Result<Self, BuildError>

Available on crate feature siwx only.

Enables SIWX access-grant and 402 challenges on this route.

Errors

BuildError::EmptyPriceTags when this replacement is not auth-only and the static tag list is empty.

pub fn with_auth_only(self, gate: SiwxGate) -> Result<Self, BuildError>

Available on crate feature siwx only.

Enables SIWX with auth-only access-grant on this route.

Errors

BuildError from static re-validation after the replacement.

impl X402Layer<DynamicPriceTags>

pub fn with_settlement_mode( self, mode: SettlementMode, ) -> Result<Self, BuildError>

After-handler settle scheduler for the authorization payment flow.

Same semantics as X402Layer<StaticPriceTags>::with_settlement_mode. Dynamic tags are resolved per request; incompatible upfront / escrow combinations fail at request time, not here.

Errors

Always Ok after storing mode.

pub fn with_siwx(self, gate: SiwxGate) -> Self

Available on crate feature siwx only.

Enables SIWX access-grant and 402 challenges on this route.

pub fn with_auth_only(self, gate: SiwxGate) -> Self

Available on crate feature siwx only.

Enables SIWX with auth-only access-grant on this route.

impl<TSource> X402Layer<TSource>

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

Registers a scheme/network adapter on the owned resource server.

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

Registers a protocol extension advertised on 402 responses.

pub fn with_description(self, description: String) -> Self

Description copied onto 402 resource.description.

pub fn with_mime_type(self, mime: String) -> Self

MIME type copied onto 402 resource.mimeType.

pub fn with_resource(self, resource: Url) -> Self

Pins ResourceInfo.url for this route. Does not waive base_url.

pub fn with_settlement_tracker( self, tracker: BackgroundSettlementTracker, ) -> Self

In-flight counter for SettlementMode::Background settle tasks.

pub fn with_hooks<H>(self, hooks: H) -> Self

where H: GateHooks + 'static,

HTTP-layer hooks (GrantAccess slot).

Trait Implementations

impl<TSource: Clone> Clone for X402Layer<TSource>

fn clone(&self) -> X402Layer<TSource>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<TSource: Debug> Debug for X402Layer<TSource>

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

Formats the value using the given formatter.

impl<S, TSource> Layer<S> for X402Layer<TSource>

where S: Service<Request, Response = Response, Error = Infallible> + Clone + Send + Sync + 'static, S::Future: Send + 'static, TSource: PriceTagSource,

type Service = X402MiddlewareService<TSource>

The wrapped service

fn layer(&self, inner: S) -> Self::Service

Wrap the given service with the middleware, returning a new service that has been decorated with the middleware.