@clonegod/ttd-base-common 1.0.26 → 1.1.1

package/dist/appconfig/BaseQuoteAppConfig.d.ts

@@ -0,0 +1,10 @@
+import { BaseEnvArgs } from "./base_env_args";
+import { AppConfig } from '@clonegod/ttd-core';
+export declare class BaseQuoteAppConfig extends AppConfig {
+    private eventEmitter;
+    env_args: BaseEnvArgs;
+    constructor();
+    on(eventName: string | symbol, listener: (...args: any[]) => void): this;
+    emit(eventName: string | symbol, ...args: any[]): boolean;
+    init(): Promise<void>;
+}

package/dist/appconfig/BaseQuoteAppConfig.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseQuoteAppConfig = void 0;
+const ensure_core_env_1 = require("./ensure_core_env");
+const ttd_core_1 = require("@clonegod/ttd-core");
+const events_1 = require("events");
+class BaseQuoteAppConfig extends ttd_core_1.AppConfig {
+    constructor() {
+        (0, ensure_core_env_1.ensureCoreEnv)();
+        super();
+        this.eventEmitter = new events_1.EventEmitter();
+        this.env_args = (0, ttd_core_1.getCoreEnv)();
+    }
+    on(eventName, listener) {
+        this.eventEmitter.on(eventName, listener);
+        return this;
+    }
+    emit(eventName, ...args) {
+        return this.eventEmitter.emit(eventName, ...args);
+    }
+    async init() {
+        await super.init();
+        await this.arb_cache.init();
+        if (!this.arb_event_subscriber) {
+            this.arb_event_subscriber = (0, ttd_core_1.getArbEventSubscriber)(this.arb_cache);
+        }
+        (0, ttd_core_1.log_info)('BaseQuoteAppConfig initialized', {
+            chain_id: this.env_args.chain_id,
+            dex_id: this.env_args.dex_id,
+            pair: this.env_args.pair,
+            rpc_endpoint: this.env_args.rpc_endpoint,
+            ws_endpoint: this.env_args.ws_endpoint,
+        });
+    }
+}
+exports.BaseQuoteAppConfig = BaseQuoteAppConfig;

package/dist/appconfig/BaseTradeAppConfig.d.ts

@@ -0,0 +1,7 @@
+import { AbstractTradeAppConfig } from '@clonegod/ttd-core';
+import { BaseEnvArgs } from './base_env_args';
+export declare abstract class BaseTradeAppConfig extends AbstractTradeAppConfig {
+    env_args: BaseEnvArgs;
+    constructor();
+    abstract subscribe_wallet_raw_txn_event(): void;
+}

package/dist/appconfig/BaseTradeAppConfig.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseTradeAppConfig = void 0;
+const ttd_core_1 = require("@clonegod/ttd-core");
+const ensure_core_env_1 = require("./ensure_core_env");
+class BaseTradeAppConfig extends ttd_core_1.AbstractTradeAppConfig {
+    constructor() {
+        (0, ensure_core_env_1.ensureCoreEnv)();
+        super();
+        this.env_args = (0, ttd_core_1.getCoreEnv)();
+    }
+}
+exports.BaseTradeAppConfig = BaseTradeAppConfig;

package/dist/appconfig/base_dex_env_args.d.ts

@@ -0,0 +1,5 @@
+import { BaseEnvArgs } from './base_env_args';
+export declare class BaseDexEnvArgs extends BaseEnvArgs {
+    constructor();
+    print(moduleName?: string): void;
+}

