x402-bazaar 1.2.1 → 2.0.0

package/bin/cli.js

@@ -4,6 +4,10 @@ import { Command } from 'commander';
 import { initCommand } from '../src/commands/init.js';
 import { configCommand } from '../src/commands/config.js';
 import { statusCommand } from '../src/commands/status.js';
+import { listCommand } from '../src/commands/list.js';
+import { searchCommand } from '../src/commands/search.js';
+import { callCommand } from '../src/commands/call.js';
+import { walletCommand } from '../src/commands/wallet.js';
 import chalk from 'chalk';
 
 // Global error handler
@@ -21,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('1.2.1');
+  .version('2.0.0');
 
 program
   .command('init')
@@ -49,17 +53,53 @@ program
   .option('--server-url <url>', 'Server URL to check', 'https://x402-api.onrender.com')
   .action(statusCommand);
 
+program
+  .command('list')
+  .description('List all services on x402 Bazaar')
+  .option('--chain <chain>', 'Filter by chain (base or skale)')
+  .option('--category <category>', 'Filter by category (ai, data, weather, etc.)')
+  .option('--free', 'Show only free services')
+  .option('--server-url <url>', 'Server URL', 'https://x402-api.onrender.com')
+  .action(listCommand);
+
+program
+  .command('search <query>')
+  .description('Search for services by keyword')
+  .option('--server-url <url>', 'Server URL', 'https://x402-api.onrender.com')
+  .action(searchCommand);
+
+program
+  .command('call <endpoint>')
+  .description('Call a marketplace endpoint (testing/debugging)')
+  .option('--param <key=value>', 'Add parameter (can be used multiple times)', (value, previous) => {
+    return previous ? [...previous, value] : [value];
+  }, [])
+  .option('--server-url <url>', 'Server URL', 'https://x402-api.onrender.com')
+  .action(callCommand);
+
+program
+  .command('wallet')
+  .description('Check USDC wallet balance on Base')
+  .option('--address <address>', 'Ethereum address to check')
+  .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'));
+  console.log(chalk.hex('#FF9900').bold('  x402 Bazaar') + chalk.dim(' — AI Agent Marketplace CLI v2'));
+  console.log('');
+  console.log('  Setup commands:');
+  console.log(chalk.cyan('    npx x402-bazaar init') + chalk.dim('          Full interactive setup'));
+  console.log(chalk.cyan('    npx x402-bazaar config') + chalk.dim('        Generate MCP config'));
+  console.log(chalk.cyan('    npx x402-bazaar status') + chalk.dim('        Check server connection'));
   console.log('');
