@clonegod/ttd-sol-common 2.0.78 → 2.0.80

package/dist/quote/abstract_dex_quote.d.ts

@@ -50,7 +50,8 @@ export declare abstract class AbstractDexQuote<C extends SolanaChainOps = Solana
     protected calculateDepth(_poolInfo: StandardPoolInfoType, _poolAddress: string, _priceMap: Map<string, {
         price: string;
     } | undefined>): Promise<QuoteDepthOutput | undefined>;
-    protected readonly feeInVault: boolean;
+    protected getEffectiveFeeBps(poolInfo: StandardPoolInfoType): number;
+    protected getOutOfVaultFeeBps(_poolInfo: StandardPoolInfoType): number;
     protected isStateConsistentForQuote(_poolInfo: StandardPoolInfoType): boolean;
     protected accountSlots: Map<string, number>;
     protected recordAccountSlot(accountAddr: string, slot: number): void;

package/dist/quote/abstract_dex_quote.js

@@ -15,13 +15,14 @@ class AbstractDexQuote {
         this.latestBlockSlot = 0;
         this.MIN_QUOTE_INTERVAL_MS = Math.max(3000, parseInt(process.env.MIN_QUOTE_INTERVAL_MS || '10000', 10) || 10000);
         this.consistencyPolicy = 'snapshot';
-        this.feeInVault = true;
         this.accountSlots = new Map();
         this.appConfig = appConfig;
         this.chain = chain;
     }
     async refreshStateFromEvent(_poolInfo, _evt) { }
     async calculateDepth(_poolInfo, _poolAddress, _priceMap) { return undefined; }
+    getEffectiveFeeBps(poolInfo) { return Number(poolInfo.fee_rate) || 0; }
+    getOutOfVaultFeeBps(_poolInfo) { return 0; }
     isStateConsistentForQuote(_poolInfo) { return true; }
     recordAccountSlot(accountAddr, slot) {
         this.accountSlots.set(accountAddr, slot);
@@ -72,8 +73,7 @@ class AbstractDexQuote {
             token1Decimals: Number(poolInfo.tokenB?.decimals ?? 0),
             poolInfo: { tokenA: poolInfo.tokenA, tokenB: poolInfo.tokenB, quote_token: poolInfo.quote_token },
             swapperDeltaConvention: false,
-            feeExclusiveExec: !this.feeInVault,
-            feeRateBps: poolInfo.fee_rate,
+            outOfVaultFeeBps: this.getOutOfVaultFeeBps(poolInfo),
         };
         const verifyLog = this.quotePriceVerify.checkSwap(params);
         if (verifyLog)

package/dist/quote/index.d.ts

@@ -1,5 +1,4 @@
 export * from './pricing';
-export * from './pool_subscription_registry';
 export * from './pool_event';
 export * from './chain_ops';
 export * from './abstract_dex_quote';

package/dist/quote/index.js

@@ -15,7 +15,6 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./pricing"), exports);
-__exportStar(require("./pool_subscription_registry"), exports);
 __exportStar(require("./pool_event"), exports);
 __exportStar(require("./chain_ops"), exports);
 __exportStar(require("./abstract_dex_quote"), exports);

package/dist/quote/pool_subscription_registry.js

@@ -52,11 +52,18 @@ async function attachPoolSubscriptionLifecycle(appConfig, pools) {
             + '询价进程必须由 PM2/trade-mgt 以确定进程名启动，否则订阅会被 reconcile 当孤儿清除。');
     }
     await registerPoolSubscriptions(appConfig, pools, quote_app_id);
