@routedock/routedock 0.2.0 → 0.3.0

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

@@ -1,6 +1,6 @@
 import { RequestHandler } from 'express';
-import { P as PaymentMode, R as RouteDockManifest } from './types-DmhmfLzP.js';
-import { O as OrphanedSessionInfo, S as SeenTxStore } from './MppSessionHandler-CLB5SzgN.js';
+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';
 
 interface RouteDockMiddlewareOptions {
     modes: PaymentMode[];
@@ -12,9 +12,9 @@ interface RouteDockMiddlewareOptions {
             channelFactory: string;
         };
     };
-    asset: string;
+    asset?: string;
     /** Stellar Asset Contract address for the payment asset */
-    assetContract: string;
+    assetContract?: string;
     payee: string;
     network: 'testnet' | 'mainnet';
     /** Private key (S...) of the server/payee account */
@@ -53,6 +53,11 @@ interface RouteDockMiddlewareOptions {
      * duplicate settlement on agent retries. Defaults to per-handler in-memory.
      */
     seenTxStore?: SeenTxStore;
+    /**
+     * Structured log sink for every adapter diagnostic (settlement errors,
+     * callback failures, orphaned sessions). Defaults to a console-backed logger.
+     */
+    logger?: RouteDockLogger;
 }
 declare function routedock(opts: RouteDockMiddlewareOptions): RequestHandler;
 

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

@@ -1,6 +1,6 @@
 import { RequestHandler } from 'express';
-import { P as PaymentMode, R as RouteDockManifest } from './types-DmhmfLzP.cjs';
-import { O as OrphanedSessionInfo, S as SeenTxStore } from './MppSessionHandler-B4TyD7Xg.cjs';
+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';
 
 interface RouteDockMiddlewareOptions {
     modes: PaymentMode[];
@@ -12,9 +12,9 @@ interface RouteDockMiddlewareOptions {
             channelFactory: string;
         };
     };
-    asset: string;
+    asset?: string;
     /** Stellar Asset Contract address for the payment asset */
-    assetContract: string;
+    assetContract?: string;
     payee: string;
     network: 'testnet' | 'mainnet';
     /** Private key (S...) of the server/payee account */
@@ -53,6 +53,11 @@ interface RouteDockMiddlewareOptions {
      * duplicate settlement on agent retries. Defaults to per-handler in-memory.
      */
     seenTxStore?: SeenTxStore;
+    /**
+     * Structured log sink for every adapter diagnostic (settlement errors,
+     * callback failures, orphaned sessions). Defaults to a console-backed logger.
+     */
+    logger?: RouteDockLogger;
 }
 declare function routedock(opts: RouteDockMiddlewareOptions): RequestHandler;
 

package/dist/schema.cjs

@@ -81,6 +81,14 @@ var routedock_schema_default = {
       type: "string",
       description: "Stellar Asset Contract (SAC) address for the payment asset"
     },