package/dist/appconfig/base_dex_env_args.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseDexEnvArgs = void 0;
+const dist_1 = require("@clonegod/ttd-core/dist");
+const base_env_args_1 = require("./base_env_args");
+class BaseDexEnvArgs extends base_env_args_1.BaseEnvArgs {
+    constructor() {
+        super();
+        const cfg = this._cfg;
+        this.app_name = (cfg.app_name || '').toLowerCase();
+        this.chain_id = (cfg.chain_id || '').toUpperCase();
+        this.dex_id = (cfg.dex_id || '').toUpperCase();
+        this.server_id = cfg.server_id ?? '';
+        this.redis_host = cfg.redis_host;
+        this.redis_port = String(cfg.redis_port);
+        this.rpc_endpoint = cfg.rpc_endpoint;
+        this.ws_endpoint = cfg.ws_endpoint;
+        this.pair = cfg.pair ?? '';
+        this.group_id = cfg.group_id ?? '';
+        this.quote_pool_address = cfg.quote_pool_address;
+        this.quote_pool_name = cfg.quote_pool_name;
+        this.quote_pool_fee_rate = cfg.quote_pool_fee_rate;
+        this.quote_amount_usd = cfg.quote_amount_usd;
+        this.wallet_dir = cfg.wallet_dir;
+        this.encryption_key = cfg.encryption_key ?? '';
+        this.server_ip_list = cfg.server_ip_list ?? '';
+        this.ip_exclude_prefix = cfg.ip_exclude_prefix ?? '';
+        this.namespace = cfg.namespace ?? '';
+        this.trade_analyze_host = cfg.trade_analyze_host ?? '';
+        this.gas_price_gwei = cfg.gas_price_gwei;
+        this.gas_limit = cfg.gas_limit;
+        this.tip_amount_gwei = cfg.tip_amount_gwei;
+        this.gas_max_limit = cfg.gas_max_limit;
+        this.gas_max_price_gwei = cfg.gas_max_price_gwei;
+        this.gas_max_fee_per_gas_gwei = cfg.gas_max_fee_per_gas_gwei;
+        this.gas_max_priority_fee_gwei = cfg.gas_max_priority_fee_gwei;
+        this.gas_max_tip_amount_gwei = cfg.gas_max_tip_amount_gwei;
+        this.aerodrome_executor_id = cfg.aerodrome_executor_id;
+        this.uniswap_executor_id = cfg.uniswap_executor_id;
+        this.caller_select_strategy = cfg.caller_select_strategy;
+        this.send_tx_ws_host = cfg.send_tx_ws_host;
+        this.send_tx_direct_rpc = cfg.send_tx_direct_rpc;
+        this.base_rpc_endpoint = cfg.base_rpc_endpoint;
+        this.send_tx_backup_rpc = cfg.send_tx_backup_rpc;
+        this.base_backup_rpc_endpoint = cfg.base_backup_rpc_endpoint;
+        this.send_tx_timeout_ms = cfg.send_tx_timeout_ms;
+        this.send_tx_blockrazor = cfg.send_tx_blockrazor;
+        this.blockrazor_endpoint = cfg.blockrazor_endpoint;
+        this.blockrazor_auth_token = cfg.blockrazor_auth_token;
+        this.blockrazor_tip_amount_wei = cfg.blockrazor_tip_amount_wei;
+        this.blockrazor_tip_address = cfg.blockrazor_tip_address;
+        this.send_tx_bloxroute = cfg.send_tx_bloxroute;
+        this.bloxroute_endpoint = cfg.bloxroute_endpoint;
+        this.bloxroute_auth_token = cfg.bloxroute_auth_token;
+        this.bloxroute_backrunme_address = cfg.bloxroute_backrunme_address;
+        this.stream_quote_ws_host = cfg.stream_quote_ws_host;
+        this.min_quote_interval_ms = cfg.min_quote_interval_ms;
+        this.use_pricefeed_for_orderbook = cfg.use_pricefeed_for_orderbook;
+        this.trade_parse_fetch_block_time = cfg.trade_parse_fetch_block_time;
+        this.tick_cache_neighboring_words = cfg.tick_cache_neighboring_words;
+        this.tick_cache_ttl = cfg.tick_cache_ttl;
+        this.tick_cache_min_update_interval = cfg.tick_cache_min_update_interval;
+    }
+    print(moduleName) {
+        (0, dist_1.printEnvConfig)(moduleName || this.app_name || 'base-dex', this);
+    }
+}
+exports.BaseDexEnvArgs = BaseDexEnvArgs;

package/dist/appconfig/base_env_args.d.ts

