@routedock/routedock 0.1.0 → 0.1.2

package/README.md

@@ -1,35 +1,33 @@
-# @routedock/sdk
+# @routedock/routedock
 
 Unified payment execution layer for autonomous agents on Stellar. One SDK for x402, MPP charge, and MPP session — mode selected automatically from the provider's `routedock.json` manifest.
 
 ## Install
 
 ```bash
-npm install @routedock/sdk
-# or
-pnpm add @routedock/sdk
+npm install @routedock/routedock
 ```
 
 ## Agent Usage
 
 ```ts
-import { RouteDockClient } from '@routedock/sdk/client'
+import { RouteDockClient } from '@routedock/routedock/client'
 import { Keypair } from '@stellar/stellar-sdk'
 
 const client = new RouteDockClient({
   wallet: Keypair.fromSecret(process.env.AGENT_SECRET),
   network: 'testnet',
-  spendCap: { daily: '1.00', asset: 'USDC' }, // optional local guard
+  spendCap: { daily: '1.00', asset: 'USDC' },
 })
 
 // Single call — SDK reads manifest, picks mode automatically
-const result = await client.pay('https://provider.railway.app/price')
+const result = await client.pay('https://provider.example.com/price')
 // result.data   — response body
 // result.txHash — settlement hash (or null for session vouchers)
 // result.mode   — 'x402' | 'mpp-charge' | 'mpp-session'
 
 // Sustained streaming access
-const session = await client.openSession('https://provider.railway.app/stream/orderbook')
+const session = await client.openSession('https://provider.example.com/stream/orderbook')
 for await (const update of session.stream()) {
   console.log(update)
   if (done) break
@@ -41,47 +39,88 @@ await session.close() // triggers on-chain settlement
 
 ```ts
 import express from 'express'
-import { routedock, SupabaseSessionStore } from '@routedock/sdk/provider'
-import { createClient } from '@supabase/supabase-js'
+import { routedock } from '@routedock/routedock/provider'
 
 const app = express()
 
-// Price endpoint — x402 + MPP charge
 app.use('/price', routedock({
   modes: ['x402', 'mpp-charge'],
   pricing: { x402: '0.001', 'mpp-charge': '0.0008' },
   asset: 'USDC',
+  assetContract: process.env.USDC_ASSET_CONTRACT,
   payee: process.env.STELLAR_PAYEE_ADDRESS,
-  network: process.env.STELLAR_NETWORK as 'testnet' | 'mainnet',
-  facilitatorApiKey: process.env.OPENZEPPELIN_API_KEY,
+  network: 'testnet',
+  payeeSecretKey: process.env.STELLAR_PAYEE_SECRET,
+  manifest,
+  onSettled: async (txHash, amount, mode) => {
+    console.log(`settled: ${mode} ${amount} USDC — ${txHash}`)
+  },
 }))
