@clonegod/ttd-core 3.1.11 → 3.1.13

package/dist/alert/codes.d.ts

@@ -0,0 +1,5 @@
+import { AlertCodeDef, AlertSeverity } from './types';
+export declare const ALERT_CODES: Record<string, AlertCodeDef>;
+export declare function getDefaultSeverity(code: string): AlertSeverity;
+export declare function getCategory(code: string): string;
+export declare function isKnownCode(code: string): boolean;

package/dist/alert/codes.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ALERT_CODES = void 0;
+exports.getDefaultSeverity = getDefaultSeverity;
+exports.getCategory = getCategory;
+exports.isKnownCode = isKnownCode;
+const types_1 = require("./types");
+const S = types_1.AlertSeverity;
+exports.ALERT_CODES = {
+    QUOTE_RPC_TIMEOUT: { code: 'QUOTE_RPC_TIMEOUT', severity: S.WARN, category: 'quote', desc: '单次 RPC 请求超时', suggested_action: '框架自动重试' },
+    QUOTE_RPC_DISCONNECT: { code: 'QUOTE_RPC_DISCONNECT', severity: S.WARN, category: 'quote', desc: '单个 RPC ws 断开', suggested_action: '自动重连' },
+    QUOTE_RPC_DISCONNECT_ALL: { code: 'QUOTE_RPC_DISCONNECT_ALL', severity: S.CRITICAL, category: 'quote', desc: '所有 RPC 全断', suggested_action: '立即人工介入' },
+    QUOTE_BLOCK_LAG_HIGH: { code: 'QUOTE_BLOCK_LAG_HIGH', severity: S.WARN, category: 'quote', desc: 'block 接收延迟过高' },
+    QUOTE_BLOCK_LAG_PERSIST: { code: 'QUOTE_BLOCK_LAG_PERSIST', severity: S.ERROR, category: 'quote', desc: 'block 延迟持续 > 2 分钟', suggested_action: '考虑切 RPC' },
+    QUOTE_TICK_FETCH_FAIL: { code: 'QUOTE_TICK_FETCH_FAIL', severity: S.WARN, category: 'quote', desc: 'tick cache 刷新失败' },
+    QUOTE_TICK_STALE: { code: 'QUOTE_TICK_STALE', severity: S.ERROR, category: 'quote', desc: 'tick 数据过期但仍在报价', suggested_action: '风险提示' },
+    QUOTE_PRICE_ANOMALY: { code: 'QUOTE_PRICE_ANOMALY', severity: S.ERROR, category: 'quote', desc: '报价偏离参考价 > 阈值', suggested_action: '检查数据源' },
+    QUOTE_INTERVAL_BREACH: { code: 'QUOTE_INTERVAL_BREACH', severity: S.WARN, category: 'quote', desc: '询价间隔超出预期' },
+    TRADE_ENCODE_FAIL: { code: 'TRADE_ENCODE_FAIL', severity: S.ERROR, category: 'trade', desc: 'calldata 编码失败', suggested_action: '检查订单参数' },
+    TRADE_SIGN_FAIL: { code: 'TRADE_SIGN_FAIL', severity: S.ERROR, category: 'trade', desc: '交易签名失败', suggested_action: '检查 caller 钱包' },
+    TRADE_NONCE_CONFLICT: {
+        code: 'TRADE_NONCE_CONFLICT', severity: S.WARN, category: 'trade',
+        desc: '单次 nonce 冲突', suggested_action: '自动重试',
+        escalate: { burst_threshold: 5, escalated_severity: S.CRITICAL },
+    },
+    TRADE_NONCE_CONFLICT_BURST: { code: 'TRADE_NONCE_CONFLICT_BURST', severity: S.CRITICAL, category: 'trade', desc: '短时间大量 nonce 冲突', suggested_action: 'nonce 管理异常，排查 stream-trade' },
+    TRADE_CALLER_LOW_BALANCE: { code: 'TRADE_CALLER_LOW_BALANCE', severity: S.ERROR, category: 'trade', desc: 'caller 原生币低于警戒线', suggested_action: '尽快充值' },
+    TRADE_CALLER_EMPTY: { code: 'TRADE_CALLER_EMPTY', severity: S.CRITICAL, category: 'trade', desc: 'caller 原生币为 0', suggested_action: '立即停用或充值' },
+    TRADE_BUILDER_REJECT: { code: 'TRADE_BUILDER_REJECT', severity: S.WARN, category: 'trade', desc: '单个 Builder 拒绝' },
+    TRADE_BUILDER_REJECT_ALL: { code: 'TRADE_BUILDER_REJECT_ALL', severity: S.CRITICAL, category: 'trade', desc: '所有 Builder 都拒', suggested_action: '检查私钥白名单 / builder 配置' },
+    TRADE_SUBMIT_TIMEOUT: { code: 'TRADE_SUBMIT_TIMEOUT', severity: S.ERROR, category: 'trade', desc: '提交后 N 秒未 receipt' },
+    TRADE_RECEIPT_MISS: { code: 'TRADE_RECEIPT_MISS', severity: S.ERROR, category: 'trade', desc: '最终查不到 receipt', suggested_action: '交易可能丢' },
+    TRADE_REVERT_SLIPPAGE: {
+        code: 'TRADE_REVERT_SLIPPAGE', severity: S.WARN, category: 'trade',
+        desc: '链上 revert（滑点）', suggested_action: '市场合理',
+        escalate: { burst_threshold: 5, escalated_severity: S.ERROR },
+    },
+    TRADE_REVERT_SLIPPAGE_BURST: { code: 'TRADE_REVERT_SLIPPAGE_BURST', severity: S.ERROR, category: 'trade', desc: '短时间内大量 slippage revert', suggested_action: '滑点参数需调' },
+    TRADE_REVERT_UNKNOWN: { code: 'TRADE_REVERT_UNKNOWN', severity: S.ERROR, category: 'trade', desc: '链上 revert（非滑点原因）', suggested_action: '必须人工看 revert reason' },
+    TRADE_GAS_UNDERPRICED: { code: 'TRADE_GAS_UNDERPRICED', severity: S.WARN, category: 'trade', desc: 'gas 过低被挤出' },
+    CHAIN_RPC_TIMEOUT: { code: 'CHAIN_RPC_TIMEOUT', severity: S.WARN, category: 'chain', desc: '单次 RPC 请求超时' },
+    CHAIN_RPC_DISCONNECT: { code: 'CHAIN_RPC_DISCONNECT', severity: S.WARN, category: 'chain', desc: '单个 RPC ws 断' },
+    CHAIN_RPC_DISCONNECT_ALL: { code: 'CHAIN_RPC_DISCONNECT_ALL', severity: S.CRITICAL, category: 'chain', desc: '所有 RPC 全断', suggested_action: '立即检查网络' },
+    CHAIN_RPC_LAG_HIGH: { code: 'CHAIN_RPC_LAG_HIGH', severity: S.WARN, category: 'chain', desc: 'RPC 响应延迟异常' },
+    CHAIN_BLOCK_SUB_LAG: { code: 'CHAIN_BLOCK_SUB_LAG', severity: S.WARN, category: 'chain', desc: 'stream-block 订阅延迟' },
+    CHAIN_POOL_EVENT_GAP: { code: 'CHAIN_POOL_EVENT_GAP', severity: S.WARN, category: 'chain', desc: '池子事件 block 跳跃' },
+    CHAIN_POOL_EVENT_LOSS: { code: 'CHAIN_POOL_EVENT_LOSS', severity: S.ERROR, category: 'chain', desc: '确认池子事件丢失' },
+    THIRDPARTY_RATE_LIMITED: {
+        code: 'THIRDPARTY_RATE_LIMITED', severity: S.WARN, category: 'thirdparty',
+        desc: '第三方服务限流（429）',
+        escalate: { burst_threshold: 5, escalated_severity: S.ERROR },
+    },
+    THIRDPARTY_RATE_LIMITED_BURST: { code: 'THIRDPARTY_RATE_LIMITED_BURST', severity: S.ERROR, category: 'thirdparty', desc: '短时连续限流', suggested_action: '降频 / 换 key' },
+    THIRDPARTY_API_FAIL: { code: 'THIRDPARTY_API_FAIL', severity: S.WARN, category: 'thirdparty', desc: '单次失败（5xx / 网络 / 解析）' },
+    THIRDPARTY_API_DOWN: { code: 'THIRDPARTY_API_DOWN', severity: S.ERROR, category: 'thirdparty', desc: '持续失败 > N 分钟' },
+    THIRDPARTY_DATA_INVALID: { code: 'THIRDPARTY_DATA_INVALID', severity: S.WARN, category: 'thirdparty', desc: '返回数据格式错' },
+    THIRDPARTY_AUTH_FAIL: { code: 'THIRDPARTY_AUTH_FAIL', severity: S.ERROR, category: 'thirdparty', desc: '认证失败（API key 过期）' },
+    INFRA_REDIS_DISCONNECT: { code: 'INFRA_REDIS_DISCONNECT', severity: S.CRITICAL, category: 'infra', desc: 'Redis 连接断', suggested_action: '立即查 Redis' },
+    INFRA_REDIS_LATENCY_HIGH: { code: 'INFRA_REDIS_LATENCY_HIGH', severity: S.WARN, category: 'infra', desc: 'Redis P95 延迟异常' },
+    INFRA_CONFIG_CENTER_DOWN: { code: 'INFRA_CONFIG_CENTER_DOWN', severity: S.ERROR, category: 'infra', desc: 'config-center 不可达' },
+    INFRA_MARKET_DATA_DOWN: { code: 'INFRA_MARKET_DATA_DOWN', severity: S.ERROR, category: 'infra', desc: 'market-data 不可达' },
+    INFRA_TRADE_MGT_DOWN: { code: 'INFRA_TRADE_MGT_DOWN', severity: S.ERROR, category: 'infra', desc: 'trade-mgt 不可达' },
+    INFRA_PROCESS_CRASH: {
+        code: 'INFRA_PROCESS_CRASH', severity: S.ERROR, category: 'infra',
+        desc: 'PM2 restart_count 增加',
+        escalate: { burst_threshold: 3, escalated_severity: S.CRITICAL },
+    },
+    INFRA_PROCESS_CRASH_LOOP: { code: 'INFRA_PROCESS_CRASH_LOOP', severity: S.CRITICAL, category: 'infra', desc: '进程 5 分钟内反复重启', suggested_action: '停用该进程' },
+    INFRA_ENV_MISSING: { code: 'INFRA_ENV_MISSING', severity: S.ERROR, category: 'infra', desc: '关键 env 未配置' },
+    ANALYZE_UPSTREAM_MISSING: { code: 'ANALYZE_UPSTREAM_MISSING', severity: S.WARN, category: 'analyze', desc: '上游消息缺环节（PreTrade/OnTrade/PostTrade）' },
+    ANALYZE_SQLITE_FULL: { code: 'ANALYZE_SQLITE_FULL', severity: S.WARN, category: 'analyze', desc: 'SQLite 接近容量上限' },
+    ANALYZE_SQLITE_WRITE_FAIL: { code: 'ANALYZE_SQLITE_WRITE_FAIL', severity: S.ERROR, category: 'analyze', desc: 'SQLite 写失败' },
+    ANALYZE_ALERT_FLOOD: { code: 'ANALYZE_ALERT_FLOOD', severity: S.ERROR, category: 'analyze', desc: '告警上报速率异常（防噪音自保）' },
+};
+function getDefaultSeverity(code) {
+    var _a;
+    return ((_a = exports.ALERT_CODES[code]) === null || _a === void 0 ? void 0 : _a.severity) || types_1.AlertSeverity.ERROR;
+}
+function getCategory(code) {
+    var _a;
+    return ((_a = exports.ALERT_CODES[code]) === null || _a === void 0 ? void 0 : _a.category) || 'unknown';
+}
+function isKnownCode(code) {
+    return code in exports.ALERT_CODES;
+}

