@x402/evm 2.8.0 → 2.9.0

package/dist/cjs/index.js

@@ -22,6 +22,7 @@ var src_exports = {};
 __export(src_exports, {
   ExactEvmScheme: () => ExactEvmScheme,
   PERMIT2_ADDRESS: () => PERMIT2_ADDRESS,
+  UptoEvmScheme: () => UptoEvmScheme,
   authorizationTypes: () => authorizationTypes,
   createPermit2ApprovalTx: () => createPermit2ApprovalTx,
   eip3009ABI: () => eip3009ABI,
@@ -29,15 +30,21 @@ __export(src_exports, {
   getPermit2AllowanceReadParams: () => getPermit2AllowanceReadParams,
   isEIP3009Payload: () => isEIP3009Payload,
   isPermit2Payload: () => isPermit2Payload,
+  isUptoPermit2Payload: () => isUptoPermit2Payload,
   permit2WitnessTypes: () => permit2WitnessTypes,
   toClientEvmSigner: () => toClientEvmSigner,
   toFacilitatorEvmSigner: () => toFacilitatorEvmSigner,
+  uptoPermit2WitnessTypes: () => uptoPermit2WitnessTypes,
   x402ExactPermit2ProxyABI: () => x402ExactPermit2ProxyABI,
   x402ExactPermit2ProxyAddress: () => x402ExactPermit2ProxyAddress,
+  x402UptoPermit2ProxyABI: () => x402UptoPermit2ProxyABI,
   x402UptoPermit2ProxyAddress: () => x402UptoPermit2ProxyAddress
 });
 module.exports = __toCommonJS(src_exports);
 
+// src/exact/client/eip3009.ts
+var import_viem2 = require("viem");
+
 // src/constants.ts
 var authorizationTypes = {
   TransferWithAuthorization: [
@@ -66,6 +73,24 @@ var permit2WitnessTypes = {
     { name: "validAfter", type: "uint256" }
   ]
 };
+var uptoPermit2WitnessTypes = {
+  PermitWitnessTransferFrom: [
+    { name: "permitted", type: "TokenPermissions" },
+    { name: "spender", type: "address" },
+    { name: "nonce", type: "uint256" },
+    { name: "deadline", type: "uint256" },
+    { name: "witness", type: "Witness" }
+  ],
+  TokenPermissions: [
+    { name: "token", type: "address" },
+    { name: "amount", type: "uint256" }
+  ],
+  Witness: [
+    { name: "to", type: "address" },
+    { name: "facilitator", type: "address" },
+    { name: "validAfter", type: "uint256" }
+  ]
+};
 var eip3009ABI = [
   {
     inputs: [
@@ -178,11 +203,131 @@ var DEFAULT_MAX_FEE_PER_GAS = 1000000000n;
 var DEFAULT_MAX_PRIORITY_FEE_PER_GAS = 100000000n;
 var PERMIT2_ADDRESS = "0x000000000022D473030F116dDEE9F6B43aC78BA3";
 var x402ExactPermit2ProxyAddress = "0x402085c248EeA27D92E8b30b2C58ed07f9E20001";
-var x402UptoPermit2ProxyAddress = "0x402039b3d6E6BEC5A02c2C9fd937ac17A6940002";
+var x402UptoPermit2ProxyAddress = "0x4020A4f3b7b90ccA423B9fabCc0CE57C6C240002";
 var permit2WitnessABIComponents = [
   { name: "to", type: "address", internalType: "address" },
   { name: "validAfter", type: "uint256", internalType: "uint256" }
 ];
+var uptoPermit2WitnessABIComponents = [
+  { name: "to", type: "address", internalType: "address" },
+  { name: "facilitator", type: "address", internalType: "address" },
+  { name: "validAfter", type: "uint256", internalType: "uint256" }
+];
+var x402UptoPermit2ProxyABI = [
+  {
+    type: "function",
+    name: "PERMIT2",
+    inputs: [],
+    outputs: [{ name: "", type: "address", internalType: "contract ISignatureTransfer" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "WITNESS_TYPEHASH",
+    inputs: [],
+    outputs: [{ name: "", type: "bytes32", internalType: "bytes32" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "WITNESS_TYPE_STRING",
+    inputs: [],
+    outputs: [{ name: "", type: "string", internalType: "string" }],
+    stateMutability: "view"
+  },
+  {
+    type: "function",
+    name: "settle",
+    inputs: [
+      {
+        name: "permit",
+        type: "tuple",
+        internalType: "struct ISignatureTransfer.PermitTransferFrom",
+        components: [
+          {
+            name: "permitted",
+            type: "tuple",
+            internalType: "struct ISignatureTransfer.TokenPermissions",
+            components: [
+              { name: "token", type: "address", internalType: "address" },
+              { name: "amount", type: "uint256", internalType: "uint256" }
+            ]
+          },
+          { name: "nonce", type: "uint256", internalType: "uint256" },
+          { name: "deadline", type: "uint256", internalType: "uint256" }
+        ]
+      },
+      { name: "amount", type: "uint256", internalType: "uint256" },
+      { name: "owner", type: "address", internalType: "address" },
+      {
+        name: "witness",
+        type: "tuple",
+        internalType: "struct x402UptoPermit2Proxy.Witness",
+        components: uptoPermit2WitnessABIComponents
+      },
+      { name: "signature", type: "bytes", internalType: "bytes" }
+    ],
+    outputs: [],
+    stateMutability: "nonpayable"
+  },
+  {
+    type: "function",
+    name: "settleWithPermit",
+    inputs: [
+      {
+        name: "permit2612",
+        type: "tuple",
+        internalType: "struct x402UptoPermit2Proxy.EIP2612Permit",
+        components: [
+          { name: "value", type: "uint256", internalType: "uint256" },
+          { name: "deadline", type: "uint256", internalType: "uint256" },
+          { name: "r", type: "bytes32", internalType: "bytes32" },
+          { name: "s", type: "bytes32", internalType: "bytes32" },
+          { name: "v", type: "uint8", internalType: "uint8" }
+        ]
+      },
+      {
+        name: "permit",
+        type: "tuple",
+        internalType: "struct ISignatureTransfer.PermitTransferFrom",
+        components: [
+          {
+            name: "permitted",
+            type: "tuple",
+            internalType: "struct ISignatureTransfer.TokenPermissions",
+            components: [
+              { name: "token", type: "address", internalType: "address" },
+              { name: "amount", type: "uint256", internalType: "uint256" }
+            ]
+          },
+          { name: "nonce", type: "uint256", internalType: "uint256" },
+          { name: "deadline", type: "uint256", internalType: "uint256" }
+        ]
+      },
+      { name: "amount", type: "uint256", internalType: "uint256" },
+      { name: "owner", type: "address", internalType: "address" },
+      {
+        name: "witness",
+        type: "tuple",
+        internalType: "struct x402UptoPermit2Proxy.Witness",
+        components: uptoPermit2WitnessABIComponents
+      },
+      { name: "signature", type: "bytes", internalType: "bytes" }
+    ],
+    outputs: [],
+    stateMutability: "nonpayable"
+  },
+  { type: "event", name: "Settled", inputs: [], anonymous: false },
+  { type: "event", name: "SettledWithPermit", inputs: [], anonymous: false },
+  { type: "error", name: "AmountExceedsPermitted", inputs: [] },
+  { type: "error", name: "InvalidDestination", inputs: [] },
+  { type: "error", name: "InvalidOwner", inputs: [] },
+  { type: "error", name: "InvalidPermit2Address", inputs: [] },
+  { type: "error", name: "PaymentTooEarly", inputs: [] },
+  { type: "error", name: "Permit2612AmountMismatch", inputs: [] },
+  { type: "error", name: "ReentrancyGuardReentrantCall", inputs: [] },
+  { type: "error", name: "UnauthorizedFacilitator", inputs: [] }
+];
 var x402ExactPermit2ProxyABI = [
   {
     type: "function",
@@ -296,9 +441,6 @@ var x402ExactPermit2ProxyABI = [
   { type: "error", name: "ReentrancyGuardReentrantCall", inputs: [] }
 ];
 
-// src/exact/client/scheme.ts
-var import_viem7 = require("viem");
-
 // src/utils.ts
 var import_viem = require("viem");
 function getEvmChainId(network) {
@@ -327,13 +469,7 @@ function createPermit2Nonce() {
   return BigInt((0, import_viem.toHex)(randomBytes)).toString();
 }
 
-// src/exact/extensions.ts
-var EIP2612_GAS_SPONSORING_KEY = "eip2612GasSponsoring";
-var ERC20_APPROVAL_GAS_SPONSORING_KEY = "erc20ApprovalGasSponsoring";
-var ERC20_APPROVAL_GAS_SPONSORING_VERSION = "1";
-
 // src/exact/client/eip3009.ts
-var import_viem2 = require("viem");
 async function createEIP3009Payload(signer, x402Version, paymentRequirements) {
   const nonce = createNonce();
   const now = Math.floor(Date.now() / 1e3);
@@ -386,9 +522,24 @@ async function signEIP3009Authorization(signer, authorization, requirements) {
 }
 
 // src/exact/client/permit2.ts
+var import_viem6 = require("viem");
+
+// src/exact/extensions.ts
+var EIP2612_GAS_SPONSORING_KEY = "eip2612GasSponsoring";
+var ERC20_APPROVAL_GAS_SPONSORING_KEY = "erc20ApprovalGasSponsoring";
+var ERC20_APPROVAL_GAS_SPONSORING_VERSION = "1";
+
+// src/shared/permit2.ts
+var import_viem5 = require("viem");
+
+// src/multicall.ts
 var import_viem3 = require("viem");
-var MAX_UINT256 = BigInt("0xffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff");
-async function createPermit2Payload(signer, x402Version, paymentRequirements) {
+
+// src/shared/erc20approval.ts
+var import_viem4 = require("viem");
+
+// src/shared/permit2.ts
+async function createPermit2PayloadForProxy(proxyAddress, signer, x402Version, paymentRequirements) {
   const now = Math.floor(Date.now() / 1e3);
   const nonce = createPermit2Nonce();
   const validAfter = (now - 600).toString();
@@ -396,14 +547,14 @@ async function createPermit2Payload(signer, x402Version, paymentRequirements) {
   const permit2Authorization = {
     from: signer.address,
     permitted: {
-      token: (0, import_viem3.getAddress)(paymentRequirements.asset),
+      token: (0, import_viem5.getAddress)(paymentRequirements.asset),
       amount: paymentRequirements.amount
     },
-    spender: x402ExactPermit2ProxyAddress,
+    spender: proxyAddress,
     nonce,
     deadline,
     witness: {
-      to: (0, import_viem3.getAddress)(paymentRequirements.payTo),
+      to: (0, import_viem5.getAddress)(paymentRequirements.payTo),
       validAfter
     }
   };
@@ -412,67 +563,71 @@ async function createPermit2Payload(signer, x402Version, paymentRequirements) {
     permit2Authorization,
     paymentRequirements
   );
-  const payload = {
-    signature,
-    permit2Authorization
-  };
   return {
     x402Version,
-    payload
+    payload: { signature, permit2Authorization }
   };
 }
 async function signPermit2Authorization(signer, permit2Authorization, requirements) {
   const chainId = getEvmChainId(requirements.network);
-  const domain = {
-    name: "Permit2",
-    chainId,
-    verifyingContract: PERMIT2_ADDRESS
-  };
-  const message = {
-    permitted: {
-      token: (0, import_viem3.getAddress)(permit2Authorization.permitted.token),
-      amount: BigInt(permit2Authorization.permitted.amount)
-    },
-    spender: (0, import_viem3.getAddress)(permit2Authorization.spender),
-    nonce: BigInt(permit2Authorization.nonce),
-    deadline: BigInt(permit2Authorization.deadline),
-    witness: {
-      to: (0, import_viem3.getAddress)(permit2Authorization.witness.to),
-      validAfter: BigInt(permit2Authorization.witness.validAfter)
-    }
-  };
   return await signer.signTypedData({
-    domain,
+    domain: { name: "Permit2", chainId, verifyingContract: PERMIT2_ADDRESS },
     types: permit2WitnessTypes,
     primaryType: "PermitWitnessTransferFrom",
-    message
+    message: {
+      permitted: {
+        token: (0, import_viem5.getAddress)(permit2Authorization.permitted.token),
+        amount: BigInt(permit2Authorization.permitted.amount)
+      },
+      spender: (0, import_viem5.getAddress)(permit2Authorization.spender),
+      nonce: BigInt(permit2Authorization.nonce),
+      deadline: BigInt(permit2Authorization.deadline),
+      witness: {
+        to: (0, import_viem5.getAddress)(permit2Authorization.witness.to),
+        validAfter: BigInt(permit2Authorization.witness.validAfter)
+      }
+    }
   });
 }
+
+// src/exact/client/permit2.ts
+var MAX_UINT256 = BigInt("0xffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff");
+async function createPermit2Payload(signer, x402Version, paymentRequirements) {
+  return createPermit2PayloadForProxy(
+    x402ExactPermit2ProxyAddress,
+    signer,
+    x402Version,
+    paymentRequirements
+  );
+}
 function createPermit2ApprovalTx(tokenAddress) {
-  const data = (0, import_viem3.encodeFunctionData)({
+  const data = (0, import_viem6.encodeFunctionData)({
     abi: erc20ApproveAbi,
     functionName: "approve",
     args: [PERMIT2_ADDRESS, MAX_UINT256]
   });
   return {
-    to: (0, import_viem3.getAddress)(tokenAddress),
+    to: (0, import_viem6.getAddress)(tokenAddress),
     data
   };
 }
 function getPermit2AllowanceReadParams(params) {
   return {
-    address: (0, import_viem3.getAddress)(params.tokenAddress),
+    address: (0, import_viem6.getAddress)(params.tokenAddress),
     abi: erc20AllowanceAbi,
     functionName: "allowance",
-    args: [(0, import_viem3.getAddress)(params.ownerAddress), PERMIT2_ADDRESS]
+    args: [(0, import_viem6.getAddress)(params.ownerAddress), PERMIT2_ADDRESS]
   };
 }
 
+// src/shared/extensions.ts
+var import_viem10 = require("viem");
+
 // src/exact/client/eip2612.ts
-var import_viem4 = require("viem");
+var import_viem7 = require("viem");
 async function signEip2612Permit(signer, tokenAddress, tokenName, tokenVersion, chainId, deadline, permittedAmount) {
   const owner = signer.address;
-  const spender = (0, import_viem4.getAddress)(PERMIT2_ADDRESS);
+  const spender = (0, import_viem7.getAddress)(PERMIT2_ADDRESS);
   const nonce = await signer.readContract({
     address: tokenAddress,
     abi: eip2612NoncesAbi,
@@ -512,14 +667,14 @@ async function signEip2612Permit(signer, tokenAddress, tokenName, tokenVersion,
 }
 
 // src/exact/client/erc20approval.ts
-var import_viem5 = require("viem");
+var import_viem8 = require("viem");
 async function signErc20ApprovalTransaction(signer, tokenAddress, chainId) {
   const from = signer.address;
-  const spender = (0, import_viem5.getAddress)(PERMIT2_ADDRESS);
-  const data = (0, import_viem5.encodeFunctionData)({
+  const spender = (0, import_viem8.getAddress)(PERMIT2_ADDRESS);
+  const data = (0, import_viem8.encodeFunctionData)({
     abi: erc20ApproveAbi,
     functionName: "approve",
-    args: [spender, import_viem5.maxUint256]
+    args: [spender, import_viem8.maxUint256]
   });
   const nonce = await signer.getTransactionCount({ address: from });
   let maxFeePerGas;
@@ -548,14 +703,14 @@ async function signErc20ApprovalTransaction(signer, tokenAddress, chainId) {
     from,
     asset: tokenAddress,
     spender,
-    amount: import_viem5.maxUint256.toString(),
+    amount: import_viem8.maxUint256.toString(),
     signedTransaction,
     version: ERC20_APPROVAL_GAS_SPONSORING_VERSION
   };
 }
 
-// src/exact/client/rpc.ts
-var import_viem6 = require("viem");
+// src/shared/rpc.ts
+var import_viem9 = require("viem");
 var rpcClientCache = /* @__PURE__ */ new Map();
 function isConfigByChainId(options) {
   const keys = Object.keys(options);
@@ -566,8 +721,8 @@ function getRpcClient(rpcUrl) {
   if (existing) {
     return existing;
   }
-  const client = (0, import_viem6.createPublicClient)({
-    transport: (0, import_viem6.http)(rpcUrl)
+  const client = (0, import_viem9.createPublicClient)({
+    transport: (0, import_viem9.http)(rpcUrl)
   });
   rpcClientCache.set(rpcUrl, client);
   return client;
@@ -611,6 +766,93 @@ function resolveExtensionRpcCapabilities(network, signer, options) {
   return capabilities;
 }
 
+// src/shared/extensions.ts
+async function trySignEip2612PermitExtension(signer, options, requirements, result, context) {
+  const capabilities = resolveExtensionRpcCapabilities(requirements.network, signer, options);
+  if (!capabilities.readContract) {
+    return void 0;
+  }
+  if (!context?.extensions?.[EIP2612_GAS_SPONSORING_KEY]) {
+    return void 0;
+  }
+  const tokenName = requirements.extra?.name;
+  const tokenVersion = requirements.extra?.version;
+  if (!tokenName || !tokenVersion) {
+    return void 0;
+  }
+  const chainId = getEvmChainId(requirements.network);
+  const tokenAddress = (0, import_viem10.getAddress)(requirements.asset);
+  try {
+    const allowance = await capabilities.readContract({
+      address: tokenAddress,
+      abi: erc20AllowanceAbi,
+      functionName: "allowance",
+      args: [signer.address, PERMIT2_ADDRESS]
+    });
+    if (allowance >= BigInt(requirements.amount)) {
+      return void 0;
+    }
+  } catch {
+  }
+  const permit2Auth = result.payload?.permit2Authorization;
+  const deadline = permit2Auth?.deadline ?? Math.floor(Date.now() / 1e3 + requirements.maxTimeoutSeconds).toString();
+  const info = await signEip2612Permit(
+    {
+      address: signer.address,
+      signTypedData: (msg) => signer.signTypedData(msg),
+      readContract: capabilities.readContract
+    },
+    tokenAddress,
+    tokenName,
+    tokenVersion,
+    chainId,
+    deadline,
+    requirements.amount
+  );
+  return {
+    [EIP2612_GAS_SPONSORING_KEY]: { info }
+  };
+}
+async function trySignErc20ApprovalExtension(signer, options, requirements, context) {
+  const capabilities = resolveExtensionRpcCapabilities(requirements.network, signer, options);
+  if (!capabilities.readContract) {
+    return void 0;
+  }
+  if (!context?.extensions?.[ERC20_APPROVAL_GAS_SPONSORING_KEY]) {
+    return void 0;
+  }
+  if (!capabilities.signTransaction || !capabilities.getTransactionCount) {
+    return void 0;
+  }
+  const chainId = getEvmChainId(requirements.network);
+  const tokenAddress = (0, import_viem10.getAddress)(requirements.asset);
+  try {
+    const allowance = await capabilities.readContract({
+      address: tokenAddress,
+      abi: erc20AllowanceAbi,
+      functionName: "allowance",
+      args: [signer.address, PERMIT2_ADDRESS]
+    });
+    if (allowance >= BigInt(requirements.amount)) {
+      return void 0;
+    }
+  } catch {
+  }
+  const info = await signErc20ApprovalTransaction(
+    {
+      address: signer.address,
+      signTransaction: capabilities.signTransaction,
+      getTransactionCount: capabilities.getTransactionCount,
+      estimateFeesPerGas: capabilities.estimateFeesPerGas
+    },
+    tokenAddress,
+    chainId
+  );
+  return {
+    [ERC20_APPROVAL_GAS_SPONSORING_KEY]: { info }
+  };
+}
+
 // src/exact/client/scheme.ts
 var ExactEvmScheme = class {
   /**
@@ -644,7 +886,9 @@ var ExactEvmScheme = class {
     const assetTransferMethod = paymentRequirements.extra?.assetTransferMethod ?? "eip3009";
     if (assetTransferMethod === "permit2") {
       const result = await createPermit2Payload(this.signer, x402Version, paymentRequirements);
-      const eip2612Extensions = await this.trySignEip2612Permit(
+      const eip2612Extensions = await trySignEip2612PermitExtension(
+        this.signer,
+        this.options,
         paymentRequirements,
         result,
         context
@@ -655,7 +899,12 @@ var ExactEvmScheme = class {
           extensions: eip2612Extensions
         };
       }
-      const erc20Extensions = await this.trySignErc20Approval(paymentRequirements, result, context);
+      const erc20Extensions = await trySignErc20ApprovalExtension(
+        this.signer,
+        this.options,
+        paymentRequirements,
+        context
+      );
       if (erc20Extensions) {
         return {
           ...result,
@@ -666,146 +915,16 @@ var ExactEvmScheme = class {
     }
     return createEIP3009Payload(this.signer, x402Version, paymentRequirements);
   }
-  /**
-   * 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
-   */
-  async trySignEip2612Permit(requirements, result, context) {
-    const capabilities = resolveExtensionRpcCapabilities(
-      requirements.network,
-      this.signer,
-      this.options
-    );
-    if (!capabilities.readContract) {
-      return void 0;
-    }
-    if (!context?.extensions?.[EIP2612_GAS_SPONSORING_KEY]) {
-      return void 0;
-    }
-    const tokenName = requirements.extra?.name;
-    const tokenVersion = requirements.extra?.version;
-    if (!tokenName || !tokenVersion) {
-      return void 0;
-    }
-    const chainId = getEvmChainId(requirements.network);
-    const tokenAddress = (0, import_viem7.getAddress)(requirements.asset);
-    try {
-      const allowance = await capabilities.readContract({
-        address: tokenAddress,
-        abi: erc20AllowanceAbi,
-        functionName: "allowance",
-        args: [this.signer.address, PERMIT2_ADDRESS]
-      });
-      if (allowance >= BigInt(requirements.amount)) {
-        return void 0;
-      }
-    } catch {
-    }
-    const permit2Auth = result.payload?.permit2Authorization;
-    const deadline = permit2Auth?.deadline ?? Math.floor(Date.now() / 1e3 + requirements.maxTimeoutSeconds).toString();
-    const info = await signEip2612Permit(
-      {
-        address: this.signer.address,
-        signTypedData: (msg) => this.signer.signTypedData(msg),
-        readContract: capabilities.readContract
-      },
-      tokenAddress,
-      tokenName,
-      tokenVersion,
-      chainId,
-      deadline,
-      requirements.amount
-    );
-    return {
-      [EIP2612_GAS_SPONSORING_KEY]: { info }
-    };
-  }
-  /**
-   * 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
-   */
-  async trySignErc20Approval(requirements, _result, context) {
-    const capabilities = resolveExtensionRpcCapabilities(
-      requirements.network,
-      this.signer,
-      this.options
-    );
-    if (!capabilities.readContract) {
-      return void 0;
-    }
-    if (!context?.extensions?.[ERC20_APPROVAL_GAS_SPONSORING_KEY]) {
-      return void 0;
-    }
-    if (!capabilities.signTransaction || !capabilities.getTransactionCount) {
-      return void 0;
-    }
-    const chainId = getEvmChainId(requirements.network);
-    const tokenAddress = (0, import_viem7.getAddress)(requirements.asset);
-    try {
-      const allowance = await capabilities.readContract({
-        address: tokenAddress,
-        abi: erc20AllowanceAbi,
-        functionName: "allowance",
-        args: [this.signer.address, PERMIT2_ADDRESS]
-      });
-      if (allowance >= BigInt(requirements.amount)) {
-        return void 0;
-      }
-    } catch {
-    }
-    const info = await signErc20ApprovalTransaction(
-      {
-        address: this.signer.address,
-        signTransaction: capabilities.signTransaction,
-        getTransactionCount: capabilities.getTransactionCount,
-        estimateFeesPerGas: capabilities.estimateFeesPerGas
-      },
-      tokenAddress,
-      chainId
-    );
-    return {
-      [ERC20_APPROVAL_GAS_SPONSORING_KEY]: { info }
-    };
-  }
 };
 
 // src/exact/v1/client/scheme.ts
-var import_viem11 = require("viem");
+var import_viem13 = require("viem");
 
 // src/exact/v1/facilitator/scheme.ts
-var import_viem10 = require("viem");
+var import_viem12 = require("viem");
 
 // src/exact/facilitator/eip3009-utils.ts
-var import_viem9 = require("viem");
-
-// src/multicall.ts
-var import_viem8 = require("viem");
+var import_viem11 = require("viem");
 
 // src/v1/index.ts
 var EVM_NETWORK_CHAIN_ID_MAP = {
@@ -827,7 +946,9 @@ var EVM_NETWORK_CHAIN_ID_MAP = {
   educhain: 41923,
   "skale-base-sepolia": 324705682,
   megaeth: 4326,
-  monad: 143
+  monad: 143,
+  stable: 988,
+  "stable-testnet": 2201
 };
 var NETWORKS = Object.keys(EVM_NETWORK_CHAIN_ID_MAP);
 
@@ -869,10 +990,136 @@ function isPermit2Payload(payload) {
 function isEIP3009Payload(payload) {
   return "authorization" in payload;
 }
+function isUptoPermit2Payload(payload) {
+  if (typeof payload.signature !== "string") return false;
+  if (!("permit2Authorization" in payload)) return false;
+  const auth = payload.permit2Authorization;
+  if (typeof auth !== "object" || auth === null) return false;
+  const a = auth;
+  if (typeof a.from !== "string") return false;
+  if (typeof a.spender !== "string") return false;
+  if (typeof a.nonce !== "string") return false;
+  if (typeof a.deadline !== "string") return false;
+  const permitted = a.permitted;
+  if (typeof permitted !== "object" || permitted === null) return false;
+  const p = permitted;
+  if (typeof p.token !== "string") return false;
+  if (typeof p.amount !== "string") return false;
+  const witness = a.witness;
+  if (typeof witness !== "object" || witness === null) return false;
+  const w = witness;
+  return typeof w.facilitator === "string" && typeof w.to === "string" && typeof w.validAfter === "string";
+}
+
+// src/upto/client/permit2.ts
+var import_viem14 = require("viem");
+async function createUptoPermit2Payload(signer, x402Version, paymentRequirements) {
+  const facilitatorAddress = paymentRequirements.extra?.facilitatorAddress;
+  if (!facilitatorAddress) {
+    throw new Error(
+      "upto scheme requires facilitatorAddress in paymentRequirements.extra. Ensure the server is configured with an upto facilitator that provides getExtra()."
+    );
+  }
+  const now = Math.floor(Date.now() / 1e3);
+  const nonce = createPermit2Nonce();
+  const validAfter = (now - 600).toString();
+  const deadline = (now + paymentRequirements.maxTimeoutSeconds).toString();
+  if (BigInt(deadline) <= BigInt(validAfter)) {
+    throw new Error(
+      `Invalid time window: deadline (${deadline}) must be after validAfter (${validAfter}). Check that maxTimeoutSeconds (${paymentRequirements.maxTimeoutSeconds}) is positive.`
+    );
+  }
+  const permit2Authorization = {
+    from: signer.address,
+    permitted: {
+      token: (0, import_viem14.getAddress)(paymentRequirements.asset),
+      amount: paymentRequirements.amount
+    },
+    spender: x402UptoPermit2ProxyAddress,
+    nonce,
+    deadline,
+    witness: {
+      to: (0, import_viem14.getAddress)(paymentRequirements.payTo),
+      facilitator: (0, import_viem14.getAddress)(facilitatorAddress),
+      validAfter
+    }
+  };
+  const chainId = getEvmChainId(paymentRequirements.network);
+  const signature = await signer.signTypedData({
+    domain: { name: "Permit2", chainId, verifyingContract: PERMIT2_ADDRESS },
+    types: uptoPermit2WitnessTypes,
+    primaryType: "PermitWitnessTransferFrom",
+    message: {
+      permitted: {
+        token: (0, import_viem14.getAddress)(permit2Authorization.permitted.token),
+        amount: BigInt(permit2Authorization.permitted.amount)
+      },
+      spender: (0, import_viem14.getAddress)(permit2Authorization.spender),
+      nonce: BigInt(permit2Authorization.nonce),
+      deadline: BigInt(permit2Authorization.deadline),
+      witness: {
+        to: (0, import_viem14.getAddress)(permit2Authorization.witness.to),
+        facilitator: (0, import_viem14.getAddress)(permit2Authorization.witness.facilitator),
+        validAfter: BigInt(permit2Authorization.witness.validAfter)
+      }
+    }
+  });
+  return {
+    x402Version,
+    payload: { signature, permit2Authorization }
+  };
+}
+
+// src/upto/client/scheme.ts
+var UptoEvmScheme = class {
+  /**
+   * Creates a new UptoEvmScheme instance.
+   *
+   * @param signer - The EVM signer for client operations
+   * @param options - Optional RPC configuration
+   */
+  constructor(signer, options) {
+    this.signer = signer;
+    this.options = options;
+    this.scheme = "upto";
+  }
+  /**
+   * 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
+   */
+  async createPaymentPayload(x402Version, paymentRequirements, context) {
+    const result = await createUptoPermit2Payload(this.signer, x402Version, paymentRequirements);
+    const eip2612Extensions = await trySignEip2612PermitExtension(
+      this.signer,
+      this.options,
+      paymentRequirements,
+      result,
+      context
+    );
+    if (eip2612Extensions) {
+      return { ...result, extensions: eip2612Extensions };
+    }
+    const erc20Extensions = await trySignErc20ApprovalExtension(
+      this.signer,
+      this.options,
+      paymentRequirements,
+      context
+    );
+    if (erc20Extensions) {
+      return { ...result, extensions: erc20Extensions };
+    }
+    return result;
+  }
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ExactEvmScheme,
   PERMIT2_ADDRESS,
+  UptoEvmScheme,
   authorizationTypes,
   createPermit2ApprovalTx,
   eip3009ABI,
@@ -880,11 +1127,14 @@ function isEIP3009Payload(payload) {
   getPermit2AllowanceReadParams,
   isEIP3009Payload,
   isPermit2Payload,
+  isUptoPermit2Payload,
   permit2WitnessTypes,
   toClientEvmSigner,
   toFacilitatorEvmSigner,
+  uptoPermit2WitnessTypes,
   x402ExactPermit2ProxyABI,
   x402ExactPermit2ProxyAddress,
+  x402UptoPermit2ProxyABI,
   x402UptoPermit2ProxyAddress
 });
 //# sourceMappingURL=index.js.map