@bankofai/x402-evm 1.0.0-beta.0

package/dist/cjs/batch-settlement/server/redis-storage.js

@@ -0,0 +1,181 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/batch-settlement/server/redisStorage.ts
+var redisStorage_exports = {};
+__export(redisStorage_exports, {
+  RedisChannelStorage: () => RedisChannelStorage
+});
+module.exports = __toCommonJS(redisStorage_exports);
+var DEFAULT_KEY_PREFIX = "x402:batch-settlement";
+var DEFAULT_LOCK_RETRY_INTERVAL_MS = 10;
+var DEFAULT_SCAN_COUNT = 100;
+var UPDATE_CHANNEL_SCRIPT = `
+local current = redis.call("GET", KEYS[1])
+local expectedExists = ARGV[1]
+local expected = ARGV[2]
+local operation = ARGV[3]
+local nextValue = ARGV[4]
+
+if expectedExists == "0" then
+  if current ~= false then
+    return {0, current}
+  end
+elseif current ~= expected then
+  return {0, current or false}
+end
+
+if operation == "delete" then
+  redis.call("DEL", KEYS[1])
+  return {1, false}
+end
+
+if operation == "set" then
+  redis.call("SET", KEYS[1], nextValue)
+  return {1, nextValue}
+end
+
+return {1, current or false}
+`;
+var RedisChannelStorage = class {
+  /**
+   * Creates Redis-backed server channel storage.
+   *
+   * @param options - Redis client and optional key/retry configuration.
+   */
+  constructor(options) {
+    this.client = options.client;
+    this.keyPrefix = options.keyPrefix ?? DEFAULT_KEY_PREFIX;
+    this.channelKeyPrefix = `${this.keyPrefix}:server:channel`;
+    this.lockRetryIntervalMs = options.lockRetryIntervalMs ?? DEFAULT_LOCK_RETRY_INTERVAL_MS;
+    this.scanCount = options.scanCount ?? DEFAULT_SCAN_COUNT;
+  }
+  /**
+   * Loads a persisted channel record, if present.
+   *
+   * @param channelId - The channel identifier.
+   * @returns Parsed channel record or `undefined` when the key is missing.
+   */
+  async get(channelId) {
+    const raw = await this.client.get(this.channelKey(channelId));
+    if (!raw) return void 0;
+    return JSON.parse(raw);
+  }
+  /**
+   * Lists all stored channel records by scanning Redis keys.
+   *
+   * @returns Channel records sorted by channelId.
+   */
+  async list() {
+    const channels = [];
+    for await (const keyOrKeys of this.client.scanIterator({
+      MATCH: `${this.channelKeyPrefix}:*`,
+      COUNT: this.scanCount
+    })) {
+      const keys = Array.isArray(keyOrKeys) ? keyOrKeys : [keyOrKeys];
+      for (const key of keys) {
+        if (key.endsWith(":lock")) continue;
+        const raw = await this.client.get(key);
+        if (!raw) continue;
+        channels.push(JSON.parse(raw));
+      }
+    }
+    return channels.sort((a, b) => a.channelId.localeCompare(b.channelId));
+  }
+  /**
+   * Atomically inspects and mutates a channel record with Redis compare-and-write retries.
+   *
+   * @param channelId - The channel identifier.
+   * @param update - Mutation callback. Return `undefined` to delete, or `current` to leave unchanged.
+   * @returns The final stored channel and whether storage updated, stayed unchanged, or deleted.
+   */
+  async updateChannel(channelId, update) {
+    const key = this.channelKey(channelId);
+    while (true) {
+      const currentRaw = await this.client.get(key);
+      const current = currentRaw ? JSON.parse(currentRaw) : void 0;
+      const next = update(current);
+      if (next === current) {
+        const result2 = await this.commitUpdate(key, currentRaw, "keep");
+        if (result2.applied) return { channel: current, status: "unchanged" };
+        await sleep(this.lockRetryIntervalMs);
+        continue;
+      }
+      if (!next) {
+        const result2 = await this.commitUpdate(key, currentRaw, "delete");
+        if (result2.applied) {
+          return { channel: void 0, status: current ? "deleted" : "unchanged" };
+        }
+        await sleep(this.lockRetryIntervalMs);
+        continue;
+      }
+      const nextRaw = JSON.stringify(next);
+      const result = await this.commitUpdate(key, currentRaw, "set", nextRaw);
+      if (result.applied) return { channel: next, status: "updated" };
+      await sleep(this.lockRetryIntervalMs);
+    }
+  }
+  /**
+   * Applies a channel mutation only if the key still contains the value that was inspected.
+   *
+   * @param key - Redis channel key to mutate.
+   * @param expectedRaw - Raw JSON value observed before running the update callback.
+   * @param operation - Mutation to apply when the observed value is still current.
+   * @param nextRaw - Raw JSON value to write for set operations.
+   * @returns Whether the mutation was applied.
+   */
+  async commitUpdate(key, expectedRaw, operation, nextRaw = "") {
+    return parseRedisUpdateResult(
+      await this.client.eval(UPDATE_CHANNEL_SCRIPT, {
+        keys: [key],
+        arguments: [expectedRaw === null ? "0" : "1", expectedRaw ?? "", operation, nextRaw]
+      })
+    );
+  }
+  /**
+   * Builds the Redis key for a stored channel record.
+   *
+   * @param channelId - The channel identifier.
+   * @returns Redis key for the channel JSON.
+   */
+  channelKey(channelId) {
+    return `${this.channelKeyPrefix}:${channelId.toLowerCase()}`;
+  }
+};
+function parseRedisUpdateResult(value) {
+  if (!Array.isArray(value) || value.length < 1) {
+    throw new Error("Unexpected Redis update response");
+  }
+  const [applied, raw] = value;
+  if (applied !== 0 && applied !== 1) {
+    throw new Error("Unexpected Redis update status");
+  }
+  if (raw !== false && raw !== null && raw !== void 0 && typeof raw !== "string") {
+    throw new Error("Unexpected Redis update value");
+  }
+  return { applied: applied === 1 };
+}
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  RedisChannelStorage
+});
+//# sourceMappingURL=redis-storage.js.map

