@4mica/x402 1.0.1 → 1.0.2

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.0.2",
   "type": "module",
   "description": "TypeScript x402 utilities for interacting with the 4Mica payment network",
   "license": "MIT",

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