uvd-x402-sdk 2.0.1 → 2.0.3

package/README.md

@@ -1,12 +1,12 @@
 # uvd-x402-sdk
 
-> Gasless crypto payments across 15 blockchain networks using the x402 protocol.
+> 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.
 
 ## Features
 
-- **15 Supported Networks**: EVM chains, Solana, Fogo, Stellar, and NEAR
+- **14 Supported Networks**: EVM chains, Solana, Fogo, Stellar, and NEAR
 - **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
@@ -69,9 +69,66 @@ npm install react
 
 ---
 
+## WalletConnect Integration
+
+The SDK works with any EVM wallet that injects into `window.ethereum`, including:
+
+- **Browser extensions**: MetaMask, Rainbow, Rabby, Coinbase Wallet
+- **Mobile wallets**: Rainbow, MetaMask Mobile, Trust Wallet (via WalletConnect)
+
+### Using WalletConnect (Mobile Wallets)
+
+For mobile wallet support (Rainbow, MetaMask Mobile, etc.), initialize WalletConnect before using the SDK:
+
+```typescript
+import { EthereumProvider } from '@walletconnect/ethereum-provider';
+import { X402Client } from 'uvd-x402-sdk';
+
+// 1. Initialize WalletConnect
+const walletConnectProvider = await EthereumProvider.init({
+  projectId: 'YOUR_WALLETCONNECT_PROJECT_ID', // Get from cloud.walletconnect.com
+  chains: [8453], // Base mainnet
+  optionalChains: [1, 137, 42161, 10], // ETH, Polygon, Arbitrum, Optimism
+  showQrModal: true,
+});
+
+// 2. Connect wallet (shows QR code for mobile wallet to scan)
+await walletConnectProvider.connect();
+
+// 3. Use the SDK normally
+const client = new X402Client({ defaultChain: 'base' });
+const address = await client.connect('base');
+
+// 4. Create payment
+const result = await client.createPayment({
+  recipient: '0xD3868E1eD738CED6945A574a7c769433BeD5d474',
+  amount: '10.00',
+});
+```
+
+### Using Browser Extensions (Rainbow, MetaMask, etc.)
+
+Browser extension wallets work automatically - no extra setup needed:
+
+```typescript
+import { X402Client } from 'uvd-x402-sdk';
+
+const client = new X402Client({ defaultChain: 'base' });
+
+// Connects to whatever wallet is installed (Rainbow, MetaMask, Rabby, etc.)
+const address = await client.connect('base');
+
+const result = await client.createPayment({
+  recipient: '0xD3868E1eD738CED6945A574a7c769433BeD5d474',
+  amount: '10.00',
+});
+```
+
+---
+
 ## Network Examples
 
-### EVM Chains (11 Networks)
+### EVM Chains (10 Networks)
 
 All EVM chains use EIP-712 typed data signing with ERC-3009 TransferWithAuthorization.
 
