uvd-x402-sdk 2.1.0 → 2.2.0

package/README.md

@@ -2,17 +2,19 @@
 
 > Gasless crypto payments across 14 blockchain networks using the x402 protocol.
 
-The x402 SDK enables any application to accept USDC payments without requiring users to pay gas fees. Users sign a message or transaction, and the Ultravioleta facilitator handles on-chain settlement.
+The x402 SDK enables any application to accept stablecoin payments (USDC, EURC, AUSD, PYUSD, GHO, crvUSD) without requiring users to pay gas fees. Users sign a message or transaction, and the Ultravioleta facilitator handles on-chain settlement.
 
 ## Features
 
 - **14 Supported Networks**: EVM chains, Solana, Fogo, Stellar, and NEAR
+- **Multi-Stablecoin**: USDC, EURC, AUSD, PYUSD, GHO, crvUSD support on EVM chains
 - **x402 v1 & v2**: Full support for both protocol versions with automatic detection
 - **Gasless Payments**: Users never pay gas - the facilitator covers all network fees
 - **Multi-Network**: Accept payments on multiple networks simultaneously
 - **Type-Safe**: Comprehensive TypeScript definitions
 - **Framework Agnostic**: Works with any JavaScript framework
 - **React Hooks**: First-class React integration
+- **Wagmi/RainbowKit**: Dedicated adapter for wagmi-based apps
 - **Modular**: Import only what you need
 
 ## Quick Start
