@clonegod/ttd-sol-common 2.0.81 → 2.0.83

package/dist/trade/abstract_dex_trade.d.ts

@@ -3,7 +3,7 @@ import { TransactionInstruction } from '@solana/web3.js';
 import { SolTransactionBuilder } from './tx_builder';
 export declare abstract class AbstractSolDexTrade<Q extends QuoteResultType = QuoteResultType> extends AbastrcatTrade {
     abstract txBuilder: SolTransactionBuilder;
-    protected abstract getQuoteResult(context: TradeContext): Promise<Q> | Q;
+    protected abstract prepareSwapParams(context: TradeContext): Promise<Q> | Q;
     protected abstract createSwapInstructions(context: TradeContext, quote_result: Q): Promise<TransactionInstruction[]>;
     execute(context: TradeContext): Promise<string>;
 }

package/dist/trade/abstract_dex_trade.js

@@ -17,10 +17,10 @@ class AbstractSolDexTrade extends dist_1.AbastrcatTrade {
         trace.set('order_id', order_msg.unique_order_msg_id);
         trace.set('amount', order_msg.amount);
         trace.set('slippage', `${slippage_bps / 100}%`);
-        let stage = 'quote';
+        let stage = 'prepare';
         try {
-            const quote_result = await this.getQuoteResult(context);
-            trace.mark('quote');
+            const quote_result = await this.prepareSwapParams(context);
+            trace.mark('prepare');
             trace.set('exec_price', quote_result.price);
             stage = 'encode';
             const swapIxs = await this.createSwapInstructions(context, quote_result);

package/package.json

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

package/src/trade/abstract_dex_trade.ts

@@ -9,21 +9,22 @@ import { TransactionSender } from './send'
  * AbstractSolDexTrade —— Solana 交易执行基类（对齐 BSC/BASE 的 abstract_dex_trade）。
  *
  * 共享一套交易热路径 + TradeTrace 打点（一处维护，8 个 DEX 共用），DEX 只实现两个差异点：
- *   - getQuoteResult：重新询价，拿 exec 用的 quote_result（可同步可异步）。
- *   - createSwapInstructions：组装这笔 swap 的指令（内部自取 poolData / account / 0-RPC 组装）。
+ *   - prepareSwapParams：按订单算 swap 参数（amountIn/amountOutMin 滑点下限/amountInMax）。**不是询价** ——
+ *     价格随订单 order_msg.price 而来（询价进程早算好），trade 信任它，纯算术、无 RPC。
+ *   - createSwapInstructions：组装这笔 swap 的指令（内部自取 poolData / account / 0-RPC；CLMM 的真 tick 模拟在这）。
  *
- * 流程（SOL 模型，非 EVM）：recv → quote → encode → build(签名) → sent(Helius Sender 发出，fire-and-forget；
+ * 流程（SOL 模型，非 EVM）：recv → prepare → encode → build(签名) → sent(Helius Sender 发出，fire-and-forget；
  *   结果走 tx_result_check 异步回来)。无 nonce / caller。
  *
- * 输出对齐 BSC：成功 `[TRADE OK] <id> | pair dir { timeline: recv -> quote(Xms) -> encode -> build -> sent = N ms, ... }`，
+ * 输出对齐 BSC：成功 `[TRADE OK] <id> | pair dir { timeline: recv -> prepare(Xms) -> encode -> build -> sent = N ms, ... }`，
  *   失败 `[TRADE FAILED] ... stage=<阶段> | <错误>`。
  */
 export abstract class AbstractSolDexTrade<Q extends QuoteResultType = QuoteResultType> extends AbastrcatTrade {
     /** DEX 子类持有（构造时 new SolTransactionBuilder(appConfig)）；基类只调用 buildTransactionForSwap。 */
     abstract txBuilder: SolTransactionBuilder
 
-    /** DEX 实现：重新询价（exec 用）。Q 允许 DEX 用自己的 quote_result 子类型（如 PumfunQuoteResultType）。 */
-    protected abstract getQuoteResult(context: TradeContext): Promise<Q> | Q
+    /** DEX 实现：按订单算 swap 参数（amountIn/minOut/滑点边界）。**非询价**，纯算术。Q 允许 DEX 用自己的子类型（如 PumfunQuoteResultType）。 */
+    protected abstract prepareSwapParams(context: TradeContext): Promise<Q> | Q
     /** DEX 实现：组装 swap 指令（内部自取 poolData / 0-RPC）。返回指令数组。 */
     protected abstract createSwapInstructions(context: TradeContext, quote_result: Q): Promise<TransactionInstruction[]>
 
@@ -37,10 +38,10 @@ export abstract class AbstractSolDexTrade<Q extends QuoteResultType = QuoteResul
         trace.set('amount', order_msg.amount)
         trace.set('slippage', `${slippage_bps / 100}%`)
 
-        let stage = 'quote'
+        let stage = 'prepare'
         try {
-            const quote_result = await this.getQuoteResult(context)
-            trace.mark('quote')
+            const quote_result = await this.prepareSwapParams(context)
+            trace.mark('prepare')
             trace.set('exec_price', quote_result.price)
 
             stage = 'encode'