+```
+
+## Session Lifecycle Hooks
+
+For `mpp-session` mode, the middleware exposes three hooks that fire at each stage of the payment channel lifecycle:
 
-// Stream endpoint — MPP session only
-const store = new SupabaseSessionStore(createClient(process.env.SUPABASE_URL, process.env.SUPABASE_SERVICE_KEY))
-app.use('/stream/orderbook', routedock({
+```ts
+app.use('/stream', routedock({
   modes: ['mpp-session'],
-  pricing: { 'mpp-session': { rate: '0.0001', channelContract: process.env.CHANNEL_CONTRACT_ID } },
+  pricing: { 'mpp-session': { rate: '0.0001', channelContract: CHANNEL_CONTRACT } },
   asset: 'USDC',
-  payee: process.env.STELLAR_PAYEE_ADDRESS,
-  network: process.env.STELLAR_NETWORK as 'testnet' | 'mainnet',
-  store,
+  assetContract: USDC_ASSET_CONTRACT,
+  payee: PAYEE_ADDRESS,
+  network: 'testnet',
+  payeeSecretKey: PAYEE_SECRET,
+  manifest,
+  commitmentPublicKey: COMMITMENT_PUBLIC_KEY,
+
+  // Fires once when the first voucher is verified for a new session
+  onSessionOpen: async (channelId) => {
+    await db.from('sessions').insert({
+      channel_id: channelId,
+      status: 'open',
+      voucher_count: 0,
+    })
+  },
+
+  // Fires after each verified ed25519 commitment (off-chain, no tx fee)
+  onVoucher: async (voucherIndex, cumulativeAmount) => {
+    await db.from('sessions').update({
+      voucher_count: voucherIndex,
+      cumulative_amount: parseFloat(cumulativeAmount),
+    }).eq('channel_id', channelId)
+  },
+
+  // Fires after the on-chain channel close settles the cumulative amount
+  onSettled: async (txHash, totalPaid, mode) => {
+    await db.from('sessions').update({
+      status: 'closed',
+      settlement_tx_hash: txHash,
+    }).eq('channel_id', channelId)
+  },
 }))
 ```
 
+| Hook | When it fires | On-chain? |
+|---|---|---|
+| `onSessionOpen(channelId)` | First verified voucher in a new session | No |
+| `onVoucher(index, cumulativeAmount)` | Each verified ed25519 commitment | No |
+| `onSettled(txHash, amount, mode)` | Channel close transaction confirmed | Yes |
+
 ## Mode Selection Logic
 
 The `ModeRouter` uses this decision tree (deterministic, no randomness):
 
 1. If `{ sustained: true }` passed AND manifest supports `mpp-session` → session
 2. Else if manifest supports `mpp-charge` AND network is Stellar → MPP charge (lower fees)
-3. Else if manifest supports `x402` → x402 with OZ facilitator
+3. Else if manifest supports `x402` → x402 with facilitator
 4. Else throw `RouteDockNoSupportedModeError`
 
 Override with `{ forceMode: 'x402' }` to bypass auto-selection.
 
 ## Security
 
-The `one-way-channel` Soroban contract wrapped by `MppSessionClient` is **unaudited** (`stellar-experimental/one-way-channel`). Safe defaults are enforced: 17280 ledger refund window, durable `SupabaseSessionStore` with monotonic invariant. Production use should await a formal audit.
+The `one-way-channel` Soroban contract wrapped by `MppSessionClient` is **unaudited** (`stellar-experimental/one-way-channel`). Safe defaults are enforced: 17280 ledger refund window, monotonic cumulative enforcement at application, database, and contract layers. Production mainnet use should await a formal audit.
 
 ## License
 

package/dist/index.cjs

@@ -10,9 +10,11 @@ var client$3 = require('@stellar/mpp/charge/client');
 var client$2 = require('mppx/client');
 var client$4 = require('@stellar/mpp/channel/client');
 var facilitator = require('@x402/stellar/exact/facilitator');
-var server$1 = require('@stellar/mpp/charge/server');
-var server = require('mppx/server');
-var server$2 = require('@stellar/mpp/channel/server');
+var server$1 = require('@x402/stellar/exact/server');
+var server = require('@x402/core/server');
+var server$3 = require('@stellar/mpp/charge/server');
+var server$2 = require('mppx/server');
+var server$4 = require('@stellar/mpp/channel/server');
 
 function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 
@@ -611,13 +613,29 @@ var CAIP22 = {
   testnet: "stellar:testnet",
   mainnet: "stellar:pubnet"
 };
+var OZ_FACILITATOR_URL = "https://channels.openzeppelin.com/x402";
 function createX402Handler(opts) {
   const caip2 = CAIP22[opts.network];
   const payeeKeypair = stellarSdk.Keypair.fromSecret(opts.payeeSecretKey);
   const signer = stellar.createEd25519Signer(opts.payeeSecretKey, caip2);
-  const facilitatorScheme = new facilitator.ExactStellarScheme([signer], {
+  const useOzFacilitator = opts.network === "mainnet" && opts.facilitatorApiKey;
+  const localFacilitator = new facilitator.ExactStellarScheme([signer], {
     areFeesSponsored: true
   });
+  let ozServer = null;
+  if (useOzFacilitator) {
+    const apiKey = opts.facilitatorApiKey;
+    const facilitator = new server.HTTPFacilitatorClient({
+      url: OZ_FACILITATOR_URL,
+      createAuthHeaders: async () => ({
+        verify: { Authorization: `Bearer ${apiKey}` },
+        settle: { Authorization: `Bearer ${apiKey}` },
+        supported: { Authorization: `Bearer ${apiKey}` }
+      })
+    });
+    ozServer = new server.x402ResourceServer(facilitator);
+    ozServer.register(caip2, new server$1.ExactStellarScheme());
+  }
   const amountInBaseUnits = String(Math.round(parseFloat(opts.amount) * 1e7));
   const requirements = {
     scheme: "exact",
@@ -628,52 +646,78 @@ function createX402Handler(opts) {
     maxTimeoutSeconds: 60,
     extra: {
       areFeesSponsored: true,
-      facilitatorAddresses: [payeeKeypair.publicKey()]
+      ...useOzFacilitator ? {} : { facilitatorAddresses: [payeeKeypair.publicKey()] }
     }
   };
   return async (req, res, next) => {
     try {
       const paymentHeader = req.headers["payment-signature"] ?? req.headers["x-payment"];
       if (!paymentHeader) {
-        const x402Response = {
-          x402Version: 2,
-          resource: {
+        if (ozServer) {
+          const resourceInfo = {
             url: `${req.protocol}://${req.get("host") ?? ""}${req.originalUrl}`,
             description: opts.manifest.name
