Enum SettlementMode 

pub enum SettlementMode {
    Sequential,
    Concurrent,
    Background,
}

Available on crate feature server only.

Controls when on-chain settlement executes relative to the inner service.

Variants

• Sequential (default): verify → execute → settle. Settlement only runs after the handler returns a successful response. This is the safest option — no settlement occurs on handler errors.

• Concurrent: verify → (settle ∥ execute) → await settle. Settlement is spawned immediately after verification and runs in parallel with the handler, reducing total request latency by one facilitator RTT. On handler error the settlement task is detached (fire-and-forget).

• Background: verify → spawn settle (fire-and-forget) → execute → return. Settlement runs entirely in the background — the response is returned to the client immediately after the handler completes, without waiting for settlement. Ideal for streaming responses (e.g. SSE / LLM token streams) where the client should start receiving data as soon as possible. Trade-off: the Payment-Response header is not attached since settlement may still be in progress when the response is sent.

Variants

Sequential

Settlement runs after the handler completes.

Concurrent

Settlement runs concurrently with the handler; response waits for settlement.

Background

Settlement is fire-and-forget; response is returned immediately.

Trait Implementations

impl Clone for SettlementMode

fn clone(&self) -> SettlementMode

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SettlementMode

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

Formats the value using the given formatter.

impl Default for SettlementMode

fn default() -> SettlementMode

Returns the “default value” for a type.

impl Hash for SettlementMode

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for SettlementMode

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for SettlementMode

impl Eq for SettlementMode

impl StructuralPartialEq for SettlementMode