@4mica/x402 1.0.1 → 1.2.0

package/README.md

@@ -156,6 +156,22 @@ The recommended middleware factory for most use cases. Automatically configures
 6. **`paywall`** (optional): Custom paywall provider
 7. **`syncFacilitatorOnStart`** (optional): Whether to sync with facilitator on startup (defaults to true)
 
+#### V2 Requirements Extra
+
+When using x402 V2, `paymentRequirements.extra` must include the validation policy fields expected by the 4mica SDKs and facilitator:
+
+```typescript
+const extra = {
+  validationRegistryAddress: '0x3333333333333333333333333333333333333333',
+  validatorAddress: '0x4444444444444444444444444444444444444444',
+  validatorAgentId: '7',
+  minValidationScore: 80,
+  jobHash: '0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa',
+  requiredValidationTag: 'hard-finality', // optional
+  tabEndpoint: 'https://api.example.com/tabs/open',
+}
+```
+
 #### Supported Networks
 
 - `eip155:11155111` - Ethereum Sepolia

package/package.json

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

package/src/client/scheme.ts

@@ -12,6 +12,7 @@ import { SUPPORTED_NETWORKS } from '../server/scheme.js'
 
 const NETWORK_RPC_URLS: Record<Network, string> = {
   'eip155:11155111': 'https://ethereum.sepolia.api.4mica.xyz',
+  'eip155:84532': 'https://base.sepolia.api.4mica.xyz',
   'eip155:80002': 'https://api.4mica.xyz',
 }
 

package/src/index.ts

@@ -5,3 +5,5 @@ export type {
   Network,
   SchemeNetworkServer,
 } from '@x402/core/types'
+
+export type { FourMicaPaymentRequirementsV2, FourMicaV2RequirementsExtra } from './types.js'

package/src/server/scheme.ts

@@ -7,7 +7,7 @@ import {
   MoneyParser,
 } from '@x402/core/types'
 
-export const SUPPORTED_NETWORKS: Network[] = ['eip155:11155111', 'eip155:80002']
+export const SUPPORTED_NETWORKS: Network[] = ['eip155:11155111', 'eip155:84532', 'eip155:80002']
 
 /**
  * EVM server implementation for the 4mica payment scheme.
@@ -205,6 +205,12 @@ export class FourMicaEvmScheme implements SchemeNetworkServer {
         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/src/types.ts

@@ -0,0 +1,24 @@
+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/tests/client-scheme.test.ts

@@ -39,6 +39,7 @@ describe('FourMicaEvmScheme', () => {
         validatorAgentId: '7',
         minValidationScore: 80,
         requiredValidationTag: 'hard-finality',
+        jobHash: '0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa',
         resource: {
           url: 'https://api.example.com/premium',
           description: 'Premium dataset',
@@ -73,6 +74,7 @@ describe('FourMicaEvmScheme', () => {
       validatorAgentId: '7',
       minValidationScore: 80,
       requiredValidationTag: 'hard-finality',
+      jobHash: '0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa',
     })
   })