uvd-x402-sdk 2.0.3 → 2.2.0

package/src/providers/evm/index.ts

@@ -27,9 +27,11 @@ import type {
   PaymentInfo,
   EVMPaymentPayload,
   WalletAdapter,
+  TokenType,
+  TokenConfig,
 } from '../../types';
 import { X402Error } from '../../types';
-import { getChainByName, getChainById } from '../../chains';
+import { getChainByName, getChainById, getTokenConfig } from '../../chains';
 
 /**
  * Ethereum provider interface
@@ -197,22 +199,48 @@ export class EVMProvider implements WalletAdapter {
   }
 
   /**
-   * Get USDC balance
+   * Get token balance (defaults to USDC for backward compatibility)
+   *
+   * @param chainConfig - Chain configuration
+   * @param tokenType - Token type to check balance for (defaults to 'usdc')
+   * @returns Formatted balance string
    */
-  async getBalance(chainConfig: ChainConfig): Promise<string> {
+  async getBalance(chainConfig: ChainConfig, tokenType: TokenType = 'usdc'): Promise<string> {
     if (!this.address) {
       throw new X402Error('Wallet not connected', 'WALLET_NOT_CONNECTED');
     }
 
+    // Get token config for the specified token type
+    const tokenConfig = getTokenConfig(chainConfig.name, tokenType);
+    if (!tokenConfig) {
+      // Fall back to USDC config for backward compatibility
+      const fallbackConfig = chainConfig.usdc;
+      if (!fallbackConfig) {
+        throw new X402Error(`Token ${tokenType} not supported on ${chainConfig.name}`, 'INVALID_CONFIG');
+      }
+      return this.getBalanceWithConfig(chainConfig.rpcUrl, fallbackConfig);
+    }
+
+    return this.getBalanceWithConfig(chainConfig.rpcUrl, tokenConfig);
+  }
+
+  /**
+   * Internal helper to get balance using a token config
+   */
+  private async getBalanceWithConfig(rpcUrl: string, tokenConfig: TokenConfig): Promise<string> {
+    if (!this.address) {
+      return '0.00';
+    }
+
     // Use public RPC for balance check
-    const publicProvider = new ethers.JsonRpcProvider(chainConfig.rpcUrl);
+    const publicProvider = new ethers.JsonRpcProvider(rpcUrl);
 
-    const usdcAbi = ['function balanceOf(address owner) view returns (uint256)'];
-    const usdcContract = new ethers.Contract(chainConfig.usdc.address, usdcAbi, publicProvider);
+    const tokenAbi = ['function balanceOf(address owner) view returns (uint256)'];
+    const tokenContract = new ethers.Contract(tokenConfig.address, tokenAbi, publicProvider);
 
     try {
-      const balance = await usdcContract.balanceOf(this.address);
-      const formatted = ethers.formatUnits(balance, chainConfig.usdc.decimals);
+      const balance = await tokenContract.balanceOf(this.address);
+      const formatted = ethers.formatUnits(balance, tokenConfig.decimals);
       return parseFloat(formatted).toFixed(2);
     } catch {
       return '0.00';
@@ -221,12 +249,32 @@ export class EVMProvider implements WalletAdapter {
 
   /**
    * Create EVM payment (EIP-712 TransferWithAuthorization)
+   *
+   * Supports multi-token payments. If paymentInfo.tokenType is specified,
+   * it will use the appropriate token configuration. Defaults to USDC
+   * for backward compatibility.
+   *
+   * @param paymentInfo - Payment details including amount and recipient
+   * @param chainConfig - Chain configuration
+   * @returns JSON-encoded payment payload
    */
   async signPayment(paymentInfo: PaymentInfo, chainConfig: ChainConfig): Promise<string> {
     if (!this.signer || !this.address) {
       throw new X402Error('Wallet not connected', 'WALLET_NOT_CONNECTED');
     }
 
+    // Determine token type (default to 'usdc' for backward compatibility)
+    const tokenType: TokenType = paymentInfo.tokenType || 'usdc';
+
+    // Get token configuration for the specified token type
+    const tokenConfig = getTokenConfig(chainConfig.name, tokenType);
+    if (!tokenConfig) {
+      throw new X402Error(
+        `Token ${tokenType} not supported on ${chainConfig.name}`,
+        'CHAIN_NOT_SUPPORTED'
+      );
+    }
+
     // Get recipient
     const recipient = paymentInfo.recipients?.evm || paymentInfo.recipient;
 
@@ -246,12 +294,12 @@ export class EVMProvider implements WalletAdapter {
     const validityWindowSeconds = chainConfig.name === 'base' ? 300 : 60;
     const validBefore = Math.floor(Date.now() / 1000) + validityWindowSeconds;
 
-    // EIP-712 domain
+    // EIP-712 domain using the selected token's configuration
     const domain = {
-      name: chainConfig.usdc.name,
-      version: chainConfig.usdc.version,
+      name: tokenConfig.name,
+      version: tokenConfig.version,
       chainId: chainConfig.chainId,
-      verifyingContract: chainConfig.usdc.address,
+      verifyingContract: tokenConfig.address,
     };
 
     // EIP-712 types for TransferWithAuthorization (ERC-3009)
@@ -266,8 +314,8 @@ export class EVMProvider implements WalletAdapter {
       ],
     };
 
-    // Parse amount
-    const value = ethers.parseUnits(paymentInfo.amount, chainConfig.usdc.decimals);
+    // Parse amount using the token's decimals
+    const value = ethers.parseUnits(paymentInfo.amount, tokenConfig.decimals);
     const from = this.address;
     const to = ethers.getAddress(recipient);
 
@@ -298,7 +346,7 @@ export class EVMProvider implements WalletAdapter {
 
     const sig = ethers.Signature.from(signature);
 
-    // Construct payload
+    // Construct payload with the selected token address
     const payload: EVMPaymentPayload = {
       from,
       to,
@@ -310,7 +358,7 @@ export class EVMProvider implements WalletAdapter {
       r: sig.r,
       s: sig.s,
       chainId: chainConfig.chainId,
-      token: chainConfig.usdc.address,
+      token: tokenConfig.address,
     };
 
     return JSON.stringify(payload);

package/src/types/index.ts

@@ -20,8 +20,34 @@
  */
 export type NetworkType = 'evm' | 'svm' | 'solana' | 'stellar' | 'near';
 
+/**
+ * Supported stablecoin token types
+ * - usdc: USD Coin (Circle) - 6 decimals
+ * - eurc: Euro Coin (Circle) - 6 decimals
+ * - ausd: Agora USD (Agora Finance) - 6 decimals
+ * - pyusd: PayPal USD (PayPal/Paxos) - 6 decimals
+ * - gho: GHO Stablecoin (Aave) - 18 decimals
+ * - crvusd: Curve USD (Curve Finance) - 18 decimals
+ */
+export type TokenType = 'usdc' | 'eurc' | 'ausd' | 'pyusd' | 'gho' | 'crvusd';
+
+/**
+ * Token configuration for EIP-712 signing and transfers
+ */
+export interface TokenConfig {
+  /** Contract/mint address */
+  address: string;
+  /** Token decimals (6 for most stablecoins, 18 for GHO/crvUSD) */
+  decimals: number;
+  /** Token name for EIP-712 domain (e.g., "USD Coin" or "USDC") */
+  name: string;
+  /** Token version for EIP-712 domain */
+  version: string;
+}
+
 /**
  * USDC token configuration for a specific chain
+ * @deprecated Use TokenConfig instead. This is kept for backward compatibility.
  */
 export interface USDCConfig {
   /** Contract/mint address */
@@ -65,6 +91,12 @@ export interface ChainConfig {
   nativeCurrency: NativeCurrency;
   /** USDC token configuration */
   usdc: USDCConfig;
+  /**
+   * Multi-token configurations (EVM chains only)
+   * Maps token type to its configuration for this chain.
+   * Not all tokens are available on all chains.
+   */
+  tokens?: Partial<Record<TokenType, TokenConfig>>;
   /** x402 facilitator configuration */
   x402: {
     facilitatorUrl: string;
@@ -117,11 +149,17 @@ export interface WalletAdapter {
   /** Switch to a different chain (EVM only) */
   switchChain?(chainName: string): Promise<void>;
 
-  /** Sign a payment payload */
+  /**
+   * Sign a payment payload
+   * For EVM chains, supports multi-token via paymentInfo.tokenType
+   */
   signPayment(paymentInfo: PaymentInfo, chainConfig: ChainConfig): Promise<string>;
 
-  /** Check USDC balance */
-  getBalance(chainConfig: ChainConfig): Promise<string>;
+  /**
+   * Check token balance (defaults to USDC for backward compatibility)
+   * EVM providers may accept optional tokenType parameter
+   */
+  getBalance(chainConfig: ChainConfig, tokenType?: TokenType): Promise<string>;
 
   /** Get current address */
   getAddress(): string | null;
@@ -170,6 +208,11 @@ export interface PaymentInfo {
   amount: string;
   /** Token symbol (usually "USDC") */
   token?: string;
+  /**
+   * Token type for multi-token support
+   * Defaults to 'usdc' if not specified for backward compatibility
+   */
+  tokenType?: TokenType;
   /** Network hint from backend */
   network?: string;
   /** Supported chain IDs */