@vike-io/cli 0.5.0

package/src/commands/perp.js

@@ -0,0 +1,59 @@
+import { callTool } from '../mcp-client.js';
+import { emit, emitError } from '../format.js';
+import { parseInt10 } from '../util.js';
+
+export function registerPerp(program) {
+  const cmd = program
+    .command('perp')
+    .description('Perpetual-futures funding, spreads, and Hyperliquid trader leaderboard');
+
+  cmd
+    .command('funding')
+    .description('Funding rates per venue, or cross-venue funding-arb opportunities')
+    .option('--symbol <s>', 'Specific symbol (e.g. BTC). Omit for top arb opportunities.')
+    .option('--json', 'Emit JSON')
+    .action(async (opts) => {
+      try {
+        const r = await callTool('perp_funding', { symbol: opts.symbol });
+        emit(r, opts);
+      } catch (err) { emitError(err, opts); }
+    });
+
+  cmd
+    .command('spreads')
+    .description('Cross-venue spot-perp spread arbitrage opportunities')
+    .option('--symbol <s>', 'Specific symbol. Omit for full matrix.')
+    .option('--json', 'Emit JSON')
+    .action(async (opts) => {
+      try {
+        const r = await callTool('perp_spreads', { symbol: opts.symbol });
+        emit(r, opts);
+      } catch (err) { emitError(err, opts); }
+    });
+
+  cmd
+    .command('top-traders')
+    .description('Top Hyperliquid perp wallets by PnL / ROI / win rate / volume')
+    .option('--window <w>', '1d | 7d | 30d | all', '30d')
+    .option('--sort <s>', 'pnl | roi | win_rate | volume | trade_count | drawdown', 'pnl')
+    .option('--order <o>', 'asc | desc', 'desc')
+    .option('--min-trades <n>', 'Minimum trade count', '3')
+    .option('--min-win-rate <p>', 'Minimum win rate percent (0-100)', '0')
+    .option('--min-volume <usd>', 'Minimum volume USD', '0')
+    .option('--size <n>', 'Page size (max 20)', '10')
+    .option('--json', 'Emit JSON')
+    .action(async (opts) => {
+      try {
+        const r = await callTool('hl_perp_top_traders', {
+          window: opts.window,
+          sort: opts.sort,
+          order: opts.order,
+          min_trades: parseInt10(opts.minTrades, 3),
+          min_win_rate: opts.minWinRate,
+          min_volume: opts.minVolume,
+          size: parseInt10(opts.size, 10),
+        });
+        emit(r, opts);
+      } catch (err) { emitError(err, opts); }
+    });
+}

package/src/commands/polymarket.js

