@4mica/x402 1.2.1 → 1.2.3

package/demo/src/server.ts

@@ -7,6 +7,9 @@ app.use(express.json())
 
 const PORT = process.env.PORT || 3000
 const PAY_TO_ADDRESS = process.env.PAY_TO_ADDRESS
+// This endpoint is hosted by this resource server. Clients call it after receiving
+// a 402 response, and the middleware below forwards the tab-open request to the
+// 4Mica facilitator on the server's behalf.
 const ADVERTISED_ENDPOINT =
   process.env.ADVERTISED_ENDPOINT || `http://localhost:${PORT}/payment/tab`
 
@@ -29,6 +32,8 @@ app.use(
       },
     },
     {
+      // The middleware injects this URL into paymentRequirements.extra.tabEndpoint
+      // and also serves the POST route on this Express app.
       advertisedEndpoint: ADVERTISED_ENDPOINT,
       ttlSeconds: 3600, // 1 hour
     }
@@ -70,5 +75,7 @@ app.listen(PORT, () => {
   console.log(`x402 Demo Server running on http://localhost:${PORT}`)
   console.log(`Protected endpoint: http://localhost:${PORT}/api/premium-data`)
   console.log(`Payment required: $0.01 (4mica credit on Sepolia)`)
-  console.log(`Payment tab endpoint: ${ADVERTISED_ENDPOINT}`)
+  console.log(`Tab endpoint hosted by this server: POST ${ADVERTISED_ENDPOINT}`)
+  console.log('Who calls it: payer clients after a 402 Payment Required response')
+  console.log('What it does: opens or reuses a tab via the 4Mica facilitator and returns tab JSON')
 })

package/dist/server/express/index.js

@@ -84,10 +84,10 @@ export function paymentMiddlewareFromHTTPServer(httpServer, tabConfig, paywallCo
             const advertisedUrl = new URL(tabConfig.advertisedEndpoint);
             if (req.path === advertisedUrl.pathname) {
                 // Parse the request body
-                const { userAddress, paymentRequirements } = req.body;
+                const { userAddress, paymentRequirements, x402Version } = req.body;
                 try {
                     // Call the facilitator to open the tab
-                    const openTabResponse = await facilitatorClient.openTab(userAddress, paymentRequirements, tabConfig.ttlSeconds);
+                    const openTabResponse = await facilitatorClient.openTab(userAddress, paymentRequirements, tabConfig.ttlSeconds, x402Version);
                     // Return the response
                     return res.json(openTabResponse);
                 }

package/dist/server/facilitator.d.ts

@@ -33,7 +33,7 @@ export declare class OpenTabError extends Error {
 }
 export declare class FourMicaFacilitatorClient extends HTTPFacilitatorClient {
     constructor(config?: FacilitatorConfig);
-    openTab(userAddress: string, paymentRequirements: PaymentRequirements, ttlSeconds?: number): Promise<OpenTabResponse>;
+    openTab(userAddress: string, paymentRequirements: PaymentRequirements, ttlSeconds?: number, guaranteeVersion?: number): Promise<OpenTabResponse>;
     settle(paymentPayload: PaymentPayload, paymentRequirements: PaymentRequirements): Promise<FourMicaSettleResponse>;
     /**
      * Helper to convert objects to JSON-safe format.

package/dist/server/facilitator.js

@@ -12,7 +12,7 @@ export class FourMicaFacilitatorClient extends HTTPFacilitatorClient {
     constructor(config) {
         super({ ...config, url: config?.url ?? DEFAULT_FACILITATOR_URL });
     }
-    async openTab(userAddress, paymentRequirements, ttlSeconds) {
+    async openTab(userAddress, paymentRequirements, ttlSeconds, guaranteeVersion) {
         let headers = {
             'Content-Type': 'application/json',
         };
@@ -27,6 +27,7 @@ export class FourMicaFacilitatorClient extends HTTPFacilitatorClient {
                 network: paymentRequirements.network,
                 erc20Token: paymentRequirements.asset,
                 ttlSeconds,
+                guaranteeVersion: guaranteeVersion ?? 1,
             })),
         });
         const data = await response.json();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@4mica/x402",
-  "version": "1.2.1",
+  "version": "1.2.3",
   "type": "module",
   "description": "TypeScript x402 utilities for interacting with the 4Mica payment network",
   "license": "MIT",

package/src/server/express/index.ts

@@ -168,14 +168,15 @@ export function paymentMiddlewareFromHTTPServer(
       const advertisedUrl = new URL(tabConfig.advertisedEndpoint)
       if (req.path === advertisedUrl.pathname) {
         // Parse the request body
-        const { userAddress, paymentRequirements } = req.body
+        const { userAddress, paymentRequirements, x402Version } = req.body
 
         try {
           // Call the facilitator to open the tab
           const openTabResponse = await facilitatorClient.openTab(
             userAddress,
             paymentRequirements,
-            tabConfig.ttlSeconds
+            tabConfig.ttlSeconds,
+            x402Version
           )
 
           // Return the response

package/src/server/facilitator.ts

@@ -51,7 +51,8 @@ export class FourMicaFacilitatorClient extends HTTPFacilitatorClient {
   async openTab(
     userAddress: string,
     paymentRequirements: PaymentRequirements,
-    ttlSeconds?: number
+    ttlSeconds?: number,
+    guaranteeVersion?: number
   ): Promise<OpenTabResponse> {
     let headers: Record<string, string> = {
       'Content-Type': 'application/json',
@@ -70,6 +71,7 @@ export class FourMicaFacilitatorClient extends HTTPFacilitatorClient {
           network: paymentRequirements.network,
           erc20Token: paymentRequirements.asset,
           ttlSeconds,
+          guaranteeVersion: guaranteeVersion ?? 1,
         })
       ),
     })