@@ -0,0 +1,82 @@
+import { EnvArgs } from '@clonegod/ttd-core';
+export declare class BaseEnvArgs extends EnvArgs {
+    gas_price_gwei: number;
+    gas_limit: number;
+    tip_amount_gwei: number;
+    gas_max_limit: number;
+    gas_max_price_gwei: number;
+    gas_max_fee_per_gas_gwei: number;
+    gas_max_priority_fee_gwei: number;
+    gas_max_tip_amount_gwei: number;
+    large_trade_threshold_usd: number;
+    aerodrome_executor_id: string;
+    uniswap_executor_id: string;
+    caller_select_strategy: string;
+    tx_status_check_interval_mills: number;
+    tx_cancel_timeout_ms: number;
+    tx_cancel_gas_boost_factor: number;
+    send_tx_ws_host: string;
+    send_tx_direct_rpc: boolean;
+    base_rpc_endpoint: string;
+    send_tx_backup_rpc: boolean;
+    base_backup_rpc_endpoint: string;
+    send_tx_timeout_ms: number;
+    send_tx_blockrazor: boolean;
+    blockrazor_endpoint: string;
+    blockrazor_auth_token: string;
+    blockrazor_tip_amount_wei: number;
+    blockrazor_tip_address: string;
+    send_tx_bloxroute: boolean;
+    bloxroute_endpoint: string;
+    bloxroute_auth_token: string;
+    bloxroute_backrunme_address: string;
+    stream_quote_ws_host: string;
+    min_quote_interval_ms: number;
+    use_pricefeed_for_orderbook: boolean;
+    trade_parse_fetch_block_time: boolean;
+    tick_cache_neighboring_words: number;
+    tick_cache_ttl: number;
+    tick_cache_min_update_interval: number;
+    flashblocks_enabled: boolean;
+    flashblocks_quicknode_wss: string;
+    flashblocks_dedup_ttl_ms: number;
+    flashblocks_health_window_s: number;
+    flashblocks_min_hit_rate: number;
+    ws_push_enable: boolean;
+    print_event_data: boolean;
+    pool_sync_interval_ms: number;
+    redis_url: string;
+    skip_pool_list: string;
+    price_feed_skip_dup: boolean;
+    price_feed_client_id: string;
+    trade_analyze_port: number;
+    log_max_size_mb: number;
+    log_check_interval_min: number;
+    log_dir: string;
+    block_stale_ms: number;
+    chain_name: string;
+    caller_balance_check_interval: string;
+    caller_balance_low_threshold: string;
+    caller_balance_empty_threshold: string;
+    gecko_network: string;
+    chain_id_num: number;
+    native_token_symbol: string;
+    native_token_address: string;
+    wrapped_native_address: string;
+    sync_pool_interval_ms: number;
+    fetch_api_wait_ms: number;
+    fetch_min_tvl: number;
+    fetch_min_vol: number;
+    pool_default_tvl: number;
+    fetch_max_page_no: number;
+    token_batch_size: number;
+    fetch_on_startup: boolean;
+    vault_mgt_rpc_url: string;
+    vault_mgt_chain_id: number;
+    vault_mgt_chain_name: string;
+    vault_mgt_vault_groups: string;
+    vault_mgt_native_symbol: string;
+    vault_mgt_wrapped_native_address: string;
+    vault_mgt_fund_caller_max: string;
+    constructor();
+}

package/dist/appconfig/base_env_args.js