package/dist/cjs/batch-settlement/server/redis-storage.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/batch-settlement/server/redisStorage.ts"],"sourcesContent":["import type { Channel, ChannelStorage, ChannelUpdateResult } from \"./storage\";\n\nconst DEFAULT_KEY_PREFIX = \"x402:batch-settlement\";\nconst DEFAULT_LOCK_RETRY_INTERVAL_MS = 10;\nconst DEFAULT_SCAN_COUNT = 100;\n\nconst UPDATE_CHANNEL_SCRIPT = `\nlocal current = redis.call(\"GET\", KEYS[1])\nlocal expectedExists = ARGV[1]\nlocal expected = ARGV[2]\nlocal operation = ARGV[3]\nlocal nextValue = ARGV[4]\n\nif expectedExists == \"0\" then\n  if current ~= false then\n    return {0, current}\n  end\nelseif current ~= expected then\n  return {0, current or false}\nend\n\nif operation == \"delete\" then\n  redis.call(\"DEL\", KEYS[1])\n  return {1, false}\nend\n\nif operation == \"set\" then\n  redis.call(\"SET\", KEYS[1], nextValue)\n  return {1, nextValue}\nend\n\nreturn {1, current or false}\n`;\n\nexport type RedisEvalOptions = {\n  keys: string[];\n  arguments: string[];\n};\n\nexport type RedisSetOptions = {\n  NX?: true;\n  PX?: number;\n};\n\nexport type RedisScanOptions = {\n  MATCH?: string;\n  COUNT?: number;\n};\n\nexport type RedisChannelStorageClient = {\n  get(key: string): Promise<string | null>;\n  set(key: string, value: string, options?: RedisSetOptions): Promise<string | null>;\n  del(key: string): Promise<number>;\n  eval(script: string, options: RedisEvalOptions): Promise<unknown>;\n  scanIterator(options: RedisScanOptions): AsyncIterable<string | string[]>;\n};\n\nexport type RedisChannelStorageOptions = {\n  client: RedisChannelStorageClient;\n  keyPrefix?: string;\n  lockTtlMs?: number;\n  lockRetryIntervalMs?: number;\n  lockRenewalIntervalMs?: number;\n  scanCount?: number;\n};\n\ntype RedisUpdateOperation = \"delete\" | \"keep\" | \"set\";\n\ntype ParsedRedisUpdateResult = {\n  applied: boolean;\n};\n\n/**\n * Redis-backed {@link ChannelStorage} with optimistic atomic updates.\n */\nexport class RedisChannelStorage implements ChannelStorage {\n  private readonly client: RedisChannelStorageClient;\n  private readonly keyPrefix: string;\n  private readonly channelKeyPrefix: string;\n  private readonly lockRetryIntervalMs: number;\n  private readonly scanCount: number;\n\n  /**\n   * Creates Redis-backed server channel storage.\n   *\n   * @param options - Redis client and optional key/retry configuration.\n   */\n  constructor(options: RedisChannelStorageOptions) {\n    this.client = options.client;\n    this.keyPrefix = options.keyPrefix ?? DEFAULT_KEY_PREFIX;\n    this.channelKeyPrefix = `${this.keyPrefix}:server:channel`;\n    this.lockRetryIntervalMs = options.lockRetryIntervalMs ?? DEFAULT_LOCK_RETRY_INTERVAL_MS;\n    this.scanCount = options.scanCount ?? DEFAULT_SCAN_COUNT;\n  }\n\n  /**\n   * Loads a persisted channel record, if present.\n   *\n   * @param channelId - The channel identifier.\n   * @returns Parsed channel record or `undefined` when the key is missing.\n   */\n  async get(channelId: string): Promise<Channel | undefined> {\n    const raw = await this.client.get(this.channelKey(channelId));\n    if (!raw) return undefined;\n    return JSON.parse(raw) as Channel;\n  }\n\n  /**\n   * Lists all stored channel records by scanning Redis keys.\n   *\n   * @returns Channel records sorted by channelId.\n   */\n  async list(): Promise<Channel[]> {\n    const channels: Channel[] = [];\n    for await (const keyOrKeys of this.client.scanIterator({\n      MATCH: `${this.channelKeyPrefix}:*`,\n      COUNT: this.scanCount,\n    })) {\n      const keys = Array.isArray(keyOrKeys) ? keyOrKeys : [keyOrKeys];\n      for (const key of keys) {\n        if (key.endsWith(\":lock\")) continue;\n        const raw = await this.client.get(key);\n        if (!raw) continue;\n        channels.push(JSON.parse(raw) as Channel);\n      }\n    }\n    return channels.sort((a, b) => a.channelId.localeCompare(b.channelId));\n  }\n\n  /**\n   * Atomically inspects and mutates a channel record with Redis compare-and-write retries.\n   *\n   * @param channelId - The channel identifier.\n   * @param update - Mutation callback. Return `undefined` to delete, or `current` to leave unchanged.\n   * @returns The final stored channel and whether storage updated, stayed unchanged, or deleted.\n   */\n  async updateChannel(\n    channelId: string,\n    update: (current: Channel | undefined) => Channel | undefined,\n  ): Promise<ChannelUpdateResult> {\n    const key = this.channelKey(channelId);\n    while (true) {\n      const currentRaw = await this.client.get(key);\n      const current = currentRaw ? (JSON.parse(currentRaw) as Channel) : undefined;\n      const next = update(current);\n\n      if (next === current) {\n        const result = await this.commitUpdate(key, currentRaw, \"keep\");\n        if (result.applied) return { channel: current, status: \"unchanged\" };\n        await sleep(this.lockRetryIntervalMs);\n        continue;\n      }\n\n      if (!next) {\n        const result = await this.commitUpdate(key, currentRaw, \"delete\");\n        if (result.applied) {\n          return { channel: undefined, status: current ? \"deleted\" : \"unchanged\" };\n        }\n        await sleep(this.lockRetryIntervalMs);\n        continue;\n      }\n\n      const nextRaw = JSON.stringify(next);\n      const result = await this.commitUpdate(key, currentRaw, \"set\", nextRaw);\n      if (result.applied) return { channel: next, status: \"updated\" };\n      await sleep(this.lockRetryIntervalMs);\n    }\n  }\n\n  /**\n   * Applies a channel mutation only if the key still contains the value that was inspected.\n   *\n   * @param key - Redis channel key to mutate.\n   * @param expectedRaw - Raw JSON value observed before running the update callback.\n   * @param operation - Mutation to apply when the observed value is still current.\n   * @param nextRaw - Raw JSON value to write for set operations.\n   * @returns Whether the mutation was applied.\n   */\n  private async commitUpdate(\n    key: string,\n    expectedRaw: string | null,\n    operation: RedisUpdateOperation,\n    nextRaw = \"\",\n  ): Promise<ParsedRedisUpdateResult> {\n    return parseRedisUpdateResult(\n      await this.client.eval(UPDATE_CHANNEL_SCRIPT, {\n        keys: [key],\n        arguments: [expectedRaw === null ? \"0\" : \"1\", expectedRaw ?? \"\", operation, nextRaw],\n      }),\n    );\n  }\n\n  /**\n   * Builds the Redis key for a stored channel record.\n   *\n   * @param channelId - The channel identifier.\n   * @returns Redis key for the channel JSON.\n   */\n  private channelKey(channelId: string) {\n    return `${this.channelKeyPrefix}:${channelId.toLowerCase()}`;\n  }\n}\n\n/**\n * Parses the Redis script response.\n *\n * @param value - Raw response from the Redis client.\n * @returns Whether the compare-and-write applied.\n */\nfunction parseRedisUpdateResult(value: unknown): ParsedRedisUpdateResult {\n  if (!Array.isArray(value) || value.length < 1) {\n    throw new Error(\"Unexpected Redis update response\");\n  }\n\n  const [applied, raw] = value;\n  if (applied !== 0 && applied !== 1) {\n    throw new Error(\"Unexpected Redis update status\");\n  }\n\n  if (raw !== false && raw !== null && raw !== undefined && typeof raw !== \"string\") {\n    throw new Error(\"Unexpected Redis update value\");\n  }\n\n  return { applied: applied === 1 };\n}\n\n/**\n * Resolves after the requested delay.\n *\n * @param ms - Delay in milliseconds.\n * @returns Promise resolved after the delay.\n */\nfunction sleep(ms: number) {\n  return new Promise(resolve => setTimeout(resolve, ms));\n}\n"],"mappings":"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","names":["result"]}

