x402-bazaar 1.2.2 → 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.2');
+  .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.2",
-  "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/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)}`;
+}