@@ -0,0 +1,74 @@
+import { callTool } from '../mcp-client.js';
+import { emit, emitError } from '../format.js';
+import { parseInt10 } from '../util.js';
+
+export function registerPolymarket(program) {
+  const cmd = program
+    .command('polymarket')
+    .alias('pm')
+    .description('Polymarket prediction-market analytics (markets, traders, smart money)');
+
+  cmd
+    .command('markets')
+    .description('Trending Polymarket markets ranked by 24h volume')
+    .option('--category <c>', 'Crypto | Sports | Politics | Pop-Culture | Tech | all', 'all')
+    .option('--limit <n>', 'Max markets (max 30)', '10')
+    .option('--json', 'Emit JSON')
+    .action(async (opts) => {
+      try {
+        const r = await callTool('polymarket_markets', {
+          category: opts.category,
+          limit: parseInt10(opts.limit, 10),
+        });
+        emit(r, opts);
+      } catch (err) { emitError(err, opts); }
+    });
+
+  cmd
+    .command('market <condition_id>')
+    .description('Deep-dive on one Polymarket market by condition_id')
+    .option('--json', 'Emit JSON')
+    .action(async (conditionId, opts) => {
+      try {
+        const r = await callTool('polymarket_market_detail', {
+          condition_id: conditionId,
+        });
+        emit(r, opts);
+      } catch (err) { emitError(err, opts); }
+    });
+
+  cmd
+    .command('wallet <address>')
+    .description('Profile a Polymarket trader (PnL / hit-rate / categories)')
+    .option('--window <w>', '24h | 7d | 30d | all', 'all')
+    .option('--json', 'Emit JSON')
+    .action(async (address, opts) => {
+      try {
+        const r = await callTool('polymarket_wallet', {
+          address,
+          window: opts.window,
+        });
+        emit(r, opts);
+      } catch (err) { emitError(err, opts); }
+    });
+
+  cmd
+    .command('smart-money')
+    .description('Smart-money flows or mispricings on Polymarket')
+    .option('--mode <m>', 'flows | mispricings', 'flows')
+    .option('--hours <n>', 'Lookback hours', '24')
+    .option('--category <c>', 'Crypto | Sports | Politics | Pop-Culture | Tech | all', 'all')
+    .option('--limit <n>', 'Max rows (max 20)', '10')
+    .option('--json', 'Emit JSON')
+    .action(async (opts) => {
+      try {
+        const r = await callTool('polymarket_smart_money', {
+          mode: opts.mode,
+          hours: parseInt10(opts.hours, 24),
+          category: opts.category,
+          limit: parseInt10(opts.limit, 10),
+        });
+        emit(r, opts);
+      } catch (err) { emitError(err, opts); }
+    });
+}

package/src/commands/schema.js

@@ -0,0 +1,31 @@
+import { listTools } from '../mcp-client.js';
+import { emit, emitError } from '../format.js';
+
+export function registerSchema(program) {
+  program
+    .command('schema')
+    .description('Print the full MCP tool schema (names, descriptions, input schemas)')
+    .option('--pretty', 'Human-friendly summary instead of raw JSON')
+    .option('--json', 'Emit JSON (default)')
+    .action(async (opts) => {
+      try {
+        const tools = await listTools();
+        if (opts.pretty) {
+          for (const t of tools) {
+            console.log(`\n  ${t.name}`);
+            console.log(`    ${(t.description || '').split('\n')[0]}`);
+            const props = t.inputSchema?.properties ?? {};
+            const required = new Set(t.inputSchema?.required ?? []);
+            for (const [k, v] of Object.entries(props)) {
+              const tag = required.has(k) ? '(required)' : '';
+              const enumStr = Array.isArray(v.enum) ? ` [${v.enum.join('|')}]` : '';
+              console.log(`      --${k}${enumStr} ${tag}`);
+            }
+          }
+          console.log(`\n${tools.length} tools.`);
+        } else {
+          emit({ tools }, { json: true });
+        }
+      } catch (err) { emitError(err, opts); }
+    });
+}

package/src/commands/token.js