package/dist/cjs/client/agent-wallet.d.ts

@@ -0,0 +1,69 @@
+import { C as ClientEvmSigner } from '../signer-BFelv8DL.js';
+import 'viem';
+
+/**
+ * BankofAI overlay — NOT from upstream @x402/evm.
+ *
+ * Client-side wallet-bridge factory, symmetric to TRON's
+ * `createClientTronSigner` and to this package's `createFacilitatorEvmSigner`.
+ * Upstream ships only `toClientEvmSigner`, a composition helper that expects an
+ * already-resolved `{ address, signTypedData }`; it does not adapt an
+ * `@bankofai/agent-wallet` wallet (async `getAddress`, and a `signTypedData`
+ * that strips the `0x` prefix). This factory closes that gap so client examples
+ * stay a one-liner and never touch a raw key.
+ *
+ * Upgrade safety: consumes only upstream's public surface (`toClientEvmSigner` +
+ * the `ClientEvmSigner` type); never edits `signer.ts` / `index.ts`.
+ */
+
+/**
+ * A wallet that signs EIP-712 typed data without exposing its key — structurally
+ * compatible with `@bankofai/agent-wallet`'s `EvmSigner`. `signTypedData` may
+ * return the signature with or without the `0x` prefix (agent-wallet strips it);
+ * the factory normalizes it.
+ */
+interface ClientEvmWallet {
+    getAddress(): Promise<string>;
+    signTypedData(data: {
+        domain: Record<string, unknown>;
+        types: Record<string, unknown>;
+        primaryType: string;
+        message: Record<string, unknown>;
+    }): Promise<string>;
+    /**
+     * Optionally sign a fully-specified EIP-1559 transaction (e.g. the one-time
+     * `approve(Permit2)` for the ERC-20 approval gas-sponsoring extension).
+     * agent-wallet's `EvmSigner` satisfies this; the returned hex may omit the
+     * `0x` prefix (agent-wallet strips it). When absent, the signer can't produce
+     * the gas-sponsored approval and that flow is simply skipped.
+     */
+    signTransaction?(tx: Record<string, unknown>): Promise<string>;
+}
+/** Minimal read surface for permit2 allowance enrichment (a viem client satisfies it). */
+interface ClientEvmReadClient {
+    readContract(args: {
+        address: `0x${string}`;
+        abi: readonly unknown[];
+        functionName: string;
+        args?: readonly unknown[];
+    }): Promise<unknown>;
+}
+/**
+ * Creates a {@link ClientEvmSigner} from an agent-wallet — the EVM counterpart
+ * of `createClientTronSigner`. The key never enters the SDK; the wallet signs.
+ *
+ * @param wallet - The wallet that signs payment authorizations.
+ * @param publicClient - Optional viem client; enables EIP-2612/permit2
+ *   enrichment via `readContract`. Omit for ERC-3009-only flows.
+ * @returns A {@link ClientEvmSigner} backed by the wallet.
+ *
+ * @example
+ * ```typescript
+ * const wallet = await resolveWallet({ network: "evm" }); // @bankofai/agent-wallet
+ * const signer = await createClientEvmSigner(wallet, publicClient);
+ * new ExactEvmScheme(signer);
+ * ```
+ */
+declare function createClientEvmSigner(wallet: ClientEvmWallet, publicClient?: ClientEvmReadClient): Promise<ClientEvmSigner>;
+
+export { type ClientEvmReadClient, type ClientEvmWallet, createClientEvmSigner };

