@bankofai/x402-evm 2.6.0-beta.0

package/dist/esm/signer-DC81R8wQ.d.mts

@@ -0,0 +1,161 @@
+/**
+ * ClientEvmSigner - Used by x402 clients to sign payment authorizations.
+ *
+ * Typically a viem WalletClient extended with publicActions:
+ * ```typescript
+ * const client = createWalletClient({
+ *   account: privateKeyToAccount('0x...'),
+ *   chain: baseSepolia,
+ *   transport: http(),
+ * }).extend(publicActions);
+ * ```
+ *
+ * Or composed via `toClientEvmSigner(account, publicClient)`.
+ */
+type ClientEvmSigner = {
+    readonly address: `0x${string}`;
+    signTypedData(message: {
+        domain: Record<string, unknown>;
+        types: Record<string, unknown>;
+        primaryType: string;
+        message: Record<string, unknown>;
+    }): Promise<`0x${string}`>;
+    readContract(args: {
+        address: `0x${string}`;
+        abi: readonly unknown[];
+        functionName: string;
+        args?: readonly unknown[];
+    }): Promise<unknown>;
+    /**
+     * Optional: Signs a raw EIP-1559 transaction without broadcasting.
+     * Required for ERC-20 approval gas sponsoring when the token lacks EIP-2612.
+     */
+    signTransaction?(args: {
+        to: `0x${string}`;
+        data: `0x${string}`;
+        nonce: number;
+        gas: bigint;
+        maxFeePerGas: bigint;
+        maxPriorityFeePerGas: bigint;
+        chainId: number;
+    }): Promise<`0x${string}`>;
+    /**
+     * Optional: Gets the current transaction count (nonce) for an address.
+     * Required for ERC-20 approval gas sponsoring.
+     */
+    getTransactionCount?(args: {
+        address: `0x${string}`;
+    }): Promise<number>;
+    /**
+     * Optional: Estimates current gas fees per gas.
+     * Required for ERC-20 approval gas sponsoring.
+     */
+    estimateFeesPerGas?(): Promise<{
+        maxFeePerGas: bigint;
+        maxPriorityFeePerGas: bigint;
+    }>;
+};
+/**
+ * FacilitatorEvmSigner - Used by x402 facilitators to verify and settle payments
+ * This is typically a viem PublicClient + WalletClient combination that can
+ * read contract state, verify signatures, write transactions, and wait for receipts
+ *
+ * Supports multiple addresses for load balancing, key rotation, and high availability
+ */
+type FacilitatorEvmSigner = {
+    /**
+     * Get all addresses this facilitator can use for signing
+     * Enables dynamic address selection for load balancing and key rotation
+     */
+    getAddresses(): readonly `0x${string}`[];
+    readContract(args: {
+        address: `0x${string}`;
+        abi: readonly unknown[];
+        functionName: string;
+        args?: readonly unknown[];
+    }): Promise<unknown>;
+    verifyTypedData(args: {
+        address: `0x${string}`;
+        domain: Record<string, unknown>;
+        types: Record<string, unknown>;
+        primaryType: string;
+        message: Record<string, unknown>;
+        signature: `0x${string}`;
+    }): Promise<boolean>;
+    writeContract(args: {
+        address: `0x${string}`;
+        abi: readonly unknown[];
+        functionName: string;
+        args: readonly unknown[];
+    }): Promise<`0x${string}`>;
+    sendTransaction(args: {
+        to: `0x${string}`;
+        data: `0x${string}`;
+    }): Promise<`0x${string}`>;
+    waitForTransactionReceipt(args: {
+        hash: `0x${string}`;
+    }): Promise<{
+        status: string;
+    }>;
+    getCode(args: {
+        address: `0x${string}`;
+    }): Promise<`0x${string}` | undefined>;
+};
+/**
+ * Composes a ClientEvmSigner from a local account and a public client.
+ *
+ * Use this when your signer (e.g., `privateKeyToAccount`) doesn't have
+ * `readContract`. The `publicClient` provides the on-chain read capability.
+ *
+ * Alternatively, use a WalletClient extended with publicActions directly:
+ * ```typescript
+ * const signer = createWalletClient({
+ *   account: privateKeyToAccount('0x...'),
+ *   chain: baseSepolia,
+ *   transport: http(),
+ * }).extend(publicActions);
+ * ```
+ *
+ * @param signer - A signer with `address` and `signTypedData` (and optionally `readContract`)
+ * @param publicClient - A client with `readContract` (required if signer lacks it)
+ * @param publicClient.readContract - The readContract method from the public client
+ * @param publicClient.getTransactionCount - Optional getTransactionCount for ERC-20 approval
+ * @param publicClient.estimateFeesPerGas - Optional estimateFeesPerGas for ERC-20 approval
+ * @returns A complete ClientEvmSigner
+ *
+ * @example
+ * ```typescript
+ * const account = privateKeyToAccount("0x...");
+ * const publicClient = createPublicClient({ chain: baseSepolia, transport: http() });
+ * const signer = toClientEvmSigner(account, publicClient);
+ * ```
+ */
+declare function toClientEvmSigner(signer: Omit<ClientEvmSigner, "readContract"> & {
+    readContract?: ClientEvmSigner["readContract"];
+}, publicClient?: {
+    readContract(args: {
+        address: `0x${string}`;
+        abi: readonly unknown[];
+        functionName: string;
+        args?: readonly unknown[];
+    }): Promise<unknown>;
+    getTransactionCount?(args: {
+        address: `0x${string}`;
+    }): Promise<number>;
+    estimateFeesPerGas?(): Promise<{
+        maxFeePerGas: bigint;
+        maxPriorityFeePerGas: bigint;
+    }>;
+}): ClientEvmSigner;
+/**
+ * Converts a viem client with single address to a FacilitatorEvmSigner
+ * Wraps the single address in a getAddresses() function for compatibility
+ *
+ * @param client - The client to convert (must have 'address' property)
+ * @returns FacilitatorEvmSigner with getAddresses() support
+ */
+declare function toFacilitatorEvmSigner(client: Omit<FacilitatorEvmSigner, "getAddresses"> & {
+    address: `0x${string}`;
+}): FacilitatorEvmSigner;
+
+export { type ClientEvmSigner as C, type FacilitatorEvmSigner as F, toFacilitatorEvmSigner as a, toClientEvmSigner as t };