-  console.log('  Quick start:');
-  console.log(chalk.cyan('    npx x402-bazaar init') + chalk.dim('      Full interactive setup'));
-  console.log(chalk.cyan('    npx x402-bazaar status') + chalk.dim('    Check server connection'));
-  console.log(chalk.cyan('    npx x402-bazaar config') + chalk.dim('    Generate MCP config'));
+  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('');
-  console.log(chalk.dim('  Run with --help for all options'));
+  console.log(chalk.dim('  Run any command with --help for detailed options'));
   console.log('');
   process.exit(0);
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "x402-bazaar",
-  "version": "1.2.1",
-  "description": "CLI to set up x402 Bazaar MCP server for AI agents. One command to connect your agent to the marketplace.",
+  "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.",
   "type": "module",
   "main": "bin/cli.js",
   "bin": {

package/src/commands/call.js

@@ -0,0 +1,197 @@
+import ora from 'ora';
+import chalk from 'chalk';
+import { log } from '../utils/logger.js';
+
+export async function callCommand(endpoint, options) {
+  if (!endpoint || endpoint.trim().length === 0) {
+    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"');
+    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}`;
+
+  log.banner();
+  log.info(`Calling endpoint: ${chalk.bold(normalizedEndpoint)}`);
+  console.log('');
+
+  // Parse params
+  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
+      if ((value.startsWith('"') && value.endsWith('"')) ||
+          (value.startsWith("'") && value.endsWith("'"))) {
+        value = value.slice(1, -1);
+      }
+      params[key.trim()] = value;
+    }
+  }
+
+  if (Object.keys(params).length > 0) {
+    log.info('Parameters:');
+    for (const [k, v] of Object.entries(params)) {
+      log.dim(`  ${k}: ${v}`);
+    }
+    console.log('');
+  }
+
+  // Build URL with query params (always use GET for marketplace APIs)
+  let finalUrl = fullUrl;
+  if (Object.keys(params).length > 0) {
+    const queryString = new URLSearchParams(params).toString();
+    finalUrl = `${fullUrl}?${queryString}`;
+  }
+
+  const spinner = ora(`GET ${finalUrl}...`).start();
+
+  try {
+    const fetchOptions = {
+      method: 'GET',
+      headers: {
+        'Content-Type': 'application/json',
+      },
+      signal: AbortSignal.timeout(30000),
+    };
+
+    const res = await fetch(finalUrl, fetchOptions);
+
+    spinner.stop();
+
+    // Handle 402 Payment Required
+    if (res.status === 402) {
+      console.log('');
+      log.warn(chalk.bold('Payment Required (HTTP 402)'));
+      console.log('');
+
+      try {
+        const paymentInfo = await res.json();
+
+        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}`);
+        }
+
+        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('');
+
+      } catch {
+        log.dim('  This endpoint requires payment.');
+        log.dim('  Use the MCP server for automatic payment handling.');
+        console.log('');
+      }
+      return;
+    }
+
+    // Handle other errors
+    if (!res.ok) {
+      console.log('');
+      log.error(`HTTP ${res.status}: ${res.statusText}`);
+
+      try {
+        const errorBody = await res.text();
+        if (errorBody) {
+          console.log('');
+          log.dim('Response:');
+          console.log(chalk.red(errorBody));
+        }
+      } catch {
+        // Ignore
+      }
+
+      console.log('');
+      process.exit(1);
+    }
+
+    // Success
+    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('');
+
+      // Pretty-print JSON with syntax highlighting
+      const jsonString = JSON.stringify(responseData, null, 2);
+      const highlighted = highlightJson(jsonString);
+      console.log(highlighted);
+      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('');
+
+  } catch (err) {
+    spinner.fail('Request 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');
+    } else {
+      log.error(err.message);
+    }
+
+    console.log('');
+    process.exit(1);
+  }
+}
+
+/**
+ * Simple JSON syntax highlighting for terminal
+ */
+function highlightJson(jsonString) {
+  return jsonString
+    .replace(/"([^"]+)":/g, chalk.hex('#60A5FA')('"$1"') + ':')
+    .replace(/: "([^"]+)"/g, ': ' + chalk.hex('#34D399')('"$1"'))
+    .replace(/: (\d+\.?\d*)/g, ': ' + chalk.hex('#FBBF24')('$1'))
+    .replace(/: (true|false)/g, ': ' + chalk.hex('#9333EA')('$1'))
+    .replace(/: null/g, ': ' + chalk.hex('#6B7280')('null'));
+}

package/src/commands/init.js