package/dist/cjs/client/agent-wallet.js

@@ -0,0 +1,84 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/client/agent-wallet.ts
+var agent_wallet_exports = {};
+__export(agent_wallet_exports, {
+  createClientEvmSigner: () => createClientEvmSigner
+});
+module.exports = __toCommonJS(agent_wallet_exports);
+
+// src/signer.ts
+function toClientEvmSigner(signer, publicClient) {
+  const readContract = signer.readContract ?? publicClient?.readContract.bind(publicClient);
+  const result = {
+    address: signer.address,
+    signTypedData: (msg) => signer.signTypedData(msg)
+  };
+  if (readContract) {
+    result.readContract = readContract;
+  }
+  const signTransaction = signer.signTransaction;
+  if (signTransaction) {
+    result.signTransaction = (args) => signTransaction(args);
+  }
+  const getTransactionCount = signer.getTransactionCount ?? publicClient?.getTransactionCount?.bind(publicClient);
+  if (getTransactionCount) {
+    result.getTransactionCount = (args) => getTransactionCount(args);
+  }
+  const estimateFeesPerGas = signer.estimateFeesPerGas ?? publicClient?.estimateFeesPerGas?.bind(publicClient);
+  if (estimateFeesPerGas) {
+    result.estimateFeesPerGas = () => estimateFeesPerGas();
+  }
+  return result;
+}
+
+// src/client/agent-wallet.ts
+async function createClientEvmSigner(wallet, publicClient) {
+  const address = await wallet.getAddress();
+  const signTransaction = wallet.signTransaction?.bind(wallet);
+  return toClientEvmSigner(
+    {
+      address,
+      // agent-wallet strips the `0x` (signature analog of SDK issue #2);
+      // re-add it so the returned signature matches the ClientEvmSigner contract.
+      signTypedData: async (msg) => {
+        const sig = await wallet.signTypedData(msg);
+        return `0x${sig.replace(/^0x/, "")}`;
+      },
+      // Enables the ERC-20 approval gas-sponsoring extension: the client signs
+      // the `approve(Permit2, MaxUint256)` tx offline (facilitator broadcasts it).
+      // agent-wallet's EvmSigner.signTransaction takes the viem EIP-1559 fields
+      // as-is and strips the `0x`; re-add it. getTransactionCount/estimateFeesPerGas
+      // come from `publicClient` via toClientEvmSigner.
+      ...signTransaction ? {
+        signTransaction: async (args) => {
+          const signed = await signTransaction(args);
+          return `0x${signed.replace(/^0x/, "")}`;
+        }
+      } : {}
+    },
+    publicClient
+  );
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createClientEvmSigner
+});
+//# sourceMappingURL=agent-wallet.js.map

