@4mica/x402 1.2.1 → 1.2.2

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@4mica/x402",
-  "version": "1.2.1",
+  "version": "1.2.2",
   "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,
         })
       ),
     })