@@ -0,0 +1,77 @@
+import { callTool } from '../mcp-client.js';
+import { emit, emitError } from '../format.js';
+import { parseInt10 } from '../util.js';
+
+export function registerToken(program) {
+  const cmd = program
+    .command('token')
+    .description('Token search, transfers, and price charts');
+
+  cmd
+    .command('search <query>')
+    .description('Search tokens by symbol or name')
+    .option('--chain <chain>', 'ethereum | bsc | base', 'ethereum')
+    .option('--limit <n>', 'Max results', '10')
+    .option('--json', 'Emit JSON')
+    .action(async (query, opts) => {
+      try {
+        const r = await callTool('token_search', {
+          query,
+          chain: opts.chain,
+          limit: parseInt10(opts.limit, 10),
+        });
+        emit(r, opts);
+      } catch (err) { emitError(err, opts); }
+    });
+
+  cmd
+    .command('transfers <token_address>')
+    .description('Top buyers/sellers for a token in a window')
+    .option('--period <p>', '1h | 24h | 7d | 30d', '24h')
+    .option('--tab <t>', 'bought | sold', 'sold')
+    .option('--chain <chain>', 'ethereum | bsc | base | all', 'ethereum')
+    .option('--json', 'Emit JSON')
+    .action(async (tokenAddress, opts) => {
+      try {
+        const r = await callTool('token_transfers', {
+          token_address: tokenAddress,
+          period: opts.period,
+          tab: opts.tab,
+          chain: opts.chain,
+        });
+        emit(r, opts);
+      } catch (err) { emitError(err, opts); }
+    });
+
+  cmd
+    .command('chart <token_address>')
+    .description('OHLCV candle data for a token')
+    .option('--interval <m>', '5 | 30 | 120 minutes', '30')
+    .option('--json', 'Emit JSON')
+    .action(async (tokenAddress, opts) => {
+      try {
+        const r = await callTool('token_chart', {
+          token_address: tokenAddress,
+          interval: opts.interval,
+        });
+        emit(r, opts);
+      } catch (err) { emitError(err, opts); }
+    });
+
+  cmd
+    .command('holders <token_address>')
+    .description('Top holders of a token by cumulative net inflow USD')
+    .option('--chain <chain>', 'ethereum | bsc | base', 'ethereum')
+    .option('--limit <n>', 'Max holders (max 50)', '10')
+    .option('--json', 'Emit JSON')
+    .action(async (tokenAddress, opts) => {
+      try {
+        const r = await callTool('token_holders', {
+          token_address: tokenAddress,
+          chain: opts.chain,
+          limit: parseInt10(opts.limit, 10),
+        });
+        emit(r, opts);
+      } catch (err) { emitError(err, opts); }
+    });
+}

package/src/commands/wallet.js

@@ -0,0 +1,106 @@
+import { callTool } from '../mcp-client.js';
+import { emit, emitError } from '../format.js';
+import { parseInt10 } from '../util.js';
+
+export function registerWallet(program) {
+  const cmd = program
+    .command('wallet')
+    .description('Wallet metrics, discovery, and ranking');
+
+  cmd
+    .command('summary <address>')
+    .description('Aggregate metrics: volume / inflow / outflow / pnl across windows')
+    .option('--json', 'Emit JSON')
+    .action(async (address, opts) => {
+      try {
+        const r = await callTool('wallet_summary', { address });
+        emit(r, opts);
+      } catch (err) { emitError(err, opts); }
+    });
+
+  cmd
+    .command('counterparties <address>')
+    .description('Top trading partners of a wallet by combined transfer volume')
+    .option('--chain <c>', 'ethereum | bsc | base', 'ethereum')
+    .option('--window <w>', '24h | 7d | 30d | 90d | 180d | all', '30d')
+    .option('--limit <n>', 'Max counterparties (max 50)', '10')
+    .option('--json', 'Emit JSON')
+    .action(async (address, opts) => {
+      try {
+        const r = await callTool('wallet_counterparties', {
+          address,
+          chain: opts.chain,
+          window: opts.window,
+          limit: parseInt10(opts.limit, 10),
+        });
+        emit(r, opts);
+      } catch (err) { emitError(err, opts); }
+    });
+
+  cmd
+    .command('pnl-history <address>')
+    .description('Daily net-flow series (proxy for daily PnL)')
+    .option('--chain <c>', 'ethereum | bsc | base', 'ethereum')
+    .option('--days <n>', 'Days back (max 365)', '30')
+    .option('--json', 'Emit JSON')
+    .action(async (address, opts) => {
+      try {
+        const r = await callTool('wallet_pnl_history', {
+          address,
+          chain: opts.chain,
+          days: parseInt10(opts.days, 30),
+        });
+        emit(r, opts);
+      } catch (err) { emitError(err, opts); }
+    });
+
+  cmd
+    .command('balances <address>')
+    .description('Current ERC-20 holdings across major EVM chains')
+    .option('--chains <list>', 'Comma-separated chains (eth,bsc,base,arbitrum,polygon,optimism)')
+    .option('--min-usd <n>', 'Filter dust below this USD value', '1')
+    .option('--json', 'Emit JSON')
+    .action(async (address, opts) => {
+      try {
+        const payload = { address, min_usd: opts.minUsd };
+        if (opts.chains) {
+          payload.chains = opts.chains.split(',').map((c) => c.trim()).filter(Boolean);
+        }
+        const r = await callTool('wallet_token_balances', payload);
+        emit(r, opts);
+      } catch (err) { emitError(err, opts); }
+    });
+
+  cmd
+    .command('ens <address>')
+    .description('Reverse ENS lookup: address → vitalik.eth style name')
+    .option('--json', 'Emit JSON')
+    .action(async (address, opts) => {
+      try {
+        const r = await callTool('wallet_ens', { address });
+        emit(r, opts);
+      } catch (err) { emitError(err, opts); }
+    });
+
+  cmd
+    .command('discover')
+    .description('Top wallets ranked by volume / inflow / outflow / pnl / net_flow / tx_count')
+    .option('--window <w>', '24h | 7d | 30d | 90d | all', '30d')
+    .option('--sort <s>', 'volume | inflow | outflow | net_flow | tx_count | pnl', 'volume')
+    .option('--order <o>', 'asc | desc', 'desc')
+    .option('--chain <c>', 'ethereum | bsc', 'ethereum')
+    .option('--size <n>', 'Page size (max 20)', '10')
+    .option('--json', 'Emit JSON')
+    .action(async (opts) => {
+      try {
+        const r = await callTool('wallet_discover', {
+          window: opts.window,
+          sort: opts.sort,
+          order: opts.order,
+          chain: opts.chain,
+          size: parseInt10(opts.size, 10),
+        });
+        emit(r, opts);
+      } catch (err) { emitError(err, opts); }
+    });
+}