-          },
-          accepts: [requirements]
-        };
-        res.status(402).setHeader("Content-Type", "application/json").setHeader("X-Payment-Requirements", http.encodePaymentRequiredHeader(x402Response)).json({ error: "Payment Required" });
+          };
+          const paymentRequired = await ozServer.createPaymentRequiredResponse(
+            [requirements],
+            resourceInfo
+          );
+          res.status(402).setHeader("Content-Type", "application/json").setHeader("X-Payment-Requirements", http.encodePaymentRequiredHeader(paymentRequired)).json({ error: "Payment Required" });
+        } else {
+          const x402Response = {
+            x402Version: 2,
+            resource: {
+              url: `${req.protocol}://${req.get("host") ?? ""}${req.originalUrl}`,
+              description: opts.manifest.name
+            },
+            accepts: [requirements]
+          };
+          res.status(402).setHeader("Content-Type", "application/json").setHeader("X-Payment-Requirements", http.encodePaymentRequiredHeader(x402Response)).json({ error: "Payment Required" });
+        }
         return;
       }
       const payload = http.decodePaymentSignatureHeader(paymentHeader);
-      const verifyResult = await facilitatorScheme.verify(
-        payload,
-        requirements
-      );
-      if (!verifyResult.isValid) {
-        res.status(401).json({
-          error: "Payment verification failed",
-          reason: verifyResult.invalidReason
-        });
-        return;
+      let txHash = null;
+      if (ozServer) {
+        const settleResult = await ozServer.settlePayment(payload, requirements);
+        txHash = settleResult.transaction ?? null;
+        if (settleResult) {
+          res.setHeader(
+            "X-Payment-Response",
+            http.encodePaymentResponseHeader(
+              settleResult
+            )
+          );
+        }
+      } else {
+        const verifyResult = await localFacilitator.verify(
+          payload,
+          requirements
+        );
+        if (!verifyResult.isValid) {
+          res.status(401).json({
+            error: "Payment verification failed",
+            reason: verifyResult.invalidReason
+          });
+          return;
+        }
+        const settleResult = await localFacilitator.settle(
+          payload,
+          requirements
+        );
+        txHash = settleResult.transaction ?? null;
+        if (settleResult) {
+          res.setHeader(
+            "X-Payment-Response",
+            http.encodePaymentResponseHeader(
+              settleResult
+            )
+          );
+        }
       }
-      const settleResult = await facilitatorScheme.settle(
-        payload,
-        requirements
-      );
-      const txHash = settleResult.transaction ?? null;
       if (txHash && opts.onSettled) {
         await opts.onSettled(txHash, opts.amount, "x402");
       }
-      if (settleResult) {
-        res.setHeader(
-          "X-Payment-Response",
-          http.encodePaymentResponseHeader(
-            settleResult
-          )
-        );
-      }
       next();
     } catch (err) {
       console.error("[x402] Settlement error:", err);
@@ -688,10 +732,10 @@ var MPP_NETWORK = {
 function createMppChargeHandler(opts) {
   const networkId = MPP_NETWORK[opts.network];
   const amountHumanReadable = opts.amount;
-  const mppx = server.Mppx.create({
+  const mppx = server$2.Mppx.create({
     secretKey: opts.payeeSecretKey,
     methods: [
-      server$1.stellar.charge({
+      server$3.stellar.charge({
         recipient: opts.manifest.payee,
         currency: opts.assetContract,
         network: networkId,
@@ -701,7 +745,7 @@ function createMppChargeHandler(opts) {
   });
   return async (req, res, next) => {
     try {
-      const fetchReq = server.Request.fromNodeListener(req, res);
+      const fetchReq = server$2.Request.fromNodeListener(req, res);
       const handler = mppx["stellar/charge"];
       const result = await handler({
         amount: amountHumanReadable,
@@ -745,8 +789,10 @@ function createMppSessionHandler(opts) {
   const rateHuman = opts.rate;
   const payeeKeypair = stellarSdk.Keypair.fromSecret(opts.payeeSecretKey);
   const cumulativeKey = `stellar:channel:cumulative:${opts.channelContract}`;
-  const innerStore = server$2.Store.memory();
+  const innerStore = server$4.Store.memory();
   let lastCumulativeAmount = 0n;
+  let voucherCount = 0;
+  let sessionOpened = false;
   const wrappedStore = {
     async get(key) {
       return innerStore.get(key);
@@ -755,16 +801,27 @@ function createMppSessionHandler(opts) {
       await innerStore.put(key, value);
       if (key === cumulativeKey && value && typeof value === "object" && "amount" in value) {
         lastCumulativeAmount = BigInt(value.amount);
+        voucherCount++;
+        if (!sessionOpened) {
+          sessionOpened = true;
+          if (opts.onSessionOpen) {
+            await opts.onSessionOpen(opts.channelContract);
+          }
+        }
+        if (opts.onVoucher) {
+          const humanAmount = (Number(lastCumulativeAmount) / 1e7).toFixed(7);
+          await opts.onVoucher(voucherCount, humanAmount);
+        }
       }
     },
     async delete(key) {
       return innerStore.delete(key);
     }
   };
-  const mppx = server.Mppx.create({
+  const mppx = server$2.Mppx.create({
     secretKey: opts.payeeSecretKey,
     methods: [
-      server$2.stellar.channel({
+      server$4.stellar.channel({
         channel: opts.channelContract,
         commitmentKey: opts.commitmentPublicKey,
         network: networkId,
@@ -782,7 +839,7 @@ function createMppSessionHandler(opts) {
         const closeAmount = body?.amount ? BigInt(body.amount) : lastCumulativeAmount;
         const closeSig = body?.signature ?? lastSignatureHex;
         if (closeAmount > 0n && closeSig) {
-          const closeTxHash = await server$2.close({
+          const closeTxHash = await server$4.close({
             channel: opts.channelContract,
             amount: closeAmount,
             signature: Buffer.from(closeSig, "hex"),
@@ -797,6 +854,9 @@ function createMppSessionHandler(opts) {
         } else {
           res.json({ closeTxHash: null, message: "no vouchers received" });
         }
+        sessionOpened = false;
+        voucherCount = 0;
+        lastCumulativeAmount = 0n;
         return;
       }
       const authHeader = req.headers["authorization"];
@@ -813,7 +873,7 @@ function createMppSessionHandler(opts) {
         } catch {
         }
       }
-      const fetchReq = server.Request.fromNodeListener(req, res);
+      const fetchReq = server$2.Request.fromNodeListener(req, res);
       const result = await mppx.channel({
         amount: rateHuman,
         description: opts.manifest.name
@@ -882,7 +942,9 @@ function routedock(opts) {
           assetContract: opts.assetContract,
           manifest: opts.manifest,
           commitmentPublicKey: opts.commitmentPublicKey,
-          ...opts.onSettled ? { onSettled: opts.onSettled } : {}
+          ...opts.onSettled ? { onSettled: opts.onSettled } : {},
+          ...opts.onSessionOpen ? { onSessionOpen: opts.onSessionOpen } : {},
+          ...opts.onVoucher ? { onVoucher: opts.onVoucher } : {}
         })
       );
     }

package/dist/index.d.cts

@@ -1,6 +1,6 @@
 export { P as PaymentMode, a as PaymentResult, b as PricingConfig, R as RouteDockError, c as RouteDockManifest, d as RouteDockManifestError, e as RouteDockNoSupportedModeError, f as RouteDockPolicyRejectedError, g as RouteDockSessionError, S as SessionCloseResult, h as SessionHandle, i as SessionPricingConfig, j as SessionState, k as SessionStore, l as SupabaseSessionStore } from './SessionStore-CCVO0PHM.cjs';
 export { ModeSelectOptions, MppChargeClient, MppSessionClient, RouteDockClient, RouteDockClientConfig, SpendCap, X402Client, fetchManifest, selectMode } from './client.cjs';
-export { R as RouteDockMiddlewareOptions, r as routedock } from './routedockMiddleware-Beqan6QS.cjs';
+export { R as RouteDockMiddlewareOptions, r as routedock } from './routedockMiddleware-B7WTB3LT.cjs';
 import '@supabase/supabase-js';
 import '@stellar/stellar-sdk';
 import 'express';

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 export { P as PaymentMode, a as PaymentResult, b as PricingConfig, R as RouteDockError, c as RouteDockManifest, d as RouteDockManifestError, e as RouteDockNoSupportedModeError, f as RouteDockPolicyRejectedError, g as RouteDockSessionError, S as SessionCloseResult, h as SessionHandle, i as SessionPricingConfig, j as SessionState, k as SessionStore, l as SupabaseSessionStore } from './SessionStore-CCVO0PHM.js';
 export { ModeSelectOptions, MppChargeClient, MppSessionClient, RouteDockClient, RouteDockClientConfig, SpendCap, X402Client, fetchManifest, selectMode } from './client.js';
-export { R as RouteDockMiddlewareOptions, r as routedock } from './routedockMiddleware-CqnyHjhO.js';
+export { R as RouteDockMiddlewareOptions, r as routedock } from './routedockMiddleware-DRgdrycG.js';
 import '@supabase/supabase-js';
 import '@stellar/stellar-sdk';
 import 'express';

package/dist/index.js

@@ -8,6 +8,8 @@ import { stellar } from '@stellar/mpp/charge/client';
 import { Mppx } from 'mppx/client';
 import { stellar as stellar$1 } from '@stellar/mpp/channel/client';
 import { ExactStellarScheme as ExactStellarScheme$1 } from '@x402/stellar/exact/facilitator';
+import { ExactStellarScheme as ExactStellarScheme$2 } from '@x402/stellar/exact/server';
+import { HTTPFacilitatorClient, x402ResourceServer } from '@x402/core/server';
 import { stellar as stellar$2 } from '@stellar/mpp/charge/server';
 import { Mppx as Mppx$1, Request } from 'mppx/server';
 import { Store, stellar as stellar$3, close } from '@stellar/mpp/channel/server';
@@ -605,13 +607,29 @@ var CAIP22 = {
   testnet: "stellar:testnet",
   mainnet: "stellar:pubnet"
 };
+var OZ_FACILITATOR_URL = "https://channels.openzeppelin.com/x402";
 function createX402Handler(opts) {
   const caip2 = CAIP22[opts.network];
   const payeeKeypair = Keypair.fromSecret(opts.payeeSecretKey);
   const signer = createEd25519Signer(opts.payeeSecretKey, caip2);
-  const facilitatorScheme = new ExactStellarScheme$1([signer], {
+  const useOzFacilitator = opts.network === "mainnet" && opts.facilitatorApiKey;
+  const localFacilitator = new ExactStellarScheme$1([signer], {
     areFeesSponsored: true
   });
+  let ozServer = null;
+  if (useOzFacilitator) {
+    const apiKey = opts.facilitatorApiKey;
+    const facilitator = new HTTPFacilitatorClient({
+      url: OZ_FACILITATOR_URL,
+      createAuthHeaders: async () => ({
+        verify: { Authorization: `Bearer ${apiKey}` },
+        settle: { Authorization: `Bearer ${apiKey}` },
+        supported: { Authorization: `Bearer ${apiKey}` }
+      })
+    });
+    ozServer = new x402ResourceServer(facilitator);
+    ozServer.register(caip2, new ExactStellarScheme$2());
+  }
   const amountInBaseUnits = String(Math.round(parseFloat(opts.amount) * 1e7));
   const requirements = {
     scheme: "exact",
@@ -622,52 +640,78 @@ function createX402Handler(opts) {
     maxTimeoutSeconds: 60,
     extra: {
       areFeesSponsored: true,
-      facilitatorAddresses: [payeeKeypair.publicKey()]
+      ...useOzFacilitator ? {} : { facilitatorAddresses: [payeeKeypair.publicKey()] }
     }
   };
   return async (req, res, next) => {
     try {
       const paymentHeader = req.headers["payment-signature"] ?? req.headers["x-payment"];
       if (!paymentHeader) {
-        const x402Response = {
-          x402Version: 2,
-          resource: {
+        if (ozServer) {
+          const resourceInfo = {
             url: `${req.protocol}://${req.get("host") ?? ""}${req.originalUrl}`,
             description: opts.manifest.name
-          },
-          accepts: [requirements]
-        };
-        res.status(402).setHeader("Content-Type", "application/json").setHeader("X-Payment-Requirements", encodePaymentRequiredHeader(x402Response)).json({ error: "Payment Required" });
+          };
+          const paymentRequired = await ozServer.createPaymentRequiredResponse(
+            [requirements],
+            resourceInfo
+          );
+          res.status(402).setHeader("Content-Type", "application/json").setHeader("X-Payment-Requirements", encodePaymentRequiredHeader(paymentRequired)).json({ error: "Payment Required" });
+        } else {
+          const x402Response = {
+            x402Version: 2,
+            resource: {
+              url: `${req.protocol}://${req.get("host") ?? ""}${req.originalUrl}`,
+              description: opts.manifest.name
+            },
+            accepts: [requirements]
+          };
+          res.status(402).setHeader("Content-Type", "application/json").setHeader("X-Payment-Requirements", encodePaymentRequiredHeader(x402Response)).json({ error: "Payment Required" });
+        }
         return;
       }
       const payload = decodePaymentSignatureHeader(paymentHeader);
-      const verifyResult = await facilitatorScheme.verify(
-        payload,
-        requirements
-      );
-      if (!verifyResult.isValid) {
-        res.status(401).json({
-          error: "Payment verification failed",
-          reason: verifyResult.invalidReason
-        });
-        return;
+      let txHash = null;
+      if (ozServer) {
+        const settleResult = await ozServer.settlePayment(payload, requirements);
+        txHash = settleResult.transaction ?? null;
+        if (settleResult) {
+          res.setHeader(
+            "X-Payment-Response",
+            encodePaymentResponseHeader(
+              settleResult
+            )
+          );
+        }
+      } else {
+        const verifyResult = await localFacilitator.verify(
+          payload,
+          requirements
+        );
+        if (!verifyResult.isValid) {
+          res.status(401).json({
+            error: "Payment verification failed",
+            reason: verifyResult.invalidReason
+          });
+          return;
+        }
+        const settleResult = await localFacilitator.settle(
+          payload,
+          requirements
+        );
+        txHash = settleResult.transaction ?? null;
+        if (settleResult) {
+          res.setHeader(
+            "X-Payment-Response",
+            encodePaymentResponseHeader(
+              settleResult
+            )
+          );
+        }
       }
-      const settleResult = await facilitatorScheme.settle(
-        payload,
-        requirements
-      );
-      const txHash = settleResult.transaction ?? null;
       if (txHash && opts.onSettled) {
         await opts.onSettled(txHash, opts.amount, "x402");
       }
-      if (settleResult) {
-        res.setHeader(
-          "X-Payment-Response",
-          encodePaymentResponseHeader(
-            settleResult
-          )
-        );
-      }
       next();
     } catch (err) {
       console.error("[x402] Settlement error:", err);
@@ -741,6 +785,8 @@ function createMppSessionHandler(opts) {
   const cumulativeKey = `stellar:channel:cumulative:${opts.channelContract}`;
   const innerStore = Store.memory();
   let lastCumulativeAmount = 0n;
+  let voucherCount = 0;
+  let sessionOpened = false;
   const wrappedStore = {
     async get(key) {
       return innerStore.get(key);
@@ -749,6 +795,17 @@ function createMppSessionHandler(opts) {
       await innerStore.put(key, value);
       if (key === cumulativeKey && value && typeof value === "object" && "amount" in value) {
         lastCumulativeAmount = BigInt(value.amount);
+        voucherCount++;
+        if (!sessionOpened) {
+          sessionOpened = true;
+          if (opts.onSessionOpen) {
+            await opts.onSessionOpen(opts.channelContract);
+          }
+        }
+        if (opts.onVoucher) {
+          const humanAmount = (Number(lastCumulativeAmount) / 1e7).toFixed(7);
+          await opts.onVoucher(voucherCount, humanAmount);
+        }
       }
     },
     async delete(key) {
@@ -791,6 +848,9 @@ function createMppSessionHandler(opts) {
         } else {
           res.json({ closeTxHash: null, message: "no vouchers received" });
         }
+        sessionOpened = false;
+        voucherCount = 0;
+        lastCumulativeAmount = 0n;
         return;
       }
       const authHeader = req.headers["authorization"];
@@ -876,7 +936,9 @@ function routedock(opts) {
           assetContract: opts.assetContract,
           manifest: opts.manifest,
           commitmentPublicKey: opts.commitmentPublicKey,
-          ...opts.onSettled ? { onSettled: opts.onSettled } : {}
+          ...opts.onSettled ? { onSettled: opts.onSettled } : {},
+          ...opts.onSessionOpen ? { onSessionOpen: opts.onSessionOpen } : {},
+          ...opts.onVoucher ? { onVoucher: opts.onVoucher } : {}
         })
       );
     }