@elizaos/plugin-x402 2.0.0-alpha.6 → 2.0.3-beta.5

package/dist/x402-standard-payment.d.ts

@@ -0,0 +1,130 @@
+/**
+ * Standard x402 **buyer → seller** payloads carried in `PAYMENT-SIGNATURE`, `X-Payment`,
+ * or legacy `X-Payment` headers (often base64-wrapped JSON).
+ *
+ * **Why this file exists:** the agent historically verified “proof strings” (tx
+ * hashes, legacy formats, facilitator payment IDs). Modern clients instead send
+ * a structured **payment payload** plus expect the seller to validate it against
+ * **payment requirements** through a facilitator (`POST /verify`, `POST /settle`).
+ * Centralizing decode, requirement construction, and HTTP calls here keeps
+ * `payment-wrapper.ts` readable and avoids duplicating facilitator contracts.
+ *
+ * **Why verify *and* settle:** authorization-like payloads are not settlement.
+ * Unlocking paid HTTP work only after settle succeeds matches facilitator-centric
+ * flows and closes the “valid signature, no transfer” gap.
+ *
+ * **Why URL helpers are flexible:** facilitator vendors mount `/verify` and
+ * `/settle` under different prefixes; Eliza Cloud uses `/api/v1/x402/*` while
+ * other stacks use a single base URL with trailing paths. Explicit override envs
+ * exist so production does not depend on one hardcoded layout.
+ */
+import { type PaymentConfigDefinition } from "./payment-config.js";
+import type { X402Runtime } from "./types.js";
+/** Decoded X-Payment body (x402-fetch / CDP-style clients). */
+export type X402StandardPaymentPayload = {
+    x402Version: number;
+    accepted: {
+        scheme: string;
+        network: string;
+        asset: string;
+        amount?: string;
+        maxAmountRequired?: string;
+        payTo: string;
+    };
+    payload: {
+        signature: string;
+        authorization: {
+            from: string;
+            to: string;
+            value: string;
+            validAfter?: string;
+            validBefore: string;
+            nonce: string;
+        };
+    };
+};
+export type FacilitatorPaymentRequirements = {
+    scheme: string;
+    network: string;
+    asset: string;
+    amount: string;
+    payTo: string;
+    maxTimeoutSeconds?: number;
+    extra?: Record<string, unknown>;
+};
+export type StandardPaymentRequiredAccept = {
+    scheme: "exact";
+    network: string;
+    maxAmountRequired: string;
+    resource: string;
+    description: string;
+    mimeType: string;
+    payTo: string;
+    maxTimeoutSeconds: number;
+    asset: string;
+    extra?: Record<string, unknown>;
+};
+export type StandardPaymentRequired = {
+    x402Version: 2;
+    accepts: StandardPaymentRequiredAccept[];
+    error?: string;
+};
+/**
+ * Decode `X-Payment` / `X-PAYMENT` value: base64(JSON) first, then raw JSON.
+ */
+export declare function decodeXPaymentHeader(raw: string): unknown | null;
+export declare function isX402StandardPaymentPayload(v: unknown): v is X402StandardPaymentPayload;
+export declare function toStandardNetwork(network: PaymentConfigDefinition["network"]): string;
+export declare function standardAssetForConfig(cfg: PaymentConfigDefinition): string;
+export declare function buildStandardPaymentRequiredAccept(params: {
+    routePath: string;
+    description: string;
+    priceInCents: number;
+    configName: string;
+    agentId?: string;
+}): StandardPaymentRequiredAccept;
+export declare function buildStandardPaymentRequired(params: {
+    routePath: string;
+    description: string;
+    priceInCents: number;
+    paymentConfigNames: string[];
+    agentId?: string;
+    error?: string;
+}): StandardPaymentRequired;
+/**
+ * Build facilitator `paymentRequirements` for this route/config (must match what we advertise in `accepts`).
+ */
+export declare function buildFacilitatorPaymentRequirements(params: {
+    routePath: string;
+    priceInCents: number;
+    configName: string;
+    agentId?: string;
+}): FacilitatorPaymentRequirements;
+export declare function findMatchingPaymentConfigForStandardPayload(payload: X402StandardPaymentPayload, paymentConfigNames: string[], priceInCents: number, agentId?: string): {
+    name: string;
+    cfg: PaymentConfigDefinition;
+} | null;
+export declare function getFacilitatorVerifyPostUrl(runtime: X402Runtime): string | null;
+export declare function getFacilitatorSettlePostUrl(runtime: X402Runtime): string | null;
+export type FacilitatorVerifyPostResult = {
+    ok: true;
+    payer?: string;
+} | {
+    ok: false;
+    invalidReason?: string;
+};
+export type FacilitatorSettlePostResult = {
+    ok: true;
+    paymentResponse: string;
+    transaction?: string;
+    payer?: string;
+} | {
+    ok: false;
+    invalidReason?: string;
+};
+/**
+ * POST `{ paymentPayload, paymentRequirements }` to facilitator verify (Eliza Cloud–compatible).
+ */
+export declare function verifyPaymentPayloadViaFacilitatorPost(runtime: X402Runtime, paymentPayload: X402StandardPaymentPayload, paymentRequirements: FacilitatorPaymentRequirements): Promise<FacilitatorVerifyPostResult>;
+export declare function settlePaymentPayloadViaFacilitatorPost(runtime: X402Runtime, paymentPayload: X402StandardPaymentPayload, paymentRequirements: FacilitatorPaymentRequirements): Promise<FacilitatorSettlePostResult>;
+//# sourceMappingURL=x402-standard-payment.d.ts.map