+    assets: {
+      type: "array",
+      minItems: 1,
+      items: {
+        $ref: "#/definitions/AssetConfig"
+      },
+      description: "Payment assets accepted by this provider. Each asset can be scoped to specific modes and endpoints. When present, assets[0] must match the root-level asset and asset_contract."
+    },
     payee: {
       type: "string",
       description: "Stellar address (G...) that receives payments"
@@ -213,6 +221,38 @@ var routedock_schema_default = {
       enum: ["x402", "mpp-charge", "mpp-session", "mpp-session-ws"],
       description: "A supported RouteDock payment mode"
     },
+    AssetConfig: {
+      type: "object",
+      description: "Payment asset configuration with optional mode and endpoint scoping",
+      required: ["asset", "asset_contract"],
+      additionalProperties: false,
+      properties: {
+        asset: {
+          type: "string",
+          description: "Asset ticker symbol (e.g. 'USDC' or 'XLM')"
+        },
+        asset_contract: {
+          type: "string",
+          description: "Stellar Asset Contract (SAC) address for the payment asset"
+        },
+        modes: {
+          type: "array",
+          items: {
+            $ref: "#/definitions/PaymentMode"
+          },
+          uniqueItems: true,
+          description: "Optional: restrict this asset to specific payment modes. If omitted, available for all modes."
+        },
+        endpoints: {
+          type: "array",
+          items: {
+            type: "string"
+          },
+          uniqueItems: true,
+          description: "Optional: restrict this asset to specific endpoints (by name). If omitted, available for all endpoints."
+        }
+      }
+    },
     PricingConfig: {
       type: "object",
       description: "Per-request pricing for x402 or mpp-charge modes",

package/dist/schema.js

@@ -77,6 +77,14 @@ var routedock_schema_default = {
       type: "string",
       description: "Stellar Asset Contract (SAC) address for the payment asset"
     },
+    assets: {
+      type: "array",
+      minItems: 1,
+      items: {
+        $ref: "#/definitions/AssetConfig"
+      },
+      description: "Payment assets accepted by this provider. Each asset can be scoped to specific modes and endpoints. When present, assets[0] must match the root-level asset and asset_contract."
+    },
     payee: {
       type: "string",
       description: "Stellar address (G...) that receives payments"
@@ -209,6 +217,38 @@ var routedock_schema_default = {
       enum: ["x402", "mpp-charge", "mpp-session", "mpp-session-ws"],
       description: "A supported RouteDock payment mode"
     },
+    AssetConfig: {
+      type: "object",
+      description: "Payment asset configuration with optional mode and endpoint scoping",
+      required: ["asset", "asset_contract"],
+      additionalProperties: false,
+      properties: {
+        asset: {
+          type: "string",
+          description: "Asset ticker symbol (e.g. 'USDC' or 'XLM')"
+        },
+        asset_contract: {
+          type: "string",
+          description: "Stellar Asset Contract (SAC) address for the payment asset"
+        },
+        modes: {
+          type: "array",
+          items: {
+            $ref: "#/definitions/PaymentMode"
+          },
+          uniqueItems: true,
+          description: "Optional: restrict this asset to specific payment modes. If omitted, available for all modes."
+        },
+        endpoints: {
+          type: "array",
+          items: {
+            type: "string"
+          },
+          uniqueItems: true,
+          description: "Optional: restrict this asset to specific endpoints (by name). If omitted, available for all endpoints."
+        }
+      }
+    },
     PricingConfig: {
       type: "object",
       description: "Per-request pricing for x402 or mpp-charge modes",

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

@@ -1,4 +1,4 @@
-import { R as RouteDockManifest } from './types-DmhmfLzP.js';
+import { h as RouteDockManifest } from './logger-D8_Q2ytp.cjs';
 
 /**
  * Ed25519 manifest signing and verification.

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

@@ -1,4 +1,4 @@
-import { R as RouteDockManifest } from './types-DmhmfLzP.cjs';
+import { h as RouteDockManifest } from './logger-D8_Q2ytp.js';
 
 /**
  * Ed25519 manifest signing and verification.

package/dist/testing.cjs

@@ -3,6 +3,7 @@
 // src/testing/createMockRoutedockMiddleware.ts
 var DEFAULT_TX_HASH = "0000000000000000000000000000000000000000000000000000000000000000";
 var DEFAULT_CHANNEL_ID = "CCK4XOW3YKQUEZFONUTINKMSNW7SNMRQZURME5U3UP7E6WNGK7UHUCAH";
+var DEFAULT_PAYER = "GAIRCEIRCEIRCEIRCEIRCEIRCEIRCEIRCEIRCEIRCEIRCEIRCEIRCF6M";
 function format7(scaled) {
   return (Number(scaled) / 1e7).toFixed(7);
 }
@@ -16,11 +17,12 @@ async function runMockSettlement(opts) {
   if ((opts.payment ?? "auto-pass") === "auto-fail") return null;
   const s = opts.synthetic ?? {};
   const txHash = s.txHash ?? DEFAULT_TX_HASH;
-  if (mode === "mpp-session") {
+  const payer = s.payer === void 0 ? DEFAULT_PAYER : s.payer;
+  if (mode === "mpp-session" || mode === "mpp-session-ws") {
     const channelId = s.channelId ?? DEFAULT_CHANNEL_ID;
     const rate = toScaled(s.rate ?? "0.0001");
     const count = s.voucherCount ?? 3;
-    if (opts.onSessionOpen) await opts.onSessionOpen(channelId);
+    if (opts.onSessionOpen) await opts.onSessionOpen(channelId, payer);
     const vouchers = [];
     for (let i = 1; i <= count; i++) {
       const cumulativeAmount = format7(rate * BigInt(i));
@@ -28,11 +30,11 @@ async function runMockSettlement(opts) {
       if (opts.onVoucher) await opts.onVoucher(channelId, i, cumulativeAmount, "0000000000000000000000000000000000000000000000000000000000000000");
     }
     const totalPaid = format7(rate * BigInt(count));
-    if (opts.onSettled) await opts.onSettled(txHash, totalPaid, "mpp-session");
+    if (opts.onSettled) await opts.onSettled(txHash, totalPaid, mode, payer);
     return { mode, txHash, amount: totalPaid, channelId, vouchers };
   }
   const amount = s.amount ?? "0.001";
-  if (opts.onSettled) await opts.onSettled(txHash, amount, mode);
+  if (opts.onSettled) await opts.onSettled(txHash, amount, mode, payer);
   return { mode, txHash, amount };
 }
 function createMockRoutedockMiddleware(opts = {}) {

package/dist/testing.d.cts

@@ -1,19 +1,26 @@
 import { RequestHandler } from 'express';
-import { P as PaymentMode } from './types-DmhmfLzP.cjs';
+import { P as PaymentMode } from './logger-D8_Q2ytp.cjs';
+import { R as RouteDockMiddlewareOptions } from './routedockMiddleware-DlyLrxp7.cjs';
 import 'mppx';
+import './MppSessionHandler-1EL8QBAn.cjs';
 
 /**
- * Provider settlement callbacks under test. Same shape as the real
- * `RouteDockMiddlewareOptions` callbacks, but accept sync or async fns so a
- * plain test spy works without wrapping it in a Promise.
+ * Loosen a production callback's return type so a plain sync test spy works,
+ * while keeping its exact parameter list (the real adapter's signature).
+ */
+type TestCallback<F> = F extends (...args: infer A) => unknown ? (...args: A) => void | Promise<void> : never;
+/**
+ * Provider settlement callbacks under test. Same parameter list as the real
+ * `RouteDockMiddlewareOptions` callbacks — including `payer` — but they accept
+ * sync or async fns so a plain test spy works without wrapping it in a Promise.
  */
 interface MockRoutedockCallbacks {
     /** Called after each (synthetic) on-chain settlement. */
-    onSettled?: (txHash: string, amount: string, mode: string) => void | Promise<void>;
-    /** Called once when a synthetic mpp-session is opened (first voucher). */
-    onSessionOpen?: (channelId: string) => void | Promise<void>;
-    /** Called for each synthetic voucher in an mpp-session (1-based index). */
-    onVoucher?: (channelId: string, voucherIndex: number, cumulativeAmount: string, signature: string) => void | Promise<void>;
+    onSettled?: TestCallback<NonNullable<RouteDockMiddlewareOptions['onSettled']>>;
+    /** Called once when a synthetic session is opened (first voucher). */
+    onSessionOpen?: TestCallback<NonNullable<RouteDockMiddlewareOptions['onSessionOpen']>>;
+    /** Called for each synthetic voucher in a session (1-based index). */
+    onVoucher?: TestCallback<NonNullable<RouteDockMiddlewareOptions['onVoucher']>>;
 }
 /** Synthetic settlement values handed to the callbacks. All optional — sensible defaults per mode. */
 interface SyntheticPayment {
@@ -21,12 +28,19 @@ interface SyntheticPayment {
     txHash?: string;
     /** Settled amount (x402 / mpp-charge) passed to onSettled. Default: '0.001'. */
     amount?: string;
-    /** Channel address (mpp-session) passed to onSessionOpen. Default: a fixed C... address. */
+    /** Channel address (session modes) passed to onSessionOpen. Default: a fixed C... address. */
     channelId?: string;
-    /** Per-voucher rate (mpp-session), in decimal string. Default: '0.0001'. */
+    /** Per-voucher rate (session modes), in decimal string. Default: '0.0001'. */
     rate?: string;
-    /** Number of vouchers to emit before close (mpp-session). Default: 3. */
+    /** Number of vouchers to emit before close (session modes). Default: 3. */
     voucherCount?: number;
+    /**
+     * Payer passed to onSettled (4th arg) and onSessionOpen (2nd arg). Default: a
+     * valid Stellar G... account. Pass `null` to exercise the address-unavailable
+     * path; `null` is passed through untouched (an explicit null is not replaced
+     * by the default).
+     */
+    payer?: string | null;
 }
 interface MockRoutedockOptions extends MockRoutedockCallbacks {
     /** Payment mode the synthetic payment uses. Default: 'x402'. */
@@ -87,7 +101,12 @@ declare function runMockSettlement(opts: MockRoutedockOptions): Promise<MockSett
  * app.get('/price', (_req, res) => res.json({ price: '42' }))
  *
  * await request(app).get('/price').expect(200)
- * expect(onSettled).toHaveBeenCalledWith(expect.any(String), '0.001', 'x402')
+ * expect(onSettled).toHaveBeenCalledWith(
+ *   expect.any(String),
+ *   '0.001',
+ *   'x402',
+ *   expect.any(String), // payer
+ * )
  * ```
  */
 declare function createMockRoutedockMiddleware(opts?: MockRoutedockOptions): RequestHandler;

package/dist/testing.d.ts

@@ -1,19 +1,26 @@
 import { RequestHandler } from 'express';
-import { P as PaymentMode } from './types-DmhmfLzP.js';
+import { P as PaymentMode } from './logger-D8_Q2ytp.js';
+import { R as RouteDockMiddlewareOptions } from './routedockMiddleware-57gUaEMf.js';
 import 'mppx';
+import './MppSessionHandler-Bq4S-JTE.js';
 
 /**
- * Provider settlement callbacks under test. Same shape as the real
- * `RouteDockMiddlewareOptions` callbacks, but accept sync or async fns so a
- * plain test spy works without wrapping it in a Promise.
+ * Loosen a production callback's return type so a plain sync test spy works,
+ * while keeping its exact parameter list (the real adapter's signature).
+ */
+type TestCallback<F> = F extends (...args: infer A) => unknown ? (...args: A) => void | Promise<void> : never;
+/**
+ * Provider settlement callbacks under test. Same parameter list as the real
+ * `RouteDockMiddlewareOptions` callbacks — including `payer` — but they accept
+ * sync or async fns so a plain test spy works without wrapping it in a Promise.
  */
 interface MockRoutedockCallbacks {
     /** Called after each (synthetic) on-chain settlement. */
-    onSettled?: (txHash: string, amount: string, mode: string) => void | Promise<void>;
-    /** Called once when a synthetic mpp-session is opened (first voucher). */
-    onSessionOpen?: (channelId: string) => void | Promise<void>;
-    /** Called for each synthetic voucher in an mpp-session (1-based index). */
-    onVoucher?: (channelId: string, voucherIndex: number, cumulativeAmount: string, signature: string) => void | Promise<void>;
+    onSettled?: TestCallback<NonNullable<RouteDockMiddlewareOptions['onSettled']>>;
+    /** Called once when a synthetic session is opened (first voucher). */
+    onSessionOpen?: TestCallback<NonNullable<RouteDockMiddlewareOptions['onSessionOpen']>>;
+    /** Called for each synthetic voucher in a session (1-based index). */
+    onVoucher?: TestCallback<NonNullable<RouteDockMiddlewareOptions['onVoucher']>>;
 }
 /** Synthetic settlement values handed to the callbacks. All optional — sensible defaults per mode. */
 interface SyntheticPayment {
@@ -21,12 +28,19 @@ interface SyntheticPayment {
     txHash?: string;
     /** Settled amount (x402 / mpp-charge) passed to onSettled. Default: '0.001'. */
     amount?: string;
-    /** Channel address (mpp-session) passed to onSessionOpen. Default: a fixed C... address. */
+    /** Channel address (session modes) passed to onSessionOpen. Default: a fixed C... address. */
     channelId?: string;
-    /** Per-voucher rate (mpp-session), in decimal string. Default: '0.0001'. */
+    /** Per-voucher rate (session modes), in decimal string. Default: '0.0001'. */
     rate?: string;
-    /** Number of vouchers to emit before close (mpp-session). Default: 3. */
+    /** Number of vouchers to emit before close (session modes). Default: 3. */
     voucherCount?: number;
+    /**
+     * Payer passed to onSettled (4th arg) and onSessionOpen (2nd arg). Default: a
+     * valid Stellar G... account. Pass `null` to exercise the address-unavailable
+     * path; `null` is passed through untouched (an explicit null is not replaced
+     * by the default).
+     */
+    payer?: string | null;
 }
 interface MockRoutedockOptions extends MockRoutedockCallbacks {
     /** Payment mode the synthetic payment uses. Default: 'x402'. */
@@ -87,7 +101,12 @@ declare function runMockSettlement(opts: MockRoutedockOptions): Promise<MockSett
  * app.get('/price', (_req, res) => res.json({ price: '42' }))
  *
  * await request(app).get('/price').expect(200)
- * expect(onSettled).toHaveBeenCalledWith(expect.any(String), '0.001', 'x402')
+ * expect(onSettled).toHaveBeenCalledWith(
+ *   expect.any(String),
+ *   '0.001',
+ *   'x402',
+ *   expect.any(String), // payer
+ * )
  * ```
  */
 declare function createMockRoutedockMiddleware(opts?: MockRoutedockOptions): RequestHandler;

package/dist/testing.js

@@ -1,6 +1,7 @@
 // src/testing/createMockRoutedockMiddleware.ts
 var DEFAULT_TX_HASH = "0000000000000000000000000000000000000000000000000000000000000000";
 var DEFAULT_CHANNEL_ID = "CCK4XOW3YKQUEZFONUTINKMSNW7SNMRQZURME5U3UP7E6WNGK7UHUCAH";
+var DEFAULT_PAYER = "GAIRCEIRCEIRCEIRCEIRCEIRCEIRCEIRCEIRCEIRCEIRCEIRCEIRCF6M";
 function format7(scaled) {
   return (Number(scaled) / 1e7).toFixed(7);
 }
@@ -14,11 +15,12 @@ async function runMockSettlement(opts) {
   if ((opts.payment ?? "auto-pass") === "auto-fail") return null;
   const s = opts.synthetic ?? {};
   const txHash = s.txHash ?? DEFAULT_TX_HASH;
-  if (mode === "mpp-session") {
+  const payer = s.payer === void 0 ? DEFAULT_PAYER : s.payer;
+  if (mode === "mpp-session" || mode === "mpp-session-ws") {
     const channelId = s.channelId ?? DEFAULT_CHANNEL_ID;
     const rate = toScaled(s.rate ?? "0.0001");
     const count = s.voucherCount ?? 3;
-    if (opts.onSessionOpen) await opts.onSessionOpen(channelId);
+    if (opts.onSessionOpen) await opts.onSessionOpen(channelId, payer);
     const vouchers = [];
     for (let i = 1; i <= count; i++) {
       const cumulativeAmount = format7(rate * BigInt(i));
@@ -26,11 +28,11 @@ async function runMockSettlement(opts) {
       if (opts.onVoucher) await opts.onVoucher(channelId, i, cumulativeAmount, "0000000000000000000000000000000000000000000000000000000000000000");
     }
     const totalPaid = format7(rate * BigInt(count));
-    if (opts.onSettled) await opts.onSettled(txHash, totalPaid, "mpp-session");
+    if (opts.onSettled) await opts.onSettled(txHash, totalPaid, mode, payer);
     return { mode, txHash, amount: totalPaid, channelId, vouchers };
   }
   const amount = s.amount ?? "0.001";
-  if (opts.onSettled) await opts.onSettled(txHash, amount, mode);
+  if (opts.onSettled) await opts.onSettled(txHash, amount, mode, payer);
   return { mode, txHash, amount };
 }
 function createMockRoutedockMiddleware(opts = {}) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@routedock/routedock",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Unified payment execution layer for autonomous agents on Stellar",
   "license": "MIT",
   "repository": {
@@ -131,7 +131,7 @@
     "@x402/core": "^2.9.0",
     "@x402/stellar": "^2.9.0",
     "mppx": "^0.5.7",
-    "@routedock/nulth-sdk": "0.2.0"
+    "@routedock/nulth-sdk": "0.2.1"
   },
   "peerDependencies": {
     "express": "^4.18.0",

package/dist/MppSessionHandler-B4TyD7Xg.d.cts

@@ -1,121 +0,0 @@
-import { RequestHandler } from 'express';
-import { Store } from 'mppx';
-import { R as RouteDockManifest } from './types-DmhmfLzP.cjs';
-
-/**
- * Idempotency store for payment settlement.
- *
- * `x402Handler` and `MppChargeHandler` settle on every request carrying a
- * payment header. An agent that retries after a post-settlement network
- * timeout resends the *same* signed payment, which would settle a second time
- * and invoke `onSettled` twice — double-counting in billing.
- *
- * Before settling, a handler derives an idempotency key from the inbound
- * payment header(s) and checks this store. On a hit it replays the cached
- * settlement response and skips both the on-chain settle and `onSettled`.
- *
- * The default {@link InMemorySeenTxStore} is per-handler and per-process. For
- * multi-instance deployments, supply a shared implementation backed by Redis,
- * Supabase, etc.
- */
-/** Cached outcome of a settlement, replayed on a duplicate payment. */
-interface SettlementRecord {
-    /** On-chain transaction hash (or settlement reference), if known. */
-    txHash: string | null;
-    /** Response headers to re-apply on a replay (e.g. `X-Payment-Response`). */
-    headers?: Record<string, string>;
-}
-interface SeenTxStore {
-    /** Returns the cached settlement for a key, or `undefined` if unseen. */
-    get(key: string): Promise<SettlementRecord | undefined> | SettlementRecord | undefined;
-    /** Records the settlement outcome for a key. */
-    set(key: string, record: SettlementRecord): Promise<void> | void;
-}
-interface InMemorySeenTxStoreOptions {
-    /** Maximum number of entries before FIFO eviction. Defaults to 10,000. */
-    maxEntries?: number;
-    /** Log a startup warning about non-durability. Defaults to true. */
-    warn?: boolean;
-}
-/**
- * Default in-memory {@link SeenTxStore}. Bounded by `maxEntries` with FIFO
- * eviction so a long-running process cannot grow without limit.
- *
- * **Not durable.** On serverless/edge runtimes each request may land on a
- * fresh isolate with an empty cache, which causes duplicate settlements.
- * Supply a persistent implementation (Supabase, Redis, …) in production.
- */
-declare class InMemorySeenTxStore implements SeenTxStore {
-    private readonly map;
-    private readonly order;
-    constructor(maxEntriesOrOptions?: number | InMemorySeenTxStoreOptions);
-    private readonly maxEntries;
-    get(key: string): SettlementRecord | undefined;
-    set(key: string, record: SettlementRecord): void;
-}
-/**
- * Derive a collision-resistant idempotency key from the inbound
- * payment-bearing headers. Uses SHA-256 instead of 32-bit FNV-1a
- * (which has a 2^32 keyspace — birthday collisions become likely
- * well before the 10_000-entry default store is full).
- *
- * x402 clients send the signed payment in `payment-signature` / `x-payment`;
- * mppx clients send it in `authorization` (the `Payment` scheme). A retry
- * resends byte-identical headers, so hashing the first present one yields a
- * stable key. Returns `null` when no payment header is present (nothing to
- * dedupe — e.g. the initial 402 challenge request).
- */
-declare function paymentIdempotencyKey(getHeader: (name: string) => string | undefined): Promise<string | null>;
-
-/** Store shape extended with optional atomic update operation. */
-type ChannelStore = Store.Store & {
-    update?: (key: string, fn: (prev: unknown) => unknown) => Promise<unknown>;
-};
-/** Expected payload shape for voucher cumulative amount entries. */
-interface VoucherStoreValue {
-    amount: string;
-    [key: string]: unknown;
-}
-/** Validates that a stored store value is an object containing a numeric string amount. */
-declare function isVoucherStoreValue(value: unknown): value is VoucherStoreValue;
-type Network = 'testnet' | 'mainnet';
-/** Why a live session was flagged as orphaned (never cleanly closed). */
-type OrphanReason = 'connection-closed' | 'idle-timeout';
-/** Latest signed state of an orphaned session, enough for the reconciler to settle. */
-interface OrphanedSessionInfo {
-    /** Cumulative amount of the highest voucher seen (human-readable, 7 dp). */
-    cumulativeAmount: string;
-    /** Hex-encoded signature of the highest voucher seen. */
-    lastSignature: string;
-    /** Number of vouchers received before teardown. */
-    voucherCount: number;
-    /** What triggered the orphan flag. */
-    reason: OrphanReason;
-}
-interface MppSessionHandlerOptions {
-    payeeSecretKey: string;
-    network: Network;
-    channelFactory: string;
-    rate: string;
-    assetContract: string;
-    manifest: RouteDockManifest;
-    commitmentPublicKey: string;
-    onSettled?: (txHash: string, totalPaid: string, mode: string, payer: string | null) => Promise<void>;
-    onSessionOpen?: (channelId: string, payer: string | null) => Promise<void>;
-    onVoucher?: (channelId: string, voucherIndex: number, cumulativeAmount: string, signature: string) => Promise<void>;
-    onCallbackError?: (err: unknown, cb: string) => void;
-    /**
-     * Called when the client connection drops mid-session or the session goes
-     * idle, before a clean close. Persist the session as `closing` so the
-     * SessionReconciler can settle it with the latest signed voucher.
-     */
-    onOrphaned?: (channelId: string, info: OrphanedSessionInfo) => Promise<void>;
-    /**
-     * Flag the session orphaned after this many milliseconds with no voucher
-     * activity. Disabled when unset.
-     */
-    idleTimeoutMs?: number;
-}
-declare function createMppSessionHandler(opts: MppSessionHandlerOptions): RequestHandler;
-
-export { type ChannelStore as C, InMemorySeenTxStore as I, type MppSessionHandlerOptions as M, type OrphanedSessionInfo as O, type SeenTxStore as S, type VoucherStoreValue as V, type SettlementRecord as a, type InMemorySeenTxStoreOptions as b, type OrphanReason as c, createMppSessionHandler as d, isVoucherStoreValue as i, paymentIdempotencyKey as p };