@@ -0,0 +1,91 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseEnvArgs = void 0;
+const ttd_core_1 = require("@clonegod/ttd-core");
+const constants_1 = require("../common/constants");
+(0, ttd_core_1.registerEnvVars)({
+    gas_price_gwei: { env: 'GAS_PRICE_GWEI', type: 'number', default: 1, desc: 'Legacy gasPrice 默认值(Gwei)' },
+    gas_limit: { env: 'GAS_LIMIT', type: 'number', default: 300000, desc: '交易 gas 默认值。本系统单池子 swap 场景 ~200-400k 已够；运行时由 strategy.evm_gas_limit 覆盖' },
+    tip_amount_gwei: { env: 'TIP_AMOUNT_GWEI', type: 'number', default: 10000, desc: 'Builder tip 默认值(Gwei)' },
+    gas_max_limit: { env: 'GAS_MAX_LIMIT', type: 'number', default: 1000000, desc: '单 tx gas 上限。本系统是单池子 swap 套利，不跑 batch；超过此值大概率是配置错误。Base Flashblock #1 容量是 18.75M（=1/10 块 gas @ ~187.5M block limit），1M 远低于该阈值，inclusion 速度不受影响' },
+    gas_max_price_gwei: { env: 'GAS_MAX_PRICE_GWEI', type: 'number', default: 1, desc: 'Legacy gasPrice 上限(Gwei)。Base L2 sequencer fee 通常 < 0.1 gwei，1 gwei 是宽裕上限' },
+    gas_max_fee_per_gas_gwei: { env: 'GAS_MAX_FEE_PER_GAS_GWEI', type: 'number', default: 1, desc: 'EIP-1559 maxFeePerGas 上限(Gwei)' },
+    gas_max_priority_fee_gwei: { env: 'GAS_MAX_PRIORITY_FEE_GWEI', type: 'number', default: 0.5, desc: 'EIP-1559 maxPriorityFeePerGas 上限(Gwei)。Base 上 0.01-0.05 已是高优先档' },
+    gas_max_tip_amount_gwei: { env: 'GAS_MAX_TIP_AMOUNT_GWEI', type: 'number', default: 500000, desc: 'Builder tip 上限(Gwei)' },
+    large_trade_threshold_usd: { env: 'LARGE_TRADE_THRESHOLD_USD', type: 'number', default: 500, desc: '识别询价中的大额交易阈值(USD)' },
+    aerodrome_executor_id: { env: 'AERODROME_EXECUTOR_ID', type: 'string', default: 'AERODROME', desc: 'Vault 中 Aerodrome executor 注册名（keccak256 后作为 bytes32）' },
+    uniswap_executor_id: { env: 'UNISWAP_EXECUTOR_ID', type: 'string', default: 'UNISWAP', desc: 'Vault 中 Uniswap executor 注册名（keccak256 后作为 bytes32）' },
+    caller_select_strategy: { env: 'CALLER_SELECT_STRATEGY', type: 'string', default: 'lock', desc: 'CallerManager LRU 选择策略：lock=Redis 分布式锁(默认) | lua_cas=Lua 原子脚本' },
+    tx_status_check_interval_mills: { env: 'TX_STATUS_CHECK_INTERVAL_MILLS', type: 'number', default: 3000, desc: '链上 tx 状态轮询间隔(ms)' },
+    tx_cancel_timeout_ms: { env: 'TX_CANCEL_TIMEOUT_MS', type: 'number', default: 15000, desc: '交易取消超时(ms)' },
+    tx_cancel_gas_boost_factor: { env: 'TX_CANCEL_GAS_PRICE_BOOST_FACTOR', type: 'number', default: 1.5, desc: '取消交易 gas 提升倍数' },
+    send_tx_ws_host: { env: 'SEND_TX_WS_HOST', type: 'string', default: '127.0.0.1', desc: 'trader WS 客户端连接的 send-tx 服务 host' },
+    send_tx_direct_rpc: { env: 'SEND_TX_DIRECT_RPC', type: 'boolean', default: true, desc: '直发 BASE sequencer RPC（主路径）' },
+    base_rpc_endpoint: { env: 'BASE_RPC_ENDPOINT', type: 'string', default: 'https://mainnet.base.org', desc: 'BASE sequencer RPC 端点（direct_rpc 用）。生产可换 Alchemy / QuickNode private endpoint 提速' },
+    send_tx_backup_rpc: { env: 'SEND_TX_BACKUP_RPC', type: 'boolean', default: false, desc: '备用 RPC 通道（同 chain，不同 provider 做冗余）' },
+    base_backup_rpc_endpoint: { env: 'BASE_BACKUP_RPC_ENDPOINT', type: 'string', default: '', desc: '备用 RPC URL（如 https://base.publicnode.com）' },
+    send_tx_timeout_ms: { env: 'SEND_TX_TIMEOUT_MS', type: 'number', default: 3000, desc: '单通道发送超时(ms)' },
+    send_tx_blockrazor: { env: 'SEND_TX_BLOCKRAZOR', type: 'boolean', default: false, desc: '启用 BlockRazor 通道并发提交' },
+    blockrazor_endpoint: { env: 'BLOCKRAZOR_ENDPOINT', type: 'string', default: 'http://base-fast.blockrazor.io', desc: 'BlockRazor BASE Fast endpoint' },
+    blockrazor_auth_token: { env: 'BLOCKRAZOR_AUTH_TOKEN', type: 'string', default: '', desc: 'BlockRazor Bearer token（Authorization: Bearer <token>）' },
+    blockrazor_tip_amount_wei: { env: 'BLOCKRAZOR_TIP_AMOUNT_WEI', type: 'number', default: 3000000000000, desc: 'BlockRazor tip 数量(wei)。默认 3e12 wei = 0.000003 ETH (BlockRazor 文档最低要求)' },
+    blockrazor_tip_address: { env: 'BLOCKRAZOR_TIP_ADDRESS', type: 'string', default: '0x9D70AC39166ca154307a93fa6b595CF7962fe8e5', desc: 'BlockRazor tip 收款地址（默认值来自 BlockRazor 文档）' },
+    send_tx_bloxroute: { env: 'SEND_TX_BLOXROUTE', type: 'boolean', default: false, desc: '启用 bloXroute 通道并发提交' },
+    bloxroute_endpoint: { env: 'BLOXROUTE_ENDPOINT', type: 'string', default: 'https://api.blxrbdn.com', desc: 'bloXroute API endpoint' },
+    bloxroute_auth_token: { env: 'BLOXROUTE_AUTH_TOKEN', type: 'string', default: '', desc: 'bloXroute Authorization header（直接放完整 token，不要前缀）' },
+    bloxroute_backrunme_address: { env: 'BLOXROUTE_BACKRUNME_ADDRESS', type: 'string', default: '', desc: '可选：bloXroute backrun 回扣收款钱包' },
+    stream_quote_ws_host: { env: 'STREAM_QUOTE_WS_HOST', type: 'string', default: '127.0.0.1', desc: 'stream-quote WS 地址' },
+    min_quote_interval_ms: { env: 'MIN_QUOTE_INTERVAL_MS', type: 'number', default: 10000, desc: '最小询价间隔(ms)' },
+    use_pricefeed_for_orderbook: { env: 'USE_PRICEFEED_FOR_ORDERBOOK', type: 'boolean', default: false, desc: 'PriceFeed (v3 source) 报价是否推 orderbook' },
+    trade_parse_fetch_block_time: { env: 'TRADE_PARSE_FETCH_BLOCK_TIME', type: 'boolean', default: false, desc: '解析交易 receipt 时是否额外 RPC 查询 block 时间戳' },
+    flashblocks_enabled: { env: 'FLASHBLOCKS_ENABLED', type: 'boolean', default: true, desc: 'Flashblocks pending logs 主路径开关' },
+    flashblocks_quicknode_wss: { env: 'FLASHBLOCKS_QUICKNODE_WSS', type: 'string', default: '', desc: 'QuickNode Flashblocks WSS endpoint（FLASHBLOCKS_ENABLED=true 时必填；不提供默认值，避免误用 demo endpoint）' },
+    flashblocks_dedup_ttl_ms: { env: 'FLASHBLOCKS_DEDUP_TTL_MS', type: 'number', default: 30000, desc: '事件去重 TTL：Flashblocks + 标准 WSS 同 tx 重复推送的去重窗口(ms)' },
+    flashblocks_health_window_s: { env: 'FLASHBLOCKS_HEALTH_WINDOW_S', type: 'number', default: 60, desc: 'pending→final 命中率统计滚动窗口(s)' },
+    flashblocks_min_hit_rate: { env: 'FLASHBLOCKS_MIN_HIT_RATE', type: 'number', default: 0.95, desc: 'pending→final 命中率低于此阈值则标记 Flashblocks 异常并 alert' },
+    tick_cache_neighboring_words: { env: 'TICK_CACHE_NEIGHBORING_WORDS', type: 'number', default: 2, desc: 'tick 预加载 words 数' },
+    tick_cache_ttl: { env: 'TICK_CACHE_TTL', type: 'number', default: 30000, desc: 'tick 缓存 TTL(ms)' },
+    tick_cache_min_update_interval: { env: 'TICK_CACHE_MIN_UPDATE_INTERVAL', type: 'number', default: 3000, desc: 'tick 最小刷新间隔(ms)' },
+    ws_push_enable: { env: 'WS_PUSH_ENABLE', type: 'boolean', default: true, desc: 'WS 推送开关' },
+    print_event_data: { env: 'PRINT_EVENT_DATA', type: 'boolean', default: false, desc: '打印原始事件数据' },
+    pool_sync_interval_ms: { env: 'POOL_SYNC_INTERVAL_MS', type: 'number', default: 5000, desc: '池子同步间隔(ms)' },
+    redis_url: { env: 'REDIS_URL', type: 'string', default: 'redis://127.0.0.1:6379', desc: 'Redis 连接 URL' },
+    skip_pool_list: { env: 'SKIP_POOL_LIST', type: 'string', default: '', desc: '跳过的池子名称列表(逗号分隔)' },
+    price_feed_skip_dup: { env: 'PRICE_FEED_SKIP_DUP', type: 'boolean', default: false, desc: 'PriceFeed 去重过滤' },
+    price_feed_client_id: { env: 'PRICE_FEED_CLIENT_ID', type: 'string', default: 'BASE_DC', desc: 'PriceFeed 订阅消息里的 client 标识' },
+    trade_analyze_port: { env: 'TRADE_ANALYZE_PORT', type: 'number', default: 8004, desc: '上报 analyze 的 HTTP 端口' },
+    log_max_size_mb: { env: 'LOG_MAX_SIZE_MB', type: 'number', default: 20, desc: '日志文件大小上限(MB)' },
+    log_check_interval_min: { env: 'LOG_CHECK_INTERVAL_MIN', type: 'number', default: 10, desc: '日志检查间隔(分钟)' },
+    log_dir: { env: 'LOG_DIR', type: 'string', default: 'logs', desc: '日志目录' },
+    block_stale_ms: { env: 'BLOCK_STALE_MS', type: 'number', default: 3000, desc: '收不到 block 多久视为 stale(ms)。BASE 2s 块设 3000（漏 ~1.5 块即重连）' },
+    chain_name: { env: 'CHAIN_NAME', type: 'string', default: '', desc: '链名称（Redis key 前缀），stream-trade 建议必填' },
+    caller_balance_check_interval: { env: 'CALLER_BALANCE_CHECK_INTERVAL', type: 'string', default: '1h', desc: 'caller 余额检查周期' },
+    caller_balance_low_threshold: { env: 'CALLER_BALANCE_LOW_THRESHOLD', type: 'string', default: '0.01', desc: 'caller 低余额阈值' },
+    caller_balance_empty_threshold: { env: 'CALLER_BALANCE_EMPTY_THRESHOLD', type: 'string', default: '0', desc: 'caller 耗尽阈值' },
+    gecko_network: { env: 'GECKO_NETWORK', type: 'string', default: 'base', desc: 'GeckoTerminal 网络标识（base）' },
+    chain_id_num: { env: 'CHAIN_ID_NUM', type: 'number', default: 8453, desc: 'BASE 链 ID 数字' },
+    native_token_symbol: { env: 'NATIVE_TOKEN_SYMBOL', type: 'string', default: 'ETH', desc: '原生代币符号' },
+    native_token_address: { env: 'NATIVE_TOKEN_ADDRESS', type: 'string', default: constants_1.NATIVE_ETH_ADDRESS, desc: '原生代币地址' },
+    wrapped_native_address: { env: 'WRAPPED_NATIVE_ADDRESS', type: 'string', default: constants_1.WETH_ADDRESS, desc: 'Wrapped 代币地址(WETH on BASE)' },
+    sync_pool_interval_ms: { env: 'SYNC_POOL_INTERVAL_MS', type: 'number', default: 3600000, desc: '定时池子全量同步间隔(ms)' },
+    fetch_api_wait_ms: { env: 'FETCH_API_WAIT_MS', type: 'number', default: 6000, desc: 'Gecko/DefiLlama 外部 API 调用间隔(ms)' },
+    fetch_min_tvl: { env: 'FETCH_MIN_TVL', type: 'number', default: 50000, desc: '最小 TVL(USD)' },
+    fetch_min_vol: { env: 'FETCH_MIN_VOL', type: 'number', default: 100000, desc: '最小 24h 成交量(USD)' },
+    pool_default_tvl: { env: 'POOL_DEFAULT_TVL', type: 'number', default: 100000, desc: '默认 TVL' },
+    fetch_max_page_no: { env: 'FETCH_MAX_PAGE_NO', type: 'number', default: 10, desc: '最大翻页数' },
+    token_batch_size: { env: 'TOKEN_BATCH_SIZE', type: 'number', default: 10, desc: 'token 批量大小' },
+    fetch_on_startup: { env: 'FETCH_ON_STARTUP', type: 'boolean', default: true, desc: '启动时立即执行' },
+    vault_mgt_rpc_url: { env: 'VAULT_MGT_RPC_URL', type: 'string', default: '', desc: 'Vault 管理 RPC' },
+    vault_mgt_chain_id: { env: 'VAULT_MGT_CHAIN_ID', type: 'number', default: 0, desc: '链 ID 数字' },
+    vault_mgt_chain_name: { env: 'VAULT_MGT_CHAIN_NAME', type: 'string', default: '', desc: '链名称' },
+    vault_mgt_vault_groups: { env: 'VAULT_MGT_VAULT_GROUPS', type: 'string', default: '', desc: 'Vault 分组列表(逗号分隔)' },
+    vault_mgt_native_symbol: { env: 'VAULT_MGT_NATIVE_SYMBOL', type: 'string', default: '', desc: '原生代币符号' },
+    vault_mgt_wrapped_native_address: { env: 'VAULT_MGT_WRAPPED_NATIVE_ADDRESS', type: 'string', default: '', desc: 'Wrapped 代币地址' },
+    vault_mgt_fund_caller_max: { env: 'VAULT_MGT_FUND_CALLER_MAX', type: 'string', default: '', desc: 'Caller 充值上限' },
+});
+class BaseEnvArgs extends ttd_core_1.EnvArgs {
+    constructor() {
+        super();
+    }
+}
+exports.BaseEnvArgs = BaseEnvArgs;