package/dist/cjs/client/agent-wallet.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/client/agent-wallet.ts","../../../src/signer.ts"],"sourcesContent":["/**\n * BankofAI overlay — NOT from upstream @x402/evm.\n *\n * Client-side wallet-bridge factory, symmetric to TRON's\n * `createClientTronSigner` and to this package's `createFacilitatorEvmSigner`.\n * Upstream ships only `toClientEvmSigner`, a composition helper that expects an\n * already-resolved `{ address, signTypedData }`; it does not adapt an\n * `@bankofai/agent-wallet` wallet (async `getAddress`, and a `signTypedData`\n * that strips the `0x` prefix). This factory closes that gap so client examples\n * stay a one-liner and never touch a raw key.\n *\n * Upgrade safety: consumes only upstream's public surface (`toClientEvmSigner` +\n * the `ClientEvmSigner` type); never edits `signer.ts` / `index.ts`.\n */\nimport { toClientEvmSigner, type ClientEvmSigner } from \"../signer\";\n\n/**\n * A wallet that signs EIP-712 typed data without exposing its key — structurally\n * compatible with `@bankofai/agent-wallet`'s `EvmSigner`. `signTypedData` may\n * return the signature with or without the `0x` prefix (agent-wallet strips it);\n * the factory normalizes it.\n */\nexport interface ClientEvmWallet {\n  getAddress(): Promise<string>;\n  signTypedData(data: {\n    domain: Record<string, unknown>;\n    types: Record<string, unknown>;\n    primaryType: string;\n    message: Record<string, unknown>;\n  }): Promise<string>;\n  /**\n   * Optionally sign a fully-specified EIP-1559 transaction (e.g. the one-time\n   * `approve(Permit2)` for the ERC-20 approval gas-sponsoring extension).\n   * agent-wallet's `EvmSigner` satisfies this; the returned hex may omit the\n   * `0x` prefix (agent-wallet strips it). When absent, the signer can't produce\n   * the gas-sponsored approval and that flow is simply skipped.\n   */\n  signTransaction?(tx: Record<string, unknown>): Promise<string>;\n}\n\n/** Minimal read surface for permit2 allowance enrichment (a viem client satisfies it). */\nexport interface ClientEvmReadClient {\n  readContract(args: {\n    address: `0x${string}`;\n    abi: readonly unknown[];\n    functionName: string;\n    args?: readonly unknown[];\n  }): Promise<unknown>;\n}\n\n/**\n * Creates a {@link ClientEvmSigner} from an agent-wallet — the EVM counterpart\n * of `createClientTronSigner`. The key never enters the SDK; the wallet signs.\n *\n * @param wallet - The wallet that signs payment authorizations.\n * @param publicClient - Optional viem client; enables EIP-2612/permit2\n *   enrichment via `readContract`. Omit for ERC-3009-only flows.\n * @returns A {@link ClientEvmSigner} backed by the wallet.\n *\n * @example\n * ```typescript\n * const wallet = await resolveWallet({ network: \"evm\" }); // @bankofai/agent-wallet\n * const signer = await createClientEvmSigner(wallet, publicClient);\n * new ExactEvmScheme(signer);\n * ```\n */\nexport async function createClientEvmSigner(\n  wallet: ClientEvmWallet,\n  publicClient?: ClientEvmReadClient,\n): Promise<ClientEvmSigner> {\n  const address = (await wallet.getAddress()) as `0x${string}`;\n\n  // Bind to the wallet: agent-wallet's `LocalSigner.signTransaction` reads\n  // `this._impl`, so calling a detached reference throws. (`signTypedData` below\n  // is invoked as `wallet.signTypedData(...)`, so it stays bound.)\n  const signTransaction = wallet.signTransaction?.bind(wallet);\n\n  return toClientEvmSigner(\n    {\n      address,\n      // agent-wallet strips the `0x` (signature analog of SDK issue #2);\n      // re-add it so the returned signature matches the ClientEvmSigner contract.\n      signTypedData: async msg => {\n        const sig = await wallet.signTypedData(msg);\n        return `0x${sig.replace(/^0x/, \"\")}` as `0x${string}`;\n      },\n      // Enables the ERC-20 approval gas-sponsoring extension: the client signs\n      // the `approve(Permit2, MaxUint256)` tx offline (facilitator broadcasts it).\n      // agent-wallet's EvmSigner.signTransaction takes the viem EIP-1559 fields\n      // as-is and strips the `0x`; re-add it. getTransactionCount/estimateFeesPerGas\n      // come from `publicClient` via toClientEvmSigner.\n      ...(signTransaction\n        ? {\n            signTransaction: async (args: Record<string, unknown>) => {\n              const signed = await signTransaction(args);\n              return `0x${signed.replace(/^0x/, \"\")}` as `0x${string}`;\n            },\n          }\n        : {}),\n    },\n    publicClient,\n  );\n}\n","import type { Log } from \"viem\";\n\n/**\n * ClientEvmSigner - Used by x402 clients to sign payment authorizations.\n *\n * Typically a viem WalletClient extended with publicActions:\n * ```typescript\n * const client = createWalletClient({\n *   account: privateKeyToAccount('0x...'),\n *   chain: baseSepolia,\n *   transport: http(),\n * }).extend(publicActions);\n * ```\n *\n * Or composed via `toClientEvmSigner(account, publicClient)`.\n */\nexport type ClientEvmSigner = {\n  readonly address: `0x${string}`;\n  signTypedData(message: {\n    domain: Record<string, unknown>;\n    types: Record<string, unknown>;\n    primaryType: string;\n    message: Record<string, unknown>;\n  }): Promise<`0x${string}`>;\n  /**\n   * Optional on-chain reads.\n   * Required only for extension enrichment (EIP-2612 / ERC-20 approval).\n   */\n  readContract?(args: {\n    address: `0x${string}`;\n    abi: readonly unknown[];\n    functionName: string;\n    args?: readonly unknown[];\n  }): Promise<unknown>;\n  /**\n   * Optional: Signs a raw EIP-1559 transaction without broadcasting.\n   * Required for ERC-20 approval gas sponsoring when the token lacks EIP-2612.\n   */\n  signTransaction?(args: {\n    to: `0x${string}`;\n    data: `0x${string}`;\n    nonce: number;\n    gas: bigint;\n    maxFeePerGas: bigint;\n    maxPriorityFeePerGas: bigint;\n    chainId: number;\n  }): Promise<`0x${string}`>;\n  /**\n   * Optional: Gets the current transaction count (nonce) for an address.\n   * Required for ERC-20 approval gas sponsoring.\n   */\n  getTransactionCount?(args: { address: `0x${string}` }): Promise<number>;\n  /**\n   * Optional: Estimates current gas fees per gas.\n   * Required for ERC-20 approval gas sponsoring.\n   */\n  estimateFeesPerGas?(): Promise<{ maxFeePerGas: bigint; maxPriorityFeePerGas: bigint }>;\n};\n\n/**\n * FacilitatorEvmSigner - Used by x402 facilitators to verify and settle payments\n * This is typically a viem PublicClient + WalletClient combination that can\n * read contract state, verify signatures, write transactions, and wait for receipts\n *\n * Supports multiple addresses for load balancing, key rotation, and high availability\n */\nexport type FacilitatorEvmSigner = {\n  /**\n   * Get all addresses this facilitator can use for signing\n   * Enables dynamic address selection for load balancing and key rotation\n   */\n  getAddresses(): readonly `0x${string}`[];\n\n  readContract(args: {\n    address: `0x${string}`;\n    abi: readonly unknown[];\n    functionName: string;\n    args?: readonly unknown[];\n  }): Promise<unknown>;\n  verifyTypedData(args: {\n    address: `0x${string}`;\n    domain: Record<string, unknown>;\n    types: Record<string, unknown>;\n    primaryType: string;\n    message: Record<string, unknown>;\n    signature: `0x${string}`;\n  }): Promise<boolean>;\n  writeContract(args: {\n    address: `0x${string}`;\n    abi: readonly unknown[];\n    functionName: string;\n    args: readonly unknown[];\n    gas?: bigint;\n    dataSuffix?: `0x${string}`;\n  }): Promise<`0x${string}`>;\n  sendTransaction(args: { to: `0x${string}`; data: `0x${string}` }): Promise<`0x${string}`>;\n  waitForTransactionReceipt(args: { hash: `0x${string}` }): Promise<{\n    status: string;\n    logs?: readonly Log[];\n  }>;\n  getCode(args: { address: `0x${string}` }): Promise<`0x${string}` | undefined>;\n};\n\n/**\n * Composes a ClientEvmSigner from a local account and a public client.\n *\n * Use this when your signer (e.g., `privateKeyToAccount`) doesn't have\n * `readContract`. The `publicClient` provides the on-chain read capability.\n *\n * Alternatively, use a WalletClient extended with publicActions directly:\n * ```typescript\n * const signer = createWalletClient({\n *   account: privateKeyToAccount('0x...'),\n *   chain: baseSepolia,\n *   transport: http(),\n * }).extend(publicActions);\n * ```\n *\n * @param signer - A signer with `address` and `signTypedData` (and optionally `readContract`)\n * @param publicClient - A client with optional read/nonce/fee helpers\n * @param publicClient.readContract - The readContract method from the public client\n * @param publicClient.getTransactionCount - Optional getTransactionCount for ERC-20 approval\n * @param publicClient.estimateFeesPerGas - Optional estimateFeesPerGas for ERC-20 approval\n * @returns A ClientEvmSigner with any available optional capabilities\n *\n * @example\n * ```typescript\n * const account = privateKeyToAccount(\"0x...\");\n * const publicClient = createPublicClient({ chain: baseSepolia, transport: http() });\n * const signer = toClientEvmSigner(account, publicClient);\n * ```\n */\nexport function toClientEvmSigner(\n  signer: Omit<ClientEvmSigner, \"readContract\"> & {\n    readContract?: ClientEvmSigner[\"readContract\"];\n  },\n  publicClient?: {\n    readContract(args: {\n      address: `0x${string}`;\n      abi: readonly unknown[];\n      functionName: string;\n      args?: readonly unknown[];\n    }): Promise<unknown>;\n    getTransactionCount?(args: { address: `0x${string}` }): Promise<number>;\n    estimateFeesPerGas?(): Promise<{ maxFeePerGas: bigint; maxPriorityFeePerGas: bigint }>;\n  },\n): ClientEvmSigner {\n  const readContract = signer.readContract ?? publicClient?.readContract.bind(publicClient);\n\n  const result: ClientEvmSigner = {\n    address: signer.address,\n    signTypedData: msg => signer.signTypedData(msg),\n  };\n\n  if (readContract) {\n    result.readContract = readContract;\n  }\n\n  // Forward optional capabilities from signer or publicClient\n  const signTransaction = signer.signTransaction;\n  if (signTransaction) {\n    result.signTransaction = args => signTransaction(args);\n  }\n\n  const getTransactionCount =\n    signer.getTransactionCount ?? publicClient?.getTransactionCount?.bind(publicClient);\n  if (getTransactionCount) {\n    result.getTransactionCount = args => getTransactionCount(args);\n  }\n\n  const estimateFeesPerGas =\n    signer.estimateFeesPerGas ?? publicClient?.estimateFeesPerGas?.bind(publicClient);\n  if (estimateFeesPerGas) {\n    result.estimateFeesPerGas = () => estimateFeesPerGas();\n  }\n\n  return result;\n}\n\n/**\n * Converts a viem client with single address to a FacilitatorEvmSigner\n * Wraps the single address in a getAddresses() function for compatibility\n *\n * @param client - The client to convert (must have 'address' property)\n * @returns FacilitatorEvmSigner with getAddresses() support\n */\nexport function toFacilitatorEvmSigner(\n  client: Omit<FacilitatorEvmSigner, \"getAddresses\"> & { address: `0x${string}` },\n): FacilitatorEvmSigner {\n  return {\n    ...client,\n    getAddresses: () => [client.address],\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACoIO,SAAS,kBACd,QAGA,cAUiB;AACjB,QAAM,eAAe,OAAO,gBAAgB,cAAc,aAAa,KAAK,YAAY;AAExF,QAAM,SAA0B;AAAA,IAC9B,SAAS,OAAO;AAAA,IAChB,eAAe,SAAO,OAAO,cAAc,GAAG;AAAA,EAChD;AAEA,MAAI,cAAc;AAChB,WAAO,eAAe;AAAA,EACxB;AAGA,QAAM,kBAAkB,OAAO;AAC/B,MAAI,iBAAiB;AACnB,WAAO,kBAAkB,UAAQ,gBAAgB,IAAI;AAAA,EACvD;AAEA,QAAM,sBACJ,OAAO,uBAAuB,cAAc,qBAAqB,KAAK,YAAY;AACpF,MAAI,qBAAqB;AACvB,WAAO,sBAAsB,UAAQ,oBAAoB,IAAI;AAAA,EAC/D;AAEA,QAAM,qBACJ,OAAO,sBAAsB,cAAc,oBAAoB,KAAK,YAAY;AAClF,MAAI,oBAAoB;AACtB,WAAO,qBAAqB,MAAM,mBAAmB;AAAA,EACvD;AAEA,SAAO;AACT;;;AD/GA,eAAsB,sBACpB,QACA,cAC0B;AAC1B,QAAM,UAAW,MAAM,OAAO,WAAW;AAKzC,QAAM,kBAAkB,OAAO,iBAAiB,KAAK,MAAM;AAE3D,SAAO;AAAA,IACL;AAAA,MACE;AAAA;AAAA;AAAA,MAGA,eAAe,OAAM,QAAO;AAC1B,cAAM,MAAM,MAAM,OAAO,cAAc,GAAG;AAC1C,eAAO,KAAK,IAAI,QAAQ,OAAO,EAAE,CAAC;AAAA,MACpC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,MAMA,GAAI,kBACA;AAAA,QACE,iBAAiB,OAAO,SAAkC;AACxD,gBAAM,SAAS,MAAM,gBAAgB,IAAI;AACzC,iBAAO,KAAK,OAAO,QAAQ,OAAO,EAAE,CAAC;AAAA,QACvC;AAAA,MACF,IACA,CAAC;AAAA,IACP;AAAA,IACA;AAAA,EACF;AACF;","names":[]}

