@dexterai/x402 2.0.0 → 2.1.0

package/dist/{types-D1TGACsL.d.ts → types-YQlJI5E3.d.ts}

@@ -1,4 +1,4 @@
-import { P as PaymentAccept } from './types-CjLMR7qs.js';
+import { P as PaymentAccept } from './types-_iT11DL0.js';
 
 /**
  * EVM Chain Adapter
@@ -7,6 +7,11 @@ import { P as PaymentAccept } from './types-CjLMR7qs.js';
  * Uses EIP-712 typed data signing for x402 v2 payments.
  */
 
+/**
+ * Permit2 constants (Uniswap canonical deployment, same address on every EVM chain)
+ */
+declare const PERMIT2_ADDRESS = "0x000000000022D473030F116dDEE9F6B43aC78BA3";
+declare const X402_EXACT_PERMIT2_PROXY = "0x402085c248EeA27D92E8b30b2C58ed07f9E20001";
 /**
  * CAIP-2 network identifiers for EVM chains.
  * Mirrors dexter-facilitator/src/config/chains.ts — update both when adding chains.
@@ -17,15 +22,29 @@ declare const ARBITRUM_ONE = "eip155:42161";
 declare const POLYGON = "eip155:137";
 declare const OPTIMISM = "eip155:10";
 declare const AVALANCHE = "eip155:43114";
+declare const BSC_MAINNET = "eip155:56";
 declare const SKALE_BASE = "eip155:1187947933";
 declare const SKALE_BASE_SEPOLIA = "eip155:324705682";
 /** @deprecated Not supported by the Dexter facilitator. Use BASE_MAINNET for EVM payments. */
 declare const ETHEREUM_MAINNET = "eip155:1";
+/**
+ * BSC stablecoin addresses (18 decimals — unlike 6 on every other chain)
+ */
+declare const BSC_USDT = "0x55d398326f99059fF775485246999027B3197955";
+declare const BSC_USDC = "0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d";
 /**
  * USDC contract addresses by chain.
  * Source of truth: dexter-facilitator/src/config/chains.ts
  */
 declare const USDC_ADDRESSES: Record<string, string>;
+/**
+ * Known BSC stablecoin addresses (for isKnownStablecoin checks).
+ * Both use 18 decimals on BSC, unlike the 6 decimals on all other chains.
+ */
+declare const BSC_STABLECOIN_ADDRESSES: Record<string, {
+    symbol: string;
+    decimals: number;
+}>;
 /**
  * EVM wallet interface (compatible with wagmi, ethers, viem)
  */