package/dist/appconfig/ensure_core_env.d.ts

@@ -0,0 +1 @@
+export declare function ensureCoreEnv(): void;

package/dist/appconfig/ensure_core_env.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ensureCoreEnv = ensureCoreEnv;
+const ttd_core_1 = require("@clonegod/ttd-core");
+const base_dex_env_args_1 = require("./base_dex_env_args");
+let _ensured = false;
+function ensureCoreEnv() {
+    if (_ensured)
+        return;
+    try {
+        (0, ttd_core_1.getCoreEnv)();
+        _ensured = true;
+    }
+    catch {
+        (0, ttd_core_1.setCoreEnv)(new base_dex_env_args_1.BaseDexEnvArgs());
+        _ensured = true;
+    }
+}

package/dist/appconfig/index.d.ts

@@ -0,0 +1,5 @@
+export * from './base_env_args';
+export * from './base_dex_env_args';
+export * from './BaseQuoteAppConfig';
+export * from './BaseTradeAppConfig';
+export * from './ensure_core_env';

package/dist/appconfig/index.js

@@ -0,0 +1,21 @@
+"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("./base_env_args"), exports);
+__exportStar(require("./base_dex_env_args"), exports);
+__exportStar(require("./BaseQuoteAppConfig"), exports);
+__exportStar(require("./BaseTradeAppConfig"), exports);
+__exportStar(require("./ensure_core_env"), exports);