package/src/commands/web.js

@@ -0,0 +1,41 @@
+import { callTool } from '../mcp-client.js';
+import { emit, emitError } from '../format.js';
+import { parseInt10 } from '../util.js';
+
+export function registerWeb(program) {
+  const cmd = program
+    .command('web')
+    .description('Web search + fetch (Tavily / Serper / Cerebras)');
+
+  cmd
+    .command('search <query...>')
+    .description('Web search (Tavily primary, Serper Google fallback)')
+    .option('--max <n>', 'Max results (default 5, max 10)', '5')
+    .option('--depth <d>', 'Tavily depth: basic | advanced', 'basic')
+    .option('--json', 'Emit JSON')
+    .action(async (queryParts, opts) => {
+      try {
+        const r = await callTool('web_search', {
+          query: queryParts.join(' '),
+          max_results: parseInt10(opts.max, 5),
+          search_depth: opts.depth,
+        });
+        emit(r, opts);
+      } catch (err) { emitError(err, opts); }
+    });
+
+  cmd
+    .command('fetch <url>')
+    .description('Fetch URL and optionally answer a question about it')
+    .option('--ask <question>', 'Question to answer from the content (uses Cerebras)')
+    .option('--json', 'Emit JSON')
+    .action(async (url, opts) => {
+      try {
+        const r = await callTool('web_fetch', {
+          url,
+          question: opts.ask,
+        });
+        emit(r, opts);
+      } catch (err) { emitError(err, opts); }
+    });
+}

package/src/format.js

