@4mica/x402 1.2.0 → 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/dist/client/scheme.js

@@ -2,6 +2,7 @@ import { Client, ConfigBuilder, X402Flow, } from '@4mica/sdk';
 import { SUPPORTED_NETWORKS } from '../server/scheme.js';
 const NETWORK_RPC_URLS = {
     'eip155:11155111': 'https://ethereum.sepolia.api.4mica.xyz',
+    'eip155:84532': 'https://base.sepolia.api.4mica.xyz',
     'eip155:80002': 'https://api.4mica.xyz',
 };
 export class FourMicaEvmScheme {

package/dist/index.d.ts

@@ -1 +1,2 @@
 export type { PaymentRequired, PaymentRequirements, PaymentPayload, Network, SchemeNetworkServer, } from '@x402/core/types';
+export type { FourMicaPaymentRequirementsV2, FourMicaV2RequirementsExtra } from './types.js';

package/dist/server/scheme.js

@@ -1,4 +1,4 @@
-export const SUPPORTED_NETWORKS = ['eip155:11155111', 'eip155:80002'];
+export const SUPPORTED_NETWORKS = ['eip155:11155111', 'eip155:84532', 'eip155:80002'];
 /**
  * EVM server implementation for the 4mica payment scheme.
  */
@@ -163,6 +163,12 @@ export class FourMicaEvmScheme {
                 version: '2',
                 decimals: 6,
             }, // Ethereum Sepolia USDC
+            'eip155:84532': {
+                address: '0x036CbD53842c5426634e7929541eC2318f3dCF7e',
+                name: 'USDC',
+                version: '2',
+                decimals: 6,
+            }, // Base Sepolia USDC
             'eip155:80002': {
                 address: '0x41E94Eb019C0762f9Bfcf9Fb1E58725BfB0e7582',
                 name: 'USDC',

package/dist/types.d.ts

@@ -0,0 +1,22 @@
+import { PaymentRequirements } from '@x402/core/types';
+/**
+ * Extra fields required by the 4mica V2 validation policy.
+ */
+export type FourMicaV2RequirementsExtra = {
+    validationRegistryAddress: string;
+    validatorAddress: string;
+    validatorAgentId: string | number;
+    minValidationScore: number;
+    jobHash: string;
+    requiredValidationTag?: string;
+    tabEndpoint?: string;
+    rpcUrl?: string;
+    resource?: {
+        url?: string;
+        description?: string;
+        mimeType?: string;
+    };
+};
+export type FourMicaPaymentRequirementsV2 = PaymentRequirements & {
+    extra: FourMicaV2RequirementsExtra;
+};

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@4mica/x402",
-  "version": "1.2.0",
+  "version": "1.2.2",
   "type": "module",
   "description": "TypeScript x402 utilities for interacting with the 4Mica payment network",
   "license": "MIT",
@@ -42,9 +42,9 @@
     "demo:dev": "cd demo && yarn dev"
   },
   "dependencies": {
-    "@x402/core": "^2.2.0",
-    "@x402/extensions": "^2.2.0",
-    "@4mica/sdk": "^0.5.3",
+    "@x402/core": "^2.9.0",
+    "@x402/extensions": "^2.9.0",
+    "@4mica/sdk": "^1.2.3",
     "viem": "^2.45.1"
   },
   "devDependencies": {

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,
         })
       ),
     })