@relai-fi/x402 0.1.0 → 0.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 CHANGED
@@ -225,20 +225,48 @@ React hook wrapping `createX402Client` with state management.
225
225
  import Relai from '@relai-fi/x402/server';
226
226
 
227
227
  const relai = new Relai({
228
- apiKey: process.env.RELAI_API_KEY,
229
- network: 'solana', // or 'base', 'avalanche', 'skale-base'
228
+ network: 'base', // or 'solana', 'avalanche', 'skale-base'
230
229
  });
231
230
 
232
231
  // Protect any Express route with micropayments
233
232
  app.get('/api/data', relai.protect({
234
- payTo: 'YourWalletAddress',
233
+ payTo: '0xYourWallet',
235
234
  price: 0.01, // $0.01 USDC
236
235
  description: 'Premium data access',
237
236
  }), (req, res) => {
237
+ // req.payment = { verified, transactionId, payer, network, amount }
238
238
  res.json({ data: 'Protected content', payment: req.payment });
239
239
  });
240
+
241
+ // Dynamic pricing
242
+ app.get('/api/premium', relai.protect({
243
+ payTo: '0xYourWallet',
244
+ price: (req) => req.query.tier === 'pro' ? 0.10 : 0.01,
245
+ }), handler);
246
+
247
+ // Per-endpoint network override
248
+ app.get('/api/solana-data', relai.protect({
249
+ payTo: 'SolanaWalletAddress',
250
+ price: 0.005,
251
+ network: 'solana', // overrides the default 'base'
252
+ }), handler);
240
253
  ```
241
254
 
255
+ **Flow:**
256
+ 1. Request without payment → 402 with `accepts` array
257
+ 2. Client signs payment (SDK handles this) → retries with `X-PAYMENT` header
258
+ 3. Server calls RelAI facilitator `/settle` → gas sponsored by RelAI
259
+ 4. Settlement success → `PAYMENT-RESPONSE` header set, `req.payment` populated, `next()` called
260
+
261
+ **`req.payment` fields:**
262
+ | Field | Type | Description |
263
+ |-------|------|-------------|
264
+ | `verified` | `boolean` | Always `true` after settlement |
265
+ | `transactionId` | `string` | On-chain transaction hash |
266
+ | `payer` | `string` | Payer wallet address |
267
+ | `network` | `string` | Network name (e.g., `base`) |
268
+ | `amount` | `number` | Price in USD |
269
+
242
270
  ---
243
271
 
244
272
  ## Utilities
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/client.ts","../src/types.ts"],"sourcesContent":["// src/client.ts\nimport {\n Connection,\n PublicKey,\n TransactionMessage,\n VersionedTransaction,\n} from '@solana/web3.js';\nimport {\n getAssociatedTokenAddress,\n createTransferCheckedInstruction,\n getMint,\n TOKEN_PROGRAM_ID,\n TOKEN_2022_PROGRAM_ID,\n} from '@solana/spl-token';\nimport type { SolanaWallet, EvmWallet, WalletSet } from './types';\nimport {\n RELAI_FACILITATOR_URL,\n NETWORK_CAIP2,\n CHAIN_IDS,\n isSolana,\n isEvm,\n normalizeNetwork,\n type RelaiNetwork,\n} from './types';\n\n// ============================================================================\n// Types\n// ============================================================================\n\nexport interface X402ClientConfig {\n /** Multi-chain wallets (Solana + EVM) */\n wallets?: WalletSet;\n /** Single Solana wallet (legacy shortcut) */\n wallet?: SolanaWallet;\n /** Custom facilitator URL, default: RelAI facilitator */\n facilitatorUrl?: string;\n /** Preferred network when multiple options available */\n preferredNetwork?: RelaiNetwork;\n /** Custom Solana RPC URL */\n solanaRpcUrl?: string;\n /** Custom EVM RPC URLs per network (e.g. { 'skale-base': 'https://...' }) */\n evmRpcUrls?: Record<string, string>;\n /** Maximum payment amount in atomic units */\n maxAmountAtomic?: string;\n /** Enable verbose logging */\n verbose?: boolean;\n}\n\nexport interface X402Client {\n /** Fetch with automatic x402 payment handling */\n fetch(input: string | URL | Request, init?: RequestInit): Promise<Response>;\n}\n\n/**\n * Create an x402 client for automatic payment handling.\n * Supports all RelAI facilitator networks: Solana, Base, Avalanche, SKALE Base.\n * Auto-detects the correct chain from the 402 response and picks the right\n * signing method (Solana SPL transfer, EVM EIP-3009 transferWithAuthorization).\n *\n * @example\n * ```typescript\n * import { createX402Client } from '@relai-fi/x402';\n *\n * const client = createX402Client({\n * wallets: { solana: solanaWallet, evm: evmWalletClient },\n * });\n *\n * // Automatically handles 402 on any RelAI-supported network\n * const response = await client.fetch('https://api.example.com/protected');\n * ```\n */\n// Networks that use EIP-2612 permit instead of EIP-3009 transferWithAuthorization (currently none)\nconst PERMIT_NETWORKS = new Set<string>([]);\n\n// Default EVM RPC URLs\nconst DEFAULT_EVM_RPC_URLS: Record<string, string> = {\n 'skale-base': 'https://skale-base.skalenodes.com/v1/base',\n 'base': 'https://mainnet.base.org',\n 'avalanche': 'https://api.avax.network/ext/bc/C/rpc',\n};\n\nexport function createX402Client(config: X402ClientConfig): X402Client {\n const {\n wallets = {},\n wallet: legacyWallet,\n facilitatorUrl = RELAI_FACILITATOR_URL,\n preferredNetwork,\n solanaRpcUrl = 'https://api.mainnet-beta.solana.com',\n evmRpcUrls = {},\n maxAmountAtomic,\n verbose = false,\n } = config;\n\n const log = verbose ? console.log.bind(console, '[relai-x402]') : () => {};\n\n // Merge legacy wallet into wallet set\n const effectiveWallets: WalletSet = { ...wallets };\n if (legacyWallet && !effectiveWallets.solana) {\n effectiveWallets.solana = legacyWallet;\n }\n\n const hasSolanaWallet = Boolean(\n effectiveWallets.solana?.publicKey && effectiveWallets.solana?.signTransaction\n );\n if (hasSolanaWallet) log('Solana wallet ready');\n\n // -----------------------------------------------------------------------\n // Select a payment option from the 402 response's `accepts` array\n // -----------------------------------------------------------------------\n function selectAccept(accepts: any[]): { accept: any; chain: 'solana' | 'evm' } | null {\n // 1) Preferred network first\n if (preferredNetwork) {\n const caip2 = NETWORK_CAIP2[preferredNetwork];\n for (const a of accepts) {\n const net = a.network || '';\n if (net === preferredNetwork || net === caip2) {\n const chain = isSolana(net) ? 'solana' as const : 'evm' as const;\n if ((chain === 'solana' && hasSolanaWallet) || (chain === 'evm' && effectiveWallets.evm)) {\n return { accept: a, chain };\n }\n }\n }\n }\n\n // 2) First option we have a wallet for\n for (const a of accepts) {\n const net = a.network || '';\n if (isSolana(net) && hasSolanaWallet) return { accept: a, chain: 'solana' };\n if (isEvm(net) && effectiveWallets.evm) return { accept: a, chain: 'evm' };\n }\n\n return null;\n }\n\n // -----------------------------------------------------------------------\n // JSON-RPC helper (for reading EVM contract state without ethers)\n // -----------------------------------------------------------------------\n async function evmRpcCall(rpcUrl: string, to: string, data: string): Promise<string> {\n const res = await fetch(rpcUrl, {\n method: 'POST',\n headers: { 'Content-Type': 'application/json' },\n body: JSON.stringify({\n jsonrpc: '2.0',\n method: 'eth_call',\n params: [{ to, data }, 'latest'],\n id: 1,\n }),\n });\n const json = await res.json();\n if (json.error) throw new Error(`RPC error: ${json.error.message}`);\n return json.result;\n }\n\n function getEvmRpcUrl(network: string): string {\n return evmRpcUrls[network] || DEFAULT_EVM_RPC_URLS[network] || '';\n }\n\n // -----------------------------------------------------------------------\n // Build EVM payment — EIP-2612 permit (for SKALE Base)\n // -----------------------------------------------------------------------\n async function buildEvmPermitPayment(\n accept: any,\n requirements: any,\n url: string,\n ): Promise<string> {\n const evmWallet = effectiveWallets.evm!;\n const extra = accept.extra || {};\n\n const rawNetwork = accept.network || '';\n const network = normalizeNetwork(rawNetwork);\n const chainId = network ? CHAIN_IDS[network] : parseInt(rawNetwork.split(':')[1] || '8453');\n const paymentAmount = accept.amount || accept.maxAmountRequired;\n const spender = extra.feePayer || accept.payTo;\n const usdcAddress = accept.asset;\n\n const rpcUrl = getEvmRpcUrl(network || rawNetwork);\n if (!rpcUrl) throw new Error(`[relai-x402] No EVM RPC URL for network ${network || rawNetwork}`);\n\n log('Building EIP-2612 permit on chain', chainId);\n\n // Read nonce from USDC contract: nonces(address) = 0x7ecebe00\n const paddedAddress = evmWallet.address.toLowerCase().replace('0x', '').padStart(64, '0');\n const nonceHex = await evmRpcCall(rpcUrl, usdcAddress, '0x7ecebe00' + paddedAddress);\n const nonce = nonceHex ? parseInt(nonceHex, 16) : 0;\n if (isNaN(nonce)) throw new Error(`[relai-x402] Failed to read permit nonce from ${usdcAddress} on ${rpcUrl}`);\n log(' Permit nonce:', nonce);\n\n // Read token name: name() = 0x06fdde03\n const nameHex = await evmRpcCall(rpcUrl, usdcAddress, '0x06fdde03');\n // Decode ABI-encoded string\n let tokenName = 'USD Coin';\n try {\n const offset = parseInt(nameHex.slice(2, 66), 16) * 2;\n const length = parseInt(nameHex.slice(2 + offset, 2 + offset + 64), 16);\n const hex = nameHex.slice(2 + offset + 64, 2 + offset + 64 + length * 2);\n tokenName = decodeURIComponent(hex.replace(/[0-9a-f]{2}/g, '%$&'));\n } catch {\n tokenName = extra.name || 'USD Coin';\n }\n log(' Token name:', tokenName);\n\n const deadline = Math.floor(Date.now() / 1000) + 600; // 10 min\n\n const domain = {\n name: tokenName,\n version: extra.version || '2',\n chainId,\n verifyingContract: usdcAddress,\n };\n\n const types = {\n Permit: [\n { name: 'owner', type: 'address' },\n { name: 'spender', type: 'address' },\n { name: 'value', type: 'uint256' },\n { name: 'nonce', type: 'uint256' },\n { name: 'deadline', type: 'uint256' },\n ],\n };\n\n const message = {\n owner: evmWallet.address,\n spender,\n value: paymentAmount,\n nonce: String(nonce),\n deadline: String(deadline),\n };\n\n log('Signing EIP-2612 permit:', message);\n\n const signature = await evmWallet.signTypedData({\n domain,\n types,\n message,\n primaryType: 'Permit',\n });\n\n // Split signature into v, r, s\n const sigHex = (signature as string).replace('0x', '');\n const r = '0x' + sigHex.slice(0, 64);\n const s = '0x' + sigHex.slice(64, 128);\n const v = parseInt(sigHex.slice(128, 130), 16);\n\n log(' Permit signed: v=%d r=%s s=%s', v, r, s);\n\n // Build x402 v2 payment payload (SKALE format)\n const paymentPayload = {\n x402Version: 2,\n scheme: 'exact',\n network: network || rawNetwork,\n payload: {\n userAddress: evmWallet.address,\n permit: { deadline: String(deadline), v, r, s },\n amount: paymentAmount,\n },\n };\n\n return btoa(JSON.stringify(paymentPayload));\n }\n\n // -----------------------------------------------------------------------\n // Build EVM payment (EIP-3009 transferWithAuthorization)\n // -----------------------------------------------------------------------\n async function buildEvmPayment(\n accept: any,\n requirements: any,\n url: string,\n ): Promise<string> {\n const evmWallet = effectiveWallets.evm!;\n const extra = accept.extra || {};\n\n const rawNetwork = accept.network || '';\n const network = normalizeNetwork(rawNetwork);\n const chainId = network ? CHAIN_IDS[network] : parseInt(rawNetwork.split(':')[1] || '8453');\n\n const paymentAmount = accept.amount || accept.maxAmountRequired;\n\n // EIP-3009 transferWithAuthorization typed data\n const domain = {\n name: extra.name || 'USD Coin',\n version: extra.version || '2',\n chainId,\n verifyingContract: accept.asset,\n };\n\n const validAfter = 0;\n const validBefore = Math.floor(Date.now() / 1000) + 3600;\n const nonce = '0x' + [...crypto.getRandomValues(new Uint8Array(32))]\n .map(b => b.toString(16).padStart(2, '0')).join('');\n\n const types = {\n TransferWithAuthorization: [\n { name: 'from', type: 'address' },\n { name: 'to', type: 'address' },\n { name: 'value', type: 'uint256' },\n { name: 'validAfter', type: 'uint256' },\n { name: 'validBefore', type: 'uint256' },\n { name: 'nonce', type: 'bytes32' },\n ],\n };\n\n const spender = extra.feePayer || accept.payTo;\n\n const message = {\n from: evmWallet.address,\n to: spender,\n value: paymentAmount,\n validAfter: String(validAfter),\n validBefore: String(validBefore),\n nonce,\n };\n\n log('Signing EIP-3009 transferWithAuthorization on chain', chainId);\n\n const signature = await evmWallet.signTypedData({\n domain,\n types,\n message,\n primaryType: 'TransferWithAuthorization',\n });\n\n // Build x402 v2 payment payload\n const paymentPayload = {\n x402Version: 2,\n resource: requirements.resource || { url },\n accepted: accept,\n payload: {\n authorization: message,\n signature,\n },\n facilitatorUrl,\n };\n\n return btoa(JSON.stringify(paymentPayload));\n }\n\n // -----------------------------------------------------------------------\n // Build Solana payment (SPL transfer with fee payer sponsorship)\n // -----------------------------------------------------------------------\n async function buildSolanaPayment(\n accept: any,\n requirements: any,\n url: string,\n ): Promise<string> {\n const solWallet = effectiveWallets.solana!;\n const extra = accept.extra || {};\n\n if (!extra.feePayer) {\n throw new Error('[relai-x402] Missing feePayer in Solana payment requirements');\n }\n\n const connection = new Connection(solanaRpcUrl, 'confirmed');\n const userPubkey = new PublicKey(solWallet.publicKey!.toString());\n const merchantPubkey = new PublicKey(accept.payTo);\n const feePayerPubkey = new PublicKey(extra.feePayer);\n const mintPubkey = new PublicKey(accept.asset);\n const paymentAmount = BigInt(accept.amount || accept.maxAmountRequired);\n\n log('Building Solana SPL transfer');\n log(' User:', userPubkey.toBase58());\n log(' Merchant:', merchantPubkey.toBase58());\n log(' FeePayer:', feePayerPubkey.toBase58());\n log(' Mint:', mintPubkey.toBase58());\n log(' Amount:', paymentAmount.toString());\n\n // Determine token program (TOKEN_PROGRAM_ID vs TOKEN_2022)\n const mintInfo = await getMint(connection, mintPubkey);\n const programId = mintInfo.address.equals(mintPubkey)\n ? (mintInfo as any).owner?.toBase58?.() === TOKEN_2022_PROGRAM_ID.toBase58()\n ? TOKEN_2022_PROGRAM_ID\n : TOKEN_PROGRAM_ID\n : TOKEN_PROGRAM_ID;\n\n // Get ATAs\n const sourceAta = await getAssociatedTokenAddress(\n mintPubkey, userPubkey, false, programId,\n );\n const destinationAta = await getAssociatedTokenAddress(\n mintPubkey, merchantPubkey, true, programId,\n );\n\n log(' Source ATA:', sourceAta.toBase58());\n log(' Dest ATA:', destinationAta.toBase58());\n\n // Build transfer instruction\n const transferIx = createTransferCheckedInstruction(\n sourceAta,\n mintPubkey,\n destinationAta,\n userPubkey,\n paymentAmount,\n mintInfo.decimals,\n [],\n programId,\n );\n\n // Build versioned transaction with feePayer\n const { blockhash } = await connection.getLatestBlockhash('confirmed');\n const message = new TransactionMessage({\n payerKey: feePayerPubkey,\n recentBlockhash: blockhash,\n instructions: [transferIx],\n }).compileToV0Message();\n\n const transaction = new VersionedTransaction(message);\n\n // User signs (feePayer signs on backend/facilitator side)\n const signedTx = await solWallet.signTransaction!(transaction) as VersionedTransaction;\n log('Transaction signed by user');\n\n // Serialize to base64\n const serializedTx = Buffer.from(signedTx.serialize()).toString('base64');\n\n // Build x402 v2 payment payload\n const paymentPayload = {\n x402Version: 2,\n resource: requirements.resource || { url },\n accepted: accept,\n payload: {\n transaction: serializedTx,\n },\n };\n\n return btoa(JSON.stringify(paymentPayload));\n }\n\n // -----------------------------------------------------------------------\n // Main fetch\n // -----------------------------------------------------------------------\n async function x402Fetch(\n input: string | URL | Request,\n init?: RequestInit,\n ): Promise<Response> {\n const url = typeof input === 'string' ? input : input instanceof URL ? input.href : input.url;\n log('Request:', url);\n\n const response = await fetch(input, init);\n if (response.status !== 402) return response;\n\n log('Got 402 Payment Required');\n\n let requirements: any;\n try {\n requirements = await response.clone().json();\n } catch {\n throw new Error('[relai-x402] Failed to parse 402 response body');\n }\n\n const accepts = requirements.accepts || [];\n if (!accepts.length) throw new Error('[relai-x402] No payment options in 402 response');\n\n const selected = selectAccept(accepts);\n if (!selected) {\n const networks = accepts.map((a: any) => a.network).join(', ');\n throw new Error(`[relai-x402] No wallet available for networks: ${networks}`);\n }\n\n const { accept, chain } = selected;\n const amount = accept.amount || accept.maxAmountRequired;\n log(`Selected: ${chain} / ${accept.network} / amount=${amount}`);\n\n // Amount guard\n if (maxAmountAtomic && BigInt(amount) > BigInt(maxAmountAtomic)) {\n throw new Error(`[relai-x402] Amount ${amount} exceeds max ${maxAmountAtomic}`);\n }\n\n // Solana — build SPL transfer natively (no x402-solana dependency)\n if (chain === 'solana' && hasSolanaWallet) {\n const paymentHeader = await buildSolanaPayment(accept, requirements, url);\n log('Retrying with X-PAYMENT header (Solana)');\n return fetch(input, {\n ...init,\n headers: {\n ...(init?.headers || {}),\n 'X-PAYMENT': paymentHeader,\n },\n });\n }\n\n // EVM — build payment header and retry\n if (chain === 'evm') {\n const evmNetwork = normalizeNetwork(accept.network || '');\n const usePermit = evmNetwork && PERMIT_NETWORKS.has(evmNetwork);\n const paymentHeader = usePermit\n ? await buildEvmPermitPayment(accept, requirements, url)\n : await buildEvmPayment(accept, requirements, url);\n log('Retrying with X-PAYMENT header');\n return fetch(input, {\n ...init,\n headers: {\n ...(init?.headers || {}),\n 'X-PAYMENT': paymentHeader,\n },\n });\n }\n\n throw new Error('[relai-x402] Unexpected state — no payment handler matched');\n }\n\n return { fetch: x402Fetch };\n}\n\nexport default createX402Client;\n","// src/types.ts\n\n// ============================================================================\n// Constants\n// ============================================================================\n\n/** RelAI Facilitator URL */\nexport const RELAI_FACILITATOR_URL = 'https://facilitator.x402.fi';\n\n// ============================================================================\n// Supported Networks\n// ============================================================================\n\n/** All networks supported by RelAI facilitator */\nexport type RelaiNetwork = 'solana' | 'base' | 'avalanche' | 'skale-base';\n\n/** CAIP-2 network identifiers */\nexport const NETWORK_CAIP2: Record<RelaiNetwork, string> = {\n 'solana': 'solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp',\n 'base': 'eip155:8453',\n 'avalanche': 'eip155:43114',\n 'skale-base': 'eip155:1187947933',\n};\n\n/** Reverse lookup: CAIP-2 → simple network name */\nexport const CAIP2_TO_NETWORK: Record<string, RelaiNetwork> = Object.fromEntries(\n Object.entries(NETWORK_CAIP2).map(([k, v]) => [v, k as RelaiNetwork])\n) as Record<string, RelaiNetwork>;\n\n/** Chain IDs for EVM networks */\nexport const CHAIN_IDS: Record<string, number> = {\n 'base': 8453,\n 'avalanche': 43114,\n 'skale-base': 1187947933,\n};\n\n/** USDC contract addresses per network */\nexport const USDC_ADDRESSES: Record<RelaiNetwork, string> = {\n 'solana': 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v',\n 'base': '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',\n 'avalanche': '0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E',\n 'skale-base': '0x85889c8c714505E0c94b30fcfcF64fE3Ac8FCb20',\n};\n\n/** Explorer URLs per network */\nexport const EXPLORER_TX_URL: Record<RelaiNetwork, (tx: string) => string> = {\n 'solana': (tx) => `https://solscan.io/tx/${tx}`,\n 'base': (tx) => `https://basescan.org/tx/${tx}`,\n 'avalanche': (tx) => `https://snowtrace.io/tx/${tx}`,\n 'skale-base': (tx) => `https://skale-base-explorer.skalenodes.com/tx/${tx}`,\n};\n\n/** Human-readable network labels */\nexport const NETWORK_LABELS: Record<RelaiNetwork, string> = {\n 'solana': 'Solana',\n 'base': 'Base',\n 'avalanche': 'Avalanche',\n 'skale-base': 'SKALE Base',\n};\n\n/** Legacy CAIP-2 exports for backward compatibility */\nexport const SOLANA_MAINNET_NETWORK = NETWORK_CAIP2['solana'];\nexport const BASE_MAINNET_NETWORK = NETWORK_CAIP2['base'];\n\n/** Legacy USDC exports for backward compatibility */\nexport const USDC_SOLANA = USDC_ADDRESSES['solana'];\nexport const USDC_BASE = USDC_ADDRESSES['base'];\n\n/** All supported RelAI networks list */\nexport const RELAI_NETWORKS: RelaiNetwork[] = ['solana', 'base', 'avalanche', 'skale-base'];\n\n/** Check if a network is Solana-based */\nexport function isSolana(network: string): boolean {\n return network === 'solana' || network.startsWith('solana:');\n}\n\n/** Check if a network is EVM-based */\nexport function isEvm(network: string): boolean {\n return ['base', 'avalanche', 'skale-base'].includes(network) || network.startsWith('eip155:');\n}\n\n/** Normalize CAIP-2 or simple name to RelaiNetwork */\nexport function normalizeNetwork(network: string): RelaiNetwork | null {\n if (RELAI_NETWORKS.includes(network as RelaiNetwork)) return network as RelaiNetwork;\n const fromCaip2 = CAIP2_TO_NETWORK[network];\n if (fromCaip2) return fromCaip2;\n // Partial match\n if (network.startsWith('solana:')) return 'solana';\n if (network.startsWith('eip155:')) {\n const chainId = parseInt(network.split(':')[1]);\n const entry = Object.entries(CHAIN_IDS).find(([, id]) => id === chainId);\n if (entry) return entry[0] as RelaiNetwork;\n }\n return null;\n}\n\n// ============================================================================\n// Wallet Types\n// ============================================================================\n\n/** Solana wallet interface */\nexport interface SolanaWallet {\n publicKey: { toString(): string } | null;\n signTransaction: ((tx: unknown) => Promise<unknown>) | null;\n signAllTransactions?: ((txs: unknown[]) => Promise<unknown[]>) | null;\n}\n\n/** EVM wallet interface (viem-compatible) */\nexport interface EvmWallet {\n address: string;\n signTypedData: (params: unknown) => Promise<string>;\n chain?: { id: number };\n}\n\n/** Wallet set for multi-chain support */\nexport interface WalletSet {\n solana?: SolanaWallet;\n evm?: EvmWallet;\n}\n\n// ============================================================================\n// Payment Types\n// ============================================================================\n\n/** Extra fields in payment requirements */\nexport interface AcceptsExtra {\n feePayer?: string;\n decimals?: number;\n name?: string;\n version?: string;\n [key: string]: unknown;\n}\n\n/** A single payment option */\nexport interface PaymentAccept {\n x402Version?: 1 | 2;\n scheme: string;\n network: string;\n maxAmountRequired?: string;\n amount?: string;\n asset: string;\n payTo: string;\n maxTimeoutSeconds?: number;\n extra?: AcceptsExtra;\n resource?: string;\n description?: string;\n mimeType?: string;\n outputSchema?: unknown;\n}\n\n/** Resource info for v2 */\nexport interface ResourceInfo {\n url: string;\n description?: string;\n mimeType?: string;\n}\n\n/** Payment requirements (402 response) */\nexport interface PaymentRequired {\n x402Version: 1 | 2;\n error?: string;\n accepts: PaymentAccept[];\n resource?: ResourceInfo;\n extensions?: Record<string, unknown>;\n}\n\n// ============================================================================\n// Config Types\n// ============================================================================\n\nexport interface RelaiConfig {\n apiKey?: string;\n network?: RelaiNetwork;\n facilitatorUrl?: string;\n apiBaseUrl?: string;\n}\n\nexport type DynamicPrice = number | ((req: unknown) => number | Promise<number>);\n\nexport interface ProtectOptions {\n /** Price in USD (e.g., 0.01 for 1 cent) */\n price: DynamicPrice;\n /** Wallet address to receive payments */\n payTo: string;\n /** Description shown to payer */\n description?: string;\n /** Maximum timeout in seconds */\n maxTimeout?: number;\n /** Custom validation rules */\n customRules?: (req: unknown) => boolean | Promise<boolean>;\n onPaymentRequired?: (\n req: unknown,\n info: { price: number; description?: string; facilitatorUrl?: string }\n ) => void;\n onPaymentVerified?: (req: unknown, result: PaymentResult) => void;\n onError?: (req: unknown, error: unknown) => void;\n}\n\nexport interface PaymentResult {\n verified: boolean;\n transactionId?: string;\n amount?: number;\n currency?: string;\n error?: string;\n}\n"],"mappings":"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","names":[]}
1
+ {"version":3,"sources":["../src/client.ts","../src/types.ts"],"sourcesContent":["// src/client.ts\nimport {\n Connection,\n PublicKey,\n TransactionMessage,\n VersionedTransaction,\n} from '@solana/web3.js';\nimport {\n getAssociatedTokenAddress,\n createTransferCheckedInstruction,\n getMint,\n TOKEN_PROGRAM_ID,\n TOKEN_2022_PROGRAM_ID,\n} from '@solana/spl-token';\nimport type { SolanaWallet, EvmWallet, WalletSet } from './types';\nimport {\n RELAI_FACILITATOR_URL,\n NETWORK_CAIP2,\n CHAIN_IDS,\n isSolana,\n isEvm,\n normalizeNetwork,\n type RelaiNetwork,\n} from './types';\n\n// ============================================================================\n// Types\n// ============================================================================\n\nexport interface X402ClientConfig {\n /** Multi-chain wallets (Solana + EVM) */\n wallets?: WalletSet;\n /** Single Solana wallet (legacy shortcut) */\n wallet?: SolanaWallet;\n /** Custom facilitator URL, default: RelAI facilitator */\n facilitatorUrl?: string;\n /** Preferred network when multiple options available */\n preferredNetwork?: RelaiNetwork;\n /** Custom Solana RPC URL */\n solanaRpcUrl?: string;\n /** Custom EVM RPC URLs per network (e.g. { 'skale-base': 'https://...' }) */\n evmRpcUrls?: Record<string, string>;\n /** Maximum payment amount in atomic units */\n maxAmountAtomic?: string;\n /** Enable verbose logging */\n verbose?: boolean;\n}\n\nexport interface X402Client {\n /** Fetch with automatic x402 payment handling */\n fetch(input: string | URL | Request, init?: RequestInit): Promise<Response>;\n}\n\n/**\n * Create an x402 client for automatic payment handling.\n * Supports all RelAI facilitator networks: Solana, Base, Avalanche, SKALE Base.\n * Auto-detects the correct chain from the 402 response and picks the right\n * signing method (Solana SPL transfer, EVM EIP-3009 transferWithAuthorization).\n *\n * @example\n * ```typescript\n * import { createX402Client } from '@relai-fi/x402';\n *\n * const client = createX402Client({\n * wallets: { solana: solanaWallet, evm: evmWalletClient },\n * });\n *\n * // Automatically handles 402 on any RelAI-supported network\n * const response = await client.fetch('https://api.example.com/protected');\n * ```\n */\n// Networks that use EIP-2612 permit instead of EIP-3009 transferWithAuthorization (currently none)\nconst PERMIT_NETWORKS = new Set<string>([]);\n\n// Default EVM RPC URLs\nconst DEFAULT_EVM_RPC_URLS: Record<string, string> = {\n 'skale-base': 'https://skale-base.skalenodes.com/v1/base',\n 'base': 'https://mainnet.base.org',\n 'avalanche': 'https://api.avax.network/ext/bc/C/rpc',\n};\n\nexport function createX402Client(config: X402ClientConfig): X402Client {\n const {\n wallets = {},\n wallet: legacyWallet,\n facilitatorUrl = RELAI_FACILITATOR_URL,\n preferredNetwork,\n solanaRpcUrl = 'https://api.mainnet-beta.solana.com',\n evmRpcUrls = {},\n maxAmountAtomic,\n verbose = false,\n } = config;\n\n const log = verbose ? console.log.bind(console, '[relai-x402]') : () => {};\n\n // Merge legacy wallet into wallet set\n const effectiveWallets: WalletSet = { ...wallets };\n if (legacyWallet && !effectiveWallets.solana) {\n effectiveWallets.solana = legacyWallet;\n }\n\n const hasSolanaWallet = Boolean(\n effectiveWallets.solana?.publicKey && effectiveWallets.solana?.signTransaction\n );\n if (hasSolanaWallet) log('Solana wallet ready');\n\n // -----------------------------------------------------------------------\n // Select a payment option from the 402 response's `accepts` array\n // -----------------------------------------------------------------------\n function selectAccept(accepts: any[]): { accept: any; chain: 'solana' | 'evm' } | null {\n // 1) Preferred network first\n if (preferredNetwork) {\n const caip2 = NETWORK_CAIP2[preferredNetwork];\n for (const a of accepts) {\n const net = a.network || '';\n if (net === preferredNetwork || net === caip2) {\n const chain = isSolana(net) ? 'solana' as const : 'evm' as const;\n if ((chain === 'solana' && hasSolanaWallet) || (chain === 'evm' && effectiveWallets.evm)) {\n return { accept: a, chain };\n }\n }\n }\n }\n\n // 2) First option we have a wallet for\n for (const a of accepts) {\n const net = a.network || '';\n if (isSolana(net) && hasSolanaWallet) return { accept: a, chain: 'solana' };\n if (isEvm(net) && effectiveWallets.evm) return { accept: a, chain: 'evm' };\n }\n\n return null;\n }\n\n // -----------------------------------------------------------------------\n // JSON-RPC helper (for reading EVM contract state without ethers)\n // -----------------------------------------------------------------------\n async function evmRpcCall(rpcUrl: string, to: string, data: string): Promise<string> {\n const res = await fetch(rpcUrl, {\n method: 'POST',\n headers: { 'Content-Type': 'application/json' },\n body: JSON.stringify({\n jsonrpc: '2.0',\n method: 'eth_call',\n params: [{ to, data }, 'latest'],\n id: 1,\n }),\n });\n const json = await res.json();\n if (json.error) throw new Error(`RPC error: ${json.error.message}`);\n return json.result;\n }\n\n function getEvmRpcUrl(network: string): string {\n return evmRpcUrls[network] || DEFAULT_EVM_RPC_URLS[network] || '';\n }\n\n // -----------------------------------------------------------------------\n // Build EVM payment — EIP-2612 permit (for SKALE Base)\n // -----------------------------------------------------------------------\n async function buildEvmPermitPayment(\n accept: any,\n requirements: any,\n url: string,\n ): Promise<string> {\n const evmWallet = effectiveWallets.evm!;\n const extra = accept.extra || {};\n\n const rawNetwork = accept.network || '';\n const network = normalizeNetwork(rawNetwork);\n const chainId = network ? CHAIN_IDS[network] : parseInt(rawNetwork.split(':')[1] || '8453');\n const paymentAmount = accept.amount || accept.maxAmountRequired;\n const spender = extra.feePayer || accept.payTo;\n const usdcAddress = accept.asset;\n\n const rpcUrl = getEvmRpcUrl(network || rawNetwork);\n if (!rpcUrl) throw new Error(`[relai-x402] No EVM RPC URL for network ${network || rawNetwork}`);\n\n log('Building EIP-2612 permit on chain', chainId);\n\n // Read nonce from USDC contract: nonces(address) = 0x7ecebe00\n const paddedAddress = evmWallet.address.toLowerCase().replace('0x', '').padStart(64, '0');\n const nonceHex = await evmRpcCall(rpcUrl, usdcAddress, '0x7ecebe00' + paddedAddress);\n const nonce = nonceHex ? parseInt(nonceHex, 16) : 0;\n if (isNaN(nonce)) throw new Error(`[relai-x402] Failed to read permit nonce from ${usdcAddress} on ${rpcUrl}`);\n log(' Permit nonce:', nonce);\n\n // Read token name: name() = 0x06fdde03\n const nameHex = await evmRpcCall(rpcUrl, usdcAddress, '0x06fdde03');\n // Decode ABI-encoded string\n let tokenName = 'USD Coin';\n try {\n const offset = parseInt(nameHex.slice(2, 66), 16) * 2;\n const length = parseInt(nameHex.slice(2 + offset, 2 + offset + 64), 16);\n const hex = nameHex.slice(2 + offset + 64, 2 + offset + 64 + length * 2);\n tokenName = decodeURIComponent(hex.replace(/[0-9a-f]{2}/g, '%$&'));\n } catch {\n tokenName = extra.name || 'USD Coin';\n }\n log(' Token name:', tokenName);\n\n const deadline = Math.floor(Date.now() / 1000) + 600; // 10 min\n\n const domain = {\n name: tokenName,\n version: extra.version || '2',\n chainId,\n verifyingContract: usdcAddress,\n };\n\n const types = {\n Permit: [\n { name: 'owner', type: 'address' },\n { name: 'spender', type: 'address' },\n { name: 'value', type: 'uint256' },\n { name: 'nonce', type: 'uint256' },\n { name: 'deadline', type: 'uint256' },\n ],\n };\n\n const message = {\n owner: evmWallet.address,\n spender,\n value: paymentAmount,\n nonce: String(nonce),\n deadline: String(deadline),\n };\n\n log('Signing EIP-2612 permit:', message);\n\n const signature = await evmWallet.signTypedData({\n domain,\n types,\n message,\n primaryType: 'Permit',\n });\n\n // Split signature into v, r, s\n const sigHex = (signature as string).replace('0x', '');\n const r = '0x' + sigHex.slice(0, 64);\n const s = '0x' + sigHex.slice(64, 128);\n const v = parseInt(sigHex.slice(128, 130), 16);\n\n log(' Permit signed: v=%d r=%s s=%s', v, r, s);\n\n // Build x402 v2 payment payload (SKALE format)\n const paymentPayload = {\n x402Version: 2,\n scheme: 'exact',\n network: network || rawNetwork,\n payload: {\n userAddress: evmWallet.address,\n permit: { deadline: String(deadline), v, r, s },\n amount: paymentAmount,\n },\n };\n\n return btoa(JSON.stringify(paymentPayload));\n }\n\n // -----------------------------------------------------------------------\n // Build EVM payment (EIP-3009 transferWithAuthorization)\n // -----------------------------------------------------------------------\n async function buildEvmPayment(\n accept: any,\n requirements: any,\n url: string,\n ): Promise<string> {\n const evmWallet = effectiveWallets.evm!;\n const extra = accept.extra || {};\n\n const rawNetwork = accept.network || '';\n const network = normalizeNetwork(rawNetwork);\n const chainId = network ? CHAIN_IDS[network] : parseInt(rawNetwork.split(':')[1] || '8453');\n\n const paymentAmount = accept.amount || accept.maxAmountRequired;\n\n // EIP-3009 transferWithAuthorization typed data\n const domain = {\n name: extra.name || 'USD Coin',\n version: extra.version || '2',\n chainId,\n verifyingContract: accept.asset,\n };\n\n const validAfter = 0;\n const validBefore = Math.floor(Date.now() / 1000) + 3600;\n const nonce = '0x' + [...crypto.getRandomValues(new Uint8Array(32))]\n .map(b => b.toString(16).padStart(2, '0')).join('');\n\n const types = {\n TransferWithAuthorization: [\n { name: 'from', type: 'address' },\n { name: 'to', type: 'address' },\n { name: 'value', type: 'uint256' },\n { name: 'validAfter', type: 'uint256' },\n { name: 'validBefore', type: 'uint256' },\n { name: 'nonce', type: 'bytes32' },\n ],\n };\n\n const spender = extra.feePayer || accept.payTo;\n\n const message = {\n from: evmWallet.address,\n to: spender,\n value: paymentAmount,\n validAfter: String(validAfter),\n validBefore: String(validBefore),\n nonce,\n };\n\n log('Signing EIP-3009 transferWithAuthorization on chain', chainId);\n\n const signature = await evmWallet.signTypedData({\n domain,\n types,\n message,\n primaryType: 'TransferWithAuthorization',\n });\n\n // Build x402 v2 payment payload\n const paymentPayload = {\n x402Version: 2,\n resource: requirements.resource || { url },\n accepted: accept,\n payload: {\n authorization: message,\n signature,\n },\n facilitatorUrl,\n };\n\n return btoa(JSON.stringify(paymentPayload));\n }\n\n // -----------------------------------------------------------------------\n // Build Solana payment (SPL transfer with fee payer sponsorship)\n // -----------------------------------------------------------------------\n async function buildSolanaPayment(\n accept: any,\n requirements: any,\n url: string,\n ): Promise<string> {\n const solWallet = effectiveWallets.solana!;\n const extra = accept.extra || {};\n\n if (!extra.feePayer) {\n throw new Error('[relai-x402] Missing feePayer in Solana payment requirements');\n }\n\n const connection = new Connection(solanaRpcUrl, 'confirmed');\n const userPubkey = new PublicKey(solWallet.publicKey!.toString());\n const merchantPubkey = new PublicKey(accept.payTo);\n const feePayerPubkey = new PublicKey(extra.feePayer);\n const mintPubkey = new PublicKey(accept.asset);\n const paymentAmount = BigInt(accept.amount || accept.maxAmountRequired);\n\n log('Building Solana SPL transfer');\n log(' User:', userPubkey.toBase58());\n log(' Merchant:', merchantPubkey.toBase58());\n log(' FeePayer:', feePayerPubkey.toBase58());\n log(' Mint:', mintPubkey.toBase58());\n log(' Amount:', paymentAmount.toString());\n\n // Determine token program (TOKEN_PROGRAM_ID vs TOKEN_2022)\n const mintInfo = await getMint(connection, mintPubkey);\n const programId = mintInfo.address.equals(mintPubkey)\n ? (mintInfo as any).owner?.toBase58?.() === TOKEN_2022_PROGRAM_ID.toBase58()\n ? TOKEN_2022_PROGRAM_ID\n : TOKEN_PROGRAM_ID\n : TOKEN_PROGRAM_ID;\n\n // Get ATAs\n const sourceAta = await getAssociatedTokenAddress(\n mintPubkey, userPubkey, false, programId,\n );\n const destinationAta = await getAssociatedTokenAddress(\n mintPubkey, merchantPubkey, true, programId,\n );\n\n log(' Source ATA:', sourceAta.toBase58());\n log(' Dest ATA:', destinationAta.toBase58());\n\n // Build transfer instruction\n const transferIx = createTransferCheckedInstruction(\n sourceAta,\n mintPubkey,\n destinationAta,\n userPubkey,\n paymentAmount,\n mintInfo.decimals,\n [],\n programId,\n );\n\n // Build versioned transaction with feePayer\n const { blockhash } = await connection.getLatestBlockhash('confirmed');\n const message = new TransactionMessage({\n payerKey: feePayerPubkey,\n recentBlockhash: blockhash,\n instructions: [transferIx],\n }).compileToV0Message();\n\n const transaction = new VersionedTransaction(message);\n\n // User signs (feePayer signs on backend/facilitator side)\n const signedTx = await solWallet.signTransaction!(transaction) as VersionedTransaction;\n log('Transaction signed by user');\n\n // Serialize to base64\n const serializedTx = Buffer.from(signedTx.serialize()).toString('base64');\n\n // Build x402 v2 payment payload\n const paymentPayload = {\n x402Version: 2,\n resource: requirements.resource || { url },\n accepted: accept,\n payload: {\n transaction: serializedTx,\n },\n };\n\n return btoa(JSON.stringify(paymentPayload));\n }\n\n // -----------------------------------------------------------------------\n // Main fetch\n // -----------------------------------------------------------------------\n async function x402Fetch(\n input: string | URL | Request,\n init?: RequestInit,\n ): Promise<Response> {\n const url = typeof input === 'string' ? input : input instanceof URL ? input.href : input.url;\n log('Request:', url);\n\n const response = await fetch(input, init);\n if (response.status !== 402) return response;\n\n log('Got 402 Payment Required');\n\n let requirements: any;\n try {\n requirements = await response.clone().json();\n } catch {\n throw new Error('[relai-x402] Failed to parse 402 response body');\n }\n\n const accepts = requirements.accepts || [];\n if (!accepts.length) throw new Error('[relai-x402] No payment options in 402 response');\n\n const selected = selectAccept(accepts);\n if (!selected) {\n const networks = accepts.map((a: any) => a.network).join(', ');\n throw new Error(`[relai-x402] No wallet available for networks: ${networks}`);\n }\n\n const { accept, chain } = selected;\n const amount = accept.amount || accept.maxAmountRequired;\n log(`Selected: ${chain} / ${accept.network} / amount=${amount}`);\n\n // Amount guard\n if (maxAmountAtomic && BigInt(amount) > BigInt(maxAmountAtomic)) {\n throw new Error(`[relai-x402] Amount ${amount} exceeds max ${maxAmountAtomic}`);\n }\n\n // Solana — build SPL transfer natively (no x402-solana dependency)\n if (chain === 'solana' && hasSolanaWallet) {\n const paymentHeader = await buildSolanaPayment(accept, requirements, url);\n log('Retrying with X-PAYMENT header (Solana)');\n return fetch(input, {\n ...init,\n headers: {\n ...(init?.headers || {}),\n 'X-PAYMENT': paymentHeader,\n },\n });\n }\n\n // EVM — build payment header and retry\n if (chain === 'evm') {\n const evmNetwork = normalizeNetwork(accept.network || '');\n const usePermit = evmNetwork && PERMIT_NETWORKS.has(evmNetwork);\n const paymentHeader = usePermit\n ? await buildEvmPermitPayment(accept, requirements, url)\n : await buildEvmPayment(accept, requirements, url);\n log('Retrying with X-PAYMENT header');\n return fetch(input, {\n ...init,\n headers: {\n ...(init?.headers || {}),\n 'X-PAYMENT': paymentHeader,\n },\n });\n }\n\n throw new Error('[relai-x402] Unexpected state — no payment handler matched');\n }\n\n return { fetch: x402Fetch };\n}\n\nexport default createX402Client;\n","// src/types.ts\n\n// ============================================================================\n// Constants\n// ============================================================================\n\n/** RelAI Facilitator URL */\nexport const RELAI_FACILITATOR_URL = 'https://facilitator.x402.fi';\n\n// ============================================================================\n// Supported Networks\n// ============================================================================\n\n/** All networks supported by RelAI facilitator */\nexport type RelaiNetwork = 'solana' | 'base' | 'avalanche' | 'skale-base';\n\n/** CAIP-2 network identifiers */\nexport const NETWORK_CAIP2: Record<RelaiNetwork, string> = {\n 'solana': 'solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp',\n 'base': 'eip155:8453',\n 'avalanche': 'eip155:43114',\n 'skale-base': 'eip155:1187947933',\n};\n\n/** Reverse lookup: CAIP-2 → simple network name */\nexport const CAIP2_TO_NETWORK: Record<string, RelaiNetwork> = Object.fromEntries(\n Object.entries(NETWORK_CAIP2).map(([k, v]) => [v, k as RelaiNetwork])\n) as Record<string, RelaiNetwork>;\n\n/** Chain IDs for EVM networks */\nexport const CHAIN_IDS: Record<string, number> = {\n 'base': 8453,\n 'avalanche': 43114,\n 'skale-base': 1187947933,\n};\n\n/** USDC contract addresses per network */\nexport const USDC_ADDRESSES: Record<RelaiNetwork, string> = {\n 'solana': 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v',\n 'base': '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',\n 'avalanche': '0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E',\n 'skale-base': '0x85889c8c714505E0c94b30fcfcF64fE3Ac8FCb20',\n};\n\n/** Explorer URLs per network */\nexport const EXPLORER_TX_URL: Record<RelaiNetwork, (tx: string) => string> = {\n 'solana': (tx) => `https://solscan.io/tx/${tx}`,\n 'base': (tx) => `https://basescan.org/tx/${tx}`,\n 'avalanche': (tx) => `https://snowtrace.io/tx/${tx}`,\n 'skale-base': (tx) => `https://skale-base-explorer.skalenodes.com/tx/${tx}`,\n};\n\n/** Human-readable network labels */\nexport const NETWORK_LABELS: Record<RelaiNetwork, string> = {\n 'solana': 'Solana',\n 'base': 'Base',\n 'avalanche': 'Avalanche',\n 'skale-base': 'SKALE Base',\n};\n\n/** Legacy CAIP-2 exports for backward compatibility */\nexport const SOLANA_MAINNET_NETWORK = NETWORK_CAIP2['solana'];\nexport const BASE_MAINNET_NETWORK = NETWORK_CAIP2['base'];\n\n/** Legacy USDC exports for backward compatibility */\nexport const USDC_SOLANA = USDC_ADDRESSES['solana'];\nexport const USDC_BASE = USDC_ADDRESSES['base'];\n\n/** All supported RelAI networks list */\nexport const RELAI_NETWORKS: RelaiNetwork[] = ['solana', 'base', 'avalanche', 'skale-base'];\n\n/** Check if a network is Solana-based */\nexport function isSolana(network: string): boolean {\n return network === 'solana' || network.startsWith('solana:');\n}\n\n/** Check if a network is EVM-based */\nexport function isEvm(network: string): boolean {\n return ['base', 'avalanche', 'skale-base'].includes(network) || network.startsWith('eip155:');\n}\n\n/** Normalize CAIP-2 or simple name to RelaiNetwork */\nexport function normalizeNetwork(network: string): RelaiNetwork | null {\n if (RELAI_NETWORKS.includes(network as RelaiNetwork)) return network as RelaiNetwork;\n const fromCaip2 = CAIP2_TO_NETWORK[network];\n if (fromCaip2) return fromCaip2;\n // Partial match\n if (network.startsWith('solana:')) return 'solana';\n if (network.startsWith('eip155:')) {\n const chainId = parseInt(network.split(':')[1]);\n const entry = Object.entries(CHAIN_IDS).find(([, id]) => id === chainId);\n if (entry) return entry[0] as RelaiNetwork;\n }\n return null;\n}\n\n// ============================================================================\n// Wallet Types\n// ============================================================================\n\n/** Solana wallet interface */\nexport interface SolanaWallet {\n publicKey: { toString(): string } | null;\n signTransaction: ((tx: unknown) => Promise<unknown>) | null;\n signAllTransactions?: ((txs: unknown[]) => Promise<unknown[]>) | null;\n}\n\n/** EVM wallet interface (viem-compatible) */\nexport interface EvmWallet {\n address: string;\n signTypedData: (params: unknown) => Promise<string>;\n chain?: { id: number };\n}\n\n/** Wallet set for multi-chain support */\nexport interface WalletSet {\n solana?: SolanaWallet;\n evm?: EvmWallet;\n}\n\n// ============================================================================\n// Payment Types\n// ============================================================================\n\n/** Extra fields in payment requirements */\nexport interface AcceptsExtra {\n feePayer?: string;\n decimals?: number;\n name?: string;\n version?: string;\n [key: string]: unknown;\n}\n\n/** A single payment option */\nexport interface PaymentAccept {\n x402Version?: 1 | 2;\n scheme: string;\n network: string;\n maxAmountRequired?: string;\n amount?: string;\n asset: string;\n payTo: string;\n maxTimeoutSeconds?: number;\n extra?: AcceptsExtra;\n resource?: string;\n description?: string;\n mimeType?: string;\n outputSchema?: unknown;\n}\n\n/** Resource info for v2 */\nexport interface ResourceInfo {\n url: string;\n description?: string;\n mimeType?: string;\n}\n\n/** Payment requirements (402 response) */\nexport interface PaymentRequired {\n x402Version: 1 | 2;\n error?: string;\n accepts: PaymentAccept[];\n resource?: ResourceInfo;\n extensions?: Record<string, unknown>;\n}\n\n// ============================================================================\n// Config Types (server-specific types are in server.ts)\n// ============================================================================\n"],"mappings":"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","names":[]}
package/dist/client.d.cts CHANGED
@@ -1,4 +1,4 @@
1
- import { W as WalletSet, h as SolanaWallet, a as RelaiNetwork } from './types-DGRfrYd3.cjs';
1
+ import { W as WalletSet, h as SolanaWallet, a as RelaiNetwork } from './types-Bw8MIl3i.cjs';
2
2
 