@@ -553,7 +610,7 @@ function PaymentPage() {
 
 ## Supported Networks
 
-### EVM Networks (11)
+### EVM Networks (10)
 
 | Network | Chain ID | USDC Decimals | Status |
 |---------|----------|---------------|--------|
@@ -567,9 +624,6 @@ function PaymentPage() {
 | HyperEVM | 999 | 6 | Enabled |
 | Unichain | 130 | 6 | Enabled |
 | Monad | 143 | 6 | Enabled |
-| BSC | 56 | 18 | Disabled* |
-
-*BSC USDC doesn't support ERC-3009 transferWithAuthorization
 
 ### SVM Networks (2)
 
@@ -724,7 +778,7 @@ Install MyNearWallet or Meteor wallet for NEAR support.
 
 #### "Chain not supported"
 
-Check if the chain is enabled in `SUPPORTED_CHAINS`. BSC is disabled because its USDC doesn't support ERC-3009.
+Check if the chain is enabled in `SUPPORTED_CHAINS`.
 
 #### "Signature rejected by user"
 
@@ -778,5 +832,5 @@ MIT License - see [LICENSE](LICENSE) for details.
 - [x402 Protocol](https://x402.org)
 - [Ultravioleta DAO](https://ultravioletadao.xyz)
 - [402milly](https://402milly.xyz)
-- [GitHub](https://github.com/ultravioletadao/uvd-x402-sdk)
+- [GitHub](https://github.com/UltravioletaDAO/uvd-x402-sdk-typescript)
 - [npm](https://www.npmjs.com/package/uvd-x402-sdk)

package/dist/{index-DJ4Cvrev.d.mts → index-D0N_SYpK.d.mts}

@@ -1,4 +1,4 @@
-import { s as X402ClientConfig, P as PaymentInfo, e as PaymentResult, W as WalletState, C as ChainConfig, u as X402Event, w as X402EventHandler, a as NetworkType } from './index-D6Sr4ARD.mjs';
+import { s as X402ClientConfig, P as PaymentInfo, e as PaymentResult, W as WalletState, C as ChainConfig, u as X402Event, w as X402EventHandler, a as NetworkType } from './index-MTBgC_SL.mjs';
 
 /**
  * uvd-x402-sdk - Main Client

package/dist/{index-BrBqP1I8.d.ts → index-Db8dWNam.d.ts}

@@ -1,4 +1,4 @@
-import { s as X402ClientConfig, P as PaymentInfo, e as PaymentResult, W as WalletState, C as ChainConfig, u as X402Event, w as X402EventHandler, a as NetworkType } from './index-D6Sr4ARD.js';
+import { s as X402ClientConfig, P as PaymentInfo, e as PaymentResult, W as WalletState, C as ChainConfig, u as X402Event, w as X402EventHandler, a as NetworkType } from './index-MTBgC_SL.js';
 
 /**
  * uvd-x402-sdk - Main Client

package/dist/{index-D6Sr4ARD.d.mts → index-MTBgC_SL.d.mts}

@@ -20,7 +20,7 @@ type NetworkType = 'evm' | 'svm' | 'solana' | 'stellar' | 'near';
 interface USDCConfig {
     /** Contract/mint address */
     address: string;
-    /** Token decimals (6 for most chains, 7 for Stellar, 18 for BSC) */
+    /** Token decimals (6 for most chains, 7 for Stellar) */
     decimals: number;
     /** Token name for EIP-712 domain (e.g., "USD Coin" or "USDC") */
     name: string;

package/dist/{index-D6Sr4ARD.d.ts → index-MTBgC_SL.d.ts}

@@ -20,7 +20,7 @@ type NetworkType = 'evm' | 'svm' | 'solana' | 'stellar' | 'near';
 interface USDCConfig {
     /** Contract/mint address */
     address: string;
-    /** Token decimals (6 for most chains, 7 for Stellar, 18 for BSC) */
+    /** Token decimals (6 for most chains, 7 for Stellar) */
     decimals: number;
     /** Token name for EIP-712 domain (e.g., "USD Coin" or "USDC") */
     name: string;

package/dist/index.d.mts

@@ -1,3 +1,3 @@
-export { D as DEFAULT_CHAIN, a as DEFAULT_FACILITATOR_URL, S as SUPPORTED_CHAINS, X as X402Client, g as getChainById, b as getChainByName, d as getChainsByNetworkType, e as getEVMChainIds, c as getEnabledChains, l as getExplorerAddressUrl, k as getExplorerTxUrl, j as getNetworkType, f as getSVMChains, i as isChainSupported, h as isSVMChain } from './index-DJ4Cvrev.mjs';
+export { D as DEFAULT_CHAIN, a as DEFAULT_FACILITATOR_URL, S as SUPPORTED_CHAINS, X as X402Client, g as getChainById, b as getChainByName, d as getChainsByNetworkType, e as getEVMChainIds, c as getEnabledChains, l as getExplorerAddressUrl, k as getExplorerTxUrl, j as getNetworkType, f as getSVMChains, i as isChainSupported, h as isSVMChain } from './index-D0N_SYpK.mjs';
 export { caip2ToChain, chainToCAIP2, convertX402Header, createX402Header, createX402V1Header, createX402V2Header, decodeX402Header, detectX402Version, encodeX402Header, generatePaymentOptions, isCAIP2Format, parseNetworkIdentifier } from './utils/index.mjs';
-export { z as CAIP2_IDENTIFIERS, A as CAIP2_TO_CHAIN, C as ChainConfig, D as DEFAULT_CONFIG, E as EIP712Domain, c as EIP712Types, g as EVMPaymentPayload, M as MultiPaymentConfig, i as NEARPaymentPayload, N as NativeCurrency, t as NetworkBalance, a as NetworkType, P as PaymentInfo, f as PaymentPayload, d as PaymentRequest, e as PaymentResult, S as SolanaPaymentPayload, h as StellarPaymentPayload, U as USDCConfig, b as WalletAdapter, W as WalletState, s as X402ClientConfig, o as X402EVMPayload, y as X402Error, x as X402ErrorCode, u as X402Event, v as X402EventData, w as X402EventHandler, j as X402Header, k as X402HeaderV1, l as X402HeaderV2, r as X402NEARPayload, n as X402PayloadData, m as X402PaymentOption, p as X402SolanaPayload, q as X402StellarPayload, X as X402Version } from './index-D6Sr4ARD.mjs';
+export { z as CAIP2_IDENTIFIERS, A as CAIP2_TO_CHAIN, C as ChainConfig, D as DEFAULT_CONFIG, E as EIP712Domain, c as EIP712Types, g as EVMPaymentPayload, M as MultiPaymentConfig, i as NEARPaymentPayload, N as NativeCurrency, t as NetworkBalance, a as NetworkType, P as PaymentInfo, f as PaymentPayload, d as PaymentRequest, e as PaymentResult, S as SolanaPaymentPayload, h as StellarPaymentPayload, U as USDCConfig, b as WalletAdapter, W as WalletState, s as X402ClientConfig, o as X402EVMPayload, y as X402Error, x as X402ErrorCode, u as X402Event, v as X402EventData, w as X402EventHandler, j as X402Header, k as X402HeaderV1, l as X402HeaderV2, r as X402NEARPayload, n as X402PayloadData, m as X402PaymentOption, p as X402SolanaPayload, q as X402StellarPayload, X as X402Version } from './index-MTBgC_SL.mjs';

package/dist/index.d.ts

@@ -1,3 +1,3 @@
-export { D as DEFAULT_CHAIN, a as DEFAULT_FACILITATOR_URL, S as SUPPORTED_CHAINS, X as X402Client, g as getChainById, b as getChainByName, d as getChainsByNetworkType, e as getEVMChainIds, c as getEnabledChains, l as getExplorerAddressUrl, k as getExplorerTxUrl, j as getNetworkType, f as getSVMChains, i as isChainSupported, h as isSVMChain } from './index-BrBqP1I8.js';
+export { D as DEFAULT_CHAIN, a as DEFAULT_FACILITATOR_URL, S as SUPPORTED_CHAINS, X as X402Client, g as getChainById, b as getChainByName, d as getChainsByNetworkType, e as getEVMChainIds, c as getEnabledChains, l as getExplorerAddressUrl, k as getExplorerTxUrl, j as getNetworkType, f as getSVMChains, i as isChainSupported, h as isSVMChain } from './index-Db8dWNam.js';
 export { caip2ToChain, chainToCAIP2, convertX402Header, createX402Header, createX402V1Header, createX402V2Header, decodeX402Header, detectX402Version, encodeX402Header, generatePaymentOptions, isCAIP2Format, parseNetworkIdentifier } from './utils/index.js';
-export { z as CAIP2_IDENTIFIERS, A as CAIP2_TO_CHAIN, C as ChainConfig, D as DEFAULT_CONFIG, E as EIP712Domain, c as EIP712Types, g as EVMPaymentPayload, M as MultiPaymentConfig, i as NEARPaymentPayload, N as NativeCurrency, t as NetworkBalance, a as NetworkType, P as PaymentInfo, f as PaymentPayload, d as PaymentRequest, e as PaymentResult, S as SolanaPaymentPayload, h as StellarPaymentPayload, U as USDCConfig, b as WalletAdapter, W as WalletState, s as X402ClientConfig, o as X402EVMPayload, y as X402Error, x as X402ErrorCode, u as X402Event, v as X402EventData, w as X402EventHandler, j as X402Header, k as X402HeaderV1, l as X402HeaderV2, r as X402NEARPayload, n as X402PayloadData, m as X402PaymentOption, p as X402SolanaPayload, q as X402StellarPayload, X as X402Version } from './index-D6Sr4ARD.js';
+export { z as CAIP2_IDENTIFIERS, A as CAIP2_TO_CHAIN, C as ChainConfig, D as DEFAULT_CONFIG, E as EIP712Domain, c as EIP712Types, g as EVMPaymentPayload, M as MultiPaymentConfig, i as NEARPaymentPayload, N as NativeCurrency, t as NetworkBalance, a as NetworkType, P as PaymentInfo, f as PaymentPayload, d as PaymentRequest, e as PaymentResult, S as SolanaPaymentPayload, h as StellarPaymentPayload, U as USDCConfig, b as WalletAdapter, W as WalletState, s as X402ClientConfig, o as X402EVMPayload, y as X402Error, x as X402ErrorCode, u as X402Event, v as X402EventData, w as X402EventHandler, j as X402Header, k as X402HeaderV1, l as X402HeaderV2, r as X402NEARPayload, n as X402PayloadData, m as X402PaymentOption, p as X402SolanaPayload, q as X402StellarPayload, X as X402Version } from './index-MTBgC_SL.js';

package/dist/index.js

@@ -17,7 +17,6 @@ var CAIP2_IDENTIFIERS = {
   hyperevm: "eip155:999",
   unichain: "eip155:130",
   monad: "eip155:143",
-  bsc: "eip155:56",
   // SVM chains
   solana: "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
   fogo: "svm:fogo",
@@ -54,7 +53,7 @@ var X402Error = class _X402Error extends Error {
 var DEFAULT_FACILITATOR_URL = "https://facilitator.ultravioletadao.xyz";
 var SUPPORTED_CHAINS = {
   // ============================================================================
-  // EVM CHAINS (11 networks)
+  // EVM CHAINS (10 networks)
   // ============================================================================
   base: {
     chainId: 8453,
@@ -300,33 +299,6 @@ var SUPPORTED_CHAINS = {
       enabled: true
     }
   },
-  // BSC disabled: USDC doesn't support ERC-3009 transferWithAuthorization
-  bsc: {
-    chainId: 56,
-    chainIdHex: "0x38",
-    name: "bsc",
-    displayName: "BNB Smart Chain",
-    networkType: "evm",
-    rpcUrl: "https://binance.llamarpc.com",
-    explorerUrl: "https://bscscan.com",
-    nativeCurrency: {
-      name: "Binance Coin",
-      symbol: "BNB",
-      decimals: 18
-    },
-    usdc: {
-      address: "0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d",
-      decimals: 18,
-      // BSC USDC uses 18 decimals
-      name: "USD Coin",
-      version: "2"
-    },
-    x402: {
-      facilitatorUrl: DEFAULT_FACILITATOR_URL,
-      enabled: false
-      // Disabled: BSC USDC doesn't support ERC-3009
-    }
-  },
   // ============================================================================
   // SVM CHAINS (2 networks) - Solana Virtual Machine
   // ============================================================================