byreal-test 1.3.7 → 2.0.0

package/cli.js

@@ -101,4 +101,19 @@ program
     process.exit(result.hasAlert ? 1 : 0);
   });
 
+program
+  .command('run_api')
+  .description('Call byreal-cli overview and verify key metrics (TVL / Fees)')
+  .option('--lark-webhook <url>', 'Lark bot webhook URL', 'https://open.larksuite.com/open-apis/bot/v2/hook/c465fa0d-c3c5-42b8-9018-39ae079c4f2a')
+  .option('--state-file <path>', 'Path to persist state between runs (default: ~/.byreal-test/api-state.json)')
+  .option('--no-lark', 'Disable Lark notification')
+  .action(async (opts) => {
+    const { runApi } = require('./src/api-runner');
+    const result = await runApi({
+      larkWebhook: opts.lark ? opts.larkWebhook : undefined,
+      stateFile:   opts.stateFile,
+    });
+    process.exit(result.hasAlert ? 1 : 0);
+  });
+
 program.parse(process.argv);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "byreal-test",
-  "version": "1.3.7",
+  "version": "2.0.0",
   "description": "Byreal CLI test suite - runs byreal-cli commands and generates test reports",
   "main": "cli.js",
   "bin": {

package/src/api-runner.js

@@ -0,0 +1,422 @@
+'use strict';
+
+const { execSync } = require('child_process');
+const { parseJsonOutput } = require('./runner');
+const chalk = require('chalk');
+const fs    = require('fs');
+const path  = require('path');
+const os    = require('os');
+
+const DEFAULT_STATE_FILE = path.join(os.homedir(), '.byreal-test', 'api-state.json');
+
+// ─── helpers ──────────────────────────────────────────────────────────────────
+
+function utc8Label() {
+  const now = new Date(Date.now() + 8 * 3600_000);
+  const mm  = String(now.getUTCMonth() + 1).padStart(2, '0');
+  const dd  = String(now.getUTCDate()).padStart(2, '0');
+  const hh  = String(now.getUTCHours()).padStart(2, '0');
+  const min = String(now.getUTCMinutes()).padStart(2, '0');
+  return `${mm}-${dd} ${hh}:${min}`;
+}
+
+function fmtUsd(val) {
+  if (val >= 1_000_000) return `$${(val / 1_000_000).toFixed(2)}M`;
+  if (val >= 1_000)     return `$${(val / 1_000).toFixed(2)}K`;
+  return `$${val.toFixed(2)}`;
+}
+
+function fmtPct(val) {
+  return `${val >= 0 ? '+' : ''}${val.toFixed(2)}%`;
+}
+
+function loadState(filePath) {
+  try {
+    if (fs.existsSync(filePath)) {
+      return JSON.parse(fs.readFileSync(filePath, 'utf8'));
+    }
+  } catch {}
+  return null;
+}
+
+function saveState(filePath, payload) {
+  try {
+    const dir = path.dirname(filePath);
+    if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
+    fs.writeFileSync(filePath, JSON.stringify(payload, null, 2));
+  } catch (err) {
+    console.warn(chalk.yellow(`  Warning: state save failed: ${err.message}`));
+  }
+}
+
+async function sendLark(webhookUrl, body) {
+  const res = await fetch(webhookUrl, {
+    method:  'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body:    JSON.stringify(body),
+  });
+  if (!res.ok) throw new Error(`HTTP ${res.status}`);
+}
+
+// ─── overview checks ──────────────────────────────────────────────────────────
+
+function checkOverview(data, prev) {
+  const checks = [];
+
+  // TVL 24h change within ±30%  (tvl_change_24h is already in %)
+  const tvlChg = data.tvl_change_24h;
+  const tvlOk  = Math.abs(tvlChg) <= 30;
+  checks.push({
+    name:   'TVL 24h',
+    value:  `${fmtUsd(data.tvl)}  (${fmtPct(tvlChg)})`,
+    ok:     tvlOk,
+    reason: tvlOk ? null : `24h 变动 ${fmtPct(tvlChg)} 超过 ±30% 阈值`,
+  });
+
+  // Fees (24h) > $1 000
+  const fee24hOk = data.fee_24h_usd >= 1_000;
+  checks.push({
+    name:   'Fees (24h)',
+    value:  fmtUsd(data.fee_24h_usd),
+    ok:     fee24hOk,
+    reason: fee24hOk ? null : `低于 $1K 最低阈值`,
+  });
+
+  // Fees (All Time): cumulative — flag if drops ≥ 20% vs last run
+  if (prev?.fee_all) {
+    const chgPct   = (data.fee_all - prev.fee_all) / prev.fee_all * 100;
+    const feeAllOk = chgPct >= -20;
+    checks.push({
+      name:   'Fees (All Time)',
+      value:  `${fmtUsd(data.fee_all)}  (vs prev ${fmtUsd(prev.fee_all)}: ${fmtPct(chgPct)})`,
+      ok:     feeAllOk,
+      reason: feeAllOk ? null : `相比上次下降 ${Math.abs(chgPct).toFixed(2)}%，超过 20% 警戒线`,
+    });
+  } else {
+    checks.push({
+      name:   'Fees (All Time)',
+      value:  `${fmtUsd(data.fee_all)}  (首次运行，记录基准)`,
+      ok:     true,
+      reason: null,
+    });
+  }
+
+  return checks;
+}
+
+// ─── pools checks ─────────────────────────────────────────────────────────────
+
+function checkPools(pools, prevPoolMap) {
+  const checks = [];
+
+  // APR: any pool ≥ 30 000% is suspicious
+  const highAprPools = pools.filter(p => p.apr >= 30_000);
+  const aprOk = highAprPools.length === 0;
+  checks.push({
+    name:   'APR 上限',
+    value:  aprOk
+      ? `最高 ${Math.max(...pools.map(p => p.apr)).toFixed(0)}%，共 ${pools.length} 个池`
+      : `${highAprPools.length} 个池 APR ≥ 30000%`,
+    ok:     aprOk,
+    reason: aprOk ? null :
+      highAprPools.slice(0, 5).map(p => `${p.pair} ${p.apr.toFixed(0)}%`).join(' | '),
+  });
+
+  // Low-APR pools: flag if ≥ 50% of all pools have apr < 1%
+  const lowAprCount    = pools.filter(p => p.apr < 1).length;
+  const lowAprThreshold = Math.floor(pools.length * 0.5);
+  const lowAprOk       = lowAprCount < lowAprThreshold;
+  checks.push({
+    name:   'APR < 1% 数量',
+    value:  `${lowAprCount} / ${pools.length} 个池`,
+    ok:     lowAprOk,
+    reason: lowAprOk ? null : `${lowAprCount} 个池 APR < 1%，超过总数 50%（${lowAprThreshold} 个）`,
+  });
+
+  // TVL / Volume non-negative
+  const negTvl = pools.filter(p => p.tvl_usd < 0);
+  const negVol = pools.filter(p => p.volume_24h_usd < 0);
+  const nonNegOk = negTvl.length === 0 && negVol.length === 0;
+  checks.push({
+    name:   'TVL/Volume ≥ 0',
+    value:  nonNegOk ? '全部正常' : `TVL<0: ${negTvl.length} | Vol<0: ${negVol.length}`,
+    ok:     nonNegOk,
+    reason: nonNegOk ? null :
+      [...negTvl.map(p => `${p.pair} TVL=${fmtUsd(p.tvl_usd)}`),
+       ...negVol.map(p => `${p.pair} Vol=${fmtUsd(p.volume_24h_usd)}`)].slice(0, 5).join(' | '),
+  });
+
+  // Per-pool TVL drop vs previous run: flag if ≥ 5 pools dropped > 30%
+  if (prevPoolMap && Object.keys(prevPoolMap).length > 0) {
+    const droppedPools = pools.filter(p => {
+      const prevTvl = prevPoolMap[p.id];
+      if (prevTvl == null || prevTvl === 0) return false;
+      return (p.tvl_usd - prevTvl) / prevTvl < -0.30;
+    });
+    const poolTvlOk = droppedPools.length < 5;
+    checks.push({
+      name:   'Pool TVL 跌幅',
+      value:  poolTvlOk
+        ? `${droppedPools.length} 个池跌幅 > 30%`
+        : `${droppedPools.length} 个池跌幅 > 30%`,
+      ok:     poolTvlOk,
+      reason: poolTvlOk ? null :
+        `${droppedPools.length} 个池 TVL 相比上次下降 > 30%，超过 5 个警戒线\n         ` +
+        droppedPools.slice(0, 5).map(p => {
+          const chg = ((p.tvl_usd - prevPoolMap[p.id]) / prevPoolMap[p.id] * 100).toFixed(1);
+          return `${p.pair} ${chg}%`;
+        }).join(' | '),
+    });
+  } else {
+    checks.push({
+      name:   'Pool TVL 跌幅',
+      value:  '首次运行，记录基准',
+      ok:     true,
+      reason: null,
+    });
+  }
+
+  return checks;
+}
+
+// ─── tokens checks ────────────────────────────────────────────────────────────
+
+const STABLE_SYMBOLS = new Set(['USDC', 'USDT', 'USD1', 'USDS', 'DAI', 'FDUSD']);
+
+function checkTokens(tokens, prevTokenMap) {
+  const checks = [];
+
+  // Stablecoins: price_usd within ±5% of 1.0
+  const stables    = tokens.filter(t => STABLE_SYMBOLS.has(t.symbol));
+  const badStables = stables.filter(t => Math.abs(t.price_usd - 1) > 0.05);
+  const stableOk   = badStables.length === 0;
+  checks.push({
+    name:   'Stablecoin peg',
+    value:  stableOk
+      ? stables.map(t => `${t.symbol} $${t.price_usd.toFixed(4)}`).join(' | ')
+      : badStables.map(t => `${t.symbol} $${t.price_usd.toFixed(4)}`).join(' | '),
+    ok:     stableOk,
+    reason: stableOk ? null :
+      badStables.map(t => `${t.symbol} 偏离 1.0 超过 5%`).join(', '),
+  });
+
+  // Non-stable: compare price / change_24h / volume_24h vs previous run.
+  // Key by mint (unique) to avoid false positives from duplicate symbols.
+  if (prevTokenMap && Object.keys(prevTokenMap).length > 0) {
+    const anomalies = [];
+
+    for (const t of tokens) {
+      if (STABLE_SYMBOLS.has(t.symbol)) continue;
+      const prev = prevTokenMap[t.mint];
+      if (!prev) continue;
+
+      const issues = [];
+
+      // price: relative change > 50%
+      if (prev.price_usd > 0) {
+        const chg = Math.abs(t.price_usd - prev.price_usd) / prev.price_usd;
+        if (chg > 0.50) issues.push(`price ${(chg * 100).toFixed(0)}%↑↓`);
+      }
+
+      // price_change_24h (decimal, e.g. 0.06 = 6%):
+      // flag only when BOTH conditions met:
+      //   1. relative shift > 50%  (or absolute shift > 0.50 when baseline is tiny)
+      //   2. absolute diff > 0.30  (i.e. 30 percentage-points) — filters noise
+      const prevChg  = prev.price_change_24h;
+      const curChg   = t.price_change_24h;
+      const absDiff  = Math.abs(curChg - prevChg);
+      if (absDiff > 0.30) {
+        if (Math.abs(prevChg) >= 0.02) {
+          const relChg = absDiff / Math.abs(prevChg);
+          if (relChg > 0.50) issues.push(`chg24h rel ${(relChg * 100).toFixed(0)}% abs ${(absDiff * 100).toFixed(0)}pp`);
+        } else {
+          if (absDiff > 0.50) {
+            issues.push(`chg24h shift ${(absDiff * 100).toFixed(0)}pp`);
+          }
+        }
+      }
+
+      // volume_24h: relative change > 50%, only when absolute value > $10 000
+      if (prev.volume_24h_usd > 0 && t.volume_24h_usd > 10_000) {
+        const chg = Math.abs(t.volume_24h_usd - prev.volume_24h_usd) / prev.volume_24h_usd;
+        if (chg > 0.50) issues.push(`vol24h ${(chg * 100).toFixed(0)}%↑↓`);
+      }
+
+      if (issues.length > 0) {
+        anomalies.push(`${t.symbol}(${issues.join(', ')})`);
+      }
+    }
+
+    const tokenDriftOk = anomalies.length === 0;
+    checks.push({
+      name:   'Token 数据波动',
+      value:  tokenDriftOk
+        ? `${tokens.filter(t => !STABLE_SYMBOLS.has(t.symbol)).length} 个代币均正常`
+        : `${anomalies.length} 个代币异常`,
+      ok:     tokenDriftOk,
+      reason: tokenDriftOk ? null :
+        `相比上次变化 > 50%：${anomalies.slice(0, 8).join(' | ')}`,
+    });
+  } else {
+    checks.push({
+      name:   'Token 数据波动',
+      value:  `首次运行，记录基准（${tokens.length} 个代币）`,
+      ok:     true,
+      reason: null,
+    });
+  }
+
+  return checks;
+}
+
+// ─── main ─────────────────────────────────────────────────────────────────────
+
+async function runApi({ larkWebhook, stateFile } = {}) {
+  const statePath = stateFile || DEFAULT_STATE_FILE;
+  const prev      = loadState(statePath);
+
+  // 1. fetch overview
+  let overviewData;
+  try {
+    const stdout = execSync('byreal-cli overview -o json', {
+      timeout:   30_000,
+      encoding:  'utf8',
+      maxBuffer: 2 * 1024 * 1024,
+    });
+    const parsed = parseJsonOutput(stdout);
+    if (!parsed?.success || !parsed?.data) throw new Error('invalid overview response');
+    overviewData = parsed.data;
+  } catch (err) {
+    console.error(chalk.red(`\n  ✗ byreal-cli overview failed: ${err.message}\n`));
+    return { success: false, error: err.message, hasAlert: true };
+  }
+
+  // 2. fetch pools
+  let pools = [];
+  try {
+    const stdout = execSync('byreal-cli pools list --page-size 100 -o json', {
+      timeout:   40_000,
+      encoding:  'utf8',
+      maxBuffer: 4 * 1024 * 1024,
+    });
+    const parsed = parseJsonOutput(stdout);
+    if (!Array.isArray(parsed?.data?.pools)) throw new Error('invalid pools response');
+    pools = parsed.data.pools;
+  } catch (err) {
+    console.error(chalk.red(`\n  ✗ byreal-cli pools failed: ${err.message}\n`));
+    return { success: false, error: err.message, hasAlert: true };
+  }
+
+  // 3. fetch tokens
+  let tokens = [];
+  try {
+    const stdout = execSync('byreal-cli tokens list --page-size 100 -o json', {
+      timeout:   30_000,
+      encoding:  'utf8',
+      maxBuffer: 4 * 1024 * 1024,
+    });
+    const parsed = parseJsonOutput(stdout);
+    if (!Array.isArray(parsed?.data?.tokens)) throw new Error('invalid tokens response');
+    tokens = parsed.data.tokens;
+  } catch (err) {
+    console.error(chalk.red(`\n  ✗ byreal-cli tokens failed: ${err.message}\n`));
+    return { success: false, error: err.message, hasAlert: true };
+  }
+
+  // 4. run checks
+  const overviewChecks = checkOverview(overviewData, prev);
+  const poolChecks     = checkPools(pools, prev?.poolTvlMap);
+  const tokenChecks    = checkTokens(tokens, prev?.tokenMap);
+  const allChecks      = [...overviewChecks, ...poolChecks, ...tokenChecks];
+  const hasAlert       = allChecks.some(c => !c.ok);
+
+  // 5. print
+  const time = utc8Label();
+  console.log('\n  ' + chalk.bold('Byreal API Sanity Check') + `  ${chalk.dim(time)}\n`);
+
+  const sections = [
+    { label: '── Overview ──', checks: overviewChecks },
+    { label: '── Pools ──',    checks: poolChecks     },
+    { label: '── Tokens ──',   checks: tokenChecks    },
+  ];
+  for (const sec of sections) {
+    console.log('  ' + chalk.cyan(sec.label));
+    for (const c of sec.checks) {
+      const icon = c.ok ? chalk.green('✓') : chalk.red('✗');
+      console.log(`    ${icon}  ${c.name.padEnd(22)} ${c.value}`);
+      if (!c.ok) console.log(`         ${chalk.red('→ ' + c.reason)}`);
+    }
+    console.log('');
+  }
+
+  if (hasAlert) {
+    console.log(chalk.red('  ⚠️  检测到异常，请关注\n'));
+  } else {
+    console.log(chalk.green('  ✅  所有指标正常\n'));
+  }
+
+  // 6. persist state
+  const poolTvlMap = {};
+  for (const p of pools) poolTvlMap[p.id] = p.tvl_usd;
+
+  // keyed by mint (unique) to handle duplicate symbols (e.g. counterfeit tokens)
+  const tokenMap = {};
+  for (const t of tokens) {
+    tokenMap[t.mint] = {
+      symbol:           t.symbol,
+      price_usd:        t.price_usd,
+      price_change_24h: t.price_change_24h,
+      volume_24h_usd:   t.volume_24h_usd,
+    };
+  }
+
+  saveState(statePath, {
+    timestamp:      new Date().toISOString(),
+    tvl:            overviewData.tvl,
+    tvl_change_24h: overviewData.tvl_change_24h,
+    fee_24h_usd:    overviewData.fee_24h_usd,
+    fee_all:        overviewData.fee_all,
+    pools_count:    overviewData.pools_count,
+    poolTvlMap,
+    tokenMap,
+  });
+
+  // 7. lark — only notify when there is an alert
+  if (larkWebhook && hasAlert) {
+    const title = `🚨 Byreal API Monitor · ${time}`;
+
+    const rows = [];
+
+    const sectionDefs = [
+      { label: '📊 Overview', checks: overviewChecks },
+      { label: '🏊 Pools',    checks: poolChecks     },
+      { label: '🪙 Tokens',   checks: tokenChecks    },
+    ];
+
+    for (const sec of sectionDefs) {
+      const hasIssue = sec.checks.some(c => !c.ok);
+      rows.push([{ tag: 'text', text: `${hasIssue ? '⚠️' : '✅'}  ${sec.label}` }]);
+      for (const c of sec.checks) {
+        rows.push([{ tag: 'text', text: `   ${c.ok ? '✅' : '❌'}  ${c.name}: ${c.value}` }]);
+        if (!c.ok) {
+          rows.push([{ tag: 'text', text: `         → ${c.reason}` }]);
+        }
+      }
+      rows.push([{ tag: 'text', text: ' ' }]);
+    }
+
+    try {
+      await sendLark(larkWebhook, {
+        msg_type: 'post',
+        content: { post: { zh_cn: { title, content: rows } } },
+      });
+      console.log(chalk.dim('  Lark alert sent.\n'));
+    } catch (err) {
+      console.warn(chalk.yellow(`  Warning: Lark send failed: ${err.message}\n`));
+    }
+  }
+
+  return { success: true, hasAlert, checks: allChecks, overviewData, pools, tokens };
+}
+
+module.exports = { runApi };