x402-bazaar 2.0.0 → 3.0.0

package/bin/cli.js

@@ -25,7 +25,7 @@ const program = new Command();
 program
   .name('x402-bazaar')
   .description(chalk.hex('#FF9900')('x402 Bazaar') + ' — Connect your AI agent to the marketplace in one command')
-  .version('2.0.0');
+  .version('3.0.0');
 
 program
   .command('init')
@@ -70,23 +70,25 @@ program
 
 program
   .command('call <endpoint>')
-  .description('Call a marketplace endpoint (testing/debugging)')
+  .description('Call a marketplace endpoint with automatic x402 payment')
   .option('--param <key=value>', 'Add parameter (can be used multiple times)', (value, previous) => {
     return previous ? [...previous, value] : [value];
   }, [])
+  .option('--key <privateKey>', 'Private key for auto-payment (or set X402_PRIVATE_KEY env)')
   .option('--server-url <url>', 'Server URL', 'https://x402-api.onrender.com')
   .action(callCommand);
 
 program
   .command('wallet')
-  .description('Check USDC wallet balance on Base')
+  .description('Check USDC wallet balance or generate a new wallet')
   .option('--address <address>', 'Ethereum address to check')
+  .option('--setup', 'Generate a new wallet for auto-payment')
   .action(walletCommand);
 
 // Default: show help if no command given
 if (process.argv.length <= 2) {
   console.log('');
-  console.log(chalk.hex('#FF9900').bold('  x402 Bazaar') + chalk.dim(' — AI Agent Marketplace CLI v2'));
+  console.log(chalk.hex('#FF9900').bold('  x402 Bazaar') + chalk.dim(' — AI Agent Marketplace CLI v3'));
   console.log('');
   console.log('  Setup commands:');
   console.log(chalk.cyan('    npx x402-bazaar init') + chalk.dim('          Full interactive setup'));
@@ -96,8 +98,8 @@ if (process.argv.length <= 2) {
   console.log('  Marketplace commands:');
   console.log(chalk.cyan('    npx x402-bazaar list') + chalk.dim('          Browse all services'));
   console.log(chalk.cyan('    npx x402-bazaar search <query>') + chalk.dim('  Find services by keyword'));
-  console.log(chalk.cyan('    npx x402-bazaar call <endpoint>') + chalk.dim(' Test an API endpoint'));
-  console.log(chalk.cyan('    npx x402-bazaar wallet') + chalk.dim('        Check wallet balance'));
+  console.log(chalk.cyan('    npx x402-bazaar call <endpoint>') + chalk.dim(' Call API with auto-payment'));
+  console.log(chalk.cyan('    npx x402-bazaar wallet') + chalk.dim('        Check balance / setup wallet'));
   console.log('');
   console.log(chalk.dim('  Run any command with --help for detailed options'));
   console.log('');

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "x402-bazaar",
-  "version": "2.0.0",
-  "description": "CLI to set up x402 Bazaar MCP server for AI agents. Browse, search, and call marketplace APIs. One command to connect your agent.",
+  "version": "3.0.0",
+  "description": "CLI for x402 Bazaar — AI Agent Marketplace. Browse, call, and auto-pay APIs with USDC on Base. One command to connect your agent.",
   "type": "module",
   "main": "bin/cli.js",
   "bin": {
@@ -44,6 +44,7 @@
     "chalk": "^5.3.0",
     "commander": "^12.1.0",
     "inquirer": "^9.3.0",
-    "ora": "^8.0.1"
+    "ora": "^8.0.1",
+    "viem": "^2.45.3"
   }
 }

package/src/commands/call.js

@@ -1,5 +1,7 @@
 import ora from 'ora';
 import chalk from 'chalk';
+import fs from 'fs';
+import path from 'path';
 import { log } from '../utils/logger.js';
 
 export async function callCommand(endpoint, options) {
@@ -7,14 +9,12 @@ export async function callCommand(endpoint, options) {
     log.error('Endpoint is required');
     log.dim('  Usage: x402-bazaar call <endpoint> [--param key=value...]');
     log.dim('  Example: x402-bazaar call /api/weather --param city=Paris');
-    log.dim('  Example: x402-bazaar call /api/search --param q="AI agents"');
+    log.dim('  Example: x402-bazaar call /api/hash --param text=hello --key 0x...');
     console.log('');
     process.exit(1);
   }
 
   const serverUrl = options.serverUrl || 'https://x402-api.onrender.com';
-
-  // Normalize endpoint (add leading slash if missing)
   const normalizedEndpoint = endpoint.startsWith('/') ? endpoint : `/${endpoint}`;
   const fullUrl = `${serverUrl}${normalizedEndpoint}`;
 
@@ -26,15 +26,13 @@ export async function callCommand(endpoint, options) {
   const params = {};
   if (options.param) {
     const paramArray = Array.isArray(options.param) ? options.param : [options.param];
-
     for (const p of paramArray) {
       const [key, ...valueParts] = p.split('=');
       if (!key || valueParts.length === 0) {
         log.warn(`Invalid param format: ${p} (expected key=value)`);
         continue;
       }
-      let value = valueParts.join('='); // rejoin in case value contains '='
-      // Strip quotes if present
+      let value = valueParts.join('=');
       if ((value.startsWith('"') && value.endsWith('"')) ||
           (value.startsWith("'") && value.endsWith("'"))) {
         value = value.slice(1, -1);
@@ -51,7 +49,21 @@ export async function callCommand(endpoint, options) {
     console.log('');
   }
 
-  // Build URL with query params (always use GET for marketplace APIs)
+  // Resolve private key for auto-payment
+  const privateKey = resolvePrivateKey(options);
+  const autoPay = !!privateKey;
+
+  if (autoPay) {
+    log.info(`Auto-payment: ${chalk.hex('#34D399').bold('enabled')}`);
+    try {
+      const { getAddressFromKey } = await import('../lib/payment.js');
+      const address = getAddressFromKey(privateKey);
+      log.dim(`  Wallet: ${address.slice(0, 6)}...${address.slice(-4)}`);
+    } catch { /* ignore display errors */ }
+    console.log('');
+  }
+
+  // Build URL with query params
   let finalUrl = fullUrl;
   if (Object.keys(params).length > 0) {
     const queryString = new URLSearchParams(params).toString();
@@ -63,14 +75,11 @@ export async function callCommand(endpoint, options) {
   try {
     const fetchOptions = {
       method: 'GET',
-      headers: {
-        'Content-Type': 'application/json',
-      },
+      headers: { 'Content-Type': 'application/json' },
       signal: AbortSignal.timeout(30000),
     };
 
     const res = await fetch(finalUrl, fetchOptions);
-
     spinner.stop();
 
     // Handle 402 Payment Required
@@ -79,32 +88,49 @@ export async function callCommand(endpoint, options) {
       log.warn(chalk.bold('Payment Required (HTTP 402)'));
       console.log('');
 
+      let paymentInfo;
       try {
-        const paymentInfo = await res.json();
+        paymentInfo = await res.json();
+      } catch {
+        log.error('Could not parse payment details');
+        process.exit(1);
+      }
 
-        if (paymentInfo.price) {
-          log.info(`Price: ${chalk.cyan(`${paymentInfo.price} USDC`)}`);
-        }
-        if (paymentInfo.paymentAddress) {
-          log.info(`Payment address: ${chalk.hex('#34D399')(paymentInfo.paymentAddress)}`);
-        }
-        if (paymentInfo.message) {
-          log.dim(`  ${paymentInfo.message}`);
-        }
+      const price = paymentInfo.payment_details?.amount || paymentInfo.price;
+      const payTo = paymentInfo.payment_details?.recipient || paymentInfo.payment_details?.walletAddress || paymentInfo.paymentAddress;
 
-        console.log('');
-        log.separator();
-        console.log('');
-        log.info('To pay automatically, use the MCP server via Claude/Cursor.');
-        log.dim('  The MCP server handles x402 payments transparently.');
-        log.dim('  Install: npx x402-bazaar init');
-        console.log('');
+      if (price) {
+        log.info(`Price: ${chalk.cyan.bold(`${price} USDC`)}`);
+      }
+      if (payTo) {
+        log.dim(`  Pay to: ${payTo}`);
+      }
+      console.log('');
 
-      } catch {
-        log.dim('  This endpoint requires payment.');
-        log.dim('  Use the MCP server for automatic payment handling.');
-        console.log('');
+      // Auto-pay if key is available
+      if (autoPay && price && payTo) {
+        await handleAutoPayment(privateKey, payTo, price, finalUrl, fetchOptions);
+        return;
       }
+
+      // No auto-pay — show instructions
+      log.separator();
+      console.log('');
+      log.info('To pay automatically, provide your private key:');
+      console.log('');
+      log.dim('  Option 1: Environment variable');
+      log.dim('    export X402_PRIVATE_KEY=0xYourPrivateKey');
+      log.dim('    npx x402-bazaar call /api/weather --param city=Paris');
+      console.log('');
+      log.dim('  Option 2: --key flag');
+      log.dim('    npx x402-bazaar call /api/weather --param city=Paris --key 0xYourKey');
+      console.log('');
+      log.dim('  Option 3: Generate a new wallet');
+      log.dim('    npx x402-bazaar wallet --setup');
+      console.log('');
+      log.dim('  Option 4: Use the MCP server (via Claude/Cursor)');
+      log.dim('    npx x402-bazaar init');
+      console.log('');
       return;
     }
 
@@ -112,7 +138,6 @@ export async function callCommand(endpoint, options) {
     if (!res.ok) {
       console.log('');
       log.error(`HTTP ${res.status}: ${res.statusText}`);
-
       try {
         const errorBody = await res.text();
         if (errorBody) {
@@ -120,61 +145,115 @@ export async function callCommand(endpoint, options) {
           log.dim('Response:');
           console.log(chalk.red(errorBody));
         }
-      } catch {
-        // Ignore
-      }
-
+      } catch { /* ignore */ }
       console.log('');
       process.exit(1);
     }
 
     // Success
+    await displayResponse(res);
+
+  } catch (err) {
+    spinner.fail('Request failed');
     console.log('');
-    log.success(`${chalk.bold(res.status)} ${res.statusText}`);
+
+    if (err.name === 'AbortError') {
+      log.error('Request timeout (30s)');
+      log.dim('  Try again or check status: npx x402-bazaar status');
+    } else if (err.code === 'ECONNREFUSED' || err.code === 'ENOTFOUND') {
+      log.error('Cannot connect to server');
+      log.dim(`  Server URL: ${serverUrl}`);
+    } else {
+      log.error(err.message);
+    }
+
     console.log('');
+    process.exit(1);
+  }
+}
 
-    const contentType = res.headers.get('content-type') || '';
+/**
+ * Resolve private key from: --key flag > X402_PRIVATE_KEY env > ~/.x402-bazaar/wallet.json
+ */
+function resolvePrivateKey(options) {
+  if (options.key) {
+    return normalizeKey(options.key);
+  }
 
-    if (contentType.includes('application/json')) {
-      const responseData = await res.json();
+  if (process.env.X402_PRIVATE_KEY) {
+    return normalizeKey(process.env.X402_PRIVATE_KEY);
+  }
 
-      log.separator();
-      console.log('');
-      log.info('Response (JSON):');
-      console.log('');
+  // Try local wallet file
+  try {
+    const home = process.env.HOME || process.env.USERPROFILE;
+    const walletPath = path.join(home, '.x402-bazaar', 'wallet.json');
+    if (fs.existsSync(walletPath)) {
+      const data = JSON.parse(fs.readFileSync(walletPath, 'utf-8'));
+      if (data.privateKey) {
+        return normalizeKey(data.privateKey);
+      }
+    }
+  } catch { /* ignore */ }
 
-      // Pretty-print JSON with syntax highlighting
-      const jsonString = JSON.stringify(responseData, null, 2);
-      const highlighted = highlightJson(jsonString);
-      console.log(highlighted);
-      console.log('');
-      log.separator();
+  return null;
+}
 
-    } else {
-      const responseText = await res.text();
+function normalizeKey(key) {
+  key = key.trim();
+  if (!key.startsWith('0x')) key = '0x' + key;
+  if (!/^0x[a-fA-F0-9]{64}$/.test(key)) return null;
+  return key;
+}
 
-      log.separator();
-      console.log('');
-      log.info('Response:');
+/**
+ * Handle automatic x402 payment and retry
+ */
+async function handleAutoPayment(privateKey, payTo, price, url, fetchOptions) {
+  const spinner = ora(`Sending ${price} USDC on Base mainnet...`).start();
+
+  try {
+    const { sendUsdcPayment } = await import('../lib/payment.js');
+    const payment = await sendUsdcPayment(privateKey, payTo, price);
+
+    spinner.succeed(`Payment confirmed: ${chalk.hex('#34D399').bold(`${price} USDC`)}`);
+    log.dim(`  Tx: ${payment.explorer}`);
+    console.log('');
+
+    // Retry with payment proof
+    const retrySpinner = ora('Retrying with payment proof...').start();
+
+    const retryRes = await fetch(url, {
+      ...fetchOptions,
+      headers: {
+        ...fetchOptions.headers,
+        'X-Payment-TxHash': payment.txHash,
+      },
+    });
+
+    retrySpinner.stop();
+
+    if (!retryRes.ok) {
       console.log('');
-      console.log(chalk.white(responseText));
+      log.error(`HTTP ${retryRes.status}: ${retryRes.statusText}`);
+      try {
+        const body = await retryRes.text();
+        if (body) console.log(chalk.red(body));
+      } catch { /* ignore */ }
       console.log('');
-      log.separator();
+      process.exit(1);
     }
 
-    console.log('');
+    await displayResponse(retryRes);
 
   } catch (err) {
-    spinner.fail('Request failed');
+    spinner.fail('Payment failed');
     console.log('');
 
-    if (err.name === 'AbortError') {
-      log.error('Request timeout (30s) — server may be slow or endpoint not responding');
-      log.dim('  Try again or check status: npx x402-bazaar status');
-    } else if (err.code === 'ECONNREFUSED' || err.code === 'ENOTFOUND') {
-      log.error('Cannot connect to server');
-      log.dim(`  Server URL: ${serverUrl}`);
-      log.dim('  Check your internet connection or try: npx x402-bazaar status');
+    if (err.message.includes('Insufficient USDC')) {
+      log.error(err.message);
+      log.dim('  Fund your wallet with USDC on Base.');
+      log.dim('  Check balance: npx x402-bazaar wallet --address <your-address>');
     } else {
       log.error(err.message);
     }
@@ -185,8 +264,37 @@ export async function callCommand(endpoint, options) {
 }
 
 /**
- * Simple JSON syntax highlighting for terminal
+ * Display API response with JSON highlighting
  */
+async function displayResponse(res) {
+  console.log('');
+  log.success(`${chalk.bold(res.status)} ${res.statusText}`);
+  console.log('');
+
+  const contentType = res.headers.get('content-type') || '';
+
+  if (contentType.includes('application/json')) {
+    const responseData = await res.json();
+    log.separator();
+    console.log('');
+    log.info('Response (JSON):');
+    console.log('');
+    console.log(highlightJson(JSON.stringify(responseData, null, 2)));
+    console.log('');
+    log.separator();
+  } else {
+    const responseText = await res.text();
+    log.separator();
+    console.log('');
+    log.info('Response:');
+    console.log('');
+    console.log(chalk.white(responseText));
+    console.log('');
+    log.separator();
+  }
+  console.log('');
+}
+
 function highlightJson(jsonString) {
   return jsonString
     .replace(/"([^"]+)":/g, chalk.hex('#60A5FA')('"$1"') + ':')

package/src/commands/wallet.js

@@ -1,5 +1,7 @@
 import ora from 'ora';
 import chalk from 'chalk';
+import fs from 'fs';
+import path from 'path';
 import { log } from '../utils/logger.js';
 
 const BASE_RPC_URL = 'https://mainnet.base.org';
@@ -9,26 +11,28 @@ const BALANCE_OF_SELECTOR = '0x70a08231';
 export async function walletCommand(options) {
   log.banner();
 
+  // Handle --setup: generate a new wallet
+  if (options.setup) {
+    await setupWallet();
+    return;
+  }
+
   if (!options.address) {
-    log.info('Check USDC balance for any wallet address on Base.');
+    log.info('Check USDC balance or generate a new wallet.');
     console.log('');
     log.dim('  Usage:');
     log.dim('    x402-bazaar wallet --address 0xYourAddress');
+    log.dim('    x402-bazaar wallet --setup');
     console.log('');
-    log.dim('  Example:');
+    log.dim('  Examples:');
     log.dim('    x402-bazaar wallet --address 0xA986540F0AaDFB5Ba5ceb2b1d81d90DBE479084b');
-    console.log('');
-    log.dim('  To find your agent wallet address:');
-    log.dim('    1. Run: npx x402-bazaar init');
-    log.dim('    2. Or check your .env file: AGENT_PRIVATE_KEY');
-    log.dim('    3. Or ask your AI agent: "What is my wallet address?"');
+    log.dim('    x402-bazaar wallet --setup  (generate a new wallet for auto-payment)');
     console.log('');
     return;
   }
 
   const address = options.address.trim();
 
-  // Validate address format
   if (!/^0x[a-fA-F0-9]{40}$/.test(address)) {
     log.error('Invalid Ethereum address format');
     log.dim('  Expected: 0x followed by 40 hexadecimal characters');
@@ -43,24 +47,14 @@ export async function walletCommand(options) {
   const spinner = ora('Fetching USDC balance from Base...').start();
 
   try {
-    // Encode balanceOf(address) call
-    // balanceOf selector: 0x70a08231
-    // Param: address (32 bytes, left-padded)
     const paddedAddress = address.slice(2).padStart(64, '0');
     const data = BALANCE_OF_SELECTOR + paddedAddress;
 
-    // Make RPC call
     const rpcPayload = {
       jsonrpc: '2.0',
       id: 1,
       method: 'eth_call',
-      params: [
-        {
-          to: USDC_CONTRACT_BASE,
-          data: data,
-        },
-        'latest',
-      ],
+      params: [{ to: USDC_CONTRACT_BASE, data }, 'latest'],
     };
 
     const res = await fetch(BASE_RPC_URL, {
@@ -70,28 +64,17 @@ export async function walletCommand(options) {
       signal: AbortSignal.timeout(15000),
     });
 
-    if (!res.ok) {
-      throw new Error(`HTTP ${res.status}: ${res.statusText}`);
-    }
+    if (!res.ok) throw new Error(`HTTP ${res.status}: ${res.statusText}`);
 
     const rpcResponse = await res.json();
+    if (rpcResponse.error) throw new Error(rpcResponse.error.message || 'RPC error');
+    if (!rpcResponse.result) throw new Error('No result from RPC');
 
-    if (rpcResponse.error) {
-      throw new Error(rpcResponse.error.message || 'RPC error');
-    }
-
-    if (!rpcResponse.result) {
-      throw new Error('No result from RPC');
-    }
-
-    // Parse balance (USDC has 6 decimals)
-    const balanceHex = rpcResponse.result;
-    const balanceRaw = BigInt(balanceHex);
+    const balanceRaw = BigInt(rpcResponse.result);
     const balanceUsdc = Number(balanceRaw) / 1_000_000;
 
     spinner.succeed('Balance fetched');
     console.log('');
-
     log.separator();
     console.log('');
 
@@ -102,30 +85,22 @@ export async function walletCommand(options) {
     console.log('');
     log.separator();
     console.log('');
-
-    // Show explorer link
     log.dim(`  Explorer:  https://basescan.org/address/${address}`);
 
-    // Helpful tips based on balance
     if (balanceUsdc === 0) {
       console.log('');
       log.warn('This wallet has no USDC.');
-      log.dim('  To fund it:');
-      log.dim('    1. Open MetaMask and switch to Base network');
-      log.dim('    2. Send USDC to this address');
-      log.dim('    3. Send a tiny amount of ETH for gas (~$0.01)');
-      log.dim('  Get USDC: bridge from Ethereum or buy on Base DEX');
+      log.dim('  Send USDC on Base to this address to start using paid APIs.');
     } else if (balanceUsdc < 0.1) {
       console.log('');
       log.warn('Low balance — consider adding more USDC.');
-      log.dim('  Most x402 Bazaar APIs cost $0.005-$0.05 per call.');
+      log.dim('  Most x402 Bazaar APIs cost $0.001-$0.05 per call.');
     } else {
       console.log('');
       log.success('Wallet is funded and ready!');
-      const estimatedCalls = Math.floor(balanceUsdc / 0.02);
-      log.dim(`  Estimated API calls: ~${estimatedCalls} (at avg $0.02/call)`);
+      const estimatedCalls = Math.floor(balanceUsdc / 0.005);
+      log.dim(`  Estimated API calls: ~${estimatedCalls} (at avg $0.005/call)`);
     }
-
     console.log('');
 
   } catch (err) {
@@ -134,22 +109,107 @@ export async function walletCommand(options) {
 
     if (err.name === 'AbortError') {
       log.error('Request timeout — Base RPC may be slow');
-      log.dim('  Try again in a few seconds');
     } else if (err.code === 'ECONNREFUSED' || err.code === 'ENOTFOUND') {
       log.error('Cannot connect to Base RPC');
-      log.dim('  Check your internet connection');
     } else {
       log.error(err.message);
     }
-
     console.log('');
     process.exit(1);
   }
 }
 
 /**
- * Mask address for display: 0xabcd...1234
+ * Generate a new wallet and save to ~/.x402-bazaar/wallet.json
  */
+async function setupWallet() {
+  log.info('Generating a new wallet for x402 Bazaar auto-payment...');
+  console.log('');
+
+  const home = process.env.HOME || process.env.USERPROFILE;
+  const dir = path.join(home, '.x402-bazaar');
+  const walletPath = path.join(dir, 'wallet.json');
+
+  // Check if wallet already exists
+  if (fs.existsSync(walletPath)) {
+    try {
+      const existing = JSON.parse(fs.readFileSync(walletPath, 'utf-8'));
+      if (existing.privateKey) {
+        const { getAddressFromKey } = await import('../lib/payment.js');
+        const address = getAddressFromKey(existing.privateKey.startsWith('0x') ? existing.privateKey : '0x' + existing.privateKey);
+        console.log('');
+        log.warn('A wallet already exists!');
+        log.info(`Address: ${chalk.hex('#34D399')(address)}`);
+        log.dim(`  File: ${walletPath}`);
+        console.log('');
+        log.dim('  To use a different wallet, delete the file and run --setup again.');
+        log.dim('  To check balance: npx x402-bazaar wallet --address ' + address);
+        console.log('');
+        return;
+      }
+    } catch { /* ignore parse errors, will overwrite */ }
+  }
+
+  const spinner = ora('Generating cryptographic key pair...').start();
+
+  try {
+    const { generatePrivateKey, privateKeyToAccount } = await import('viem/accounts');
+    const privateKey = generatePrivateKey();
+    const account = privateKeyToAccount(privateKey);
+
+    // Create directory
+    if (!fs.existsSync(dir)) {
+      fs.mkdirSync(dir, { recursive: true });
+    }
+
+    // Save wallet (private key stored locally)
+    fs.writeFileSync(walletPath, JSON.stringify({
+      address: account.address,
+      privateKey: privateKey,
+      network: 'base',
+      created: new Date().toISOString(),
+    }, null, 2), 'utf-8');
+
+    spinner.succeed('Wallet generated!');
+    console.log('');
+    log.separator();
+    console.log('');
+
+    log.info(`Address:     ${chalk.hex('#34D399').bold(account.address)}`);
+    log.info(`Network:     ${chalk.hex('#0052FF').bold('Base Mainnet')}`);
+    log.info(`Saved to:    ${chalk.dim(walletPath)}`);
+
+    console.log('');
+    log.separator();
+    console.log('');
+
+    log.info('Next steps:');
+    console.log('');
+    log.dim('  1. Fund this wallet with USDC on Base:');
+    log.dim(`     Send USDC to ${chalk.hex('#34D399')(account.address)}`);
+    log.dim('     + a tiny amount of ETH for gas (~$0.01)');
+    console.log('');
+    log.dim('  2. Call paid APIs automatically:');
+    log.dim(`     ${chalk.cyan('npx x402-bazaar call /api/weather --param city=Paris')}`);
+    log.dim('     (auto-payment will use your saved wallet)');
+    console.log('');
+    log.dim('  3. Or set the env variable for any tool:');
+    log.dim(`     export X402_PRIVATE_KEY=${privateKey}`);
+    console.log('');
+
+    log.warn('Keep your private key safe! Anyone with it can spend your funds.');
+    log.dim(`  Backup: ${walletPath}`);
+    console.log('');
+
+  } catch (err) {
+    spinner.fail('Wallet generation failed');
+    console.log('');
+    log.error(err.message);
+    console.log('');
+    process.exit(1);
+  }
+}
+
 function maskAddress(address) {
   if (address.length < 12) return address;
   return `${address.slice(0, 6)}...${address.slice(-4)}`;

package/src/lib/payment.js

@@ -0,0 +1,106 @@
+import { createWalletClient, createPublicClient, http, parseUnits, encodeFunctionData } from 'viem';
+import { base } from 'viem/chains';
+import { privateKeyToAccount } from 'viem/accounts';
+
+const USDC_CONTRACT = '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913';
+const USDC_ABI = [
+  {
+    name: 'transfer',
+    type: 'function',
+    inputs: [
+      { name: 'to', type: 'address' },
+      { name: 'amount', type: 'uint256' },
+    ],
+    outputs: [{ type: 'bool' }],
+  },
+  {
+    name: 'balanceOf',
+    type: 'function',
+    inputs: [{ name: 'account', type: 'address' }],
+    outputs: [{ type: 'uint256' }],
+    stateMutability: 'view',
+  },
+];
+
+/**
+ * Send USDC payment on Base mainnet
+ * @param {string} privateKey - Hex private key (with 0x prefix)
+ * @param {string} toAddress - Recipient wallet address
+ * @param {number} amountUsdc - Amount in USDC (e.g., 0.005)
+ * @returns {{ txHash: string, explorer: string }}
+ */
+export async function sendUsdcPayment(privateKey, toAddress, amountUsdc) {
+  const account = privateKeyToAccount(privateKey);
+
+  const walletClient = createWalletClient({
+    account,
+    chain: base,
+    transport: http('https://mainnet.base.org'),
+  });
+
+  const publicClient = createPublicClient({
+    chain: base,
+    transport: http('https://mainnet.base.org'),
+  });
+
+  // Convert USDC amount to 6-decimal units
+  const amount = parseUnits(amountUsdc.toString(), 6);
+
+  // Check balance first
+  const balance = await publicClient.readContract({
+    address: USDC_CONTRACT,
+    abi: USDC_ABI,
+    functionName: 'balanceOf',
+    args: [account.address],
+  });
+
+  if (balance < amount) {
+    const balanceUsdc = Number(balance) / 1_000_000;
+    throw new Error(`Insufficient USDC balance: ${balanceUsdc.toFixed(6)} USDC (need ${amountUsdc} USDC)`);
+  }
+
+  // Send the USDC transfer
+  const txHash = await walletClient.writeContract({
+    address: USDC_CONTRACT,
+    abi: USDC_ABI,
+    functionName: 'transfer',
+    args: [toAddress, amount],
+  });
+
+  // Wait for confirmation
+  await publicClient.waitForTransactionReceipt({ hash: txHash, confirmations: 1 });
+
+  return {
+    txHash,
+    explorer: `https://basescan.org/tx/${txHash}`,
+    from: account.address,
+    amount: amountUsdc,
+  };
+}
+
+/**
+ * Get the wallet address from a private key
+ */
+export function getAddressFromKey(privateKey) {
+  const account = privateKeyToAccount(privateKey);
+  return account.address;
+}
+
+/**
+ * Get USDC balance for an address
+ */
+export async function getUsdcBalance(address) {
+  const publicClient = createPublicClient({
+    chain: base,
+    transport: http('https://mainnet.base.org'),
+  });
+
+  const balance = await publicClient.readContract({
+    address: USDC_CONTRACT,
+    abi: USDC_ABI,
+    functionName: 'balanceOf',
+    args: [address],
+  });
+
+  return Number(balance) / 1_000_000;
+}