@routedock/routedock 0.3.0 → 0.4.0

package/dist/{routedockMiddleware-57gUaEMf.d.ts → routedockMiddleware-Cq9HOJEa.d.ts}

@@ -1,6 +1,7 @@
 import { RequestHandler } from 'express';
-import { P as PaymentMode, h as RouteDockManifest, g as RouteDockLogger } from './logger-D8_Q2ytp.js';
-import { O as OrphanedSessionInfo, S as SeenTxStore } from './MppSessionHandler-Bq4S-JTE.js';
+import { P as PaymentMode, R as RouteDockManifest } from './types-DXaS5Wip.js';
+import { O as OrphanedSessionInfo, S as SeenTxStore, V as VaultSettlementConfig } from './MppSessionHandler-3QfCHI5x.js';
+import { b as RouteDockLogger } from './logger-DVa7VT4c.js';
 
 interface RouteDockMiddlewareOptions {
     modes: PaymentMode[];
@@ -58,6 +59,12 @@ interface RouteDockMiddlewareOptions {
      * callback failures, orphaned sessions). Defaults to a console-backed logger.
      */
     logger?: RouteDockLogger;
+    /**
+     * Record `session_settled` on the agent vault after each clean mpp-session
+     * close. Falls back to the deprecated `AGENT_VAULT_CONTRACT`/
+     * `AGENT_VAULT_CONTRACT_ID` env vars when unset.
+     */
+    vaultSettlement?: VaultSettlementConfig;
 }
 declare function routedock(opts: RouteDockMiddlewareOptions): RequestHandler;
 

package/dist/{routedockMiddleware-DlyLrxp7.d.cts → routedockMiddleware-CxsWkSKa.d.cts}

@@ -1,6 +1,7 @@
 import { RequestHandler } from 'express';
-import { P as PaymentMode, h as RouteDockManifest, g as RouteDockLogger } from './logger-D8_Q2ytp.cjs';
-import { O as OrphanedSessionInfo, S as SeenTxStore } from './MppSessionHandler-1EL8QBAn.cjs';
+import { P as PaymentMode, R as RouteDockManifest } from './types-DXaS5Wip.cjs';
+import { O as OrphanedSessionInfo, S as SeenTxStore, V as VaultSettlementConfig } from './MppSessionHandler-xu4Kxu6N.cjs';
+import { b as RouteDockLogger } from './logger-DVa7VT4c.cjs';
 
 interface RouteDockMiddlewareOptions {
     modes: PaymentMode[];
@@ -58,6 +59,12 @@ interface RouteDockMiddlewareOptions {
      * callback failures, orphaned sessions). Defaults to a console-backed logger.
      */
     logger?: RouteDockLogger;
+    /**
+     * Record `session_settled` on the agent vault after each clean mpp-session
+     * close. Falls back to the deprecated `AGENT_VAULT_CONTRACT`/
+     * `AGENT_VAULT_CONTRACT_ID` env vars when unset.
+     */
+    vaultSettlement?: VaultSettlementConfig;
 }
 declare function routedock(opts: RouteDockMiddlewareOptions): RequestHandler;
 

package/dist/schema.cjs

