@clonegod/ttd-sol-common 2.0.85 → 2.0.86

package/dist/quote/abstract_dex_quote.js

@@ -51,9 +51,14 @@ class AbstractDexQuote {
     registerEventHandlers() {
         this.chain.subscribeNewBlock((raw) => this.handleBlockUpdateEvent(raw));
         this.chain.subscribePoolEvents(this.dexId, Array.from(this.poolInfoMap.values()), async (evt) => {
-            const bundle = await this.calculateQuote(evt);
-            if (bundle)
-                this.publishQuote(bundle);
+            try {
+                const bundle = await this.calculateQuote(evt);
+                if (bundle)
+                    this.publishQuote(bundle);
+            }
+            catch (err) {
+                (0, dist_1.log_error)(`[${this.dexId}] v2 事件处理失败 pool=${evt.pool_address}: ${err.message}`, err instanceof Error ? err : new Error(String(err)));
+            }
         }, (sv) => this.handleSwapVerify(sv));
     }
     handleSwapVerify(sv) {

package/dist/trade/tx_builder.d.ts

@@ -9,7 +9,6 @@ export declare class SolTransactionBuilder {
     recentBlockheight: number;
     constructor(appConfig: SolanaTradeAppConfig);
     init(): Promise<void>;
-    private warmupSigner;
     private handleBlockUpdateEvent;
     private getPreInstructions;
     private createComputeUnitLimitWithJitoDontFront;

package/dist/trade/tx_builder.js

@@ -56,24 +56,6 @@ class SolTransactionBuilder {
     }
     async init() {
         this.appConfig.arb_event_subscriber.subscribe_new_block(dist_1.CHAIN_ID.SOLANA, this.handleBlockUpdateEvent.bind(this));
-        this.warmupSigner();
-    }
-    warmupSigner() {
-        try {
-            for (let i = 0; i < 2; i++) {
-                const tx = new web3_js_1.Transaction();
-                tx.add(web3_js_1.SystemProgram.transfer({
-                    fromPubkey: this.keypair.publicKey,
-                    toPubkey: this.keypair.publicKey,
-                    lamports: 0,
-                }));
-                tx.recentBlockhash = '11111111111111111111111111111111';
-                tx.feePayer = this.keypair.publicKey;
-                tx.sign(this.keypair);
-            }
-        }
-        catch {
-        }
     }
     async handleBlockUpdateEvent(eventData) {
         let blockUpdateEvent = JSON.parse(eventData);

package/dist/utils/assert_pool_tokens.d.ts

@@ -0,0 +1,2 @@
+import { StandardPoolInfoType } from '@clonegod/ttd-core/dist';
+export declare function assertPoolTokensMatch(poolInfo: StandardPoolInfoType, onChainMintA: string, onChainMintB: string, ctx: string): void;

package/dist/utils/assert_pool_tokens.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assertPoolTokensMatch = assertPoolTokensMatch;
+function assertPoolTokensMatch(poolInfo, onChainMintA, onChainMintB, ctx) {
+    const cfgA = poolInfo.tokenA?.address;
+    const cfgB = poolInfo.tokenB?.address;
+    const where = `pool=${poolInfo.pool_name}(${poolInfo.pool_address})`;
+    if (!cfgA || !cfgB) {
+        throw new Error(`[${ctx}] assertPoolTokensMatch 失败：配置缺少 token 地址 A=${cfgA} B=${cfgB}，${where}`);
+    }
+    if (!onChainMintA || !onChainMintB) {
+        throw new Error(`[${ctx}] assertPoolTokensMatch 失败：链上 mint 为空 A=${onChainMintA} B=${onChainMintB}，${where}`);
+    }
+    const cfg = new Set([cfgA, cfgB]);
+    const matched = cfg.size === 2 && cfg.has(onChainMintA) && cfg.has(onChainMintB);
+    if (!matched) {
+        throw new Error(`[${ctx}] assertPoolTokensMatch 失败：配置 token 地址与链上 mint 不符（选错地址/配错池）` +
+            ` — 配置=(${cfgA} / ${cfgB}) 链上=(${onChainMintA} / ${onChainMintB})，${where}`);
+    }
+}

package/dist/utils/index.d.ts

@@ -1 +1,3 @@
 export * from './trade_direction';
+export * from './assert_pool_tokens';
+export * from './transfer_fee';

package/dist/utils/index.js

@@ -15,3 +15,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./trade_direction"), exports);
+__exportStar(require("./assert_pool_tokens"), exports);
+__exportStar(require("./transfer_fee"), exports);

package/dist/utils/transfer_fee.d.ts

@@ -0,0 +1,5 @@
+import { TransferFeeConfig } from '@solana/spl-token';
+import { Connection, EpochInfo, PublicKey } from '@solana/web3.js';
+import BN from 'bn.js';
+export declare function loadMintTransferFeeConfig(connection: Connection, mint: PublicKey): Promise<TransferFeeConfig | undefined>;
+export declare function computeTransferFee(amount: BN, config: TransferFeeConfig | undefined, epochInfo: EpochInfo): BN;

package/dist/utils/transfer_fee.js

@@ -0,0 +1,29 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadMintTransferFeeConfig = loadMintTransferFeeConfig;
+exports.computeTransferFee = computeTransferFee;
+const dist_1 = require("@clonegod/ttd-core/dist");
+const spl_token_1 = require("@solana/spl-token");
+const bn_js_1 = __importDefault(require("bn.js"));
+async function loadMintTransferFeeConfig(connection, mint) {
+    try {
+        const info = await connection.getAccountInfo(mint);
+        if (!info)
+            return undefined;
+        const parsed = (0, spl_token_1.unpackMint)(mint, info, info.owner);
+        return (0, spl_token_1.getTransferFeeConfig)(parsed) ?? undefined;
+    }
+    catch (err) {
+        (0, dist_1.log_debug)(`[transfer_fee] config 解析失败(按无费处理): ${mint.toBase58()}`, err.message);
+        return undefined;
+    }
+}
+function computeTransferFee(amount, config, epochInfo) {
+    if (!config)
+        return new bn_js_1.default(0);
+    const fee = (0, spl_token_1.calculateEpochFee)(config, BigInt(epochInfo.epoch), BigInt(amount.toString()));
+    return new bn_js_1.default(fee.toString());
+}

package/package.json

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

package/src/quote/abstract_dex_quote.ts

@@ -1,6 +1,6 @@
 import {
     AppConfig, QuoteDepthOutput, QuoteResultType, StandardPoolInfoType,
-    log_info, log_warn, on_quote_response, report_quote_candidate,
+    log_info, log_warn, log_error, on_quote_response, report_quote_candidate,
 } from '@clonegod/ttd-core/dist'
 import { SolanaBlockMetaUpdateEvent, SolanaSwapVerifyEventData } from '../types'
 import { SolanaChainOps } from './chain_ops'
@@ -176,8 +176,14 @@ export abstract class AbstractDexQuote<C extends SolanaChainOps = SolanaChainOps
             this.dexId,
             Array.from(this.poolInfoMap.values()),
             async (evt: SolPoolEvent) => {
-                const bundle = await this.calculateQuote(evt)
-                if (bundle) this.publishQuote(bundle)
+                try {
+                    const bundle = await this.calculateQuote(evt)
+                    if (bundle) this.publishQuote(bundle)
+                } catch (err) {
+                    // 账户快照解码/计算失败 fail-loud：每次都 log_error + 跳过本拍，绝不拿陈旧状态报价。
+                    // 落在 handler 边界（非裸抛）：一条坏事件不拖垮流式询价进程；v1 block 兜底仍会定期 RPC 刷新报价。
+                    log_error(`[${this.dexId}] v2 事件处理失败 pool=${evt.pool_address}: ${(err as Error).message}`, err instanceof Error ? err : new Error(String(err)))
+                }
             },
             // swap-verify 通道（链上真实成交 vault Δ）：独立于账户快照，对账缓存报价 → [Verify]
             (sv: SolanaSwapVerifyEventData) => this.handleSwapVerify(sv),
@@ -264,6 +270,7 @@ export abstract class AbstractDexQuote<C extends SolanaChainOps = SolanaChainOps
         // 例外：乱序晚到的旧 writeVersion 跳过，防状态回拉（writeVersion 缺省时无条件应用）。
         const hasWv = Number.isInteger(evt.writeVersion)
         const skipApply = hasWv && !this.shouldApplyState(evt.pool_address, evt.blockNumber, evt.writeVersion as number)
+        // 解码失败直接抛 → 由 v2 事件 handler 边界 log_error + 跳过本拍（不软化、不拿陈旧状态报价）。
         if (!skipApply) await this.refreshStateFromEvent(poolInfo, evt)
 
         // compute 前短路：已陈旧 → 跳过重算+推送（状态已更新）

package/src/trade/tx_builder.ts

@@ -83,29 +83,6 @@ export class SolTransactionBuilder {
     public async init(): Promise<void> {
         // 订阅区块更新事件
         this.appConfig.arb_event_subscriber.subscribe_new_block(CHAIN_ID.SOLANA, this.handleBlockUpdateEvent.bind(this));
-        // 预热签名路径：web3.js 1.98 用 @noble/curves/ed25519，首次 sign 要懒构建 base-point wNAF 表
-        // + V8 JIT 整条 compileMessage/serialize 路径，冷启动 ~34ms。在 init 跑几笔 dummy sign
-        // 把这 ~30ms 从「第一笔真实交易的关键路径」挪到进程启动期（实测首笔 34ms→~5ms）。
-        this.warmupSigner()
-    }
-
-    /** 进程启动期预热 ed25519 签名 + 序列化热路径，消除第一笔交易的冷启动尖刺 */
-    private warmupSigner(): void {
-        try {
-            for (let i = 0; i < 2; i++) {
-                const tx = new Transaction()
-                tx.add(SystemProgram.transfer({
-                    fromPubkey: this.keypair.publicKey,
-                    toPubkey: this.keypair.publicKey,
-                    lamports: 0,
-                }))
-                tx.recentBlockhash = '11111111111111111111111111111111' // 仅预热用，不广播
-                tx.feePayer = this.keypair.publicKey
-                tx.sign(this.keypair)
-            }
-        } catch {
-            // 预热失败不影响主流程（首笔退化为冷签名）
-        }
     }
 
     private async handleBlockUpdateEvent(eventData: string): Promise<void> {

package/src/utils/assert_pool_tokens.ts

@@ -0,0 +1,45 @@
+import { StandardPoolInfoType } from '@clonegod/ttd-core/dist'
+
+/**
+ * 链上身份 > 配置标签（DEX 报价实现规范原则 3）：池子 init 即校验配置 token 地址与链上 mint 一致，
+ * 不一致 fail-loud。堵「同名 symbol 选错地址 → 静默哑火」这一类 bug（见 BSC/Base 已落地的
+ * assertPoolTokensMatch 不变量 / token_guard 事故）。
+ *
+ * 用**集合相等**（顺序无关）而非按序比对：各 DEX 询价/深度都靠**地址**解析 baseIsToken0 方向
+ * （如 `dir.baseToken.address === poolState.tokenAMint`），不依赖配置 tokenA/tokenB 的排列顺序，
+ * 故只要两个配置地址 == 两个链上 mint 即可，按序硬比会对合法池误报。
+ *
+ * Solana 地址 base58 大小写敏感 → 原值精确比较。原生 SOL 在池子里即 WSOL mint
+ * （So111…112），与配置地址一致，无需 EVM 那种 native/wrapped 特殊处理。
+ *
+ * @param onChainMintA 链上 token0/A（或 base）的 mint 地址（base58 原值）
+ * @param onChainMintB 链上 token1/B（或 quote）的 mint 地址
+ * @param ctx 协议标识，仅用于报错定位（如 'RAYDIUM_AMM' / 'PUMPSWAP'）
+ */
+export function assertPoolTokensMatch(
+    poolInfo: StandardPoolInfoType,
+    onChainMintA: string,
+    onChainMintB: string,
+    ctx: string,
+): void {
+    const cfgA = poolInfo.tokenA?.address
+    const cfgB = poolInfo.tokenB?.address
+    const where = `pool=${poolInfo.pool_name}(${poolInfo.pool_address})`
+
+    if (!cfgA || !cfgB) {
+        throw new Error(`[${ctx}] assertPoolTokensMatch 失败：配置缺少 token 地址 A=${cfgA} B=${cfgB}，${where}`)
+    }
+    if (!onChainMintA || !onChainMintB) {
+        throw new Error(`[${ctx}] assertPoolTokensMatch 失败：链上 mint 为空 A=${onChainMintA} B=${onChainMintB}，${where}`)
+    }
+
+    const cfg = new Set([cfgA, cfgB])
+    // size===2 排除配置两 token 同址（退化）；两个链上 mint 都在配置集合里 ⟺ 集合相等
+    const matched = cfg.size === 2 && cfg.has(onChainMintA) && cfg.has(onChainMintB)
+    if (!matched) {
+        throw new Error(
+            `[${ctx}] assertPoolTokensMatch 失败：配置 token 地址与链上 mint 不符（选错地址/配错池）` +
+            ` — 配置=(${cfgA} / ${cfgB}) 链上=(${onChainMintA} / ${onChainMintB})，${where}`,
+        )
+    }
+}

package/src/utils/index.ts

@@ -1 +1,3 @@
 export * from './trade_direction'
+export * from './assert_pool_tokens'
+export * from './transfer_fee'

package/src/utils/transfer_fee.ts

@@ -0,0 +1,49 @@
+import { log_debug } from '@clonegod/ttd-core/dist'
+import { calculateEpochFee, getTransferFeeConfig, TransferFeeConfig, unpackMint } from '@solana/spl-token'
+import { Connection, EpochInfo, PublicKey } from '@solana/web3.js'
+import BN from 'bn.js'
+
+/**
+ * Token-2022 transfer-fee 通用处理（跨 DEX，放 sol-common 供 quote/trade 共用）。
+ *
+ * transfer fee 是 token-2022 的**可选**扩展：mint 无扩展 → config=undefined → 费用算 0
+ * （对普通 SPL mint 零影响）。任何承载带费 token-2022 池的 DEX 都需要此处理
+ * （如 raydium-cpmm / raydium-clmm）。
+ *
+ * 费率数学走 `@solana/spl-token` 的 `calculateEpochFee`（与链上 token-2022 程序同一套口径，
+ * 含 maximumFee 封顶），不引入任何 DEX SDK 依赖。
+ */
+
+/**
+ * 取某 mint 的 token-2022 transfer-fee config（SPL / 无 TransferFee 扩展 → undefined）。
+ * 一次性 init 调用，结果由调用方缓存。
+ */
+export async function loadMintTransferFeeConfig(
+    connection: Connection,
+    mint: PublicKey,
+): Promise<TransferFeeConfig | undefined> {
+    try {
+        const info = await connection.getAccountInfo(mint)
+        if (!info) return undefined
+        // 按账户 owner(token program) 解析 mint 扩展；SPL mint → getTransferFeeConfig 返回 null
+        const parsed = unpackMint(mint, info, info.owner)
+        return getTransferFeeConfig(parsed) ?? undefined
+    } catch (err) {
+        log_debug(`[transfer_fee] config 解析失败(按无费处理): ${mint.toBase58()}`, (err as Error).message)
+        return undefined
+    }
+}
+
+/**
+ * 按当前 epoch 计算「转账总额 amount」应扣的转账费（无 config → 0）。
+ * 口径 = 链上 token-2022 转账：从转账总额中扣费（preFeeAmount=amount），含 maximumFee 封顶。
+ */
+export function computeTransferFee(
+    amount: BN,
+    config: TransferFeeConfig | undefined,
+    epochInfo: EpochInfo,
+): BN {
+    if (!config) return new BN(0)
+    const fee = calculateEpochFee(config, BigInt(epochInfo.epoch), BigInt(amount.toString()))
+    return new BN(fee.toString())
+}