package/dist/cjs/exact/client/index.d.ts

@@ -0,0 +1,63 @@
+export { E as ExactEvmScheme } from '../../scheme-DWgpkDgz.js';
+import { x402Client, SelectPaymentRequirements, PaymentPolicy } from '@bankofai/x402-core/client';
+import { Network } from '@bankofai/x402-core/types';
+import { C as ClientEvmSigner } from '../../signer-BFelv8DL.js';
+import { E as ExactEvmSchemeOptions } from '../../rpc-DULZzRne.js';
+export { a as ExactEvmSchemeConfig, b as ExactEvmSchemeConfigByChainId } from '../../rpc-DULZzRne.js';
+export { P as Permit2AllowanceParams, c as createPermit2ApprovalTx, e as erc20AllowanceAbi, g as getPermit2AllowanceReadParams } from '../../permit2-DhJRUcgY.js';
+import 'viem';
+
+/**
+ * Configuration options for registering EVM schemes to an x402Client
+ */
+interface EvmClientConfig {
+    /**
+     * The EVM signer to use for creating payment payloads
+     */
+    signer: ClientEvmSigner;
+    /**
+     * Optional payment requirements selector function
+     * If not provided, uses the default selector (first available option)
+     */
+    paymentRequirementsSelector?: SelectPaymentRequirements;
+    /**
+     * Optional policies to apply to the client
+     */
+    policies?: PaymentPolicy[];
+    /**
+     * Optional Exact EVM client scheme options.
+     * Supports either a single config ({ rpcUrl }) or per-chain configs
+     * keyed by EVM chain ID ({ 8453: { rpcUrl: "..." } }).
+     */
+    schemeOptions?: ExactEvmSchemeOptions;
+    /**
+     * Optional specific networks to register.
+     * If not provided, registers wildcard support (eip155:*).
+     */
+    networks?: Network[];
+}
+/**
+ * Registers EVM exact payment schemes to an x402Client instance.
+ *
+ * This function registers:
+ * - V2: eip155:* wildcard scheme with ExactEvmScheme (or specific networks if provided)
+ * - V1: All supported EVM networks with ExactEvmSchemeV1
+ *
+ * @param client - The x402Client instance to register schemes to
+ * @param config - Configuration for EVM client registration
+ * @returns The client instance for chaining
+ *
+ * @example
+ * ```typescript
+ * import { registerExactEvmScheme } from "@bankofai/x402-evm/exact/client/register";
+ * import { x402Client } from "@bankofai/x402-core/client";
+ * import { privateKeyToAccount } from "viem/accounts";
+ *
+ * const account = privateKeyToAccount("0x...");
+ * const client = new x402Client();
+ * registerExactEvmScheme(client, { signer: account });
+ * ```
+ */
+declare function registerExactEvmScheme(client: x402Client, config: EvmClientConfig): x402Client;
+
+export { type EvmClientConfig, ExactEvmSchemeOptions, registerExactEvmScheme };