package/dist/esm/v1/index.d.mts

@@ -0,0 +1,39 @@
+export { ExactEvmSchemeV1 } from '../exact/v1/client/index.mjs';
+import '@bankofai/x402-core/types';
+import '../signer-DC81R8wQ.mjs';
+
+declare const EVM_NETWORK_CHAIN_ID_MAP: {
+    readonly ethereum: 1;
+    readonly sepolia: 11155111;
+    readonly abstract: 2741;
+    readonly "abstract-testnet": 11124;
+    readonly "base-sepolia": 84532;
+    readonly base: 8453;
+    readonly "avalanche-fuji": 43113;
+    readonly avalanche: 43114;
+    readonly iotex: 4689;
+    readonly sei: 1329;
+    readonly "sei-testnet": 1328;
+    readonly polygon: 137;
+    readonly "polygon-amoy": 80002;
+    readonly peaq: 3338;
+    readonly story: 1514;
+    readonly educhain: 41923;
+    readonly "skale-base-sepolia": 324705682;
+    readonly megaeth: 4326;
+    readonly monad: 143;
+    readonly bsc: 56;
+    readonly "bsc-testnet": 97;
+};
+type EvmNetworkV1 = keyof typeof EVM_NETWORK_CHAIN_ID_MAP;
+declare const NETWORKS: string[];
+/**
+ * Extract chain ID from a v1 legacy network name.
+ *
+ * @param network - The v1 network name (e.g., "base-sepolia", "polygon")
+ * @returns The numeric chain ID
+ * @throws Error if the network name is not a known v1 network
+ */
+declare function getEvmChainIdV1(network: string): number;
+
+export { EVM_NETWORK_CHAIN_ID_MAP, type EvmNetworkV1, NETWORKS, getEvmChainIdV1 };

package/dist/esm/v1/index.mjs

@@ -0,0 +1,13 @@
+import {
+  EVM_NETWORK_CHAIN_ID_MAP,
+  ExactEvmSchemeV12 as ExactEvmSchemeV1,
+  NETWORKS,
+  getEvmChainIdV1
+} from "../chunk-UDKSVWSE.mjs";
+export {
+  EVM_NETWORK_CHAIN_ID_MAP,
+  ExactEvmSchemeV1,
+  NETWORKS,
+  getEvmChainIdV1
+};
+//# sourceMappingURL=index.mjs.map

package/dist/esm/v1/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/package.json