@@ -79,6 +79,7 @@ var routedock_schema_default = {
     },
     asset_contract: {
       type: "string",
+      pattern: "^C[A-Z2-7]{55}$",
       description: "Stellar Asset Contract (SAC) address for the payment asset"
     },
     assets: {
@@ -91,6 +92,7 @@ var routedock_schema_default = {
     },
     payee: {
       type: "string",
+      pattern: "^G[A-Z2-7]{55}$",
       description: "Stellar address (G...) that receives payments"
     },
     pricing: {
@@ -261,6 +263,7 @@ var routedock_schema_default = {
       properties: {
         amount: {
           type: "string",
+          pattern: "^[0-9]+(\\.[0-9]{1,7})?$",
           description: "Cost per request in the payment asset (decimal string, e.g. '0.001')"
         },
         per: {
@@ -274,6 +277,7 @@ var routedock_schema_default = {
         },
         payee: {
           type: "string",
+          pattern: "^G[A-Z2-7]{55}$",
           description: "Optional per-mode payee override (Stellar G... address). Directs settlements for this mode to a separate account for treasury separation. Falls back to the top-level 'payee' when omitted."
         }
       }
@@ -286,6 +290,7 @@ var routedock_schema_default = {
       properties: {
         rate: {
           type: "string",
+          pattern: "^[0-9]+(\\.[0-9]{1,7})?$",
           description: "Cost per voucher in the payment asset (decimal string, e.g. '0.0001')"
         },
         per: {
@@ -295,10 +300,12 @@ var routedock_schema_default = {
         },
         channel_factory: {
           type: "string",
+          pattern: "^C[A-Z2-7]{55}$",
           description: "Stable Soroban factory address (C...) used to deploy a per-session channel"
         },
         min_deposit: {
           type: "string",
+          pattern: "^[0-9]+(\\.[0-9]{1,7})?$",
           description: "Minimum initial deposit to open a channel (decimal string)"
         },
         refund_waiting_period_ledgers: {

package/dist/schema.js

@@ -75,6 +75,7 @@ var routedock_schema_default = {
     },
     asset_contract: {
       type: "string",
+      pattern: "^C[A-Z2-7]{55}$",
       description: "Stellar Asset Contract (SAC) address for the payment asset"
     },
     assets: {
@@ -87,6 +88,7 @@ var routedock_schema_default = {
     },
     payee: {
       type: "string",
+      pattern: "^G[A-Z2-7]{55}$",
       description: "Stellar address (G...) that receives payments"
     },
     pricing: {
@@ -257,6 +259,7 @@ var routedock_schema_default = {
       properties: {
         amount: {
           type: "string",
+          pattern: "^[0-9]+(\\.[0-9]{1,7})?$",
           description: "Cost per request in the payment asset (decimal string, e.g. '0.001')"
         },
         per: {
@@ -270,6 +273,7 @@ var routedock_schema_default = {
         },
         payee: {
           type: "string",
+          pattern: "^G[A-Z2-7]{55}$",
           description: "Optional per-mode payee override (Stellar G... address). Directs settlements for this mode to a separate account for treasury separation. Falls back to the top-level 'payee' when omitted."
         }
       }
@@ -282,6 +286,7 @@ var routedock_schema_default = {
       properties: {
         rate: {
           type: "string",
+          pattern: "^[0-9]+(\\.[0-9]{1,7})?$",
           description: "Cost per voucher in the payment asset (decimal string, e.g. '0.0001')"
         },
         per: {
@@ -291,10 +296,12 @@ var routedock_schema_default = {
         },
         channel_factory: {
           type: "string",
+          pattern: "^C[A-Z2-7]{55}$",
           description: "Stable Soroban factory address (C...) used to deploy a per-session channel"
         },
         min_deposit: {
           type: "string",
+          pattern: "^[0-9]+(\\.[0-9]{1,7})?$",
           description: "Minimum initial deposit to open a channel (decimal string)"
         },
         refund_waiting_period_ledgers: {

package/dist/{sign-AKH67sft.d.cts → sign-Bq08SeFq.d.ts}

@@ -1,4 +1,4 @@
-import { h as RouteDockManifest } from './logger-D8_Q2ytp.cjs';
+import { R as RouteDockManifest } from './types-DXaS5Wip.js';
 
 /**
  * Ed25519 manifest signing and verification.
@@ -25,7 +25,7 @@ import { h as RouteDockManifest } from './logger-D8_Q2ytp.cjs';
 
 declare const MANIFEST_SIGNATURE_VERSION: "2";
 /** Produce the canonical SHA-256 digest of the manifest (signature field excluded). */
-declare function manifestDigest(manifest: RouteDockManifest): Buffer;
+declare function manifestDigest(manifest: RouteDockManifest): Uint8Array;
 /**
  * Sign a manifest with the payee's Stellar secret key.
  * Returns a new manifest object with the `signature` field populated.

package/dist/{sign-BEq-OsSq.d.ts → sign-DqGE0Plv.d.cts}

@@ -1,4 +1,4 @@
-import { h as RouteDockManifest } from './logger-D8_Q2ytp.js';
+import { R as RouteDockManifest } from './types-DXaS5Wip.cjs';
 
 /**
  * Ed25519 manifest signing and verification.
@@ -25,7 +25,7 @@ import { h as RouteDockManifest } from './logger-D8_Q2ytp.js';
 
 declare const MANIFEST_SIGNATURE_VERSION: "2";
 /** Produce the canonical SHA-256 digest of the manifest (signature field excluded). */
-declare function manifestDigest(manifest: RouteDockManifest): Buffer;
+declare function manifestDigest(manifest: RouteDockManifest): Uint8Array;
 /**
  * Sign a manifest with the payee's Stellar secret key.
  * Returns a new manifest object with the `signature` field populated.

package/dist/testing.d.cts

@@ -1,8 +1,9 @@
 import { RequestHandler } from 'express';
-import { P as PaymentMode } from './logger-D8_Q2ytp.cjs';
-import { R as RouteDockMiddlewareOptions } from './routedockMiddleware-DlyLrxp7.cjs';
+import { P as PaymentMode } from './types-DXaS5Wip.cjs';
+import { R as RouteDockMiddlewareOptions } from './routedockMiddleware-CxsWkSKa.cjs';
 import 'mppx';
-import './MppSessionHandler-1EL8QBAn.cjs';
+import './MppSessionHandler-xu4Kxu6N.cjs';
+import './logger-DVa7VT4c.cjs';
 
 /**
  * Loosen a production callback's return type so a plain sync test spy works,

package/dist/testing.d.ts

@@ -1,8 +1,9 @@
 import { RequestHandler } from 'express';
-import { P as PaymentMode } from './logger-D8_Q2ytp.js';
-import { R as RouteDockMiddlewareOptions } from './routedockMiddleware-57gUaEMf.js';
+import { P as PaymentMode } from './types-DXaS5Wip.js';
+import { R as RouteDockMiddlewareOptions } from './routedockMiddleware-Cq9HOJEa.js';
 import 'mppx';
-import './MppSessionHandler-Bq4S-JTE.js';
+import './MppSessionHandler-3QfCHI5x.js';
+import './logger-DVa7VT4c.js';
 
 /**
  * Loosen a production callback's return type so a plain sync test spy works,

package/dist/{logger-D8_Q2ytp.d.cts → types-DXaS5Wip.d.cts}

@@ -90,7 +90,12 @@ interface EndpointDescriptor {
 }
 /** Full RouteDock discovery manifest — served at /.well-known/routedock.json */
 interface RouteDockManifest {
-    /** Manifest schema version (major.minor), e.g. "1.0", "1.1", "2.0" */
+    /**
+     * Manifest schema version (major.minor), e.g. "1.0", "1.1", "2.0".
+     * Clients reject a manifest whose major version is higher than the highest
+     * one they support (`RouteDockClientVersionError`); any minor of a supported
+     * major is accepted, since minor bumps are additive.
+     */
     routedock: string;
     /**
      * Minimum SDK client version (major.minor) required to use this manifest.
@@ -224,6 +229,39 @@ interface PreflightResult {
     /** Optional protocol features supported by this provider */
     capabilities?: RouteDockManifest['capabilities'];
 }
+/** Estimated cost of one payment mode, as declared by the provider manifest */
+interface PreflightModeCost {
+    /** Payment mode this cost applies to */
+    mode: PaymentMode;
+    /** Charge per unit in the payment asset (decimal string): per request, or per voucher for session modes */
+    amount: string;
+    /** Billing unit for `amount` */
+    per: 'request' | 'voucher';
+    /** Payment asset ticker that would be used for this mode, e.g. "USDC" */
+    asset: string;
+    /** Minimum channel deposit (decimal string) — session modes only */
+    min_deposit?: string;
+}
+/** Deprecation / sunset signals surfaced by client.preflight(url) */
+interface PreflightComplianceFlags {
+    /** Modes still listed for backwards compatibility but deprecated */
+    deprecated_modes: PaymentMode[];
+    /** Manifest-level sunset timestamp (ISO 8601), when the provider declares one */
+    sunset_at?: string;
+    /** Whether an endpoint matching the URL path is marked deprecated */
+    endpoint_deprecated: boolean;
+    /** Sunset timestamp (ISO 8601) of the endpoint matching the URL path, when declared */
+    endpoint_sunset_at?: string;
+}
+/** Result returned by client.preflight(url) — manifest compatibility check with no money movement */
+interface UrlPreflightResult {
+    /** Payment modes supported by this provider */
+    modes: PaymentMode[];
+    /** Estimated cost for each supported mode */
+    costs: PreflightModeCost[];
+    /** Deprecation / sunset flags */
+    compliance: PreflightComplianceFlags;
+}
 /** Result returned by client.estimateCost() — the expected charge without submitting any transaction */
 interface EstimateCostResult {
     /** Expected charge in the payment asset (decimal string, e.g. "0.001") */
@@ -336,6 +374,28 @@ interface SessionEventPayloadMap {
     'session:timeout': SessionTimeoutPayload;
     'session:close-failed': SessionCloseFailedPayload;
 }
+/**
+ * HTTP request fields RouteDock replays to the provider on the caller's behalf.
+ *
+ * A payment is more than one round-trip — an unpaid probe that elicits the 402
+ * challenge, the paid retry, and retries of either — so the body is buffered
+ * once (when it is not already replayable) and reused for every attempt. The
+ * supported bodies are strings, ArrayBuffers/typed arrays, `Blob`, `FormData`
+ * and `URLSearchParams`; a `ReadableStream` is drained up front, which makes it
+ * unsuitable for a streaming upload.
+ *
+ * Payment headers the SDK sets itself (`PAYMENT-SIGNATURE` / `X-PAYMENT` for
+ * x402, `Authorization` for MPP) always win over a caller header with the same
+ * name.
+ */
+interface PaymentRequest {
+    /** HTTP method, e.g. `'POST'`. Defaults to `'GET'`. */
+    method?: string;
+    /** Additional request headers. SDK payment headers take precedence. */
+    headers?: HeadersInit;
+    /** Request body, replayed on every attempt. */
+    body?: BodyInit;
+}
 /**
  * Options for SessionHandle.stream().
  */
@@ -347,6 +407,12 @@ interface StreamOptions {
      * vouchers; out-of-order sequence numbers will cause payment failures otherwise.
      */
     concurrency?: number;
+    /**
+     * HTTP request replayed for every voucher request. Use this when the streamed
+     * endpoint expects a POST body. For `mpp-session-ws` only the HTTP voucher
+     * probe uses it — the WebSocket upgrade is always a GET handshake.
+     */
+    request?: PaymentRequest;
 }
 /** Handle for a live MPP session returned by client.openSession() */
 interface SessionHandle {
@@ -388,10 +454,22 @@ interface SessionHandle {
     stats(): SessionStats;
     /** Close the channel on-chain with the highest signed voucher */
     close(): Promise<SessionCloseResult>;
-    /** Request refund from the channel contract (initiates dispute) */
-    requestRefund(): Promise<string>;
-    /** Server-side counter-mechanism to settle with latest voucher before refund window expires */
-    settleWithLatestVoucher(): Promise<string>;
+    /**
+     * Request refund from the channel contract (initiates dispute).
+     * Returns the transaction hash only after on-chain confirmation (SUCCESS).
+     */
+    requestRefund(options?: {
+        timeoutMs?: number;
+        intervalMs?: number;
+    }): Promise<string>;
+    /**
+     * Server-side counter-mechanism to settle with latest voucher before refund window expires.
+     * Returns the transaction hash only after on-chain confirmation (SUCCESS).
+     */
+    settleWithLatestVoucher(options?: {
+        timeoutMs?: number;
+        intervalMs?: number;
+    }): Promise<string>;
     /** Get the current dispute status of the channel */
     getDisputeStatus(): Promise<DisputeStatus>;
     /**
@@ -415,7 +493,7 @@ interface SessionState {
     /** Monotonically increasing cumulative amount — stored as string to preserve precision */
     cumulative_amount: string;
     last_signature: string;
-    status: 'open' | 'closing' | 'closed';
+    status: 'open' | 'closing' | 'closed' | 'failed';
     opened_at: string;
     updated_at: string;
     settlement_tx_hash: string | null;
@@ -424,44 +502,4 @@ interface SessionState {
 /** Dispute status of a channel */
 type DisputeStatus = 'open' | 'in-refund-window' | 'refundable' | 'settled';
 
-/**
- * Structured logging hook shared by the client and provider adapters.
- *
- * The SDK used to write straight to `console` in a couple of dozen error
- * paths, which is unusable on structured-logging runtimes (Cloudflare Workers,
- * Datadog, …) and untestable without spying on `console`. Every internal
- * diagnostic now goes through a {@link RouteDockLogger}, so a consumer can
- * silence it, redirect it, or attach correlation fields.
- *
- * The default implementation is console-backed, so behaviour is unchanged when
- * no logger is supplied.
- */
-/** Severity of a log line. */
-type RouteDockLogLevel = 'debug' | 'info' | 'warn' | 'error';
-/**
- * Structured context attached to a log line, typically `{ error: err }`. Sinks
- * receive the values unresolved, so a serialising sink must project non-JSON
- * values such as `Error` itself.
- */
-type RouteDockLogFields = Record<string, unknown>;
-/**
- * Consumer-supplied log sink.
- *
- * `fields` carries the structured payload (the error, the channel id, …) that
- * a bare string would drop at the boundary.
- */
-type RouteDockLogger = (level: RouteDockLogLevel, message: string, fields?: RouteDockLogFields) => void;
-/**
- * Default logger that forwards to the console at the matching level. Field
- * values are spread as additional console arguments so `console.error(msg, err)`
- * spies (and existing log shippers) keep seeing the raw error object.
- */
-declare function createConsoleLogger(): RouteDockLogger;
-/** Shared console-backed logger — the default when none is configured. */
-declare const consoleLogger: RouteDockLogger;
-/** Logger that discards every line. */
-declare const noopLogger: RouteDockLogger;
-/** Resolve an optional logger to a concrete sink, defaulting to `fallback`. */
-declare function resolveLogger(logger: RouteDockLogger | undefined, fallback?: RouteDockLogger): RouteDockLogger;
-
-export { type AssetConfig as A, DEFAULT_MAX_SESSION_DURATION_MS as D, type EndpointDescriptor as E, type PaymentMode as P, type RouteDockLogFields as R, type SLAConfig as S, type VaultMode as V, type DisputeStatus as a, type EstimateCostResult as b, type PaymentResult as c, type PreflightResult as d, type PricingConfig as e, type RouteDockLogLevel as f, type RouteDockLogger as g, type RouteDockManifest as h, type SessionCloseFailedPayload as i, type SessionCloseResult as j, type SessionEvent as k, type SessionEventPayloadMap as l, type SessionHandle as m, type SessionOptions as n, type SessionPricingConfig as o, type SessionState as p, type SessionStats as q, type SessionTimeoutPayload as r, type StreamOptions as s, consoleLogger as t, createConsoleLogger as u, noopLogger as v, resolveLogger as w };
+export { type AssetConfig as A, DEFAULT_MAX_SESSION_DURATION_MS as D, type EndpointDescriptor as E, type PaymentMode as P, type RouteDockManifest as R, type SLAConfig as S, type UrlPreflightResult as U, type VaultMode as V, type DisputeStatus as a, type EstimateCostResult as b, type PaymentRequest as c, type PaymentResult as d, type PreflightComplianceFlags as e, type PreflightModeCost as f, type PreflightResult as g, type PricingConfig as h, type SessionCloseFailedPayload as i, type SessionCloseResult as j, type SessionEvent as k, type SessionEventPayloadMap as l, type SessionHandle as m, type SessionOptions as n, type SessionPricingConfig as o, type SessionState as p, type SessionStats as q, type SessionTimeoutPayload as r, type StreamOptions as s };

package/dist/{logger-D8_Q2ytp.d.ts → types-DXaS5Wip.d.ts}

@@ -90,7 +90,12 @@ interface EndpointDescriptor {
 }
 /** Full RouteDock discovery manifest — served at /.well-known/routedock.json */
 interface RouteDockManifest {
-    /** Manifest schema version (major.minor), e.g. "1.0", "1.1", "2.0" */
+    /**
+     * Manifest schema version (major.minor), e.g. "1.0", "1.1", "2.0".
+     * Clients reject a manifest whose major version is higher than the highest
+     * one they support (`RouteDockClientVersionError`); any minor of a supported
+     * major is accepted, since minor bumps are additive.
+     */
     routedock: string;
     /**
      * Minimum SDK client version (major.minor) required to use this manifest.
@@ -224,6 +229,39 @@ interface PreflightResult {
     /** Optional protocol features supported by this provider */
     capabilities?: RouteDockManifest['capabilities'];
 }
+/** Estimated cost of one payment mode, as declared by the provider manifest */
+interface PreflightModeCost {
+    /** Payment mode this cost applies to */
+    mode: PaymentMode;
+    /** Charge per unit in the payment asset (decimal string): per request, or per voucher for session modes */
+    amount: string;
+    /** Billing unit for `amount` */
+    per: 'request' | 'voucher';
+    /** Payment asset ticker that would be used for this mode, e.g. "USDC" */
+    asset: string;
+    /** Minimum channel deposit (decimal string) — session modes only */
+    min_deposit?: string;
+}
+/** Deprecation / sunset signals surfaced by client.preflight(url) */
+interface PreflightComplianceFlags {
+    /** Modes still listed for backwards compatibility but deprecated */
+    deprecated_modes: PaymentMode[];
+    /** Manifest-level sunset timestamp (ISO 8601), when the provider declares one */
+    sunset_at?: string;
+    /** Whether an endpoint matching the URL path is marked deprecated */
+    endpoint_deprecated: boolean;
+    /** Sunset timestamp (ISO 8601) of the endpoint matching the URL path, when declared */
+    endpoint_sunset_at?: string;
+}
+/** Result returned by client.preflight(url) — manifest compatibility check with no money movement */
+interface UrlPreflightResult {
+    /** Payment modes supported by this provider */
+    modes: PaymentMode[];
+    /** Estimated cost for each supported mode */
+    costs: PreflightModeCost[];
+    /** Deprecation / sunset flags */
+    compliance: PreflightComplianceFlags;
+}
 /** Result returned by client.estimateCost() — the expected charge without submitting any transaction */
 interface EstimateCostResult {
     /** Expected charge in the payment asset (decimal string, e.g. "0.001") */
@@ -336,6 +374,28 @@ interface SessionEventPayloadMap {
     'session:timeout': SessionTimeoutPayload;
     'session:close-failed': SessionCloseFailedPayload;
 }
+/**
+ * HTTP request fields RouteDock replays to the provider on the caller's behalf.
+ *
+ * A payment is more than one round-trip — an unpaid probe that elicits the 402
+ * challenge, the paid retry, and retries of either — so the body is buffered
+ * once (when it is not already replayable) and reused for every attempt. The
+ * supported bodies are strings, ArrayBuffers/typed arrays, `Blob`, `FormData`
+ * and `URLSearchParams`; a `ReadableStream` is drained up front, which makes it
+ * unsuitable for a streaming upload.
+ *
+ * Payment headers the SDK sets itself (`PAYMENT-SIGNATURE` / `X-PAYMENT` for
+ * x402, `Authorization` for MPP) always win over a caller header with the same
+ * name.
+ */
+interface PaymentRequest {
+    /** HTTP method, e.g. `'POST'`. Defaults to `'GET'`. */
+    method?: string;
+    /** Additional request headers. SDK payment headers take precedence. */
+    headers?: HeadersInit;
+    /** Request body, replayed on every attempt. */
+    body?: BodyInit;
+}
 /**
  * Options for SessionHandle.stream().
  */
@@ -347,6 +407,12 @@ interface StreamOptions {
      * vouchers; out-of-order sequence numbers will cause payment failures otherwise.
      */
     concurrency?: number;
+    /**
+     * HTTP request replayed for every voucher request. Use this when the streamed
+     * endpoint expects a POST body. For `mpp-session-ws` only the HTTP voucher
+     * probe uses it — the WebSocket upgrade is always a GET handshake.
+     */
+    request?: PaymentRequest;
 }
 /** Handle for a live MPP session returned by client.openSession() */
 interface SessionHandle {
@@ -388,10 +454,22 @@ interface SessionHandle {
     stats(): SessionStats;
     /** Close the channel on-chain with the highest signed voucher */
     close(): Promise<SessionCloseResult>;
-    /** Request refund from the channel contract (initiates dispute) */
-    requestRefund(): Promise<string>;
-    /** Server-side counter-mechanism to settle with latest voucher before refund window expires */
-    settleWithLatestVoucher(): Promise<string>;
+    /**
+     * Request refund from the channel contract (initiates dispute).
+     * Returns the transaction hash only after on-chain confirmation (SUCCESS).
+     */
+    requestRefund(options?: {
+        timeoutMs?: number;
+        intervalMs?: number;
+    }): Promise<string>;
+    /**
+     * Server-side counter-mechanism to settle with latest voucher before refund window expires.
+     * Returns the transaction hash only after on-chain confirmation (SUCCESS).
+     */
+    settleWithLatestVoucher(options?: {
+        timeoutMs?: number;
+        intervalMs?: number;
+    }): Promise<string>;
     /** Get the current dispute status of the channel */
     getDisputeStatus(): Promise<DisputeStatus>;
     /**
@@ -415,7 +493,7 @@ interface SessionState {
     /** Monotonically increasing cumulative amount — stored as string to preserve precision */
     cumulative_amount: string;
     last_signature: string;
-    status: 'open' | 'closing' | 'closed';
+    status: 'open' | 'closing' | 'closed' | 'failed';
     opened_at: string;
     updated_at: string;
     settlement_tx_hash: string | null;
@@ -424,44 +502,4 @@ interface SessionState {
 /** Dispute status of a channel */
 type DisputeStatus = 'open' | 'in-refund-window' | 'refundable' | 'settled';
 
-/**
- * Structured logging hook shared by the client and provider adapters.
- *
- * The SDK used to write straight to `console` in a couple of dozen error
- * paths, which is unusable on structured-logging runtimes (Cloudflare Workers,
- * Datadog, …) and untestable without spying on `console`. Every internal
- * diagnostic now goes through a {@link RouteDockLogger}, so a consumer can
- * silence it, redirect it, or attach correlation fields.
- *
- * The default implementation is console-backed, so behaviour is unchanged when
- * no logger is supplied.
- */
-/** Severity of a log line. */
-type RouteDockLogLevel = 'debug' | 'info' | 'warn' | 'error';
-/**
- * Structured context attached to a log line, typically `{ error: err }`. Sinks
- * receive the values unresolved, so a serialising sink must project non-JSON
- * values such as `Error` itself.
- */
-type RouteDockLogFields = Record<string, unknown>;
-/**
- * Consumer-supplied log sink.
- *
- * `fields` carries the structured payload (the error, the channel id, …) that
- * a bare string would drop at the boundary.
- */
-type RouteDockLogger = (level: RouteDockLogLevel, message: string, fields?: RouteDockLogFields) => void;
-/**
- * Default logger that forwards to the console at the matching level. Field
- * values are spread as additional console arguments so `console.error(msg, err)`
- * spies (and existing log shippers) keep seeing the raw error object.
- */
-declare function createConsoleLogger(): RouteDockLogger;
-/** Shared console-backed logger — the default when none is configured. */
-declare const consoleLogger: RouteDockLogger;
-/** Logger that discards every line. */
-declare const noopLogger: RouteDockLogger;
-/** Resolve an optional logger to a concrete sink, defaulting to `fallback`. */
-declare function resolveLogger(logger: RouteDockLogger | undefined, fallback?: RouteDockLogger): RouteDockLogger;
-
-export { type AssetConfig as A, DEFAULT_MAX_SESSION_DURATION_MS as D, type EndpointDescriptor as E, type PaymentMode as P, type RouteDockLogFields as R, type SLAConfig as S, type VaultMode as V, type DisputeStatus as a, type EstimateCostResult as b, type PaymentResult as c, type PreflightResult as d, type PricingConfig as e, type RouteDockLogLevel as f, type RouteDockLogger as g, type RouteDockManifest as h, type SessionCloseFailedPayload as i, type SessionCloseResult as j, type SessionEvent as k, type SessionEventPayloadMap as l, type SessionHandle as m, type SessionOptions as n, type SessionPricingConfig as o, type SessionState as p, type SessionStats as q, type SessionTimeoutPayload as r, type StreamOptions as s, consoleLogger as t, createConsoleLogger as u, noopLogger as v, resolveLogger as w };
+export { type AssetConfig as A, DEFAULT_MAX_SESSION_DURATION_MS as D, type EndpointDescriptor as E, type PaymentMode as P, type RouteDockManifest as R, type SLAConfig as S, type UrlPreflightResult as U, type VaultMode as V, type DisputeStatus as a, type EstimateCostResult as b, type PaymentRequest as c, type PaymentResult as d, type PreflightComplianceFlags as e, type PreflightModeCost as f, type PreflightResult as g, type PricingConfig as h, type SessionCloseFailedPayload as i, type SessionCloseResult as j, type SessionEvent as k, type SessionEventPayloadMap as l, type SessionHandle as m, type SessionOptions as n, type SessionPricingConfig as o, type SessionState as p, type SessionStats as q, type SessionTimeoutPayload as r, type StreamOptions as s };