@clonegod/ttd-core 3.1.23 → 3.1.25

package/dist/alert/codes.js

@@ -16,6 +16,7 @@ exports.ALERT_CODES = {
     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: '询价间隔超出预期' },
+    QUOTE_PRICE_CACHE_MISS: { code: 'QUOTE_PRICE_CACHE_MISS', severity: S.WARN, category: 'quote', desc: 'token 在系统里但 cache 无价（scheduler 未刷到）', suggested_action: '观察 market-data TokenPriceSyncer 是否正常' },
     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: {

package/dist/alert/log_rules.js

@@ -45,6 +45,7 @@ registerLogRules([
         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: /price cache miss/i, level: 'warn', code: 'QUOTE_PRICE_CACHE_MISS' },
     { 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' },

package/dist/app_config/AppConfig.d.ts

@@ -1,5 +1,5 @@
 import EventEmitter from "events";
-import { StandardTokenInfoType, TradeRuntimeType } from "../../types";
+import { TradeRuntimeType } from "../../types";
 import { ArbCache, ArbEventSubscriber } from "../cache";
 import { EnvArgs } from "./EnvArgs";
 export declare class AppConfig extends EventEmitter {
@@ -11,6 +11,4 @@ export declare class AppConfig extends EventEmitter {
     constructor();
     init(): Promise<void>;
     subscribe_config_change(): Promise<void>;
-    cache_token_market_price(token_info_with_price: StandardTokenInfoType, ttl?: number): Promise<void>;
-    get_token_market_price(symbol: string): Promise<StandardTokenInfoType>;
 }

package/dist/app_config/AppConfig.js

@@ -15,13 +15,11 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.AppConfig = void 0;
 const events_1 = __importDefault(require("events"));
 const __1 = require("..");
-const EnvArgs_1 = require("./EnvArgs");
 const core_env_1 = require("./core_env");
 class AppConfig extends events_1.default {
     constructor() {
         super();
-        this.env_args = new EnvArgs_1.EnvArgs();
-        (0, core_env_1.setCoreEnv)(this.env_args);
+        this.env_args = (0, core_env_1.getCoreEnv)();
         let { chain_id, app_name, dex_id } = this.env_args;
         this.app_full_name = `${chain_id}_${dex_id}_${app_name}`;
         global.app_config = this;
@@ -49,16 +47,5 @@ class AppConfig extends events_1.default {
             yield this.arb_event_subscriber.subscribe_config_change_event(refresh_trade_runtime);
         });
     }
-    cache_token_market_price(token_info_with_price_1) {
-        return __awaiter(this, arguments, void 0, function* (token_info_with_price, ttl = -1) {
-            token_info_with_price.update_time = (0, __1.getCurDateTime)();
-            yield this.arb_cache.cache_token_market_price(token_info_with_price, ttl);
-        });
-    }
-    get_token_market_price(symbol) {
-        return __awaiter(this, void 0, void 0, function* () {
-            return yield this.arb_cache.get_token_market_price(symbol);
-        });
-    }
 }
 exports.AppConfig = AppConfig;

package/dist/app_config/EnvArgs.d.ts

@@ -10,6 +10,7 @@ export declare class EnvArgs {
     redis_host: string;
     redis_port: string;
     config_center_host: string;
+    market_data_host: string;
     enable_init_cache: string;
     trade_analyze_url: string;
     trade_analyze_host: string;
@@ -31,7 +32,7 @@ export declare class EnvArgs {
     trade_pair: string;
     trade_log_report_cex_url: string;
     trade_log_report_cex_data_type: string;
-    token_price_cache_seconds: number;
+    token_price_refresh_interval_seconds: number;
     token_market_price_url: string;
     wallet_dir: string;
     encryption_key: string;

package/dist/app_config/env_registry.js

@@ -24,6 +24,7 @@ registerEnvVars({
     grpc_endpoint: { env: 'GRPC_ENDPOINT', type: 'string', default: '', desc: 'gRPC 端点' },
     grpc_token: { env: 'GRPC_TOKEN', type: 'string', default: '', sensitive: true, desc: 'gRPC 认证 token' },
     config_center_host: { env: 'CONFIG_CENTER_HOST', type: 'string', default: '127.0.0.1', desc: '配置中心' },
+    market_data_host: { env: 'MARKET_DATA_HOST', type: 'string', default: '127.0.0.1', desc: 'market-data 服务（L3 现查 / fetch-pool 调用）' },
     enable_init_cache: { env: 'ENABLE_INIT_CACHE', type: 'string', default: '', desc: '仅 config-center：是否初始化缓存（空或 true 视为启用；false 则跳过）' },
     trade_analyze_host: { env: 'TRADE_ANALYZE_HOST', type: 'string', default: '', desc: 'analyze 上报地址(IP)；为空则不上报' },
     auto_quote_enable: { env: 'AUTO_QUOTE_ENABLE', type: 'boolean', default: false, desc: '自动报价开关' },
@@ -44,7 +45,7 @@ registerEnvVars({
     encryption_key: { env: 'ENCRYPTION_KEY', type: 'string', default: '', sensitive: true, desc: '对称加密密钥（用于钱包文件等）' },
     trade_analyze_url: { env: 'TRADE_ANALYZE_URL', type: 'string', default: '', desc: 'analyze HTTP 基址（旧 EnvArgs；未配则 analyze 上报走默认拼接）' },
     providers_file_path: { env: 'PROVIDERS_FILE_PATH', type: 'string', default: '', desc: 'stream-quote providers.json 绝对路径；留空则仅写 Redis' },
-    token_price_cache_seconds: { env: 'TOKEN_PRICE_CACHE_SECONDS', type: 'number', default: 1200, desc: 'token 价格缓存时间(s)' },
+    token_price_refresh_interval_seconds: { env: 'TOKEN_PRICE_REFRESH_INTERVAL_SECONDS', type: 'number', default: 600, desc: 'TokenPriceSyncer 刷价周期(s)：market-data 拉价并推送给 config-center 写 token_list 的频率' },
     token_market_price_url: { env: 'TOKEN_MARKET_PRICE_URL', type: 'string', default: '', desc: '【使用方: ttd-core estimate_token_amount】config-center 市价估算 HTTP 基址；为空则跳过远程回退' },
     fixed_symbol_address_file: { env: 'FIXED_SYMBOL_ADDRESS_FILE', type: 'string', default: '', desc: '固定 symbol/address 映射文件路径（覆盖默认按 CHAIN_ID 推断的路径）' },
     zh_pinyin_map_file: { env: 'ZH_PINYIN_MAP_FILE', type: 'string', default: '', desc: '中文拼音映射文件路径（覆盖默认路径）' },

package/dist/cache/arb_cache.d.ts

@@ -51,8 +51,7 @@ export declare class ArbCache {
     create_trade_runtime(chain_id: string, group_id: string, dex_id: string, pair_name: string): Promise<TradeRuntimeType>;
     find_pair_in_trade_config(pair_name: string, trade_config: TradeServiceConfigType): TradePairType;
     find_pair_dex_in_trade_config(dex_id: string, pair_config: TradePairType): TradePairDexPoolsType;
-    cache_token_market_price(token_with_price: StandardTokenInfoType, ttl?: number): Promise<void>;
-    get_token_market_price(symbol: string): Promise<StandardTokenInfoType>;
+    update_token_prices(input_tokens: StandardTokenInfoType[]): Promise<number>;
     cache_price_message(price_msg: PriceMessageType, ttl?: number): Promise<void>;
     get_price_message(price_id: string): Promise<PriceMessageType>;
     cache_order_message(order_msg: OrderMessageType, ttl?: number): Promise<{

package/dist/cache/arb_cache.js

@@ -81,18 +81,40 @@ class ArbCache {
         return path_1.default.join('config', chain_id, file_name);
     }
     refresh_local_cache_token_list(token_list) {
-        this.token_list = token_list;
+        const new_by_addr = new Map();
+        const merged = [];
+        for (const fresh of token_list) {
+            new_by_addr.set(fresh.address, fresh);
+        }
+        const to_delete_addr = [];
+        for (const [addr, existing] of this.token_address_map) {
+            const fresh = new_by_addr.get(addr);
+            if (fresh) {
+                Object.assign(existing, fresh);
+                merged.push(existing);
+                new_by_addr.delete(addr);
+            }
+            else {
+                to_delete_addr.push(addr);
+            }
+        }
+        for (const addr of to_delete_addr) {
+            this.token_address_map.delete(addr);
+        }
+        for (const fresh of new_by_addr.values()) {
+            this.token_address_map.set(fresh.address, fresh);
+            merged.push(fresh);
+        }
         this.token_symbol_map.clear();
-        this.token_address_map.clear();
-        for (let token of token_list) {
+        for (const token of merged) {
             this.token_symbol_map.set(token.symbol, token);
-            this.token_address_map.set(token.address, token);
         }
+        this.token_list = merged;
         this.token_list_cache_last_update_time = (0, index_1.getCurDateTime)();
         (0, index_1.log_trace)('refresh_local_cache_token_list, success', {
             token_list_len: this.token_list.length,
             token_symbol_map_size: this.token_symbol_map.size,
-            token_address_map_szie: this.token_address_map.size
+            token_address_map_szie: this.token_address_map.size,
         });
     }
     refresh_local_cache_pool_list(pool_list) {
@@ -141,9 +163,6 @@ class ArbCache {
                 if (index_1.LOG.debug) {
                     (0, index_1.log_trace)(`cache_token_list, symbol=${field}, result: ` + JSON.stringify(result));
                 }
-                if (token.market_price) {
-                    this.cache_token_market_price(token, -1);
-                }
             }
             this.refresh_local_cache_token_list(token_list);
             let result = yield this.loading_cache.hlen(this.chain_id, index_1.CACHE_KEY_TYPE.CONFIG_TOKEN_LIST);
@@ -644,36 +663,26 @@ class ArbCache {
         let pair_dex_config = pair_config.dex_list.find(e => e.dex_id === dex_id);
         return pair_dex_config;
     }
-    cache_token_market_price(token_with_price_1) {
-        return __awaiter(this, arguments, void 0, function* (token_with_price, ttl = -1) {
-            (0, index_1.log_trace)(`cache_market_price, start`);
-            if ((0, index_1.isEmpty)(token_with_price.market_price)) {
-                (0, index_1.log_warn)(`cache_token_market_price skip: empty market_price, symbol=${token_with_price.symbol}, address=${token_with_price.address}`);
-                return;
-            }
-            let { symbol } = token_with_price;
-            let field = (0, index_1.format_symbol_name)(symbol);
-            let value = JSON.stringify(token_with_price);
-            let result = yield this.loading_cache.hset_ex(this.chain_id, index_1.CACHE_KEY_TYPE.MARKET_TOKEN_PRICE, field, value, ttl);
-            (0, index_1.log_trace)('cache_market_price, end', result);
-        });
-    }
-    get_token_market_price(symbol) {
+    update_token_prices(input_tokens) {
         return __awaiter(this, void 0, void 0, function* () {
-            try {
-                let id = (0, index_1.format_symbol_name)(symbol);
-                let res = yield this.loading_cache.hget(this.chain_id, index_1.CACHE_KEY_TYPE.MARKET_TOKEN_PRICE, id);
-                if (index_1.LOG.debug) {
-                    (0, index_1.log_trace)(`get_token_market_price, symbol=${symbol}, res=`, res);
-                }
-                let { key, field, value } = res;
-                let token_with_price = JSON.parse(value);
-                return token_with_price;
-            }
-            catch (err) {
-                (0, index_1.log_error)('get_token_market_price error!!! key expired ???', err);
-                throw new Error(`get_token_market_price error! err=${err.message}`);
-            }
+            if ((0, index_1.isEmpty)(input_tokens))
+                return 0;
+            let count = 0;
+            for (const token of input_tokens) {
+                if (!(token === null || token === void 0 ? void 0 : token.symbol) || (0, index_1.isEmpty)(token.market_price))
+                    continue;
+                const field = (0, index_1.format_symbol_name)(token.symbol);
+                yield this.loading_cache.hset(this.chain_id, index_1.CACHE_KEY_TYPE.CONFIG_TOKEN_LIST, field, JSON.stringify(token));
+                count++;
+            }
+            if (count > 0) {
+                yield this.redis_event_publisher.publish_config_change_event({
+                    event_type: index_1.REDIS_EVENT_TYPE_CONFIG_CHANGE.TOKEN_CONFIG_CHANGE,
+                    event_time: Date.now(),
+                });
+            }
+            (0, index_1.log_trace)(`update_token_prices, end. count=${count}`);
+            return count;
         });
     }
     cache_price_message(price_msg_1) {

package/dist/index.d.ts

@@ -115,7 +115,6 @@ export declare enum OnChainDataSubscribeType {
     GRPC = "grpc"
 }
 export declare enum CACHE_KEY_TYPE {
-    MARKET_TOKEN_PRICE = "m:price",
     CONFIG_TOKEN_LIST = "c:token",
     CONFIG_POOL_LIST = "c:pool",
     CONFIG_PAIR_LIST = "c:pair",

package/dist/index.js

@@ -207,7 +207,6 @@ var OnChainDataSubscribeType;
 })(OnChainDataSubscribeType || (exports.OnChainDataSubscribeType = OnChainDataSubscribeType = {}));
 var CACHE_KEY_TYPE;
 (function (CACHE_KEY_TYPE) {
-    CACHE_KEY_TYPE["MARKET_TOKEN_PRICE"] = "m:price";
     CACHE_KEY_TYPE["CONFIG_TOKEN_LIST"] = "c:token";
     CACHE_KEY_TYPE["CONFIG_POOL_LIST"] = "c:pool";
     CACHE_KEY_TYPE["CONFIG_PAIR_LIST"] = "c:pair";

package/dist/market_price/estimate_token_amount.js

@@ -61,12 +61,12 @@ class EstimateAmountInToken {
                 }
                 else {
                     if (index_1.LOG.debug) {
-                        (0, index_1.log_debug)(`try-2 get market price from remote cache`);
+                        (0, index_1.log_debug)(`try-2 get market price from in-memory token_address_map`);
                     }
-                    token_info = yield arb_cache.get_token_market_price(symbol);
+                    token_info = arb_cache.token_symbol_map.get(symbol);
                     set_tmp_market_price(token_info);
                     if (index_1.LOG.debug) {
-                        (0, index_1.log_debug)(`try-2 get market price from remote cache, res=`, token_info);
+                        (0, index_1.log_debug)(`try-2 get market price from in-memory map, res=`, token_info);
                     }
                 }
                 let market_price = token_info === null || token_info === void 0 ? void 0 : token_info.market_price;

package/dist/pool/cache_pool_config.js

@@ -24,63 +24,55 @@ const cache_pool_config = (chain_id, valid_tokens_map, sol_pools_cache) => __awa
     let skip_pool_list = [];
     const genv = (0, core_env_1.getCoreEnv)();
     const ccBase = `http://${(genv.config_center_host || '127.0.0.1').trim()}:${service_ports_1.SERVICE_PORT.CONFIG_CENTER_HTTP}/${chain_id}/config`;
-    let config_pool_url = `${ccBase}/pools`;
-    for (let [dex_id, pool_list] of sol_pools_cache) {
-        let batch_pools = (0, index_1.chunkArray)(pool_list, 10);
-        for (let one_pool_list of batch_pools) {
-            let valid_pool_list = [];
-            for (let pool of one_pool_list) {
-                let is_contains_unkown_symbol = !valid_tokens_map.has(pool.tokenA.symbol) || !valid_tokens_map.has(pool.tokenB.symbol);
-                if (is_contains_unkown_symbol || (0, is_not_arb_token_1.is_not_arb_token)(pool.pool_name)) {
-                    skip_pool_list.push(pool);
-                    continue;
-                }
-                let std_pool = {
-                    program_id: pool.program_id,
-                    authority: pool.authority,
-                    subscribe_type: 'grpc',
-                    pair: pool.pair,
-                    dex_id: dex_id,
-                    pool_name: pool.pool_name,
-                    pool_address: pool.pool_address,
-                    pool_address_hex: '',
-                    tokenA: null,
-                    tokenB: null,
-                    vaultA: pool.vaultA,
-                    vaultB: pool.vaultB,
-                    subscribe_vault_change: pool.subscribe_vault_change,
-                    router_id: null,
-                    fee_rate: pool.fee_rate_bps,
-                    quote_token: pool.quote_token,
-                    quote_amount_usd: genv.quote_amount_usd,
-                    quote_price_decimals: 18,
-                    is_reverse_token: null,
-                    cu_limit: get_cu_limit(dex_id),
-                    tvl: pool.tvl,
-                    vol_24h: pool.vol_24h,
-                    update_time: (0, index_1.getCurDateTime)(),
-                    is_trade_native_token: pool.is_trade_native_token,
-                    enable: true,
-                };
-                valid_pool_list.push(std_pool);
-                count = count + 1;
-            }
-            if (valid_pool_list.length === 0) {
+    const config_pool_url = `${ccBase}/pools`;
+    const body = [];
+    for (const [dex_id, pool_list] of sol_pools_cache) {
+        const valid_pool_list = [];
+        for (const pool of pool_list) {
+            const is_contains_unkown_symbol = !valid_tokens_map.has(pool.tokenA.symbol) || !valid_tokens_map.has(pool.tokenB.symbol);
+            if (is_contains_unkown_symbol || (0, is_not_arb_token_1.is_not_arb_token)(pool.pool_name)) {
+                skip_pool_list.push(pool);
                 continue;
             }
-            let body = [
-                {
-                    dex_id: dex_id,
-                    pool_list: valid_pool_list
-                }
-            ];
-            const res = (yield axios_1.default.post(config_pool_url, body, {
-                headers: { 'Content-Type': 'application/json' }
-            })).data;
-            (0, index_1.log_trace)('cache_pool_config, res', res);
-            yield (0, index_1.sleep)(200);
+            valid_pool_list.push({
+                program_id: pool.program_id,
+                authority: pool.authority,
+                subscribe_type: 'grpc',
+                pair: pool.pair,
+                dex_id,
+                pool_name: pool.pool_name,
+                pool_address: pool.pool_address,
+                pool_address_hex: '',
+                tokenA: null,
+                tokenB: null,
+                vaultA: pool.vaultA,
+                vaultB: pool.vaultB,
+                subscribe_vault_change: pool.subscribe_vault_change,
+                router_id: null,
+                fee_rate: pool.fee_rate_bps,
+                quote_token: pool.quote_token,
+                quote_amount_usd: genv.quote_amount_usd,
+                quote_price_decimals: 18,
+                is_reverse_token: null,
+                cu_limit: get_cu_limit(dex_id),
+                tvl: pool.tvl,
+                vol_24h: pool.vol_24h,
+                update_time: (0, index_1.getCurDateTime)(),
+                is_trade_native_token: pool.is_trade_native_token,
+                enable: true,
+            });
+            count = count + 1;
+        }
+        if (valid_pool_list.length > 0) {
+            body.push({ dex_id, pool_list: valid_pool_list });
         }
     }
+    if (body.length > 0) {
+        const res = (yield axios_1.default.post(config_pool_url, body, {
+            headers: { 'Content-Type': 'application/json' },
+        })).data;
+        (0, index_1.log_trace)('cache_pool_config, res', res);
+    }
     (0, index_1.log_info)(`cache_pool_config finished! sync pool count:${count}, skip: ${skip_pool_list.length}`);
     skip_pool_list.sort((a, b) => a.pair.localeCompare(b.pair));
     (0, index_1.writeFile)(`dist/${chain_id.toLowerCase()}_skip_pool_list.json`, JSON.stringify({

package/dist/token/cache_token_config.js

@@ -22,46 +22,35 @@ const cache_token_config = (chain_id, valid_tokens_map) => __awaiter(void 0, voi
     (0, index_1.log_info)(`cache_token_config start`);
     const genv = (0, core_env_1.getCoreEnv)();
     const ccBase = `http://${(genv.config_center_host || '127.0.0.1').trim()}:${service_ports_1.SERVICE_PORT.CONFIG_CENTER_HTTP}/${chain_id}/config`;
-    let config_token_url = `${ccBase}/tokens`;
-    let count = 0;
-    let batch_symbols = (0, index_1.chunkArray)(Array.from(valid_tokens_map.keys()), 20);
-    for (let one_batch of batch_symbols) {
-        let valid_tokens = [];
-        for (let key of one_batch) {
-            let value = valid_tokens_map.get(key);
-            if (!value || value.length !== 1) {
-                continue;
-            }
-            let token = value[0];
-            let std_token = {
-                symbol: token.symbol,
-                address: token.address,
-                address_hex: '',
-                decimals: token.decimals,
-                name: token.name,
-                is_token2022: token.is_token_2022,
-                market_price: token.price,
-                update_time: (0, index_1.getCurDateTime)(),
-                alias: (0, index_1.get_token_symbol_alias)(token.address),
-                enable: true
-            };
-            if ((0, is_not_arb_token_1.is_not_arb_token)(std_token.symbol)) {
-                continue;
-            }
-            valid_tokens.push(std_token);
-            count += 1;
-        }
-        if (valid_tokens.length === 0) {
+    const config_token_url = `${ccBase}/tokens`;
+    const valid_tokens = [];
+    for (const [, value] of valid_tokens_map) {
+        if (!value || value.length !== 1)
             continue;
-        }
-        const body = valid_tokens;
-        const res = (yield axios_1.default.post(config_token_url, body, {
-            headers: { 'Content-Type': 'application/json' }
+        const token = value[0];
+        const std_token = {
+            symbol: token.symbol,
+            address: token.address,
+            address_hex: '',
+            decimals: token.decimals,
+            name: token.name,
+            is_token2022: token.is_token_2022,
+            market_price: token.price,
+            update_time: (0, index_1.getCurDateTime)(),
+            alias: (0, index_1.get_token_symbol_alias)(token.address),
+            enable: true,
+        };
+        if ((0, is_not_arb_token_1.is_not_arb_token)(std_token.symbol))
+            continue;
+        valid_tokens.push(std_token);
+    }
+    if (valid_tokens.length > 0) {
+        const res = (yield axios_1.default.post(config_token_url, valid_tokens, {
+            headers: { 'Content-Type': 'application/json' },
         })).data;
         (0, index_1.log_trace)('cache_token_config, res', res);
-        yield (0, index_1.sleep)(200);
     }
-    (0, index_1.log_info)(`cache_token_config finish! sync token count: ${count}`);
+    (0, index_1.log_info)(`cache_token_config finish! sync token count: ${valid_tokens.length}`);
     let notify_config_change_url = `${ccBase}/change?type=token`;
     let res = (yield axios_1.default.get(notify_config_change_url)).data;
     (0, index_1.log_info)('fetch tokens end, notify config change', {

package/dist/token/price/get_bsc_token_price.d.ts

@@ -1,2 +1,5 @@
 import { FormattedTokenPrice } from "../types";
-export declare function get_bsc_token_price_info(addresses: string[]): Promise<Map<string, FormattedTokenPrice>>;
+export type PriceSource = 'cache_only' | 'cache_first' | 'force_fetch';
+export declare function get_bsc_token_price_info(addresses: string[], opts?: {
+    source?: PriceSource;
+}): Promise<Map<string, FormattedTokenPrice>>;

package/dist/token/price/get_bsc_token_price.js

@@ -15,17 +15,19 @@ const index_1 = require("../../index");
 const defi_llama_1 = require("./defi_llama");
 const gecko_terminal_1 = require("./gecko_terminal");
 const price_cache_1 = require("./price_cache");
-function get_bsc_token_price_info(addresses) {
+function get_bsc_token_price_info(addresses, opts) {
     return __awaiter(this, void 0, void 0, function* () {
+        var _a;
+        const source = (_a = opts === null || opts === void 0 ? void 0 : opts.source) !== null && _a !== void 0 ? _a : 'cache_only';
         addresses = addresses.map(addr => addr.toLowerCase());
         const result = new Map();
-        const PRICE_CHANNELS = [
-            {
-                name: 'CachedPrice',
-                fetchFn: price_cache_1.fetchPriceFromCache,
-                batchSize: 100,
-                batchDelay: 1000,
-            },
+        const cachedChannel = {
+            name: 'CachedPrice',
+            fetchFn: price_cache_1.fetchPriceFromCache,
+            batchSize: 100,
+            batchDelay: 1000,
+        };
+        const externalChannels = [
             {
                 name: 'DefiLlama',
                 fetchFn: (address_list) => (0, defi_llama_1.fetchPriceFromDefiLlama)(index_1.CHAIN_ID.BSC, address_list),
@@ -39,6 +41,10 @@ function get_bsc_token_price_info(addresses) {
                 batchDelay: 1000,
             },
         ];
+        const PRICE_CHANNELS = source === 'cache_only' ? [cachedChannel] :
+            source === 'cache_first' ? [cachedChannel, ...externalChannels] :
+                [...externalChannels];
+        const externalHits = [];
         try {
             for (const channel of PRICE_CHANNELS) {
                 if (addresses.length === 0)
@@ -58,7 +64,7 @@ function get_bsc_token_price_info(addresses) {
                             result.set(address, priceInfo);
                             remainingAddresses = remainingAddresses.filter(addr => addr !== address);
                             if (channel.name !== 'CachedPrice') {
-                                (0, price_cache_1.cache_new_market_price)(address, priceInfo.price, channel.name);
+                                externalHits.push({ address, price: priceInfo.price, source: channel.name });
                             }
                         }
                     }
@@ -75,17 +81,26 @@ function get_bsc_token_price_info(addresses) {
                     break;
                 }
             }
-            if (result.size === 0) {
+            if (externalHits.length > 0) {
+                yield (0, price_cache_1.cache_new_market_price_batch)(externalHits);
+            }
+            if (source === 'cache_only' && addresses.length > 0) {
+                (0, price_cache_1.warnPriceCacheMiss)(addresses);
+            }
+            if (source === 'force_fetch' && result.size === 0) {
                 throw new Error(`Unable to get price information for any token: ${addresses.join(', ')}`);
             }
-            if (addresses.length > 0) {
+            if (source !== 'cache_only' && addresses.length > 0) {
                 (0, index_1.log_warn)(`[get_token_price_info] Failed to get prices for ${addresses.length} tokens after trying all channels: ${addresses.join(', ')}`);
             }
             (0, index_1.log_debug)(`[get_token_price_info] Completed price fetching for ${result.size} tokens`);
             return result;
         }
         catch (error) {
-            throw new Error(`Failed to get token price information: ${error instanceof Error ? error.message : String(error)}`);
+            if (source === 'force_fetch') {
+                throw new Error(`Failed to get token price information: ${error instanceof Error ? error.message : String(error)}`);
+            }
+            return result;
         }
     });
 }

package/dist/token/price/get_eth_token_price.d.ts

@@ -1,3 +1,6 @@
 import { EvmChainInfoType } from '../../chains';
 import { FormattedTokenPrice } from "../types";
-export declare function get_eth_token_price_info(evm_chain_info: EvmChainInfoType, addresses: string[]): Promise<Map<string, FormattedTokenPrice>>;
+import type { PriceSource } from './get_bsc_token_price';
+export declare function get_eth_token_price_info(evm_chain_info: EvmChainInfoType, addresses: string[], opts?: {
+    source?: PriceSource;
+}): Promise<Map<string, FormattedTokenPrice>>;

package/dist/token/price/get_eth_token_price.js

@@ -19,17 +19,19 @@ const index_1 = require("../../index");
 const defi_llama_1 = require("./defi_llama");
 const gecko_terminal_1 = require("./gecko_terminal");
 const price_cache_1 = require("./price_cache");
-function get_eth_token_price_info(evm_chain_info, addresses) {
+function get_eth_token_price_info(evm_chain_info, addresses, opts) {
     return __awaiter(this, void 0, void 0, function* () {
+        var _a;
+        const source = (_a = opts === null || opts === void 0 ? void 0 : opts.source) !== null && _a !== void 0 ? _a : 'cache_only';
         addresses = addresses.map(addr => addr.toLowerCase());
         const result = new Map();
-        const PRICE_CHANNELS = [
-            {
-                name: 'CachedPrice',
-                fetchFn: price_cache_1.fetchPriceFromCache,
-                batchSize: 100,
-                batchDelay: 1000,
-            },
+        const cachedChannel = {
+            name: 'CachedPrice',
+            fetchFn: price_cache_1.fetchPriceFromCache,
+            batchSize: 100,
+            batchDelay: 1000,
+        };
+        const externalChannels = [
             {
                 name: 'DefiLlama',
                 fetchFn: (address_list) => (0, defi_llama_1.fetchPriceFromDefiLlama)(evm_chain_info.chain_short_name, address_list),
@@ -49,6 +51,10 @@ function get_eth_token_price_info(evm_chain_info, addresses) {
                 batchDelay: 1000,
             },
         ];
+        const PRICE_CHANNELS = source === 'cache_only' ? [cachedChannel] :
+            source === 'cache_first' ? [cachedChannel, ...externalChannels] :
+                [...externalChannels];
+        const externalHits = [];
         try {
             for (const channel of PRICE_CHANNELS) {
                 if (addresses.length === 0)
@@ -68,7 +74,7 @@ function get_eth_token_price_info(evm_chain_info, addresses) {
                             result.set(address, priceInfo);
                             remainingAddresses = remainingAddresses.filter(addr => addr !== address);
                             if (channel.name !== 'CachedPrice') {
-                                (0, price_cache_1.cache_new_market_price)(address, priceInfo.price, channel.name);
+                                externalHits.push({ address, price: priceInfo.price, source: channel.name });
                             }
                         }
                     }
@@ -85,17 +91,26 @@ function get_eth_token_price_info(evm_chain_info, addresses) {
                     break;
                 }
             }
-            if (result.size === 0) {
+            if (externalHits.length > 0) {
+                yield (0, price_cache_1.cache_new_market_price_batch)(externalHits);
+            }
+            if (source === 'cache_only' && addresses.length > 0) {
+                (0, price_cache_1.warnPriceCacheMiss)(addresses);
+            }
+            if (source === 'force_fetch' && result.size === 0) {
                 throw new Error(`Unable to get price information for any token: ${addresses.join(', ')}`);
             }
-            if (addresses.length > 0) {
+            if (source !== 'cache_only' && addresses.length > 0) {
                 (0, index_1.log_warn)(`[get_token_price_info] Failed to get prices for ${addresses.length} tokens after trying all channels: ${addresses.join(', ')}`);
             }
             (0, index_1.log_debug)(`[get_token_price_info] Completed price fetching for ${result.size} tokens`);
             return result;
         }
         catch (error) {
-            throw new Error(`Failed to get token price information: ${error instanceof Error ? error.message : String(error)}`);
+            if (source === 'force_fetch') {
+                throw new Error(`Failed to get token price information: ${error instanceof Error ? error.message : String(error)}`);
+            }
+            return result;
         }
     });
 }

package/dist/token/price/get_solana_token_price.d.ts

@@ -1,2 +1,5 @@
 import { FormattedTokenPrice } from "../types";
-export declare function get_solana_token_price_info(addresses: string[]): Promise<Map<string, FormattedTokenPrice>>;
+import type { PriceSource } from './get_bsc_token_price';
+export declare function get_solana_token_price_info(addresses: string[], opts?: {
+    source?: PriceSource;
+}): Promise<Map<string, FormattedTokenPrice>>;