@@ -0,0 +1,128 @@
+{
+  "name": "@bankofai/x402-evm",
+  "version": "2.6.0-beta.0",
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/cjs/index.d.ts",
+  "scripts": {
+    "start": "tsx --env-file=.env index.ts",
+    "build": "tsup",
+    "test": "vitest run",
+    "test:integration": "vitest run --config vitest.integration.config.ts",
+    "test:watch": "vitest",
+    "watch": "tsc --watch",
+    "format": "prettier -c .prettierrc --write \"**/*.{ts,js,cjs,json,md}\"",
+    "format:check": "prettier -c .prettierrc --check \"**/*.{ts,js,cjs,json,md}\"",
+    "lint": "eslint . --ext .ts --fix",
+    "lint:check": "eslint . --ext .ts"
+  },
+  "keywords": [
+    "@bankofai/x402",
+    "payment",
+    "protocol",
+    "evm",
+    "ethereum"
+  ],
+  "license": "Apache-2.0",
+  "author": "bankofai",
+  "repository": "https://github.com/bankofai/x402",
+  "description": "x402 Payment Protocol EVM Implementation",
+  "devDependencies": {
+    "@eslint/js": "^9.24.0",
+    "@types/node": "^22.13.4",
+    "@typescript-eslint/eslint-plugin": "^8.29.1",
+    "@typescript-eslint/parser": "^8.29.1",
+    "eslint": "^9.24.0",
+    "eslint-plugin-import": "^2.31.0",
+    "eslint-plugin-jsdoc": "^50.6.9",
+    "eslint-plugin-prettier": "^5.2.6",
+    "prettier": "3.5.2",
+    "tsup": "^8.4.0",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.3",
+    "vite": "^6.2.6",
+    "vite-tsconfig-paths": "^5.1.4",
+    "vitest": "^3.0.5"
+  },
+  "dependencies": {
+    "@bankofai/x402-core": "2.6.0-beta.0",
+    "@bankofai/x402-extensions": "2.6.0-beta.0",
+    "viem": "^2.39.3",
+    "zod": "^3.24.2"
+  },
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/esm/index.d.mts",
+        "default": "./dist/esm/index.mjs"
+      },
+      "require": {
+        "types": "./dist/cjs/index.d.ts",
+        "default": "./dist/cjs/index.js"
+      }
+    },
+    "./v1": {
+      "import": {
+        "types": "./dist/esm/v1/index.d.mts",
+        "default": "./dist/esm/v1/index.mjs"
+      },
+      "require": {
+        "types": "./dist/cjs/v1/index.d.ts",
+        "default": "./dist/cjs/v1/index.js"
+      }
+    },
+    "./exact/client": {
+      "import": {
+        "types": "./dist/esm/exact/client/index.d.mts",
+        "default": "./dist/esm/exact/client/index.mjs"
+      },
+      "require": {
+        "types": "./dist/cjs/exact/client/index.d.ts",
+        "default": "./dist/cjs/exact/client/index.js"
+      }
+    },
+    "./exact/server": {
+      "import": {
+        "types": "./dist/esm/exact/server/index.d.mts",
+        "default": "./dist/esm/exact/server/index.mjs"
+      },
+      "require": {
+        "types": "./dist/cjs/exact/server/index.d.ts",
+        "default": "./dist/cjs/exact/server/index.js"
+      }
+    },
+    "./exact/facilitator": {
+      "import": {
+        "types": "./dist/esm/exact/facilitator/index.d.mts",
+        "default": "./dist/esm/exact/facilitator/index.mjs"
+      },
+      "require": {
+        "types": "./dist/cjs/exact/facilitator/index.d.ts",
+        "default": "./dist/cjs/exact/facilitator/index.js"
+      }
+    },
+    "./exact/v1/client": {
+      "import": {
+        "types": "./dist/esm/exact/v1/client/index.d.mts",
+        "default": "./dist/esm/exact/v1/client/index.mjs"
+      },
+      "require": {
+        "types": "./dist/cjs/exact/v1/client/index.d.ts",
+        "default": "./dist/cjs/exact/v1/client/index.js"
+      }
+    },
+    "./exact/v1/facilitator": {
+      "import": {
+        "types": "./dist/esm/exact/v1/facilitator/index.d.mts",
+        "default": "./dist/esm/exact/v1/facilitator/index.mjs"
+      },
+      "require": {
+        "types": "./dist/cjs/exact/v1/facilitator/index.d.ts",
+        "default": "./dist/cjs/exact/v1/facilitator/index.js"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ]
+}