package/dist/alert/index.d.ts

@@ -0,0 +1,4 @@
+export * from './types';
+export * from './codes';
+export * from './reporter';
+export * from './log_rules';

package/dist/alert/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./types"), exports);
+__exportStar(require("./codes"), exports);
+__exportStar(require("./reporter"), exports);
+__exportStar(require("./log_rules"), exports);

package/dist/alert/log_rules.d.ts

@@ -0,0 +1,8 @@
+export interface LogAlertRule {
+    pattern: RegExp;
+    level?: 'warn' | 'error';
+    code: string;
+    context?: Record<string, any> | ((match: RegExpMatchArray, msg: string) => Record<string, any>);
+}
+export declare function registerLogRules(rules: LogAlertRule[]): void;
+export declare function getRegisteredRuleCount(): number;

package/dist/alert/log_rules.js

@@ -0,0 +1,84 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerLogRules = registerLogRules;
+exports.getRegisteredRuleCount = getRegisteredRuleCount;
+const reporter_1 = require("./reporter");
+const log_bus_1 = require("../log_bus");
+const _rules = [];
+function registerLogRules(rules) {
+    _rules.push(...rules);
+}
+function getRegisteredRuleCount() {
+    return _rules.length;
+}
+function detectProvider(msg) {
+    const m = msg.toLowerCase();
+    if (m.includes('geckoterminal') || m.includes('gecko-terminal'))
+        return 'geckoterminal';
+    if (m.includes('dexscreener'))
+        return 'dexscreener';
+    if (m.includes('birdeye'))
+        return 'birdeye';
+    if (m.includes('coingecko'))
+        return 'coingecko';
+    if (m.includes('defillama'))
+        return 'defillama';
+    return 'unknown';
+}
+registerLogRules([
+    { pattern: /redis.*(disconnect|connection.*lost|econnrefused|pubsub.*error|subscribe.*failed|exceeded max reconnect|连接失败)/i,
+        code: 'INFRA_REDIS_DISCONNECT' },
+    { pattern: /econnrefused.*4000|config-center.*(down|unavailable)|(get|update|delete|post|check)\s+(pools|tokens|group|fixed-symbol|zh-pinyin).*error|init_.*client.*error/i,
+        level: 'error', code: 'INFRA_CONFIG_CENTER_DOWN' },
+    { pattern: /uncaught exception|unhandled rejection|startup failed|main error|create_trade_runtime error|arb_cache.*init.*error/i,
+        level: 'error', code: 'INFRA_PROCESS_CRASH' },
+    { pattern: /未设置.*api.*key|missing.*api.*key|env.*not.*configured/i,
+        code: 'INFRA_ENV_MISSING' },
+    { pattern: /\[collector\].*(run error|fatal)|market.?data.*(down|unavailable)/i,
+        level: 'error', code: 'INFRA_MARKET_DATA_DOWN' },
+    { pattern: /\b429\b|too many requests/i, code: 'THIRDPARTY_RATE_LIMITED',
+        context: (_m, msg) => ({ provider: detectProvider(msg) }) },
+    { pattern: /geckoterminal.*(error|fail)|defillama.*(error|fail)|failed to get prices.*after trying all channels/i,
+        code: 'THIRDPARTY_API_FAIL',
+        context: (_m, msg) => ({ provider: detectProvider(msg) }) },
+    { pattern: /api.*(unauthorized|invalid api key|auth.*failed)/i,
+        level: 'error', code: 'THIRDPARTY_AUTH_FAIL' },
+    { pattern: /pricefeed.*(parse failed|not an array|empty)|empty response at page/i,
+        level: 'warn', code: 'THIRDPARTY_DATA_INVALID' },
+    { pattern: /sqlite.*(disk|full|i\/o error|cleanup error|write.*fail)/i,
+        level: 'error', code: 'ANALYZE_SQLITE_WRITE_FAIL' },
+    { pattern: /db size.*\d+mb.*limit/i, level: 'warn', code: 'ANALYZE_SQLITE_FULL' },
+    { pattern: /poolsync.*(failed|skip)|blocktimecache.*(failed|skip)|\[preload\].*failed/i,
+        level: 'warn', code: 'ANALYZE_UPSTREAM_MISSING' },
+]);
+function matchAndReport(level, msg, err) {
+    setImmediate(() => {
+        try {
+            if (!msg)
+                return;
+            for (const rule of _rules) {
+                if (rule.level && rule.level !== level)
+                    continue;
+                const match = msg.match(rule.pattern);
+                if (!match)
+                    continue;
+                const context = typeof rule.context === 'function'
+                    ? rule.context(match, msg)
+                    : (rule.context || {});
+                (0, reporter_1.reportAlert)({
+                    code: rule.code,
+                    source: '',
+                    message: msg.length > 500 ? msg.slice(0, 500) + '...' : msg,
+                    context,
+                    err: err instanceof Error ? err : undefined,
+                });
+                break;
+            }
+        }
+        catch (_a) {
+        }
+    });
+}
+log_bus_1.logBus.onLog((event) => {
+    matchAndReport(event.level, event.msg, event.err || event.data);
+});

