@openfacilitator/sdk 0.5.0 → 0.6.1

package/dist/index.d.mts

@@ -527,12 +527,12 @@ declare function createPaymentContext(settleResponse: {
 interface PaymentMiddlewareConfig {
     /** Facilitator instance or URL */
     facilitator: OpenFacilitator | string;
-    /** Function to get payment requirements for the request */
-    getRequirements: (req: unknown) => PaymentRequirements | Promise<PaymentRequirements>;
+    /** Function to get payment requirements for the request (single or multiple for multi-network) */
+    getRequirements: (req: unknown) => PaymentRequirements | PaymentRequirements[] | Promise<PaymentRequirements | PaymentRequirements[]>;
     /** Optional: Refund protection config (enables auto failure reporting) */
     refundProtection?: RefundProtectionConfig;
     /** Optional: Custom 402 response handler */
-    on402?: (req: unknown, res: unknown, requirements: PaymentRequirements) => void | Promise<void>;
+    on402?: (req: unknown, res: unknown, requirements: PaymentRequirements[]) => void | Promise<void>;
 }
 /**
  * Create x402 payment middleware that handles verification, settlement, and optional refund protection.
@@ -580,8 +580,8 @@ declare function createPaymentMiddleware(config: PaymentMiddlewareConfig): (req:
 interface HonoPaymentConfig {
     /** Facilitator instance or URL */
     facilitator: OpenFacilitator | string;
-    /** Function to get payment requirements for the request */
-    getRequirements: (c: HonoContext) => PaymentRequirements | Promise<PaymentRequirements>;
+    /** Function to get payment requirements for the request (single or multiple for multi-network) */
+    getRequirements: (c: HonoContext) => PaymentRequirements | PaymentRequirements[] | Promise<PaymentRequirements | PaymentRequirements[]>;
     /** Optional: Refund protection config */
     refundProtection?: RefundProtectionConfig;
 }

package/dist/index.d.ts

@@ -527,12 +527,12 @@ declare function createPaymentContext(settleResponse: {
 interface PaymentMiddlewareConfig {
     /** Facilitator instance or URL */
     facilitator: OpenFacilitator | string;
-    /** Function to get payment requirements for the request */
-    getRequirements: (req: unknown) => PaymentRequirements | Promise<PaymentRequirements>;
+    /** Function to get payment requirements for the request (single or multiple for multi-network) */
+    getRequirements: (req: unknown) => PaymentRequirements | PaymentRequirements[] | Promise<PaymentRequirements | PaymentRequirements[]>;
     /** Optional: Refund protection config (enables auto failure reporting) */
     refundProtection?: RefundProtectionConfig;
     /** Optional: Custom 402 response handler */
-    on402?: (req: unknown, res: unknown, requirements: PaymentRequirements) => void | Promise<void>;
+    on402?: (req: unknown, res: unknown, requirements: PaymentRequirements[]) => void | Promise<void>;
 }
 /**
  * Create x402 payment middleware that handles verification, settlement, and optional refund protection.
@@ -580,8 +580,8 @@ declare function createPaymentMiddleware(config: PaymentMiddlewareConfig): (req:
 interface HonoPaymentConfig {
     /** Facilitator instance or URL */
     facilitator: OpenFacilitator | string;
-    /** Function to get payment requirements for the request */
-    getRequirements: (c: HonoContext) => PaymentRequirements | Promise<PaymentRequirements>;
+    /** Function to get payment requirements for the request (single or multiple for multi-network) */
+    getRequirements: (c: HonoContext) => PaymentRequirements | PaymentRequirements[] | Promise<PaymentRequirements | PaymentRequirements[]>;
     /** Optional: Refund protection config */
     refundProtection?: RefundProtectionConfig;
 }

package/dist/index.js

@@ -572,31 +572,36 @@ function createPaymentMiddleware(config) {
   const facilitator = typeof config.facilitator === "string" ? new OpenFacilitator({ url: config.facilitator }) : config.facilitator;
   return async (req, res, next) => {
     try {
-      const requirements = await config.getRequirements(req);
+      const rawRequirements = await config.getRequirements(req);
+      const requirementsArray = Array.isArray(rawRequirements) ? rawRequirements : [rawRequirements];
       const paymentHeader = req.headers["x-payment"];
       const paymentString = Array.isArray(paymentHeader) ? paymentHeader[0] : paymentHeader;
       if (!paymentString) {
         if (config.on402) {
-          await config.on402(req, res, requirements);
+          await config.on402(req, res, requirementsArray);
         } else {
-          const extra = {
-            ...requirements.extra
-          };
-          if (config.refundProtection) {
-            extra.supportsRefunds = true;
-          }
+          const accepts = requirementsArray.map((requirements2) => {
+            const extra = {
+              ...requirements2.extra
+            };
+            if (config.refundProtection) {
+              extra.supportsRefunds = true;
+            }
+            return {
+              scheme: requirements2.scheme,
+              network: requirements2.network,
+              maxAmountRequired: requirements2.maxAmountRequired,
+              asset: requirements2.asset,
+              payTo: requirements2.payTo,
+              resource: requirements2.resource || req.url,
+              description: requirements2.description,
+              ...Object.keys(extra).length > 0 ? { extra } : {}
+            };
+          });
           res.status(402).json({
+            x402Version: 2,
             error: "Payment Required",
-            accepts: [{
-              scheme: requirements.scheme,
-              network: requirements.network,
-              maxAmountRequired: requirements.maxAmountRequired,
-              asset: requirements.asset,
-              payTo: requirements.payTo,
-              resource: requirements.resource || req.url,
-              description: requirements.description,
-              ...Object.keys(extra).length > 0 ? { extra } : {}
-            }]
+            accepts
           });
         }
         return;
@@ -611,6 +616,8 @@ function createPaymentMiddleware(config) {
         res.status(400).json({ error: "Invalid X-PAYMENT header" });
         return;
       }
+      const paymentNetwork = paymentPayload.network;
+      const requirements = requirementsArray.find((r) => r.network === paymentNetwork) || requirementsArray[0];
       const verifyResult = await facilitator.verify(paymentPayload, requirements);
       if (!verifyResult.isValid) {
         res.status(402).json({
@@ -675,27 +682,32 @@ function createPaymentMiddleware(config) {
 function honoPaymentMiddleware(config) {
   const facilitator = typeof config.facilitator === "string" ? new OpenFacilitator({ url: config.facilitator }) : config.facilitator;
   return async (c, next) => {
-    const requirements = await config.getRequirements(c);
+    const rawRequirements = await config.getRequirements(c);
+    const requirementsArray = Array.isArray(rawRequirements) ? rawRequirements : [rawRequirements];
     const paymentString = c.req.header("x-payment");
     if (!paymentString) {
-      const extra = {
-        ...requirements.extra
-      };
-      if (config.refundProtection) {
-        extra.supportsRefunds = true;
-      }
+      const accepts = requirementsArray.map((requirements2) => {
+        const extra = {
+          ...requirements2.extra
+        };
+        if (config.refundProtection) {
+          extra.supportsRefunds = true;
+        }
+        return {
+          scheme: requirements2.scheme,
+          network: requirements2.network,
+          maxAmountRequired: requirements2.maxAmountRequired,
+          asset: requirements2.asset,
+          payTo: requirements2.payTo,
+          resource: requirements2.resource || c.req.url,
+          description: requirements2.description,
+          ...Object.keys(extra).length > 0 ? { extra } : {}
+        };
+      });
       return c.json({
+        x402Version: 2,
         error: "Payment Required",
-        accepts: [{
-          scheme: requirements.scheme,
-          network: requirements.network,
-          maxAmountRequired: requirements.maxAmountRequired,
-          asset: requirements.asset,
-          payTo: requirements.payTo,
-          resource: requirements.resource || c.req.url,
-          description: requirements.description,
-          ...Object.keys(extra).length > 0 ? { extra } : {}
-        }]
+        accepts
       }, 402);
     }
     let paymentPayload;
@@ -707,6 +719,8 @@ function honoPaymentMiddleware(config) {
     } catch {
       return c.json({ error: "Invalid X-PAYMENT header" }, 400);
     }
+    const paymentNetwork = paymentPayload.network;
+    const requirements = requirementsArray.find((r) => r.network === paymentNetwork) || requirementsArray[0];
     const verifyResult = await facilitator.verify(paymentPayload, requirements);
     if (!verifyResult.isValid) {
       return c.json({

package/dist/index.mjs

@@ -521,31 +521,36 @@ function createPaymentMiddleware(config) {
   const facilitator = typeof config.facilitator === "string" ? new OpenFacilitator({ url: config.facilitator }) : config.facilitator;
   return async (req, res, next) => {
     try {
-      const requirements = await config.getRequirements(req);
+      const rawRequirements = await config.getRequirements(req);
+      const requirementsArray = Array.isArray(rawRequirements) ? rawRequirements : [rawRequirements];
       const paymentHeader = req.headers["x-payment"];
       const paymentString = Array.isArray(paymentHeader) ? paymentHeader[0] : paymentHeader;
       if (!paymentString) {
         if (config.on402) {
-          await config.on402(req, res, requirements);
+          await config.on402(req, res, requirementsArray);
         } else {
-          const extra = {
-            ...requirements.extra
-          };
-          if (config.refundProtection) {
-            extra.supportsRefunds = true;
-          }
+          const accepts = requirementsArray.map((requirements2) => {
+            const extra = {
+              ...requirements2.extra
+            };
+            if (config.refundProtection) {
+              extra.supportsRefunds = true;
+            }
+            return {
+              scheme: requirements2.scheme,
+              network: requirements2.network,
+              maxAmountRequired: requirements2.maxAmountRequired,
+              asset: requirements2.asset,
+              payTo: requirements2.payTo,
+              resource: requirements2.resource || req.url,
+              description: requirements2.description,
+              ...Object.keys(extra).length > 0 ? { extra } : {}
+            };
+          });
           res.status(402).json({
+            x402Version: 2,
             error: "Payment Required",
-            accepts: [{
-              scheme: requirements.scheme,
-              network: requirements.network,
-              maxAmountRequired: requirements.maxAmountRequired,
-              asset: requirements.asset,
-              payTo: requirements.payTo,
-              resource: requirements.resource || req.url,
-              description: requirements.description,
-              ...Object.keys(extra).length > 0 ? { extra } : {}
-            }]
+            accepts
           });
         }
         return;
@@ -560,6 +565,8 @@ function createPaymentMiddleware(config) {
         res.status(400).json({ error: "Invalid X-PAYMENT header" });
         return;
       }
+      const paymentNetwork = paymentPayload.network;
+      const requirements = requirementsArray.find((r) => r.network === paymentNetwork) || requirementsArray[0];
       const verifyResult = await facilitator.verify(paymentPayload, requirements);
       if (!verifyResult.isValid) {
         res.status(402).json({
@@ -624,27 +631,32 @@ function createPaymentMiddleware(config) {
 function honoPaymentMiddleware(config) {
   const facilitator = typeof config.facilitator === "string" ? new OpenFacilitator({ url: config.facilitator }) : config.facilitator;
   return async (c, next) => {
-    const requirements = await config.getRequirements(c);
+    const rawRequirements = await config.getRequirements(c);
+    const requirementsArray = Array.isArray(rawRequirements) ? rawRequirements : [rawRequirements];
     const paymentString = c.req.header("x-payment");
     if (!paymentString) {
-      const extra = {
-        ...requirements.extra
-      };
-      if (config.refundProtection) {
-        extra.supportsRefunds = true;
-      }
+      const accepts = requirementsArray.map((requirements2) => {
+        const extra = {
+          ...requirements2.extra
+        };
+        if (config.refundProtection) {
+          extra.supportsRefunds = true;
+        }
+        return {
+          scheme: requirements2.scheme,
+          network: requirements2.network,
+          maxAmountRequired: requirements2.maxAmountRequired,
+          asset: requirements2.asset,
+          payTo: requirements2.payTo,
+          resource: requirements2.resource || c.req.url,
+          description: requirements2.description,
+          ...Object.keys(extra).length > 0 ? { extra } : {}
+        };
+      });
       return c.json({
+        x402Version: 2,
         error: "Payment Required",
-        accepts: [{
-          scheme: requirements.scheme,
-          network: requirements.network,
-          maxAmountRequired: requirements.maxAmountRequired,
-          asset: requirements.asset,
-          payTo: requirements.payTo,
-          resource: requirements.resource || c.req.url,
-          description: requirements.description,
-          ...Object.keys(extra).length > 0 ? { extra } : {}
-        }]
+        accepts
       }, 402);
     }
     let paymentPayload;
@@ -656,6 +668,8 @@ function honoPaymentMiddleware(config) {
     } catch {
       return c.json({ error: "Invalid X-PAYMENT header" }, 400);
     }
+    const paymentNetwork = paymentPayload.network;
+    const requirements = requirementsArray.find((r) => r.network === paymentNetwork) || requirementsArray[0];
     const verifyResult = await facilitator.verify(paymentPayload, requirements);
     if (!verifyResult.isValid) {
       return c.json({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openfacilitator/sdk",
-  "version": "0.5.0",
+  "version": "0.6.1",
   "description": "TypeScript SDK for x402 payment facilitation",
   "main": "dist/index.js",
   "module": "dist/index.mjs",