@jellylegsai/aether-cli 1.9.1 → 2.0.1

package/commands/validators.js

@@ -1,626 +1,623 @@
-#!/usr/bin/env node
-/**
- * aether-cli validators
- *
- * List, filter, and inspect validators on the Aether network.
- * Shows identity, tier, stake, APY, uptime, and performance metrics.
- *
- * Usage:
- *   aether validators list              List all active validators
- *   aether validators list --tier full   Filter by tier (full|lite|observer)
- *   aether validators list --json        JSON output for scripting
- *   aether validators list --rpc <url>   Query a specific RPC endpoint
- *   aether validators list --sort stake  Sort by stake (default: score)
- *
- * Requires AETHER_RPC env var (default: http://127.0.0.1:8899)
- * 
- * SDK wired to: GET /v1/validators, GET /v1/epoch, GET /v1/supply
- */
-
-const path = require('path');
-
-// Import SDK for real blockchain RPC calls
-const sdkPath = path.join(__dirname, '..', 'sdk', 'index.js');
-const aether = require(sdkPath);
-
-// ANSI colours
-const C = {
-  reset: '\x1b[0m',
-  bright: '\x1b[1m',
-  dim: '\x1b[2m',
-  red: '\x1b[31m',
-  green: '\x1b[32m',
-  yellow: '\x1b[33m',
-  blue: '\x1b[34m',
-  cyan: '\x1b[36m',
-  magenta: '\x1b[35m',
-};
-
-function getDefaultRpc() {
-  return process.env.AETHER_RPC || aether.DEFAULT_RPC_URL || 'http://127.0.0.1:8899';
-}
-
-function createClient(rpcUrl) {
-  return new aether.AetherClient({ rpcUrl });
-}
-
-// ---------------------------------------------------------------------------
-// Argument parsing
-// ---------------------------------------------------------------------------
-
-function parseArgs() {
-  const args = process.argv.slice(3); // [node, index.js, validators, list, ...]
-  const opts = {
-    rpc: getDefaultRpc(),
-    subcmd: 'list',
-    tier: null,
-    asJson: false,
-    sortBy: 'score',
-    limit: 100,
-    rank: false,
-  };
-
-  for (let i = 0; i < args.length; i++) {
-    const arg = args[i];
-    if (arg === '--tier' || arg === '-t') {
-      const tier = (args[++i] || '').toLowerCase();
-      if (['full', 'lite', 'observer'].includes(tier)) {
-        opts.tier = tier;
-      } else {
-        console.log(`  ${C.yellow}⚠ Invalid tier "${tier}". Valid: full, lite, observer${C.reset}`);
-      }
-    } else if (arg === '--json' || arg === '-j') {
-      opts.asJson = true;
-    } else if (arg === '--rpc' || arg === '-r') {
-      opts.rpc = args[++i];
-    } else if (arg === '--sort' || arg === '-s') {
-      const sortVal = (args[++i] || '').toLowerCase();
-      if (['stake', 'score', 'apy', 'uptime', 'name'].includes(sortVal)) {
-        opts.sortBy = sortVal;
-      } else {
-        console.log(`  ${C.yellow}⚠ Invalid sort "${sortVal}". Valid: stake, score, apy, uptime, name${C.reset}`);
-      }
-    } else if (arg === '--limit' || arg === '-l') {
-      const limit = parseInt(args[++i], 10);
-      if (!isNaN(limit) && limit > 0 && limit <= 500) {
-        opts.limit = limit;
-      }
-    } else if (arg === '--help' || arg === '-h') {
-      showHelp();
-      process.exit(0);
-    } else if (arg === '--rank') {
-      opts.rank = true;
-      opts.subcmd = 'rank';
-    }
-  }
-
-  return opts;
-}
-
-function showHelp() {
-  const defaultRpc = getDefaultRpc();
-  console.log(`
-${C.bright}${C.cyan}aether-cli validators${C.reset} - List and inspect Aether validators
-
-${C.bright}Usage:${C.reset}
-  aether validators list [options]
-  aether validators rank [options]        Ranked leaderboard (sorted by stake)
-
-${C.bright}Options (list):${C.reset}
-  -t, --tier <type>   Filter by tier: full, lite, observer
-  -s, --sort <field>  Sort by: stake, score, apy, uptime, name (default: score)
-  -l, --limit <n>     Max validators to show (default: 100, max: 500)
-  -r, --rpc <url>     RPC endpoint (default: ${defaultRpc} or $AETHER_RPC)
-  -j, --json          Output raw JSON (for scripting)
-  -h, --help          Show this help message
-
-${C.bright}Options (rank):${C.reset}
-  -t, --tier <type>   Filter by tier: full, lite, observer
-  -l, --limit <n>     Max validators to show (default: 50, max: 200)
-  -r, --rpc <url>     RPC endpoint (default: ${defaultRpc} or $AETHER_RPC)
-  -j, --json          Output raw JSON (for scripting)
-  -h, --help          Show this help message
-
-${C.bright}SDK Methods Used:${C.reset}
-  client.getValidators()  → GET /v1/validators
-  client.getEpochInfo()   → GET /v1/epoch
-  client.getSupply()      → GET /v1/supply
-
-${C.bright}Examples:${C.reset}
-  aether validators list                  # All validators, sorted by score
-  aether validators list --tier full       # Full validators only
-  aether validators list --sort stake      # Sort by total stake
-  aether validators list --sort apy        # Sort by estimated APY
-  aether validators list --json           # JSON for scripts
-  aether validators rank                  # Top validators by stake (leaderboard)
-  aether validators rank --tier full       # Full validators only
-  aether validators rank --limit 20       # Top 20 validators
-  aether validators list --rpc http://custom-rpc:8899
-`.trim());
-}
-
-// ---------------------------------------------------------------------------
-// Data fetchers using SDK - Real blockchain RPC calls
-// ---------------------------------------------------------------------------
-
-/** Fetch all validators from the network using SDK */
-async function fetchValidators(rpc) {
-  try {
-    const client = createClient(rpc);
-    // SDK getValidators() → GET /v1/validators
-    const result = await client.getValidators();
-    return Array.isArray(result) ? result : [];
-  } catch {
-    return [];
-  }
-}
-
-/** Fetch epoch info for APY calculations using SDK */
-async function fetchEpochInfo(rpc) {
-  try {
-    const client = createClient(rpc);
-    // SDK getEpochInfo() → GET /v1/epoch
-    const result = await client.getEpochInfo();
-    return result || null;
-  } catch {
-    return null;
-  }
-}
-
-/** Fetch network-wide stake totals for APY estimation using SDK */
-async function fetchSupply(rpc) {
-  try {
-    const client = createClient(rpc);
-    // SDK getSupply() → GET /v1/supply
-    const result = await client.getSupply();
-    return result || null;
-  } catch {
-    return null;
-  }
-}
-
-// ---------------------------------------------------------------------------
-// Normalise validator record from various RPC response shapes
-// ---------------------------------------------------------------------------
-
-function normaliseValidator(v) {
-  // Handle different response shapes from different RPC implementations
-  const pubkey = v.pubkey || v.address || v.identity || v.id || null;
-  const name = v.name || v.moniker || v.label || v.identity_name || null;
-  const tier = (v.tier || v.node_type || v.type || 'full').toLowerCase();
-  const stake = BigInt(v.stake || v.delegatedStake || v.stake_lamports || v.lamports || 0);
-  const score = v.score !== undefined ? v.score : (v.uptime !== undefined ? Math.round(v.uptime * 100) : null);
-  const apy = v.apy !== undefined ? v.apy : (v.apy_bps !== undefined ? v.apy_bps / 100 : null);
-  const commission = v.commission !== undefined ? v.commission : (v.commission_bps !== undefined ? v.commission_bps / 100 : null);
-  const version = v.version || v.agent || v.app_version || null;
-  const ip = v.ip || v.remote || null;
-  const lastVote = v.last_vote || v.lastVote || null;
-  const epoch = v.epoch || null;
-  const voteAccount = v.vote_account || v.voteAccount || null;
-
-  return {
-    pubkey,
-    name,
-    tier,
-    stake: stake.toString(),
-    stakeFormatted: formatAether(stake),
-    stakeAeth: Number(stake) / 1e9,
-    score,
-    apy,
-    commission,
-    version,
-    ip,
-    lastVote,
-    epoch,
-    voteAccount,
-    // Raw for JSON export
-    _raw: v,
-  };
-}
-
-function formatAether(lamports) {
-  const aeth = Number(lamports) / 1e9;
-  if (aeth === 0) return '0 AETH';
-  return aeth.toFixed(2).replace(/\.?0+$/, '') + ' AETH';
-}
-
-function formatScore(score) {
-  if (score === null || score === undefined) return `${C.dim}—${C.reset}`;
-  if (score >= 80) return `${C.green}${score}${C.reset}`;
-  if (score >= 50) return `${C.yellow}${score}${C.reset}`;
-  return `${C.red}${score}${C.reset}`;
-}
-
-// ---------------------------------------------------------------------------
-// Render outputs
-// ---------------------------------------------------------------------------
-
-function tierColor(tier) {
-  if (tier === 'full') return `${C.cyan}FULL${C.reset}`;
-  if (tier === 'lite') return `${C.yellow}LITE${C.reset}`;
-  if (tier === 'observer') return `${C.green}OBS${C.reset}`;
-  return `${C.dim}${tier.toUpperCase()}${C.reset}`;
-}
-
-function tierBadge(tier) {
-  if (tier === 'full') return `${C.cyan}◆ FULL${C.reset}`;
-  if (tier === 'lite') return `${C.yellow}◇ LITE${C.reset}`;
-  if (tier === 'observer') return `${C.green}○ OBS${C.reset}`;
-  return `${C.dim}[${tier}]${C.reset}`;
-}
-
-function renderTable(validators, opts) {
-  const sortBy = opts.sortBy;
-  const tier = opts.tier;
-
-  // Sort validators
-  const sorted = [...validators].sort((a, b) => {
-    if (sortBy === 'stake') return b.stakeAeth - a.stakeAeth;
-    if (sortBy === 'score') return (b.score || 0) - (a.score || 0);
-    if (sortBy === 'apy') return (b.apy || 0) - (a.apy || 0);
-    if (sortBy === 'name') return (a.name || '').localeCompare(b.name || '');
-    return 0;
-  });
-
-  // Filter by tier
-  const filtered = tier
-    ? sorted.filter(v => v.tier === tier)
-    : sorted;
-
-  const shown = filtered.slice(0, opts.limit);
-  const total = filtered.length;
-
-  // Header
-  console.log();
-  console.log(`${C.bright}${C.cyan}╔═══════════════════════════════════════════════════════════════════════════════╗${C.reset}`);
-  console.log(`${C.bright}${C.cyan}║${C.reset}              ${C.bright}AETHER VALIDATORS${C.reset}  ${C.dim}(total: ${total})${C.reset}                      ${C.bright}║${C.reset}`);
-  console.log(`${C.bright}${C.cyan}╚═══════════════════════════════════════════════════════════════════════════════╝${C.reset}`);
-  if (tier) console.log(`  ${C.dim}Tier filter: ${tier.toUpperCase()}   Sort: ${sortBy}   RPC: ${opts.rpc}${C.reset}`);
-  else console.log(`  ${C.dim}Sort: ${sortBy}   RPC: ${opts.rpc}${C.reset}`);
-  console.log();
-
-  if (shown.length === 0) {
-    console.log(`  ${C.yellow}⚠ No validators found${C.reset}${tier ? ` for tier "${tier}"` : ''}.`);
-    console.log(`  ${C.dim}  Check your RPC endpoint: ${opts.rpc}${C.reset}\n`);
-    return;
-  }
-
-  // Table header
-  console.log(`  ${C.bright}┌──────────────────────────────────────────────────────────────────────────────────────┐${C.reset}`);
-  console.log(
-    `  ${C.bright}│${C.reset}` +
-    ` ${C.cyan}#${C.reset}`.padEnd(4) +
-    `${C.cyan}Validator${C.reset}`.padEnd(36) +
-    `${C.cyan}Tier${C.reset}`.padEnd(8) +
-    `${C.cyan}Stake${C.reset}`.padEnd(14) +
-    `${C.cyan}Score${C.reset}`.padEnd(8) +
-    `${C.cyan}APY${C.reset}`.padEnd(8) +
-    `${C.cyan}Version${C.reset}`.padEnd(10) +
-    `${C.bright}│${C.reset}`
-  );
-  console.log(`  ${C.bright}├${'─'.repeat(90)}${C.bright}│${C.reset}`);
-
-  for (let i = 0; i < shown.length; i++) {
-    const v = shown[i];
-    const num = (i + 1).toString().padStart(3);
-    const nameOrKey = v.name
-      ? v.name.substring(0, 20).padEnd(20)
-      : (v.pubkey ? v.pubkey.substring(0, 20).padEnd(20) : 'unknown'.padEnd(20));
-    const tierStr = tierBadge(v.tier);
-    const stakeStr = v.stakeFormatted.padEnd(12);
-    const scoreStr = v.score !== null && v.score !== undefined
-      ? `${v.score}%`.padEnd(6)
-      : '—'.padEnd(6);
-    const apyStr = v.apy !== null && v.apy !== undefined
-      ? `${v.apy.toFixed(1)}%`.padEnd(6)
-      : '—'.padEnd(6);
-    const versionStr = v.version ? v.version.substring(0, 10).padEnd(10) : '—'.padEnd(10);
-
-    const scoreColor = v.score === null || v.score === undefined ? C.dim
-      : v.score >= 80 ? C.green
-      : v.score >= 50 ? C.yellow
-      : C.red;
-
-    console.log(
-      `  ${C.bright}│${C.reset}` +
-      ` ${C.dim}${num}${C.reset} `.substring(0, 5) +
-      `${C.cyan}${nameOrKey}${C.reset} ` +
-      `${tierStr} `.substring(0, 9) +
-      `${C.green}${stakeStr}${C.reset} ` +
-      `${scoreColor}${scoreStr}${C.reset} ` +
-      `${C.green}${apyStr}${C.reset} ` +
-      `${C.dim}${versionStr}${C.reset} ` +
-      `${C.bright}│${C.reset}`
-    );
-  }
-
-  console.log(`  ${C.bright}└${'─'.repeat(90)}${C.bright}│${C.reset}`);
-  console.log();
-
-  // Summary row
-  const totalStake = shown.reduce((sum, v) => sum + v.stakeAeth, 0);
-  const avgScore = shown.reduce((sum, v) => sum + (v.score || 0), 0) / shown.filter(v => v.score !== null).length;
-  const fullCount = shown.filter(v => v.tier === 'full').length;
-  const liteCount = shown.filter(v => v.tier === 'lite').length;
-  const obsCount = shown.filter(v => v.tier === 'observer').length;
-
-  console.log(`  ${C.dim}Showing ${shown.length} of ${total} validators${total !== shown.length ? ` (limit ${opts.limit})` : ''}${C.reset}`);
-  console.log(`  ${C.dim}Total stake shown: ${C.reset}${C.green}${totalStake.toFixed(2)} AETH${C.reset}  ${C.dim}Avg score: ${C.reset}${avgScore ? `${avgScore.toFixed(1)}%` : '—'}${C.reset}`);
-  if (!tier) {
-    console.log(`  ${C.cyan}◆${C.reset} ${C.cyan}Full${C.reset}: ${fullCount}   ${C.yellow}◇${C.reset} ${C.yellow}Lite${C.reset}: ${liteCount}   ${C.green}○${C.reset} ${C.green}Observer${C.reset}: ${obsCount}`);
-  }
-  console.log();
-  console.log(`  ${C.dim}Tip: --tier full|lite|observer  |  --sort stake|score|apy|name  |  --json for data${C.reset}`);
-  console.log();
-}
-
-function renderJson(validators, opts) {
-  const tier = opts.tier;
-  const filtered = tier
-    ? validators.filter(v => v.tier === tier)
-    : validators;
-
-  const out = {
-    rpc: opts.rpc,
-    total: filtered.length,
-    sort: opts.sortBy,
-    tier_filter: tier,
-    fetched_at: new Date().toISOString(),
-    validators: filtered.map(v => ({
-      pubkey: v.pubkey,
-      name: v.name,
-      tier: v.tier,
-      stake: v.stake,
-      stake_aeth: v.stakeAeth,
-      stake_formatted: v.stakeFormatted,
-      score: v.score,
-      apy: v.apy,
-      commission: v.commission,
-      version: v.version,
-      ip: v.ip,
-      vote_account: v.voteAccount,
-      last_vote: v.lastVote,
-      epoch: v.epoch,
-    })),
-  };
-
-  console.log(JSON.stringify(out, null, 2));
-}
-
-// ---------------------------------------------------------------------------
-// Main
-// ---------------------------------------------------------------------------
-
-async function validatorsList(opts) {
-  const rpc = opts.rpc;
-
-  if (!opts.asJson) {
-    console.log(`${C.dim}Fetching validators from ${rpc}...${C.reset}`);
-  }
-
-  const [rawValidators, epochInfo, supply] = await Promise.all([
-    fetchValidators(rpc),
-    fetchEpochInfo(rpc),
-    fetchSupply(rpc),
-  ]);
-
-  if (rawValidators.length === 0) {
-    if (opts.asJson) {
-      console.log(JSON.stringify({ rpc, validators: [], total: 0, error: 'No validator data returned from RPC' }, null, 2));
-    } else {
-      console.log(`\n  ${C.yellow}⚠ No validator data returned from RPC.${C.reset}`);
-      console.log(`  ${C.dim}  RPC: ${rpc}${C.reset}`);
-      console.log(`  ${C.dim}  Check that your validator is running and the RPC endpoint is accessible.${C.reset}`);
-      console.log(`  ${C.dim}  Set custom RPC: AETHER_RPC=http://your-rpc-url${C.reset}\n`);
-    }
-    return;
-  }
-
-  // Normalise all validators
-  let validators = rawValidators.map(normaliseValidator);
-
-  // Estimate APY if not provided by RPC (rough approximation)
-  if (supply && !supply.error) {
-    const totalStake = Number(supply.total_staked || supply.total || 0);
-    const rewardsPerEpoch = Number(epochInfo?.rewards_per_epoch || '2000000000');
-    if (totalStake > 0 && rewardsPerEpoch > 0) {
-      const apyEstimate = (rewardsPerEpoch / totalStake) * 73; // ~73 epochs/year
-      validators = validators.map(v => {
-        if (v.apy === null || v.apy === undefined) {
-          return { ...v, apy: apyEstimate };
-        }
-        return v;
-      });
-    }
-  }
-
-  if (opts.asJson) {
-    renderJson(validators, opts);
-  } else {
-    renderTable(validators, opts);
-  }
-}
-
-// ---------------------------------------------------------------------------
-// Validators Rank — leaderboard sorted by stake
-// ---------------------------------------------------------------------------
-
-function rankBadge(rank) {
-  if (rank === 1) return `${C.yellow}🥇 1${C.reset}`;
-  if (rank === 2) return `${C.dim}🥈 2${C.reset}`;
-  if (rank === 3) return `${C.yellow}🥉 3${C.reset}`;
-  return `${C.dim}${String(rank).padStart(3)}${C.reset}`;
-}
-
-function renderRankTable(validators, opts) {
-  const tier = opts.tier;
-
-  // Sort by stake descending, filter by tier
-  const sorted = [...validators]
-    .sort((a, b) => b.stakeAeth - a.stakeAeth);
-
-  const filtered = tier
-    ? sorted.filter(v => v.tier === tier)
-    : sorted;
-
-  const shown = filtered.slice(0, opts.limit);
-  const total = filtered.length;
-
-  // Total staked across all shown validators
-  const totalStaked = shown.reduce((sum, v) => sum + v.stakeAeth, 0);
-  const maxStake = shown.length > 0 ? shown[0].stakeAeth : 1;
-
-  console.log();
-  console.log(`${C.bright}${C.cyan}╔═══════════════════════════════════════════════════════════════════════════════════╗${C.reset}`);
-  console.log(`${C.bright}${C.cyan}║${C.reset}              ${C.bright}AETHER VALIDATOR LEADERBOARD${C.reset}  ${C.dim}(${total} validators)${C.reset}         ${C.bright}║${C.reset}`);
-  console.log(`${C.bright}${C.cyan}╚═══════════════════════════════════════════════════════════════════════════════════╝${C.reset}`);
-  if (tier) console.log(`  ${C.dim}Tier: ${tier.toUpperCase()}   RPC: ${opts.rpc}${C.reset}`);
-  else console.log(`  ${C.dim}Sorted by stake   RPC: ${opts.rpc}${C.reset}`);
-  console.log();
-  console.log(`  ${C.bright}┌────────────────────────────────────────────────────────────────────────────────────────────┐${C.reset}`);
-  console.log(
-    `  ${C.bright}│${C.reset}` +
-    ` ${C.cyan}Rank${C.reset}`.padEnd(6) +
-    `${C.cyan}Validator${C.reset}`.padEnd(34) +
-    `${C.cyan}Tier${C.reset}`.padEnd(8) +
-    `${C.cyan}Stake (AETH)${C.reset}`.padEnd(16) +
-    `${C.cyan}Score${C.reset}`.padEnd(8) +
-    `${C.cyan}APY${C.reset}`.padEnd(8) +
-    `${C.bright}│${C.reset}`
-  );
-  console.log(`  ${C.bright}├${'─'.repeat(94)}${C.bright}│${C.reset}`);
-
-  for (let i = 0; i < shown.length; i++) {
-    const v = shown[i];
-    const rank = i + 1;
-    const rankStr = rankBadge(rank);
-    const nameOrKey = v.name
-      ? v.name.substring(0, 20).padEnd(20)
-      : (v.pubkey ? v.pubkey.substring(0, 20).padEnd(20) : 'unknown'.padEnd(20));
-    const tierStr = tierBadge(v.tier);
-    const stakeFormatted = v.stakeFormatted.padEnd(14);
-    const scoreStr = v.score !== null && v.score !== undefined
-      ? `${v.score}%`.padEnd(6)
-      : '—'.padEnd(6);
-    const apyStr = v.apy !== null && v.apy !== undefined
-      ? `${v.apy.toFixed(1)}%`.padEnd(6)
-      : '—'.padEnd(6);
-
-    const scoreColor = v.score === null || v.score === undefined ? C.dim
-      : v.score >= 80 ? C.green
-      : v.score >= 50 ? C.yellow
-      : C.red;
-
-    // Mini bar for relative stake
-    const barLen = 12;
-    const fillLen = maxStake > 0 ? Math.round((v.stakeAeth / maxStake) * barLen) : 0;
-    const stakeBar = `${C.green}${'█'.repeat(fillLen)}${C.dim}${'░'.repeat(barLen - fillLen)}${C.reset}`;
-
-    console.log(
-      `  ${C.bright}│${C.reset}` +
-      ` ${rankStr} `.substring(0, 7) +
-      `${C.cyan}${nameOrKey}${C.reset} ` +
-      `${tierStr} `.substring(0, 9) +
-      `${stakeBar}${C.reset} ` +
-      `${C.green}${stakeFormatted}${C.reset} ` +
-      `${scoreColor}${scoreStr}${C.reset} ` +
-      `${C.green}${apyStr}${C.reset} ` +
-      `${C.bright}│${C.reset}`
-    );
-  }
-
-  console.log(`  ${C.bright}└${'─'.repeat(94)}${C.bright}│${C.reset}`);
-  console.log();
-
-  // Summary
-  const avgApy = shown.reduce((sum, v) => sum + (v.apy || 0), 0) / shown.filter(v => v.apy !== null).length;
-  console.log(`  ${C.dim}Total staked (shown): ${C.reset}${C.green}${totalStaked.toFixed(2)} AETH${C.reset}  ${C.dim}Avg APY: ${C.reset}${avgApy.toFixed(1)}%  ${C.dim}Top stake: ${C.reset}${maxStake.toFixed(2)} AETH${C.reset}`);
-  console.log(`  ${C.dim}Run with ${C.cyan}--json${C.reset}${C.dim} for raw data, ${C.cyan}--limit 20${C.reset}${C.dim} for top 20${C.reset}`);
-  console.log();
-}
-
-async function validatorsRank(opts) {
-  const rpc = opts.rpc;
-  const limit = Math.min(opts.limit || 50, 200);
-
-  if (!opts.asJson) {
-    console.log(`${C.dim}Fetching validator leaderboard from ${rpc}...${C.reset}`);
-  }
-
-  const [rawValidators, epochInfo, supply] = await Promise.all([
-    fetchValidators(rpc),
-    fetchEpochInfo(rpc),
-    fetchSupply(rpc),
-  ]);
-
-  if (rawValidators.length === 0) {
-    if (opts.asJson) {
-      console.log(JSON.stringify({ rpc, validators: [], total: 0, error: 'No validator data returned from RPC' }, null, 2));
-    } else {
-      console.log(`\n  ${C.yellow}⚠ No validator data returned from RPC.${C.reset}`);
-      console.log(`  ${C.dim}  RPC: ${rpc}${C.reset}`);
-      console.log(`  ${C.dim}  Check that your validator is running and the RPC endpoint is accessible.${C.reset}\n`);
-    }
-    return;
-  }
-
-  let validators = rawValidators.map(normaliseValidator);
-
-  // Estimate APY if not provided
-  if (supply && !supply.error) {
-    const totalStake = Number(supply.total_staked || supply.total || 0);
-    const rewardsPerEpoch = Number(epochInfo?.rewards_per_epoch || '2000000000');
-    if (totalStake > 0 && rewardsPerEpoch > 0) {
-      const apyEstimate = (rewardsPerEpoch / totalStake) * 73;
-      validators = validators.map(v => {
-        if (v.apy === null || v.apy === undefined) {
-          return { ...v, apy: apyEstimate };
-        }
-        return v;
-      });
-    }
-  }
-
-  opts.limit = limit;
-
-  if (opts.asJson) {
-    const ranked = [...validators]
-      .sort((a, b) => b.stakeAeth - a.stakeAeth)
-      .filter(v => !opts.tier || v.tier === opts.tier)
-      .slice(0, limit)
-      .map((v, i) => ({ rank: i + 1, ...v }));
-    console.log(JSON.stringify({ rpc, validators: ranked, total: ranked.length, fetched_at: new Date().toISOString() }, null, 2));
-  } else {
-    renderRankTable(validators, opts);
-  }
-}
-
-// ---------------------------------------------------------------------------
-// Entry point
-// ---------------------------------------------------------------------------
-
-async function main() {
-  const opts = parseArgs();
-
-  if (opts.subcmd === 'list') {
-    await validatorsList(opts);
-  } else if (opts.subcmd === 'rank') {
-    await validatorsRank(opts);
-  } else {
-    console.log(`\n  ${C.red}Unknown subcommand:${C.reset} ${opts.subcmd}`);
-    console.log(`  ${C.dim}Usage: aether validators list [--tier full] [--sort stake] [--json]${C.reset}\n`);
-    process.exit(1);
-  }
-}
-
-main().catch(err => {
-  console.error(`\n${C.red}✗ Validators command failed:${C.reset} ${err.message}`);
-  console.error(`  ${C.dim}Set custom RPC: AETHER_RPC=http://your-rpc-url${C.reset}\n`);
-  process.exit(1);
-});
-
-module.exports = { validatorsListCommand: main };
-
-if (require.main === module) {
-  main();
-}
+#!/usr/bin/env node
+/**
+ * aether-cli validators
+ *
+ * List and manage validators on the Aether network.
+ * Fully wired to @jellylegsai/aether-sdk for real blockchain RPC calls.
+ *
+ * Usage:
+ *   aether validators list [--tier full|lite|observer] [--json]
+ *   aether validators info <address> [--json]
+ *   aether validators top [--limit 10] [--json]
+ */
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const readline = require('readline');
+
+// Import SDK for real blockchain RPC calls
+const sdkPath = path.join(__dirname, '..', 'sdk', 'index.js');
+const aether = require(sdkPath);
+
+// Import UI framework for consistent branding
+const { BRANDING, C, indicators, drawBox, drawTable,
+        success, error, warning, info, code, highlight, value,
+        startSpinner, stopSpinner, progressBar, progressBarColored,
+        formatHelp } = require('../lib/ui');
+
+const CLI_VERSION = '2.0.0';
+
+// ============================================================================
+// SDK Setup
+// ============================================================================
+
+function getDefaultRpc() {
+  return process.env.AETHER_RPC || aether.DEFAULT_RPC_URL || 'http://127.0.0.1:8899';
+}
+
+function createClient(rpcUrl) {
+  return new aether.AetherClient({ rpcUrl });
+}
+
+// ============================================================================
+// Config Helpers
+// ============================================================================
+
+function getAetherDir() {
+  return path.join(os.homedir(), '.aether');
+}
+
+function getConfigPath() {
+  return path.join(getAetherDir(), 'config.json');
+}
+
+function loadConfig() {
+  if (!fs.existsSync(getConfigPath())) {
+    return { defaultWallet: null };
+  }
+  try {
+    return JSON.parse(fs.readFileSync(getConfigPath(), 'utf8'));
+  } catch {
+    return { defaultWallet: null };
+  }
+}
+
+// ============================================================================
+// Format Helpers
+// ============================================================================
+
+function formatAether(lamports) {
+  if (!lamports || lamports === '0') return '0 AETH';
+  const aeth = Number(lamports) / 1e9;
+  if (aeth >= 1_000_000) {
+    return (aeth / 1_000_000).toFixed(2) + 'M AETH';
+  }
+  if (aeth >= 1_000) {
+    return (aeth / 1_000).toFixed(2) + 'K AETH';
+  }
+  return aeth.toFixed(4).replace(/\.?0+$/, '') + ' AETH';
+}
+
+function formatNumber(n) {
+  if (n === null || n === undefined) return 'N/A';
+  return n.toString().replace(/\B(?=(\d{3})+(?!\d))/g, ',');
+}
+
+function shortAddress(addr) {
+  if (!addr || addr.length < 16) return addr || 'unknown';
+  return addr.slice(0, 8) + '...' + addr.slice(-8);
+}
+
+function formatPercent(val) {
+  if (val === undefined || val === null) return 'N/A';
+  const pct = Number(val);
+  if (isNaN(pct)) return 'N/A';
+  return pct.toFixed(2) + '%';
+}
+
+function formatAPY(apy) {
+  if (!apy && apy !== 0) return `${C.dim}N/A${C.reset}`;
+  const val = Number(apy);
+  if (isNaN(val)) return `${C.dim}N/A${C.reset}`;
+  if (val >= 10) return `${C.green}${val.toFixed(2)}%${C.reset}`;
+  if (val >= 5) return `${C.yellow}${val.toFixed(2)}%${C.reset}`;
+  return `${C.cyan}${val.toFixed(2)}%${C.reset}`;
+}
+
+// ============================================================================
+// Fetch Validators via SDK
+// ============================================================================
+
+async function fetchValidators(rpcUrl) {
+  const client = createClient(rpcUrl);
+  
+  try {
+    const validators = await client.getValidators();
+    if (!Array.isArray(validators)) return [];
+    
+    return validators.map(v => ({
+      address: v.vote_account || v.pubkey || v.address || v.identity || 'unknown',
+      identity: v.identity || v.node_pubkey || v.address,
+      stake: v.stake_lamports || v.activated_stake || v.stake || 0,
+      commission: v.commission || v.commission_bps || 0,
+      apy: v.apy || v.return_rate || v.estimated_apy || 0,
+      name: v.name || v.moniker || v.identity_name || 'Unknown',
+      tier: v.tier || 'unknown',
+      active: v.active !== false && v.delinquent !== true,
+      delinquent: v.delinquent === true,
+      skipRate: v.skip_rate || 0,
+      uptime: v.uptime || 0,
+      lastVote: v.last_vote || v.last_vote_slot || 0,
+      version: v.version || 'unknown',
+      website: v.website || null,
+      details: v.details || null,
+    }));
+  } catch (err) {
+    return [];
+  }
+}
+
+async function fetchValidatorInfo(rpcUrl, address) {
+  const validators = await fetchValidators(rpcUrl);
+  const rawAddr = address.startsWith('ATH') ? address.slice(3) : address;
+  return validators.find(v => 
+    v.address === address || 
+    v.address === rawAddr ||
+    v.identity === address ||
+    v.identity === rawAddr
+  ) || null;
+}
+
+// ============================================================================
+// Validator Status Indicator
+// ============================================================================
+
+function getStatusIndicator(validator) {
+  if (validator.delinquent) {
+    return `${C.red}● DELINQUENT${C.reset}`;
+  }
+  if (validator.active) {
+    return `${C.green}● ACTIVE${C.reset}`;
+  }
+  return `${C.yellow}● INACTIVE${C.reset}`;
+}
+
+function getTierBadge(tier) {
+  const tiers = {
+    full: `${C.magenta}[FULL]${C.reset}`,
+    lite: `${C.cyan}[LITE]${C.reset}`,
+    observer: `${C.dim}[OBSERVER]${C.reset}`,
+  };
+  return tiers[tier?.toLowerCase()] || `${C.dim}[${tier?.toUpperCase() || 'UNKNOWN'}]${C.reset}`;
+}
+
+// ============================================================================
+// List Command
+// ============================================================================
+
+async function listCommand(opts) {
+  if (!opts.json) {
+    console.log(BRANDING.header(CLI_VERSION));
+    console.log();
+    console.log(drawBox(
+      `${C.bright}VALIDATORS${C.reset} — Active validators on the Aether network`,
+      { style: 'double', title: 'NETWORK', titleColor: C.cyan }
+    ));
+    console.log();
+    startSpinner('Fetching validators from ' + shortAddress(opts.rpc));
+  }
+
+  const validators = await fetchValidators(opts.rpc);
+
+  if (!opts.json) {
+    stopSpinner(true, `Found ${validators.length} validators`);
+  }
+
+  // Filter by tier if specified
+  let filtered = validators;
+  if (opts.tier && opts.tier !== 'all') {
+    filtered = validators.filter(v => v.tier?.toLowerCase() === opts.tier.toLowerCase());
+  }
+
+  // Sort by stake (descending)
+  filtered.sort((a, b) => b.stake - a.stake);
+
+  if (filtered.length === 0) {
+    if (opts.json) {
+      console.log(JSON.stringify({
+        success: false,
+        error: 'No validators found',
+        rpc: opts.rpc,
+        tier_filter: opts.tier,
+      }, null, 2));
+    } else {
+      console.log(`\n  ${warning('No validators found.')}`);
+      if (opts.tier) {
+        console.log(`  ${C.dim}Tier filter: ${opts.tier}${C.reset}`);
+      }
+      console.log(`  ${C.dim}Check your RPC endpoint: ${opts.rpc}${C.reset}\n`);
+    }
+    return;
+  }
+
+  // Calculate stats
+  const totalStake = filtered.reduce((sum, v) => sum + Number(v.stake), 0);
+  const activeCount = filtered.filter(v => v.active && !v.delinquent).length;
+  const delinquentCount = filtered.filter(v => v.delinquent).length;
+  const avgAPY = filtered.length > 0 
+    ? filtered.reduce((sum, v) => sum + Number(v.apy || 0), 0) / filtered.length 
+    : 0;
+
+  if (opts.json) {
+    console.log(JSON.stringify({
+      success: true,
+      count: filtered.length,
+      total_validators: validators.length,
+      tier_filter: opts.tier || 'all',
+      stats: {
+        total_stake_lamports: totalStake,
+        total_stake_aeth: totalStake / 1e9,
+        active_count: activeCount,
+        delinquent_count: delinquentCount,
+        average_apy: avgAPY,
+      },
+      validators: filtered.map((v, i) => ({
+        rank: i + 1,
+        address: v.address,
+        name: v.name,
+        tier: v.tier,
+        stake_lamports: v.stake,
+        stake_aeth: v.stake / 1e9,
+        commission: v.commission,
+        apy: v.apy,
+        active: v.active,
+        delinquent: v.delinquent,
+        skip_rate: v.skipRate,
+        uptime: v.uptime,
+      })),
+      rpc: opts.rpc,
+      timestamp: new Date().toISOString(),
+    }, null, 2));
+    return;
+  }
+
+  // Pretty output
+  console.log();
+  console.log(drawBox(
+    `${C.dim}Network Stats${C.reset}\n\n` +
+    `  ${C.cyan}Total Validators:${C.reset} ${C.bright}${formatNumber(filtered.length)}${C.reset}\n` +
+    `  ${C.green}Active:${C.reset} ${C.bright}${formatNumber(activeCount)}${C.reset}  ` +
+    `${C.red}Delinquent:${C.reset} ${C.bright}${formatNumber(delinquentCount)}${C.reset}\n` +
+    `  ${C.yellow}Total Stake:${C.reset} ${C.bright}${formatAether(totalStake)}${C.reset}\n` +
+    `  ${C.magenta}Avg APY:${C.reset} ${formatAPY(avgAPY)}`,
+    { style: 'single', borderColor: C.dim }
+  ));
+  console.log();
+
+  // Build table
+  const headers = ['#', 'Status', 'Name', 'Address', 'Tier', 'Stake', 'APY', 'Comm'];
+  const rows = filtered.slice(0, opts.limit).map((v, i) => {
+    const status = v.delinquent ? indicators.error : (v.active ? indicators.success : indicators.warning);
+    const name = (v.name || 'Unknown').slice(0, 16).padEnd(16);
+    const addr = shortAddress(v.address);
+    const tier = getTierBadge(v.tier);
+    const stake = formatAether(v.stake);
+    const apy = formatAPY(v.apy);
+    const comm = formatPercent(v.commission / 100); // Assuming basis points
+    return [`${i + 1}`, status, name, addr, tier, stake, apy, comm];
+  });
+
+  console.log(drawTable(headers, rows, {
+    borderStyle: 'single',
+    headerColor: C.cyan + C.bright,
+    borderColor: C.dim,
+  }));
+
+  if (filtered.length > opts.limit) {
+    console.log(`\n  ${C.dim}... and ${filtered.length - opts.limit} more validators${C.reset}`);
+  }
+
+  console.log(`\n  ${C.dim}To stake:${C.reset} ${code('aether stake --validator <address> --amount <aeth>')}`);
+  console.log(`  ${C.dim}For details:${C.reset} ${code('aether validators info <address>')}`);
+  console.log();
+}
+
+// ============================================================================
+// Info Command
+// ============================================================================
+
+async function infoCommand(opts) {
+  if (!opts.address) {
+    if (!opts.json) {
+      console.log(`\n  ${error('Validator address required.')}`);
+      console.log(`  ${C.dim}Usage: aether validators info <address>${C.reset}\n`);
+    } else {
+      console.log(JSON.stringify({ error: 'Validator address required' }, null, 2));
+    }
+    return;
+  }
+
+  if (!opts.json) {
+    console.log(BRANDING.header(CLI_VERSION));
+    console.log();
+    startSpinner('Fetching validator info');
+  }
+
+  const validator = await fetchValidatorInfo(opts.rpc, opts.address);
+
+  if (!opts.json) {
+    stopSpinner(!!validator, validator ? 'Validator found' : 'Validator not found');
+  }
+
+  if (!validator) {
+    if (opts.json) {
+      console.log(JSON.stringify({
+        success: false,
+        error: 'Validator not found',
+        address: opts.address,
+        rpc: opts.rpc,
+      }, null, 2));
+    } else {
+      console.log(`\n  ${error('Validator not found:')} ${opts.address}`);
+      console.log(`  ${C.dim}Check the address and try again.${C.reset}\n`);
+    }
+    return;
+  }
+
+  if (opts.json) {
+    console.log(JSON.stringify({
+      success: true,
+      validator: {
+        address: validator.address,
+        identity: validator.identity,
+        name: validator.name,
+        tier: validator.tier,
+        stake_lamports: validator.stake,
+        stake_aeth: validator.stake / 1e9,
+        commission: validator.commission,
+        apy: validator.apy,
+        active: validator.active,
+        delinquent: validator.delinquent,
+        skip_rate: validator.skipRate,
+        uptime: validator.uptime,
+        last_vote: validator.lastVote,
+        version: validator.version,
+        website: validator.website,
+        details: validator.details,
+      },
+      rpc: opts.rpc,
+      timestamp: new Date().toISOString(),
+    }, null, 2));
+    return;
+  }
+
+  // Pretty output
+  const statusLine = getStatusIndicator(validator);
+  const uptimeBar = validator.uptime 
+    ? progressBarColored(validator.uptime, 100, 30)
+    : `${C.dim}N/A${C.reset}`;
+
+  console.log();
+  console.log(drawBox(
+    `${C.bright}VALIDATOR DETAILS${C.reset}\n\n` +
+    `  ${C.cyan}Status:${C.reset}     ${statusLine}\n` +
+    `  ${C.cyan}Name:${C.reset}       ${C.bright}${validator.name || 'Unknown'}${C.reset}\n` +
+    `  ${C.cyan}Tier:${C.reset}       ${getTierBadge(validator.tier)}\n\n` +
+    `  ${C.cyan}Address:${C.reset}    ${C.bright}${validator.address}${C.reset}\n` +
+    `  ${C.cyan}Identity:${C.reset}   ${validator.identity || 'N/A'}\n\n` +
+    `  ${C.cyan}Stake:${C.reset}      ${C.bright}${formatAether(validator.stake)}${C.reset}\n` +
+    `  ${C.cyan}APY:${C.reset}        ${formatAPY(validator.apy)}\n` +
+    `  ${C.cyan}Commission:${C.reset} ${formatPercent(validator.commission / 100)}\n\n` +
+    `  ${C.cyan}Uptime:${C.reset}     ${uptimeBar}\n` +
+    `  ${C.cyan}Skip Rate:${C.reset}  ${formatPercent(validator.skipRate)}\n` +
+    `  ${C.cyan}Version:${C.reset}    ${validator.version || 'unknown'}`,
+    { style: 'double', title: validator.name?.toUpperCase() || 'VALIDATOR', titleColor: C.cyan }
+  ));
+
+  if (validator.website) {
+    console.log(`\n  ${C.dim}Website:${C.reset} ${C.blue}${validator.website}${C.reset}`);
+  }
+  if (validator.details) {
+    console.log(`\n  ${C.dim}Details:${C.reset} ${validator.details}`);
+  }
+
+  console.log(`\n  ${C.dim}To stake:${C.reset} ${code(`aether stake --validator ${validator.address} --amount <aeth>`)}`);
+  console.log();
+}
+
+// ============================================================================
+// Top Command
+// ============================================================================
+
+async function topCommand(opts) {
+  if (!opts.json) {
+    console.log(BRANDING.header(CLI_VERSION));
+    console.log();
+    console.log(drawBox(
+      `${C.bright}TOP VALIDATORS${C.reset} — Highest stake validators`,
+      { style: 'double', title: 'LEADERBOARD', titleColor: C.yellow }
+    ));
+    console.log();
+    startSpinner('Fetching top validators');
+  }
+
+  const validators = await fetchValidators(opts.rpc);
+
+  // Sort by stake and take top N
+  validators.sort((a, b) => b.stake - a.stake);
+  const topValidators = validators.slice(0, opts.limit);
+
+  if (!opts.json) {
+    stopSpinner(topValidators.length > 0, `Found ${topValidators.length} validators`);
+  }
+
+  if (topValidators.length === 0) {
+    if (opts.json) {
+      console.log(JSON.stringify({ error: 'No validators found' }, null, 2));
+    } else {
+      console.log(`\n  ${warning('No validators found.')}\n`);
+    }
+    return;
+  }
+
+  // Calculate total stake for percentages
+  const totalNetworkStake = validators.reduce((sum, v) => sum + Number(v.stake), 0);
+
+  if (opts.json) {
+    console.log(JSON.stringify({
+      success: true,
+      top_count: topValidators.length,
+      total_network_stake: totalNetworkStake,
+      validators: topValidators.map((v, i) => ({
+        rank: i + 1,
+        address: v.address,
+        name: v.name,
+        stake_lamports: v.stake,
+        stake_aeth: v.stake / 1e9,
+        stake_percentage: totalNetworkStake > 0 ? (v.stake / totalNetworkStake * 100).toFixed(2) : 0,
+        apy: v.apy,
+        commission: v.commission,
+        active: v.active,
+      })),
+      rpc: opts.rpc,
+      timestamp: new Date().toISOString(),
+    }, null, 2));
+    return;
+  }
+
+  console.log();
+  console.log(`  ${C.dim}Network:${C.reset} ${C.bright}${formatAether(totalNetworkStake)}${C.reset} total stake`);
+  console.log(`  ${C.dim}Showing top ${opts.limit} validators${C.reset}\n`);
+
+  // Build leaderboard table
+  const headers = ['Rank', 'Validator', 'Stake', '% Network', 'APY'];
+  const rows = topValidators.map((v, i) => {
+    const rank = i + 1;
+    const rankIcon = rank === 1 ? `${C.yellow}🥇${C.reset}` : 
+                     rank === 2 ? `${C.dim}🥈${C.reset}` : 
+                     rank === 3 ? `${C.brightYellow}🥉${C.reset}` : 
+                     `${C.dim}${rank}${C.reset}`;
+    const name = (v.name || shortAddress(v.address)).slice(0, 20);
+    const stake = formatAether(v.stake);
+    const pct = totalNetworkStake > 0 ? (v.stake / totalNetworkStake * 100).toFixed(2) + '%' : '0%';
+    const apy = formatAPY(v.apy);
+    return [rankIcon, name, stake, pct, apy];
+  });
+
+  console.log(drawTable(headers, rows, {
+    borderStyle: 'single',
+    headerColor: C.yellow + C.bright,
+    borderColor: C.dim,
+  }));
+
+  console.log();
+}
+
+// ============================================================================
+// Show Help
+// ============================================================================
+
+function showHelp() {
+  console.log(BRANDING.header(CLI_VERSION));
+  
+  console.log(`\n  ${C.bright}AETHER VALIDATORS${C.reset} — Network validator management\n`);
+  
+  console.log(`  ${C.cyan}◆ LIST${C.reset}     ${code('aether validators list [--tier <tier>] [--json]')}`);
+  console.log(`    ${C.dim}Show all validators, optionally filtered by tier${C.reset}`);
+  
+  console.log(`\n  ${C.cyan}◆ INFO${C.reset}     ${code('aether validators info <address> [--json]')}`);
+  console.log(`    ${C.dim}Detailed information about a specific validator${C.reset}`);
+  
+  console.log(`\n  ${C.cyan}◆ TOP${C.reset}      ${code('aether validators top [--limit 10] [--json]')}`);
+  console.log(`    ${C.dim}Show top validators by stake amount${C.reset}`);
+  
+  console.log(`\n  ${C.bright}OPTIONS${C.reset}`);
+  console.log(`    ${code('--tier <tier>')}    Filter by tier: full, lite, observer`);
+  console.log(`    ${code('--limit <n>')}      Show top N validators (default: 15)`);
+  console.log(`    ${code('--rpc <url>')}      Custom RPC endpoint`);
+  console.log(`    ${code('--json')}           Output JSON for scripting`);
+  console.log(`    ${code('--help')}           Show this help message`);
+  
+  console.log(`\n  ${C.bright}EXAMPLES${C.reset}`);
+  console.log(`    ${C.dim}$${C.reset} ${code('aether validators list')}`);
+  console.log(`    ${C.dim}$${C.reset} ${code('aether validators list --tier full --json')}`);
+  console.log(`    ${C.dim}$${C.reset} ${code('aether validators info ATHxxx...')}`);
+  console.log(`    ${C.dim}$${C.reset} ${code('aether validators top --limit 20')}`);
+  
+  console.log(`\n  ${C.bright}SDK METHODS${C.reset}`);
+  console.log(`    ${C.dim}client.getValidators()  → GET /v1/validators${C.reset}`);
+  console.log();
+}
+
+// ============================================================================
+// CLI Args Parser
+// ============================================================================
+
+function parseArgs() {
+  const rawArgs = process.argv.slice(3);
+  
+  // Determine subcommand - first arg if not a flag
+  let subcmd = 'list';
+  let allArgs = rawArgs;
+  
+  if (rawArgs.length > 0 && !rawArgs[0].startsWith('-')) {
+    subcmd = rawArgs[0];
+    allArgs = rawArgs.slice(1);
+  }
+  
+  const opts = {
+    subcmd,
+    rpc: getDefaultRpc(),
+    json: false,
+    tier: null,
+    limit: 15,
+    address: null,
+  };
+
+  // Parse flags
+  for (let i = 0; i < allArgs.length; i++) {
+    const arg = allArgs[i];
+    if (arg === '--rpc' || arg === '-r') {
+      opts.rpc = allArgs[++i];
+    } else if (arg === '--json' || arg === '-j') {
+      opts.json = true;
+    } else if (arg === '--tier' || arg === '-t') {
+      opts.tier = allArgs[++i];
+    } else if (arg === '--limit' || arg === '-l') {
+      const val = parseInt(allArgs[++i], 10);
+      if (!isNaN(val) && val > 0) opts.limit = val;
+    } else if (arg === '--help' || arg === '-h') {
+      opts.subcmd = 'help';
+    } else if (!arg.startsWith('-') && subcmd === 'info') {
+      // For info command, non-flag arg is the address
+      opts.address = arg;
+    }
+  }
+
+  // For info command, also check if address was passed directly
+  if (subcmd === 'info' && !opts.address) {
+    const firstArg = allArgs.find(a => !a.startsWith('-'));
+    if (firstArg) opts.address = firstArg;
+  }
+
+  return opts;
+}
+
+// ============================================================================
+// Main Entry Point
+// ============================================================================
+
+async function validatorsCommand() {
+  const opts = parseArgs();
+
+  switch (opts.subcmd) {
+    case 'list':
+      await listCommand(opts);
+      break;
+    case 'info':
+      await infoCommand(opts);
+      break;
+    case 'top':
+      await topCommand(opts);
+      break;
+    case 'help':
+    case '--help':
+    case '-h':
+      showHelp();
+      break;
+    default:
+      console.log(`\n  ${error('Unknown subcommand:')} ${opts.subcmd}`);
+      console.log(`  ${C.dim}Run 'aether validators --help' for usage.${C.reset}\n`);
+      process.exit(1);
+  }
+}
+
+module.exports = { validatorsCommand };
+
+if (require.main === module) {
+  validatorsCommand().catch(err => {
+    console.error(`\n${error('Validators command failed:')} ${err.message}\n`);
+    process.exit(1);
+  });
+}