package/dist/alert/reporter.d.ts

@@ -0,0 +1,3 @@
+import { AlertPayload } from './types';
+export declare function reportAlert(payload: AlertPayload): void;
+export declare function flushAlerts(): Promise<void>;

package/dist/alert/reporter.js

@@ -0,0 +1,130 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reportAlert = reportAlert;
+exports.flushAlerts = flushAlerts;
+const types_1 = require("./types");
+const codes_1 = require("./codes");
+let _axios = null;
+function getAxios() {
+    if (!_axios)
+        _axios = require('axios');
+    return _axios;
+}
+function getConfig() {
+    return {
+        analyze_host: process.env.ALERT_ANALYZE_HOST || '',
+        analyze_port: parseInt(process.env.ALERT_ANALYZE_PORT || '8004'),
+        flush_size: parseInt(process.env.ALERT_FLUSH_SIZE || '10'),
+        flush_ms: parseInt(process.env.ALERT_FLUSH_MS || '5000'),
+        dedup_window_ms: parseInt(process.env.ALERT_DEDUP_WINDOW_MS || '60000'),
+        source_prefix: process.env.APP_NAME || process.env.NAMESPACE || 'unknown',
+    };
+}
+const buffer = new Map();
+let flushTimer = null;
+function dedupKey(code, source) {
+    return `${code}|${source}`;
+}
+function reportAlert(payload) {
+    try {
+        const cfg = getConfig();
+        if (!cfg.analyze_host)
+            return;
+        const severity = payload.severity || (0, codes_1.getDefaultSeverity)(payload.code);
+        if (severity === types_1.AlertSeverity.DEBUG)
+            return;
+        const normalized = Object.assign(Object.assign({}, payload), { severity, source: payload.source || cfg.source_prefix, ts: payload.ts || Date.now(), err: payload.err instanceof Error ? serializeError(payload.err) : payload.err });
+        const key = dedupKey(normalized.code, normalized.source);
+        const now = Date.now();
+        const existing = buffer.get(key);
+        if (existing && now - existing.first_ts < cfg.dedup_window_ms) {
+            existing.count += 1;
+            existing.last_ts = now;
+            existing.payload.context = Object.assign(Object.assign({}, (existing.payload.context || {})), (normalized.context || {}));
+            const def = codes_1.ALERT_CODES[normalized.code];
+            if ((def === null || def === void 0 ? void 0 : def.escalate) && !existing.escalated && existing.count >= def.escalate.burst_threshold) {
+                existing.payload.severity = def.escalate.escalated_severity;
+                existing.escalated = true;
+            }
+        }
+        else {
+            buffer.set(key, {
+                payload: normalized,
+                first_ts: now,
+                last_ts: now,
+                count: 1,
+            });
+        }
+        if (buffer.size >= cfg.flush_size) {
+            flush();
+        }
+        else if (!flushTimer) {
+            flushTimer = setTimeout(flush, cfg.flush_ms);
+        }
+    }
+    catch (e) {
+        safeLogWarn('reportAlert internal error', e);
+    }
+}
+function flush() {
+    return __awaiter(this, void 0, void 0, function* () {
+        if (flushTimer) {
+            clearTimeout(flushTimer);
+            flushTimer = null;
+        }
+        if (buffer.size === 0)
+            return;
+        const cfg = getConfig();
+        const items = Array.from(buffer.values());
+        buffer.clear();
+        const url = `http://${cfg.analyze_host}:${cfg.analyze_port}/trade/analyze/alert/ingest`;
+        const body = {
+            alerts: items.map(b => ({
+                code: b.payload.code,
+                severity: b.payload.severity,
+                source: b.payload.source,
+                message: b.payload.message,
+                context: b.payload.context,
+                err: b.payload.err,
+                count: b.count,
+                first_ts: b.first_ts,
+                last_ts: b.last_ts,
+                escalated: b.escalated || false,
+            })),
+        };
+        try {
+            yield getAxios().post(url, body, {
+                timeout: 3000,
+                headers: { 'Content-Type': 'application/json' },
+            });
+        }
+        catch (e) {
+            safeLogWarn(`[alert] flush failed (${items.length} items): ${e.message}`);
+        }
+    });
+}
+function flushAlerts() {
+    return __awaiter(this, void 0, void 0, function* () {
+        yield flush();
+    });
+}
+process.on('SIGTERM', () => { flushAlerts(); });
+process.on('SIGINT', () => { flushAlerts(); });
+function serializeError(err) {
+    return { name: err.name, message: err.message, stack: err.stack };
+}
+function safeLogWarn(msg, err) {
+    try {
+        console.warn(`[alert] ${msg}`, err ? (err.message || err) : '');
+    }
+    catch (_a) { }
+}