+    const heartbeatMs = Math.max(5000, parseInt(process.env.SUBSCRIPTION_HEARTBEAT_MS || '30000', 10) || 30000);
+    const heartbeat = setInterval(() => {
+        registerPoolSubscriptions(appConfig, pools, quote_app_id)
+            .catch(e => (0, dist_1.log_warn)(`[pool/subscriptions] heartbeat re-register failed: ${e.message}`));
+    }, heartbeatMs);
+    heartbeat.unref?.();
     let cleaned = false;
     const cleanup = async (sig) => {
         if (cleaned)
             return;
         cleaned = true;
+        clearInterval(heartbeat);
         (0, dist_1.log_info)(`[pool/subscriptions] ${sig} → unregister ${quote_app_id}`);
         await unregisterPoolSubscriptions(appConfig, quote_app_id);
         process.exit(0);

package/dist/quote/verify/quote_price_verify.d.ts

@@ -16,8 +16,7 @@ export interface CheckSwapParams {
         quote_token: string;
     };
     swapperDeltaConvention?: boolean;
-    feeExclusiveExec?: boolean;
-    feeRateBps?: number;
+    outOfVaultFeeBps?: number;
 }
 export declare class QuotePriceVerify {
     private quoteCache;

package/dist/quote/verify/quote_price_verify.js

@@ -114,9 +114,6 @@ class QuotePriceVerify {
                 if (!match)
                     continue;
                 refPrice = match.tier.price;
-                if (params.feeExclusiveExec && match.tier.amount_in > 0) {
-                    refPrice = stripFeeExclusive(refPrice, isBuy, match.tier.fee / match.tier.amount_in);
-                }
                 tierInfo = {
                     matched_pct: parseFloat(match.tier.pct.toFixed(4)),
                     mode: match.mode,
@@ -127,9 +124,9 @@ class QuotePriceVerify {
             }
             else {
                 refPrice = isBuy ? cached.askPrice : cached.bidPrice;
-                if (params.feeExclusiveExec && params.feeRateBps && params.feeRateBps > 0) {
-                    refPrice = stripFeeExclusive(refPrice, isBuy, params.feeRateBps / 10000);
-                }
+            }
+            if (params.outOfVaultFeeBps && params.outOfVaultFeeBps > 0) {
+                refPrice = stripFeeExclusive(refPrice, isBuy, params.outOfVaultFeeBps / 10000);
             }
             if (refPrice <= 0)
                 continue;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clonegod/ttd-sol-common",
-  "version": "2.0.78",
+  "version": "2.0.80",
   "description": "",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/quote/abstract_dex_quote.ts

@@ -17,7 +17,7 @@ import { QuoteTrace } from './quote_trace'
 //     · 无 v3 PriceFeed（同 SUI，省 do_quote_v3）。
 //     · verify（报价偏差）走**独立的 swap-verify 通道**（非账户快照）：stream-quote 从真实交易的
 //       pre/postTokenBalances 解码订阅池子 vault Δ（DEX 无关）→ WS push → handleSwapVerify → checkSwap。
-//       exec_price = |Δquote/Δbase|（pool-side vault Δ），fee-exclusive 对账（费路由出池的 DEX 由 feeInVault=false 触发剥费）。
+//       exec_price = |Δquote/Δbase|（pool-side vault Δ），fee-exclusive 对账（费路由出池的部分由 getOutOfVaultFeeBps 提供，方向感知剥掉）。
 
 /**
  * 流动性一致性策略（设计文档 §2.2 定稿：3 订阅原型）。各 DEX 子类按协议特性声明：
@@ -114,12 +114,17 @@ export abstract class AbstractDexQuote<C extends SolanaChainOps = SolanaChainOps
     /** 深度（tier 化）；fee 来自链上 load。priceMap 由基类预取。默认 undefined（step 3 各 DEX 逐档实现）。 */
     protected async calculateDepth(_poolInfo: StandardPoolInfoType, _poolAddress: string, _priceMap: Map<string, { price: string } | undefined>): Promise<QuoteDepthOutput | undefined> { return undefined }
     /**
-     * verify 口径：池子手续费是否留在 vault 内。
-     *   - true（默认；Raydium/Orca/Meteora 等）：fee 累进储备 → vault Δ 含费 → 与含费报价同口径，不剥费。
-     *   - false（pumpswap：protocol/creator fee 路由出池到独立账户）：vault Δ 不含费 → checkSwap 把参考价剥成 fee-exclusive。
-     * 详见 quote_price_verify CheckSwapParams.feeExclusiveExec。
+     * depth gross-up 用的**总费率**（bps）。默认配置 fee_rate；动态费 DEX（pumpswap 市值档位 / DLMM 波动费）覆盖，
+     * 每事件按真实链上 feeConfig 重算 → 报价自适应费率变化。
      */
-    protected readonly feeInVault: boolean = true
+    protected getEffectiveFeeBps(poolInfo: StandardPoolInfoType): number { return Number(poolInfo.fee_rate) || 0 }
+
+    /**
+     * verify 剥费用的**出池费率**（bps）= 路由出 vault 的费（vault Δ exec 不含的部分）。
+     *   - 0（默认）：费全留池（Raydium/Orca/Meteora 等）→ vault Δ 与含费报价同口径，不剥。
+     *   - >0：pumpswap（protocol+creator，动态按市值档位）等覆盖。详见 CheckSwapParams.outOfVaultFeeBps。
+     */
+    protected getOutOfVaultFeeBps(_poolInfo: StandardPoolInfoType): number { return 0 }
 
     /**
      * slot 门控钩子（仅 consistencyPolicy='slot-gate' 生效）：判断本池"走单触碰的多账户"状态是否 slot 一致。
@@ -181,7 +186,7 @@ export abstract class AbstractDexQuote<C extends SolanaChainOps = SolanaChainOps
 
     /**
      * 消费 stream-quote 推来的 swap-verify（pool-side vault Δ）→ checkSwap 对账缓存报价 → 打 [Verify]。
-     * exec_price 由 |Δquote/Δbase| 算；fee-exclusive 口径由 feeInVault 决定（详见 CheckSwapParams.feeExclusiveExec）。
+     * exec_price 由 |Δquote/Δbase| 算；剥费用 getOutOfVaultFeeBps（详见 CheckSwapParams.outOfVaultFeeBps）。
      */
     private handleSwapVerify(sv: SolanaSwapVerifyEventData): void {
         const poolInfo = this.poolInfoMap.get(sv.pool_address)
@@ -198,9 +203,8 @@ export abstract class AbstractDexQuote<C extends SolanaChainOps = SolanaChainOps
             token0Decimals: Number(poolInfo.tokenA?.decimals ?? 0),
             token1Decimals: Number(poolInfo.tokenB?.decimals ?? 0),
             poolInfo: { tokenA: poolInfo.tokenA, tokenB: poolInfo.tokenB, quote_token: poolInfo.quote_token },
-            swapperDeltaConvention: false,            // amount0/1 是 pool-side vault Δ
-            feeExclusiveExec: !this.feeInVault,        // 费路由出池（pumpswap）→ 剥参考价的费
-            feeRateBps: poolInfo.fee_rate,             // market-data 强制整数 bps
+            swapperDeltaConvention: false,                       // amount0/1 是 pool-side vault Δ
+            outOfVaultFeeBps: this.getOutOfVaultFeeBps(poolInfo), // 出池费（默认 0=全留池不剥；pumpswap 动态）
         }
         const verifyLog = this.quotePriceVerify.checkSwap(params)
         if (verifyLog) log_info(verifyLog)

package/src/quote/index.ts

@@ -1,5 +1,4 @@
 export * from './pricing'
-export * from './pool_subscription_registry'
 export * from './pool_event'
 export * from './chain_ops'
 export * from './abstract_dex_quote'

package/src/quote/verify/quote_price_verify.ts

@@ -120,12 +120,13 @@ function pickMatchingTier(tiers: QuoteTier[], actualAmountIn: number): TierMatch
 }
 
 /**
- * 把含费报价价剥成 fee-exclusive（曲线价），与"费路由出池"DEX（pumpswap）的 vault Δ exec 同口径。
+ * 把含费报价剥成 fee-exclusive（与 vault Δ exec 同口径），r = **出池费率**（路由出 vault 的部分）。
  *
- * 关键：费总是把 ask/bid **向两侧各撑开** r（曲线价 M 在中间），方向**不对称**：
- *   - ask(买基础币) = M / (1 − r)   → ask_excl = ask × (1 − r)
- *   - bid(卖基础币) = M × (1 − r)   → bid_excl = bid / (1 − r)   ← 是除，不是乘！
- * 不论费记输入侧还是输出侧（pumpswap 实测两种都有），上式都成立（逐项核对见 session memory）。
+ * vault Δ exec 不含"出池费"（如 pumpswap 的 protocol+creator，转给独立账户），但**含**留池的 lp 费。
+ * 报价（ask/bid）是 swapper 含全费的成交价。两者差一个"出池费"，且方向**不对称**：
+ *   - ask(买基础币) = exec / (1 − r)   → ask_excl = ask × (1 − r)
+ *   - bid(卖基础币) = exec × (1 − r)   → bid_excl = bid / (1 − r)   ← 是除，不是乘！
+ * 不论出池费记输入侧还是输出侧，上式一阶成立（lp 留池的二阶项可忽略）。
  * ask/bid 同为 quote/base 口径（calculateStandardPrice），仅方向决定撑开符号。
  */
 function stripFeeExclusive(refPrice: number, isBuy: boolean, r: number): number {
@@ -157,18 +158,14 @@ export interface CheckSwapParams {
      */
     swapperDeltaConvention?: boolean;
     /**
-     * fee-exclusive 对账口径（Solana pool-side vault Δ 用）。
+     * **出池费率**（bps）= 路由出 vault 的费（pumpswap=protocol+creator，**动态**按市值档位）。
      *
-     * 背景：exec_price 由 **pool vault Δ** 算（Δquote/Δbase）。vault Δ 是否含费**因 DEX 而异**：
-     *   - 费留池内（Raydium/Orca/Meteora 等）：vault Δ 含费 → 与"含费 tier 价"同口径 → 不剥（false，默认）。
-     *   - 费路由出池（pumpswap protocol/creator fee 进独立账户）：vault Δ 不含费 → 须把参考价剥成 fee-exclusive
-     *     才与 vault Δ 同口径（否则系统性偏差≈费率）。
-     * 为 true 时：refPrice ×= (amount_in − fee)/amount_in（tier 模式，用该档自身的含费/费额）；
-     *   scalar 兜底用 (1 − feeRateBps/1e4) 一阶近似。
+     * exec_price 由 pool vault Δ 算，**不含出池费、含留池 lp 费**。报价含全费 → 两者差出池费。
+     * 故 verify 把报价按出池费剥成 vault 口径（方向感知，见 stripFeeExclusive）。
+     *   - 0 / 缺省：费全留池（Raydium/Orca/Meteora 等），vault Δ 与含费报价同口径 → 不剥。
+     *   - >0：pumpswap 等，DEX 子类经 getOutOfVaultFeeBps 动态提供（每事件按真实 feeConfig 算）。
      */
-    feeExclusiveExec?: boolean;
-    /** 池子费率（bps）；feeExclusiveExec 且 scalar 兜底（无 tier）时用作一阶剥费因子。 */
-    feeRateBps?: number;
+    outOfVaultFeeBps?: number;
 }
 
 // ========== 主类 ==========
@@ -303,11 +300,6 @@ export class QuotePriceVerify {
                 const match = pickMatchingTier(tiers, swapData.inputAmountUi);
                 if (!match) continue;
                 refPrice = match.tier.price;
-                // fee-exclusive 对账：把含费 tier 价剥成 fee-exclusive，与 fee-out-of-vault DEX（pumpswap）的 vault Δ 同口径。
-                // r = 该档费率（fee/amount_in，amount_in 含费）。
-                if (params.feeExclusiveExec && match.tier.amount_in > 0) {
-                    refPrice = stripFeeExclusive(refPrice, isBuy, match.tier.fee / match.tier.amount_in);
-                }
                 tierInfo = {
                     matched_pct: parseFloat(match.tier.pct.toFixed(4)),
                     mode: match.mode,
@@ -318,10 +310,12 @@ export class QuotePriceVerify {
             } else {
                 // scalar fallback：旧 DEX 包未传 tiers 时使用
                 refPrice = isBuy ? cached.askPrice : cached.bidPrice;
-                // scalar 无 tier 费额 → 用池子费率一阶剥费（feeExclusiveExec 时）
-                if (params.feeExclusiveExec && params.feeRateBps && params.feeRateBps > 0) {
-                    refPrice = stripFeeExclusive(refPrice, isBuy, params.feeRateBps / 10000);
-                }
+            }
+
+            // fee-exclusive 对账：剥掉"出池费"（vault Δ exec 不含的部分）→ 报价与 vault Δ 同口径。
+            // tier / scalar 统一处理：出池费是定比（与档位/大小无关），方向感知（买×卖÷）。
+            if (params.outOfVaultFeeBps && params.outOfVaultFeeBps > 0) {
+                refPrice = stripFeeExclusive(refPrice, isBuy, params.outOfVaultFeeBps / 10000);
             }
 
             if (refPrice <= 0) continue;

package/src/quote/pool_subscription_registry.ts

@@ -1,87 +0,0 @@
-import { AppConfig, HttpUtil, log_info, log_warn, SERVICE_PORT, StandardPoolInfoType } from '@clonegod/ttd-core/dist'
-import { resolveGrpcProvider } from '../grpc/grpc_provider_registry'
-
-/**
- * 按需订阅 —— 生产端（询价进程调用）。对齐 BSC/BASE/SUI：询价进程通过 config-center 声明所需池子，
- * config-center 写 `${chain}:pool:subscriptions` Hash + 广播 `:change`，stream-quote 消费后订阅 Helius。
- *
- * Solana 适配（与 BSC 的差异）：
- *  - **单 Helius provider，且对齐 SUI 由运维在 analyze Config/RPC 页配（type=grpc, endpoint=laserstream URL, auth_token=API key）**。
- *    本 helper **不自动种 provider**；register 用 `resolveGrpcProvider` 解析出 analyze 配的 provider id（无配 fail-loud）。
- *  - **base58 地址大小写敏感**：依赖 config-center `lower()` 已改为 0x 感知（非 0x 原样保留），不破坏地址。
- */
-
-function configCenterBase(appConfig: AppConfig): string {
-    const chain = appConfig.env_args.chain_id // SOLANA
-    let host = String(appConfig.env_args.config_center_host || '127.0.0.1').trim()
-    // host 可能含端口(127.0.0.1:4000)或不含(127.0.0.1)；不含则补 CONFIG_CENTER_HTTP
-    if (!host.includes(':')) host = `${host}:${SERVICE_PORT.CONFIG_CENTER_HTTP}`
-    return `http://${host}/${chain}/config`
-}
-
-/** 注册一批池子订阅（每池 POST config-center /quote/register），provider_ids 用 analyze 配的 grpc provider。 */
-export async function registerPoolSubscriptions(
-    appConfig: AppConfig,
-    pools: StandardPoolInfoType[],
-    quote_app_id: string,
-): Promise<void> {
-    // provider 由运维在 analyze Config/RPC 配（type=grpc）；解析其 id 供 register 引用，无配 fail-loud
-    const provider = await resolveGrpcProvider(appConfig.arb_cache.redis_cmd, appConfig.env_args.chain_id)
-    const provider_ids = [provider.id]
-
-    const base = configCenterBase(appConfig)
-    let ok = 0
-    for (const p of pools) {
-        try {
-            await HttpUtil.post(`${base}/quote/register`, {
-                pool_address: p.pool_address,
-                provider_ids,
-                quote_app_id,
-                pair: p.pair,
-                dex_id: p.dex_id,
-                pool_name: p.pool_name,
-                fee_rate: p.fee_rate,
-            })
-            ok++
-        } catch (e: any) {
-            log_warn(`[pool/subscriptions] register ${p.pool_address} failed: ${e.message}`)
-        }
-    }
-    log_info(`[pool/subscriptions] registered ${ok}/${pools.length} pools by ${quote_app_id} → provider=${provider.id}`)
-}
-
-/** 注销本进程注册的所有池子订阅（按 quote_app_id）。 */
-export async function unregisterPoolSubscriptions(appConfig: AppConfig, quote_app_id: string): Promise<void> {
-    try {
-        await HttpUtil.post(`${configCenterBase(appConfig)}/quote/unregister`, { quote_app_id })
-        log_info(`[pool/subscriptions] unregistered all pools by ${quote_app_id}`)
-    } catch (e: any) {
-        log_warn(`[pool/subscriptions] unregister failed: ${e.message}`)
-    }
-}
-
-/**
- * 询价进程启动后调用一次：确保 helius provider + 注册全部池子 + 装退出时自动 unregister。
- * quote_app_id **必须 = PM2 进程名**（pm2 注入 process.env.name），与 trade-mgt register/reconcile 用的 app_id 一致。
- * 否则 trade-mgt 的 60s reconcile 按 PM2 进程名核对，会把本进程自注册的订阅当"孤儿"注销 → 订阅消失、收不到事件。
- * **取不到则 fail-loud（绝不兜底）**：塌成 'sol-quote' 这类 PM2 里不存在的名字 = 必被 reconcile 清掉，等于没注册还掩盖问题。
- */
-export async function attachPoolSubscriptionLifecycle(appConfig: AppConfig, pools: StandardPoolInfoType[]): Promise<void> {
-    const quote_app_id = process.env.name || String(appConfig.env_args.app_name || '')
-    if (!quote_app_id) {
-        throw new Error('[pool/subscriptions] 无法确定 quote_app_id：process.env.name(PM2 进程名) 与 APP_NAME 均为空。'
-            + '询价进程必须由 PM2/trade-mgt 以确定进程名启动，否则订阅会被 reconcile 当孤儿清除。')
-    }
-    await registerPoolSubscriptions(appConfig, pools, quote_app_id)
-
-    let cleaned = false
-    const cleanup = async (sig: string) => {
-        if (cleaned) return
-        cleaned = true
-        log_info(`[pool/subscriptions] ${sig} → unregister ${quote_app_id}`)
-        await unregisterPoolSubscriptions(appConfig, quote_app_id)
-        process.exit(0)
-    }
-    process.on('SIGINT', () => void cleanup('SIGINT'))
-    process.on('SIGTERM', () => void cleanup('SIGTERM'))
-}