package/dist/index.d.ts

@@ -1,8 +1,8 @@
 export * from './common';
-export * from './config';
+export * from './appconfig';
 export * from './quote';
 export * from './trade';
 export * from './types';
 export * from './utils';
 export * from './redis';
-export * from './ws';
+export * from './send-tx';

package/dist/index.js

@@ -15,10 +15,10 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./common"), exports);
-__exportStar(require("./config"), exports);
+__exportStar(require("./appconfig"), exports);
 __exportStar(require("./quote"), exports);
 __exportStar(require("./trade"), exports);
 __exportStar(require("./types"), exports);
 __exportStar(require("./utils"), exports);
 __exportStar(require("./redis"), exports);
-__exportStar(require("./ws"), exports);
+__exportStar(require("./send-tx"), exports);

package/dist/quote/depth/amm_depth_calculator.d.ts

@@ -0,0 +1,19 @@
+export interface AmmDepthInput {
+    reserve0: string;
+    reserve1: string;
+    targetBps: number;
+    isBuy: boolean;
+    baseIsToken0: boolean;
+    token0Decimals: number;
+    token1Decimals: number;
+}
+export interface AmmDepthResult {
+    amountOutWei: bigint;
+    amountOut: number;
+    outputDecimals: number;
+    amountInWei: bigint;
+    amountIn: number;
+    inputDecimals: number;
+    targetPrice: number;
+}
+export declare function calculateAmmDepth(input: AmmDepthInput): AmmDepthResult;

