uvd-x402-sdk 2.1.0 → 2.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +282 -15
- package/dist/adapters/index.d.mts +1 -1
- package/dist/adapters/index.d.ts +1 -1
- package/dist/adapters/index.js +168 -0
- package/dist/adapters/index.js.map +1 -1
- package/dist/adapters/index.mjs +168 -0
- package/dist/adapters/index.mjs.map +1 -1
- package/dist/{index-MTBgC_SL.d.mts → index-BHwtdJrt.d.mts} +45 -4
- package/dist/{index-MTBgC_SL.d.ts → index-BHwtdJrt.d.ts} +45 -4
- package/dist/{index-Db8dWNam.d.ts → index-CkDdnSNx.d.mts} +33 -2
- package/dist/{index-D0N_SYpK.d.mts → index-UTj85ZDJ.d.ts} +33 -2
- package/dist/index.d.mts +2 -2
- package/dist/index.d.ts +2 -2
- package/dist/index.js +210 -0
- package/dist/index.js.map +1 -1
- package/dist/index.mjs +207 -1
- package/dist/index.mjs.map +1 -1
- package/dist/providers/evm/index.d.mts +19 -3
- package/dist/providers/evm/index.d.ts +19 -3
- package/dist/providers/evm/index.js +228 -12
- package/dist/providers/evm/index.js.map +1 -1
- package/dist/providers/evm/index.mjs +228 -12
- package/dist/providers/evm/index.mjs.map +1 -1
- package/dist/providers/near/index.d.mts +1 -1
- package/dist/providers/near/index.d.ts +1 -1
- package/dist/providers/near/index.js.map +1 -1
- package/dist/providers/near/index.mjs.map +1 -1
- package/dist/providers/solana/index.d.mts +1 -1
- package/dist/providers/solana/index.d.ts +1 -1
- package/dist/providers/solana/index.js +168 -0
- package/dist/providers/solana/index.js.map +1 -1
- package/dist/providers/solana/index.mjs +168 -0
- package/dist/providers/solana/index.mjs.map +1 -1
- package/dist/providers/stellar/index.d.mts +1 -1
- package/dist/providers/stellar/index.d.ts +1 -1
- package/dist/providers/stellar/index.js.map +1 -1
- package/dist/providers/stellar/index.mjs.map +1 -1
- package/dist/react/index.d.mts +3 -3
- package/dist/react/index.d.ts +3 -3
- package/dist/react/index.js +168 -0
- package/dist/react/index.js.map +1 -1
- package/dist/react/index.mjs +168 -0
- package/dist/react/index.mjs.map +1 -1
- package/dist/utils/index.d.mts +1 -1
- package/dist/utils/index.d.ts +1 -1
- package/dist/utils/index.js +168 -0
- package/dist/utils/index.js.map +1 -1
- package/dist/utils/index.mjs +168 -0
- package/dist/utils/index.mjs.map +1 -1
- package/package.json +5 -2
- package/src/chains/index.ts +255 -1
- package/src/index.ts +9 -0
- package/src/providers/evm/index.ts +64 -16
- package/src/types/index.ts +46 -3
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../../../src/types/index.ts","../../../src/chains/index.ts","../../../src/providers/solana/index.ts"],"names":["publicKeyString"],"mappings":"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","file":"index.mjs","sourcesContent":["/**\n * uvd-x402-sdk - Type Definitions\n *\n * Core TypeScript interfaces for the x402 payment SDK.\n * These types define the contract between the SDK and consuming applications.\n */\n\n// ============================================================================\n// CHAIN CONFIGURATION TYPES\n// ============================================================================\n\n/**\n * Network type categorization\n * - 'evm': Ethereum Virtual Machine compatible chains (use EIP-712)\n * - 'svm': Solana Virtual Machine chains (Solana, Fogo) (use SPL tokens)\n * - 'stellar': Stellar network (use Soroban)\n * - 'near': NEAR Protocol (use NEP-366)\n *\n * @deprecated 'solana' type is deprecated, use 'svm' instead\n */\nexport type NetworkType = 'evm' | 'svm' | 'solana' | 'stellar' | 'near';\n\n/**\n * USDC token configuration for a specific chain\n */\nexport interface USDCConfig {\n /** Contract/mint address */\n address: string;\n /** Token decimals (6 for most chains, 7 for Stellar) */\n decimals: number;\n /** Token name for EIP-712 domain (e.g., \"USD Coin\" or \"USDC\") */\n name: string;\n /** Token version for EIP-712 domain */\n version: string;\n}\n\n/**\n * Native currency configuration\n */\nexport interface NativeCurrency {\n name: string;\n symbol: string;\n decimals: number;\n}\n\n/**\n * Complete chain configuration\n */\nexport interface ChainConfig {\n /** Numeric chain ID (0 for non-EVM chains) */\n chainId: number;\n /** Hex-encoded chain ID for wallet_switchEthereumChain */\n chainIdHex: string;\n /** Internal chain identifier (e.g., 'base', 'solana') */\n name: string;\n /** Human-readable display name */\n displayName: string;\n /** Network type for routing */\n networkType: NetworkType;\n /** Primary RPC endpoint URL */\n rpcUrl: string;\n /** Block explorer base URL */\n explorerUrl: string;\n /** Native currency info */\n nativeCurrency: NativeCurrency;\n /** USDC token configuration */\n usdc: USDCConfig;\n /** x402 facilitator configuration */\n x402: {\n facilitatorUrl: string;\n enabled: boolean;\n };\n}\n\n// ============================================================================\n// WALLET TYPES\n// ============================================================================\n\n/**\n * Current wallet connection state\n */\nexport interface WalletState {\n /** Whether a wallet is currently connected */\n connected: boolean;\n /** Connected wallet address (null if not connected) */\n address: string | null;\n /** Current chain ID (null for non-EVM or disconnected) */\n chainId: number | null;\n /** Current network name */\n network: string | null;\n /** Network type of connected wallet */\n networkType: NetworkType | null;\n /** USDC balance on current chain (null if unknown) */\n balance: string | null;\n}\n\n/**\n * Wallet adapter interface for different wallet types\n */\nexport interface WalletAdapter {\n /** Unique identifier for this wallet type */\n readonly id: string;\n /** Display name */\n readonly name: string;\n /** Network type this adapter supports */\n readonly networkType: NetworkType;\n\n /** Check if this wallet is available/installed */\n isAvailable(): boolean;\n\n /** Connect to the wallet */\n connect(chainName?: string): Promise<string>;\n\n /** Disconnect from the wallet */\n disconnect(): Promise<void>;\n\n /** Switch to a different chain (EVM only) */\n switchChain?(chainName: string): Promise<void>;\n\n /** Sign a payment payload */\n signPayment(paymentInfo: PaymentInfo, chainConfig: ChainConfig): Promise<string>;\n\n /** Check USDC balance */\n getBalance(chainConfig: ChainConfig): Promise<string>;\n\n /** Get current address */\n getAddress(): string | null;\n\n /** Get current chain ID (EVM only) */\n getChainId?(): number | null;\n}\n\n/**\n * EIP-712 domain for typed data signing\n */\nexport interface EIP712Domain {\n name: string;\n version: string;\n chainId: number;\n verifyingContract: string;\n}\n\n/**\n * EIP-712 type definitions\n */\nexport interface EIP712Types {\n [typeName: string]: Array<{ name: string; type: string }>;\n}\n\n// ============================================================================\n// PAYMENT TYPES\n// ============================================================================\n\n/**\n * Payment information returned by backend on 402 response\n */\nexport interface PaymentInfo {\n /** Default recipient address */\n recipient: string;\n /** Network-specific recipient addresses */\n recipients?: {\n evm?: string;\n solana?: string;\n near?: string;\n stellar?: string;\n };\n /** Facilitator address (for Solana fee payer) */\n facilitator?: string;\n /** Amount in USD (e.g., \"10.00\") */\n amount: string;\n /** Token symbol (usually \"USDC\") */\n token?: string;\n /** Network hint from backend */\n network?: string;\n /** Supported chain IDs */\n supportedChains?: number[];\n}\n\n/**\n * Simple payment request from application\n */\nexport interface PaymentRequest {\n /** Amount in USDC (e.g., \"10.00\") */\n amount: string;\n /** Override recipient address (optional) */\n recipient?: string;\n /** Application-specific metadata */\n metadata?: Record<string, unknown>;\n}\n\n/**\n * Result of a payment operation\n */\nexport interface PaymentResult {\n /** Whether payment was successful */\n success: boolean;\n /** Base64-encoded X-PAYMENT header value */\n paymentHeader: string;\n /** Transaction hash (if available) */\n transactionHash?: string;\n /** Network where payment was made */\n network: string;\n /** Payer address */\n payer?: string;\n /** Error message (if success is false) */\n error?: string;\n}\n\n// ============================================================================\n// PAYLOAD TYPES (Internal)\n// ============================================================================\n\n/**\n * EVM payment payload (ERC-3009 TransferWithAuthorization)\n */\nexport interface EVMPaymentPayload {\n from: string;\n to: string;\n value: string;\n validAfter: number;\n validBefore: number;\n nonce: string;\n v: number;\n r: string;\n s: string;\n chainId: number;\n token: string;\n}\n\n/**\n * Solana payment payload (partially-signed transaction)\n */\nexport interface SolanaPaymentPayload {\n /** Base64-encoded serialized transaction */\n transaction: string;\n}\n\n/**\n * Stellar payment payload (Soroban authorization)\n */\nexport interface StellarPaymentPayload {\n /** Sender G... public key */\n from: string;\n /** Recipient G... public key */\n to: string;\n /** Amount in stroops (7 decimals) */\n amount: string;\n /** USDC SAC contract address */\n tokenContract: string;\n /** Base64 XDR-encoded SorobanAuthorizationEntry */\n authorizationEntryXdr: string;\n /** Random 64-bit nonce */\n nonce: number;\n /** Ledger when authorization expires */\n signatureExpirationLedger: number;\n}\n\n/**\n * NEAR payment payload (NEP-366 meta-transaction)\n */\nexport interface NEARPaymentPayload {\n /** Base64 Borsh-encoded SignedDelegateAction */\n signedDelegateAction: string;\n network: 'near';\n}\n\n/**\n * Union type for all payment payloads\n */\nexport type PaymentPayload =\n | EVMPaymentPayload\n | SolanaPaymentPayload\n | StellarPaymentPayload\n | NEARPaymentPayload;\n\n// ============================================================================\n// X402 HEADER TYPES (v1 and v2)\n// ============================================================================\n\n/**\n * x402 protocol version\n */\nexport type X402Version = 1 | 2;\n\n/**\n * CAIP-2 chain identifiers for x402 v2\n * @see https://github.com/ChainAgnostic/CAIPs/blob/master/CAIPs/caip-2.md\n */\nexport const CAIP2_IDENTIFIERS: Record<string, string> = {\n // EVM chains\n base: 'eip155:8453',\n ethereum: 'eip155:1',\n polygon: 'eip155:137',\n arbitrum: 'eip155:42161',\n optimism: 'eip155:10',\n avalanche: 'eip155:43114',\n celo: 'eip155:42220',\n hyperevm: 'eip155:999',\n unichain: 'eip155:130',\n monad: 'eip155:143',\n // SVM chains\n solana: 'solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp',\n fogo: 'svm:fogo',\n // Stellar\n stellar: 'stellar:pubnet',\n // NEAR\n near: 'near:mainnet',\n};\n\n/**\n * Reverse mapping from CAIP-2 to chain name\n */\nexport const CAIP2_TO_CHAIN: Record<string, string> = Object.fromEntries(\n Object.entries(CAIP2_IDENTIFIERS).map(([k, v]) => [v, k])\n);\n\n/**\n * x402 v1 header structure (network as string)\n */\nexport interface X402HeaderV1 {\n x402Version: 1;\n scheme: 'exact';\n network: string;\n payload: X402PayloadData;\n}\n\n/**\n * x402 v2 payment option\n */\nexport interface X402PaymentOption {\n network: string; // CAIP-2 format\n asset: string;\n amount: string;\n facilitator?: string;\n}\n\n/**\n * x402 v2 header structure (CAIP-2 network, accepts array)\n */\nexport interface X402HeaderV2 {\n x402Version: 2;\n scheme: 'exact';\n network: string; // CAIP-2 format\n payload: X402PayloadData;\n accepts?: X402PaymentOption[];\n}\n\n/**\n * Union type for both v1 and v2 headers\n */\nexport type X402Header = X402HeaderV1 | X402HeaderV2;\n\n/**\n * EVM-specific payload in x402 header\n */\nexport interface X402EVMPayload {\n signature: string;\n authorization: {\n from: string;\n to: string;\n value: string;\n validAfter: string;\n validBefore: string;\n nonce: string;\n };\n}\n\n/**\n * Solana-specific payload in x402 header\n */\nexport interface X402SolanaPayload {\n transaction: string;\n}\n\n/**\n * Stellar-specific payload in x402 header\n */\nexport interface X402StellarPayload {\n from: string;\n to: string;\n amount: string;\n tokenContract: string;\n authorizationEntryXdr: string;\n nonce: number;\n signatureExpirationLedger: number;\n}\n\n/**\n * NEAR-specific payload in x402 header\n */\nexport interface X402NEARPayload {\n signedDelegateAction: string;\n}\n\n/**\n * Union of all x402 payload types\n */\nexport type X402PayloadData =\n | X402EVMPayload\n | X402SolanaPayload\n | X402StellarPayload\n | X402NEARPayload;\n\n// ============================================================================\n// CLIENT CONFIGURATION\n// ============================================================================\n\n/**\n * Multi-payment configuration for supporting multiple networks\n */\nexport interface MultiPaymentConfig {\n /** Networks to support (e.g., ['base', 'solana', 'stellar', 'near']) */\n networks: string[];\n /** Default network if user hasn't selected one */\n defaultNetwork?: string;\n /** Whether to auto-detect user's preferred network based on wallet */\n autoDetect?: boolean;\n}\n\n/**\n * SDK client configuration options\n */\nexport interface X402ClientConfig {\n /** Facilitator URL (default: https://facilitator.ultravioletadao.xyz) */\n facilitatorUrl?: string;\n /** Default chain to connect to */\n defaultChain?: string;\n /** Auto-connect on initialization */\n autoConnect?: boolean;\n /** Enable debug logging */\n debug?: boolean;\n /** Custom chain configurations (override defaults) */\n customChains?: Record<string, Partial<ChainConfig>>;\n /** Wallet preference order */\n walletPreference?: string[];\n /** Custom RPC URLs (override defaults) */\n rpcOverrides?: Record<string, string>;\n /**\n * x402 protocol version to use\n * - 1: Classic format with network as string (e.g., \"base\")\n * - 2: CAIP-2 format with accepts array (e.g., \"eip155:8453\")\n * - 'auto': Auto-detect from 402 response (default)\n */\n x402Version?: X402Version | 'auto';\n /** Multi-payment configuration for supporting multiple networks */\n multiPayment?: MultiPaymentConfig;\n}\n\n/**\n * Default configuration values\n */\nexport const DEFAULT_CONFIG: Required<Pick<X402ClientConfig, 'facilitatorUrl' | 'defaultChain' | 'autoConnect' | 'debug' | 'x402Version'>> = {\n facilitatorUrl: 'https://facilitator.ultravioletadao.xyz',\n defaultChain: 'base',\n autoConnect: false,\n debug: false,\n x402Version: 'auto',\n};\n\n// ============================================================================\n// BALANCE TYPES\n// ============================================================================\n\n/**\n * Balance information for a single network\n */\nexport interface NetworkBalance {\n /** Chain name */\n chainName: string;\n /** Human-readable display name */\n displayName: string;\n /** Formatted balance (e.g., \"15.50\") or null if loading/error */\n balance: string | null;\n /** Whether balance is currently being fetched */\n isLoading: boolean;\n /** Error message if fetch failed */\n error: string | null;\n}\n\n// ============================================================================\n// EVENT TYPES\n// ============================================================================\n\n/**\n * Events emitted by the SDK client\n */\nexport type X402Event =\n | 'connect'\n | 'disconnect'\n | 'chainChanged'\n | 'accountChanged'\n | 'balanceChanged'\n | 'paymentStarted'\n | 'paymentSigned'\n | 'paymentCompleted'\n | 'paymentFailed';\n\n/**\n * Event data types\n */\nexport interface X402EventData {\n connect: WalletState;\n disconnect: void;\n chainChanged: { chainId: number; chainName: string };\n accountChanged: { address: string };\n balanceChanged: { balance: string };\n paymentStarted: { amount: string; network: string };\n paymentSigned: { paymentHeader: string };\n paymentCompleted: PaymentResult;\n paymentFailed: { error: string; code: X402ErrorCode };\n}\n\n/**\n * Event handler type\n */\nexport type X402EventHandler<E extends X402Event> = (data: X402EventData[E]) => void;\n\n// ============================================================================\n// ERROR TYPES\n// ============================================================================\n\n/**\n * Error codes for categorizing errors\n */\nexport type X402ErrorCode =\n | 'WALLET_NOT_FOUND'\n | 'WALLET_NOT_CONNECTED'\n | 'WALLET_CONNECTION_REJECTED'\n | 'WALLET_CONNECTION_TIMEOUT'\n | 'CHAIN_NOT_SUPPORTED'\n | 'CHAIN_SWITCH_REJECTED'\n | 'INSUFFICIENT_BALANCE'\n | 'SIGNATURE_REJECTED'\n | 'PAYMENT_FAILED'\n | 'PAYMENT_TIMEOUT'\n | 'NETWORK_ERROR'\n | 'INVALID_CONFIG'\n | 'INVALID_AMOUNT'\n | 'INVALID_RECIPIENT'\n | 'UNKNOWN_ERROR';\n\n/**\n * SDK-specific error class\n */\nexport class X402Error extends Error {\n public readonly code: X402ErrorCode;\n public readonly details?: unknown;\n\n constructor(message: string, code: X402ErrorCode, details?: unknown) {\n super(message);\n this.name = 'X402Error';\n this.code = code;\n this.details = details;\n\n // Maintains proper stack trace for where error was thrown (V8 engines)\n if (Error.captureStackTrace) {\n Error.captureStackTrace(this, X402Error);\n }\n }\n}\n","/**\n * uvd-x402-sdk - Chain Registry\n *\n * Complete configuration for all 15 supported blockchain networks.\n * EVM chains (11): Use ERC-3009 TransferWithAuthorization\n * SVM chains (2): Solana and Fogo - Use SPL tokens with partially-signed transactions\n * Stellar (1): Uses Soroban authorization entries\n * NEAR (1): Uses NEP-366 meta-transactions\n */\n\nimport type { ChainConfig, NetworkType } from '../types';\n\n/**\n * Default facilitator URL for x402 payments\n */\nexport const DEFAULT_FACILITATOR_URL = 'https://facilitator.ultravioletadao.xyz';\n\n/**\n * All supported chains configuration\n *\n * To add a new chain:\n * 1. Add chain config below with all required fields\n * 2. Verify USDC contract supports ERC-3009 (transferWithAuthorization) for EVM chains\n * 3. Test on testnet first before enabling\n */\nexport const SUPPORTED_CHAINS: Record<string, ChainConfig> = {\n // ============================================================================\n // EVM CHAINS (10 networks)\n // ============================================================================\n\n base: {\n chainId: 8453,\n chainIdHex: '0x2105',\n name: 'base',\n displayName: 'Base',\n networkType: 'evm',\n rpcUrl: 'https://mainnet.base.org',\n explorerUrl: 'https://basescan.org',\n nativeCurrency: {\n name: 'Ethereum',\n symbol: 'ETH',\n decimals: 18,\n },\n usdc: {\n address: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',\n decimals: 6,\n name: 'USD Coin',\n version: '2',\n },\n x402: {\n facilitatorUrl: DEFAULT_FACILITATOR_URL,\n enabled: true,\n },\n },\n\n avalanche: {\n chainId: 43114,\n chainIdHex: '0xa86a',\n name: 'avalanche',\n displayName: 'Avalanche C-Chain',\n networkType: 'evm',\n rpcUrl: 'https://avalanche-c-chain-rpc.publicnode.com',\n explorerUrl: 'https://snowtrace.io',\n nativeCurrency: {\n name: 'Avalanche',\n symbol: 'AVAX',\n decimals: 18,\n },\n usdc: {\n address: '0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E',\n decimals: 6,\n name: 'USD Coin',\n version: '2',\n },\n x402: {\n facilitatorUrl: DEFAULT_FACILITATOR_URL,\n enabled: true,\n },\n },\n\n ethereum: {\n chainId: 1,\n chainIdHex: '0x1',\n name: 'ethereum',\n displayName: 'Ethereum',\n networkType: 'evm',\n rpcUrl: 'https://eth.llamarpc.com',\n explorerUrl: 'https://etherscan.io',\n nativeCurrency: {\n name: 'Ethereum',\n symbol: 'ETH',\n decimals: 18,\n },\n usdc: {\n address: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48',\n decimals: 6,\n name: 'USD Coin',\n version: '2',\n },\n x402: {\n facilitatorUrl: DEFAULT_FACILITATOR_URL,\n enabled: true,\n },\n },\n\n polygon: {\n chainId: 137,\n chainIdHex: '0x89',\n name: 'polygon',\n displayName: 'Polygon',\n networkType: 'evm',\n rpcUrl: 'https://polygon-rpc.com',\n explorerUrl: 'https://polygonscan.com',\n nativeCurrency: {\n name: 'Polygon',\n symbol: 'POL',\n decimals: 18,\n },\n usdc: {\n address: '0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359',\n decimals: 6,\n name: 'USD Coin',\n version: '2',\n },\n x402: {\n facilitatorUrl: DEFAULT_FACILITATOR_URL,\n enabled: true,\n },\n },\n\n arbitrum: {\n chainId: 42161,\n chainIdHex: '0xa4b1',\n name: 'arbitrum',\n displayName: 'Arbitrum One',\n networkType: 'evm',\n rpcUrl: 'https://arb1.arbitrum.io/rpc',\n explorerUrl: 'https://arbiscan.io',\n nativeCurrency: {\n name: 'Ethereum',\n symbol: 'ETH',\n decimals: 18,\n },\n usdc: {\n address: '0xaf88d065e77c8cC2239327C5EDb3A432268e5831',\n decimals: 6,\n name: 'USD Coin',\n version: '2',\n },\n x402: {\n facilitatorUrl: DEFAULT_FACILITATOR_URL,\n enabled: true,\n },\n },\n\n optimism: {\n chainId: 10,\n chainIdHex: '0xa',\n name: 'optimism',\n displayName: 'Optimism',\n networkType: 'evm',\n rpcUrl: 'https://mainnet.optimism.io',\n explorerUrl: 'https://optimistic.etherscan.io',\n nativeCurrency: {\n name: 'Ethereum',\n symbol: 'ETH',\n decimals: 18,\n },\n usdc: {\n address: '0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85',\n decimals: 6,\n name: 'USD Coin',\n version: '2',\n },\n x402: {\n facilitatorUrl: DEFAULT_FACILITATOR_URL,\n enabled: true,\n },\n },\n\n celo: {\n chainId: 42220,\n chainIdHex: '0xa4ec',\n name: 'celo',\n displayName: 'Celo',\n networkType: 'evm',\n rpcUrl: 'https://forno.celo.org',\n explorerUrl: 'https://celoscan.io',\n nativeCurrency: {\n name: 'Celo',\n symbol: 'CELO',\n decimals: 18,\n },\n usdc: {\n address: '0xcebA9300f2b948710d2653dD7B07f33A8B32118C',\n decimals: 6,\n name: 'USDC', // Celo uses \"USDC\" not \"USD Coin\" for EIP-712\n version: '2',\n },\n x402: {\n facilitatorUrl: DEFAULT_FACILITATOR_URL,\n enabled: true,\n },\n },\n\n hyperevm: {\n chainId: 999,\n chainIdHex: '0x3e7',\n name: 'hyperevm',\n displayName: 'HyperEVM',\n networkType: 'evm',\n rpcUrl: 'https://rpc.hyperliquid.xyz/evm',\n explorerUrl: 'https://hyperevmscan.io',\n nativeCurrency: {\n name: 'Ethereum',\n symbol: 'ETH',\n decimals: 18,\n },\n usdc: {\n address: '0xb88339CB7199b77E23DB6E890353E22632Ba630f',\n decimals: 6,\n name: 'USDC', // HyperEVM uses \"USDC\" not \"USD Coin\"\n version: '2',\n },\n x402: {\n facilitatorUrl: DEFAULT_FACILITATOR_URL,\n enabled: true,\n },\n },\n\n unichain: {\n chainId: 130,\n chainIdHex: '0x82',\n name: 'unichain',\n displayName: 'Unichain',\n networkType: 'evm',\n rpcUrl: 'https://unichain-rpc.publicnode.com',\n explorerUrl: 'https://uniscan.xyz',\n nativeCurrency: {\n name: 'Ethereum',\n symbol: 'ETH',\n decimals: 18,\n },\n usdc: {\n address: '0x078d782b760474a361dda0af3839290b0ef57ad6',\n decimals: 6,\n name: 'USDC', // Unichain uses \"USDC\" not \"USD Coin\"\n version: '2',\n },\n x402: {\n facilitatorUrl: DEFAULT_FACILITATOR_URL,\n enabled: true,\n },\n },\n\n monad: {\n chainId: 143,\n chainIdHex: '0x8f',\n name: 'monad',\n displayName: 'Monad',\n networkType: 'evm',\n rpcUrl: 'https://rpc.monad.xyz',\n explorerUrl: 'https://monad.socialscan.io',\n nativeCurrency: {\n name: 'Monad',\n symbol: 'MON',\n decimals: 18,\n },\n usdc: {\n address: '0x754704bc059f8c67012fed69bc8a327a5aafb603',\n decimals: 6,\n name: 'USDC', // Monad uses \"USDC\" not \"USD Coin\"\n version: '2',\n },\n x402: {\n facilitatorUrl: DEFAULT_FACILITATOR_URL,\n enabled: true,\n },\n },\n\n // ============================================================================\n // SVM CHAINS (2 networks) - Solana Virtual Machine\n // ============================================================================\n\n solana: {\n chainId: 0, // Non-EVM\n chainIdHex: '0x0',\n name: 'solana',\n displayName: 'Solana',\n networkType: 'svm',\n rpcUrl: 'https://api.mainnet-beta.solana.com',\n explorerUrl: 'https://solscan.io',\n nativeCurrency: {\n name: 'Solana',\n symbol: 'SOL',\n decimals: 9,\n },\n usdc: {\n address: 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v', // USDC SPL token mint\n decimals: 6,\n name: 'USD Coin',\n version: '1',\n },\n x402: {\n facilitatorUrl: DEFAULT_FACILITATOR_URL,\n enabled: true,\n },\n },\n\n fogo: {\n chainId: 0, // Non-EVM (SVM)\n chainIdHex: '0x0',\n name: 'fogo',\n displayName: 'Fogo',\n networkType: 'svm',\n rpcUrl: 'https://rpc.fogo.nightly.app/',\n explorerUrl: 'https://explorer.fogo.nightly.app',\n nativeCurrency: {\n name: 'Fogo',\n symbol: 'FOGO',\n decimals: 9,\n },\n usdc: {\n address: 'uSd2czE61Evaf76RNbq4KPpXnkiL3irdzgLFUMe3NoG', // Fogo USDC mint\n decimals: 6,\n name: 'USDC',\n version: '1',\n },\n x402: {\n facilitatorUrl: DEFAULT_FACILITATOR_URL,\n enabled: true,\n },\n },\n\n // ============================================================================\n // STELLAR (1 network)\n // ============================================================================\n\n stellar: {\n chainId: 0, // Non-EVM\n chainIdHex: '0x0',\n name: 'stellar',\n displayName: 'Stellar',\n networkType: 'stellar',\n rpcUrl: 'https://horizon.stellar.org',\n explorerUrl: 'https://stellar.expert/explorer/public',\n nativeCurrency: {\n name: 'Lumens',\n symbol: 'XLM',\n decimals: 7, // Stellar uses 7 decimals (stroops)\n },\n usdc: {\n address: 'CCW67TSZV3SSS2HXMBQ5JFGCKJNXKZM7UQUWUZPUTHXSTZLEO7SJMI75', // Soroban Asset Contract\n decimals: 7, // Stellar USDC uses 7 decimals\n name: 'USDC',\n version: '1',\n },\n x402: {\n facilitatorUrl: DEFAULT_FACILITATOR_URL,\n enabled: true,\n },\n },\n\n // ============================================================================\n // NEAR (1 network) - Uses NEP-366 meta-transactions\n // ============================================================================\n\n near: {\n chainId: 0, // Non-EVM\n chainIdHex: '0x0',\n name: 'near',\n displayName: 'NEAR Protocol',\n networkType: 'near',\n rpcUrl: 'https://rpc.mainnet.near.org',\n explorerUrl: 'https://nearblocks.io',\n nativeCurrency: {\n name: 'NEAR',\n symbol: 'NEAR',\n decimals: 24, // NEAR uses 24 decimals (yoctoNEAR)\n },\n usdc: {\n address: '17208628f84f5d6ad33f0da3bbbeb27ffcb398eac501a31bd6ad2011e36133a1', // Native Circle USDC\n decimals: 6,\n name: 'USDC',\n version: '1',\n },\n x402: {\n facilitatorUrl: DEFAULT_FACILITATOR_URL,\n enabled: true, // NEP-366 meta-transactions supported\n },\n },\n};\n\n/**\n * Default chain for new users\n */\nexport const DEFAULT_CHAIN = 'base';\n\n/**\n * Get chain config by chain ID\n */\nexport function getChainById(chainId: number): ChainConfig | undefined {\n return Object.values(SUPPORTED_CHAINS).find(chain => chain.chainId === chainId);\n}\n\n/**\n * Get chain config by name (case-insensitive)\n */\nexport function getChainByName(name: string): ChainConfig | undefined {\n return SUPPORTED_CHAINS[name.toLowerCase()];\n}\n\n/**\n * Check if a chain is supported\n */\nexport function isChainSupported(chainIdOrName: number | string): boolean {\n if (typeof chainIdOrName === 'number') {\n return Object.values(SUPPORTED_CHAINS).some(chain => chain.chainId === chainIdOrName);\n }\n return chainIdOrName.toLowerCase() in SUPPORTED_CHAINS;\n}\n\n/**\n * Get list of enabled chains\n */\nexport function getEnabledChains(): ChainConfig[] {\n return Object.values(SUPPORTED_CHAINS).filter(chain => chain.x402.enabled);\n}\n\n/**\n * Get list of chains by network type\n */\nexport function getChainsByNetworkType(networkType: NetworkType): ChainConfig[] {\n return Object.values(SUPPORTED_CHAINS).filter(\n chain => chain.networkType === networkType && chain.x402.enabled\n );\n}\n\n/**\n * Get all EVM chain IDs (for wallet_switchEthereumChain)\n */\nexport function getEVMChainIds(): number[] {\n return getChainsByNetworkType('evm').map(chain => chain.chainId);\n}\n\n/**\n * Get list of SVM chains (Solana, Fogo)\n */\nexport function getSVMChains(): ChainConfig[] {\n return Object.values(SUPPORTED_CHAINS).filter(\n chain => chain.networkType === 'svm' && chain.x402.enabled\n );\n}\n\n/**\n * Check if a chain is SVM-based (Solana Virtual Machine)\n */\nexport function isSVMChain(chainName: string): boolean {\n const chain = getChainByName(chainName);\n return chain?.networkType === 'svm';\n}\n\n/**\n * Get network type from chain name\n */\nexport function getNetworkType(chainName: string): NetworkType | undefined {\n const chain = getChainByName(chainName);\n return chain?.networkType;\n}\n\n/**\n * Format transaction URL for block explorer\n */\nexport function getExplorerTxUrl(chainName: string, txHash: string): string | null {\n const chain = getChainByName(chainName);\n if (!chain) return null;\n\n switch (chain.networkType) {\n case 'evm':\n return `${chain.explorerUrl}/tx/${txHash}`;\n case 'svm':\n case 'solana': // @deprecated\n return `${chain.explorerUrl}/tx/${txHash}`;\n case 'stellar':\n return `${chain.explorerUrl}/tx/${txHash}`;\n case 'near':\n return `${chain.explorerUrl}/txns/${txHash}`;\n default:\n return null;\n }\n}\n\n/**\n * Format address URL for block explorer\n */\nexport function getExplorerAddressUrl(chainName: string, address: string): string | null {\n const chain = getChainByName(chainName);\n if (!chain) return null;\n\n switch (chain.networkType) {\n case 'evm':\n return `${chain.explorerUrl}/address/${address}`;\n case 'svm':\n case 'solana': // @deprecated\n return `${chain.explorerUrl}/account/${address}`;\n case 'stellar':\n return `${chain.explorerUrl}/account/${address}`;\n case 'near':\n return `${chain.explorerUrl}/address/${address}`;\n default:\n return null;\n }\n}\n","/**\n * uvd-x402-sdk - SVM Provider (Solana Virtual Machine)\n *\n * Provides wallet connection and payment creation for SVM-based chains via Phantom.\n * Supports: Solana, Fogo\n * Uses partially-signed transactions where the facilitator is the fee payer.\n *\n * @example Solana\n * ```ts\n * import { SVMProvider } from 'uvd-x402-sdk/solana';\n * import { getChainByName } from 'uvd-x402-sdk';\n *\n * const svm = new SVMProvider();\n *\n * // Connect\n * const address = await svm.connect();\n *\n * // Create Solana payment\n * const chainConfig = getChainByName('solana')!;\n * const paymentPayload = await svm.signPayment(paymentInfo, chainConfig);\n * const header = svm.encodePaymentHeader(paymentPayload, chainConfig);\n * ```\n *\n * @example Fogo\n * ```ts\n * import { SVMProvider } from 'uvd-x402-sdk/solana';\n * import { getChainByName } from 'uvd-x402-sdk';\n *\n * const svm = new SVMProvider();\n *\n * // Connect (same wallet works for all SVM chains)\n * const address = await svm.connect();\n *\n * // Create Fogo payment\n * const chainConfig = getChainByName('fogo')!;\n * const paymentPayload = await svm.signPayment(paymentInfo, chainConfig);\n * const header = svm.encodePaymentHeader(paymentPayload, chainConfig);\n * ```\n */\n\nimport type {\n ChainConfig,\n PaymentInfo,\n SolanaPaymentPayload,\n WalletAdapter,\n} from '../../types';\nimport { X402Error } from '../../types';\nimport { getChainByName } from '../../chains';\n\n/**\n * Browser-compatible base64 encoding for Uint8Array\n * Avoids Node.js Buffer dependency for browser bundlers\n */\nfunction uint8ArrayToBase64(bytes: Uint8Array): string {\n let binary = '';\n for (let i = 0; i < bytes.length; i++) {\n binary += String.fromCharCode(bytes[i]);\n }\n return btoa(binary);\n}\n\n// Lazy import Solana dependencies to avoid bundling when not used\nlet Connection: typeof import('@solana/web3.js').Connection;\nlet PublicKey: typeof import('@solana/web3.js').PublicKey;\nlet TransactionMessage: typeof import('@solana/web3.js').TransactionMessage;\nlet VersionedTransaction: typeof import('@solana/web3.js').VersionedTransaction;\nlet ComputeBudgetProgram: typeof import('@solana/web3.js').ComputeBudgetProgram;\nlet getAssociatedTokenAddress: typeof import('@solana/spl-token').getAssociatedTokenAddress;\nlet createTransferCheckedInstruction: typeof import('@solana/spl-token').createTransferCheckedInstruction;\nlet createAssociatedTokenAccountIdempotentInstruction: typeof import('@solana/spl-token').createAssociatedTokenAccountIdempotentInstruction;\nlet TOKEN_PROGRAM_ID: typeof import('@solana/spl-token').TOKEN_PROGRAM_ID;\n\nasync function loadSolanaDeps() {\n if (!Connection) {\n const web3 = await import('@solana/web3.js');\n const splToken = await import('@solana/spl-token');\n Connection = web3.Connection;\n PublicKey = web3.PublicKey;\n TransactionMessage = web3.TransactionMessage;\n VersionedTransaction = web3.VersionedTransaction;\n ComputeBudgetProgram = web3.ComputeBudgetProgram;\n getAssociatedTokenAddress = splToken.getAssociatedTokenAddress;\n createTransferCheckedInstruction = splToken.createTransferCheckedInstruction;\n createAssociatedTokenAccountIdempotentInstruction = splToken.createAssociatedTokenAccountIdempotentInstruction;\n TOKEN_PROGRAM_ID = splToken.TOKEN_PROGRAM_ID;\n }\n}\n\n/**\n * Phantom wallet provider interface\n */\ninterface PhantomProvider {\n isPhantom?: boolean;\n isConnected?: boolean;\n publicKey?: { toBase58(): string };\n connect(): Promise<{ publicKey: { toBase58(): string } }>;\n disconnect(): Promise<void>;\n signTransaction<T>(transaction: T): Promise<T>;\n}\n\n/**\n * SVMProvider - Wallet adapter for SVM chains (Solana, Fogo) via Phantom\n *\n * @alias SolanaProvider for backward compatibility\n */\nexport class SVMProvider implements WalletAdapter {\n readonly id = 'phantom';\n readonly name = 'Phantom';\n readonly networkType = 'svm' as const;\n\n private provider: PhantomProvider | null = null;\n private publicKey: InstanceType<typeof PublicKey> | null = null;\n private connections: Map<string, InstanceType<typeof Connection>> = new Map();\n private address: string | null = null;\n\n /**\n * Check if Phantom wallet is available\n */\n isAvailable(): boolean {\n if (typeof window === 'undefined') return false;\n return !!(\n (window as Window & { phantom?: { solana?: PhantomProvider } }).phantom?.solana?.isPhantom ||\n (window as Window & { solana?: PhantomProvider }).solana?.isPhantom\n );\n }\n\n /**\n * Connect to Phantom wallet\n */\n async connect(): Promise<string> {\n await loadSolanaDeps();\n\n // Get Phantom provider\n this.provider = await this.getPhantomProvider();\n if (!this.provider) {\n throw new X402Error(\n 'Phantom wallet not installed. Please install from phantom.app',\n 'WALLET_NOT_FOUND'\n );\n }\n\n try {\n // Check if already connected\n if (this.provider.publicKey && this.provider.isConnected) {\n const publicKeyString = this.provider.publicKey.toBase58();\n this.publicKey = new PublicKey(publicKeyString);\n this.address = publicKeyString;\n await this.initConnection();\n return publicKeyString;\n }\n\n // Connect\n const resp = await this.provider.connect();\n const publicKeyString = resp.publicKey.toBase58();\n\n this.publicKey = new PublicKey(publicKeyString);\n this.address = publicKeyString;\n\n await this.initConnection();\n\n return publicKeyString;\n } catch (error: unknown) {\n if (error instanceof Error) {\n if (error.message.includes('User rejected') || (error as { code?: number }).code === 4001) {\n throw new X402Error('Connection rejected by user', 'WALLET_CONNECTION_REJECTED');\n }\n }\n throw new X402Error(\n `Failed to connect Phantom: ${error instanceof Error ? error.message : 'Unknown error'}`,\n 'UNKNOWN_ERROR',\n error\n );\n }\n }\n\n /**\n * Disconnect from Phantom\n */\n async disconnect(): Promise<void> {\n if (this.provider) {\n try {\n await this.provider.disconnect();\n } catch {\n // Ignore disconnect errors\n }\n }\n this.provider = null;\n this.publicKey = null;\n this.connections.clear();\n this.address = null;\n }\n\n /**\n * Get current address\n */\n getAddress(): string | null {\n return this.address;\n }\n\n /**\n * Get USDC balance\n */\n async getBalance(chainConfig: ChainConfig): Promise<string> {\n await loadSolanaDeps();\n\n if (!this.address) {\n throw new X402Error('Wallet not connected', 'WALLET_NOT_CONNECTED');\n }\n\n await this.initConnection(chainConfig);\n const connection = this.connections.get(chainConfig.name);\n if (!connection) {\n throw new X402Error('Failed to connect to Solana RPC', 'NETWORK_ERROR');\n }\n\n try {\n const response = await fetch(chainConfig.rpcUrl, {\n method: 'POST',\n headers: { 'Content-Type': 'application/json' },\n body: JSON.stringify({\n jsonrpc: '2.0',\n id: 1,\n method: 'getTokenAccountsByOwner',\n params: [\n this.address,\n { mint: chainConfig.usdc.address },\n { encoding: 'jsonParsed' },\n ],\n }),\n });\n\n const data = await response.json();\n\n if (!data.result?.value?.length) {\n return '0.00';\n }\n\n const tokenAccountInfo = data.result.value[0].account.data.parsed.info;\n const balance = Number(tokenAccountInfo.tokenAmount.amount) / Math.pow(10, tokenAccountInfo.tokenAmount.decimals);\n\n return balance.toFixed(2);\n } catch {\n return '0.00';\n }\n }\n\n /**\n * Create SVM payment (partially-signed transaction)\n *\n * Works for both Solana and Fogo chains.\n *\n * Transaction structure required by facilitator:\n * 1. SetComputeUnitLimit\n * 2. SetComputeUnitPrice\n * 3. (Optional) CreateAssociatedTokenAccount if recipient ATA doesn't exist\n * 4. TransferChecked (USDC transfer)\n *\n * Fee payer: Facilitator (not user)\n * User pays: ZERO SOL/FOGO\n */\n async signPayment(paymentInfo: PaymentInfo, chainConfig: ChainConfig): Promise<string> {\n await loadSolanaDeps();\n\n if (!this.provider || !this.publicKey || !this.address) {\n throw new X402Error('Wallet not connected', 'WALLET_NOT_CONNECTED');\n }\n\n const connection = await this.getConnection(chainConfig);\n if (!connection) {\n throw new X402Error(`Failed to connect to ${chainConfig.displayName} RPC`, 'NETWORK_ERROR');\n }\n\n // Get recipient and facilitator addresses\n const recipient = paymentInfo.recipients?.solana || paymentInfo.recipient;\n const facilitatorAddress = paymentInfo.facilitator;\n\n if (!facilitatorAddress) {\n throw new X402Error('Facilitator address not provided', 'INVALID_CONFIG');\n }\n\n const recipientPubkey = new PublicKey(recipient);\n const facilitatorPubkey = new PublicKey(facilitatorAddress);\n const usdcMint = new PublicKey(chainConfig.usdc.address);\n\n // Parse amount (6 decimals for USDC)\n const amount = Math.floor(parseFloat(paymentInfo.amount) * 1_000_000);\n\n // Get token accounts\n const fromTokenAccount = await getAssociatedTokenAddress(\n usdcMint,\n this.publicKey,\n true,\n TOKEN_PROGRAM_ID\n );\n\n const toTokenAccount = await getAssociatedTokenAddress(\n usdcMint,\n recipientPubkey,\n true,\n TOKEN_PROGRAM_ID\n );\n\n // Check if recipient ATA exists\n const toTokenAccountInfo = await connection.getAccountInfo(toTokenAccount);\n const needsATACreation = toTokenAccountInfo === null;\n\n // Get recent blockhash\n const { blockhash } = await connection.getLatestBlockhash('finalized');\n\n // Build instructions in exact order required by facilitator\n const instructions = [];\n\n // Instruction 0: SetComputeUnitLimit\n instructions.push(\n ComputeBudgetProgram.setComputeUnitLimit({\n units: needsATACreation ? 50_000 : 20_000,\n })\n );\n\n // Instruction 1: SetComputeUnitPrice\n // Use 100k microlamports/CU for fast landing on mainnet\n // Lower values (like 1) cause transactions to be deprioritized and time out\n instructions.push(\n ComputeBudgetProgram.setComputeUnitPrice({\n microLamports: 100_000,\n })\n );\n\n // Instruction 2 (optional): CreateAssociatedTokenAccountIdempotent\n // User pays for ATA creation (not facilitator - security check in x402-rs)\n if (needsATACreation) {\n instructions.push(\n createAssociatedTokenAccountIdempotentInstruction(\n this.publicKey, // User pays for ATA creation\n toTokenAccount,\n recipientPubkey,\n usdcMint,\n TOKEN_PROGRAM_ID\n )\n );\n }\n\n // Instruction 2/3: TransferChecked\n instructions.push(\n createTransferCheckedInstruction(\n fromTokenAccount,\n usdcMint,\n toTokenAccount,\n this.publicKey,\n amount,\n 6,\n [],\n TOKEN_PROGRAM_ID\n )\n );\n\n // Build VersionedTransaction with facilitator as fee payer\n const messageV0 = new TransactionMessage({\n payerKey: facilitatorPubkey,\n recentBlockhash: blockhash,\n instructions,\n }).compileToV0Message();\n\n const transaction = new VersionedTransaction(messageV0);\n\n // User signs (partial signature - facilitator will co-sign)\n // IMPORTANT: Phantom may modify the transaction (add memo instruction).\n // We send the FULL signed transaction to the facilitator, which will use it\n // exactly as signed (not reconstruct it). This ensures signature validity.\n let signedTransaction: InstanceType<typeof VersionedTransaction>;\n try {\n signedTransaction = await this.provider.signTransaction(transaction);\n } catch (error: unknown) {\n if (error instanceof Error && error.message.includes('User rejected')) {\n throw new X402Error('Signature rejected by user', 'SIGNATURE_REJECTED');\n }\n throw new X402Error(\n `Failed to sign transaction: ${error instanceof Error ? error.message : 'Unknown error'}`,\n 'PAYMENT_FAILED',\n error\n );\n }\n\n // Serialize the FULL signed transaction (including any wallet modifications)\n // The facilitator will use this exact transaction, adding only its signature\n const serialized = signedTransaction.serialize();\n\n const payload: SolanaPaymentPayload = {\n transaction: uint8ArrayToBase64(serialized),\n };\n\n return JSON.stringify(payload);\n }\n\n /**\n * Encode SVM payment as X-PAYMENT header\n *\n * @param paymentPayload - The payment payload JSON string\n * @param chainConfig - Optional chain config (defaults to 'solana' if not provided)\n */\n encodePaymentHeader(paymentPayload: string, chainConfig?: ChainConfig): string {\n const payload = JSON.parse(paymentPayload) as SolanaPaymentPayload;\n\n // Use chain name from config, or default to 'solana' for backward compatibility\n const networkName = chainConfig?.name || 'solana';\n\n const x402Payload = {\n x402Version: 1,\n scheme: 'exact',\n network: networkName,\n payload: {\n transaction: payload.transaction,\n },\n };\n\n return btoa(JSON.stringify(x402Payload));\n }\n\n // Private helpers\n\n private async getPhantomProvider(): Promise<PhantomProvider | null> {\n if (typeof window === 'undefined') return null;\n\n // Try window.phantom.solana first\n const win = window as Window & {\n phantom?: { solana?: PhantomProvider };\n solana?: PhantomProvider;\n };\n\n if (win.phantom?.solana?.isPhantom) {\n return win.phantom.solana;\n }\n\n // Fallback to window.solana\n if (win.solana?.isPhantom) {\n return win.solana;\n }\n\n // Wait a bit for Phantom to inject itself\n for (let i = 0; i < 5; i++) {\n await new Promise(resolve => setTimeout(resolve, 100));\n if (win.phantom?.solana?.isPhantom) {\n return win.phantom.solana;\n }\n if (win.solana?.isPhantom) {\n return win.solana;\n }\n }\n\n return null;\n }\n\n /**\n * Get or create a connection for a specific chain\n *\n * IMPORTANT: Caches by RPC URL, not chain name. This allows consumers to\n * override the RPC URL (e.g., use Helius instead of public RPC) and get\n * a fresh connection with their custom RPC.\n */\n private async getConnection(chainConfig?: ChainConfig): Promise<InstanceType<typeof Connection>> {\n await loadSolanaDeps();\n\n const config = chainConfig || getChainByName('solana');\n if (!config) {\n throw new X402Error('Chain config not found', 'CHAIN_NOT_SUPPORTED');\n }\n\n // Cache by RPC URL, not chain name - allows custom RPC overrides\n const cacheKey = config.rpcUrl;\n\n // Check if we already have a connection for this RPC\n if (this.connections.has(cacheKey)) {\n return this.connections.get(cacheKey)!;\n }\n\n // Create new connection for this RPC\n const connection = new Connection(config.rpcUrl, 'confirmed');\n this.connections.set(cacheKey, connection);\n\n return connection;\n }\n\n /**\n * @deprecated Use getConnection instead\n */\n private async initConnection(chainConfig?: ChainConfig): Promise<void> {\n await this.getConnection(chainConfig);\n }\n}\n\n/**\n * @deprecated Use SVMProvider instead\n */\nexport class SolanaProvider extends SVMProvider {\n constructor() {\n super();\n console.warn('SolanaProvider is deprecated. Use SVMProvider instead.');\n }\n}\n\n// Default export\nexport default SVMProvider;\n"]}
|
|
1
|
+
{"version":3,"sources":["../../../src/types/index.ts","../../../src/chains/index.ts","../../../src/providers/solana/index.ts"],"names":["publicKeyString"],"mappings":"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","file":"index.mjs","sourcesContent":["/**\n * uvd-x402-sdk - Type Definitions\n *\n * Core TypeScript interfaces for the x402 payment SDK.\n * These types define the contract between the SDK and consuming applications.\n */\n\n// ============================================================================\n// CHAIN CONFIGURATION TYPES\n// ============================================================================\n\n/**\n * Network type categorization\n * - 'evm': Ethereum Virtual Machine compatible chains (use EIP-712)\n * - 'svm': Solana Virtual Machine chains (Solana, Fogo) (use SPL tokens)\n * - 'stellar': Stellar network (use Soroban)\n * - 'near': NEAR Protocol (use NEP-366)\n *\n * @deprecated 'solana' type is deprecated, use 'svm' instead\n */\nexport type NetworkType = 'evm' | 'svm' | 'solana' | 'stellar' | 'near';\n\n/**\n * Supported stablecoin token types\n * - usdc: USD Coin (Circle) - 6 decimals\n * - eurc: Euro Coin (Circle) - 6 decimals\n * - ausd: Agora USD (Agora Finance) - 6 decimals\n * - pyusd: PayPal USD (PayPal/Paxos) - 6 decimals\n * - gho: GHO Stablecoin (Aave) - 18 decimals\n * - crvusd: Curve USD (Curve Finance) - 18 decimals\n */\nexport type TokenType = 'usdc' | 'eurc' | 'ausd' | 'pyusd' | 'gho' | 'crvusd';\n\n/**\n * Token configuration for EIP-712 signing and transfers\n */\nexport interface TokenConfig {\n /** Contract/mint address */\n address: string;\n /** Token decimals (6 for most stablecoins, 18 for GHO/crvUSD) */\n decimals: number;\n /** Token name for EIP-712 domain (e.g., \"USD Coin\" or \"USDC\") */\n name: string;\n /** Token version for EIP-712 domain */\n version: string;\n}\n\n/**\n * USDC token configuration for a specific chain\n * @deprecated Use TokenConfig instead. This is kept for backward compatibility.\n */\nexport interface USDCConfig {\n /** Contract/mint address */\n address: string;\n /** Token decimals (6 for most chains, 7 for Stellar) */\n decimals: number;\n /** Token name for EIP-712 domain (e.g., \"USD Coin\" or \"USDC\") */\n name: string;\n /** Token version for EIP-712 domain */\n version: string;\n}\n\n/**\n * Native currency configuration\n */\nexport interface NativeCurrency {\n name: string;\n symbol: string;\n decimals: number;\n}\n\n/**\n * Complete chain configuration\n */\nexport interface ChainConfig {\n /** Numeric chain ID (0 for non-EVM chains) */\n chainId: number;\n /** Hex-encoded chain ID for wallet_switchEthereumChain */\n chainIdHex: string;\n /** Internal chain identifier (e.g., 'base', 'solana') */\n name: string;\n /** Human-readable display name */\n displayName: string;\n /** Network type for routing */\n networkType: NetworkType;\n /** Primary RPC endpoint URL */\n rpcUrl: string;\n /** Block explorer base URL */\n explorerUrl: string;\n /** Native currency info */\n nativeCurrency: NativeCurrency;\n /** USDC token configuration */\n usdc: USDCConfig;\n /**\n * Multi-token configurations (EVM chains only)\n * Maps token type to its configuration for this chain.\n * Not all tokens are available on all chains.\n */\n tokens?: Partial<Record<TokenType, TokenConfig>>;\n /** x402 facilitator configuration */\n x402: {\n facilitatorUrl: string;\n enabled: boolean;\n };\n}\n\n// ============================================================================\n// WALLET TYPES\n// ============================================================================\n\n/**\n * Current wallet connection state\n */\nexport interface WalletState {\n /** Whether a wallet is currently connected */\n connected: boolean;\n /** Connected wallet address (null if not connected) */\n address: string | null;\n /** Current chain ID (null for non-EVM or disconnected) */\n chainId: number | null;\n /** Current network name */\n network: string | null;\n /** Network type of connected wallet */\n networkType: NetworkType | null;\n /** USDC balance on current chain (null if unknown) */\n balance: string | null;\n}\n\n/**\n * Wallet adapter interface for different wallet types\n */\nexport interface WalletAdapter {\n /** Unique identifier for this wallet type */\n readonly id: string;\n /** Display name */\n readonly name: string;\n /** Network type this adapter supports */\n readonly networkType: NetworkType;\n\n /** Check if this wallet is available/installed */\n isAvailable(): boolean;\n\n /** Connect to the wallet */\n connect(chainName?: string): Promise<string>;\n\n /** Disconnect from the wallet */\n disconnect(): Promise<void>;\n\n /** Switch to a different chain (EVM only) */\n switchChain?(chainName: string): Promise<void>;\n\n /**\n * Sign a payment payload\n * For EVM chains, supports multi-token via paymentInfo.tokenType\n */\n signPayment(paymentInfo: PaymentInfo, chainConfig: ChainConfig): Promise<string>;\n\n /**\n * Check token balance (defaults to USDC for backward compatibility)\n * EVM providers may accept optional tokenType parameter\n */\n getBalance(chainConfig: ChainConfig, tokenType?: TokenType): Promise<string>;\n\n /** Get current address */\n getAddress(): string | null;\n\n /** Get current chain ID (EVM only) */\n getChainId?(): number | null;\n}\n\n/**\n * EIP-712 domain for typed data signing\n */\nexport interface EIP712Domain {\n name: string;\n version: string;\n chainId: number;\n verifyingContract: string;\n}\n\n/**\n * EIP-712 type definitions\n */\nexport interface EIP712Types {\n [typeName: string]: Array<{ name: string; type: string }>;\n}\n\n// ============================================================================\n// PAYMENT TYPES\n// ============================================================================\n\n/**\n * Payment information returned by backend on 402 response\n */\nexport interface PaymentInfo {\n /** Default recipient address */\n recipient: string;\n /** Network-specific recipient addresses */\n recipients?: {\n evm?: string;\n solana?: string;\n near?: string;\n stellar?: string;\n };\n /** Facilitator address (for Solana fee payer) */\n facilitator?: string;\n /** Amount in USD (e.g., \"10.00\") */\n amount: string;\n /** Token symbol (usually \"USDC\") */\n token?: string;\n /**\n * Token type for multi-token support\n * Defaults to 'usdc' if not specified for backward compatibility\n */\n tokenType?: TokenType;\n /** Network hint from backend */\n network?: string;\n /** Supported chain IDs */\n supportedChains?: number[];\n}\n\n/**\n * Simple payment request from application\n */\nexport interface PaymentRequest {\n /** Amount in USDC (e.g., \"10.00\") */\n amount: string;\n /** Override recipient address (optional) */\n recipient?: string;\n /** Application-specific metadata */\n metadata?: Record<string, unknown>;\n}\n\n/**\n * Result of a payment operation\n */\nexport interface PaymentResult {\n /** Whether payment was successful */\n success: boolean;\n /** Base64-encoded X-PAYMENT header value */\n paymentHeader: string;\n /** Transaction hash (if available) */\n transactionHash?: string;\n /** Network where payment was made */\n network: string;\n /** Payer address */\n payer?: string;\n /** Error message (if success is false) */\n error?: string;\n}\n\n// ============================================================================\n// PAYLOAD TYPES (Internal)\n// ============================================================================\n\n/**\n * EVM payment payload (ERC-3009 TransferWithAuthorization)\n */\nexport interface EVMPaymentPayload {\n from: string;\n to: string;\n value: string;\n validAfter: number;\n validBefore: number;\n nonce: string;\n v: number;\n r: string;\n s: string;\n chainId: number;\n token: string;\n}\n\n/**\n * Solana payment payload (partially-signed transaction)\n */\nexport interface SolanaPaymentPayload {\n /** Base64-encoded serialized transaction */\n transaction: string;\n}\n\n/**\n * Stellar payment payload (Soroban authorization)\n */\nexport interface StellarPaymentPayload {\n /** Sender G... public key */\n from: string;\n /** Recipient G... public key */\n to: string;\n /** Amount in stroops (7 decimals) */\n amount: string;\n /** USDC SAC contract address */\n tokenContract: string;\n /** Base64 XDR-encoded SorobanAuthorizationEntry */\n authorizationEntryXdr: string;\n /** Random 64-bit nonce */\n nonce: number;\n /** Ledger when authorization expires */\n signatureExpirationLedger: number;\n}\n\n/**\n * NEAR payment payload (NEP-366 meta-transaction)\n */\nexport interface NEARPaymentPayload {\n /** Base64 Borsh-encoded SignedDelegateAction */\n signedDelegateAction: string;\n network: 'near';\n}\n\n/**\n * Union type for all payment payloads\n */\nexport type PaymentPayload =\n | EVMPaymentPayload\n | SolanaPaymentPayload\n | StellarPaymentPayload\n | NEARPaymentPayload;\n\n// ============================================================================\n// X402 HEADER TYPES (v1 and v2)\n// ============================================================================\n\n/**\n * x402 protocol version\n */\nexport type X402Version = 1 | 2;\n\n/**\n * CAIP-2 chain identifiers for x402 v2\n * @see https://github.com/ChainAgnostic/CAIPs/blob/master/CAIPs/caip-2.md\n */\nexport const CAIP2_IDENTIFIERS: Record<string, string> = {\n // EVM chains\n base: 'eip155:8453',\n ethereum: 'eip155:1',\n polygon: 'eip155:137',\n arbitrum: 'eip155:42161',\n optimism: 'eip155:10',\n avalanche: 'eip155:43114',\n celo: 'eip155:42220',\n hyperevm: 'eip155:999',\n unichain: 'eip155:130',\n monad: 'eip155:143',\n // SVM chains\n solana: 'solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp',\n fogo: 'svm:fogo',\n // Stellar\n stellar: 'stellar:pubnet',\n // NEAR\n near: 'near:mainnet',\n};\n\n/**\n * Reverse mapping from CAIP-2 to chain name\n */\nexport const CAIP2_TO_CHAIN: Record<string, string> = Object.fromEntries(\n Object.entries(CAIP2_IDENTIFIERS).map(([k, v]) => [v, k])\n);\n\n/**\n * x402 v1 header structure (network as string)\n */\nexport interface X402HeaderV1 {\n x402Version: 1;\n scheme: 'exact';\n network: string;\n payload: X402PayloadData;\n}\n\n/**\n * x402 v2 payment option\n */\nexport interface X402PaymentOption {\n network: string; // CAIP-2 format\n asset: string;\n amount: string;\n facilitator?: string;\n}\n\n/**\n * x402 v2 header structure (CAIP-2 network, accepts array)\n */\nexport interface X402HeaderV2 {\n x402Version: 2;\n scheme: 'exact';\n network: string; // CAIP-2 format\n payload: X402PayloadData;\n accepts?: X402PaymentOption[];\n}\n\n/**\n * Union type for both v1 and v2 headers\n */\nexport type X402Header = X402HeaderV1 | X402HeaderV2;\n\n/**\n * EVM-specific payload in x402 header\n */\nexport interface X402EVMPayload {\n signature: string;\n authorization: {\n from: string;\n to: string;\n value: string;\n validAfter: string;\n validBefore: string;\n nonce: string;\n };\n}\n\n/**\n * Solana-specific payload in x402 header\n */\nexport interface X402SolanaPayload {\n transaction: string;\n}\n\n/**\n * Stellar-specific payload in x402 header\n */\nexport interface X402StellarPayload {\n from: string;\n to: string;\n amount: string;\n tokenContract: string;\n authorizationEntryXdr: string;\n nonce: number;\n signatureExpirationLedger: number;\n}\n\n/**\n * NEAR-specific payload in x402 header\n */\nexport interface X402NEARPayload {\n signedDelegateAction: string;\n}\n\n/**\n * Union of all x402 payload types\n */\nexport type X402PayloadData =\n | X402EVMPayload\n | X402SolanaPayload\n | X402StellarPayload\n | X402NEARPayload;\n\n// ============================================================================\n// CLIENT CONFIGURATION\n// ============================================================================\n\n/**\n * Multi-payment configuration for supporting multiple networks\n */\nexport interface MultiPaymentConfig {\n /** Networks to support (e.g., ['base', 'solana', 'stellar', 'near']) */\n networks: string[];\n /** Default network if user hasn't selected one */\n defaultNetwork?: string;\n /** Whether to auto-detect user's preferred network based on wallet */\n autoDetect?: boolean;\n}\n\n/**\n * SDK client configuration options\n */\nexport interface X402ClientConfig {\n /** Facilitator URL (default: https://facilitator.ultravioletadao.xyz) */\n facilitatorUrl?: string;\n /** Default chain to connect to */\n defaultChain?: string;\n /** Auto-connect on initialization */\n autoConnect?: boolean;\n /** Enable debug logging */\n debug?: boolean;\n /** Custom chain configurations (override defaults) */\n customChains?: Record<string, Partial<ChainConfig>>;\n /** Wallet preference order */\n walletPreference?: string[];\n /** Custom RPC URLs (override defaults) */\n rpcOverrides?: Record<string, string>;\n /**\n * x402 protocol version to use\n * - 1: Classic format with network as string (e.g., \"base\")\n * - 2: CAIP-2 format with accepts array (e.g., \"eip155:8453\")\n * - 'auto': Auto-detect from 402 response (default)\n */\n x402Version?: X402Version | 'auto';\n /** Multi-payment configuration for supporting multiple networks */\n multiPayment?: MultiPaymentConfig;\n}\n\n/**\n * Default configuration values\n */\nexport const DEFAULT_CONFIG: Required<Pick<X402ClientConfig, 'facilitatorUrl' | 'defaultChain' | 'autoConnect' | 'debug' | 'x402Version'>> = {\n facilitatorUrl: 'https://facilitator.ultravioletadao.xyz',\n defaultChain: 'base',\n autoConnect: false,\n debug: false,\n x402Version: 'auto',\n};\n\n// ============================================================================\n// BALANCE TYPES\n// ============================================================================\n\n/**\n * Balance information for a single network\n */\nexport interface NetworkBalance {\n /** Chain name */\n chainName: string;\n /** Human-readable display name */\n displayName: string;\n /** Formatted balance (e.g., \"15.50\") or null if loading/error */\n balance: string | null;\n /** Whether balance is currently being fetched */\n isLoading: boolean;\n /** Error message if fetch failed */\n error: string | null;\n}\n\n// ============================================================================\n// EVENT TYPES\n// ============================================================================\n\n/**\n * Events emitted by the SDK client\n */\nexport type X402Event =\n | 'connect'\n | 'disconnect'\n | 'chainChanged'\n | 'accountChanged'\n | 'balanceChanged'\n | 'paymentStarted'\n | 'paymentSigned'\n | 'paymentCompleted'\n | 'paymentFailed';\n\n/**\n * Event data types\n */\nexport interface X402EventData {\n connect: WalletState;\n disconnect: void;\n chainChanged: { chainId: number; chainName: string };\n accountChanged: { address: string };\n balanceChanged: { balance: string };\n paymentStarted: { amount: string; network: string };\n paymentSigned: { paymentHeader: string };\n paymentCompleted: PaymentResult;\n paymentFailed: { error: string; code: X402ErrorCode };\n}\n\n/**\n * Event handler type\n */\nexport type X402EventHandler<E extends X402Event> = (data: X402EventData[E]) => void;\n\n// ============================================================================\n// ERROR TYPES\n// ============================================================================\n\n/**\n * Error codes for categorizing errors\n */\nexport type X402ErrorCode =\n | 'WALLET_NOT_FOUND'\n | 'WALLET_NOT_CONNECTED'\n | 'WALLET_CONNECTION_REJECTED'\n | 'WALLET_CONNECTION_TIMEOUT'\n | 'CHAIN_NOT_SUPPORTED'\n | 'CHAIN_SWITCH_REJECTED'\n | 'INSUFFICIENT_BALANCE'\n | 'SIGNATURE_REJECTED'\n | 'PAYMENT_FAILED'\n | 'PAYMENT_TIMEOUT'\n | 'NETWORK_ERROR'\n | 'INVALID_CONFIG'\n | 'INVALID_AMOUNT'\n | 'INVALID_RECIPIENT'\n | 'UNKNOWN_ERROR';\n\n/**\n * SDK-specific error class\n */\nexport class X402Error extends Error {\n public readonly code: X402ErrorCode;\n public readonly details?: unknown;\n\n constructor(message: string, code: X402ErrorCode, details?: unknown) {\n super(message);\n this.name = 'X402Error';\n this.code = code;\n this.details = details;\n\n // Maintains proper stack trace for where error was thrown (V8 engines)\n if (Error.captureStackTrace) {\n Error.captureStackTrace(this, X402Error);\n }\n }\n}\n","/**\n * uvd-x402-sdk - Chain Registry\n *\n * Complete configuration for all 15 supported blockchain networks.\n * EVM chains (11): Use ERC-3009 TransferWithAuthorization\n * SVM chains (2): Solana and Fogo - Use SPL tokens with partially-signed transactions\n * Stellar (1): Uses Soroban authorization entries\n * NEAR (1): Uses NEP-366 meta-transactions\n */\n\nimport type { ChainConfig, NetworkType, TokenType, TokenConfig } from '../types';\n\n/**\n * Default facilitator URL for x402 payments\n */\nexport const DEFAULT_FACILITATOR_URL = 'https://facilitator.ultravioletadao.xyz';\n\n/**\n * All supported chains configuration\n *\n * To add a new chain:\n * 1. Add chain config below with all required fields\n * 2. Verify USDC contract supports ERC-3009 (transferWithAuthorization) for EVM chains\n * 3. Test on testnet first before enabling\n */\nexport const SUPPORTED_CHAINS: Record<string, ChainConfig> = {\n // ============================================================================\n // EVM CHAINS (10 networks)\n // ============================================================================\n\n base: {\n chainId: 8453,\n chainIdHex: '0x2105',\n name: 'base',\n displayName: 'Base',\n networkType: 'evm',\n rpcUrl: 'https://mainnet.base.org',\n explorerUrl: 'https://basescan.org',\n nativeCurrency: {\n name: 'Ethereum',\n symbol: 'ETH',\n decimals: 18,\n },\n usdc: {\n address: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',\n decimals: 6,\n name: 'USD Coin',\n version: '2',\n },\n tokens: {\n usdc: {\n address: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',\n decimals: 6,\n name: 'USD Coin',\n version: '2',\n },\n eurc: {\n address: '0x60a3E35Cc302bFA44Cb288Bc5a4F316Fdb1adb42',\n decimals: 6,\n name: 'EURC',\n version: '2',\n },\n gho: {\n address: '0x6Bb7a212910682DCFdbd5BCBb3e28FB4E8da10Ee',\n decimals: 18,\n name: 'Gho Token',\n version: '1',\n },\n },\n x402: {\n facilitatorUrl: DEFAULT_FACILITATOR_URL,\n enabled: true,\n },\n },\n\n avalanche: {\n chainId: 43114,\n chainIdHex: '0xa86a',\n name: 'avalanche',\n displayName: 'Avalanche C-Chain',\n networkType: 'evm',\n rpcUrl: 'https://avalanche-c-chain-rpc.publicnode.com',\n explorerUrl: 'https://snowtrace.io',\n nativeCurrency: {\n name: 'Avalanche',\n symbol: 'AVAX',\n decimals: 18,\n },\n usdc: {\n address: '0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E',\n decimals: 6,\n name: 'USD Coin',\n version: '2',\n },\n tokens: {\n usdc: {\n address: '0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E',\n decimals: 6,\n name: 'USD Coin',\n version: '2',\n },\n eurc: {\n address: '0xC891EB4cbdEFf6e073e859e987815Ed1505c2ACD',\n decimals: 6,\n name: 'EURC',\n version: '2',\n },\n ausd: {\n address: '0x00000000eFE302BEAA2b3e6e1b18d08D69a9012a',\n decimals: 6,\n name: 'Agora USD',\n version: '1',\n },\n },\n x402: {\n facilitatorUrl: DEFAULT_FACILITATOR_URL,\n enabled: true,\n },\n },\n\n ethereum: {\n chainId: 1,\n chainIdHex: '0x1',\n name: 'ethereum',\n displayName: 'Ethereum',\n networkType: 'evm',\n rpcUrl: 'https://eth.llamarpc.com',\n explorerUrl: 'https://etherscan.io',\n nativeCurrency: {\n name: 'Ethereum',\n symbol: 'ETH',\n decimals: 18,\n },\n usdc: {\n address: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48',\n decimals: 6,\n name: 'USD Coin',\n version: '2',\n },\n tokens: {\n usdc: {\n address: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48',\n decimals: 6,\n name: 'USD Coin',\n version: '2',\n },\n eurc: {\n address: '0x1aBaEA1f7C830bD89Acc67eC4af516284b1bC33c',\n decimals: 6,\n name: 'EURC',\n version: '2',\n },\n ausd: {\n address: '0x00000000eFE302BEAA2b3e6e1b18d08D69a9012a',\n decimals: 6,\n name: 'Agora USD',\n version: '1',\n },\n pyusd: {\n address: '0x6c3ea9036406852006290770BEdFcAbA0e23A0e8',\n decimals: 6,\n name: 'PayPal USD',\n version: '1',\n },\n gho: {\n address: '0x40D16FC0246aD3160Ccc09B8D0D3A2cD28aE6C2f',\n decimals: 18,\n name: 'Gho Token',\n version: '1',\n },\n crvusd: {\n address: '0xf939E0A03FB07F59A73314E73794Be0E57ac1b4E',\n decimals: 18,\n name: 'Curve.Fi USD Stablecoin',\n version: '1',\n },\n },\n x402: {\n facilitatorUrl: DEFAULT_FACILITATOR_URL,\n enabled: true,\n },\n },\n\n polygon: {\n chainId: 137,\n chainIdHex: '0x89',\n name: 'polygon',\n displayName: 'Polygon',\n networkType: 'evm',\n rpcUrl: 'https://polygon-rpc.com',\n explorerUrl: 'https://polygonscan.com',\n nativeCurrency: {\n name: 'Polygon',\n symbol: 'POL',\n decimals: 18,\n },\n usdc: {\n address: '0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359',\n decimals: 6,\n name: 'USD Coin',\n version: '2',\n },\n tokens: {\n usdc: {\n address: '0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359',\n decimals: 6,\n name: 'USD Coin',\n version: '2',\n },\n ausd: {\n address: '0x00000000eFE302BEAA2b3e6e1b18d08D69a9012a',\n decimals: 6,\n name: 'Agora USD',\n version: '1',\n },\n },\n x402: {\n facilitatorUrl: DEFAULT_FACILITATOR_URL,\n enabled: true,\n },\n },\n\n arbitrum: {\n chainId: 42161,\n chainIdHex: '0xa4b1',\n name: 'arbitrum',\n displayName: 'Arbitrum One',\n networkType: 'evm',\n rpcUrl: 'https://arb1.arbitrum.io/rpc',\n explorerUrl: 'https://arbiscan.io',\n nativeCurrency: {\n name: 'Ethereum',\n symbol: 'ETH',\n decimals: 18,\n },\n usdc: {\n address: '0xaf88d065e77c8cC2239327C5EDb3A432268e5831',\n decimals: 6,\n name: 'USD Coin',\n version: '2',\n },\n tokens: {\n usdc: {\n address: '0xaf88d065e77c8cC2239327C5EDb3A432268e5831',\n decimals: 6,\n name: 'USD Coin',\n version: '2',\n },\n ausd: {\n address: '0x00000000eFE302BEAA2b3e6e1b18d08D69a9012a',\n decimals: 6,\n name: 'Agora USD',\n version: '1',\n },\n gho: {\n address: '0x7dfF72693f6A4149b17e7C6314655f6A9F7c8B33',\n decimals: 18,\n name: 'Gho Token',\n version: '1',\n },\n crvusd: {\n address: '0x498Bf2B1e120FeD3ad3D42EA2165E9b73f99C1e5',\n decimals: 18,\n name: 'Curve.Fi USD Stablecoin',\n version: '1',\n },\n },\n x402: {\n facilitatorUrl: DEFAULT_FACILITATOR_URL,\n enabled: true,\n },\n },\n\n optimism: {\n chainId: 10,\n chainIdHex: '0xa',\n name: 'optimism',\n displayName: 'Optimism',\n networkType: 'evm',\n rpcUrl: 'https://mainnet.optimism.io',\n explorerUrl: 'https://optimistic.etherscan.io',\n nativeCurrency: {\n name: 'Ethereum',\n symbol: 'ETH',\n decimals: 18,\n },\n usdc: {\n address: '0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85',\n decimals: 6,\n name: 'USD Coin',\n version: '2',\n },\n tokens: {\n usdc: {\n address: '0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85',\n decimals: 6,\n name: 'USD Coin',\n version: '2',\n },\n },\n x402: {\n facilitatorUrl: DEFAULT_FACILITATOR_URL,\n enabled: true,\n },\n },\n\n celo: {\n chainId: 42220,\n chainIdHex: '0xa4ec',\n name: 'celo',\n displayName: 'Celo',\n networkType: 'evm',\n rpcUrl: 'https://forno.celo.org',\n explorerUrl: 'https://celoscan.io',\n nativeCurrency: {\n name: 'Celo',\n symbol: 'CELO',\n decimals: 18,\n },\n usdc: {\n address: '0xcebA9300f2b948710d2653dD7B07f33A8B32118C',\n decimals: 6,\n name: 'USDC', // Celo uses \"USDC\" not \"USD Coin\" for EIP-712\n version: '2',\n },\n tokens: {\n usdc: {\n address: '0xcebA9300f2b948710d2653dD7B07f33A8B32118C',\n decimals: 6,\n name: 'USDC', // Celo uses \"USDC\" not \"USD Coin\" for EIP-712\n version: '2',\n },\n },\n x402: {\n facilitatorUrl: DEFAULT_FACILITATOR_URL,\n enabled: true,\n },\n },\n\n hyperevm: {\n chainId: 999,\n chainIdHex: '0x3e7',\n name: 'hyperevm',\n displayName: 'HyperEVM',\n networkType: 'evm',\n rpcUrl: 'https://rpc.hyperliquid.xyz/evm',\n explorerUrl: 'https://hyperevmscan.io',\n nativeCurrency: {\n name: 'Ethereum',\n symbol: 'ETH',\n decimals: 18,\n },\n usdc: {\n address: '0xb88339CB7199b77E23DB6E890353E22632Ba630f',\n decimals: 6,\n name: 'USDC', // HyperEVM uses \"USDC\" not \"USD Coin\"\n version: '2',\n },\n tokens: {\n usdc: {\n address: '0xb88339CB7199b77E23DB6E890353E22632Ba630f',\n decimals: 6,\n name: 'USDC', // HyperEVM uses \"USDC\" not \"USD Coin\"\n version: '2',\n },\n },\n x402: {\n facilitatorUrl: DEFAULT_FACILITATOR_URL,\n enabled: true,\n },\n },\n\n unichain: {\n chainId: 130,\n chainIdHex: '0x82',\n name: 'unichain',\n displayName: 'Unichain',\n networkType: 'evm',\n rpcUrl: 'https://unichain-rpc.publicnode.com',\n explorerUrl: 'https://uniscan.xyz',\n nativeCurrency: {\n name: 'Ethereum',\n symbol: 'ETH',\n decimals: 18,\n },\n usdc: {\n address: '0x078d782b760474a361dda0af3839290b0ef57ad6',\n decimals: 6,\n name: 'USDC', // Unichain uses \"USDC\" not \"USD Coin\"\n version: '2',\n },\n tokens: {\n usdc: {\n address: '0x078d782b760474a361dda0af3839290b0ef57ad6',\n decimals: 6,\n name: 'USDC', // Unichain uses \"USDC\" not \"USD Coin\"\n version: '2',\n },\n },\n x402: {\n facilitatorUrl: DEFAULT_FACILITATOR_URL,\n enabled: true,\n },\n },\n\n monad: {\n chainId: 143,\n chainIdHex: '0x8f',\n name: 'monad',\n displayName: 'Monad',\n networkType: 'evm',\n rpcUrl: 'https://rpc.monad.xyz',\n explorerUrl: 'https://monad.socialscan.io',\n nativeCurrency: {\n name: 'Monad',\n symbol: 'MON',\n decimals: 18,\n },\n usdc: {\n address: '0x754704bc059f8c67012fed69bc8a327a5aafb603',\n decimals: 6,\n name: 'USDC', // Monad uses \"USDC\" not \"USD Coin\"\n version: '2',\n },\n tokens: {\n usdc: {\n address: '0x754704bc059f8c67012fed69bc8a327a5aafb603',\n decimals: 6,\n name: 'USDC', // Monad uses \"USDC\" not \"USD Coin\"\n version: '2',\n },\n ausd: {\n address: '0x00000000eFE302BEAA2b3e6e1b18d08D69a9012a',\n decimals: 6,\n name: 'Agora USD',\n version: '1',\n },\n },\n x402: {\n facilitatorUrl: DEFAULT_FACILITATOR_URL,\n enabled: true,\n },\n },\n\n // ============================================================================\n // SVM CHAINS (2 networks) - Solana Virtual Machine\n // ============================================================================\n\n solana: {\n chainId: 0, // Non-EVM\n chainIdHex: '0x0',\n name: 'solana',\n displayName: 'Solana',\n networkType: 'svm',\n rpcUrl: 'https://api.mainnet-beta.solana.com',\n explorerUrl: 'https://solscan.io',\n nativeCurrency: {\n name: 'Solana',\n symbol: 'SOL',\n decimals: 9,\n },\n usdc: {\n address: 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v', // USDC SPL token mint\n decimals: 6,\n name: 'USD Coin',\n version: '1',\n },\n x402: {\n facilitatorUrl: DEFAULT_FACILITATOR_URL,\n enabled: true,\n },\n },\n\n fogo: {\n chainId: 0, // Non-EVM (SVM)\n chainIdHex: '0x0',\n name: 'fogo',\n displayName: 'Fogo',\n networkType: 'svm',\n rpcUrl: 'https://rpc.fogo.nightly.app/',\n explorerUrl: 'https://explorer.fogo.nightly.app',\n nativeCurrency: {\n name: 'Fogo',\n symbol: 'FOGO',\n decimals: 9,\n },\n usdc: {\n address: 'uSd2czE61Evaf76RNbq4KPpXnkiL3irdzgLFUMe3NoG', // Fogo USDC mint\n decimals: 6,\n name: 'USDC',\n version: '1',\n },\n x402: {\n facilitatorUrl: DEFAULT_FACILITATOR_URL,\n enabled: true,\n },\n },\n\n // ============================================================================\n // STELLAR (1 network)\n // ============================================================================\n\n stellar: {\n chainId: 0, // Non-EVM\n chainIdHex: '0x0',\n name: 'stellar',\n displayName: 'Stellar',\n networkType: 'stellar',\n rpcUrl: 'https://horizon.stellar.org',\n explorerUrl: 'https://stellar.expert/explorer/public',\n nativeCurrency: {\n name: 'Lumens',\n symbol: 'XLM',\n decimals: 7, // Stellar uses 7 decimals (stroops)\n },\n usdc: {\n address: 'CCW67TSZV3SSS2HXMBQ5JFGCKJNXKZM7UQUWUZPUTHXSTZLEO7SJMI75', // Soroban Asset Contract\n decimals: 7, // Stellar USDC uses 7 decimals\n name: 'USDC',\n version: '1',\n },\n x402: {\n facilitatorUrl: DEFAULT_FACILITATOR_URL,\n enabled: true,\n },\n },\n\n // ============================================================================\n // NEAR (1 network) - Uses NEP-366 meta-transactions\n // ============================================================================\n\n near: {\n chainId: 0, // Non-EVM\n chainIdHex: '0x0',\n name: 'near',\n displayName: 'NEAR Protocol',\n networkType: 'near',\n rpcUrl: 'https://rpc.mainnet.near.org',\n explorerUrl: 'https://nearblocks.io',\n nativeCurrency: {\n name: 'NEAR',\n symbol: 'NEAR',\n decimals: 24, // NEAR uses 24 decimals (yoctoNEAR)\n },\n usdc: {\n address: '17208628f84f5d6ad33f0da3bbbeb27ffcb398eac501a31bd6ad2011e36133a1', // Native Circle USDC\n decimals: 6,\n name: 'USDC',\n version: '1',\n },\n x402: {\n facilitatorUrl: DEFAULT_FACILITATOR_URL,\n enabled: true, // NEP-366 meta-transactions supported\n },\n },\n};\n\n/**\n * Default chain for new users\n */\nexport const DEFAULT_CHAIN = 'base';\n\n/**\n * Get chain config by chain ID\n */\nexport function getChainById(chainId: number): ChainConfig | undefined {\n return Object.values(SUPPORTED_CHAINS).find(chain => chain.chainId === chainId);\n}\n\n/**\n * Get chain config by name (case-insensitive)\n */\nexport function getChainByName(name: string): ChainConfig | undefined {\n return SUPPORTED_CHAINS[name.toLowerCase()];\n}\n\n/**\n * Check if a chain is supported\n */\nexport function isChainSupported(chainIdOrName: number | string): boolean {\n if (typeof chainIdOrName === 'number') {\n return Object.values(SUPPORTED_CHAINS).some(chain => chain.chainId === chainIdOrName);\n }\n return chainIdOrName.toLowerCase() in SUPPORTED_CHAINS;\n}\n\n/**\n * Get list of enabled chains\n */\nexport function getEnabledChains(): ChainConfig[] {\n return Object.values(SUPPORTED_CHAINS).filter(chain => chain.x402.enabled);\n}\n\n/**\n * Get list of chains by network type\n */\nexport function getChainsByNetworkType(networkType: NetworkType): ChainConfig[] {\n return Object.values(SUPPORTED_CHAINS).filter(\n chain => chain.networkType === networkType && chain.x402.enabled\n );\n}\n\n/**\n * Get all EVM chain IDs (for wallet_switchEthereumChain)\n */\nexport function getEVMChainIds(): number[] {\n return getChainsByNetworkType('evm').map(chain => chain.chainId);\n}\n\n/**\n * Get list of SVM chains (Solana, Fogo)\n */\nexport function getSVMChains(): ChainConfig[] {\n return Object.values(SUPPORTED_CHAINS).filter(\n chain => chain.networkType === 'svm' && chain.x402.enabled\n );\n}\n\n/**\n * Check if a chain is SVM-based (Solana Virtual Machine)\n */\nexport function isSVMChain(chainName: string): boolean {\n const chain = getChainByName(chainName);\n return chain?.networkType === 'svm';\n}\n\n/**\n * Get network type from chain name\n */\nexport function getNetworkType(chainName: string): NetworkType | undefined {\n const chain = getChainByName(chainName);\n return chain?.networkType;\n}\n\n/**\n * Format transaction URL for block explorer\n */\nexport function getExplorerTxUrl(chainName: string, txHash: string): string | null {\n const chain = getChainByName(chainName);\n if (!chain) return null;\n\n switch (chain.networkType) {\n case 'evm':\n return `${chain.explorerUrl}/tx/${txHash}`;\n case 'svm':\n case 'solana': // @deprecated\n return `${chain.explorerUrl}/tx/${txHash}`;\n case 'stellar':\n return `${chain.explorerUrl}/tx/${txHash}`;\n case 'near':\n return `${chain.explorerUrl}/txns/${txHash}`;\n default:\n return null;\n }\n}\n\n/**\n * Format address URL for block explorer\n */\nexport function getExplorerAddressUrl(chainName: string, address: string): string | null {\n const chain = getChainByName(chainName);\n if (!chain) return null;\n\n switch (chain.networkType) {\n case 'evm':\n return `${chain.explorerUrl}/address/${address}`;\n case 'svm':\n case 'solana': // @deprecated\n return `${chain.explorerUrl}/account/${address}`;\n case 'stellar':\n return `${chain.explorerUrl}/account/${address}`;\n case 'near':\n return `${chain.explorerUrl}/address/${address}`;\n default:\n return null;\n }\n}\n\n// ============================================================================\n// MULTI-TOKEN SUPPORT FUNCTIONS\n// ============================================================================\n\n/**\n * Get token configuration for a specific chain and token type\n * Falls back to USDC config if token not found (for backward compatibility)\n *\n * @param chainName - Chain name (e.g., 'ethereum', 'base')\n * @param tokenType - Token type (e.g., 'usdc', 'eurc', 'gho')\n * @returns Token configuration or undefined if chain not found\n */\nexport function getTokenConfig(\n chainName: string,\n tokenType: TokenType = 'usdc'\n): TokenConfig | undefined {\n const chain = getChainByName(chainName);\n if (!chain) return undefined;\n\n // Try to get from tokens map first (new multi-token support)\n if (chain.tokens && chain.tokens[tokenType]) {\n return chain.tokens[tokenType];\n }\n\n // Fall back to usdc config for backward compatibility\n if (tokenType === 'usdc') {\n return chain.usdc;\n }\n\n return undefined;\n}\n\n/**\n * Get list of supported tokens for a chain\n *\n * @param chainName - Chain name (e.g., 'ethereum', 'base')\n * @returns Array of supported token types, or empty array if chain not found\n */\nexport function getSupportedTokens(chainName: string): TokenType[] {\n const chain = getChainByName(chainName);\n if (!chain) return [];\n\n // If tokens map exists, return its keys\n if (chain.tokens) {\n return Object.keys(chain.tokens) as TokenType[];\n }\n\n // Default to just USDC for chains without explicit tokens map\n return ['usdc'];\n}\n\n/**\n * Check if a token is supported on a specific chain\n *\n * @param chainName - Chain name (e.g., 'ethereum', 'base')\n * @param tokenType - Token type (e.g., 'usdc', 'eurc', 'gho')\n * @returns true if token is supported on the chain\n */\nexport function isTokenSupported(chainName: string, tokenType: TokenType): boolean {\n const chain = getChainByName(chainName);\n if (!chain) return false;\n\n // Check tokens map\n if (chain.tokens && chain.tokens[tokenType]) {\n return true;\n }\n\n // USDC is always supported (backward compatibility)\n if (tokenType === 'usdc') {\n return true;\n }\n\n return false;\n}\n\n/**\n * Get all chains that support a specific token\n *\n * @param tokenType - Token type (e.g., 'usdc', 'eurc', 'gho')\n * @returns Array of chain configs that support the token\n */\nexport function getChainsByToken(tokenType: TokenType): ChainConfig[] {\n return Object.values(SUPPORTED_CHAINS).filter(chain => {\n if (!chain.x402.enabled) return false;\n if (chain.tokens && chain.tokens[tokenType]) return true;\n if (tokenType === 'usdc') return true; // USDC is universal\n return false;\n });\n}\n","/**\n * uvd-x402-sdk - SVM Provider (Solana Virtual Machine)\n *\n * Provides wallet connection and payment creation for SVM-based chains via Phantom.\n * Supports: Solana, Fogo\n * Uses partially-signed transactions where the facilitator is the fee payer.\n *\n * @example Solana\n * ```ts\n * import { SVMProvider } from 'uvd-x402-sdk/solana';\n * import { getChainByName } from 'uvd-x402-sdk';\n *\n * const svm = new SVMProvider();\n *\n * // Connect\n * const address = await svm.connect();\n *\n * // Create Solana payment\n * const chainConfig = getChainByName('solana')!;\n * const paymentPayload = await svm.signPayment(paymentInfo, chainConfig);\n * const header = svm.encodePaymentHeader(paymentPayload, chainConfig);\n * ```\n *\n * @example Fogo\n * ```ts\n * import { SVMProvider } from 'uvd-x402-sdk/solana';\n * import { getChainByName } from 'uvd-x402-sdk';\n *\n * const svm = new SVMProvider();\n *\n * // Connect (same wallet works for all SVM chains)\n * const address = await svm.connect();\n *\n * // Create Fogo payment\n * const chainConfig = getChainByName('fogo')!;\n * const paymentPayload = await svm.signPayment(paymentInfo, chainConfig);\n * const header = svm.encodePaymentHeader(paymentPayload, chainConfig);\n * ```\n */\n\nimport type {\n ChainConfig,\n PaymentInfo,\n SolanaPaymentPayload,\n WalletAdapter,\n} from '../../types';\nimport { X402Error } from '../../types';\nimport { getChainByName } from '../../chains';\n\n/**\n * Browser-compatible base64 encoding for Uint8Array\n * Avoids Node.js Buffer dependency for browser bundlers\n */\nfunction uint8ArrayToBase64(bytes: Uint8Array): string {\n let binary = '';\n for (let i = 0; i < bytes.length; i++) {\n binary += String.fromCharCode(bytes[i]);\n }\n return btoa(binary);\n}\n\n// Lazy import Solana dependencies to avoid bundling when not used\nlet Connection: typeof import('@solana/web3.js').Connection;\nlet PublicKey: typeof import('@solana/web3.js').PublicKey;\nlet TransactionMessage: typeof import('@solana/web3.js').TransactionMessage;\nlet VersionedTransaction: typeof import('@solana/web3.js').VersionedTransaction;\nlet ComputeBudgetProgram: typeof import('@solana/web3.js').ComputeBudgetProgram;\nlet getAssociatedTokenAddress: typeof import('@solana/spl-token').getAssociatedTokenAddress;\nlet createTransferCheckedInstruction: typeof import('@solana/spl-token').createTransferCheckedInstruction;\nlet createAssociatedTokenAccountIdempotentInstruction: typeof import('@solana/spl-token').createAssociatedTokenAccountIdempotentInstruction;\nlet TOKEN_PROGRAM_ID: typeof import('@solana/spl-token').TOKEN_PROGRAM_ID;\n\nasync function loadSolanaDeps() {\n if (!Connection) {\n const web3 = await import('@solana/web3.js');\n const splToken = await import('@solana/spl-token');\n Connection = web3.Connection;\n PublicKey = web3.PublicKey;\n TransactionMessage = web3.TransactionMessage;\n VersionedTransaction = web3.VersionedTransaction;\n ComputeBudgetProgram = web3.ComputeBudgetProgram;\n getAssociatedTokenAddress = splToken.getAssociatedTokenAddress;\n createTransferCheckedInstruction = splToken.createTransferCheckedInstruction;\n createAssociatedTokenAccountIdempotentInstruction = splToken.createAssociatedTokenAccountIdempotentInstruction;\n TOKEN_PROGRAM_ID = splToken.TOKEN_PROGRAM_ID;\n }\n}\n\n/**\n * Phantom wallet provider interface\n */\ninterface PhantomProvider {\n isPhantom?: boolean;\n isConnected?: boolean;\n publicKey?: { toBase58(): string };\n connect(): Promise<{ publicKey: { toBase58(): string } }>;\n disconnect(): Promise<void>;\n signTransaction<T>(transaction: T): Promise<T>;\n}\n\n/**\n * SVMProvider - Wallet adapter for SVM chains (Solana, Fogo) via Phantom\n *\n * @alias SolanaProvider for backward compatibility\n */\nexport class SVMProvider implements WalletAdapter {\n readonly id = 'phantom';\n readonly name = 'Phantom';\n readonly networkType = 'svm' as const;\n\n private provider: PhantomProvider | null = null;\n private publicKey: InstanceType<typeof PublicKey> | null = null;\n private connections: Map<string, InstanceType<typeof Connection>> = new Map();\n private address: string | null = null;\n\n /**\n * Check if Phantom wallet is available\n */\n isAvailable(): boolean {\n if (typeof window === 'undefined') return false;\n return !!(\n (window as Window & { phantom?: { solana?: PhantomProvider } }).phantom?.solana?.isPhantom ||\n (window as Window & { solana?: PhantomProvider }).solana?.isPhantom\n );\n }\n\n /**\n * Connect to Phantom wallet\n */\n async connect(): Promise<string> {\n await loadSolanaDeps();\n\n // Get Phantom provider\n this.provider = await this.getPhantomProvider();\n if (!this.provider) {\n throw new X402Error(\n 'Phantom wallet not installed. Please install from phantom.app',\n 'WALLET_NOT_FOUND'\n );\n }\n\n try {\n // Check if already connected\n if (this.provider.publicKey && this.provider.isConnected) {\n const publicKeyString = this.provider.publicKey.toBase58();\n this.publicKey = new PublicKey(publicKeyString);\n this.address = publicKeyString;\n await this.initConnection();\n return publicKeyString;\n }\n\n // Connect\n const resp = await this.provider.connect();\n const publicKeyString = resp.publicKey.toBase58();\n\n this.publicKey = new PublicKey(publicKeyString);\n this.address = publicKeyString;\n\n await this.initConnection();\n\n return publicKeyString;\n } catch (error: unknown) {\n if (error instanceof Error) {\n if (error.message.includes('User rejected') || (error as { code?: number }).code === 4001) {\n throw new X402Error('Connection rejected by user', 'WALLET_CONNECTION_REJECTED');\n }\n }\n throw new X402Error(\n `Failed to connect Phantom: ${error instanceof Error ? error.message : 'Unknown error'}`,\n 'UNKNOWN_ERROR',\n error\n );\n }\n }\n\n /**\n * Disconnect from Phantom\n */\n async disconnect(): Promise<void> {\n if (this.provider) {\n try {\n await this.provider.disconnect();\n } catch {\n // Ignore disconnect errors\n }\n }\n this.provider = null;\n this.publicKey = null;\n this.connections.clear();\n this.address = null;\n }\n\n /**\n * Get current address\n */\n getAddress(): string | null {\n return this.address;\n }\n\n /**\n * Get USDC balance\n */\n async getBalance(chainConfig: ChainConfig): Promise<string> {\n await loadSolanaDeps();\n\n if (!this.address) {\n throw new X402Error('Wallet not connected', 'WALLET_NOT_CONNECTED');\n }\n\n await this.initConnection(chainConfig);\n const connection = this.connections.get(chainConfig.name);\n if (!connection) {\n throw new X402Error('Failed to connect to Solana RPC', 'NETWORK_ERROR');\n }\n\n try {\n const response = await fetch(chainConfig.rpcUrl, {\n method: 'POST',\n headers: { 'Content-Type': 'application/json' },\n body: JSON.stringify({\n jsonrpc: '2.0',\n id: 1,\n method: 'getTokenAccountsByOwner',\n params: [\n this.address,\n { mint: chainConfig.usdc.address },\n { encoding: 'jsonParsed' },\n ],\n }),\n });\n\n const data = await response.json();\n\n if (!data.result?.value?.length) {\n return '0.00';\n }\n\n const tokenAccountInfo = data.result.value[0].account.data.parsed.info;\n const balance = Number(tokenAccountInfo.tokenAmount.amount) / Math.pow(10, tokenAccountInfo.tokenAmount.decimals);\n\n return balance.toFixed(2);\n } catch {\n return '0.00';\n }\n }\n\n /**\n * Create SVM payment (partially-signed transaction)\n *\n * Works for both Solana and Fogo chains.\n *\n * Transaction structure required by facilitator:\n * 1. SetComputeUnitLimit\n * 2. SetComputeUnitPrice\n * 3. (Optional) CreateAssociatedTokenAccount if recipient ATA doesn't exist\n * 4. TransferChecked (USDC transfer)\n *\n * Fee payer: Facilitator (not user)\n * User pays: ZERO SOL/FOGO\n */\n async signPayment(paymentInfo: PaymentInfo, chainConfig: ChainConfig): Promise<string> {\n await loadSolanaDeps();\n\n if (!this.provider || !this.publicKey || !this.address) {\n throw new X402Error('Wallet not connected', 'WALLET_NOT_CONNECTED');\n }\n\n const connection = await this.getConnection(chainConfig);\n if (!connection) {\n throw new X402Error(`Failed to connect to ${chainConfig.displayName} RPC`, 'NETWORK_ERROR');\n }\n\n // Get recipient and facilitator addresses\n const recipient = paymentInfo.recipients?.solana || paymentInfo.recipient;\n const facilitatorAddress = paymentInfo.facilitator;\n\n if (!facilitatorAddress) {\n throw new X402Error('Facilitator address not provided', 'INVALID_CONFIG');\n }\n\n const recipientPubkey = new PublicKey(recipient);\n const facilitatorPubkey = new PublicKey(facilitatorAddress);\n const usdcMint = new PublicKey(chainConfig.usdc.address);\n\n // Parse amount (6 decimals for USDC)\n const amount = Math.floor(parseFloat(paymentInfo.amount) * 1_000_000);\n\n // Get token accounts\n const fromTokenAccount = await getAssociatedTokenAddress(\n usdcMint,\n this.publicKey,\n true,\n TOKEN_PROGRAM_ID\n );\n\n const toTokenAccount = await getAssociatedTokenAddress(\n usdcMint,\n recipientPubkey,\n true,\n TOKEN_PROGRAM_ID\n );\n\n // Check if recipient ATA exists\n const toTokenAccountInfo = await connection.getAccountInfo(toTokenAccount);\n const needsATACreation = toTokenAccountInfo === null;\n\n // Get recent blockhash\n const { blockhash } = await connection.getLatestBlockhash('finalized');\n\n // Build instructions in exact order required by facilitator\n const instructions = [];\n\n // Instruction 0: SetComputeUnitLimit\n instructions.push(\n ComputeBudgetProgram.setComputeUnitLimit({\n units: needsATACreation ? 50_000 : 20_000,\n })\n );\n\n // Instruction 1: SetComputeUnitPrice\n // Use 100k microlamports/CU for fast landing on mainnet\n // Lower values (like 1) cause transactions to be deprioritized and time out\n instructions.push(\n ComputeBudgetProgram.setComputeUnitPrice({\n microLamports: 100_000,\n })\n );\n\n // Instruction 2 (optional): CreateAssociatedTokenAccountIdempotent\n // User pays for ATA creation (not facilitator - security check in x402-rs)\n if (needsATACreation) {\n instructions.push(\n createAssociatedTokenAccountIdempotentInstruction(\n this.publicKey, // User pays for ATA creation\n toTokenAccount,\n recipientPubkey,\n usdcMint,\n TOKEN_PROGRAM_ID\n )\n );\n }\n\n // Instruction 2/3: TransferChecked\n instructions.push(\n createTransferCheckedInstruction(\n fromTokenAccount,\n usdcMint,\n toTokenAccount,\n this.publicKey,\n amount,\n 6,\n [],\n TOKEN_PROGRAM_ID\n )\n );\n\n // Build VersionedTransaction with facilitator as fee payer\n const messageV0 = new TransactionMessage({\n payerKey: facilitatorPubkey,\n recentBlockhash: blockhash,\n instructions,\n }).compileToV0Message();\n\n const transaction = new VersionedTransaction(messageV0);\n\n // User signs (partial signature - facilitator will co-sign)\n // IMPORTANT: Phantom may modify the transaction (add memo instruction).\n // We send the FULL signed transaction to the facilitator, which will use it\n // exactly as signed (not reconstruct it). This ensures signature validity.\n let signedTransaction: InstanceType<typeof VersionedTransaction>;\n try {\n signedTransaction = await this.provider.signTransaction(transaction);\n } catch (error: unknown) {\n if (error instanceof Error && error.message.includes('User rejected')) {\n throw new X402Error('Signature rejected by user', 'SIGNATURE_REJECTED');\n }\n throw new X402Error(\n `Failed to sign transaction: ${error instanceof Error ? error.message : 'Unknown error'}`,\n 'PAYMENT_FAILED',\n error\n );\n }\n\n // Serialize the FULL signed transaction (including any wallet modifications)\n // The facilitator will use this exact transaction, adding only its signature\n const serialized = signedTransaction.serialize();\n\n const payload: SolanaPaymentPayload = {\n transaction: uint8ArrayToBase64(serialized),\n };\n\n return JSON.stringify(payload);\n }\n\n /**\n * Encode SVM payment as X-PAYMENT header\n *\n * @param paymentPayload - The payment payload JSON string\n * @param chainConfig - Optional chain config (defaults to 'solana' if not provided)\n */\n encodePaymentHeader(paymentPayload: string, chainConfig?: ChainConfig): string {\n const payload = JSON.parse(paymentPayload) as SolanaPaymentPayload;\n\n // Use chain name from config, or default to 'solana' for backward compatibility\n const networkName = chainConfig?.name || 'solana';\n\n const x402Payload = {\n x402Version: 1,\n scheme: 'exact',\n network: networkName,\n payload: {\n transaction: payload.transaction,\n },\n };\n\n return btoa(JSON.stringify(x402Payload));\n }\n\n // Private helpers\n\n private async getPhantomProvider(): Promise<PhantomProvider | null> {\n if (typeof window === 'undefined') return null;\n\n // Try window.phantom.solana first\n const win = window as Window & {\n phantom?: { solana?: PhantomProvider };\n solana?: PhantomProvider;\n };\n\n if (win.phantom?.solana?.isPhantom) {\n return win.phantom.solana;\n }\n\n // Fallback to window.solana\n if (win.solana?.isPhantom) {\n return win.solana;\n }\n\n // Wait a bit for Phantom to inject itself\n for (let i = 0; i < 5; i++) {\n await new Promise(resolve => setTimeout(resolve, 100));\n if (win.phantom?.solana?.isPhantom) {\n return win.phantom.solana;\n }\n if (win.solana?.isPhantom) {\n return win.solana;\n }\n }\n\n return null;\n }\n\n /**\n * Get or create a connection for a specific chain\n *\n * IMPORTANT: Caches by RPC URL, not chain name. This allows consumers to\n * override the RPC URL (e.g., use Helius instead of public RPC) and get\n * a fresh connection with their custom RPC.\n */\n private async getConnection(chainConfig?: ChainConfig): Promise<InstanceType<typeof Connection>> {\n await loadSolanaDeps();\n\n const config = chainConfig || getChainByName('solana');\n if (!config) {\n throw new X402Error('Chain config not found', 'CHAIN_NOT_SUPPORTED');\n }\n\n // Cache by RPC URL, not chain name - allows custom RPC overrides\n const cacheKey = config.rpcUrl;\n\n // Check if we already have a connection for this RPC\n if (this.connections.has(cacheKey)) {\n return this.connections.get(cacheKey)!;\n }\n\n // Create new connection for this RPC\n const connection = new Connection(config.rpcUrl, 'confirmed');\n this.connections.set(cacheKey, connection);\n\n return connection;\n }\n\n /**\n * @deprecated Use getConnection instead\n */\n private async initConnection(chainConfig?: ChainConfig): Promise<void> {\n await this.getConnection(chainConfig);\n }\n}\n\n/**\n * @deprecated Use SVMProvider instead\n */\nexport class SolanaProvider extends SVMProvider {\n constructor() {\n super();\n console.warn('SolanaProvider is deprecated. Use SVMProvider instead.');\n }\n}\n\n// Default export\nexport default SVMProvider;\n"]}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../../../src/types/index.ts","../../../src/providers/stellar/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * uvd-x402-sdk - Type Definitions\n *\n * Core TypeScript interfaces for the x402 payment SDK.\n * These types define the contract between the SDK and consuming applications.\n */\n\n// ============================================================================\n// CHAIN CONFIGURATION TYPES\n// ============================================================================\n\n/**\n * Network type categorization\n * - 'evm': Ethereum Virtual Machine compatible chains (use EIP-712)\n * - 'svm': Solana Virtual Machine chains (Solana, Fogo) (use SPL tokens)\n * - 'stellar': Stellar network (use Soroban)\n * - 'near': NEAR Protocol (use NEP-366)\n *\n * @deprecated 'solana' type is deprecated, use 'svm' instead\n */\nexport type NetworkType = 'evm' | 'svm' | 'solana' | 'stellar' | 'near';\n\n/**\n * USDC token configuration for a specific chain\n */\nexport interface USDCConfig {\n /** Contract/mint address */\n address: string;\n /** Token decimals (6 for most chains, 7 for Stellar) */\n decimals: number;\n /** Token name for EIP-712 domain (e.g., \"USD Coin\" or \"USDC\") */\n name: string;\n /** Token version for EIP-712 domain */\n version: string;\n}\n\n/**\n * Native currency configuration\n */\nexport interface NativeCurrency {\n name: string;\n symbol: string;\n decimals: number;\n}\n\n/**\n * Complete chain configuration\n */\nexport interface ChainConfig {\n /** Numeric chain ID (0 for non-EVM chains) */\n chainId: number;\n /** Hex-encoded chain ID for wallet_switchEthereumChain */\n chainIdHex: string;\n /** Internal chain identifier (e.g., 'base', 'solana') */\n name: string;\n /** Human-readable display name */\n displayName: string;\n /** Network type for routing */\n networkType: NetworkType;\n /** Primary RPC endpoint URL */\n rpcUrl: string;\n /** Block explorer base URL */\n explorerUrl: string;\n /** Native currency info */\n nativeCurrency: NativeCurrency;\n /** USDC token configuration */\n usdc: USDCConfig;\n /** x402 facilitator configuration */\n x402: {\n facilitatorUrl: string;\n enabled: boolean;\n };\n}\n\n// ============================================================================\n// WALLET TYPES\n// ============================================================================\n\n/**\n * Current wallet connection state\n */\nexport interface WalletState {\n /** Whether a wallet is currently connected */\n connected: boolean;\n /** Connected wallet address (null if not connected) */\n address: string | null;\n /** Current chain ID (null for non-EVM or disconnected) */\n chainId: number | null;\n /** Current network name */\n network: string | null;\n /** Network type of connected wallet */\n networkType: NetworkType | null;\n /** USDC balance on current chain (null if unknown) */\n balance: string | null;\n}\n\n/**\n * Wallet adapter interface for different wallet types\n */\nexport interface WalletAdapter {\n /** Unique identifier for this wallet type */\n readonly id: string;\n /** Display name */\n readonly name: string;\n /** Network type this adapter supports */\n readonly networkType: NetworkType;\n\n /** Check if this wallet is available/installed */\n isAvailable(): boolean;\n\n /** Connect to the wallet */\n connect(chainName?: string): Promise<string>;\n\n /** Disconnect from the wallet */\n disconnect(): Promise<void>;\n\n /** Switch to a different chain (EVM only) */\n switchChain?(chainName: string): Promise<void>;\n\n /** Sign a payment payload */\n signPayment(paymentInfo: PaymentInfo, chainConfig: ChainConfig): Promise<string>;\n\n /** Check USDC balance */\n getBalance(chainConfig: ChainConfig): Promise<string>;\n\n /** Get current address */\n getAddress(): string | null;\n\n /** Get current chain ID (EVM only) */\n getChainId?(): number | null;\n}\n\n/**\n * EIP-712 domain for typed data signing\n */\nexport interface EIP712Domain {\n name: string;\n version: string;\n chainId: number;\n verifyingContract: string;\n}\n\n/**\n * EIP-712 type definitions\n */\nexport interface EIP712Types {\n [typeName: string]: Array<{ name: string; type: string }>;\n}\n\n// ============================================================================\n// PAYMENT TYPES\n// ============================================================================\n\n/**\n * Payment information returned by backend on 402 response\n */\nexport interface PaymentInfo {\n /** Default recipient address */\n recipient: string;\n /** Network-specific recipient addresses */\n recipients?: {\n evm?: string;\n solana?: string;\n near?: string;\n stellar?: string;\n };\n /** Facilitator address (for Solana fee payer) */\n facilitator?: string;\n /** Amount in USD (e.g., \"10.00\") */\n amount: string;\n /** Token symbol (usually \"USDC\") */\n token?: string;\n /** Network hint from backend */\n network?: string;\n /** Supported chain IDs */\n supportedChains?: number[];\n}\n\n/**\n * Simple payment request from application\n */\nexport interface PaymentRequest {\n /** Amount in USDC (e.g., \"10.00\") */\n amount: string;\n /** Override recipient address (optional) */\n recipient?: string;\n /** Application-specific metadata */\n metadata?: Record<string, unknown>;\n}\n\n/**\n * Result of a payment operation\n */\nexport interface PaymentResult {\n /** Whether payment was successful */\n success: boolean;\n /** Base64-encoded X-PAYMENT header value */\n paymentHeader: string;\n /** Transaction hash (if available) */\n transactionHash?: string;\n /** Network where payment was made */\n network: string;\n /** Payer address */\n payer?: string;\n /** Error message (if success is false) */\n error?: string;\n}\n\n// ============================================================================\n// PAYLOAD TYPES (Internal)\n// ============================================================================\n\n/**\n * EVM payment payload (ERC-3009 TransferWithAuthorization)\n */\nexport interface EVMPaymentPayload {\n from: string;\n to: string;\n value: string;\n validAfter: number;\n validBefore: number;\n nonce: string;\n v: number;\n r: string;\n s: string;\n chainId: number;\n token: string;\n}\n\n/**\n * Solana payment payload (partially-signed transaction)\n */\nexport interface SolanaPaymentPayload {\n /** Base64-encoded serialized transaction */\n transaction: string;\n}\n\n/**\n * Stellar payment payload (Soroban authorization)\n */\nexport interface StellarPaymentPayload {\n /** Sender G... public key */\n from: string;\n /** Recipient G... public key */\n to: string;\n /** Amount in stroops (7 decimals) */\n amount: string;\n /** USDC SAC contract address */\n tokenContract: string;\n /** Base64 XDR-encoded SorobanAuthorizationEntry */\n authorizationEntryXdr: string;\n /** Random 64-bit nonce */\n nonce: number;\n /** Ledger when authorization expires */\n signatureExpirationLedger: number;\n}\n\n/**\n * NEAR payment payload (NEP-366 meta-transaction)\n */\nexport interface NEARPaymentPayload {\n /** Base64 Borsh-encoded SignedDelegateAction */\n signedDelegateAction: string;\n network: 'near';\n}\n\n/**\n * Union type for all payment payloads\n */\nexport type PaymentPayload =\n | EVMPaymentPayload\n | SolanaPaymentPayload\n | StellarPaymentPayload\n | NEARPaymentPayload;\n\n// ============================================================================\n// X402 HEADER TYPES (v1 and v2)\n// ============================================================================\n\n/**\n * x402 protocol version\n */\nexport type X402Version = 1 | 2;\n\n/**\n * CAIP-2 chain identifiers for x402 v2\n * @see https://github.com/ChainAgnostic/CAIPs/blob/master/CAIPs/caip-2.md\n */\nexport const CAIP2_IDENTIFIERS: Record<string, string> = {\n // EVM chains\n base: 'eip155:8453',\n ethereum: 'eip155:1',\n polygon: 'eip155:137',\n arbitrum: 'eip155:42161',\n optimism: 'eip155:10',\n avalanche: 'eip155:43114',\n celo: 'eip155:42220',\n hyperevm: 'eip155:999',\n unichain: 'eip155:130',\n monad: 'eip155:143',\n // SVM chains\n solana: 'solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp',\n fogo: 'svm:fogo',\n // Stellar\n stellar: 'stellar:pubnet',\n // NEAR\n near: 'near:mainnet',\n};\n\n/**\n * Reverse mapping from CAIP-2 to chain name\n */\nexport const CAIP2_TO_CHAIN: Record<string, string> = Object.fromEntries(\n Object.entries(CAIP2_IDENTIFIERS).map(([k, v]) => [v, k])\n);\n\n/**\n * x402 v1 header structure (network as string)\n */\nexport interface X402HeaderV1 {\n x402Version: 1;\n scheme: 'exact';\n network: string;\n payload: X402PayloadData;\n}\n\n/**\n * x402 v2 payment option\n */\nexport interface X402PaymentOption {\n network: string; // CAIP-2 format\n asset: string;\n amount: string;\n facilitator?: string;\n}\n\n/**\n * x402 v2 header structure (CAIP-2 network, accepts array)\n */\nexport interface X402HeaderV2 {\n x402Version: 2;\n scheme: 'exact';\n network: string; // CAIP-2 format\n payload: X402PayloadData;\n accepts?: X402PaymentOption[];\n}\n\n/**\n * Union type for both v1 and v2 headers\n */\nexport type X402Header = X402HeaderV1 | X402HeaderV2;\n\n/**\n * EVM-specific payload in x402 header\n */\nexport interface X402EVMPayload {\n signature: string;\n authorization: {\n from: string;\n to: string;\n value: string;\n validAfter: string;\n validBefore: string;\n nonce: string;\n };\n}\n\n/**\n * Solana-specific payload in x402 header\n */\nexport interface X402SolanaPayload {\n transaction: string;\n}\n\n/**\n * Stellar-specific payload in x402 header\n */\nexport interface X402StellarPayload {\n from: string;\n to: string;\n amount: string;\n tokenContract: string;\n authorizationEntryXdr: string;\n nonce: number;\n signatureExpirationLedger: number;\n}\n\n/**\n * NEAR-specific payload in x402 header\n */\nexport interface X402NEARPayload {\n signedDelegateAction: string;\n}\n\n/**\n * Union of all x402 payload types\n */\nexport type X402PayloadData =\n | X402EVMPayload\n | X402SolanaPayload\n | X402StellarPayload\n | X402NEARPayload;\n\n// ============================================================================\n// CLIENT CONFIGURATION\n// ============================================================================\n\n/**\n * Multi-payment configuration for supporting multiple networks\n */\nexport interface MultiPaymentConfig {\n /** Networks to support (e.g., ['base', 'solana', 'stellar', 'near']) */\n networks: string[];\n /** Default network if user hasn't selected one */\n defaultNetwork?: string;\n /** Whether to auto-detect user's preferred network based on wallet */\n autoDetect?: boolean;\n}\n\n/**\n * SDK client configuration options\n */\nexport interface X402ClientConfig {\n /** Facilitator URL (default: https://facilitator.ultravioletadao.xyz) */\n facilitatorUrl?: string;\n /** Default chain to connect to */\n defaultChain?: string;\n /** Auto-connect on initialization */\n autoConnect?: boolean;\n /** Enable debug logging */\n debug?: boolean;\n /** Custom chain configurations (override defaults) */\n customChains?: Record<string, Partial<ChainConfig>>;\n /** Wallet preference order */\n walletPreference?: string[];\n /** Custom RPC URLs (override defaults) */\n rpcOverrides?: Record<string, string>;\n /**\n * x402 protocol version to use\n * - 1: Classic format with network as string (e.g., \"base\")\n * - 2: CAIP-2 format with accepts array (e.g., \"eip155:8453\")\n * - 'auto': Auto-detect from 402 response (default)\n */\n x402Version?: X402Version | 'auto';\n /** Multi-payment configuration for supporting multiple networks */\n multiPayment?: MultiPaymentConfig;\n}\n\n/**\n * Default configuration values\n */\nexport const DEFAULT_CONFIG: Required<Pick<X402ClientConfig, 'facilitatorUrl' | 'defaultChain' | 'autoConnect' | 'debug' | 'x402Version'>> = {\n facilitatorUrl: 'https://facilitator.ultravioletadao.xyz',\n defaultChain: 'base',\n autoConnect: false,\n debug: false,\n x402Version: 'auto',\n};\n\n// ============================================================================\n// BALANCE TYPES\n// ============================================================================\n\n/**\n * Balance information for a single network\n */\nexport interface NetworkBalance {\n /** Chain name */\n chainName: string;\n /** Human-readable display name */\n displayName: string;\n /** Formatted balance (e.g., \"15.50\") or null if loading/error */\n balance: string | null;\n /** Whether balance is currently being fetched */\n isLoading: boolean;\n /** Error message if fetch failed */\n error: string | null;\n}\n\n// ============================================================================\n// EVENT TYPES\n// ============================================================================\n\n/**\n * Events emitted by the SDK client\n */\nexport type X402Event =\n | 'connect'\n | 'disconnect'\n | 'chainChanged'\n | 'accountChanged'\n | 'balanceChanged'\n | 'paymentStarted'\n | 'paymentSigned'\n | 'paymentCompleted'\n | 'paymentFailed';\n\n/**\n * Event data types\n */\nexport interface X402EventData {\n connect: WalletState;\n disconnect: void;\n chainChanged: { chainId: number; chainName: string };\n accountChanged: { address: string };\n balanceChanged: { balance: string };\n paymentStarted: { amount: string; network: string };\n paymentSigned: { paymentHeader: string };\n paymentCompleted: PaymentResult;\n paymentFailed: { error: string; code: X402ErrorCode };\n}\n\n/**\n * Event handler type\n */\nexport type X402EventHandler<E extends X402Event> = (data: X402EventData[E]) => void;\n\n// ============================================================================\n// ERROR TYPES\n// ============================================================================\n\n/**\n * Error codes for categorizing errors\n */\nexport type X402ErrorCode =\n | 'WALLET_NOT_FOUND'\n | 'WALLET_NOT_CONNECTED'\n | 'WALLET_CONNECTION_REJECTED'\n | 'WALLET_CONNECTION_TIMEOUT'\n | 'CHAIN_NOT_SUPPORTED'\n | 'CHAIN_SWITCH_REJECTED'\n | 'INSUFFICIENT_BALANCE'\n | 'SIGNATURE_REJECTED'\n | 'PAYMENT_FAILED'\n | 'PAYMENT_TIMEOUT'\n | 'NETWORK_ERROR'\n | 'INVALID_CONFIG'\n | 'INVALID_AMOUNT'\n | 'INVALID_RECIPIENT'\n | 'UNKNOWN_ERROR';\n\n/**\n * SDK-specific error class\n */\nexport class X402Error extends Error {\n public readonly code: X402ErrorCode;\n public readonly details?: unknown;\n\n constructor(message: string, code: X402ErrorCode, details?: unknown) {\n super(message);\n this.name = 'X402Error';\n this.code = code;\n this.details = details;\n\n // Maintains proper stack trace for where error was thrown (V8 engines)\n if (Error.captureStackTrace) {\n Error.captureStackTrace(this, X402Error);\n }\n }\n}\n","/**\n * uvd-x402-sdk - Stellar Provider\n *\n * Provides Stellar wallet connection and payment creation via Freighter.\n * Uses Soroban authorization entries for gasless USDC transfers.\n *\n * @example\n * ```ts\n * import { X402Client } from 'uvd-x402-sdk';\n * import { StellarProvider } from 'uvd-x402-sdk/stellar';\n *\n * const client = new X402Client();\n * const stellar = new StellarProvider();\n *\n * // Connect\n * const address = await stellar.connect();\n *\n * // Create payment\n * const paymentPayload = await stellar.createPayment(paymentInfo);\n * ```\n */\n\nimport type {\n ChainConfig,\n PaymentInfo,\n StellarPaymentPayload,\n WalletAdapter,\n} from '../../types';\nimport { X402Error } from '../../types';\n\n/**\n * Browser-compatible text to Uint8Array encoding\n * Avoids Node.js Buffer dependency for browser bundlers\n */\nfunction stringToUint8Array(str: string): Uint8Array {\n return new TextEncoder().encode(str);\n}\n\n/**\n * Browser-compatible base64 decoding to Uint8Array\n */\nfunction base64ToUint8Array(base64: string): Uint8Array {\n const binary = atob(base64);\n const bytes = new Uint8Array(binary.length);\n for (let i = 0; i < binary.length; i++) {\n bytes[i] = binary.charCodeAt(i);\n }\n return bytes;\n}\n\n// Stellar configuration\nconst STELLAR_CONFIG = {\n networkPassphrase: 'Public Global Stellar Network ; September 2015',\n horizonUrl: 'https://horizon.stellar.org',\n sorobanRpcUrl: 'https://mainnet.sorobanrpc.com',\n usdcIssuer: 'GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN',\n};\n\n/**\n * StellarProvider - Wallet adapter for Stellar via Freighter\n */\nexport class StellarProvider implements WalletAdapter {\n readonly id = 'freighter';\n readonly name = 'Freighter';\n readonly networkType = 'stellar' as const;\n\n private publicKey: string | null = null;\n\n /**\n * Check if Freighter wallet is available\n */\n isAvailable(): boolean {\n if (typeof window === 'undefined') return false;\n // Check for Freighter global\n return typeof (window as Window & { freighter?: unknown }).freighter !== 'undefined';\n }\n\n /**\n * Connect to Freighter wallet\n */\n async connect(): Promise<string> {\n const freighterApi = await this.getFreighterApi();\n\n try {\n // Check if Freighter is connected\n const connectionResult = await freighterApi.isConnected();\n if (!connectionResult.isConnected) {\n throw new X402Error(\n 'Freighter wallet not installed. Please install from freighter.app',\n 'WALLET_NOT_FOUND'\n );\n }\n\n // Request access\n const accessResult = await freighterApi.requestAccess();\n if (accessResult.error) {\n throw new X402Error(accessResult.error, 'WALLET_CONNECTION_REJECTED');\n }\n\n // Get address\n const addressResult = await freighterApi.getAddress();\n if (addressResult.error) {\n throw new X402Error(addressResult.error, 'WALLET_CONNECTION_REJECTED');\n }\n\n const address = addressResult.address;\n if (!address) {\n throw new X402Error('Failed to get Stellar public key', 'WALLET_CONNECTION_REJECTED');\n }\n\n // Validate format (G... public key)\n if (!address.startsWith('G') || address.length !== 56) {\n throw new X402Error('Invalid Stellar public key format', 'WALLET_CONNECTION_REJECTED');\n }\n\n this.publicKey = address;\n return address;\n } catch (error: unknown) {\n if (error instanceof X402Error) throw error;\n\n if (error instanceof Error) {\n if (error.message.includes('User rejected') || error.message.includes('cancelled')) {\n throw new X402Error('Connection rejected by user', 'WALLET_CONNECTION_REJECTED');\n }\n }\n\n throw new X402Error(\n `Failed to connect Freighter: ${error instanceof Error ? error.message : 'Unknown error'}`,\n 'UNKNOWN_ERROR',\n error\n );\n }\n }\n\n /**\n * Disconnect from Freighter\n */\n async disconnect(): Promise<void> {\n this.publicKey = null;\n }\n\n /**\n * Get current address\n */\n getAddress(): string | null {\n return this.publicKey;\n }\n\n /**\n * Get USDC balance\n */\n async getBalance(_chainConfig: ChainConfig): Promise<string> {\n if (!this.publicKey) {\n throw new X402Error('Wallet not connected', 'WALLET_NOT_CONNECTED');\n }\n\n try {\n const response = await fetch(\n `${STELLAR_CONFIG.horizonUrl}/accounts/${this.publicKey}`\n );\n\n if (!response.ok) {\n if (response.status === 404) {\n // Account not activated\n return '0.00';\n }\n throw new Error('Failed to fetch Stellar account');\n }\n\n const account = await response.json();\n\n // Find USDC balance\n const usdcBalance = account.balances.find(\n (b: { asset_code?: string; asset_issuer?: string }) =>\n b.asset_code === 'USDC' && b.asset_issuer === STELLAR_CONFIG.usdcIssuer\n );\n\n if (!usdcBalance) {\n return '0.00';\n }\n\n const balance = parseFloat(usdcBalance.balance);\n return balance.toFixed(2);\n } catch {\n return '0.00';\n }\n }\n\n /**\n * Create Stellar payment (Soroban authorization entry)\n *\n * User signs an authorization that proves they authorized the USDC transfer.\n * Facilitator wraps this in a fee-bump transaction and pays all XLM network fees.\n */\n async signPayment(paymentInfo: PaymentInfo, chainConfig: ChainConfig): Promise<string> {\n if (!this.publicKey) {\n throw new X402Error('Wallet not connected', 'WALLET_NOT_CONNECTED');\n }\n\n const freighterApi = await this.getFreighterApi();\n const stellarSdk = await import('@stellar/stellar-sdk');\n const { Address, xdr, StrKey, nativeToScVal, hash, Networks } = stellarSdk;\n\n // Get recipient\n const recipient = paymentInfo.recipients?.stellar || paymentInfo.recipient;\n\n // Parse amount (7 decimals for Stellar USDC)\n const amountStroops = Math.floor(parseFloat(paymentInfo.amount) * 10_000_000);\n\n try {\n // Get current ledger from Soroban RPC\n const rpcResponse = await fetch(STELLAR_CONFIG.sorobanRpcUrl, {\n method: 'POST',\n headers: { 'Content-Type': 'application/json' },\n body: JSON.stringify({\n jsonrpc: '2.0',\n id: 1,\n method: 'getLatestLedger',\n }),\n });\n\n const rpcData = await rpcResponse.json();\n if (rpcData.error) {\n throw new Error(`Soroban RPC error: ${rpcData.error.message}`);\n }\n\n const currentLedger = rpcData.result.sequence;\n const signatureExpirationLedger = currentLedger + 60; // ~5 minutes\n\n // Generate random nonce\n const nonce = Math.floor(Math.random() * Number.MAX_SAFE_INTEGER);\n\n // Build authorization for transfer(from, to, amount)\n const fromAddress = new Address(this.publicKey);\n const toAddress = new Address(recipient);\n const amountScVal = nativeToScVal(BigInt(amountStroops), { type: 'i128' });\n\n const args = [fromAddress.toScVal(), toAddress.toScVal(), amountScVal];\n\n // Create contract address\n const contractIdBytes = StrKey.decodeContract(chainConfig.usdc.address);\n // @ts-ignore - Stellar SDK accepts Uint8Array\n const contractScAddress = Address.contract(contractIdBytes).toScAddress();\n\n // Build authorized invocation\n const contractFn = new xdr.InvokeContractArgs({\n contractAddress: contractScAddress,\n functionName: 'transfer',\n args: args,\n });\n\n const invocation = new xdr.SorobanAuthorizedInvocation({\n function: xdr.SorobanAuthorizedFunction.sorobanAuthorizedFunctionTypeContractFn(contractFn),\n subInvocations: [],\n });\n\n // Build HashIdPreimageSorobanAuthorization for signing\n // Cast to Buffer for hash() - Uint8Array is compatible at runtime\n const networkId = hash(stringToUint8Array(Networks.PUBLIC) as unknown as Buffer);\n\n const preimageData = new xdr.HashIdPreimageSorobanAuthorization({\n networkId: networkId,\n nonce: xdr.Int64.fromString(nonce.toString()),\n signatureExpirationLedger: signatureExpirationLedger,\n invocation: invocation,\n });\n\n const hashIdPreimage = xdr.HashIdPreimage.envelopeTypeSorobanAuthorization(preimageData);\n const preimageXdr = hashIdPreimage.toXDR('base64');\n\n // Sign with Freighter\n const signResult = await freighterApi.signAuthEntry(preimageXdr, {\n networkPassphrase: STELLAR_CONFIG.networkPassphrase,\n });\n\n if (signResult.error) {\n throw new X402Error(signResult.error, 'SIGNATURE_REJECTED');\n }\n\n if (!signResult.signedAuthEntry) {\n throw new X402Error('Freighter did not return signed auth entry', 'PAYMENT_FAILED');\n }\n\n // Build the signed SorobanAuthorizationEntry\n const signatureBytes = base64ToUint8Array(signResult.signedAuthEntry);\n const publicKeyBytes = StrKey.decodeEd25519PublicKey(this.publicKey);\n\n const sigMapEntries = [\n new xdr.ScMapEntry({\n key: xdr.ScVal.scvSymbol('public_key'),\n val: xdr.ScVal.scvBytes(publicKeyBytes),\n }),\n new xdr.ScMapEntry({\n key: xdr.ScVal.scvSymbol('signature'),\n val: xdr.ScVal.scvBytes(signatureBytes as unknown as Buffer),\n }),\n ];\n\n const signatureScVal = xdr.ScVal.scvVec([xdr.ScVal.scvMap(sigMapEntries)]);\n\n const signedAddressCredentials = new xdr.SorobanAddressCredentials({\n address: fromAddress.toScAddress(),\n nonce: xdr.Int64.fromString(nonce.toString()),\n signatureExpirationLedger: signatureExpirationLedger,\n signature: signatureScVal,\n });\n\n const signedCredentials = xdr.SorobanCredentials.sorobanCredentialsAddress(signedAddressCredentials);\n const signedAuthEntry = new xdr.SorobanAuthorizationEntry({\n credentials: signedCredentials,\n rootInvocation: invocation,\n });\n\n const authorizationEntryXdr = signedAuthEntry.toXDR('base64');\n\n const payload: StellarPaymentPayload = {\n from: this.publicKey,\n to: recipient,\n amount: amountStroops.toString(),\n tokenContract: chainConfig.usdc.address,\n authorizationEntryXdr,\n nonce,\n signatureExpirationLedger,\n };\n\n return JSON.stringify(payload);\n } catch (error: unknown) {\n if (error instanceof X402Error) throw error;\n\n if (error instanceof Error) {\n if (error.message.includes('User rejected') || error.message.includes('cancelled')) {\n throw new X402Error('Signature rejected by user', 'SIGNATURE_REJECTED');\n }\n }\n\n throw new X402Error(\n `Failed to create Stellar payment: ${error instanceof Error ? error.message : 'Unknown error'}`,\n 'PAYMENT_FAILED',\n error\n );\n }\n }\n\n /**\n * Encode Stellar payment as X-PAYMENT header\n */\n encodePaymentHeader(paymentPayload: string): string {\n const payload = JSON.parse(paymentPayload) as StellarPaymentPayload;\n\n const x402Payload = {\n x402Version: 1,\n scheme: 'exact',\n network: 'stellar',\n payload: {\n from: payload.from,\n to: payload.to,\n amount: payload.amount,\n tokenContract: payload.tokenContract,\n authorizationEntryXdr: payload.authorizationEntryXdr,\n nonce: payload.nonce,\n signatureExpirationLedger: payload.signatureExpirationLedger,\n },\n };\n\n return btoa(JSON.stringify(x402Payload));\n }\n\n // Private helpers\n\n private async getFreighterApi(): Promise<typeof import('@stellar/freighter-api')> {\n const freighterApi = await import('@stellar/freighter-api');\n return freighterApi;\n }\n}\n\nexport default StellarProvider;\n"]}
|
|
1
|
+
{"version":3,"sources":["../../../src/types/index.ts","../../../src/providers/stellar/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * uvd-x402-sdk - Type Definitions\n *\n * Core TypeScript interfaces for the x402 payment SDK.\n * These types define the contract between the SDK and consuming applications.\n */\n\n// ============================================================================\n// CHAIN CONFIGURATION TYPES\n// ============================================================================\n\n/**\n * Network type categorization\n * - 'evm': Ethereum Virtual Machine compatible chains (use EIP-712)\n * - 'svm': Solana Virtual Machine chains (Solana, Fogo) (use SPL tokens)\n * - 'stellar': Stellar network (use Soroban)\n * - 'near': NEAR Protocol (use NEP-366)\n *\n * @deprecated 'solana' type is deprecated, use 'svm' instead\n */\nexport type NetworkType = 'evm' | 'svm' | 'solana' | 'stellar' | 'near';\n\n/**\n * Supported stablecoin token types\n * - usdc: USD Coin (Circle) - 6 decimals\n * - eurc: Euro Coin (Circle) - 6 decimals\n * - ausd: Agora USD (Agora Finance) - 6 decimals\n * - pyusd: PayPal USD (PayPal/Paxos) - 6 decimals\n * - gho: GHO Stablecoin (Aave) - 18 decimals\n * - crvusd: Curve USD (Curve Finance) - 18 decimals\n */\nexport type TokenType = 'usdc' | 'eurc' | 'ausd' | 'pyusd' | 'gho' | 'crvusd';\n\n/**\n * Token configuration for EIP-712 signing and transfers\n */\nexport interface TokenConfig {\n /** Contract/mint address */\n address: string;\n /** Token decimals (6 for most stablecoins, 18 for GHO/crvUSD) */\n decimals: number;\n /** Token name for EIP-712 domain (e.g., \"USD Coin\" or \"USDC\") */\n name: string;\n /** Token version for EIP-712 domain */\n version: string;\n}\n\n/**\n * USDC token configuration for a specific chain\n * @deprecated Use TokenConfig instead. This is kept for backward compatibility.\n */\nexport interface USDCConfig {\n /** Contract/mint address */\n address: string;\n /** Token decimals (6 for most chains, 7 for Stellar) */\n decimals: number;\n /** Token name for EIP-712 domain (e.g., \"USD Coin\" or \"USDC\") */\n name: string;\n /** Token version for EIP-712 domain */\n version: string;\n}\n\n/**\n * Native currency configuration\n */\nexport interface NativeCurrency {\n name: string;\n symbol: string;\n decimals: number;\n}\n\n/**\n * Complete chain configuration\n */\nexport interface ChainConfig {\n /** Numeric chain ID (0 for non-EVM chains) */\n chainId: number;\n /** Hex-encoded chain ID for wallet_switchEthereumChain */\n chainIdHex: string;\n /** Internal chain identifier (e.g., 'base', 'solana') */\n name: string;\n /** Human-readable display name */\n displayName: string;\n /** Network type for routing */\n networkType: NetworkType;\n /** Primary RPC endpoint URL */\n rpcUrl: string;\n /** Block explorer base URL */\n explorerUrl: string;\n /** Native currency info */\n nativeCurrency: NativeCurrency;\n /** USDC token configuration */\n usdc: USDCConfig;\n /**\n * Multi-token configurations (EVM chains only)\n * Maps token type to its configuration for this chain.\n * Not all tokens are available on all chains.\n */\n tokens?: Partial<Record<TokenType, TokenConfig>>;\n /** x402 facilitator configuration */\n x402: {\n facilitatorUrl: string;\n enabled: boolean;\n };\n}\n\n// ============================================================================\n// WALLET TYPES\n// ============================================================================\n\n/**\n * Current wallet connection state\n */\nexport interface WalletState {\n /** Whether a wallet is currently connected */\n connected: boolean;\n /** Connected wallet address (null if not connected) */\n address: string | null;\n /** Current chain ID (null for non-EVM or disconnected) */\n chainId: number | null;\n /** Current network name */\n network: string | null;\n /** Network type of connected wallet */\n networkType: NetworkType | null;\n /** USDC balance on current chain (null if unknown) */\n balance: string | null;\n}\n\n/**\n * Wallet adapter interface for different wallet types\n */\nexport interface WalletAdapter {\n /** Unique identifier for this wallet type */\n readonly id: string;\n /** Display name */\n readonly name: string;\n /** Network type this adapter supports */\n readonly networkType: NetworkType;\n\n /** Check if this wallet is available/installed */\n isAvailable(): boolean;\n\n /** Connect to the wallet */\n connect(chainName?: string): Promise<string>;\n\n /** Disconnect from the wallet */\n disconnect(): Promise<void>;\n\n /** Switch to a different chain (EVM only) */\n switchChain?(chainName: string): Promise<void>;\n\n /**\n * Sign a payment payload\n * For EVM chains, supports multi-token via paymentInfo.tokenType\n */\n signPayment(paymentInfo: PaymentInfo, chainConfig: ChainConfig): Promise<string>;\n\n /**\n * Check token balance (defaults to USDC for backward compatibility)\n * EVM providers may accept optional tokenType parameter\n */\n getBalance(chainConfig: ChainConfig, tokenType?: TokenType): Promise<string>;\n\n /** Get current address */\n getAddress(): string | null;\n\n /** Get current chain ID (EVM only) */\n getChainId?(): number | null;\n}\n\n/**\n * EIP-712 domain for typed data signing\n */\nexport interface EIP712Domain {\n name: string;\n version: string;\n chainId: number;\n verifyingContract: string;\n}\n\n/**\n * EIP-712 type definitions\n */\nexport interface EIP712Types {\n [typeName: string]: Array<{ name: string; type: string }>;\n}\n\n// ============================================================================\n// PAYMENT TYPES\n// ============================================================================\n\n/**\n * Payment information returned by backend on 402 response\n */\nexport interface PaymentInfo {\n /** Default recipient address */\n recipient: string;\n /** Network-specific recipient addresses */\n recipients?: {\n evm?: string;\n solana?: string;\n near?: string;\n stellar?: string;\n };\n /** Facilitator address (for Solana fee payer) */\n facilitator?: string;\n /** Amount in USD (e.g., \"10.00\") */\n amount: string;\n /** Token symbol (usually \"USDC\") */\n token?: string;\n /**\n * Token type for multi-token support\n * Defaults to 'usdc' if not specified for backward compatibility\n */\n tokenType?: TokenType;\n /** Network hint from backend */\n network?: string;\n /** Supported chain IDs */\n supportedChains?: number[];\n}\n\n/**\n * Simple payment request from application\n */\nexport interface PaymentRequest {\n /** Amount in USDC (e.g., \"10.00\") */\n amount: string;\n /** Override recipient address (optional) */\n recipient?: string;\n /** Application-specific metadata */\n metadata?: Record<string, unknown>;\n}\n\n/**\n * Result of a payment operation\n */\nexport interface PaymentResult {\n /** Whether payment was successful */\n success: boolean;\n /** Base64-encoded X-PAYMENT header value */\n paymentHeader: string;\n /** Transaction hash (if available) */\n transactionHash?: string;\n /** Network where payment was made */\n network: string;\n /** Payer address */\n payer?: string;\n /** Error message (if success is false) */\n error?: string;\n}\n\n// ============================================================================\n// PAYLOAD TYPES (Internal)\n// ============================================================================\n\n/**\n * EVM payment payload (ERC-3009 TransferWithAuthorization)\n */\nexport interface EVMPaymentPayload {\n from: string;\n to: string;\n value: string;\n validAfter: number;\n validBefore: number;\n nonce: string;\n v: number;\n r: string;\n s: string;\n chainId: number;\n token: string;\n}\n\n/**\n * Solana payment payload (partially-signed transaction)\n */\nexport interface SolanaPaymentPayload {\n /** Base64-encoded serialized transaction */\n transaction: string;\n}\n\n/**\n * Stellar payment payload (Soroban authorization)\n */\nexport interface StellarPaymentPayload {\n /** Sender G... public key */\n from: string;\n /** Recipient G... public key */\n to: string;\n /** Amount in stroops (7 decimals) */\n amount: string;\n /** USDC SAC contract address */\n tokenContract: string;\n /** Base64 XDR-encoded SorobanAuthorizationEntry */\n authorizationEntryXdr: string;\n /** Random 64-bit nonce */\n nonce: number;\n /** Ledger when authorization expires */\n signatureExpirationLedger: number;\n}\n\n/**\n * NEAR payment payload (NEP-366 meta-transaction)\n */\nexport interface NEARPaymentPayload {\n /** Base64 Borsh-encoded SignedDelegateAction */\n signedDelegateAction: string;\n network: 'near';\n}\n\n/**\n * Union type for all payment payloads\n */\nexport type PaymentPayload =\n | EVMPaymentPayload\n | SolanaPaymentPayload\n | StellarPaymentPayload\n | NEARPaymentPayload;\n\n// ============================================================================\n// X402 HEADER TYPES (v1 and v2)\n// ============================================================================\n\n/**\n * x402 protocol version\n */\nexport type X402Version = 1 | 2;\n\n/**\n * CAIP-2 chain identifiers for x402 v2\n * @see https://github.com/ChainAgnostic/CAIPs/blob/master/CAIPs/caip-2.md\n */\nexport const CAIP2_IDENTIFIERS: Record<string, string> = {\n // EVM chains\n base: 'eip155:8453',\n ethereum: 'eip155:1',\n polygon: 'eip155:137',\n arbitrum: 'eip155:42161',\n optimism: 'eip155:10',\n avalanche: 'eip155:43114',\n celo: 'eip155:42220',\n hyperevm: 'eip155:999',\n unichain: 'eip155:130',\n monad: 'eip155:143',\n // SVM chains\n solana: 'solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp',\n fogo: 'svm:fogo',\n // Stellar\n stellar: 'stellar:pubnet',\n // NEAR\n near: 'near:mainnet',\n};\n\n/**\n * Reverse mapping from CAIP-2 to chain name\n */\nexport const CAIP2_TO_CHAIN: Record<string, string> = Object.fromEntries(\n Object.entries(CAIP2_IDENTIFIERS).map(([k, v]) => [v, k])\n);\n\n/**\n * x402 v1 header structure (network as string)\n */\nexport interface X402HeaderV1 {\n x402Version: 1;\n scheme: 'exact';\n network: string;\n payload: X402PayloadData;\n}\n\n/**\n * x402 v2 payment option\n */\nexport interface X402PaymentOption {\n network: string; // CAIP-2 format\n asset: string;\n amount: string;\n facilitator?: string;\n}\n\n/**\n * x402 v2 header structure (CAIP-2 network, accepts array)\n */\nexport interface X402HeaderV2 {\n x402Version: 2;\n scheme: 'exact';\n network: string; // CAIP-2 format\n payload: X402PayloadData;\n accepts?: X402PaymentOption[];\n}\n\n/**\n * Union type for both v1 and v2 headers\n */\nexport type X402Header = X402HeaderV1 | X402HeaderV2;\n\n/**\n * EVM-specific payload in x402 header\n */\nexport interface X402EVMPayload {\n signature: string;\n authorization: {\n from: string;\n to: string;\n value: string;\n validAfter: string;\n validBefore: string;\n nonce: string;\n };\n}\n\n/**\n * Solana-specific payload in x402 header\n */\nexport interface X402SolanaPayload {\n transaction: string;\n}\n\n/**\n * Stellar-specific payload in x402 header\n */\nexport interface X402StellarPayload {\n from: string;\n to: string;\n amount: string;\n tokenContract: string;\n authorizationEntryXdr: string;\n nonce: number;\n signatureExpirationLedger: number;\n}\n\n/**\n * NEAR-specific payload in x402 header\n */\nexport interface X402NEARPayload {\n signedDelegateAction: string;\n}\n\n/**\n * Union of all x402 payload types\n */\nexport type X402PayloadData =\n | X402EVMPayload\n | X402SolanaPayload\n | X402StellarPayload\n | X402NEARPayload;\n\n// ============================================================================\n// CLIENT CONFIGURATION\n// ============================================================================\n\n/**\n * Multi-payment configuration for supporting multiple networks\n */\nexport interface MultiPaymentConfig {\n /** Networks to support (e.g., ['base', 'solana', 'stellar', 'near']) */\n networks: string[];\n /** Default network if user hasn't selected one */\n defaultNetwork?: string;\n /** Whether to auto-detect user's preferred network based on wallet */\n autoDetect?: boolean;\n}\n\n/**\n * SDK client configuration options\n */\nexport interface X402ClientConfig {\n /** Facilitator URL (default: https://facilitator.ultravioletadao.xyz) */\n facilitatorUrl?: string;\n /** Default chain to connect to */\n defaultChain?: string;\n /** Auto-connect on initialization */\n autoConnect?: boolean;\n /** Enable debug logging */\n debug?: boolean;\n /** Custom chain configurations (override defaults) */\n customChains?: Record<string, Partial<ChainConfig>>;\n /** Wallet preference order */\n walletPreference?: string[];\n /** Custom RPC URLs (override defaults) */\n rpcOverrides?: Record<string, string>;\n /**\n * x402 protocol version to use\n * - 1: Classic format with network as string (e.g., \"base\")\n * - 2: CAIP-2 format with accepts array (e.g., \"eip155:8453\")\n * - 'auto': Auto-detect from 402 response (default)\n */\n x402Version?: X402Version | 'auto';\n /** Multi-payment configuration for supporting multiple networks */\n multiPayment?: MultiPaymentConfig;\n}\n\n/**\n * Default configuration values\n */\nexport const DEFAULT_CONFIG: Required<Pick<X402ClientConfig, 'facilitatorUrl' | 'defaultChain' | 'autoConnect' | 'debug' | 'x402Version'>> = {\n facilitatorUrl: 'https://facilitator.ultravioletadao.xyz',\n defaultChain: 'base',\n autoConnect: false,\n debug: false,\n x402Version: 'auto',\n};\n\n// ============================================================================\n// BALANCE TYPES\n// ============================================================================\n\n/**\n * Balance information for a single network\n */\nexport interface NetworkBalance {\n /** Chain name */\n chainName: string;\n /** Human-readable display name */\n displayName: string;\n /** Formatted balance (e.g., \"15.50\") or null if loading/error */\n balance: string | null;\n /** Whether balance is currently being fetched */\n isLoading: boolean;\n /** Error message if fetch failed */\n error: string | null;\n}\n\n// ============================================================================\n// EVENT TYPES\n// ============================================================================\n\n/**\n * Events emitted by the SDK client\n */\nexport type X402Event =\n | 'connect'\n | 'disconnect'\n | 'chainChanged'\n | 'accountChanged'\n | 'balanceChanged'\n | 'paymentStarted'\n | 'paymentSigned'\n | 'paymentCompleted'\n | 'paymentFailed';\n\n/**\n * Event data types\n */\nexport interface X402EventData {\n connect: WalletState;\n disconnect: void;\n chainChanged: { chainId: number; chainName: string };\n accountChanged: { address: string };\n balanceChanged: { balance: string };\n paymentStarted: { amount: string; network: string };\n paymentSigned: { paymentHeader: string };\n paymentCompleted: PaymentResult;\n paymentFailed: { error: string; code: X402ErrorCode };\n}\n\n/**\n * Event handler type\n */\nexport type X402EventHandler<E extends X402Event> = (data: X402EventData[E]) => void;\n\n// ============================================================================\n// ERROR TYPES\n// ============================================================================\n\n/**\n * Error codes for categorizing errors\n */\nexport type X402ErrorCode =\n | 'WALLET_NOT_FOUND'\n | 'WALLET_NOT_CONNECTED'\n | 'WALLET_CONNECTION_REJECTED'\n | 'WALLET_CONNECTION_TIMEOUT'\n | 'CHAIN_NOT_SUPPORTED'\n | 'CHAIN_SWITCH_REJECTED'\n | 'INSUFFICIENT_BALANCE'\n | 'SIGNATURE_REJECTED'\n | 'PAYMENT_FAILED'\n | 'PAYMENT_TIMEOUT'\n | 'NETWORK_ERROR'\n | 'INVALID_CONFIG'\n | 'INVALID_AMOUNT'\n | 'INVALID_RECIPIENT'\n | 'UNKNOWN_ERROR';\n\n/**\n * SDK-specific error class\n */\nexport class X402Error extends Error {\n public readonly code: X402ErrorCode;\n public readonly details?: unknown;\n\n constructor(message: string, code: X402ErrorCode, details?: unknown) {\n super(message);\n this.name = 'X402Error';\n this.code = code;\n this.details = details;\n\n // Maintains proper stack trace for where error was thrown (V8 engines)\n if (Error.captureStackTrace) {\n Error.captureStackTrace(this, X402Error);\n }\n }\n}\n","/**\n * uvd-x402-sdk - Stellar Provider\n *\n * Provides Stellar wallet connection and payment creation via Freighter.\n * Uses Soroban authorization entries for gasless USDC transfers.\n *\n * @example\n * ```ts\n * import { X402Client } from 'uvd-x402-sdk';\n * import { StellarProvider } from 'uvd-x402-sdk/stellar';\n *\n * const client = new X402Client();\n * const stellar = new StellarProvider();\n *\n * // Connect\n * const address = await stellar.connect();\n *\n * // Create payment\n * const paymentPayload = await stellar.createPayment(paymentInfo);\n * ```\n */\n\nimport type {\n ChainConfig,\n PaymentInfo,\n StellarPaymentPayload,\n WalletAdapter,\n} from '../../types';\nimport { X402Error } from '../../types';\n\n/**\n * Browser-compatible text to Uint8Array encoding\n * Avoids Node.js Buffer dependency for browser bundlers\n */\nfunction stringToUint8Array(str: string): Uint8Array {\n return new TextEncoder().encode(str);\n}\n\n/**\n * Browser-compatible base64 decoding to Uint8Array\n */\nfunction base64ToUint8Array(base64: string): Uint8Array {\n const binary = atob(base64);\n const bytes = new Uint8Array(binary.length);\n for (let i = 0; i < binary.length; i++) {\n bytes[i] = binary.charCodeAt(i);\n }\n return bytes;\n}\n\n// Stellar configuration\nconst STELLAR_CONFIG = {\n networkPassphrase: 'Public Global Stellar Network ; September 2015',\n horizonUrl: 'https://horizon.stellar.org',\n sorobanRpcUrl: 'https://mainnet.sorobanrpc.com',\n usdcIssuer: 'GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN',\n};\n\n/**\n * StellarProvider - Wallet adapter for Stellar via Freighter\n */\nexport class StellarProvider implements WalletAdapter {\n readonly id = 'freighter';\n readonly name = 'Freighter';\n readonly networkType = 'stellar' as const;\n\n private publicKey: string | null = null;\n\n /**\n * Check if Freighter wallet is available\n */\n isAvailable(): boolean {\n if (typeof window === 'undefined') return false;\n // Check for Freighter global\n return typeof (window as Window & { freighter?: unknown }).freighter !== 'undefined';\n }\n\n /**\n * Connect to Freighter wallet\n */\n async connect(): Promise<string> {\n const freighterApi = await this.getFreighterApi();\n\n try {\n // Check if Freighter is connected\n const connectionResult = await freighterApi.isConnected();\n if (!connectionResult.isConnected) {\n throw new X402Error(\n 'Freighter wallet not installed. Please install from freighter.app',\n 'WALLET_NOT_FOUND'\n );\n }\n\n // Request access\n const accessResult = await freighterApi.requestAccess();\n if (accessResult.error) {\n throw new X402Error(accessResult.error, 'WALLET_CONNECTION_REJECTED');\n }\n\n // Get address\n const addressResult = await freighterApi.getAddress();\n if (addressResult.error) {\n throw new X402Error(addressResult.error, 'WALLET_CONNECTION_REJECTED');\n }\n\n const address = addressResult.address;\n if (!address) {\n throw new X402Error('Failed to get Stellar public key', 'WALLET_CONNECTION_REJECTED');\n }\n\n // Validate format (G... public key)\n if (!address.startsWith('G') || address.length !== 56) {\n throw new X402Error('Invalid Stellar public key format', 'WALLET_CONNECTION_REJECTED');\n }\n\n this.publicKey = address;\n return address;\n } catch (error: unknown) {\n if (error instanceof X402Error) throw error;\n\n if (error instanceof Error) {\n if (error.message.includes('User rejected') || error.message.includes('cancelled')) {\n throw new X402Error('Connection rejected by user', 'WALLET_CONNECTION_REJECTED');\n }\n }\n\n throw new X402Error(\n `Failed to connect Freighter: ${error instanceof Error ? error.message : 'Unknown error'}`,\n 'UNKNOWN_ERROR',\n error\n );\n }\n }\n\n /**\n * Disconnect from Freighter\n */\n async disconnect(): Promise<void> {\n this.publicKey = null;\n }\n\n /**\n * Get current address\n */\n getAddress(): string | null {\n return this.publicKey;\n }\n\n /**\n * Get USDC balance\n */\n async getBalance(_chainConfig: ChainConfig): Promise<string> {\n if (!this.publicKey) {\n throw new X402Error('Wallet not connected', 'WALLET_NOT_CONNECTED');\n }\n\n try {\n const response = await fetch(\n `${STELLAR_CONFIG.horizonUrl}/accounts/${this.publicKey}`\n );\n\n if (!response.ok) {\n if (response.status === 404) {\n // Account not activated\n return '0.00';\n }\n throw new Error('Failed to fetch Stellar account');\n }\n\n const account = await response.json();\n\n // Find USDC balance\n const usdcBalance = account.balances.find(\n (b: { asset_code?: string; asset_issuer?: string }) =>\n b.asset_code === 'USDC' && b.asset_issuer === STELLAR_CONFIG.usdcIssuer\n );\n\n if (!usdcBalance) {\n return '0.00';\n }\n\n const balance = parseFloat(usdcBalance.balance);\n return balance.toFixed(2);\n } catch {\n return '0.00';\n }\n }\n\n /**\n * Create Stellar payment (Soroban authorization entry)\n *\n * User signs an authorization that proves they authorized the USDC transfer.\n * Facilitator wraps this in a fee-bump transaction and pays all XLM network fees.\n */\n async signPayment(paymentInfo: PaymentInfo, chainConfig: ChainConfig): Promise<string> {\n if (!this.publicKey) {\n throw new X402Error('Wallet not connected', 'WALLET_NOT_CONNECTED');\n }\n\n const freighterApi = await this.getFreighterApi();\n const stellarSdk = await import('@stellar/stellar-sdk');\n const { Address, xdr, StrKey, nativeToScVal, hash, Networks } = stellarSdk;\n\n // Get recipient\n const recipient = paymentInfo.recipients?.stellar || paymentInfo.recipient;\n\n // Parse amount (7 decimals for Stellar USDC)\n const amountStroops = Math.floor(parseFloat(paymentInfo.amount) * 10_000_000);\n\n try {\n // Get current ledger from Soroban RPC\n const rpcResponse = await fetch(STELLAR_CONFIG.sorobanRpcUrl, {\n method: 'POST',\n headers: { 'Content-Type': 'application/json' },\n body: JSON.stringify({\n jsonrpc: '2.0',\n id: 1,\n method: 'getLatestLedger',\n }),\n });\n\n const rpcData = await rpcResponse.json();\n if (rpcData.error) {\n throw new Error(`Soroban RPC error: ${rpcData.error.message}`);\n }\n\n const currentLedger = rpcData.result.sequence;\n const signatureExpirationLedger = currentLedger + 60; // ~5 minutes\n\n // Generate random nonce\n const nonce = Math.floor(Math.random() * Number.MAX_SAFE_INTEGER);\n\n // Build authorization for transfer(from, to, amount)\n const fromAddress = new Address(this.publicKey);\n const toAddress = new Address(recipient);\n const amountScVal = nativeToScVal(BigInt(amountStroops), { type: 'i128' });\n\n const args = [fromAddress.toScVal(), toAddress.toScVal(), amountScVal];\n\n // Create contract address\n const contractIdBytes = StrKey.decodeContract(chainConfig.usdc.address);\n // @ts-ignore - Stellar SDK accepts Uint8Array\n const contractScAddress = Address.contract(contractIdBytes).toScAddress();\n\n // Build authorized invocation\n const contractFn = new xdr.InvokeContractArgs({\n contractAddress: contractScAddress,\n functionName: 'transfer',\n args: args,\n });\n\n const invocation = new xdr.SorobanAuthorizedInvocation({\n function: xdr.SorobanAuthorizedFunction.sorobanAuthorizedFunctionTypeContractFn(contractFn),\n subInvocations: [],\n });\n\n // Build HashIdPreimageSorobanAuthorization for signing\n // Cast to Buffer for hash() - Uint8Array is compatible at runtime\n const networkId = hash(stringToUint8Array(Networks.PUBLIC) as unknown as Buffer);\n\n const preimageData = new xdr.HashIdPreimageSorobanAuthorization({\n networkId: networkId,\n nonce: xdr.Int64.fromString(nonce.toString()),\n signatureExpirationLedger: signatureExpirationLedger,\n invocation: invocation,\n });\n\n const hashIdPreimage = xdr.HashIdPreimage.envelopeTypeSorobanAuthorization(preimageData);\n const preimageXdr = hashIdPreimage.toXDR('base64');\n\n // Sign with Freighter\n const signResult = await freighterApi.signAuthEntry(preimageXdr, {\n networkPassphrase: STELLAR_CONFIG.networkPassphrase,\n });\n\n if (signResult.error) {\n throw new X402Error(signResult.error, 'SIGNATURE_REJECTED');\n }\n\n if (!signResult.signedAuthEntry) {\n throw new X402Error('Freighter did not return signed auth entry', 'PAYMENT_FAILED');\n }\n\n // Build the signed SorobanAuthorizationEntry\n const signatureBytes = base64ToUint8Array(signResult.signedAuthEntry);\n const publicKeyBytes = StrKey.decodeEd25519PublicKey(this.publicKey);\n\n const sigMapEntries = [\n new xdr.ScMapEntry({\n key: xdr.ScVal.scvSymbol('public_key'),\n val: xdr.ScVal.scvBytes(publicKeyBytes),\n }),\n new xdr.ScMapEntry({\n key: xdr.ScVal.scvSymbol('signature'),\n val: xdr.ScVal.scvBytes(signatureBytes as unknown as Buffer),\n }),\n ];\n\n const signatureScVal = xdr.ScVal.scvVec([xdr.ScVal.scvMap(sigMapEntries)]);\n\n const signedAddressCredentials = new xdr.SorobanAddressCredentials({\n address: fromAddress.toScAddress(),\n nonce: xdr.Int64.fromString(nonce.toString()),\n signatureExpirationLedger: signatureExpirationLedger,\n signature: signatureScVal,\n });\n\n const signedCredentials = xdr.SorobanCredentials.sorobanCredentialsAddress(signedAddressCredentials);\n const signedAuthEntry = new xdr.SorobanAuthorizationEntry({\n credentials: signedCredentials,\n rootInvocation: invocation,\n });\n\n const authorizationEntryXdr = signedAuthEntry.toXDR('base64');\n\n const payload: StellarPaymentPayload = {\n from: this.publicKey,\n to: recipient,\n amount: amountStroops.toString(),\n tokenContract: chainConfig.usdc.address,\n authorizationEntryXdr,\n nonce,\n signatureExpirationLedger,\n };\n\n return JSON.stringify(payload);\n } catch (error: unknown) {\n if (error instanceof X402Error) throw error;\n\n if (error instanceof Error) {\n if (error.message.includes('User rejected') || error.message.includes('cancelled')) {\n throw new X402Error('Signature rejected by user', 'SIGNATURE_REJECTED');\n }\n }\n\n throw new X402Error(\n `Failed to create Stellar payment: ${error instanceof Error ? error.message : 'Unknown error'}`,\n 'PAYMENT_FAILED',\n error\n );\n }\n }\n\n /**\n * Encode Stellar payment as X-PAYMENT header\n */\n encodePaymentHeader(paymentPayload: string): string {\n const payload = JSON.parse(paymentPayload) as StellarPaymentPayload;\n\n const x402Payload = {\n x402Version: 1,\n scheme: 'exact',\n network: 'stellar',\n payload: {\n from: payload.from,\n to: payload.to,\n amount: payload.amount,\n tokenContract: payload.tokenContract,\n authorizationEntryXdr: payload.authorizationEntryXdr,\n nonce: payload.nonce,\n signatureExpirationLedger: payload.signatureExpirationLedger,\n },\n };\n\n return btoa(JSON.stringify(x402Payload));\n }\n\n // Private helpers\n\n private async getFreighterApi(): Promise<typeof import('@stellar/freighter-api')> {\n const freighterApi = await import('@stellar/freighter-api');\n return freighterApi;\n }\n}\n\nexport default StellarProvider;\n"]}
|