@@ -191,8 +191,8 @@ export async function initCommand(options) {
 
   console.log('');
 
-  // ─── Step 3: Wallet Configuration ───────────────────────────────────
-  log.step(3, 'Configuring wallet...');
+  // ─── Step 3: Network & Wallet Configuration ────────────────────────
+  log.step(3, 'Configuring network and wallet...');
   console.log('');
 
   let walletMode = 'readonly';
@@ -207,6 +207,42 @@ export async function initCommand(options) {
     log.info('Skipping wallet setup (--no-wallet)');
     walletMode = 'readonly';
   } else {
+    // Network & Budget first — needed for wallet funding instructions
+    const configOverrides = {};
+    if (options.network) configOverrides.network = options.network;
+    if (options.budget) configOverrides.maxBudget = options.budget;
+
+    const configAnswers = await promptOrDefault([
+      {
+        type: 'list',
+        name: 'network',
+        message: 'Which network?',
+        choices: [
+          { name: 'Base Mainnet (real USDC)', value: 'mainnet' },
+          { name: 'Base Sepolia (testnet, free tokens for testing)', value: 'testnet' },
+          { name: 'SKALE Europa (zero gas fees — advanced users)', value: 'skale' },
+        ],
+        default: 'mainnet',
+      },
+      {
+        type: 'input',
+        name: 'maxBudget',
+        message: 'Max USDC budget per session (safety limit):',
+        default: '1.00',
+        validate: (v) => {
+          const n = parseFloat(v);
+          if (isNaN(n) || n <= 0) return 'Must be a positive number';
+          if (n > 100) return 'Maximum is 100 USDC per session';
+          return true;
+        },
+      },
+    ], configOverrides);
+
+    network = configAnswers.network;
+    maxBudget = configAnswers.maxBudget;
+
+    console.log('');
+
     const { mode } = await promptOrDefault([{
       type: 'list',
       name: 'mode',
@@ -247,19 +283,36 @@ export async function initCommand(options) {
         ).toString().trim();
         console.log('');
         log.info(`Wallet address: ${chalk.bold(walletAddress)}`);
-        log.dim(`  BaseScan: https://basescan.org/address/${walletAddress}`);
+        if (network === 'skale') {
+          log.dim(`  Explorer: https://elated-tan-skat.explorer.mainnet.skalenodes.com/address/${walletAddress}`);
+        } else {
+          log.dim(`  BaseScan: https://basescan.org/address/${walletAddress}`);
+        }
         console.log('');
         log.separator();
-        log.info(chalk.bold('To activate payments, fund this wallet from MetaMask:'));
-        console.log('');
-        log.dim(`  ${chalk.white('1.')} Open MetaMask and switch to the ${chalk.bold('Base')} network`);
-        log.dim(`     (Chain ID: 8453 — add it via https://chainlist.org/chain/8453)`);
-        log.dim(`  ${chalk.white('2.')} Send ${chalk.bold('USDC')} to: ${chalk.hex('#34D399')(walletAddress)}`);
-        log.dim(`     (Even $1 USDC is enough to start — each API call costs $0.005-$0.05)`);
-        log.dim(`  ${chalk.white('3.')} Send a tiny bit of ${chalk.bold('ETH')} to the same address for gas`);
-        log.dim(`     (${chalk.white('~$0.01 of ETH on Base')} is enough for hundreds of transactions)`);
-        console.log('');
-        log.warn(`IMPORTANT: Send on the ${chalk.bold('Base')} network only — not Ethereum mainnet!`);
+        if (network === 'skale') {
+          log.info(chalk.bold('To activate payments, fund this wallet:'));
+          console.log('');
+          log.dim(`  ${chalk.white('1.')} Bridge USDC to SKALE Europa`);
+          log.dim(`     (Use https://portal.skale.space/bridge or any SKALE bridge)`);
+          log.dim(`  ${chalk.white('2.')} Send ${chalk.bold('USDC')} to: ${chalk.hex('#34D399')(walletAddress)}`);
+          log.dim(`     (Even $1 USDC is enough — each API call costs $0.005-$0.05)`);
+          log.dim(`  ${chalk.white('3.')} Get free sFUEL for gas at https://www.sfuelstation.com/`);
+          log.dim(`     (sFUEL is free — no ETH needed on SKALE!)`);
+          console.log('');
+          log.warn(`IMPORTANT: Send USDC on ${chalk.bold('SKALE Europa')} only — not Base or Ethereum!`);
+        } else {
+          log.info(chalk.bold('To activate payments, fund this wallet from MetaMask:'));
+          console.log('');
+          log.dim(`  ${chalk.white('1.')} Open MetaMask and switch to the ${chalk.bold('Base')} network`);
+          log.dim(`     (Chain ID: 8453 — add it via https://chainlist.org/chain/8453)`);
+          log.dim(`  ${chalk.white('2.')} Send ${chalk.bold('USDC')} to: ${chalk.hex('#34D399')(walletAddress)}`);
+          log.dim(`     (Even $1 USDC is enough to start — each API call costs $0.005-$0.05)`);
+          log.dim(`  ${chalk.white('3.')} Send a tiny bit of ${chalk.bold('ETH')} to the same address for gas`);
+          log.dim(`     (${chalk.white('~$0.01 of ETH on Base')} is enough for hundreds of transactions)`);
+          console.log('');
+          log.warn(`IMPORTANT: Send on the ${chalk.bold('Base')} network only — not Ethereum mainnet!`);
+        }
         log.separator();
       } catch {
         log.info('Wallet address will be shown when you first use the MCP server.');
@@ -325,39 +378,6 @@ export async function initCommand(options) {
         }
       }
     }
-
-    // Network & Budget — use CLI flags as overrides
-    const configOverrides = {};
-    if (options.network) configOverrides.network = options.network;
-    if (options.budget) configOverrides.maxBudget = options.budget;
-
-    const configAnswers = await promptOrDefault([
-      {
-        type: 'list',
-        name: 'network',
-        message: 'Which network?',
-        choices: [
-          { name: 'Base Mainnet (real USDC)', value: 'mainnet' },
-          { name: 'Base Sepolia (testnet, free tokens for testing)', value: 'testnet' },
-        ],
-        default: 'mainnet',
-      },
-      {
-        type: 'input',
-        name: 'maxBudget',
-        message: 'Max USDC budget per session (safety limit):',
-        default: '1.00',
-        validate: (v) => {
-          const n = parseFloat(v);
-          if (isNaN(n) || n <= 0) return 'Must be a positive number';
-          if (n > 100) return 'Maximum is 100 USDC per session';
-          return true;
-        },
-      },
-    ], configOverrides);
-
-    network = configAnswers.network;
-    maxBudget = configAnswers.maxBudget;
   }
 
   console.log('');
@@ -461,7 +481,7 @@ export async function initCommand(options) {
     `Environment:    ${targetEnv.label}`,
     `Install dir:    ${installDir}`,
     `Server:         ${serverUrl}`,
-    `Network:        ${network === 'mainnet' ? 'Base Mainnet' : 'Base Sepolia'}`,
+    `Network:        ${network === 'mainnet' ? 'Base Mainnet' : network === 'skale' ? 'SKALE Europa' : 'Base Sepolia'}`,
     `Budget limit:   ${maxBudget} USDC / session`,
     `Wallet:         ${walletLabel}`,
     `Services:       ${serviceCount > 0 ? serviceCount + ' available' : 'check with npx x402-bazaar status'}`,
@@ -470,7 +490,9 @@ export async function initCommand(options) {
     '',
     ...(walletMode === 'generate' ? [
       'Before your agent can pay for APIs:',
-      '  1. Send USDC + a little ETH to your wallet on Base',
+      network === 'skale'
+        ? '  1. Bridge USDC to your wallet on SKALE Europa + get free sFUEL'
+        : '  1. Send USDC + a little ETH to your wallet on Base',
       '  2. Restart your IDE',
       '',
     ] : []),

package/src/commands/list.js

@@ -0,0 +1,125 @@
+import ora from 'ora';
+import chalk from 'chalk';
+import { log } from '../utils/logger.js';
+
+const CATEGORIES = [
+  'ai', 'data', 'automation', 'blockchain', 'weather', 'finance',
+  'social', 'image', 'video', 'audio', 'search', 'translation', 'other'
+];
+
+export async function listCommand(options) {
+  const serverUrl = options.serverUrl || 'https://x402-api.onrender.com';
+
+  log.banner();
+  log.info(`Fetching services from ${chalk.bold('x402 Bazaar')}`);
+  console.log('');
+
+  // Build query params
+  const params = new URLSearchParams();
+  if (options.chain) params.append('chain', options.chain);
+  if (options.category) params.append('category', options.category);
+  if (options.free) params.append('free', 'true');
+
+  const url = `${serverUrl}/api/services${params.toString() ? '?' + params.toString() : ''}`;
+
+  const spinner = ora('Loading services...').start();
+
+  try {
+    const res = await fetch(url, { signal: AbortSignal.timeout(15000) });
+
+    if (!res.ok) {
+      throw new Error(`HTTP ${res.status}: ${res.statusText}`);
+    }
+
+    const data = await res.json();
+    const services = data.services || data || [];
+
+    spinner.succeed(`Found ${chalk.bold(services.length)} service${services.length !== 1 ? 's' : ''}`);
+    console.log('');
+
+    if (services.length === 0) {
+      log.warn('No services found with these filters.');
+      log.dim('  Try: x402-bazaar list --category ai');
+      console.log('');
+      return;
+    }
+
+    // Display services table
+    log.separator();
+    console.log('');
+
+    services.forEach((service, idx) => {
+      const name = service.name || service.title || 'Unnamed Service';
+      const price = parseFloat(service.price || 0);
+      const priceLabel = price === 0
+        ? chalk.hex('#34D399').bold('FREE')
+        : chalk.cyan(`$${price.toFixed(3)} USDC`);
+
+      // Extract category from tags
+      let category = 'other';
+      if (service.tags && Array.isArray(service.tags)) {
+        const realCategories = service.tags.filter(t => CATEGORIES.includes(t.toLowerCase()));
+        if (realCategories.length > 0) {
+          category = realCategories[0];
+        }
+      }
+
+      const chain = service.chain || 'base';
+      const chainLabel = chain === 'skale'
+        ? chalk.hex('#9333EA')('SKALE')
+        : chalk.hex('#0052FF')('Base');
+
+      console.log(
+        chalk.hex('#FF9900').bold(`${(idx + 1).toString().padStart(2, ' ')}. `) +
+        chalk.white.bold(name)
+      );
+      console.log(`    ${priceLabel} ${chalk.dim('|')} ${chalk.hex('#60A5FA')(category)} ${chalk.dim('|')} ${chainLabel}`);
+
+      if (service.description) {
+        const desc = service.description.length > 80
+          ? service.description.substring(0, 77) + '...'
+          : service.description;
+        console.log(`    ${chalk.hex('#6B7280')(desc)}`);
+      }
+
+      if (service.endpoint) {
+        console.log(`    ${chalk.dim('Endpoint:')} ${chalk.hex('#FBBF24')(service.endpoint)}`);
+      }
+
+      console.log('');
+    });
+
+    log.separator();
+    console.log('');
+    log.info(`Total: ${chalk.bold(services.length)} service${services.length !== 1 ? 's' : ''}`);
+
+    // Show filter info
+    if (options.chain || options.category || options.free) {
+      console.log('');
+      log.dim('  Active filters:');
+      if (options.chain) log.dim(`    Chain: ${options.chain}`);
+      if (options.category) log.dim(`    Category: ${options.category}`);
+      if (options.free) log.dim('    Price: free only');
+      log.dim('  Run without options to see all services');
+    }
+
+    console.log('');
+
+  } catch (err) {
+    spinner.fail('Failed to fetch services');
+
+    if (err.name === 'AbortError') {
+      log.error('Request timeout — server may be sleeping (Render free tier)');
+      log.dim('  Try again in 30 seconds 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');
+    } else {
+      log.error(err.message);
+    }
+
+    console.log('');
+    process.exit(1);
+  }
+}

package/src/commands/search.js

@@ -0,0 +1,120 @@
+import ora from 'ora';
+import chalk from 'chalk';
+import { log } from '../utils/logger.js';
+
+const CATEGORIES = [
+  'ai', 'data', 'automation', 'blockchain', 'weather', 'finance',
+  'social', 'image', 'video', 'audio', 'search', 'translation', 'other'
+];
+
+export async function searchCommand(query, options) {
+  if (!query || query.trim().length === 0) {
+    log.error('Search query is required');
+    log.dim('  Usage: x402-bazaar search <query>');
+    log.dim('  Example: x402-bazaar search "weather API"');
+    console.log('');
+    process.exit(1);
+  }
+
+  const serverUrl = options.serverUrl || 'https://x402-api.onrender.com';
+
+  log.banner();
+  log.info(`Searching for: ${chalk.bold(query)}`);
+  console.log('');
+
+  const url = `${serverUrl}/api/services?search=${encodeURIComponent(query)}`;
+  const spinner = ora('Searching...').start();
+
+  try {
+    const res = await fetch(url, { signal: AbortSignal.timeout(15000) });
+
+    if (!res.ok) {
+      throw new Error(`HTTP ${res.status}: ${res.statusText}`);
+    }
+
+    const data = await res.json();
+    const services = data.services || data || [];
+
+    if (services.length === 0) {
+      spinner.fail('No results found');
+      console.log('');
+      log.warn(`No services match "${query}"`);
+      log.dim('  Tips:');
+      log.dim('    • Check your spelling');
+      log.dim('    • Try broader keywords (e.g., "AI" instead of "GPT-4")');
+      log.dim('    • Browse all services: x402-bazaar list');
+      console.log('');
+      return;
+    }
+
+    spinner.succeed(`Found ${chalk.bold(services.length)} result${services.length !== 1 ? 's' : ''}`);
+    console.log('');
+
+    // Display results
+    log.separator();
+    console.log('');
+
+    services.forEach((service, idx) => {
+      const name = service.name || service.title || 'Unnamed Service';
+      const price = parseFloat(service.price || 0);
+      const priceLabel = price === 0
+        ? chalk.hex('#34D399').bold('FREE')
+        : chalk.cyan(`$${price.toFixed(3)} USDC`);
+
+      // Extract category from tags
+      let category = 'other';
+      if (service.tags && Array.isArray(service.tags)) {
+        const realCategories = service.tags.filter(t => CATEGORIES.includes(t.toLowerCase()));
+        if (realCategories.length > 0) {
+          category = realCategories[0];
+        }
+      }
+
+      const chain = service.chain || 'base';
+      const chainLabel = chain === 'skale'
+        ? chalk.hex('#9333EA')('SKALE')
+        : chalk.hex('#0052FF')('Base');
+
+      console.log(
+        chalk.hex('#FF9900').bold(`${(idx + 1).toString().padStart(2, ' ')}. `) +
+        chalk.white.bold(name)
+      );
+      console.log(`    ${priceLabel} ${chalk.dim('|')} ${chalk.hex('#60A5FA')(category)} ${chalk.dim('|')} ${chainLabel}`);
+
+      if (service.description) {
+        const desc = service.description.length > 80
+          ? service.description.substring(0, 77) + '...'
+          : service.description;
+        console.log(`    ${chalk.hex('#6B7280')(desc)}`);
+      }
+
+      if (service.endpoint) {
+        console.log(`    ${chalk.dim('Endpoint:')} ${chalk.hex('#FBBF24')(service.endpoint)}`);
+      }
+
+      console.log('');
+    });
+
+    log.separator();
+    console.log('');
+    log.info(`Total: ${chalk.bold(services.length)} result${services.length !== 1 ? 's' : ''}`);
+    console.log('');
+
+  } catch (err) {
+    spinner.fail('Search failed');
+
+    if (err.name === 'AbortError') {
+      log.error('Request timeout — server may be sleeping (Render free tier)');
+      log.dim('  Try again in 30 seconds 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');
+    } else {
+      log.error(err.message);
+    }
+
+    console.log('');
+    process.exit(1);
+  }
+}

package/src/commands/wallet.js

@@ -0,0 +1,156 @@
+import ora from 'ora';
+import chalk from 'chalk';
+import { log } from '../utils/logger.js';
+
+const BASE_RPC_URL = 'https://mainnet.base.org';
+const USDC_CONTRACT_BASE = '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913';
+const BALANCE_OF_SELECTOR = '0x70a08231';
+
+export async function walletCommand(options) {
+  log.banner();
+
+  if (!options.address) {
+    log.info('Check USDC balance for any wallet address on Base.');
+    console.log('');
+    log.dim('  Usage:');
+    log.dim('    x402-bazaar wallet --address 0xYourAddress');
+    console.log('');
+    log.dim('  Example:');
+    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?"');
+    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');
+    log.dim(`  Got: ${address}`);
+    console.log('');
+    process.exit(1);
+  }
+
+  log.info(`Checking wallet: ${chalk.bold(maskAddress(address))}`);
+  console.log('');
+
+  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',
+      ],
+    };
+
+    const res = await fetch(BASE_RPC_URL, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify(rpcPayload),
+      signal: AbortSignal.timeout(15000),
+    });
+
+    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');
+    }
+
+    // Parse balance (USDC has 6 decimals)
+    const balanceHex = rpcResponse.result;
+    const balanceRaw = BigInt(balanceHex);
+    const balanceUsdc = Number(balanceRaw) / 1_000_000;
+
+    spinner.succeed('Balance fetched');
+    console.log('');
+
+    log.separator();
+    console.log('');
+
+    log.info(`Address:  ${chalk.hex('#34D399')(maskAddress(address))}`);
+    log.info(`Network:  ${chalk.hex('#0052FF').bold('Base Mainnet')} (Chain ID: 8453)`);
+    log.info(`Balance:  ${chalk.cyan.bold(balanceUsdc.toFixed(6))} ${chalk.dim('USDC')}`);
+
+    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');
+    } 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.');
+    } 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)`);
+    }
+
+    console.log('');
+
+  } catch (err) {
+    spinner.fail('Failed to fetch balance');
+    console.log('');
+
+    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
+ */
+function maskAddress(address) {
+  if (address.length < 12) return address;
+  return `${address.slice(0, 6)}...${address.slice(-4)}`;
+}