@payai/x402-evm 2.3.6 → 2.4.0

package/dist/esm/index.mjs

@@ -1,23 +1,32 @@
 import {
-  ExactEvmScheme,
-  createPermit2ApprovalTx,
-  getPermit2AllowanceReadParams
-} from "./chunk-LWO35IGS.mjs";
+  ExactEvmScheme
+} from "./chunk-D6RXZXOS.mjs";
 import {
   isEIP3009Payload,
-  isPermit2Payload
-} from "./chunk-TKN5V2BV.mjs";
-import "./chunk-GD4MKCN7.mjs";
+  isPermit2Payload,
+  isUptoPermit2Payload
+} from "./chunk-JII456TS.mjs";
+import "./chunk-RYT6M3PA.mjs";
+import {
+  UptoEvmScheme
+} from "./chunk-GJ57SZGI.mjs";
+import {
+  createPermit2ApprovalTx,
+  getPermit2AllowanceReadParams
+} from "./chunk-WKBC5YMI.mjs";
+import "./chunk-CRT6YNY5.mjs";
 import {
   PERMIT2_ADDRESS,
   authorizationTypes,
   eip3009ABI,
   erc20AllowanceAbi,
   permit2WitnessTypes,
+  uptoPermit2WitnessTypes,
   x402ExactPermit2ProxyABI,
   x402ExactPermit2ProxyAddress,
+  x402UptoPermit2ProxyABI,
   x402UptoPermit2ProxyAddress
-} from "./chunk-PCJKIY5G.mjs";
+} from "./chunk-C4ZQMS77.mjs";
 
 // src/signer.ts
 function toClientEvmSigner(signer, publicClient) {
@@ -52,6 +61,7 @@ function toFacilitatorEvmSigner(client) {
 export {
   ExactEvmScheme,
   PERMIT2_ADDRESS,
+  UptoEvmScheme,
   authorizationTypes,
   createPermit2ApprovalTx,
   eip3009ABI,
@@ -59,11 +69,14 @@ export {
   getPermit2AllowanceReadParams,
   isEIP3009Payload,
   isPermit2Payload,
+  isUptoPermit2Payload,
   permit2WitnessTypes,
   toClientEvmSigner,
   toFacilitatorEvmSigner,
+  uptoPermit2WitnessTypes,
   x402ExactPermit2ProxyABI,
   x402ExactPermit2ProxyAddress,
+  x402UptoPermit2ProxyABI,
   x402UptoPermit2ProxyAddress
 };
 //# sourceMappingURL=index.mjs.map

package/dist/esm/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/signer.ts"],"sourcesContent":["/**\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    /** Optional gas limit. When provided, skips eth_estimateGas simulation. */\n    gas?: bigint;\n  }): Promise<`0x${string}`>;\n  sendTransaction(args: { to: `0x${string}`; data: `0x${string}` }): Promise<`0x${string}`>;\n  waitForTransactionReceipt(args: { hash: `0x${string}` }): Promise<{ status: string }>;\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":";;;;;;;;;;;;;;;;;;;;;;AA+HO,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;AASO,SAAS,uBACd,QACsB;AACtB,SAAO;AAAA,IACL,GAAG;AAAA,IACH,cAAc,MAAM,CAAC,OAAO,OAAO;AAAA,EACrC;AACF;","names":[]}
+{"version":3,"sources":["../../src/signer.ts"],"sourcesContent":["/**\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    /** Optional gas limit. When provided, skips eth_estimateGas simulation. */\n    gas?: bigint;\n  }): Promise<`0x${string}`>;\n  sendTransaction(args: { to: `0x${string}`; data: `0x${string}` }): Promise<`0x${string}`>;\n  waitForTransactionReceipt(args: { hash: `0x${string}` }): Promise<{ status: string }>;\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":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+HO,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;AASO,SAAS,uBACd,QACsB;AACtB,SAAO;AAAA,IACL,GAAG;AAAA,IACH,cAAc,MAAM,CAAC,OAAO,OAAO;AAAA,EACrC;AACF;","names":[]}

package/dist/esm/{permit2-Bbh3a8_h.d.mts → permit2-CyZxwngN.d.mts}

@@ -1,89 +1,14 @@
-import { SchemeNetworkClient, PaymentRequirements, PaymentPayloadContext, PaymentPayloadResult } from '@payai/x402/types';
-import { C as ClientEvmSigner } from './signer-D912R4mq.mjs';
-
-type ExactEvmSchemeConfig = {
+type EvmSchemeConfig = {
     rpcUrl?: string;
 };
-type ExactEvmSchemeConfigByChainId = Record<number, ExactEvmSchemeConfig>;
-type ExactEvmSchemeOptions = ExactEvmSchemeConfig | ExactEvmSchemeConfigByChainId;
-
-/**
- * EVM client implementation for the Exact payment scheme.
- * Supports both EIP-3009 (transferWithAuthorization) and Permit2 flows.
- *
- * Routes to the appropriate authorization method based on
- * `requirements.extra.assetTransferMethod`. Defaults to EIP-3009
- * for backward compatibility with older facilitators.
- *
- * When the server advertises `eip2612GasSponsoring` and the asset transfer
- * method is `permit2`, the scheme automatically signs an EIP-2612 permit
- * if the user lacks Permit2 approval. This requires `readContract` on the signer.
- */
-declare class ExactEvmScheme implements SchemeNetworkClient {
-    private readonly signer;
-    private readonly options?;
-    readonly scheme = "exact";
-    /**
-     * Creates a new ExactEvmClient instance.
-     *
-     * @param signer - The EVM signer for client operations.
-     *   Base flow only requires `address` + `signTypedData`.
-     *   Extension enrichment (EIP-2612 / ERC-20 approval sponsoring) additionally
-     *   requires optional capabilities like `readContract` and tx signing helpers.
-     * @param options - Optional RPC configuration used to backfill extension capabilities.
-     */
-    constructor(signer: ClientEvmSigner, options?: ExactEvmSchemeOptions | undefined);
-    /**
-     * Creates a payment payload for the Exact scheme.
-     * Routes to EIP-3009 or Permit2 based on requirements.extra.assetTransferMethod.
-     *
-     * For Permit2 flows, if the server advertises `eip2612GasSponsoring` and the
-     * signer supports `readContract`, automatically signs an EIP-2612 permit
-     * when Permit2 allowance is insufficient.
-     *
-     * @param x402Version - The x402 protocol version
-     * @param paymentRequirements - The payment requirements
-     * @param context - Optional context with server-declared extensions
-     * @returns Promise resolving to a payment payload result (with optional extensions)
-     */
-    createPaymentPayload(x402Version: number, paymentRequirements: PaymentRequirements, context?: PaymentPayloadContext): Promise<PaymentPayloadResult>;
-    /**
-     * Attempts to sign an EIP-2612 permit for gasless Permit2 approval.
-     *
-     * Returns extension data if:
-     * 1. Server advertises eip2612GasSponsoring
-     * 2. Signer has readContract capability
-     * 3. Current Permit2 allowance is insufficient
-     *
-     * Returns undefined if the extension should not be used.
-     *
-     * @param requirements - The payment requirements from the server
-     * @param result - The payment payload result from the scheme
-     * @param context - Optional context containing server extensions and metadata
-     * @returns Extension data for EIP-2612 gas sponsoring, or undefined if not applicable
-     */
-    private trySignEip2612Permit;
-    /**
-     * Attempts to sign an ERC-20 approval transaction for gasless Permit2 approval.
-     *
-     * This is the fallback path when the token does not support EIP-2612. The client
-     * signs (but does not broadcast) a raw `approve(Permit2, MaxUint256)` transaction.
-     * The facilitator broadcasts it atomically before settling.
-     *
-     * Returns extension data if:
-     * 1. Server advertises erc20ApprovalGasSponsoring
-     * 2. Signer has signTransaction + getTransactionCount capabilities
-     * 3. Current Permit2 allowance is insufficient
-     *
-     * Returns undefined if the extension should not be used.
-     *
-     * @param requirements - The payment requirements from the server
-     * @param _result - The payment payload result from the scheme (unused)
-     * @param context - Optional context containing server extensions and metadata
-     * @returns Extension data for ERC-20 approval gas sponsoring, or undefined if not applicable
-     */
-    private trySignErc20Approval;
-}
+type EvmSchemeConfigByChainId = Record<number, EvmSchemeConfig>;
+type EvmSchemeOptions = EvmSchemeConfig | EvmSchemeConfigByChainId;
+/** @deprecated Use EvmSchemeConfig */
+type ExactEvmSchemeConfig = EvmSchemeConfig;
+/** @deprecated Use EvmSchemeConfigByChainId */
+type ExactEvmSchemeConfigByChainId = EvmSchemeConfigByChainId;
+/** @deprecated Use EvmSchemeOptions */
+type ExactEvmSchemeOptions = EvmSchemeOptions;
 
 declare const authorizationTypes: {
     readonly TransferWithAuthorization: readonly [{
@@ -107,7 +32,7 @@ declare const authorizationTypes: {
     }];
 };
 /**
- * Permit2 EIP-712 types for signing PermitWitnessTransferFrom.
+ * Permit2 EIP-712 types for signing PermitWitnessTransferFrom (exact scheme).
  * Must match the exact format expected by the Permit2 contract.
  * Note: Types must be in ALPHABETICAL order after the primary type (TokenPermissions < Witness).
  */
@@ -143,6 +68,47 @@ declare const permit2WitnessTypes: {
         readonly type: "uint256";
     }];
 };
+/**
+ * Permit2 EIP-712 types for signing PermitWitnessTransferFrom (upto scheme).
+ * The upto witness includes a `facilitator` field that the exact witness does not.
+ * This ensures only the authorized facilitator can settle the payment.
+ * Must match: Witness(address to,address facilitator,uint256 validAfter)
+ */
+declare const uptoPermit2WitnessTypes: {
+    readonly PermitWitnessTransferFrom: readonly [{
+        readonly name: "permitted";
+        readonly type: "TokenPermissions";
+    }, {
+        readonly name: "spender";
+        readonly type: "address";
+    }, {
+        readonly name: "nonce";
+        readonly type: "uint256";
+    }, {
+        readonly name: "deadline";
+        readonly type: "uint256";
+    }, {
+        readonly name: "witness";
+        readonly type: "Witness";
+    }];
+    readonly TokenPermissions: readonly [{
+        readonly name: "token";
+        readonly type: "address";
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+    }];
+    readonly Witness: readonly [{
+        readonly name: "to";
+        readonly type: "address";
+    }, {
+        readonly name: "facilitator";
+        readonly type: "address";
+    }, {
+        readonly name: "validAfter";
+        readonly type: "uint256";
+    }];
+};
 declare const eip3009ABI: readonly [{
     readonly inputs: readonly [{
         readonly name: "from";
@@ -289,7 +255,232 @@ declare const x402ExactPermit2ProxyAddress: "0x402085c248EeA27D92E8b30b2C58ed07f
  * - Vanity-mined salt for prefix 0x4020 and suffix 0002
  * - Contract bytecode + constructor args (PERMIT2_ADDRESS)
  */
-declare const x402UptoPermit2ProxyAddress: "0x402039b3d6E6BEC5A02c2C9fd937ac17A6940002";
+declare const x402UptoPermit2ProxyAddress: "0x4020A4f3b7b90ccA423B9fabCc0CE57C6C240002";
+/**
+ * x402UptoPermit2Proxy ABI — settle/settleWithPermit for the upto payment scheme.
+ * Key differences from exact: settle() takes a `uint256 amount` parameter, and the
+ * Witness struct includes an `address facilitator` field.
+ */
+declare const x402UptoPermit2ProxyABI: readonly [{
+    readonly type: "function";
+    readonly name: "PERMIT2";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "address";
+        readonly internalType: "contract ISignatureTransfer";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "WITNESS_TYPEHASH";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bytes32";
+        readonly internalType: "bytes32";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "WITNESS_TYPE_STRING";
+    readonly inputs: readonly [];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "string";
+        readonly internalType: "string";
+    }];
+    readonly stateMutability: "view";
+}, {
+    readonly type: "function";
+    readonly name: "settle";
+    readonly inputs: readonly [{
+        readonly name: "permit";
+        readonly type: "tuple";
+        readonly internalType: "struct ISignatureTransfer.PermitTransferFrom";
+        readonly components: readonly [{
+            readonly name: "permitted";
+            readonly type: "tuple";
+            readonly internalType: "struct ISignatureTransfer.TokenPermissions";
+            readonly components: readonly [{
+                readonly name: "token";
+                readonly type: "address";
+                readonly internalType: "address";
+            }, {
+                readonly name: "amount";
+                readonly type: "uint256";
+                readonly internalType: "uint256";
+            }];
+        }, {
+            readonly name: "nonce";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "deadline";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }];
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "owner";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "witness";
+        readonly type: "tuple";
+        readonly internalType: "struct x402UptoPermit2Proxy.Witness";
+        readonly components: readonly [{
+            readonly name: "to";
+            readonly type: "address";
+            readonly internalType: "address";
+        }, {
+            readonly name: "facilitator";
+            readonly type: "address";
+            readonly internalType: "address";
+        }, {
+            readonly name: "validAfter";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }];
+    }, {
+        readonly name: "signature";
+        readonly type: "bytes";
+        readonly internalType: "bytes";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "function";
+    readonly name: "settleWithPermit";
+    readonly inputs: readonly [{
+        readonly name: "permit2612";
+        readonly type: "tuple";
+        readonly internalType: "struct x402UptoPermit2Proxy.EIP2612Permit";
+        readonly components: readonly [{
+            readonly name: "value";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "deadline";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "r";
+            readonly type: "bytes32";
+            readonly internalType: "bytes32";
+        }, {
+            readonly name: "s";
+            readonly type: "bytes32";
+            readonly internalType: "bytes32";
+        }, {
+            readonly name: "v";
+            readonly type: "uint8";
+            readonly internalType: "uint8";
+        }];
+    }, {
+        readonly name: "permit";
+        readonly type: "tuple";
+        readonly internalType: "struct ISignatureTransfer.PermitTransferFrom";
+        readonly components: readonly [{
+            readonly name: "permitted";
+            readonly type: "tuple";
+            readonly internalType: "struct ISignatureTransfer.TokenPermissions";
+            readonly components: readonly [{
+                readonly name: "token";
+                readonly type: "address";
+                readonly internalType: "address";
+            }, {
+                readonly name: "amount";
+                readonly type: "uint256";
+                readonly internalType: "uint256";
+            }];
+        }, {
+            readonly name: "nonce";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }, {
+            readonly name: "deadline";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }];
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+        readonly internalType: "uint256";
+    }, {
+        readonly name: "owner";
+        readonly type: "address";
+        readonly internalType: "address";
+    }, {
+        readonly name: "witness";
+        readonly type: "tuple";
+        readonly internalType: "struct x402UptoPermit2Proxy.Witness";
+        readonly components: readonly [{
+            readonly name: "to";
+            readonly type: "address";
+            readonly internalType: "address";
+        }, {
+            readonly name: "facilitator";
+            readonly type: "address";
+            readonly internalType: "address";
+        }, {
+            readonly name: "validAfter";
+            readonly type: "uint256";
+            readonly internalType: "uint256";
+        }];
+    }, {
+        readonly name: "signature";
+        readonly type: "bytes";
+        readonly internalType: "bytes";
+    }];
+    readonly outputs: readonly [];
+    readonly stateMutability: "nonpayable";
+}, {
+    readonly type: "event";
+    readonly name: "Settled";
+    readonly inputs: readonly [];
+    readonly anonymous: false;
+}, {
+    readonly type: "event";
+    readonly name: "SettledWithPermit";
+    readonly inputs: readonly [];
+    readonly anonymous: false;
+}, {
+    readonly type: "error";
+    readonly name: "AmountExceedsPermitted";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "InvalidDestination";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "InvalidOwner";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "InvalidPermit2Address";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "PaymentTooEarly";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "Permit2612AmountMismatch";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "ReentrancyGuardReentrantCall";
+    readonly inputs: readonly [];
+}, {
+    readonly type: "error";
+    readonly name: "UnauthorizedFacilitator";
+    readonly inputs: readonly [];
+}];
 /**
  * x402ExactPermit2Proxy ABI - settle function for exact payment scheme.
  */
@@ -547,4 +738,4 @@ declare function getPermit2AllowanceReadParams(params: Permit2AllowanceParams):
     args: [`0x${string}`, `0x${string}`];
 };
 
-export { ExactEvmScheme as E, type Permit2AllowanceParams as P, PERMIT2_ADDRESS as a, x402UptoPermit2ProxyAddress as b, createPermit2ApprovalTx as c, authorizationTypes as d, erc20AllowanceAbi as e, eip3009ABI as f, getPermit2AllowanceReadParams as g, x402ExactPermit2ProxyABI as h, type ExactEvmSchemeOptions as i, type ExactEvmSchemeConfig as j, type ExactEvmSchemeConfigByChainId as k, permit2WitnessTypes as p, x402ExactPermit2ProxyAddress as x };
+export { type ExactEvmSchemeOptions as E, type Permit2AllowanceParams as P, PERMIT2_ADDRESS as a, x402UptoPermit2ProxyAddress as b, createPermit2ApprovalTx as c, authorizationTypes as d, erc20AllowanceAbi as e, eip3009ABI as f, getPermit2AllowanceReadParams as g, x402ExactPermit2ProxyABI as h, x402UptoPermit2ProxyABI as i, type ExactEvmSchemeConfig as j, type ExactEvmSchemeConfigByChainId as k, type EvmSchemeOptions as l, type EvmSchemeConfig as m, type EvmSchemeConfigByChainId as n, permit2WitnessTypes as p, uptoPermit2WitnessTypes as u, x402ExactPermit2ProxyAddress as x };

package/dist/esm/scheme-DCR7hsa3.d.mts

@@ -0,0 +1,47 @@
+import { SchemeNetworkClient, PaymentRequirements, PaymentPayloadContext, PaymentPayloadResult } from '@payai/x402/types';
+import { C as ClientEvmSigner } from './signer-D912R4mq.mjs';
+import { E as ExactEvmSchemeOptions } from './permit2-CyZxwngN.mjs';
+
+/**
+ * EVM client implementation for the Exact payment scheme.
+ * Supports both EIP-3009 (transferWithAuthorization) and Permit2 flows.
+ *
+ * Routes to the appropriate authorization method based on
+ * `requirements.extra.assetTransferMethod`. Defaults to EIP-3009
+ * for backward compatibility with older facilitators.
+ *
+ * When the server advertises `eip2612GasSponsoring` and the asset transfer
+ * method is `permit2`, the scheme automatically signs an EIP-2612 permit
+ * if the user lacks Permit2 approval. This requires `readContract` on the signer.
+ */
+declare class ExactEvmScheme implements SchemeNetworkClient {
+    private readonly signer;
+    private readonly options?;
+    readonly scheme = "exact";
+    /**
+     * Creates a new ExactEvmClient instance.
+     *
+     * @param signer - The EVM signer for client operations.
+     *   Base flow only requires `address` + `signTypedData`.
+     *   Extension enrichment (EIP-2612 / ERC-20 approval sponsoring) additionally
+     *   requires optional capabilities like `readContract` and tx signing helpers.
+     * @param options - Optional RPC configuration used to backfill extension capabilities.
+     */
+    constructor(signer: ClientEvmSigner, options?: ExactEvmSchemeOptions | undefined);
+    /**
+     * Creates a payment payload for the Exact scheme.
+     * Routes to EIP-3009 or Permit2 based on requirements.extra.assetTransferMethod.
+     *
+     * For Permit2 flows, if the server advertises `eip2612GasSponsoring` and the
+     * signer supports `readContract`, automatically signs an EIP-2612 permit
+     * when Permit2 allowance is insufficient.
+     *
+     * @param x402Version - The x402 protocol version
+     * @param paymentRequirements - The payment requirements
+     * @param context - Optional context with server-declared extensions
+     * @returns Promise resolving to a payment payload result (with optional extensions)
+     */
+    createPaymentPayload(x402Version: number, paymentRequirements: PaymentRequirements, context?: PaymentPayloadContext): Promise<PaymentPayloadResult>;
+}
+
+export { ExactEvmScheme as E };

package/dist/esm/upto/client/index.d.mts

@@ -0,0 +1,32 @@
+import { SchemeNetworkClient, PaymentRequirements, PaymentPayloadContext, PaymentPayloadResult } from '@payai/x402/types';
+import { C as ClientEvmSigner } from '../../signer-D912R4mq.mjs';
+import { l as EvmSchemeOptions } from '../../permit2-CyZxwngN.mjs';
+export { P as Permit2AllowanceParams, m as UptoEvmSchemeConfig, n as UptoEvmSchemeConfigByChainId, c as createPermit2ApprovalTx, e as erc20AllowanceAbi, g as getPermit2AllowanceReadParams } from '../../permit2-CyZxwngN.mjs';
+
+/**
+ * EVM client implementation for the Upto payment scheme.
+ * Handles Permit2-based payment payload creation and gas-sponsoring extensions.
+ */
+declare class UptoEvmScheme implements SchemeNetworkClient {
+    private readonly signer;
+    private readonly options?;
+    readonly scheme = "upto";
+    /**
+     * Creates a new UptoEvmScheme instance.
+     *
+     * @param signer - The EVM signer for client operations
+     * @param options - Optional RPC configuration
+     */
+    constructor(signer: ClientEvmSigner, options?: EvmSchemeOptions | undefined);
+    /**
+     * Creates a payment payload for the Upto scheme using Permit2.
+     *
+     * @param x402Version - The x402 protocol version
+     * @param paymentRequirements - The payment requirements
+     * @param context - Optional context with server-declared extensions
+     * @returns Promise resolving to a payment payload result
+     */
+    createPaymentPayload(x402Version: number, paymentRequirements: PaymentRequirements, context?: PaymentPayloadContext): Promise<PaymentPayloadResult>;
+}
+
+export { UptoEvmScheme, EvmSchemeOptions as UptoEvmSchemeOptions };

package/dist/esm/upto/client/index.mjs

@@ -0,0 +1,18 @@
+import {
+  UptoEvmScheme
+} from "../../chunk-GJ57SZGI.mjs";
+import {
+  createPermit2ApprovalTx,
+  getPermit2AllowanceReadParams
+} from "../../chunk-WKBC5YMI.mjs";
+import "../../chunk-CRT6YNY5.mjs";
+import {
+  erc20AllowanceAbi
+} from "../../chunk-C4ZQMS77.mjs";
+export {
+  UptoEvmScheme,
+  createPermit2ApprovalTx,
+  erc20AllowanceAbi,
+  getPermit2AllowanceReadParams
+};
+//# sourceMappingURL=index.mjs.map

package/dist/esm/upto/client/index.mjs.map

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

package/dist/esm/upto/facilitator/index.d.mts

@@ -0,0 +1,52 @@
+import { SchemeNetworkFacilitator, PaymentPayload, PaymentRequirements, FacilitatorContext, VerifyResponse, SettleResponse } from '@payai/x402/types';
+import { F as FacilitatorEvmSigner } from '../../signer-D912R4mq.mjs';
+
+/**
+ * EVM facilitator implementation for the Upto payment scheme.
+ * Handles verification and settlement of Permit2-based payments.
+ */
+declare class UptoEvmScheme implements SchemeNetworkFacilitator {
+    private readonly signer;
+    readonly scheme = "upto";
+    readonly caipFamily = "eip155:*";
+    /**
+     * Creates a new UptoEvmScheme facilitator instance.
+     *
+     * @param signer - The EVM signer for facilitator operations
+     */
+    constructor(signer: FacilitatorEvmSigner);
+    /**
+     * Returns extra metadata required by the upto scheme, including the facilitator address.
+     *
+     * @param _ - The network identifier (unused)
+     * @returns Object with facilitatorAddress, or undefined if no signer addresses are available
+     */
+    getExtra(_: string): Record<string, unknown> | undefined;
+    /**
+     * Returns the list of facilitator signer addresses for the upto scheme.
+     *
+     * @param _ - The network identifier (unused)
+     * @returns Array of facilitator signer addresses
+     */
+    getSigners(_: string): string[];
+    /**
+     * Verifies an upto Permit2 payment payload against the given requirements.
+     *
+     * @param payload - The payment payload to verify
+     * @param requirements - The payment requirements to verify against
+     * @param context - Optional facilitator context
+     * @returns Promise resolving to a verification response
+     */
+    verify(payload: PaymentPayload, requirements: PaymentRequirements, context?: FacilitatorContext): Promise<VerifyResponse>;
+    /**
+     * Settles an upto Permit2 payment on-chain.
+     *
+     * @param payload - The payment payload to settle
+     * @param requirements - The payment requirements
+     * @param context - Optional facilitator context
+     * @returns Promise resolving to a settlement response
+     */
+    settle(payload: PaymentPayload, requirements: PaymentRequirements, context?: FacilitatorContext): Promise<SettleResponse>;
+}
+
+export { UptoEvmScheme };