@clonegod/ttd-sol-common 2.0.78 → 2.0.79

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/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.79",
   "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/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;