package/dist/quote/depth/amm_depth_calculator.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.calculateAmmDepth = calculateAmmDepth;
+const clmm_depth_calculator_1 = require("./clmm_depth_calculator");
+function calculateAmmDepth(input) {
+    const { targetBps, isBuy, baseIsToken0, token0Decimals, token1Decimals } = input;
+    const R0 = BigInt(input.reserve0);
+    const R1 = BigInt(input.reserve1);
+    if (R0 === 0n || R1 === 0n) {
+        return { amountOutWei: 0n, amountOut: 0, outputDecimals: 0, amountInWei: 0n, amountIn: 0, inputDecimals: 0, targetPrice: 0 };
+    }
+    const k = R0 * R1;
+    const bps = BigInt(targetBps);
+    const PRECISION = 10n ** 18n;
+    let amountOutWei;
+    let amountInWei;
+    let outputDecimals;
+    let inputDecimals;
+    if (isBuy) {
+        const [baseReserve, quoteReserve] = baseIsToken0 ? [R0, R1] : [R1, R0];
+        outputDecimals = baseIsToken0 ? token0Decimals : token1Decimals;
+        inputDecimals = baseIsToken0 ? token1Decimals : token0Decimals;
+        const baseReserveNew = baseReserve * (0, clmm_depth_calculator_1.bigIntSqrt)(10000n * PRECISION) / (0, clmm_depth_calculator_1.bigIntSqrt)((10000n + bps) * PRECISION);
+        const quoteReserveNew = quoteReserve * (0, clmm_depth_calculator_1.bigIntSqrt)((10000n + bps) * PRECISION) / (0, clmm_depth_calculator_1.bigIntSqrt)(10000n * PRECISION);
+        amountOutWei = baseReserve - baseReserveNew;
+        amountInWei = quoteReserveNew - quoteReserve;
+    }
+    else {
+        const [baseReserve, quoteReserve] = baseIsToken0 ? [R0, R1] : [R1, R0];
+        outputDecimals = baseIsToken0 ? token1Decimals : token0Decimals;
+        inputDecimals = baseIsToken0 ? token0Decimals : token1Decimals;
+        if (bps >= 10000n) {
+            amountOutWei = quoteReserve;
+            amountInWei = baseReserve;
+        }
+        else {
+            const quoteReserveNew = quoteReserve * (0, clmm_depth_calculator_1.bigIntSqrt)((10000n - bps) * PRECISION) / (0, clmm_depth_calculator_1.bigIntSqrt)(10000n * PRECISION);
+            const baseReserveNew = baseReserve * (0, clmm_depth_calculator_1.bigIntSqrt)(10000n * PRECISION) / (0, clmm_depth_calculator_1.bigIntSqrt)((10000n - bps) * PRECISION);
+            amountOutWei = quoteReserve - quoteReserveNew;
+            amountInWei = baseReserveNew - baseReserve;
+        }
+    }
+    const amountOut = Number(amountOutWei) / Math.pow(10, outputDecimals);
+    const amountIn = Number(amountInWei) / Math.pow(10, inputDecimals);
+    const baseDec = baseIsToken0 ? token0Decimals : token1Decimals;
+    const quoteDec = baseIsToken0 ? token1Decimals : token0Decimals;
+    const baseReserveUi = Number(baseIsToken0 ? R0 : R1) / Math.pow(10, baseDec);
+    const quoteReserveUi = Number(baseIsToken0 ? R1 : R0) / Math.pow(10, quoteDec);
+    const midPrice = quoteReserveUi / baseReserveUi;
+    const bpsNum = Number(targetBps);
+    const targetPrice = isBuy
+        ? midPrice * (10000 + bpsNum) / 10000
+        : midPrice * (10000 - bpsNum) / 10000;
+    return { amountOutWei, amountOut, outputDecimals, amountInWei, amountIn, inputDecimals, targetPrice };
+}