package/dist/x402-standard-payment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"x402-standard-payment.d.ts","sourceRoot":"","sources":["../src/x402-standard-payment.ts"],"names":[],"mappings":"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"}

package/dist/x402-types.d.ts

@@ -0,0 +1,130 @@
+/**
+ * x402scan Validation Schema Types
+ * Stricter schema required for listing on x402scan
+ * Allows UI-based resource invocation
+ */
+/**
+ * Field definition for input/output schema
+ */
+export type FieldDef = {
+    type?: string;
+    required?: boolean | string[];
+    description?: string;
+    enum?: string[];
+    properties?: Record<string, FieldDef>;
+};
+/**
+ * JSON Schema type for API output
+ */
+export type OutputSchemaType = {
+    type?: "object" | "array" | "string" | "number" | "boolean" | "null";
+    description?: string;
+    properties?: Record<string, FieldDef>;
+    items?: FieldDef;
+};
+/**
+ * Output schema describing input and output expectations for the paid endpoint
+ */
+export type OutputSchema = {
+    input: {
+        type: "http";
+        method: "GET" | "POST";
+        bodyType?: "json" | "form-data" | "multipart-form-data" | "text" | "binary";
+        pathParams?: Record<string, FieldDef>;
+        queryParams?: Record<string, FieldDef>;
+        bodyFields?: Record<string, FieldDef>;
+        headerFields?: Record<string, FieldDef>;
+    };
+    output?: OutputSchemaType;
+};
+/**
+ * Valid x402scan network types (as per their API specification)
+ */
+export type X402ScanNetwork = "base-sepolia" | "base" | "avalanche-fuji" | "avalanche" | "iotex" | "solana-devnet" | "solana" | "sei" | "sei-testnet" | "polygon" | "polygon-amoy" | "bsc" | "bsc-testnet" | "peaq";
+/**
+ * EIP-712 domain information for EVM chains
+ */
+export type EIP712DomainInfo = {
+    name: string;
+    version: string;
+    chainId: number;
+    verifyingContract: string;
+};
+/**
+ * Extra metadata for payment configuration
+ */
+export type PaymentExtraMetadata = {
+    priceInCents: number;
+    priceUSD: string;
+    symbol: string;
+    paymentConfig: string;
+    expiresIn: number;
+    name?: string;
+    version?: string;
+    eip712Domain?: EIP712DomainInfo;
+    [key: string]: string | number | EIP712DomainInfo | undefined;
+};
+/**
+ * Accepts object defining payment terms for a resource
+ */
+export type Accepts = {
+    scheme: "exact";
+    network: X402ScanNetwork;
+    maxAmountRequired: string;
+    resource: string;
+    description: string;
+    mimeType: string;
+    payTo: string;
+    maxTimeoutSeconds: number;
+    asset: string;
+    outputSchema?: OutputSchema;
+    extra?: PaymentExtraMetadata;
+};
+/**
+ * X402 Response structure
+ */
+export type X402Response = {
+    x402Version: number;
+    error?: string;
+    accepts?: Array<Accepts>;
+    payer?: string;
+};
+/**
+ * Validation result type
+ */
+export type ValidationResult = {
+    valid: boolean;
+    errors: string[];
+};
+/**
+ * Validate that an Accepts object conforms to the x402scan schema
+ */
+export declare function validateAccepts(accepts: Partial<Accepts>): ValidationResult;
+/**
+ * Validate that an X402Response conforms to the x402scan schema
+ */
+export declare function validateX402Response(response: Partial<X402Response>): ValidationResult;
+/**
+ * Create a validated Accepts object with sensible defaults
+ */
+export declare function createAccepts(params: {
+    network: X402ScanNetwork;
+    maxAmountRequired: string;
+    resource: string;
+    description: string;
+    payTo: string;
+    asset: string;
+    mimeType?: string;
+    maxTimeoutSeconds?: number;
+    outputSchema?: OutputSchema;
+    extra?: PaymentExtraMetadata;
+}): Accepts;
+/**
+ * Create a validated X402Response
+ */
+export declare function createX402Response(params: {
+    accepts?: Accepts[];
+    error?: string;
+    payer?: string;
+}): X402Response;
+//# sourceMappingURL=x402-types.d.ts.map