package/dist/alert/types.d.ts

@@ -0,0 +1,40 @@
+export declare enum AlertSeverity {
+    DEBUG = "debug",
+    INFO = "info",
+    WARN = "warn",
+    ERROR = "error",
+    CRITICAL = "critical"
+}
+export interface AlertCodeDef {
+    code: string;
+    severity: AlertSeverity;
+    category: 'chain' | 'quote' | 'trade' | 'thirdparty' | 'infra' | 'analyze';
+    desc: string;
+    suggested_action?: string;
+    escalate?: {
+        burst_threshold: number;
+        escalated_severity: AlertSeverity;
+    };
+}
+export interface AlertPayload {
+    code: string;
+    severity?: AlertSeverity;
+    source: string;
+    message: string;
+    context?: Record<string, any>;
+    err?: {
+        name?: string;
+        message?: string;
+        stack?: string;
+    } | Error;
+    ts?: number;
+}
+export interface AlertRecord extends AlertPayload {
+    id: string;
+    ts: number;
+    count: number;
+    first_ts: number;
+    last_ts: number;
+    escalated?: boolean;
+    read?: boolean;
+}

package/dist/alert/types.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AlertSeverity = void 0;
+var AlertSeverity;
+(function (AlertSeverity) {
+    AlertSeverity["DEBUG"] = "debug";
+    AlertSeverity["INFO"] = "info";
+    AlertSeverity["WARN"] = "warn";
+    AlertSeverity["ERROR"] = "error";
+    AlertSeverity["CRITICAL"] = "critical";
+})(AlertSeverity || (exports.AlertSeverity = AlertSeverity = {}));