@@ -126,6 +128,117 @@ const result = await client.createPayment({
 
 ---
 
+## Wagmi / RainbowKit Integration
+
+If you're using wagmi with RainbowKit, ConnectKit, or other wagmi-based wallet libraries, use the dedicated wagmi adapter:
+
+```typescript
+import { useWalletClient } from 'wagmi';
+import { createPaymentFromWalletClient } from 'uvd-x402-sdk/wagmi';
+
+function PayButton() {
+  const { data: walletClient } = useWalletClient();
+
+  const handlePay = async () => {
+    const paymentHeader = await createPaymentFromWalletClient(walletClient, {
+      recipient: '0xD3868E1eD738CED6945A574a7c769433BeD5d474',
+      amount: '10.00',
+      chainName: 'base', // optional, defaults to 'base'
+    });
+
+    // Use in your API request
+    await fetch('/api/purchase', {
+      headers: { 'X-PAYMENT': paymentHeader },
+      method: 'POST',
+    });
+  };
+
+  return <button onClick={handlePay}>Pay $10 USDC</button>;
+}
+```
+
+### With the Helper Hook
+
+```typescript
+import { useWalletClient } from 'wagmi';
+import { useX402Wagmi } from 'uvd-x402-sdk/wagmi';
+
+function PayButton() {
+  const { data: walletClient } = useWalletClient();
+  const { createPayment, isReady } = useX402Wagmi(walletClient);
+
+  const handlePay = async () => {
+    const paymentHeader = await createPayment({
+      recipient: '0xD3868E1eD738CED6945A574a7c769433BeD5d474',
+      amount: '10.00',
+    });
+
+    await fetch('/api/purchase', {
+      headers: { 'X-PAYMENT': paymentHeader },
+    });
+  };
+
+  return (
+    <button onClick={handlePay} disabled={!isReady}>
+      Pay $10 USDC
+    </button>
+  );
+}
+```
+
+### Full Example with RainbowKit
+
+```tsx
+import { ConnectButton } from '@rainbow-me/rainbowkit';
+import { useWalletClient, useAccount } from 'wagmi';
+import { createPaymentFromWalletClient } from 'uvd-x402-sdk/wagmi';
+
+function App() {
+  const { data: walletClient } = useWalletClient();
+  const { isConnected } = useAccount();
+
+  const handlePurchase = async () => {
+    if (!walletClient) return;
+
+    try {
+      const paymentHeader = await createPaymentFromWalletClient(walletClient, {
+        recipient: '0xD3868E1eD738CED6945A574a7c769433BeD5d474',
+        amount: '5.00',
+        chainName: 'base',
+      });
+
+      const response = await fetch('/api/purchase', {
+        method: 'POST',
+        headers: {
+          'Content-Type': 'application/json',
+          'X-PAYMENT': paymentHeader,
+        },
+        body: JSON.stringify({ item: 'premium-feature' }),
+      });
+
+      if (response.ok) {
+        alert('Purchase successful!');
+      }
+    } catch (error) {
+      console.error('Payment failed:', error);
+    }
+  };
+
+  return (
+    <div>
+      <ConnectButton />
+      {isConnected && (
+        <button onClick={handlePurchase}>
+          Buy Premium ($5 USDC)
+        </button>
+      )}
+    </div>
+  );
+}
+```
+
+---
+
 ## Network Examples
 
 ### EVM Chains (10 Networks)
@@ -557,6 +670,118 @@ const options = generatePaymentOptions(chains, '10.00');
 
 ---
 
+## Multi-Stablecoin Support (EVM)
+
+EVM chains support multiple stablecoins beyond USDC. Token availability varies by chain.
+
+### Supported Tokens
+
+| Token | Description | Decimals | Chains |
+|-------|-------------|----------|--------|
+| USDC | USD Coin (Circle) | 6 | All EVM chains |
+| EURC | Euro Coin (Circle) | 6 | Ethereum, Base, Avalanche |
+| AUSD | Agora USD | 6 | Ethereum, Avalanche, Polygon, Arbitrum, Monad |
+| PYUSD | PayPal USD | 6 | Ethereum |
+| GHO | Aave GHO | 18 | Ethereum, Base, Arbitrum |
+| crvUSD | Curve USD | 18 | Ethereum, Arbitrum |
+
+### Basic Usage
+
+```typescript
+import { X402Client } from 'uvd-x402-sdk';
+
+const client = new X402Client({ defaultChain: 'base' });
+await client.connect('base');
+
+// Pay with EURC instead of USDC
+const result = await client.createPayment({
+  recipient: '0xD3868E1eD738CED6945A574a7c769433BeD5d474',
+  amount: '10.00',
+  tokenType: 'eurc', // 'usdc' | 'eurc' | 'ausd' | 'pyusd' | 'gho' | 'crvusd'
+});
+```
+
+### Check Token Availability
+
+```typescript
+import {
+  getSupportedTokens,
+  isTokenSupported,
+  getTokenConfig,
+  getChainsByToken,
+} from 'uvd-x402-sdk';
+
+// Get all tokens supported on a chain
+const tokens = getSupportedTokens('ethereum');
+// Returns: ['usdc', 'eurc', 'ausd', 'pyusd', 'gho', 'crvusd']
+
+const baseTokens = getSupportedTokens('base');
+// Returns: ['usdc', 'eurc', 'gho']
+
+// Check if a specific token is supported
+if (isTokenSupported('base', 'eurc')) {
+  console.log('EURC available on Base');
+}
+
+// Get token configuration (address, decimals, name)
+const eurcConfig = getTokenConfig('ethereum', 'eurc');
+// Returns: { address: '0x1aBa...', decimals: 6, name: 'EURC', version: '2' }
+
+// Find all chains that support a token
+const ghoChains = getChainsByToken('gho');
+// Returns: [baseConfig, ethereumConfig, arbitrumConfig]
+```
+
+### Check Token Balance
+
+```typescript
+import { EVMProvider } from 'uvd-x402-sdk';
+import { getChainByName } from 'uvd-x402-sdk';
+
+const evm = new EVMProvider();
+await evm.connect();
+
+const chainConfig = getChainByName('ethereum')!;
+
+// Check USDC balance (default)
+const usdcBalance = await evm.getBalance(chainConfig);
+
+// Check EURC balance
+const eurcBalance = await evm.getBalance(chainConfig, 'eurc');
+
+// Check GHO balance
+const ghoBalance = await evm.getBalance(chainConfig, 'gho');
+```
+
+### Wagmi/RainbowKit with Multi-Token
+
+```typescript
+import { useWalletClient } from 'wagmi';
+import { createPaymentFromWalletClient } from 'uvd-x402-sdk/wagmi';
+
+function PayWithEURC() {
+  const { data: walletClient } = useWalletClient();
+
+  const handlePay = async () => {
+    const paymentHeader = await createPaymentFromWalletClient(walletClient, {
+      recipient: '0xD3868E1eD738CED6945A574a7c769433BeD5d474',
+      amount: '10.00',
+      chainName: 'base',
+      tokenType: 'eurc', // Pay with EURC
+    });
+
+    await fetch('/api/purchase', {
+      headers: { 'X-PAYMENT': paymentHeader },
+      method: 'POST',
+    });
+  };
+
+  return <button onClick={handlePay}>Pay 10 EURC</button>;
+}
+```
+
+---
+
 ## React Integration
 
 ```tsx
@@ -612,18 +837,18 @@ function PaymentPage() {
 
 ### EVM Networks (10)
 
-| Network | Chain ID | USDC Decimals | Status |
-|---------|----------|---------------|--------|
-| Base | 8453 | 6 | Enabled |
-| Ethereum | 1 | 6 | Enabled |
-| Polygon | 137 | 6 | Enabled |
-| Arbitrum | 42161 | 6 | Enabled |
-| Optimism | 10 | 6 | Enabled |
-| Avalanche | 43114 | 6 | Enabled |
-| Celo | 42220 | 6 | Enabled |
-| HyperEVM | 999 | 6 | Enabled |
-| Unichain | 130 | 6 | Enabled |
-| Monad | 143 | 6 | Enabled |
+| Network | Chain ID | Tokens | Status |
+|---------|----------|--------|--------|
+| Ethereum | 1 | USDC, EURC, AUSD, PYUSD, GHO, crvUSD | Enabled |
+| Base | 8453 | USDC, EURC, GHO | Enabled |
+| Avalanche | 43114 | USDC, EURC, AUSD | Enabled |
+| Arbitrum | 42161 | USDC, AUSD, GHO, crvUSD | Enabled |
+| Polygon | 137 | USDC, AUSD | Enabled |
+| Monad | 143 | USDC, AUSD | Enabled |
+| Optimism | 10 | USDC | Enabled |
+| Celo | 42220 | USDC | Enabled |
+| HyperEVM | 999 | USDC | Enabled |
+| Unichain | 130 | USDC | Enabled |
 
 ### SVM Networks (2)
 
@@ -667,8 +892,8 @@ interface X402ClientConfig {
 | `connect(chainName?)` | Connect wallet to specified chain |
 | `disconnect()` | Disconnect current wallet |
 | `switchChain(chainName)` | Switch to different EVM chain |
-| `createPayment(paymentInfo)` | Create payment authorization |
-| `getBalance()` | Get USDC balance on current chain |
+| `createPayment(paymentInfo)` | Create payment authorization (supports `tokenType` in paymentInfo) |
+| `getBalance(tokenType?)` | Get token balance on current chain (defaults to USDC) |
 | `getState()` | Get current wallet state |
 | `isConnected()` | Check if wallet is connected |
 | `on(event, handler)` | Subscribe to events |
@@ -686,9 +911,23 @@ import {
   isSVMChain,
   getExplorerTxUrl,
   getExplorerAddressUrl,
+  // Multi-token utilities
+  getTokenConfig,
+  getSupportedTokens,
+  isTokenSupported,
+  getChainsByToken,
 } from 'uvd-x402-sdk';
 ```
 
+### Token Utilities
+
+| Function | Description |
+|----------|-------------|
+| `getTokenConfig(chain, tokenType)` | Get token config (address, decimals, name, version) |
+| `getSupportedTokens(chain)` | Get array of supported token types for a chain |
+| `isTokenSupported(chain, tokenType)` | Check if token is available on chain |
+| `getChainsByToken(tokenType)` | Get all chains that support a specific token |
+
 ### x402 Utilities
 
 ```typescript
@@ -705,6 +944,34 @@ import {
 } from 'uvd-x402-sdk';
 ```
 
+### Wagmi Adapter
+
+```typescript
+import {
+  createPaymentFromWalletClient,
+  createPaymentWithResult,
+  useX402Wagmi,
+} from 'uvd-x402-sdk/wagmi';
+```
+
+| Function | Description |
+|----------|-------------|
+| `createPaymentFromWalletClient(walletClient, options)` | Create payment header using wagmi's WalletClient |
+| `createPaymentWithResult(walletClient, options)` | Same as above but returns full PaymentResult |
+| `useX402Wagmi(walletClient)` | Helper hook returning `{ createPayment, isReady }` |
+
+#### Options
+
+```typescript
+interface WagmiPaymentOptions {
+  recipient: string;        // Recipient address
+  amount: string;           // Amount in token (e.g., "10.00")
+  chainName?: string;       // Chain name (default: 'base')
+  tokenType?: TokenType;    // Token type (default: 'usdc')
+  validitySeconds?: number; // Signature validity window (default: 300)
+}
+```
+
 ---
 
 ## Error Handling

package/dist/adapters/index.d.mts

@@ -1,4 +1,4 @@
-import { e as PaymentResult } from '../index-MTBgC_SL.mjs';
+import { f as PaymentResult } from '../index-BHwtdJrt.mjs';
 
 /**
  * uvd-x402-sdk - Wagmi/Viem Adapter

package/dist/adapters/index.d.ts

@@ -1,4 +1,4 @@
-import { e as PaymentResult } from '../index-MTBgC_SL.js';
+import { f as PaymentResult } from '../index-BHwtdJrt.js';
 
 /**
  * uvd-x402-sdk - Wagmi/Viem Adapter

package/dist/adapters/index.js

@@ -25,6 +25,26 @@ var SUPPORTED_CHAINS = {
       name: "USD Coin",
       version: "2"
     },
+    tokens: {
+      usdc: {
+        address: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
+        decimals: 6,
+        name: "USD Coin",
+        version: "2"
+      },
+      eurc: {
+        address: "0x60a3E35Cc302bFA44Cb288Bc5a4F316Fdb1adb42",
+        decimals: 6,
+        name: "EURC",
+        version: "2"
+      },
+      gho: {
+        address: "0x6Bb7a212910682DCFdbd5BCBb3e28FB4E8da10Ee",
+        decimals: 18,
+        name: "Gho Token",
+        version: "1"
+      }
+    },
     x402: {
       facilitatorUrl: DEFAULT_FACILITATOR_URL,
       enabled: true
@@ -49,6 +69,26 @@ var SUPPORTED_CHAINS = {
       name: "USD Coin",
       version: "2"
     },
+    tokens: {
+      usdc: {
+        address: "0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E",
+        decimals: 6,
+        name: "USD Coin",
+        version: "2"
+      },
+      eurc: {
+        address: "0xC891EB4cbdEFf6e073e859e987815Ed1505c2ACD",
+        decimals: 6,
+        name: "EURC",
+        version: "2"
+      },
+      ausd: {
+        address: "0x00000000eFE302BEAA2b3e6e1b18d08D69a9012a",
+        decimals: 6,
+        name: "Agora USD",
+        version: "1"
+      }
+    },
     x402: {
       facilitatorUrl: DEFAULT_FACILITATOR_URL,
       enabled: true
@@ -73,6 +113,44 @@ var SUPPORTED_CHAINS = {
       name: "USD Coin",
       version: "2"
     },
+    tokens: {
+      usdc: {
+        address: "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
+        decimals: 6,
+        name: "USD Coin",
+        version: "2"
+      },
+      eurc: {
+        address: "0x1aBaEA1f7C830bD89Acc67eC4af516284b1bC33c",
+        decimals: 6,
+        name: "EURC",
+        version: "2"
+      },
+      ausd: {
+        address: "0x00000000eFE302BEAA2b3e6e1b18d08D69a9012a",
+        decimals: 6,
+        name: "Agora USD",
+        version: "1"
+      },
+      pyusd: {
+        address: "0x6c3ea9036406852006290770BEdFcAbA0e23A0e8",
+        decimals: 6,
+        name: "PayPal USD",
+        version: "1"
+      },
+      gho: {
+        address: "0x40D16FC0246aD3160Ccc09B8D0D3A2cD28aE6C2f",
+        decimals: 18,
+        name: "Gho Token",
+        version: "1"
+      },
+      crvusd: {
+        address: "0xf939E0A03FB07F59A73314E73794Be0E57ac1b4E",
+        decimals: 18,
+        name: "Curve.Fi USD Stablecoin",
+        version: "1"
+      }
+    },
     x402: {
       facilitatorUrl: DEFAULT_FACILITATOR_URL,
       enabled: true
@@ -97,6 +175,20 @@ var SUPPORTED_CHAINS = {
       name: "USD Coin",
       version: "2"
     },
+    tokens: {
+      usdc: {
+        address: "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
+        decimals: 6,
+        name: "USD Coin",
+        version: "2"
+      },
+      ausd: {
+        address: "0x00000000eFE302BEAA2b3e6e1b18d08D69a9012a",
+        decimals: 6,
+        name: "Agora USD",
+        version: "1"
+      }
+    },
     x402: {
       facilitatorUrl: DEFAULT_FACILITATOR_URL,
       enabled: true
@@ -121,6 +213,32 @@ var SUPPORTED_CHAINS = {
       name: "USD Coin",
       version: "2"
     },
+    tokens: {
+      usdc: {
+        address: "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
+        decimals: 6,
+        name: "USD Coin",
+        version: "2"
+      },
+      ausd: {
+        address: "0x00000000eFE302BEAA2b3e6e1b18d08D69a9012a",
+        decimals: 6,
+        name: "Agora USD",
+        version: "1"
+      },
+      gho: {
+        address: "0x7dfF72693f6A4149b17e7C6314655f6A9F7c8B33",
+        decimals: 18,
+        name: "Gho Token",
+        version: "1"
+      },
+      crvusd: {
+        address: "0x498Bf2B1e120FeD3ad3D42EA2165E9b73f99C1e5",
+        decimals: 18,
+        name: "Curve.Fi USD Stablecoin",
+        version: "1"
+      }
+    },
     x402: {
       facilitatorUrl: DEFAULT_FACILITATOR_URL,
       enabled: true
@@ -145,6 +263,14 @@ var SUPPORTED_CHAINS = {
       name: "USD Coin",
       version: "2"
     },
+    tokens: {
+      usdc: {
+        address: "0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85",
+        decimals: 6,
+        name: "USD Coin",
+        version: "2"
+      }
+    },
     x402: {
       facilitatorUrl: DEFAULT_FACILITATOR_URL,
       enabled: true
@@ -170,6 +296,15 @@ var SUPPORTED_CHAINS = {
       // Celo uses "USDC" not "USD Coin" for EIP-712
       version: "2"
     },
+    tokens: {
+      usdc: {
+        address: "0xcebA9300f2b948710d2653dD7B07f33A8B32118C",
+        decimals: 6,
+        name: "USDC",
+        // Celo uses "USDC" not "USD Coin" for EIP-712
+        version: "2"
+      }
+    },
     x402: {
       facilitatorUrl: DEFAULT_FACILITATOR_URL,
       enabled: true
@@ -195,6 +330,15 @@ var SUPPORTED_CHAINS = {
       // HyperEVM uses "USDC" not "USD Coin"
       version: "2"
     },
+    tokens: {
+      usdc: {
+        address: "0xb88339CB7199b77E23DB6E890353E22632Ba630f",
+        decimals: 6,
+        name: "USDC",
+        // HyperEVM uses "USDC" not "USD Coin"
+        version: "2"
+      }
+    },
     x402: {
       facilitatorUrl: DEFAULT_FACILITATOR_URL,
       enabled: true
@@ -220,6 +364,15 @@ var SUPPORTED_CHAINS = {
       // Unichain uses "USDC" not "USD Coin"
       version: "2"
     },
+    tokens: {
+      usdc: {
+        address: "0x078d782b760474a361dda0af3839290b0ef57ad6",
+        decimals: 6,
+        name: "USDC",
+        // Unichain uses "USDC" not "USD Coin"
+        version: "2"
+      }
+    },
     x402: {
       facilitatorUrl: DEFAULT_FACILITATOR_URL,
       enabled: true
@@ -245,6 +398,21 @@ var SUPPORTED_CHAINS = {
       // Monad uses "USDC" not "USD Coin"
       version: "2"
     },
+    tokens: {
+      usdc: {
+        address: "0x754704bc059f8c67012fed69bc8a327a5aafb603",
+        decimals: 6,
+        name: "USDC",
+        // Monad uses "USDC" not "USD Coin"
+        version: "2"
+      },
+      ausd: {
+        address: "0x00000000eFE302BEAA2b3e6e1b18d08D69a9012a",
+        decimals: 6,
+        name: "Agora USD",
+        version: "1"
+      }
+    },
     x402: {
       facilitatorUrl: DEFAULT_FACILITATOR_URL,
       enabled: true