@@ -0,0 +1,83 @@
+// Output formatting — pretty-print for humans, JSON for pipes.
+
+export function isJsonMode(opts) {
+  return Boolean(opts?.json) || !process.stdout.isTTY;
+}
+
+export function emit(data, opts = {}) {
+  if (isJsonMode(opts)) {
+    process.stdout.write(JSON.stringify(data, null, 2) + '\n');
+    return;
+  }
+  // Human mode: light formatting for arrays of objects (most MCP responses).
+  if (Array.isArray(data)) {
+    if (data.length === 0) {
+      console.log('(no results)');
+      return;
+    }
+    printTable(data);
+    return;
+  }
+  if (data && typeof data === 'object') {
+    if (data.error) {
+      console.error(`error: ${data.error}`);
+      process.exitCode = 1;
+      return;
+    }
+    // If it has a single array prop, print that as table.
+    const arrayKey = Object.keys(data).find((k) => Array.isArray(data[k]));
+    if (arrayKey && Object.keys(data).length <= 3) {
+      printTable(data[arrayKey]);
+      return;
+    }
+    console.log(JSON.stringify(data, null, 2));
+    return;
+  }
+  console.log(String(data));
+}
+
+function printTable(rows) {
+  if (!rows.length) {
+    console.log('(empty)');
+    return;
+  }
+  // Collect a stable column order from the first row, then keep any
+  // new keys at the end. Truncate values >80 chars.
+  const cols = [];
+  const seen = new Set();
+  for (const row of rows) {
+    for (const k of Object.keys(row || {})) {
+      if (!seen.has(k)) { seen.add(k); cols.push(k); }
+    }
+  }
+  const widths = cols.map((c) => Math.min(40, Math.max(c.length, ...rows.map((r) => fmt(r?.[c]).length))));
+  const sep = '  ';
+  console.log(cols.map((c, i) => c.padEnd(widths[i])).join(sep));
+  console.log(widths.map((w) => '-'.repeat(w)).join(sep));
+  for (const row of rows) {
+    console.log(cols.map((c, i) => fmt(row?.[c]).padEnd(widths[i])).join(sep));
+  }
+}
+
+function fmt(v) {
+  if (v === null || v === undefined) return '';
+  if (typeof v === 'number') {
+    if (Math.abs(v) >= 1e9) return (v / 1e9).toFixed(2) + 'B';
+    if (Math.abs(v) >= 1e6) return (v / 1e6).toFixed(2) + 'M';
+    if (Math.abs(v) >= 1e3) return (v / 1e3).toFixed(2) + 'K';
+    return String(v);
+  }
+  if (typeof v === 'object') return JSON.stringify(v);
+  const s = String(v);
+  return s.length > 80 ? s.slice(0, 77) + '...' : s;
+}
+
+export function emitError(err, opts = {}) {
+  const msg = err?.message ?? String(err);
+  if (isJsonMode(opts)) {
+    process.stdout.write(JSON.stringify({ error: msg }) + '\n');
+  } else {
+    console.error(`vike: ${msg}`);
+  }
+  process.exitCode = 1;
+}

package/src/index.js

@@ -0,0 +1,44 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { registerToken } from './commands/token.js';
+import { registerWallet } from './commands/wallet.js';
+import { registerPerp } from './commands/perp.js';
+import { registerOptions } from './commands/options.js';
+import { registerAlerts } from './commands/alerts.js';
+import { registerPolymarket } from './commands/polymarket.js';
+import { registerLabels } from './commands/labels.js';
+import { registerWeb } from './commands/web.js';
+// Note: registerLabels also registers `vike funds` and `vike defi` top-level
+// commands. New wallet subcommands (counterparties, pnl-history, balances,
+// ens) are added under registerWallet.
+import { registerInit } from './commands/init.js';
+import { registerDoctor } from './commands/doctor.js';
+import { registerSchema } from './commands/schema.js';
+import { registerLogin, registerLogout } from './commands/auth.js';
+import { readPackageVersion } from './util.js';
+
+const program = new Command();
+
+program
+  .name('vike')
+  .description('AI-agent CLI for vike.io on-chain analytics')
+  .version(readPackageVersion(), '-v, --version', 'Show CLI version');
+
+registerLogin(program);
+registerLogout(program);
+registerInit(program);
+registerDoctor(program);
+registerSchema(program);
+registerToken(program);
+registerWallet(program);
+registerPerp(program);
+registerOptions(program);
+registerAlerts(program);
+registerPolymarket(program);
+registerLabels(program);
+registerWeb(program);
+
+program.parseAsync(process.argv).catch((err) => {
+  console.error(`vike: ${err.message ?? err}`);
+  process.exitCode = 1;
+});

package/src/mcp-client.js