package/dist/x402-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"x402-types.d.ts","sourceRoot":"","sources":["../src/x402-types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,122 +1,91 @@
 {
   "name": "@elizaos/plugin-x402",
-  "version": "2.0.0-alpha.6",
-  "description": "x402 HTTP payment protocol plugin for ElizaOS - send and receive crypto payments",
+  "version": "2.0.3-beta.5",
+  "description": "x402 micropayment middleware for elizaOS plugin HTTP routes",
   "type": "module",
   "main": "dist/index.js",
   "module": "dist/index.js",
   "types": "dist/index.d.ts",
+  "sideEffects": false,
+  "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/elizaos-plugins/plugin-x402"
-  },
-  "publishConfig": {
-    "access": "public"
+    "url": "git+https://github.com/elizaos/eliza.git",
+    "directory": "plugins/plugin-x402"
   },
   "exports": {
     "./package.json": "./package.json",
     ".": {
       "types": "./dist/index.d.ts",
+      "eliza-source": {
+        "types": "./src/index.ts",
+        "import": "./src/index.ts",
+        "default": "./src/index.ts"
+      },
       "import": "./dist/index.js",
       "default": "./dist/index.js"
+    },
+    "./*.css": "./dist/*.css",
+    "./*": {
+      "types": "./dist/*.d.ts",
+      "eliza-source": {
+        "types": "./src/*.ts",
+        "import": "./src/*.ts",
+        "default": "./src/*.ts"
+      },
+      "import": "./dist/*.js",
+      "default": "./dist/*.js"
     }
   },
-  "sideEffects": false,
   "files": [
-    "dist"
+    "dist",
+    "src"
   ],
-  "dependencies": {
-    "@elizaos/core": "2.0.0-alpha.3",
-    "viem": "^2.21.0",
-    "better-sqlite3": "^11.7.0",
-    "pg": "^8.13.1"
-  },
-  "devDependencies": {
-    "@biomejs/biome": "^2.3.11",
-    "@types/better-sqlite3": "^7.6.12",
-    "@types/node": "^25.0.3",
-    "@types/pg": "^8.11.10",
-    "typescript": "^5.9.3"
+  "elizaos": {
+    "plugin": {
+      "capabilities": [
+        "payments",
+        "x402"
+      ]
+    }
   },
+  "keywords": [
+    "elizaos",
+    "plugin",
+    "x402",
+    "payments",
+    "micropayments",
+    "http-402"
+  ],
   "scripts": {
     "build": "bun run build.ts",
     "build:ts": "bun run build.ts",
-    "dev": "bun run build.ts --watch",
-    "clean": "rm -rf dist .turbo node_modules",
-    "format": "bunx @biomejs/biome format --write .",
-    "format:check": "bunx @biomejs/biome format .",
-    "lint": "bunx @biomejs/biome check --write --unsafe .",
-    "lint:check": "bunx @biomejs/biome check .",
-    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "clean": "node ../../packages/scripts/rm-path-recursive.mjs dist",
     "test": "vitest run",
-    "test:ts": "vitest run",
-    "test:watch": "vitest"
+    "typecheck": "tsgo --noEmit",
+    "lint": "bun run typecheck",
+    "lint:check": "bun run typecheck"
   },
-  "milaidy": {
-    "platforms": [
-      "node"
-    ],
-    "runtime": "node",
-    "platformDetails": {
-      "node": "Default export (Node.js)"
-    }
+  "dependencies": {
+    "@elizaos/core": "2.0.3-beta.5",
+    "@solana/web3.js": "1.98.4",
+    "drizzle-orm": "0.45.2",
+    "viem": "^2.48.8"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "typescript": "^6.0.3",
+    "vitest": "^4.0.18"
+  },
+  "peerDependencies": {
+    "@elizaos/core": "2.0.3-beta.5"
+  },
+  "publishConfig": {
+    "access": "public"
   },
   "agentConfig": {
-    "pluginParameters": {
-      "X402_AGENT_URL": {
-        "type": "string",
-        "description": "Agent endpoint URL",
-        "required": false,
-        "sensitive": false
-      },
-      "X402_PRIVATE_KEY": {
-        "type": "string",
-        "description": "Private key for X402",
-        "required": true,
-        "sensitive": true
-      },
-      "X402_NETWORK": {
-        "type": "string",
-        "description": "Network name (e.g. mainnet, testnet)",
-        "required": false,
-        "sensitive": false
-      },
-      "X402_PAY_TO": {
-        "type": "string",
-        "description": "Payment recipient address",
-        "required": false,
-        "sensitive": false
-      },
-      "X402_FACILITATOR_URL": {
-        "type": "string",
-        "description": "Facilitator service URL",
-        "required": false,
-        "sensitive": false
-      },
-      "X402_MAX_PAYMENT_USD": {
-        "type": "number",
-        "description": "Maximum single payment in USD",
-        "required": false,
-        "sensitive": false
-      },
-      "X402_MAX_TOTAL_USD": {
-        "type": "number",
-        "description": "Maximum total spend in USD",
-        "required": false,
-        "sensitive": false
-      },
-      "X402_ENABLED": {
-        "type": "boolean",
-        "description": "Enable or disable this feature",
-        "required": false,
-        "sensitive": false
-      },
-      "X402_DB_PATH": {
-        "type": "string",
-        "description": "Database file path",
-        "required": false,
-        "sensitive": false
-      }
-    }
-  }
+    "pluginType": "elizaos:plugin:1.0.0",
+    "pluginParameters": {}
+  },
+  "gitHead": "ff6157011c9459670021cc28a6797592a78b8817"
 }

package/src/__tests__/core-test-mock.ts

@@ -0,0 +1,10 @@
+import { vi } from "vitest";
+
+vi.mock("@elizaos/core", () => ({
+  logger: {
+    debug: vi.fn(),
+    error: vi.fn(),
+    info: vi.fn(),
+    warn: vi.fn(),
+  },
+}));

package/src/index.ts

@@ -0,0 +1,115 @@
+/**
+ * x402 Payment Middleware for ElizaOS
+ *
+ * Provides micropayment protection for plugin routes using the x402 protocol.
+ *
+ * **Why this module exists (product):** plugin authors should declare `x402` on
+ * routes and get a consistent gate—402 with payment options, verification, and
+ * optional facilitator settlement—without reimplementing payment math, replay
+ * safety, or HTTP header quirks in every plugin.
+ *
+ * **Why both “legacy JSON 402” and V2 headers:** older clients and scanners read
+ * the JSON body; protocol V2 buyers read `PAYMENT-REQUIRED` / `PAYMENT-RESPONSE`.
+ * Serving both avoids breaking existing integrations while still interoperating
+ * with modern wallets.
+ *
+ * @example
+ * ```typescript
+ * import { applyPaymentProtection } from '@elizaos/plugin-x402';
+ *
+ * // In your plugin:
+ * export const routes: Route[] = [
+ *   {
+ *     type: 'GET',
+ *     path: '/api/analytics/trending',
+ *     public: true,
+ *     x402: {
+ *       priceInCents: 10,
+ *       paymentConfigs: ['base_usdc', 'solana_usdc']
+ *     },
+ *     handler: async (req, res, runtime) => {
+ *       // Your handler logic
+ *     }
+ *   }
+ * ];
+ * ```
+ */
+
+export type {
+  BuiltInPaymentConfig,
+  CharacterX402Settings,
+  PaymentEnabledRoute,
+  X402Config,
+  X402RequestValidator,
+  X402ValidationResult,
+} from "@elizaos/core";
+
+export type { Network } from "./payment-config.js";
+export {
+  atomicAmountForPriceInCents,
+  BUILT_IN_NETWORKS,
+  getBaseUrl,
+  getPaymentAddress,
+  getPaymentConfig,
+  getX402Health,
+  listX402Configs,
+  PAYMENT_ADDRESSES,
+  PAYMENT_CONFIGS,
+  type PaymentConfigDefinition,
+  registerX402Config,
+  toResourceUrl,
+  toX402Network,
+} from "./payment-config.js";
+export {
+  applyPaymentProtection,
+  createPaymentAwareHandler,
+  isRoutePaymentWrapped,
+  X402_ROUTE_PAYMENT_WRAPPED,
+} from "./payment-wrapper.js";
+export {
+  type StartupValidationResult,
+  validateAndThrowIfInvalid,
+  validateX402Startup,
+} from "./startup-validator.js";
+export {
+  resolveEffectiveX402,
+  X402_EVENT_PAYMENT_REQUIRED,
+  X402_EVENT_PAYMENT_VERIFIED,
+} from "./x402-resolve.js";
+
+export {
+  type Accepts,
+  createAccepts,
+  createX402Response,
+  type OutputSchema,
+  validateAccepts,
+  validateX402Response,
+  type X402Response,
+  type X402ScanNetwork,
+} from "./x402-types.js";
+
+import type { Plugin } from "@elizaos/core";
+
+/**
+ * elizaOS plugin descriptor for x402.
+ *
+ * The middleware exported above is the actual integration surface — plugins
+ * declare `x402` on their routes and the agent's HTTP dispatch wraps them via
+ * `applyPaymentProtection` / `createPaymentAwareHandler`. This Plugin object
+ * exists so the runtime's plugin loader can register `@elizaos/plugin-x402` as
+ * a first-class auto-loadable plugin (config: `x402.enabled`).
+ */
+const x402Plugin: Plugin = {
+  name: "x402",
+  description:
+    "x402 micropayment middleware for elizaOS plugin HTTP routes (HTTP 402 / payment-required).",
+  actions: [],
+  providers: [],
+  evaluators: [],
+  services: [],
+  // Middleware-only plugin — no service instances or persistent resources to dispose.
+  dispose: async (_runtime) => {},
+};
+
+export default x402Plugin;
+export { x402Plugin };