package/dist/analyze/index.js

@@ -19,11 +19,25 @@ const ANALYZE_HOST = process.env.TRADE_ANALYZE_HOST || '';
 const ANALYZE_PORT = process.env.TRADE_ANALYZE_PORT || '8004';
 const ANALYZE_BASE = ANALYZE_HOST ? `http://${ANALYZE_HOST}:${ANALYZE_PORT}/trade/analyze` : '';
 const headers = { 'Content-Type': 'application/json' };
+const INGEST_PATH = {
+    PriceMessageType: '/ingest/price',
+    OrderMessageType: '/ingest/order',
+    DepthLevels: '/ingest/depth',
+    TickLiquidity: '/ingest/tick',
+    TradeResultType: '/ingest/trade-result',
+    SendTxLogType: '/ingest/send-tx',
+    QuoteVerify: '/ingest/quote-verify',
+};
 const report_trade_analyze_data = (type, message) => {
     if (!ANALYZE_BASE)
         return;
+    const path = INGEST_PATH[type];
+    if (!path) {
+        (0, index_1.log_warn)(`[analyze] unknown report type: ${type}`);
+        return;
+    }
     try {
-        axios_1.default.post(ANALYZE_BASE, { type, message }, { headers, timeout: 3000 })
+        axios_1.default.post(ANALYZE_BASE + path, message, { headers, timeout: 3000 })
             .then(() => (0, index_1.log_trace)(`[analyze] report ${type} ok`))
             .catch(err => (0, index_1.log_warn)(`[analyze] report ${type} fail: ${err.message}`));
     }
@@ -36,7 +50,7 @@ const get_pool_latest_quote_price = (unique_orderbook_id) => __awaiter(void 0, v
     if (!ANALYZE_BASE || (0, index_1.isEmpty)(unique_orderbook_id))
         return null;
     try {
-        const url = `${ANALYZE_BASE}/price_msg?unique_orderbook_id=${unique_orderbook_id}`;
+        const url = `${ANALYZE_BASE}/quote/price-msg?unique_orderbook_id=${unique_orderbook_id}`;
         const res = (yield axios_1.default.get(url, { headers, timeout: 3000 })).data;
         return res.data;
     }

package/dist/app_config/env_registry.js

@@ -16,8 +16,22 @@ registerEnvVars({
     dex_id: { env: 'DEX_ID', type: 'string', desc: 'DEX 标识' },
     redis_host: { env: 'REDIS_HOST', type: 'string', default: '127.0.0.1', desc: 'Redis 地址' },
     redis_port: { env: 'REDIS_PORT', type: 'number', default: 6379, desc: 'Redis 端口' },
-    config_center_host: { env: 'CONFIG_CENTER_HOST', type: 'string', default: '', desc: 'config-center 地址' },
-    trade_analyze_host: { env: 'TRADE_ANALYZE_HOST', type: 'string', default: '', desc: 'analyze 地址' },
+    config_center_host: { env: 'CONFIG_CENTER_HOST', type: 'string', default: '127.0.0.1', desc: 'config-center 地址(IP)，端口固定 SERVICE_PORT.CONFIG_CENTER_HTTP' },
+    trade_analyze_host: { env: 'TRADE_ANALYZE_HOST', type: 'string', default: '127.0.0.1', desc: 'analyze 地址(IP)' },
+    trade_mgt_host: { env: 'TRADE_MGT_HOST', type: 'string', default: '127.0.0.1', desc: 'trade-mgt 默认地址(IP)，端口固定 SERVICE_PORT.TRADE_MGT_HTTP' },
+    trade_mgt_hosts: { env: 'TRADE_MGT_HOSTS', type: 'string', default: '', desc: 'trade-mgt 可选地址列表(IP逗号分隔)，UI 可切换；未配置则使用 TRADE_MGT_HOST' },
+    alert_analyze_host: { env: 'ALERT_ANALYZE_HOST', type: 'string', default: '', desc: 'analyze 告警端点地址(IP)，为空则不上报；默认 127.0.0.1' },
+    alert_analyze_port: { env: 'ALERT_ANALYZE_PORT', type: 'number', default: 8004, desc: 'analyze 告警端点端口' },
+    alert_flush_size: { env: 'ALERT_FLUSH_SIZE', type: 'number', default: 10, desc: 'alert 批处理阈值(条数)' },
+    alert_flush_ms: { env: 'ALERT_FLUSH_MS', type: 'number', default: 5000, desc: 'alert 批处理阈值(ms)' },
+    alert_dedup_window_ms: { env: 'ALERT_DEDUP_WINDOW_MS', type: 'number', default: 60000, desc: 'alert 去重窗口(ms)' },
+    analyze_sqlite_retain: { env: 'ANALYZE_SQLITE_RETAIN', type: 'string', default: '8h', desc: 'analyze SQLite 数据保留期，支持 8h/2d/30m 格式' },
+    alert_webhook_url: { env: 'ALERT_WEBHOOK_URL', type: 'string', default: '', sensitive: true, desc: '外推 webhook URL；为空则禁用外推' },
+    alert_webhook_type: { env: 'ALERT_WEBHOOK_TYPE', type: 'string', default: '', desc: 'webhook 类型(lark/slack/dingtalk/generic)；省略则按 URL 自动识别' },
+    alert_webhook_min_severity: { env: 'ALERT_WEBHOOK_MIN_SEVERITY', type: 'string', default: 'critical', desc: '只外推 >= 此级别的告警(warn/error/critical)' },
+    alert_webhook_rate_limit: { env: 'ALERT_WEBHOOK_RATE_LIMIT', type: 'number', default: 10, desc: 'webhook 速率上限(条/分钟)，防刷屏' },
+    alert_webhook_dedup_ms: { env: 'ALERT_WEBHOOK_DEDUP_MS', type: 'string', default: '5m', desc: 'webhook 去重窗口(同 code+source 不重复推)，支持 5m/30s/1h' },
+    alert_webhook_system_label: { env: 'ALERT_WEBHOOK_SYSTEM_LABEL', type: 'string', default: '', desc: 'webhook 消息中显示的系统标识，省略时使用 CHAIN_ID' },
     trade_analyze_port: { env: 'TRADE_ANALYZE_PORT', type: 'number', default: 8004, desc: 'analyze 端口' },
     trade_analyze_url: { env: 'TRADE_ANALYZE_URL', type: 'string', default: '', desc: 'analyze URL（旧）' },
     rpc_endpoint: { env: 'RPC_ENDPOINT', type: 'string', default: '', desc: 'RPC HTTP 端点' },

package/dist/chains/evm_gas_options.d.ts

@@ -0,0 +1,9 @@
+export interface EvmGasOptions {
+    gasLimit: number;
+    defaultGasPriceGwei: number;
+    maxGasPriceGwei: number;
+    maxFeePerGasGwei: number;
+    maxPriorityFeePerGasGwei: number;
+    defaultTipAmountGwei: number;
+    maxTipAmountGwei: number;
+}

package/dist/chains/evm_gas_options.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/index.d.ts

@@ -15,6 +15,8 @@ export * from './quote';
 export * from './token';
 export * from './trade';
 export * from './chains';
+export * from './alert';
+export * from './log_bus';
 export * from './ws';
 export * from './util';
 export type { CommonServiceType, ConfigCenterServiceType, QuoteServiceType, OrderbookServiceType, TradeProxyServiceType, StandardTokenConfigType, StandardTokenInfoType, StandardPoolConfigType, StandardDexPoolConfigType, StandardPoolInfoType, StandardPairType, TradeServiceConfigType, TradeGroupType, TradePairType, TradePairDexPoolsType, TradeSettingsType, RpcInfoType, TradeStrategyType, TradeCommandLineArgs, TradeRuntimeType, TradeProcessInstanceType, TokenPriceWithAmountType, QuoteResultType, PriceMessageType, QuoteSourceType, UniqueOrderbookIdType, PriceType, QuoteTimeInfoType, OrderbookPriceType, Ladder, OrderMessageType, OrderSubmitResultType, OrderSubmitResponseType, StandardSwapDetailType, TokenBalChangeType, TokenBalanceChangeType, TradeResponseType, TradeResultType, TradeResultBalanceChangeType, TradeExecutionInfoType, TradeTimeFlowType, TradeBroadcastType, TradeGasFeeType, ServerInfoType, SendTxLogType, WalletInfoType, WalletTokenBalanceInfoType, RedisConfigChangeEventMessageType, RedisOrderEventMessageType, RedisQuoteEventMessageType, PreTradeEventType, ProviderComparisonType, ProviderArrivalType, OnTradeType, OnTradePriceType, OnTradeDepthType, OnTradeExecutionType, OnTradeResultType, AnalyzeDepthLevelType, AnalyzeTokenAmountType, PostTradeType, AnalyzeQuoteSnapshotType, AnalyzePoolEventType, AnalyzeEventSummaryType, AnalyzeSameBlockType, } from '../types';

package/dist/index.js

@@ -76,6 +76,7 @@ exports.load_wallet = load_wallet;
 exports.load_wallet_multi = load_wallet_multi;
 exports.chunkArray = chunkArray;
 require('dotenv').config();
+const log_bus_1 = require("./log_bus");
 const bn_js_1 = __importDefault(require("bn.js"));
 const decimal_js_1 = __importDefault(require("decimal.js"));
 const fs_1 = __importDefault(require("fs"));
@@ -97,6 +98,8 @@ __exportStar(require("./quote"), exports);
 __exportStar(require("./token"), exports);
 __exportStar(require("./trade"), exports);
 __exportStar(require("./chains"), exports);
+__exportStar(require("./alert"), exports);
+__exportStar(require("./log_bus"), exports);
 __exportStar(require("./ws"), exports);
 __exportStar(require("./util"), exports);
 const short = require('short-uuid');
@@ -395,7 +398,16 @@ function log_debug(msg, data = {}, traceId = '') {
     log_info(msg, data, traceId, _caller(), LOG_LEVEL.DEBUG);
 }
 function log_warn(msg, data = {}, traceId = '') {
-    log_info(`!!! ${msg}`, data, traceId, _caller(), LOG_LEVEL.WARN);
+    const caller = _caller();
+    log_info(`!!! ${msg}`, data, traceId, caller, LOG_LEVEL.WARN);
+    log_bus_1.logBus.emitLog({
+        level: 'warn',
+        msg,
+        data,
+        caller: caller === null || caller === void 0 ? void 0 : caller.module,
+        trace_id: traceId,
+        ts: Date.now(),
+    });
 }
 function log_info(msg, data = {}, traceId = '', caller = undefined, level = LOG_LEVEL.INFO) {
     if (level < _log_level) {
@@ -424,6 +436,14 @@ function log_error(msg, err, traceId = '', caller = undefined) {
     else {
         console.error(`${getCurDateTime()} - [5] - [${caller.module}] - ${traceId} - ${msg}`, err);
     }
+    log_bus_1.logBus.emitLog({
+        level: 'error',
+        msg,
+        err,
+        caller: caller === null || caller === void 0 ? void 0 : caller.module,
+        trace_id: traceId,
+        ts: Date.now(),
+    });
 }
 function createLogger(filename) {
     const module = path_1.default.basename(filename).replace(/\.(js|ts)$/, '');

package/dist/log_bus.d.ts

@@ -0,0 +1,17 @@
+import { EventEmitter } from 'events';
+export interface LogEvent {
+    level: 'warn' | 'error';
+    msg: string;
+    err?: any;
+    data?: any;
+    caller?: string;
+    trace_id?: string;
+    ts: number;
+}
+declare class LogBus extends EventEmitter {
+    constructor();
+    emitLog(event: LogEvent): void;
+    onLog(handler: (event: LogEvent) => void): this;
+}
+export declare const logBus: LogBus;
+export {};

package/dist/log_bus.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logBus = void 0;
+const events_1 = require("events");
+class LogBus extends events_1.EventEmitter {
+    constructor() {
+        super();
+        this.setMaxListeners(50);
+    }
+    emitLog(event) {
+        try {
+            this.emit('log', event);
+        }
+        catch (_a) {
+        }
+    }
+    onLog(handler) {
+        return this.on('log', handler);
+    }
+}
+exports.logBus = new LogBus();

package/dist/pool/pool_util.js

@@ -31,7 +31,7 @@ function get_pair_name(native_token, pool_name) {
 function check_pool_token_address(pool) {
     let { pool_name, pool_address, tokenA, tokenB } = pool;
     for (let token of [tokenA, tokenB]) {
-        let is_fake_token = token_1.fixed_symbol_address.some(e => e.symbol === token.symbol && e.address.toLowerCase() !== token.address.toLowerCase());
+        let is_fake_token = (0, token_1.get_fixed_symbol_address)().some(e => e.symbol === token.symbol && e.address.toLowerCase() !== token.address.toLowerCase());
         if (is_fake_token) {
             throw new Error(`Invalid token address of ${token.symbol}: ${token.address}, ${pool_name}, ${pool_address}`);
         }

package/dist/token/fixed_symbol_address.d.ts

@@ -1,2 +1,2 @@
 import { TokenFixedSymbolAddress } from './types';
-export declare const fixed_symbol_address: TokenFixedSymbolAddress[];
+export declare const get_fixed_symbol_address: () => TokenFixedSymbolAddress[];

package/dist/token/fixed_symbol_address.js

@@ -3,25 +3,31 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.fixed_symbol_address = void 0;
+exports.get_fixed_symbol_address = void 0;
 require('dotenv').config();
 const os_1 = __importDefault(require("os"));
 const path_1 = __importDefault(require("path"));
 const index_1 = require("../index");
+let _first_load_logged = false;
 const get_fixed_symbol_address = () => {
-    let chain_id = process.env.CHAIN_ID;
+    const chain_id = process.env.CHAIN_ID;
     if (!chain_id) {
         return [];
     }
-    let filepath = process.env.BSC_FIXED_SYMBOL_ADDRESS_FILE || path_1.default.join(os_1.default.homedir(), 'data', 'onchain_data', chain_id.toLowerCase(), 'fixed_symbol_address.json');
-    console.log(`get_fixed_symbol_address: ${filepath}`);
-    let fixed_symbol_address_list = [];
+    const filepath = process.env.BSC_FIXED_SYMBOL_ADDRESS_FILE ||
+        path_1.default.join(os_1.default.homedir(), 'data', 'onchain_data', chain_id.toLowerCase(), 'fixed_symbol_address.json');
+    const print_log = process.env.PRINT_FIXED_SYMBOL_ADDRESS === 'true';
+    let list = [];
     try {
-        fixed_symbol_address_list = (0, index_1.readFile)(filepath, true, true);
+        list = (0, index_1.readFile)(filepath, true, true);
+        if (print_log && !_first_load_logged) {
+            (0, index_1.log_info)(`[fixed_symbol_address] loaded ${list.length} entries from ${filepath}`);
+            _first_load_logged = true;
+        }
     }
     catch (error) {
-        console.error('get_fixed_symbol_address erro!', error);
+        (0, index_1.log_error)(`[fixed_symbol_address] load failed from ${filepath}`, error);
     }
-    return fixed_symbol_address_list;
+    return list;
 };
-exports.fixed_symbol_address = get_fixed_symbol_address();
+exports.get_fixed_symbol_address = get_fixed_symbol_address;

package/dist/token/index.d.ts

@@ -4,3 +4,4 @@ export * from './is_not_arb_token';
 export * from './price';
 export * from './token_util';
 export * from './types';
+export * from './zh_pinyin_map';

package/dist/token/index.js

@@ -20,3 +20,4 @@ __exportStar(require("./is_not_arb_token"), exports);
 __exportStar(require("./price"), exports);
 __exportStar(require("./token_util"), exports);
 __exportStar(require("./types"), exports);
+__exportStar(require("./zh_pinyin_map"), exports);

package/dist/token/token_util.js

@@ -21,6 +21,6 @@ const is_valid_symbol = (symbol) => {
 };
 exports.is_valid_symbol = is_valid_symbol;
 function get_token_symbol_alias(token_address) {
-    let token = __1.fixed_symbol_address.find(e => e.address === token_address);
+    let token = (0, __1.get_fixed_symbol_address)().find(e => e.address === token_address);
     return (token === null || token === void 0 ? void 0 : token.alias) || '';
 }

package/dist/token/types.d.ts

@@ -11,6 +11,10 @@ export interface TokenFixedSymbolAddress {
     address: string;
     is_token2022?: boolean;
 }
+export interface ZhPinyinRow {
+    zh: string;
+    pinyin: string;
+}
 export interface FormattedTokenInfo {
     chainId: number;
     address: string;

package/dist/token/zh_pinyin_map.d.ts

@@ -0,0 +1,3 @@
+import { ZhPinyinRow } from './types';
+export declare const get_zh_pinyin_map: () => ZhPinyinRow[];
+export declare function replace_zh_symbols(text: string): string;

package/dist/token/zh_pinyin_map.js

@@ -0,0 +1,46 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.get_zh_pinyin_map = void 0;
+exports.replace_zh_symbols = replace_zh_symbols;
+require('dotenv').config();
+const os_1 = __importDefault(require("os"));
+const path_1 = __importDefault(require("path"));
+const index_1 = require("../index");
+let _first_load_logged = false;
+const get_zh_pinyin_map = () => {
+    const chain_id = process.env.CHAIN_ID;
+    if (!chain_id) {
+        return [];
+    }
+    const filepath = process.env.ZH_PINYIN_MAP_FILE ||
+        path_1.default.join(os_1.default.homedir(), 'data', 'onchain_data', chain_id.toLowerCase(), 'zh_pinyin_map.json');
+    const print_log = process.env.PRINT_ZH_PINYIN_MAP === 'true';
+    let list = [];
+    try {
+        list = (0, index_1.readFile)(filepath, true, true);
+        if (print_log && !_first_load_logged) {
+            (0, index_1.log_info)(`[zh_pinyin_map] loaded ${list.length} entries from ${filepath}`);
+            _first_load_logged = true;
+        }
+    }
+    catch (error) {
+        (0, index_1.log_error)(`[zh_pinyin_map] load failed from ${filepath}`, error);
+    }
+    return list;
+};
+exports.get_zh_pinyin_map = get_zh_pinyin_map;
+function replace_zh_symbols(text) {
+    if (!text)
+        return text;
+    const list = (0, exports.get_zh_pinyin_map)();
+    let s = text;
+    for (const row of list) {
+        if (row.zh && s.includes(row.zh)) {
+            s = s.replace(row.zh, row.pinyin || '');
+        }
+    }
+    return s;
+}

package/dist/util/duration.d.ts

@@ -0,0 +1,2 @@
+export declare function parseDuration(value: string | number | undefined | null): number;
+export declare function formatDuration(ms: number): string;

package/dist/util/duration.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseDuration = parseDuration;
+exports.formatDuration = formatDuration;
+function parseDuration(value) {
+    if (value === undefined || value === null || value === '')
+        return 0;
+    if (typeof value === 'number')
+        return value;
+    const s = String(value).trim();
+    if (!s)
+        return 0;
+    const match = s.match(/^(\d+(?:\.\d+)?)\s*(ms|s|m|h|d)?$/i);
+    if (!match) {
+        const n = parseInt(s, 10);
+        return isNaN(n) ? 0 : n;
+    }
+    const n = parseFloat(match[1]);
+    const unit = (match[2] || 'ms').toLowerCase();
+    const multipliers = {
+        ms: 1,
+        s: 1000,
+        m: 60000,
+        h: 3600000,
+        d: 86400000,
+    };
+    return Math.round(n * (multipliers[unit] || 1));
+}
+function formatDuration(ms) {
+    if (!ms || ms <= 0)
+        return '0ms';
+    const days = Math.floor(ms / 86400000);
+    const hours = Math.floor((ms % 86400000) / 3600000);
+    const mins = Math.floor((ms % 3600000) / 60000);
+    const secs = Math.floor((ms % 60000) / 1000);
+    const remMs = ms % 1000;
+    const parts = [];
+    if (days > 0)
+        parts.push(`${days}d`);
+    if (hours > 0)
+        parts.push(`${hours}h`);
+    if (mins > 0)
+        parts.push(`${mins}m`);
+    if (secs > 0)
+        parts.push(`${secs}s`);
+    if (remMs > 0 && parts.length === 0)
+        parts.push(`${remMs}ms`);
+    return parts.join(' ') || '0ms';
+}

package/dist/util/index.d.ts

@@ -1,3 +1,4 @@
 export * from './fileutil';
 export * from './httputil';
 export * from './ip_util';
+export * from './duration';

package/dist/util/index.js

@@ -17,3 +17,4 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./fileutil"), exports);
 __exportStar(require("./httputil"), exports);
 __exportStar(require("./ip_util"), exports);
+__exportStar(require("./duration"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@clonegod/ttd-core",
-    "version": "3.1.11",
+    "version": "3.1.13",
     "description": "Common types and utilities for trading systems - use `npm run push` to publish",
     "main": "dist/index.js",
     "types": "dist/index.d.ts",

package/types/index.d.ts

@@ -177,13 +177,14 @@ export interface TradeStrategyType {
     max_block_offset: number                   // Solana特定：限制交易在多少个区块内有效（约等于秒数，1 block ≈ 0.4秒）。使用最新blockhash，设置lastValidBlockHeight = currentBlockHeight + max_block_offset
 
     // evm chain
+    evm_tx_type: 0 | 2                        // 交易类型：0=Legacy, 2=EIP-1559
     evm_gas_limit: number                      // 300000
-    evm_gas_price_gwei: number                 // 1.1 Gwei
-    evm_tip_amount_gwei: number                // 48000 Gwei
+    evm_gas_price_gwei: number                 // Legacy: gasPrice（Gwei）
+    evm_tip_amount_gwei: number                // Builder tip（Gwei），独立原生代币转账
 
-    // evm EIP-1559 交易类型
-    evm_max_gas_price_gwei: number             // 0.01 Gwei 允许的gas price上限
-    evm_max_priority_fee_per_gas_gwei: number  // 0.002 Gwei 允许的priority fee上限，需小于 max_gas_price_gwei
+    // evm EIP-1559 (Type 2)
+    evm_max_fee_per_gas_gwei: number            // Type2: maxFeePerGas（Gwei）
+    evm_max_priority_fee_per_gas_gwei: number  // Type2: maxPriorityFeePerGas（Gwei），允许为 0
 
     // sui
     gas_price: number // default
@@ -921,9 +922,8 @@ export interface OnTradeResultType {
     error_code?: string
     token_in: AnalyzeTokenAmountType
     token_out: AnalyzeTokenAmountType
-    gas_used: number
-    gas_price_gwei: number
-    gas_cost_usd: number
+    /** gas 成本 — 单位为链的原生币（BNB/ETH/SOL/...），USD 计价由消费者用原生币市价换算 */
+    gas_cost_native: number
 }
 
 export interface AnalyzeTokenAmountType {