@@ -0,0 +1,94 @@
+import { requireApiKey, getEndpoint, getApiKey } from './auth.js';
+
+let _id = 0;
+function nextId() { return ++_id; }
+
+export async function callTool(toolName, args = {}, opts = {}) {
+  const apiKey = opts.apiKey ?? requireApiKey();
+  const endpoint = opts.endpoint ?? getEndpoint();
+  const timeoutMs = opts.timeoutMs ?? 60_000;
+
+  const body = {
+    jsonrpc: '2.0',
+    id: nextId(),
+    method: 'tools/call',
+    params: { name: toolName, arguments: args },
+  };
+
+  const ctrl = new AbortController();
+  const t = setTimeout(() => ctrl.abort(), timeoutMs);
+
+  let resp;
+  try {
+    resp = await fetch(endpoint, {
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+        'X-API-KEY': apiKey,
+        'User-Agent': `vike-cli/${process.env.npm_package_version ?? 'dev'}`,
+      },
+      body: JSON.stringify(body),
+      signal: ctrl.signal,
+    });
+  } catch (err) {
+    if (err.name === 'AbortError') {
+      throw new Error(`Request timed out after ${timeoutMs}ms`);
+    }
+    throw new Error(`Network error: ${err.message}`);
+  } finally {
+    clearTimeout(t);
+  }
+
+  const text = await resp.text();
+  let json;
+  try { json = JSON.parse(text); } catch {
+    throw new Error(`Bad response (HTTP ${resp.status}): ${text.slice(0, 200)}`);
+  }
+
+  if (json.error) {
+    const msg = json.error.message ?? 'Unknown MCP error';
+    throw new Error(`MCP error ${json.error.code}: ${msg}`);
+  }
+
+  // tools/call returns { content: [{type:'text', text: JSON}], isError }
+  const content = json.result?.content?.[0]?.text;
+  if (!content) return json.result;
+  try { return JSON.parse(content); } catch {
+    return content;
+  }
+}
+
+export async function listTools(opts = {}) {
+  const apiKey = opts.apiKey ?? requireApiKey();
+  const endpoint = opts.endpoint ?? getEndpoint();
+  const body = {
+    jsonrpc: '2.0',
+    id: nextId(),
+    method: 'tools/list',
+    params: {},
+  };
+  const resp = await fetch(endpoint, {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json', 'X-API-KEY': apiKey },
+    body: JSON.stringify(body),
+  });
+  const json = await resp.json();
+  if (json.error) throw new Error(json.error.message);
+  return json.result?.tools ?? [];
+}
+
+export async function ping(opts = {}) {
+  // initialize doesn't require auth — useful for `vike doctor`
+  const endpoint = opts.endpoint ?? getEndpoint();
+  const apiKey = opts.apiKey ?? getApiKey();
+  const headers = { 'Content-Type': 'application/json' };
+  if (apiKey) headers['X-API-KEY'] = apiKey;
+  const resp = await fetch(endpoint, {
+    method: 'POST',
+    headers,
+    body: JSON.stringify({
+      jsonrpc: '2.0', id: nextId(), method: 'initialize', params: {},
+    }),
+  });
+  return { status: resp.status, body: await resp.json() };
+}

package/src/util.js

@@ -0,0 +1,25 @@
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { dirname, join } from 'node:path';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+export function readPackageVersion() {
+  const pkgPath = join(__dirname, '..', 'package.json');
+  const pkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
+  return pkg.version;
+}
+
+export function parseBool(v, fallback = false) {
+  if (v === undefined || v === null || v === '') return fallback;
+  if (typeof v === 'boolean') return v;
+  const s = String(v).toLowerCase();
+  return s === 'true' || s === '1' || s === 'yes' || s === 'y';
+}
+
+export function parseInt10(v, fallback) {
+  if (v === undefined || v === null || v === '') return fallback;
+  const n = parseInt(v, 10);
+  return Number.isFinite(n) ? n : fallback;
+}