3
3
  interface X402ClientConfig {
4
4
  /** Multi-chain wallets (Solana + EVM) */
package/dist/client.d.ts CHANGED
@@ -1,4 +1,4 @@
1
- import { W as WalletSet, h as SolanaWallet, a as RelaiNetwork } from './types-DGRfrYd3.js';
1
+ import { W as WalletSet, h as SolanaWallet, a as RelaiNetwork } from './types-Bw8MIl3i.js';
2
2
 
3
3
  interface X402ClientConfig {
4
4
  /** Multi-chain wallets (Solana + EVM) */
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/client.ts","../src/types.ts"],"sourcesContent":["// src/client.ts\nimport {\n Connection,\n PublicKey,\n TransactionMessage,\n VersionedTransaction,\n} from '@solana/web3.js';\nimport {\n getAssociatedTokenAddress,\n createTransferCheckedInstruction,\n getMint,\n TOKEN_PROGRAM_ID,\n TOKEN_2022_PROGRAM_ID,\n} from '@solana/spl-token';\nimport type { SolanaWallet, EvmWallet, WalletSet } from './types';\nimport {\n RELAI_FACILITATOR_URL,\n NETWORK_CAIP2,\n CHAIN_IDS,\n isSolana,\n isEvm,\n normalizeNetwork,\n type RelaiNetwork,\n} from './types';\n\n// ============================================================================\n// Types\n// ============================================================================\n\nexport interface X402ClientConfig {\n /** Multi-chain wallets (Solana + EVM) */\n wallets?: WalletSet;\n /** Single Solana wallet (legacy shortcut) */\n wallet?: SolanaWallet;\n /** Custom facilitator URL, default: RelAI facilitator */\n facilitatorUrl?: string;\n /** Preferred network when multiple options available */\n preferredNetwork?: RelaiNetwork;\n /** Custom Solana RPC URL */\n solanaRpcUrl?: string;\n /** Custom EVM RPC URLs per network (e.g. { 'skale-base': 'https://...' }) */\n evmRpcUrls?: Record<string, string>;\n /** Maximum payment amount in atomic units */\n maxAmountAtomic?: string;\n /** Enable verbose logging */\n verbose?: boolean;\n}\n\nexport interface X402Client {\n /** Fetch with automatic x402 payment handling */\n fetch(input: string | URL | Request, init?: RequestInit): Promise<Response>;\n}\n\n/**\n * Create an x402 client for automatic payment handling.\n * Supports all RelAI facilitator networks: Solana, Base, Avalanche, SKALE Base.\n * Auto-detects the correct chain from the 402 response and picks the right\n * signing method (Solana SPL transfer, EVM EIP-3009 transferWithAuthorization).\n *\n * @example\n * ```typescript\n * import { createX402Client } from '@relai-fi/x402';\n *\n * const client = createX402Client({\n * wallets: { solana: solanaWallet, evm: evmWalletClient },\n * });\n *\n * // Automatically handles 402 on any RelAI-supported network\n * const response = await client.fetch('https://api.example.com/protected');\n * ```\n */\n// Networks that use EIP-2612 permit instead of EIP-3009 transferWithAuthorization (currently none)\nconst PERMIT_NETWORKS = new Set<string>([]);\n\n// Default EVM RPC URLs\nconst DEFAULT_EVM_RPC_URLS: Record<string, string> = {\n 'skale-base': 'https://skale-base.skalenodes.com/v1/base',\n 'base': 'https://mainnet.base.org',\n 'avalanche': 'https://api.avax.network/ext/bc/C/rpc',\n};\n\nexport function createX402Client(config: X402ClientConfig): X402Client {\n const {\n wallets = {},\n wallet: legacyWallet,\n facilitatorUrl = RELAI_FACILITATOR_URL,\n preferredNetwork,\n solanaRpcUrl = 'https://api.mainnet-beta.solana.com',\n evmRpcUrls = {},\n maxAmountAtomic,\n verbose = false,\n } = config;\n\n const log = verbose ? console.log.bind(console, '[relai-x402]') : () => {};\n\n // Merge legacy wallet into wallet set\n const effectiveWallets: WalletSet = { ...wallets };\n if (legacyWallet && !effectiveWallets.solana) {\n effectiveWallets.solana = legacyWallet;\n }\n\n const hasSolanaWallet = Boolean(\n effectiveWallets.solana?.publicKey && effectiveWallets.solana?.signTransaction\n );\n if (hasSolanaWallet) log('Solana wallet ready');\n\n // -----------------------------------------------------------------------\n // Select a payment option from the 402 response's `accepts` array\n // -----------------------------------------------------------------------\n function selectAccept(accepts: any[]): { accept: any; chain: 'solana' | 'evm' } | null {\n // 1) Preferred network first\n if (preferredNetwork) {\n const caip2 = NETWORK_CAIP2[preferredNetwork];\n for (const a of accepts) {\n const net = a.network || '';\n if (net === preferredNetwork || net === caip2) {\n const chain = isSolana(net) ? 'solana' as const : 'evm' as const;\n if ((chain === 'solana' && hasSolanaWallet) || (chain === 'evm' && effectiveWallets.evm)) {\n return { accept: a, chain };\n }\n }\n }\n }\n\n // 2) First option we have a wallet for\n for (const a of accepts) {\n const net = a.network || '';\n if (isSolana(net) && hasSolanaWallet) return { accept: a, chain: 'solana' };\n if (isEvm(net) && effectiveWallets.evm) return { accept: a, chain: 'evm' };\n }\n\n return null;\n }\n\n // -----------------------------------------------------------------------\n // JSON-RPC helper (for reading EVM contract state without ethers)\n // -----------------------------------------------------------------------\n async function evmRpcCall(rpcUrl: string, to: string, data: string): Promise<string> {\n const res = await fetch(rpcUrl, {\n method: 'POST',\n headers: { 'Content-Type': 'application/json' },\n body: JSON.stringify({\n jsonrpc: '2.0',\n method: 'eth_call',\n params: [{ to, data }, 'latest'],\n id: 1,\n }),\n });\n const json = await res.json();\n if (json.error) throw new Error(`RPC error: ${json.error.message}`);\n return json.result;\n }\n\n function getEvmRpcUrl(network: string): string {\n return evmRpcUrls[network] || DEFAULT_EVM_RPC_URLS[network] || '';\n }\n\n // -----------------------------------------------------------------------\n // Build EVM payment — EIP-2612 permit (for SKALE Base)\n // -----------------------------------------------------------------------\n async function buildEvmPermitPayment(\n accept: any,\n requirements: any,\n url: string,\n ): Promise<string> {\n const evmWallet = effectiveWallets.evm!;\n const extra = accept.extra || {};\n\n const rawNetwork = accept.network || '';\n const network = normalizeNetwork(rawNetwork);\n const chainId = network ? CHAIN_IDS[network] : parseInt(rawNetwork.split(':')[1] || '8453');\n const paymentAmount = accept.amount || accept.maxAmountRequired;\n const spender = extra.feePayer || accept.payTo;\n const usdcAddress = accept.asset;\n\n const rpcUrl = getEvmRpcUrl(network || rawNetwork);\n if (!rpcUrl) throw new Error(`[relai-x402] No EVM RPC URL for network ${network || rawNetwork}`);\n\n log('Building EIP-2612 permit on chain', chainId);\n\n // Read nonce from USDC contract: nonces(address) = 0x7ecebe00\n const paddedAddress = evmWallet.address.toLowerCase().replace('0x', '').padStart(64, '0');\n const nonceHex = await evmRpcCall(rpcUrl, usdcAddress, '0x7ecebe00' + paddedAddress);\n const nonce = nonceHex ? parseInt(nonceHex, 16) : 0;\n if (isNaN(nonce)) throw new Error(`[relai-x402] Failed to read permit nonce from ${usdcAddress} on ${rpcUrl}`);\n log(' Permit nonce:', nonce);\n\n // Read token name: name() = 0x06fdde03\n const nameHex = await evmRpcCall(rpcUrl, usdcAddress, '0x06fdde03');\n // Decode ABI-encoded string\n let tokenName = 'USD Coin';\n try {\n const offset = parseInt(nameHex.slice(2, 66), 16) * 2;\n const length = parseInt(nameHex.slice(2 + offset, 2 + offset + 64), 16);\n const hex = nameHex.slice(2 + offset + 64, 2 + offset + 64 + length * 2);\n tokenName = decodeURIComponent(hex.replace(/[0-9a-f]{2}/g, '%$&'));\n } catch {\n tokenName = extra.name || 'USD Coin';\n }\n log(' Token name:', tokenName);\n\n const deadline = Math.floor(Date.now() / 1000) + 600; // 10 min\n\n const domain = {\n name: tokenName,\n version: extra.version || '2',\n chainId,\n verifyingContract: usdcAddress,\n };\n\n const types = {\n Permit: [\n { name: 'owner', type: 'address' },\n { name: 'spender', type: 'address' },\n { name: 'value', type: 'uint256' },\n { name: 'nonce', type: 'uint256' },\n { name: 'deadline', type: 'uint256' },\n ],\n };\n\n const message = {\n owner: evmWallet.address,\n spender,\n value: paymentAmount,\n nonce: String(nonce),\n deadline: String(deadline),\n };\n\n log('Signing EIP-2612 permit:', message);\n\n const signature = await evmWallet.signTypedData({\n domain,\n types,\n message,\n primaryType: 'Permit',\n });\n\n // Split signature into v, r, s\n const sigHex = (signature as string).replace('0x', '');\n const r = '0x' + sigHex.slice(0, 64);\n const s = '0x' + sigHex.slice(64, 128);\n const v = parseInt(sigHex.slice(128, 130), 16);\n\n log(' Permit signed: v=%d r=%s s=%s', v, r, s);\n\n // Build x402 v2 payment payload (SKALE format)\n const paymentPayload = {\n x402Version: 2,\n scheme: 'exact',\n network: network || rawNetwork,\n payload: {\n userAddress: evmWallet.address,\n permit: { deadline: String(deadline), v, r, s },\n amount: paymentAmount,\n },\n };\n\n return btoa(JSON.stringify(paymentPayload));\n }\n\n // -----------------------------------------------------------------------\n // Build EVM payment (EIP-3009 transferWithAuthorization)\n // -----------------------------------------------------------------------\n async function buildEvmPayment(\n accept: any,\n requirements: any,\n url: string,\n ): Promise<string> {\n const evmWallet = effectiveWallets.evm!;\n const extra = accept.extra || {};\n\n const rawNetwork = accept.network || '';\n const network = normalizeNetwork(rawNetwork);\n const chainId = network ? CHAIN_IDS[network] : parseInt(rawNetwork.split(':')[1] || '8453');\n\n const paymentAmount = accept.amount || accept.maxAmountRequired;\n\n // EIP-3009 transferWithAuthorization typed data\n const domain = {\n name: extra.name || 'USD Coin',\n version: extra.version || '2',\n chainId,\n verifyingContract: accept.asset,\n };\n\n const validAfter = 0;\n const validBefore = Math.floor(Date.now() / 1000) + 3600;\n const nonce = '0x' + [...crypto.getRandomValues(new Uint8Array(32))]\n .map(b => b.toString(16).padStart(2, '0')).join('');\n\n const types = {\n TransferWithAuthorization: [\n { name: 'from', type: 'address' },\n { name: 'to', type: 'address' },\n { name: 'value', type: 'uint256' },\n { name: 'validAfter', type: 'uint256' },\n { name: 'validBefore', type: 'uint256' },\n { name: 'nonce', type: 'bytes32' },\n ],\n };\n\n const spender = extra.feePayer || accept.payTo;\n\n const message = {\n from: evmWallet.address,\n to: spender,\n value: paymentAmount,\n validAfter: String(validAfter),\n validBefore: String(validBefore),\n nonce,\n };\n\n log('Signing EIP-3009 transferWithAuthorization on chain', chainId);\n\n const signature = await evmWallet.signTypedData({\n domain,\n types,\n message,\n primaryType: 'TransferWithAuthorization',\n });\n\n // Build x402 v2 payment payload\n const paymentPayload = {\n x402Version: 2,\n resource: requirements.resource || { url },\n accepted: accept,\n payload: {\n authorization: message,\n signature,\n },\n facilitatorUrl,\n };\n\n return btoa(JSON.stringify(paymentPayload));\n }\n\n // -----------------------------------------------------------------------\n // Build Solana payment (SPL transfer with fee payer sponsorship)\n // -----------------------------------------------------------------------\n async function buildSolanaPayment(\n accept: any,\n requirements: any,\n url: string,\n ): Promise<string> {\n const solWallet = effectiveWallets.solana!;\n const extra = accept.extra || {};\n\n if (!extra.feePayer) {\n throw new Error('[relai-x402] Missing feePayer in Solana payment requirements');\n }\n\n const connection = new Connection(solanaRpcUrl, 'confirmed');\n const userPubkey = new PublicKey(solWallet.publicKey!.toString());\n const merchantPubkey = new PublicKey(accept.payTo);\n const feePayerPubkey = new PublicKey(extra.feePayer);\n const mintPubkey = new PublicKey(accept.asset);\n const paymentAmount = BigInt(accept.amount || accept.maxAmountRequired);\n\n log('Building Solana SPL transfer');\n log(' User:', userPubkey.toBase58());\n log(' Merchant:', merchantPubkey.toBase58());\n log(' FeePayer:', feePayerPubkey.toBase58());\n log(' Mint:', mintPubkey.toBase58());\n log(' Amount:', paymentAmount.toString());\n\n // Determine token program (TOKEN_PROGRAM_ID vs TOKEN_2022)\n const mintInfo = await getMint(connection, mintPubkey);\n const programId = mintInfo.address.equals(mintPubkey)\n ? (mintInfo as any).owner?.toBase58?.() === TOKEN_2022_PROGRAM_ID.toBase58()\n ? TOKEN_2022_PROGRAM_ID\n : TOKEN_PROGRAM_ID\n : TOKEN_PROGRAM_ID;\n\n // Get ATAs\n const sourceAta = await getAssociatedTokenAddress(\n mintPubkey, userPubkey, false, programId,\n );\n const destinationAta = await getAssociatedTokenAddress(\n mintPubkey, merchantPubkey, true, programId,\n );\n\n log(' Source ATA:', sourceAta.toBase58());\n log(' Dest ATA:', destinationAta.toBase58());\n\n // Build transfer instruction\n const transferIx = createTransferCheckedInstruction(\n sourceAta,\n mintPubkey,\n destinationAta,\n userPubkey,\n paymentAmount,\n mintInfo.decimals,\n [],\n programId,\n );\n\n // Build versioned transaction with feePayer\n const { blockhash } = await connection.getLatestBlockhash('confirmed');\n const message = new TransactionMessage({\n payerKey: feePayerPubkey,\n recentBlockhash: blockhash,\n instructions: [transferIx],\n }).compileToV0Message();\n\n const transaction = new VersionedTransaction(message);\n\n // User signs (feePayer signs on backend/facilitator side)\n const signedTx = await solWallet.signTransaction!(transaction) as VersionedTransaction;\n log('Transaction signed by user');\n\n // Serialize to base64\n const serializedTx = Buffer.from(signedTx.serialize()).toString('base64');\n\n // Build x402 v2 payment payload\n const paymentPayload = {\n x402Version: 2,\n resource: requirements.resource || { url },\n accepted: accept,\n payload: {\n transaction: serializedTx,\n },\n };\n\n return btoa(JSON.stringify(paymentPayload));\n }\n\n // -----------------------------------------------------------------------\n // Main fetch\n // -----------------------------------------------------------------------\n async function x402Fetch(\n input: string | URL | Request,\n init?: RequestInit,\n ): Promise<Response> {\n const url = typeof input === 'string' ? input : input instanceof URL ? input.href : input.url;\n log('Request:', url);\n\n const response = await fetch(input, init);\n if (response.status !== 402) return response;\n\n log('Got 402 Payment Required');\n\n let requirements: any;\n try {\n requirements = await response.clone().json();\n } catch {\n throw new Error('[relai-x402] Failed to parse 402 response body');\n }\n\n const accepts = requirements.accepts || [];\n if (!accepts.length) throw new Error('[relai-x402] No payment options in 402 response');\n\n const selected = selectAccept(accepts);\n if (!selected) {\n const networks = accepts.map((a: any) => a.network).join(', ');\n throw new Error(`[relai-x402] No wallet available for networks: ${networks}`);\n }\n\n const { accept, chain } = selected;\n const amount = accept.amount || accept.maxAmountRequired;\n log(`Selected: ${chain} / ${accept.network} / amount=${amount}`);\n\n // Amount guard\n if (maxAmountAtomic && BigInt(amount) > BigInt(maxAmountAtomic)) {\n throw new Error(`[relai-x402] Amount ${amount} exceeds max ${maxAmountAtomic}`);\n }\n\n // Solana — build SPL transfer natively (no x402-solana dependency)\n if (chain === 'solana' && hasSolanaWallet) {\n const paymentHeader = await buildSolanaPayment(accept, requirements, url);\n log('Retrying with X-PAYMENT header (Solana)');\n return fetch(input, {\n ...init,\n headers: {\n ...(init?.headers || {}),\n 'X-PAYMENT': paymentHeader,\n },\n });\n }\n\n // EVM — build payment header and retry\n if (chain === 'evm') {\n const evmNetwork = normalizeNetwork(accept.network || '');\n const usePermit = evmNetwork && PERMIT_NETWORKS.has(evmNetwork);\n const paymentHeader = usePermit\n ? await buildEvmPermitPayment(accept, requirements, url)\n : await buildEvmPayment(accept, requirements, url);\n log('Retrying with X-PAYMENT header');\n return fetch(input, {\n ...init,\n headers: {\n ...(init?.headers || {}),\n 'X-PAYMENT': paymentHeader,\n },\n });\n }\n\n throw new Error('[relai-x402] Unexpected state — no payment handler matched');\n }\n\n return { fetch: x402Fetch };\n}\n\nexport default createX402Client;\n","// src/types.ts\n\n// ============================================================================\n// Constants\n// ============================================================================\n\n/** RelAI Facilitator URL */\nexport const RELAI_FACILITATOR_URL = 'https://facilitator.x402.fi';\n\n// ============================================================================\n// Supported Networks\n// ============================================================================\n\n/** All networks supported by RelAI facilitator */\nexport type RelaiNetwork = 'solana' | 'base' | 'avalanche' | 'skale-base';\n\n/** CAIP-2 network identifiers */\nexport const NETWORK_CAIP2: Record<RelaiNetwork, string> = {\n 'solana': 'solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp',\n 'base': 'eip155:8453',\n 'avalanche': 'eip155:43114',\n 'skale-base': 'eip155:1187947933',\n};\n\n/** Reverse lookup: CAIP-2 → simple network name */\nexport const CAIP2_TO_NETWORK: Record<string, RelaiNetwork> = Object.fromEntries(\n Object.entries(NETWORK_CAIP2).map(([k, v]) => [v, k as RelaiNetwork])\n) as Record<string, RelaiNetwork>;\n\n/** Chain IDs for EVM networks */\nexport const CHAIN_IDS: Record<string, number> = {\n 'base': 8453,\n 'avalanche': 43114,\n 'skale-base': 1187947933,\n};\n\n/** USDC contract addresses per network */\nexport const USDC_ADDRESSES: Record<RelaiNetwork, string> = {\n 'solana': 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v',\n 'base': '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',\n 'avalanche': '0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E',\n 'skale-base': '0x85889c8c714505E0c94b30fcfcF64fE3Ac8FCb20',\n};\n\n/** Explorer URLs per network */\nexport const EXPLORER_TX_URL: Record<RelaiNetwork, (tx: string) => string> = {\n 'solana': (tx) => `https://solscan.io/tx/${tx}`,\n 'base': (tx) => `https://basescan.org/tx/${tx}`,\n 'avalanche': (tx) => `https://snowtrace.io/tx/${tx}`,\n 'skale-base': (tx) => `https://skale-base-explorer.skalenodes.com/tx/${tx}`,\n};\n\n/** Human-readable network labels */\nexport const NETWORK_LABELS: Record<RelaiNetwork, string> = {\n 'solana': 'Solana',\n 'base': 'Base',\n 'avalanche': 'Avalanche',\n 'skale-base': 'SKALE Base',\n};\n\n/** Legacy CAIP-2 exports for backward compatibility */\nexport const SOLANA_MAINNET_NETWORK = NETWORK_CAIP2['solana'];\nexport const BASE_MAINNET_NETWORK = NETWORK_CAIP2['base'];\n\n/** Legacy USDC exports for backward compatibility */\nexport const USDC_SOLANA = USDC_ADDRESSES['solana'];\nexport const USDC_BASE = USDC_ADDRESSES['base'];\n\n/** All supported RelAI networks list */\nexport const RELAI_NETWORKS: RelaiNetwork[] = ['solana', 'base', 'avalanche', 'skale-base'];\n\n/** Check if a network is Solana-based */\nexport function isSolana(network: string): boolean {\n return network === 'solana' || network.startsWith('solana:');\n}\n\n/** Check if a network is EVM-based */\nexport function isEvm(network: string): boolean {\n return ['base', 'avalanche', 'skale-base'].includes(network) || network.startsWith('eip155:');\n}\n\n/** Normalize CAIP-2 or simple name to RelaiNetwork */\nexport function normalizeNetwork(network: string): RelaiNetwork | null {\n if (RELAI_NETWORKS.includes(network as RelaiNetwork)) return network as RelaiNetwork;\n const fromCaip2 = CAIP2_TO_NETWORK[network];\n if (fromCaip2) return fromCaip2;\n // Partial match\n if (network.startsWith('solana:')) return 'solana';\n if (network.startsWith('eip155:')) {\n const chainId = parseInt(network.split(':')[1]);\n const entry = Object.entries(CHAIN_IDS).find(([, id]) => id === chainId);\n if (entry) return entry[0] as RelaiNetwork;\n }\n return null;\n}\n\n// ============================================================================\n// Wallet Types\n// ============================================================================\n\n/** Solana wallet interface */\nexport interface SolanaWallet {\n publicKey: { toString(): string } | null;\n signTransaction: ((tx: unknown) => Promise<unknown>) | null;\n signAllTransactions?: ((txs: unknown[]) => Promise<unknown[]>) | null;\n}\n\n/** EVM wallet interface (viem-compatible) */\nexport interface EvmWallet {\n address: string;\n signTypedData: (params: unknown) => Promise<string>;\n chain?: { id: number };\n}\n\n/** Wallet set for multi-chain support */\nexport interface WalletSet {\n solana?: SolanaWallet;\n evm?: EvmWallet;\n}\n\n// ============================================================================\n// Payment Types\n// ============================================================================\n\n/** Extra fields in payment requirements */\nexport interface AcceptsExtra {\n feePayer?: string;\n decimals?: number;\n name?: string;\n version?: string;\n [key: string]: unknown;\n}\n\n/** A single payment option */\nexport interface PaymentAccept {\n x402Version?: 1 | 2;\n scheme: string;\n network: string;\n maxAmountRequired?: string;\n amount?: string;\n asset: string;\n payTo: string;\n maxTimeoutSeconds?: number;\n extra?: AcceptsExtra;\n resource?: string;\n description?: string;\n mimeType?: string;\n outputSchema?: unknown;\n}\n\n/** Resource info for v2 */\nexport interface ResourceInfo {\n url: string;\n description?: string;\n mimeType?: string;\n}\n\n/** Payment requirements (402 response) */\nexport interface PaymentRequired {\n x402Version: 1 | 2;\n error?: string;\n accepts: PaymentAccept[];\n resource?: ResourceInfo;\n extensions?: Record<string, unknown>;\n}\n\n// ============================================================================\n// Config Types\n// ============================================================================\n\nexport interface RelaiConfig {\n apiKey?: string;\n network?: RelaiNetwork;\n facilitatorUrl?: string;\n apiBaseUrl?: string;\n}\n\nexport type DynamicPrice = number | ((req: unknown) => number | Promise<number>);\n\nexport interface ProtectOptions {\n /** Price in USD (e.g., 0.01 for 1 cent) */\n price: DynamicPrice;\n /** Wallet address to receive payments */\n payTo: string;\n /** Description shown to payer */\n description?: string;\n /** Maximum timeout in seconds */\n maxTimeout?: number;\n /** Custom validation rules */\n customRules?: (req: unknown) => boolean | Promise<boolean>;\n onPaymentRequired?: (\n req: unknown,\n info: { price: number; description?: string; facilitatorUrl?: string }\n ) => void;\n onPaymentVerified?: (req: unknown, result: PaymentResult) => void;\n onError?: (req: unknown, error: unknown) => void;\n}\n\nexport interface PaymentResult {\n verified: boolean;\n transactionId?: string;\n amount?: number;\n currency?: string;\n error?: string;\n}\n"],"mappings":"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","names":[]}
1
+ {"version":3,"sources":["../src/client.ts","../src/types.ts"],"sourcesContent":["// src/client.ts\nimport {\n Connection,\n PublicKey,\n TransactionMessage,\n VersionedTransaction,\n} from '@solana/web3.js';\nimport {\n getAssociatedTokenAddress,\n createTransferCheckedInstruction,\n getMint,\n TOKEN_PROGRAM_ID,\n TOKEN_2022_PROGRAM_ID,\n} from '@solana/spl-token';\nimport type { SolanaWallet, EvmWallet, WalletSet } from './types';\nimport {\n RELAI_FACILITATOR_URL,\n NETWORK_CAIP2,\n CHAIN_IDS,\n isSolana,\n isEvm,\n normalizeNetwork,\n type RelaiNetwork,\n} from './types';\n\n// ============================================================================\n// Types\n// ============================================================================\n\nexport interface X402ClientConfig {\n /** Multi-chain wallets (Solana + EVM) */\n wallets?: WalletSet;\n /** Single Solana wallet (legacy shortcut) */\n wallet?: SolanaWallet;\n /** Custom facilitator URL, default: RelAI facilitator */\n facilitatorUrl?: string;\n /** Preferred network when multiple options available */\n preferredNetwork?: RelaiNetwork;\n /** Custom Solana RPC URL */\n solanaRpcUrl?: string;\n /** Custom EVM RPC URLs per network (e.g. { 'skale-base': 'https://...' }) */\n evmRpcUrls?: Record<string, string>;\n /** Maximum payment amount in atomic units */\n maxAmountAtomic?: string;\n /** Enable verbose logging */\n verbose?: boolean;\n}\n\nexport interface X402Client {\n /** Fetch with automatic x402 payment handling */\n fetch(input: string | URL | Request, init?: RequestInit): Promise<Response>;\n}\n\n/**\n * Create an x402 client for automatic payment handling.\n * Supports all RelAI facilitator networks: Solana, Base, Avalanche, SKALE Base.\n * Auto-detects the correct chain from the 402 response and picks the right\n * signing method (Solana SPL transfer, EVM EIP-3009 transferWithAuthorization).\n *\n * @example\n * ```typescript\n * import { createX402Client } from '@relai-fi/x402';\n *\n * const client = createX402Client({\n * wallets: { solana: solanaWallet, evm: evmWalletClient },\n * });\n *\n * // Automatically handles 402 on any RelAI-supported network\n * const response = await client.fetch('https://api.example.com/protected');\n * ```\n */\n// Networks that use EIP-2612 permit instead of EIP-3009 transferWithAuthorization (currently none)\nconst PERMIT_NETWORKS = new Set<string>([]);\n\n// Default EVM RPC URLs\nconst DEFAULT_EVM_RPC_URLS: Record<string, string> = {\n 'skale-base': 'https://skale-base.skalenodes.com/v1/base',\n 'base': 'https://mainnet.base.org',\n 'avalanche': 'https://api.avax.network/ext/bc/C/rpc',\n};\n\nexport function createX402Client(config: X402ClientConfig): X402Client {\n const {\n wallets = {},\n wallet: legacyWallet,\n facilitatorUrl = RELAI_FACILITATOR_URL,\n preferredNetwork,\n solanaRpcUrl = 'https://api.mainnet-beta.solana.com',\n evmRpcUrls = {},\n maxAmountAtomic,\n verbose = false,\n } = config;\n\n const log = verbose ? console.log.bind(console, '[relai-x402]') : () => {};\n\n // Merge legacy wallet into wallet set\n const effectiveWallets: WalletSet = { ...wallets };\n if (legacyWallet && !effectiveWallets.solana) {\n effectiveWallets.solana = legacyWallet;\n }\n\n const hasSolanaWallet = Boolean(\n effectiveWallets.solana?.publicKey && effectiveWallets.solana?.signTransaction\n );\n if (hasSolanaWallet) log('Solana wallet ready');\n\n // -----------------------------------------------------------------------\n // Select a payment option from the 402 response's `accepts` array\n // -----------------------------------------------------------------------\n function selectAccept(accepts: any[]): { accept: any; chain: 'solana' | 'evm' } | null {\n // 1) Preferred network first\n if (preferredNetwork) {\n const caip2 = NETWORK_CAIP2[preferredNetwork];\n for (const a of accepts) {\n const net = a.network || '';\n if (net === preferredNetwork || net === caip2) {\n const chain = isSolana(net) ? 'solana' as const : 'evm' as const;\n if ((chain === 'solana' && hasSolanaWallet) || (chain === 'evm' && effectiveWallets.evm)) {\n return { accept: a, chain };\n }\n }\n }\n }\n\n // 2) First option we have a wallet for\n for (const a of accepts) {\n const net = a.network || '';\n if (isSolana(net) && hasSolanaWallet) return { accept: a, chain: 'solana' };\n if (isEvm(net) && effectiveWallets.evm) return { accept: a, chain: 'evm' };\n }\n\n return null;\n }\n\n // -----------------------------------------------------------------------\n // JSON-RPC helper (for reading EVM contract state without ethers)\n // -----------------------------------------------------------------------\n async function evmRpcCall(rpcUrl: string, to: string, data: string): Promise<string> {\n const res = await fetch(rpcUrl, {\n method: 'POST',\n headers: { 'Content-Type': 'application/json' },\n body: JSON.stringify({\n jsonrpc: '2.0',\n method: 'eth_call',\n params: [{ to, data }, 'latest'],\n id: 1,\n }),\n });\n const json = await res.json();\n if (json.error) throw new Error(`RPC error: ${json.error.message}`);\n return json.result;\n }\n\n function getEvmRpcUrl(network: string): string {\n return evmRpcUrls[network] || DEFAULT_EVM_RPC_URLS[network] || '';\n }\n\n // -----------------------------------------------------------------------\n // Build EVM payment — EIP-2612 permit (for SKALE Base)\n // -----------------------------------------------------------------------\n async function buildEvmPermitPayment(\n accept: any,\n requirements: any,\n url: string,\n ): Promise<string> {\n const evmWallet = effectiveWallets.evm!;\n const extra = accept.extra || {};\n\n const rawNetwork = accept.network || '';\n const network = normalizeNetwork(rawNetwork);\n const chainId = network ? CHAIN_IDS[network] : parseInt(rawNetwork.split(':')[1] || '8453');\n const paymentAmount = accept.amount || accept.maxAmountRequired;\n const spender = extra.feePayer || accept.payTo;\n const usdcAddress = accept.asset;\n\n const rpcUrl = getEvmRpcUrl(network || rawNetwork);\n if (!rpcUrl) throw new Error(`[relai-x402] No EVM RPC URL for network ${network || rawNetwork}`);\n\n log('Building EIP-2612 permit on chain', chainId);\n\n // Read nonce from USDC contract: nonces(address) = 0x7ecebe00\n const paddedAddress = evmWallet.address.toLowerCase().replace('0x', '').padStart(64, '0');\n const nonceHex = await evmRpcCall(rpcUrl, usdcAddress, '0x7ecebe00' + paddedAddress);\n const nonce = nonceHex ? parseInt(nonceHex, 16) : 0;\n if (isNaN(nonce)) throw new Error(`[relai-x402] Failed to read permit nonce from ${usdcAddress} on ${rpcUrl}`);\n log(' Permit nonce:', nonce);\n\n // Read token name: name() = 0x06fdde03\n const nameHex = await evmRpcCall(rpcUrl, usdcAddress, '0x06fdde03');\n // Decode ABI-encoded string\n let tokenName = 'USD Coin';\n try {\n const offset = parseInt(nameHex.slice(2, 66), 16) * 2;\n const length = parseInt(nameHex.slice(2 + offset, 2 + offset + 64), 16);\n const hex = nameHex.slice(2 + offset + 64, 2 + offset + 64 + length * 2);\n tokenName = decodeURIComponent(hex.replace(/[0-9a-f]{2}/g, '%$&'));\n } catch {\n tokenName = extra.name || 'USD Coin';\n }\n log(' Token name:', tokenName);\n\n const deadline = Math.floor(Date.now() / 1000) + 600; // 10 min\n\n const domain = {\n name: tokenName,\n version: extra.version || '2',\n chainId,\n verifyingContract: usdcAddress,\n };\n\n const types = {\n Permit: [\n { name: 'owner', type: 'address' },\n { name: 'spender', type: 'address' },\n { name: 'value', type: 'uint256' },\n { name: 'nonce', type: 'uint256' },\n { name: 'deadline', type: 'uint256' },\n ],\n };\n\n const message = {\n owner: evmWallet.address,\n spender,\n value: paymentAmount,\n nonce: String(nonce),\n deadline: String(deadline),\n };\n\n log('Signing EIP-2612 permit:', message);\n\n const signature = await evmWallet.signTypedData({\n domain,\n types,\n message,\n primaryType: 'Permit',\n });\n\n // Split signature into v, r, s\n const sigHex = (signature as string).replace('0x', '');\n const r = '0x' + sigHex.slice(0, 64);\n const s = '0x' + sigHex.slice(64, 128);\n const v = parseInt(sigHex.slice(128, 130), 16);\n\n log(' Permit signed: v=%d r=%s s=%s', v, r, s);\n\n // Build x402 v2 payment payload (SKALE format)\n const paymentPayload = {\n x402Version: 2,\n scheme: 'exact',\n network: network || rawNetwork,\n payload: {\n userAddress: evmWallet.address,\n permit: { deadline: String(deadline), v, r, s },\n amount: paymentAmount,\n },\n };\n\n return btoa(JSON.stringify(paymentPayload));\n }\n\n // -----------------------------------------------------------------------\n // Build EVM payment (EIP-3009 transferWithAuthorization)\n // -----------------------------------------------------------------------\n async function buildEvmPayment(\n accept: any,\n requirements: any,\n url: string,\n ): Promise<string> {\n const evmWallet = effectiveWallets.evm!;\n const extra = accept.extra || {};\n\n const rawNetwork = accept.network || '';\n const network = normalizeNetwork(rawNetwork);\n const chainId = network ? CHAIN_IDS[network] : parseInt(rawNetwork.split(':')[1] || '8453');\n\n const paymentAmount = accept.amount || accept.maxAmountRequired;\n\n // EIP-3009 transferWithAuthorization typed data\n const domain = {\n name: extra.name || 'USD Coin',\n version: extra.version || '2',\n chainId,\n verifyingContract: accept.asset,\n };\n\n const validAfter = 0;\n const validBefore = Math.floor(Date.now() / 1000) + 3600;\n const nonce = '0x' + [...crypto.getRandomValues(new Uint8Array(32))]\n .map(b => b.toString(16).padStart(2, '0')).join('');\n\n const types = {\n TransferWithAuthorization: [\n { name: 'from', type: 'address' },\n { name: 'to', type: 'address' },\n { name: 'value', type: 'uint256' },\n { name: 'validAfter', type: 'uint256' },\n { name: 'validBefore', type: 'uint256' },\n { name: 'nonce', type: 'bytes32' },\n ],\n };\n\n const spender = extra.feePayer || accept.payTo;\n\n const message = {\n from: evmWallet.address,\n to: spender,\n value: paymentAmount,\n validAfter: String(validAfter),\n validBefore: String(validBefore),\n nonce,\n };\n\n log('Signing EIP-3009 transferWithAuthorization on chain', chainId);\n\n const signature = await evmWallet.signTypedData({\n domain,\n types,\n message,\n primaryType: 'TransferWithAuthorization',\n });\n\n // Build x402 v2 payment payload\n const paymentPayload = {\n x402Version: 2,\n resource: requirements.resource || { url },\n accepted: accept,\n payload: {\n authorization: message,\n signature,\n },\n facilitatorUrl,\n };\n\n return btoa(JSON.stringify(paymentPayload));\n }\n\n // -----------------------------------------------------------------------\n // Build Solana payment (SPL transfer with fee payer sponsorship)\n // -----------------------------------------------------------------------\n async function buildSolanaPayment(\n accept: any,\n requirements: any,\n url: string,\n ): Promise<string> {\n const solWallet = effectiveWallets.solana!;\n const extra = accept.extra || {};\n\n if (!extra.feePayer) {\n throw new Error('[relai-x402] Missing feePayer in Solana payment requirements');\n }\n\n const connection = new Connection(solanaRpcUrl, 'confirmed');\n const userPubkey = new PublicKey(solWallet.publicKey!.toString());\n const merchantPubkey = new PublicKey(accept.payTo);\n const feePayerPubkey = new PublicKey(extra.feePayer);\n const mintPubkey = new PublicKey(accept.asset);\n const paymentAmount = BigInt(accept.amount || accept.maxAmountRequired);\n\n log('Building Solana SPL transfer');\n log(' User:', userPubkey.toBase58());\n log(' Merchant:', merchantPubkey.toBase58());\n log(' FeePayer:', feePayerPubkey.toBase58());\n log(' Mint:', mintPubkey.toBase58());\n log(' Amount:', paymentAmount.toString());\n\n // Determine token program (TOKEN_PROGRAM_ID vs TOKEN_2022)\n const mintInfo = await getMint(connection, mintPubkey);\n const programId = mintInfo.address.equals(mintPubkey)\n ? (mintInfo as any).owner?.toBase58?.() === TOKEN_2022_PROGRAM_ID.toBase58()\n ? TOKEN_2022_PROGRAM_ID\n : TOKEN_PROGRAM_ID\n : TOKEN_PROGRAM_ID;\n\n // Get ATAs\n const sourceAta = await getAssociatedTokenAddress(\n mintPubkey, userPubkey, false, programId,\n );\n const destinationAta = await getAssociatedTokenAddress(\n mintPubkey, merchantPubkey, true, programId,\n );\n\n log(' Source ATA:', sourceAta.toBase58());\n log(' Dest ATA:', destinationAta.toBase58());\n\n // Build transfer instruction\n const transferIx = createTransferCheckedInstruction(\n sourceAta,\n mintPubkey,\n destinationAta,\n userPubkey,\n paymentAmount,\n mintInfo.decimals,\n [],\n programId,\n );\n\n // Build versioned transaction with feePayer\n const { blockhash } = await connection.getLatestBlockhash('confirmed');\n const message = new TransactionMessage({\n payerKey: feePayerPubkey,\n recentBlockhash: blockhash,\n instructions: [transferIx],\n }).compileToV0Message();\n\n const transaction = new VersionedTransaction(message);\n\n // User signs (feePayer signs on backend/facilitator side)\n const signedTx = await solWallet.signTransaction!(transaction) as VersionedTransaction;\n log('Transaction signed by user');\n\n // Serialize to base64\n const serializedTx = Buffer.from(signedTx.serialize()).toString('base64');\n\n // Build x402 v2 payment payload\n const paymentPayload = {\n x402Version: 2,\n resource: requirements.resource || { url },\n accepted: accept,\n payload: {\n transaction: serializedTx,\n },\n };\n\n return btoa(JSON.stringify(paymentPayload));\n }\n\n // -----------------------------------------------------------------------\n // Main fetch\n // -----------------------------------------------------------------------\n async function x402Fetch(\n input: string | URL | Request,\n init?: RequestInit,\n ): Promise<Response> {\n const url = typeof input === 'string' ? input : input instanceof URL ? input.href : input.url;\n log('Request:', url);\n\n const response = await fetch(input, init);\n if (response.status !== 402) return response;\n\n log('Got 402 Payment Required');\n\n let requirements: any;\n try {\n requirements = await response.clone().json();\n } catch {\n throw new Error('[relai-x402] Failed to parse 402 response body');\n }\n\n const accepts = requirements.accepts || [];\n if (!accepts.length) throw new Error('[relai-x402] No payment options in 402 response');\n\n const selected = selectAccept(accepts);\n if (!selected) {\n const networks = accepts.map((a: any) => a.network).join(', ');\n throw new Error(`[relai-x402] No wallet available for networks: ${networks}`);\n }\n\n const { accept, chain } = selected;\n const amount = accept.amount || accept.maxAmountRequired;\n log(`Selected: ${chain} / ${accept.network} / amount=${amount}`);\n\n // Amount guard\n if (maxAmountAtomic && BigInt(amount) > BigInt(maxAmountAtomic)) {\n throw new Error(`[relai-x402] Amount ${amount} exceeds max ${maxAmountAtomic}`);\n }\n\n // Solana — build SPL transfer natively (no x402-solana dependency)\n if (chain === 'solana' && hasSolanaWallet) {\n const paymentHeader = await buildSolanaPayment(accept, requirements, url);\n log('Retrying with X-PAYMENT header (Solana)');\n return fetch(input, {\n ...init,\n headers: {\n ...(init?.headers || {}),\n 'X-PAYMENT': paymentHeader,\n },\n });\n }\n\n // EVM — build payment header and retry\n if (chain === 'evm') {\n const evmNetwork = normalizeNetwork(accept.network || '');\n const usePermit = evmNetwork && PERMIT_NETWORKS.has(evmNetwork);\n const paymentHeader = usePermit\n ? await buildEvmPermitPayment(accept, requirements, url)\n : await buildEvmPayment(accept, requirements, url);\n log('Retrying with X-PAYMENT header');\n return fetch(input, {\n ...init,\n headers: {\n ...(init?.headers || {}),\n 'X-PAYMENT': paymentHeader,\n },\n });\n }\n\n throw new Error('[relai-x402] Unexpected state — no payment handler matched');\n }\n\n return { fetch: x402Fetch };\n}\n\nexport default createX402Client;\n","// src/types.ts\n\n// ============================================================================\n// Constants\n// ============================================================================\n\n/** RelAI Facilitator URL */\nexport const RELAI_FACILITATOR_URL = 'https://facilitator.x402.fi';\n\n// ============================================================================\n// Supported Networks\n// ============================================================================\n\n/** All networks supported by RelAI facilitator */\nexport type RelaiNetwork = 'solana' | 'base' | 'avalanche' | 'skale-base';\n\n/** CAIP-2 network identifiers */\nexport const NETWORK_CAIP2: Record<RelaiNetwork, string> = {\n 'solana': 'solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp',\n 'base': 'eip155:8453',\n 'avalanche': 'eip155:43114',\n 'skale-base': 'eip155:1187947933',\n};\n\n/** Reverse lookup: CAIP-2 → simple network name */\nexport const CAIP2_TO_NETWORK: Record<string, RelaiNetwork> = Object.fromEntries(\n Object.entries(NETWORK_CAIP2).map(([k, v]) => [v, k as RelaiNetwork])\n) as Record<string, RelaiNetwork>;\n\n/** Chain IDs for EVM networks */\nexport const CHAIN_IDS: Record<string, number> = {\n 'base': 8453,\n 'avalanche': 43114,\n 'skale-base': 1187947933,\n};\n\n/** USDC contract addresses per network */\nexport const USDC_ADDRESSES: Record<RelaiNetwork, string> = {\n 'solana': 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v',\n 'base': '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',\n 'avalanche': '0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E',\n 'skale-base': '0x85889c8c714505E0c94b30fcfcF64fE3Ac8FCb20',\n};\n\n/** Explorer URLs per network */\nexport const EXPLORER_TX_URL: Record<RelaiNetwork, (tx: string) => string> = {\n 'solana': (tx) => `https://solscan.io/tx/${tx}`,\n 'base': (tx) => `https://basescan.org/tx/${tx}`,\n 'avalanche': (tx) => `https://snowtrace.io/tx/${tx}`,\n 'skale-base': (tx) => `https://skale-base-explorer.skalenodes.com/tx/${tx}`,\n};\n\n/** Human-readable network labels */\nexport const NETWORK_LABELS: Record<RelaiNetwork, string> = {\n 'solana': 'Solana',\n 'base': 'Base',\n 'avalanche': 'Avalanche',\n 'skale-base': 'SKALE Base',\n};\n\n/** Legacy CAIP-2 exports for backward compatibility */\nexport const SOLANA_MAINNET_NETWORK = NETWORK_CAIP2['solana'];\nexport const BASE_MAINNET_NETWORK = NETWORK_CAIP2['base'];\n\n/** Legacy USDC exports for backward compatibility */\nexport const USDC_SOLANA = USDC_ADDRESSES['solana'];\nexport const USDC_BASE = USDC_ADDRESSES['base'];\n\n/** All supported RelAI networks list */\nexport const RELAI_NETWORKS: RelaiNetwork[] = ['solana', 'base', 'avalanche', 'skale-base'];\n\n/** Check if a network is Solana-based */\nexport function isSolana(network: string): boolean {\n return network === 'solana' || network.startsWith('solana:');\n}\n\n/** Check if a network is EVM-based */\nexport function isEvm(network: string): boolean {\n return ['base', 'avalanche', 'skale-base'].includes(network) || network.startsWith('eip155:');\n}\n\n/** Normalize CAIP-2 or simple name to RelaiNetwork */\nexport function normalizeNetwork(network: string): RelaiNetwork | null {\n if (RELAI_NETWORKS.includes(network as RelaiNetwork)) return network as RelaiNetwork;\n const fromCaip2 = CAIP2_TO_NETWORK[network];\n if (fromCaip2) return fromCaip2;\n // Partial match\n if (network.startsWith('solana:')) return 'solana';\n if (network.startsWith('eip155:')) {\n const chainId = parseInt(network.split(':')[1]);\n const entry = Object.entries(CHAIN_IDS).find(([, id]) => id === chainId);\n if (entry) return entry[0] as RelaiNetwork;\n }\n return null;\n}\n\n// ============================================================================\n// Wallet Types\n// ============================================================================\n\n/** Solana wallet interface */\nexport interface SolanaWallet {\n publicKey: { toString(): string } | null;\n signTransaction: ((tx: unknown) => Promise<unknown>) | null;\n signAllTransactions?: ((txs: unknown[]) => Promise<unknown[]>) | null;\n}\n\n/** EVM wallet interface (viem-compatible) */\nexport interface EvmWallet {\n address: string;\n signTypedData: (params: unknown) => Promise<string>;\n chain?: { id: number };\n}\n\n/** Wallet set for multi-chain support */\nexport interface WalletSet {\n solana?: SolanaWallet;\n evm?: EvmWallet;\n}\n\n// ============================================================================\n// Payment Types\n// ============================================================================\n\n/** Extra fields in payment requirements */\nexport interface AcceptsExtra {\n feePayer?: string;\n decimals?: number;\n name?: string;\n version?: string;\n [key: string]: unknown;\n}\n\n/** A single payment option */\nexport interface PaymentAccept {\n x402Version?: 1 | 2;\n scheme: string;\n network: string;\n maxAmountRequired?: string;\n amount?: string;\n asset: string;\n payTo: string;\n maxTimeoutSeconds?: number;\n extra?: AcceptsExtra;\n resource?: string;\n description?: string;\n mimeType?: string;\n outputSchema?: unknown;\n}\n\n/** Resource info for v2 */\nexport interface ResourceInfo {\n url: string;\n description?: string;\n mimeType?: string;\n}\n\n/** Payment requirements (402 response) */\nexport interface PaymentRequired {\n x402Version: 1 | 2;\n error?: string;\n accepts: PaymentAccept[];\n resource?: ResourceInfo;\n extensions?: Record<string, unknown>;\n}\n\n// ============================================================================\n// Config Types (server-specific types are in server.ts)\n// ============================================================================\n"],"mappings":"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","names":[]}
package/dist/index.cjs CHANGED
@@ -1,9 +1,7 @@
1
1
  "use strict";
2
- var __create = Object.create;
3
2
  var __defProp = Object.defineProperty;
4
3
  var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
5
4
  var __getOwnPropNames = Object.getOwnPropertyNames;
6
- var __getProtoOf = Object.getPrototypeOf;
7
5
  var __hasOwnProp = Object.prototype.hasOwnProperty;
8
6
  var __export = (target, all) => {
9
7
  for (var name in all)
@@ -17,14 +15,6 @@ var __copyProps = (to, from, except, desc) => {
17
15
  }
18
16
  return to;
19
17
  };
20
- var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
21
- // If the importer is in node compatibility mode or this is not an ESM
22
- // file that has been converted to a CommonJS file using a Babel-
23
- // compatible transform (i.e. "__esModule" has not been set), then set
24
- // "default" to the CommonJS "module.exports" for node compatibility.
25
- isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
26
- mod
27
- ));
28
18
  var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