@@ -74,7 +93,47 @@ declare class EvmAdapter implements ChainAdapter {
     private getChainId;
     getBalance(accept: PaymentAccept, wallet: unknown, rpcUrl?: string): Promise<number>;
     private encodeBalanceOf;
-    buildTransaction(accept: PaymentAccept, wallet: unknown, _rpcUrl?: string): Promise<SignedTransaction>;
+    buildTransaction(accept: PaymentAccept, wallet: unknown, rpcUrl?: string): Promise<SignedTransaction>;
+    /**
+     * Build a payment transaction for chains that use the approval-based scheme.
+     * The facilitator's /supported response provides the EIP-712 domain and types
+     * in accept.extra, so the client doesn't hardcode any contract addresses.
+     */
+    private buildApprovalTransaction;
+    /**
+     * Build a Permit2 payment transaction. Used when the facilitator signals
+     * assetTransferMethod: "permit2" in extra (e.g., BSC where EIP-3009 is unavailable).
+     *
+     * Flow:
+     * 1. Check if token has approved the Permit2 contract. If not, approve(Permit2, maxUint256).
+     * 2. Sign EIP-712 PermitWitnessTransferFrom against the Permit2 contract.
+     * 3. Return { permit2Authorization, signature } payload for the facilitator.
+     */
+    private buildPermit2Transaction;
+    /**
+     * Read ERC-20 allowance via raw eth_call (no viem dependency needed).
+     */
+    private readAllowance;
+    /**
+     * Encode ERC-20 approve(address,uint256) calldata.
+     */
+    private encodeApprove;
+    /**
+     * Wait for a transaction receipt by polling eth_getTransactionReceipt.
+     */
+    private waitForReceipt;
+    /**
+     * Calculate how much to approve based on the facilitator's approval strategy.
+     * Buffered approvals reduce the number of on-chain approval txs for micropayments.
+     */
+    private calculateApprovalAmount;
+    /**
+     * Infer token decimals from payment amount magnitude.
+     * BSC stablecoins use 18 decimals, all others use 6.
+     * A $1 payment is 1000000 (6 dec) or 1000000000000000000 (18 dec).
+     * If the amount has > 12 digits, it's almost certainly 18 decimals.
+     */
+    private inferDecimals;
 }
 /**
  * Create an EVM adapter instance
@@ -242,4 +301,4 @@ interface BalanceInfo {
     asset: string;
 }
 
-export { type AdapterConfig as A, BASE_MAINNET as B, type ChainAdapter as C, type EvmWallet as E, type GenericWallet as G, OPTIMISM as O, POLYGON as P, type SolanaWallet as S, USDC_ADDRESSES as U, type WalletSet as W, createEvmAdapter as a, SOLANA_MAINNET as b, createSolanaAdapter as c, type BalanceInfo as d, SolanaAdapter as e, EvmAdapter as f, type SignedTransaction as g, SOLANA_DEVNET as h, isSolanaWallet as i, SOLANA_TESTNET as j, isEvmWallet as k, BASE_SEPOLIA as l, ARBITRUM_ONE as m, AVALANCHE as n, SKALE_BASE as o, SKALE_BASE_SEPOLIA as p, ETHEREUM_MAINNET as q };
+export { type AdapterConfig as A, BASE_MAINNET as B, type ChainAdapter as C, type EvmWallet as E, type GenericWallet as G, OPTIMISM as O, PERMIT2_ADDRESS as P, type SolanaWallet as S, USDC_ADDRESSES as U, type WalletSet as W, X402_EXACT_PERMIT2_PROXY as X, createEvmAdapter as a, SOLANA_MAINNET as b, createSolanaAdapter as c, type BalanceInfo as d, SolanaAdapter as e, EvmAdapter as f, type SignedTransaction as g, SOLANA_DEVNET as h, isSolanaWallet as i, SOLANA_TESTNET as j, isEvmWallet as k, BSC_MAINNET as l, BSC_USDT as m, BSC_USDC as n, BSC_STABLECOIN_ADDRESSES as o, BASE_SEPOLIA as p, ARBITRUM_ONE as q, POLYGON as r, AVALANCHE as s, SKALE_BASE as t, SKALE_BASE_SEPOLIA as u, ETHEREUM_MAINNET as v };

package/dist/{types-CjLMR7qs.d.cts → types-_iT11DL0.d.cts}

@@ -85,8 +85,8 @@ interface AcceptsExtra {
 interface PaymentAccept {
     /** x402 version (1 or 2, defaults to 2 if not specified) */
     x402Version?: 1 | 2;
-    /** Payment scheme (always 'exact' for x402 v2) */
-    scheme: 'exact';
+    /** Payment scheme ('exact' for EIP-3009 chains, 'exact-approval' for approval-based chains like BSC) */
+    scheme: 'exact' | 'exact-approval';
     /** CAIP-2 network identifier (v1: 'solana', v2: 'solana:5eykt...') */
     network: string;
     /** Payment amount in atomic units (x402 v2 spec field) */

package/dist/{types-CjLMR7qs.d.ts → types-_iT11DL0.d.ts}

@@ -85,8 +85,8 @@ interface AcceptsExtra {
 interface PaymentAccept {
     /** x402 version (1 or 2, defaults to 2 if not specified) */
     x402Version?: 1 | 2;
-    /** Payment scheme (always 'exact' for x402 v2) */
-    scheme: 'exact';
+    /** Payment scheme ('exact' for EIP-3009 chains, 'exact-approval' for approval-based chains like BSC) */
+    scheme: 'exact' | 'exact-approval';
     /** CAIP-2 network identifier (v1: 'solana', v2: 'solana:5eykt...') */
     network: string;
     /** Payment amount in atomic units (x402 v2 spec field) */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dexterai/x402",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "description": "Full-stack x402 SDK - add paid API monetization to any endpoint. Express middleware, React hooks, Access Pass, dynamic pricing. Solana, Base, Polygon, Arbitrum, Optimism, Avalanche, SKALE.",
   "author": "Dexter",
   "license": "MIT",