package/dist/quote/depth/clmm_depth_calculator.d.ts

@@ -0,0 +1,28 @@
+import { ClmmTickCache } from '../tick/clmm_tick_cache';
+declare function getSqrtRatioAtTick(tick: number): bigint;
+export interface ClmmDepthInput {
+    poolAddress: string;
+    tickCache: ClmmTickCache;
+    currentTick: number;
+    sqrtPriceX96: string;
+    liquidity: string;
+    tickSpacing: number;
+    zeroForOne: boolean;
+    targetBps: number;
+    inputDecimals: number;
+    outputDecimals: number;
+}
+export interface DepthResult {
+    amountInWei: bigint;
+    amountIn: number;
+    amountOutWei: bigint;
+    amountOut: number;
+    currentTick: number;
+    targetTick: number;
+    targetSqrtPriceX96: bigint;
+}
+export declare function calculateClmmDepth(input: ClmmDepthInput): DepthResult;
+export declare function priceFromSqrtX96(sqrtPriceX96: bigint, baseDecimals: number, quoteDecimals: number, baseIsToken0: boolean): number;
+declare function computeTargetSqrtPrice(currentSqrtPriceX96: bigint, bps: number, zeroForOne: boolean): bigint;
+declare function bigIntSqrt(n: bigint): bigint;
+export { getSqrtRatioAtTick, computeTargetSqrtPrice, bigIntSqrt };