29
19
 
30
20
  // src/index.ts
@@ -65,9 +55,6 @@ __export(index_exports, {
65
55
  });
66
56
  module.exports = __toCommonJS(index_exports);
67
57
 
68
- // src/server.ts
69
- var import_axios = __toESM(require("axios"), 1);
70
-
71
58
  // src/types.ts
72
59
  var RELAI_FACILITATOR_URL = "https://facilitator.x402.fi";
73
60
  var NETWORK_CAIP2 = {
@@ -129,107 +116,133 @@ function normalizeNetwork(network) {
129
116
  // src/server.ts
130
117
  var Relai = class {
131
118
  constructor(config) {
132
- this.config = {
133
- network: "solana",
134
- apiBaseUrl: "https://relai.fi/api",
135
- facilitatorUrl: RELAI_FACILITATOR_URL,
136
- ...config
137
- };
138
- if (!this.config.apiKey || typeof this.config.apiKey !== "string") {
139
- throw new Error("[Relai] Missing required apiKey in configuration");
140
- }
141
- this.client = import_axios.default.create({
142
- baseURL: this.config.apiBaseUrl,
143
- timeout: 1e4,
144
- headers: {
145
- "Authorization": `Bearer ${this.config.apiKey}`,
146
- "Content-Type": "application/json"
147
- }
148
- });
119
+ this.network = config.network;
120
+ this.facilitatorUrl = config.facilitatorUrl || RELAI_FACILITATOR_URL;
149
121
  }
150
122
  /**
151
123
  * Express middleware to protect an endpoint with x402 micropayments.
152
- * Returns a 402 with `accepts` for the configured network.
153
- * Supports: Solana, Base, Avalanche, SKALE Base.
124
+ *
125
+ * Flow:
126
+ * 1. No payment header → returns 402 with payment requirements
127
+ * 2. Payment header present → calls RelAI facilitator `/settle`
128
+ * 3. Settlement success → sets `PAYMENT-RESPONSE` header, attaches `req.payment`, calls `next()`
154
129
  */
155
130
  protect(options) {
131
+ const self = this;
156
132
  return async (req, res, next) => {
157
133
  try {
158
134
  const resolvedPrice = typeof options.price === "function" ? await options.price(req) : options.price;
159
135
  if (typeof resolvedPrice !== "number" || !isFinite(resolvedPrice) || resolvedPrice <= 0) {
160
- return res.status(400).json({ error: "Invalid price configuration", code: "INVALID_PRICE" });
136
+ return res.status(400).json({ error: "Invalid price configuration" });
161
137
  }
162
- const paymentSignature = req.headers["x-payment-signature"] || req.headers["x-relai-payment"];
163
- if (!paymentSignature) {
164
- const network = this.config.network;
165
- const caip2 = NETWORK_CAIP2[network] || NETWORK_CAIP2["solana"];
166
- const asset = USDC_ADDRESSES[network] || USDC_ADDRESSES["solana"];
138
+ const network = options.network || self.network;
139
+ const caip2 = NETWORK_CAIP2[network];
140
+ const asset = USDC_ADDRESSES[network];
141
+ const amount = String(Math.floor(resolvedPrice * 1e6));
142
+ const paymentHeader = req.headers["x-payment"] || req.headers["payment-signature"] || req.headers["x-payment-signature"];
143
+ if (!paymentHeader) {
144
+ options.onPaymentRequired?.(req, { price: resolvedPrice, network });
167
145
  return res.status(402).json({
168
146
  x402Version: 2,
169
147
  error: "Payment required",
170
148
  resource: {
171
149
  url: `${req.protocol}://${req.get("host")}${req.originalUrl}`,
172
150
  description: options.description || "API access",
173
- mimeType: "application/json"
151
+ mimeType: options.mimeType || "application/json"
174
152
  },
175
153
  accepts: [{
176
154
  scheme: "exact",
177
155
  network: caip2,
178
- maxAmountRequired: String(Math.floor(resolvedPrice * 1e6)),
156
+ amount,
179
157
  asset,
180
158
  payTo: options.payTo,
181
- maxTimeoutSeconds: 60,
159
+ maxTimeoutSeconds: options.maxTimeoutSeconds || 60,
182
160
  extra: {
183
161
  name: "USD Coin",
184
162
  version: "2",
185
- decimals: 6,
186
- facilitatorUrl: this.config.facilitatorUrl
163
+ decimals: 6
187
164
  }
188
165
  }]
189
166
  });
190
167
  }
191
- const verification = await this.verifyPayment(paymentSignature, resolvedPrice, options.maxTimeout);
192
- if (!verification.verified) {
168
+ let paymentProof;
169
+ try {
170
+ const decoded = Buffer.from(paymentHeader, "base64").toString("utf-8");
171
+ paymentProof = JSON.parse(decoded);
172
+ } catch {
173
+ try {
174
+ paymentProof = JSON.parse(paymentHeader);
175
+ } catch {
176
+ return res.status(400).json({
177
+ x402Version: 2,
178
+ error: "Invalid payment header \u2014 expected base64-encoded JSON"
179
+ });
180
+ }
181
+ }
182
+ const paymentRequirements = {
183
+ scheme: "exact",
184
+ network,
185
+ amount,
186
+ asset,
187
+ payTo: options.payTo,
188
+ maxTimeoutSeconds: options.maxTimeoutSeconds || 60
189
+ };
190
+ const settleUrl = `${self.facilitatorUrl}/settle`;
191
+ const settleRes = await fetch(settleUrl, {
192
+ method: "POST",
193
+ headers: { "Content-Type": "application/json" },
194
+ body: JSON.stringify({
195
+ paymentPayload: paymentProof,
196
+ paymentRequirements
197
+ })
198
+ });
199
+ const result = await settleRes.json();
200
+ if (!result.success) {
193
201
  return res.status(402).json({
194
- error: "Payment verification failed",
195
- code: "PAYMENT_INVALID",
196
- details: verification.error
202
+ x402Version: 2,
203
+ error: result.errorReason || result.error || "Payment settlement failed"
197
204
  });
198
205
  }
199
- req.payment = verification;
206
+ const paymentInfo = {
207
+ verified: true,
208
+ transactionId: result.transaction,
209
+ payer: result.payer,
210
+ network,
211
+ amount: resolvedPrice
212
+ };
213
+ req.payment = paymentInfo;
214
+ req.x402Payer = result.payer;
215
+ req.x402Paid = true;
216
+ req.x402Transaction = result.transaction;
217
+ req.x402Network = network;
218
+ const paymentResponse = {
219
+ x402Version: 2,
220
+ scheme: "exact",
221
+ network: caip2,
222
+ transaction: result.transaction,
223
+ payer: result.payer,
224
+ amount,
225
+ asset
226
+ };
227
+ res.setHeader(
228
+ "PAYMENT-RESPONSE",
229
+ Buffer.from(JSON.stringify(paymentResponse)).toString("base64")
230
+ );
231
+ options.onPaymentSettled?.(req, result);
200
232
  if (options.customRules) {
201
- const customValid = await options.customRules(req);
202
- if (!customValid) {
203
- return res.status(403).json({ error: "Custom validation failed", code: "VALIDATION_FAILED" });
233
+ const valid = await options.customRules(req);
234
+ if (!valid) {
235
+ return res.status(403).json({ error: "Custom validation failed" });
204
236
  }
205
237
  }
206
238
  next();
207
239
  } catch (error) {
208
- console.error("Relai protection error:", error);
209
- res.status(500).json({ error: "Internal server error", code: "SERVER_ERROR" });
240
+ options.onError?.(req, error);
241
+ console.error("[Relai] Protection error:", error);
242
+ res.status(500).json({ error: "Internal server error" });
210
243
  }
211
244
  };
212
245
  }
213
- async verifyPayment(signature, expectedPrice, timeoutMs) {
214
- try {
215
- const response = await this.client.post(
216
- "/verify-payment",
217
- { signature, expectedPrice, network: this.config.network },
218
- { timeout: typeof timeoutMs === "number" ? Math.max(1, timeoutMs) : void 0 }
219
- );
220
- return response.data;
221
- } catch (error) {
222
- return { verified: false, error: error.response?.data?.error || "Verification failed" };
223
- }
224
- }
225
- async getStats(apiId) {
226
- const params = apiId ? { apiId } : {};
227
- const response = await this.client.get("/stats", { params });
228
- return response.data;
229
- }
230
- createProtectedEndpoint(options) {
231
- return this.protect(options);
232
- }
233
246
  };
234
247
  var server_default = Relai;
235
248