@dexterai/x402 2.1.0 → 3.0.0

package/dist/client/index.js

@@ -785,21 +785,51 @@ var EvmAdapter = class {
     });
     const url = rpcUrl || this.getDefaultRpcUrl(accept.network);
     const currentAllowance = await this.readAllowance(url, asset, wallet.address, PERMIT2_ADDRESS);
+    let approvalExtension;
     if (currentAllowance < BigInt(amount)) {
-      if (!wallet.sendTransaction) {
+      const approveData = this.encodeApprove(PERMIT2_ADDRESS, MAX_UINT256);
+      if (wallet.signTransaction) {
+        this.log(`Signing Permit2 approval for relay (current allowance: ${currentAllowance})`);
+        const chainId2 = this.getChainId(accept.network);
+        const gasPrice = await this.readGasPrice(url);
+        const nonce2 = await this.readNonce(url, wallet.address);
+        const signedTx = await wallet.signTransaction({
+          to: asset,
+          data: approveData,
+          chainId: chainId2,
+          gas: 50000n,
+          // standard ERC-20 approve
+          gasPrice,
+          nonce: nonce2
+        });
+        approvalExtension = {
+          erc20ApprovalGasSponsoring: {
+            info: {
+              from: wallet.address,
+              asset,
+              spender: PERMIT2_ADDRESS,
+              amount: MAX_UINT256.toString(),
+              signedTransaction: signedTx,
+              version: "1"
+            }
+          }
+        };
+        this.log("Permit2 approval signed for facilitator relay");
+      } else if (wallet.sendTransaction) {
+        this.log(`Approving Permit2 directly (current allowance: ${currentAllowance})`);
+        const approveTxHash = await wallet.sendTransaction({
+          to: asset,
+          data: approveData,
+          value: 0n
+        });
+        this.log(`Permit2 approval tx sent: ${approveTxHash}`);
+        await this.waitForReceipt(url, approveTxHash);
+        this.log("Permit2 approval confirmed");
+      } else {
         throw new Error(
-          "Permit2 payments require a wallet that supports sendTransaction for the one-time Permit2 approval. Use createEvmKeypairWallet() or a browser wallet with transaction support."
+          "Permit2 payments require a wallet that supports signTransaction or sendTransaction for the one-time Permit2 approval. Use createEvmKeypairWallet() or a browser wallet with transaction support."
         );
       }
-      this.log(`Approving Permit2 for ${asset} (current allowance: ${currentAllowance})`);
-      const approveTxHash = await wallet.sendTransaction({
-        to: asset,
-        data: this.encodeApprove(PERMIT2_ADDRESS, MAX_UINT256),
-        value: 0n
-      });
-      this.log(`Permit2 approval tx sent: ${approveTxHash}`);
-      await this.waitForReceipt(url, approveTxHash);
-      this.log("Permit2 approval confirmed");
     } else {
       this.log("Sufficient Permit2 allowance, skipping approval");
     }
@@ -854,7 +884,8 @@ var EvmAdapter = class {
     };
     return {
       serialized: JSON.stringify(payload),
-      signature
+      signature,
+      extensions: approvalExtension
     };
   }
   /**
@@ -923,6 +954,43 @@ var EvmAdapter = class {
     }
     throw new Error(`Approval transaction receipt timeout after ${timeoutMs}ms: ${txHash}`);
   }
+  /**
+   * Read gas price via eth_gasPrice RPC call.
+   */
+  async readGasPrice(rpcUrl) {
+    try {
+      const response = await fetch(rpcUrl, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ jsonrpc: "2.0", id: 1, method: "eth_gasPrice", params: [] })
+      });
+      const result = await response.json();
+      return result.result ? BigInt(result.result) : 50000000n;
+    } catch {
+      return 50000000n;
+    }
+  }
+  /**
+   * Read transaction count (nonce) via eth_getTransactionCount RPC call.
+   */
+  async readNonce(rpcUrl, address) {
+    try {
+      const response = await fetch(rpcUrl, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+          jsonrpc: "2.0",
+          id: 1,
+          method: "eth_getTransactionCount",
+          params: [address, "latest"]
+        })
+      });
+      const result = await response.json();
+      return result.result ? parseInt(result.result, 16) : 0;
+    } catch {
+      return 0;
+    }
+  }
   /**
    * Calculate how much to approve based on the facilitator's approval strategy.
    * Buffered approvals reduce the number of on-chain approval txs for micropayments.
@@ -1184,6 +1252,9 @@ function createX402Client(config) {
       accepted: accept,
       payload
     };
+    if (signedTx.extensions) {
+      paymentSignature.extensions = signedTx.extensions;
+    }
     const paymentSignatureHeader = btoa(JSON.stringify(paymentSignature));
     const passResponse = await customFetch(passUrl, {
       ...init,
@@ -1362,6 +1433,9 @@ function createX402Client(config) {
       accepted: accept,
       payload
     };
+    if (signedTx.extensions) {
+      paymentSignature.extensions = signedTx.extensions;
+    }
     const paymentSignatureHeader = btoa(JSON.stringify(paymentSignature));
     log("Retrying request with payment...");
     const retryResponse = await fetchWithRetry(input, {
@@ -1490,7 +1564,16 @@ async function createEvmKeypairWallet(privateKey) {
   const account = privateKeyToAccount(normalizedKey);
   return {
     address: account.address,
-    signTypedData: (params) => account.signTypedData(params)
+    signTypedData: (params) => account.signTypedData(params),
+    signTransaction: (params) => account.signTransaction({
+      to: params.to,
+      data: params.data,
+      chainId: params.chainId,
+      gas: params.gas,
+      gasPrice: params.gasPrice,
+      nonce: params.nonce,
+      type: "legacy"
+    })
   };
 }
 function isEvmKeypairWallet(wallet) {
@@ -1557,55 +1640,84 @@ function wrapFetch(fetchImpl, options) {
 }
 
 // src/client/discovery.ts
-var DEFAULT_MARKETPLACE = "https://x402.dexter.cash/api/facilitator/marketplace/resources";
-async function searchAPIs(options = {}) {
+var DEFAULT_CAPABILITY_ENDPOINT = "https://x402.dexter.cash/api/x402gle/capability";
+function formatPriceLabel(priceUsdc) {
+  if (priceUsdc == null) return "price on request";
+  if (priceUsdc === 0) return "free";
+  if (priceUsdc < 0.01) return `$${priceUsdc.toFixed(4)}`;
+  return `$${priceUsdc.toFixed(2)}`;
+}
+function mapResult(r) {
+  return {
+    resourceId: r.resourceId,
+    name: r.displayName ?? r.resourceUrl,
+    url: r.resourceUrl,
+    method: r.method || "GET",
+    price: formatPriceLabel(r.pricing.usdc),
+    priceUsdc: r.pricing.usdc,
+    network: r.pricing.network,
+    description: r.description ?? "",
+    category: r.category ?? "uncategorized",
+    qualityScore: r.verification.qualityScore,
+    verified: r.verification.status === "pass",
+    verificationStatus: r.verification.status,
+    totalCalls: r.usage.totalSettlements,
+    totalVolumeUsdc: r.usage.totalVolumeUsdc,
+    iconUrl: r.icon,
+    host: r.host,
+    gamingFlags: r.gaming.flags,
+    gamingSuspicious: r.gaming.suspicious,
+    tier: r.tier,
+    similarity: Math.round(r.similarity * 1e3) / 1e3,
+    why: r.why,
+    score: r.score
+  };
+}
+async function capabilitySearch(options) {
+  if (!options?.query || !options.query.trim()) {
+    throw new Error("capabilitySearch: query is required");
+  }
   const {
     query,
-    category,
-    network,
-    maxPrice,
-    verifiedOnly,
-    sort = "marketplace",
     limit = 20,
-    marketplaceUrl = DEFAULT_MARKETPLACE
+    unverified,
+    testnets,
+    rerank,
+    endpoint = DEFAULT_CAPABILITY_ENDPOINT
   } = options;
   const params = new URLSearchParams();
-  if (query) params.set("search", query);
-  if (category) params.set("category", category);
-  if (network) params.set("network", network);
-  if (maxPrice !== void 0) params.set("maxPrice", String(maxPrice));
-  if (verifiedOnly) params.set("verified", "true");
-  params.set("sort", sort);
-  params.set("order", "desc");
-  params.set("limit", String(Math.min(limit, 50)));
-  const url = `${marketplaceUrl}?${params.toString()}`;
+  params.set("q", query);
+  params.set("limit", String(Math.min(Math.max(limit, 1), 50)));
+  if (unverified) params.set("unverified", "true");
+  if (testnets) params.set("testnets", "true");
+  if (rerank === false) params.set("rerank", "false");
+  const url = `${endpoint}?${params.toString()}`;
   const response = await fetch(url, {
-    headers: { "Accept": "application/json" },
-    signal: AbortSignal.timeout(15e3)
+    headers: { Accept: "application/json" },
+    signal: AbortSignal.timeout(2e4)
   });
   if (!response.ok) {
-    throw new Error(`Marketplace search failed: ${response.status}`);
+    const body = await response.text().catch(() => "");
+    throw new Error(`Capability search failed: ${response.status} ${body.slice(0, 400)}`);
   }
   const data = await response.json();
-  if (!data.resources) return [];
-  return data.resources.map((r) => ({
-    name: r.displayName || r.resourceUrl,
-    url: r.resourceUrl,
-    method: r.method || "GET",
-    price: r.priceLabel || (r.priceUsdc ? `$${r.priceUsdc.toFixed(4)}` : "free"),
-    priceUsdc: r.priceUsdc ?? null,
-    network: r.priceNetwork ?? null,
-    description: r.description || "",
-    category: r.category || "uncategorized",
-    qualityScore: r.qualityScore ?? null,
-    verified: r.verificationStatus === "pass",
-    totalCalls: r.totalSettlements || 0,
-    totalVolume: r.totalVolumeUsdc ? `$${r.totalVolumeUsdc.toLocaleString("en-US", { minimumFractionDigits: 2 })}` : null,
-    seller: r.seller?.displayName ?? null,
-    sellerReputation: r.reputationScore ?? null,
-    authRequired: r.authRequired || false,
-    lastActive: r.lastSettlementAt ?? null
-  }));
+  if (!data.ok) {
+    throw new Error(
+      `Capability search error${data.stage ? ` at stage ${data.stage}` : ""}: ${data.error ?? "unknown"}`
+    );
+  }
+  return {
+    query: data.query,
+    strongResults: data.strongResults.map(mapResult),
+    relatedResults: data.relatedResults.map(mapResult),
+    strongCount: data.strongCount,
+    relatedCount: data.relatedCount,
+    topSimilarity: data.topSimilarity,
+    noMatchReason: data.noMatchReason,
+    rerank: data.rerank,
+    intent: data.intent,
+    durationMs: data.durationMs
+  };
 }
 
 // src/client/budget-account.ts
@@ -1742,6 +1854,7 @@ export {
   SOLANA_MAINNET,
   USDC_MINT,
   X402Error,
+  capabilitySearch,
   createBudgetAccount,
   createEvmAdapter,
   createEvmKeypairWallet,
@@ -1754,6 +1867,5 @@ export {
   getSponsoredRecommendations,
   isEvmKeypairWallet,
   isKeypairWallet,
-  searchAPIs,
   wrapFetch
 };

package/dist/react/index.cjs

@@ -655,21 +655,51 @@ var EvmAdapter = class {
     });
     const url = rpcUrl || this.getDefaultRpcUrl(accept.network);
     const currentAllowance = await this.readAllowance(url, asset, wallet.address, PERMIT2_ADDRESS);
+    let approvalExtension;
     if (currentAllowance < BigInt(amount)) {
-      if (!wallet.sendTransaction) {
+      const approveData = this.encodeApprove(PERMIT2_ADDRESS, MAX_UINT256);
+      if (wallet.signTransaction) {
+        this.log(`Signing Permit2 approval for relay (current allowance: ${currentAllowance})`);
+        const chainId2 = this.getChainId(accept.network);
+        const gasPrice = await this.readGasPrice(url);
+        const nonce2 = await this.readNonce(url, wallet.address);
+        const signedTx = await wallet.signTransaction({
+          to: asset,
+          data: approveData,
+          chainId: chainId2,
+          gas: 50000n,
+          // standard ERC-20 approve
+          gasPrice,
+          nonce: nonce2
+        });
+        approvalExtension = {
+          erc20ApprovalGasSponsoring: {
+            info: {
+              from: wallet.address,
+              asset,
+              spender: PERMIT2_ADDRESS,
+              amount: MAX_UINT256.toString(),
+              signedTransaction: signedTx,
+              version: "1"
+            }
+          }
+        };
+        this.log("Permit2 approval signed for facilitator relay");
+      } else if (wallet.sendTransaction) {
+        this.log(`Approving Permit2 directly (current allowance: ${currentAllowance})`);
+        const approveTxHash = await wallet.sendTransaction({
+          to: asset,
+          data: approveData,
+          value: 0n
+        });
+        this.log(`Permit2 approval tx sent: ${approveTxHash}`);
+        await this.waitForReceipt(url, approveTxHash);
+        this.log("Permit2 approval confirmed");
+      } else {
         throw new Error(
-          "Permit2 payments require a wallet that supports sendTransaction for the one-time Permit2 approval. Use createEvmKeypairWallet() or a browser wallet with transaction support."
+          "Permit2 payments require a wallet that supports signTransaction or sendTransaction for the one-time Permit2 approval. Use createEvmKeypairWallet() or a browser wallet with transaction support."
         );
       }
-      this.log(`Approving Permit2 for ${asset} (current allowance: ${currentAllowance})`);
-      const approveTxHash = await wallet.sendTransaction({
-        to: asset,
-        data: this.encodeApprove(PERMIT2_ADDRESS, MAX_UINT256),
-        value: 0n
-      });
-      this.log(`Permit2 approval tx sent: ${approveTxHash}`);
-      await this.waitForReceipt(url, approveTxHash);
-      this.log("Permit2 approval confirmed");
     } else {
       this.log("Sufficient Permit2 allowance, skipping approval");
     }
@@ -724,7 +754,8 @@ var EvmAdapter = class {
     };
     return {
       serialized: JSON.stringify(payload),
-      signature
+      signature,
+      extensions: approvalExtension
     };
   }
   /**
@@ -793,6 +824,43 @@ var EvmAdapter = class {
     }
     throw new Error(`Approval transaction receipt timeout after ${timeoutMs}ms: ${txHash}`);
   }
+  /**
+   * Read gas price via eth_gasPrice RPC call.
+   */
+  async readGasPrice(rpcUrl) {
+    try {
+      const response = await fetch(rpcUrl, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ jsonrpc: "2.0", id: 1, method: "eth_gasPrice", params: [] })
+      });
+      const result = await response.json();
+      return result.result ? BigInt(result.result) : 50000000n;
+    } catch {
+      return 50000000n;
+    }
+  }
+  /**
+   * Read transaction count (nonce) via eth_getTransactionCount RPC call.
+   */
+  async readNonce(rpcUrl, address) {
+    try {
+      const response = await fetch(rpcUrl, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+          jsonrpc: "2.0",
+          id: 1,
+          method: "eth_getTransactionCount",
+          params: [address, "latest"]
+        })
+      });
+      const result = await response.json();
+      return result.result ? parseInt(result.result, 16) : 0;
+    } catch {
+      return 0;
+    }
+  }
   /**
    * Calculate how much to approve based on the facilitator's approval strategy.
    * Buffered approvals reduce the number of on-chain approval txs for micropayments.
@@ -1054,6 +1122,9 @@ function createX402Client(config) {
       accepted: accept,
       payload
     };
+    if (signedTx.extensions) {
+      paymentSignature.extensions = signedTx.extensions;
+    }
     const paymentSignatureHeader = btoa(JSON.stringify(paymentSignature));
     const passResponse = await customFetch(passUrl, {
       ...init,
@@ -1232,6 +1303,9 @@ function createX402Client(config) {
       accepted: accept,
       payload
     };
+    if (signedTx.extensions) {
+      paymentSignature.extensions = signedTx.extensions;
+    }
     const paymentSignatureHeader = btoa(JSON.stringify(paymentSignature));
     log("Retrying request with payment...");
     const retryResponse = await fetchWithRetry(input, {

package/dist/react/index.d.cts

@@ -1,6 +1,6 @@
-import { a as X402Client } from '../sponsored-access-DAVzu4x6.cjs';
-export { f as fireImpressionBeacon, b as getSponsoredRecommendations } from '../sponsored-access-DAVzu4x6.cjs';
-import { W as WalletSet, d as BalanceInfo } from '../types-D1u7iu8n.cjs';
+import { a as X402Client } from '../sponsored-access-CE7WpV5b.cjs';
+export { f as fireImpressionBeacon, b as getSponsoredRecommendations } from '../sponsored-access-CE7WpV5b.cjs';
+import { W as WalletSet, d as BalanceInfo } from '../types-C_aQh02s.cjs';
 import { SponsoredRecommendation } from '@dexterai/x402-ads-types';
 export { SponsoredRecommendation } from '@dexterai/x402-ads-types';
 import { a as AccessPassTier } from '../types-_iT11DL0.cjs';

package/dist/react/index.d.ts

@@ -1,6 +1,6 @@
-import { a as X402Client } from '../sponsored-access-Lxa11w_X.js';
-export { f as fireImpressionBeacon, b as getSponsoredRecommendations } from '../sponsored-access-Lxa11w_X.js';
-import { W as WalletSet, d as BalanceInfo } from '../types-YQlJI5E3.js';
+import { a as X402Client } from '../sponsored-access-BVoucsEW.js';
+export { f as fireImpressionBeacon, b as getSponsoredRecommendations } from '../sponsored-access-BVoucsEW.js';
+import { W as WalletSet, d as BalanceInfo } from '../types-DBS0XOsH.js';
 import { SponsoredRecommendation } from '@dexterai/x402-ads-types';
 export { SponsoredRecommendation } from '@dexterai/x402-ads-types';
 import { a as AccessPassTier } from '../types-_iT11DL0.js';

package/dist/react/index.js

@@ -628,21 +628,51 @@ var EvmAdapter = class {
     });
     const url = rpcUrl || this.getDefaultRpcUrl(accept.network);
     const currentAllowance = await this.readAllowance(url, asset, wallet.address, PERMIT2_ADDRESS);
+    let approvalExtension;
     if (currentAllowance < BigInt(amount)) {
-      if (!wallet.sendTransaction) {
+      const approveData = this.encodeApprove(PERMIT2_ADDRESS, MAX_UINT256);
+      if (wallet.signTransaction) {
+        this.log(`Signing Permit2 approval for relay (current allowance: ${currentAllowance})`);
+        const chainId2 = this.getChainId(accept.network);
+        const gasPrice = await this.readGasPrice(url);
+        const nonce2 = await this.readNonce(url, wallet.address);
+        const signedTx = await wallet.signTransaction({
+          to: asset,
+          data: approveData,
+          chainId: chainId2,
+          gas: 50000n,
+          // standard ERC-20 approve
+          gasPrice,
+          nonce: nonce2
+        });
+        approvalExtension = {
+          erc20ApprovalGasSponsoring: {
+            info: {
+              from: wallet.address,
+              asset,
+              spender: PERMIT2_ADDRESS,
+              amount: MAX_UINT256.toString(),
+              signedTransaction: signedTx,
+              version: "1"
+            }
+          }
+        };
+        this.log("Permit2 approval signed for facilitator relay");
+      } else if (wallet.sendTransaction) {
+        this.log(`Approving Permit2 directly (current allowance: ${currentAllowance})`);
+        const approveTxHash = await wallet.sendTransaction({
+          to: asset,
+          data: approveData,
+          value: 0n
+        });
+        this.log(`Permit2 approval tx sent: ${approveTxHash}`);
+        await this.waitForReceipt(url, approveTxHash);
+        this.log("Permit2 approval confirmed");
+      } else {
         throw new Error(
-          "Permit2 payments require a wallet that supports sendTransaction for the one-time Permit2 approval. Use createEvmKeypairWallet() or a browser wallet with transaction support."
+          "Permit2 payments require a wallet that supports signTransaction or sendTransaction for the one-time Permit2 approval. Use createEvmKeypairWallet() or a browser wallet with transaction support."
         );
       }
-      this.log(`Approving Permit2 for ${asset} (current allowance: ${currentAllowance})`);
-      const approveTxHash = await wallet.sendTransaction({
-        to: asset,
-        data: this.encodeApprove(PERMIT2_ADDRESS, MAX_UINT256),
-        value: 0n
-      });
-      this.log(`Permit2 approval tx sent: ${approveTxHash}`);
-      await this.waitForReceipt(url, approveTxHash);
-      this.log("Permit2 approval confirmed");
     } else {
       this.log("Sufficient Permit2 allowance, skipping approval");
     }
@@ -697,7 +727,8 @@ var EvmAdapter = class {
     };
     return {
       serialized: JSON.stringify(payload),
-      signature
+      signature,
+      extensions: approvalExtension
     };
   }
   /**
@@ -766,6 +797,43 @@ var EvmAdapter = class {
     }
     throw new Error(`Approval transaction receipt timeout after ${timeoutMs}ms: ${txHash}`);
   }
+  /**
+   * Read gas price via eth_gasPrice RPC call.
+   */
+  async readGasPrice(rpcUrl) {
+    try {
+      const response = await fetch(rpcUrl, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ jsonrpc: "2.0", id: 1, method: "eth_gasPrice", params: [] })
+      });
+      const result = await response.json();
+      return result.result ? BigInt(result.result) : 50000000n;
+    } catch {
+      return 50000000n;
+    }
+  }
+  /**
+   * Read transaction count (nonce) via eth_getTransactionCount RPC call.
+   */
+  async readNonce(rpcUrl, address) {
+    try {
+      const response = await fetch(rpcUrl, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+          jsonrpc: "2.0",
+          id: 1,
+          method: "eth_getTransactionCount",
+          params: [address, "latest"]
+        })
+      });
+      const result = await response.json();
+      return result.result ? parseInt(result.result, 16) : 0;
+    } catch {
+      return 0;
+    }
+  }
   /**
    * Calculate how much to approve based on the facilitator's approval strategy.
    * Buffered approvals reduce the number of on-chain approval txs for micropayments.
@@ -1027,6 +1095,9 @@ function createX402Client(config) {
       accepted: accept,
       payload
     };
+    if (signedTx.extensions) {
+      paymentSignature.extensions = signedTx.extensions;
+    }
     const paymentSignatureHeader = btoa(JSON.stringify(paymentSignature));
     const passResponse = await customFetch(passUrl, {
       ...init,
@@ -1205,6 +1276,9 @@ function createX402Client(config) {
       accepted: accept,
       payload
     };
+    if (signedTx.extensions) {
+      paymentSignature.extensions = signedTx.extensions;
+    }
     const paymentSignatureHeader = btoa(JSON.stringify(paymentSignature));
     log("Retrying request with payment...");
     const retryResponse = await fetchWithRetry(input, {

package/dist/{sponsored-access-Lxa11w_X.d.ts → sponsored-access-BVoucsEW.d.ts}

@@ -1,4 +1,4 @@
-import { C as ChainAdapter, W as WalletSet } from './types-YQlJI5E3.js';
+import { C as ChainAdapter, W as WalletSet } from './types-DBS0XOsH.js';
 import { A as AccessPassClientConfig, P as PaymentAccept } from './types-_iT11DL0.js';
 import { SponsoredRecommendation, SponsoredAccessSettlementInfo } from '@dexterai/x402-ads-types';
 

package/dist/{sponsored-access-DAVzu4x6.d.cts → sponsored-access-CE7WpV5b.d.cts}

@@ -1,4 +1,4 @@
-import { C as ChainAdapter, W as WalletSet } from './types-D1u7iu8n.cjs';
+import { C as ChainAdapter, W as WalletSet } from './types-C_aQh02s.cjs';
 import { A as AccessPassClientConfig, P as PaymentAccept } from './types-_iT11DL0.cjs';
 import { SponsoredRecommendation, SponsoredAccessSettlementInfo } from '@dexterai/x402-ads-types';
 

package/dist/{types-D1u7iu8n.d.cts → types-C_aQh02s.d.cts}

@@ -72,6 +72,20 @@ interface EvmWallet {
         data: string;
         value?: bigint;
     }): Promise<string>;
+    /**
+     * Sign a transaction without broadcasting.
+     * Returns the RLP-encoded signed transaction as a hex string.
+     * Used by the erc20ApprovalGasSponsoring extension to hand a signed
+     * approval tx to the facilitator for relay.
+     */
+    signTransaction?(params: {
+        to: string;
+        data: string;
+        chainId: number;
+        gas?: bigint;
+        gasPrice?: bigint;
+        nonce?: number;
+    }): Promise<string>;
 }
 /**
  * Check if an object is a valid EVM wallet
@@ -122,6 +136,14 @@ declare class EvmAdapter implements ChainAdapter {
      * Wait for a transaction receipt by polling eth_getTransactionReceipt.
      */
     private waitForReceipt;
+    /**
+     * Read gas price via eth_gasPrice RPC call.
+     */
+    private readGasPrice;
+    /**
+     * Read transaction count (nonce) via eth_getTransactionCount RPC call.
+     */
+    private readNonce;
     /**
      * Calculate how much to approve based on the facilitator's approval strategy.
      * Buffered approvals reduce the number of on-chain approval txs for micropayments.
@@ -210,6 +232,8 @@ interface SignedTransaction {
     serialized: string;
     /** Transaction signature/hash if available before broadcast */
     signature?: string;
+    /** Protocol extensions (e.g., erc20ApprovalGasSponsoring) to attach to the payment payload */
+    extensions?: Record<string, unknown>;
 }
 /**
  * Chain adapter interface - each chain implements this