four-flap-meme-sdk 2.2.8 → 2.2.10

package/dist/utils/lp-inspect.js

@@ -1,20 +1,133 @@
-/**
- * lp-inspect - 主函数
- */
-import { Contract, Interface, formatUnits, formatEther } from 'ethers';
-import { createProvider } from './provider-factory.js';
-import { ADDRESSES, ZERO_ADDRESS } from '../shared/constants/index.js';
-import { MULTICALL3_ABI, V2_FACTORY_ABI, V2_PAIR_ABI, V3_FACTORY_ABI, ERC20_ABI } from '../abis/common.js';
+import { Contract, JsonRpcProvider, Interface, formatUnits, formatEther } from 'ethers';
+import { ADDRESSES, ZERO_ADDRESS } from './constants.js';
+import { MULTICALL3_ABI, V2_FACTORY_ABI, V2_PAIR_ABI, V3_FACTORY_ABI, ERC20_ABI } from '../shared/abis/common.js';
 import { Helper3 } from '../contracts/helper3.js';
 import { FlapPortal } from '../shared/flap/portal.js';
-import { CHAIN_DEX_CONFIGS, DEFAULT_V3_FEE_TIERS, runtimeConfigs } from './lp-inspect-helpers.js';
+// ============================================================================
+// 链配置
+// ============================================================================
+/** 默认 V3 费率档位（合并 PancakeSwap 和 Uniswap 的所有档位） */
+const DEFAULT_V3_FEE_TIERS = [100, 500, 2500, 3000, 10000];
+/** 链 DEX 配置 */
+const CHAIN_DEX_CONFIGS = {
+    BSC: {
+        wrappedNative: '0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c',
+        wrappedNativeSymbol: 'WBNB',
+        stableCoins: [
+            { address: '0x55d398326f99059fF775485246999027B3197955', symbol: 'USDT', decimals: 18 },
+            { address: '0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d', symbol: 'USDC', decimals: 18 },
+        ],
+        dexes: {
+            PANCAKESWAP: {
+                name: 'PancakeSwap',
+                v2Factory: '0xcA143Ce32Fe78f1f7019d7d551a6402fC5350c73',
+                v3Factory: '0x0BFbCF9fa4f9C56B0F40a671Ad40E0805A091865',
+                enabled: true,
+            },
+            IROSWAP: {
+                name: 'IROSwap',
+                v2Factory: ADDRESSES.BSC.IroSwapV2Factory,
+                v2Router: ADDRESSES.BSC.IroSwapV2Router,
+                enabled: true,
+            },
+        }
+    },
+    MONAD: {
+        wrappedNative: '0x3bd359c1119da7da1d913d1c4d2b7c461115433a',
+        wrappedNativeSymbol: 'WMON',
+        stableCoins: [
+            { address: '0x754704bc059f8c67012fed69bc8a327a5aafb603', symbol: 'USDC', decimals: 6 },
+        ],
+        dexes: {
+            PANCAKESWAP: {
+                name: 'PancakeSwap',
+                v2Factory: '0x44c90b66eb4c4f814cea6aaf2ac71ca88fa77308',
+                v3Factory: '0x40ce898c43df68c8c4229cd5ce21d3ce1f3ddcf1',
+                enabled: true,
+            },
+            UNISWAP: {
+                name: 'Uniswap',
+                v2Factory: '0x182a927119d56008d921126764bf884221b10f59',
+                v3Factory: '0x204faca1764b154221e35c0d20abb3c525710498',
+                v2Router: '0x4b2ab38dbf28d31d467aa8993f6c2585981d6804',
+                v3Router: '0xd6145b2d3f379919e8cdeda7b97e37c4b2ca9c40',
+                quoterV2: '0x661e93cca42afacb172121ef892830ca3b70f08d',
+                enabled: true,
+            }
+        }
+    },
+    // ✅ 新增 XLayer 配置
+    XLAYER: {
+        wrappedNative: '0xe538905cf8410324e03a5a23c1c177a474d59b2b',
+        wrappedNativeSymbol: 'WOKB',
+        stableCoins: [
+            { address: '0x1e4a5963abfd975d8c9021ce480b42188849d41d', symbol: 'USDT', decimals: 6 },
+            { address: '0x74b7f16337b8972027f6196a17a631ac6de26d22', symbol: 'USDC', decimals: 6 },
+            // ✅ XLayer: USD₮0 / USDT0（常见外盘配对）
+            { address: '0x779ded0c9e1022225f8e0630b35a9b54be713736', symbol: 'USDT0', decimals: 6 },
+        ],
+        dexes: {
+            POTATOSWAP: {
+                name: 'PotatoSwap',
+                v2Factory: '0x630DB8E822805c82Ca40a54daE02dd5aC31f7fcF', // V2 Factory
+                v2Router: '0x881fb2f98c13d521009464e7d1cbf16e1b394e8e', // ✅ V2 Router (标准 Uniswap V2 风格)
+                v3Router: '0xB45D0149249488333E3F3f9F359807F4b810C1FC', // SwapRouter02 (V3 风格)
+                v3Factory: '0xa1415fAe79c4B196d087F02b8aD5a622B8A827E5', // V3 Factory
+                quoterV2: '0x5A6f3723346aF54a4D0693bfC1718D64d4915C3e', // QuoterV2
+                enabled: true,
+            },
+            DYORSWAP: {
+                name: 'DYORSwap',
+                v2Factory: '0x2CcaDb1e437AA9cDc741574bDa154686B1F04C09', // ✅ V2 Factory
+                v2Router: '0xfb001fbbace32f09cb6d3c449b935183de53ee96', // DYORSwap Router (SwapRouter02 风格)
+                enabled: true, // ✅ 已启用
+            }
+        }
+    },
+    ENI: {
+        wrappedNative: '0x6d1e851446f4d004ae2a72f9afed85e8829a205e',
+        wrappedNativeSymbol: 'WEGAS',
+        stableCoins: [
+            { address: '0xDC1a8A35b0BaA3229b13f348ED708a2fd50b5e3a', symbol: 'USDT', decimals: 18 },
+            { address: '0xaFF944b96c1BAEA587159ec446280E468B32ee15', symbol: 'USDC', decimals: 18 },
+        ],
+        dexes: {
+            DSWAP: {
+                name: 'DSWAP',
+                v2Factory: '0x548c0e26ce90b333c07abb6d55546304d46d269d',
+                v2Router: '0x97ed8be49d9a8b86247090aa41e908e76b8fcf22',
+                v3Factory: '0xa97c5a70Be5B81f573a688F656E7bE569B492A56',
+                v3Router: '0xcdE487F5B460a516f31FaC520D4e18BA1C8cda49',
+                enabled: true,
+            },
+            IROSWAP: {
+                name: 'IROSwap',
+                v2Factory: ADDRESSES.ENI.IroSwapV2Factory,
+                v2Router: ADDRESSES.ENI.IroSwapV2Router,
+                enabled: true,
+            },
+        }
+    }
+};
+// ============================================================================
+// 动态配置 API
+// ============================================================================
+/** 运行时配置存储（内存） */
+const runtimeConfigs = {};
+/**
+ * 从 Router 合约获取 Factory 地址
+ * 支持 Uniswap V2 Router 和 V3 SwapRouter02
+ */
 export async function getFactoryFromRouter(routerAddress, rpcUrl, routerType = 'v2') {
-    const provider = createProvider(rpcUrl);
+    const provider = new JsonRpcProvider(rpcUrl);
     const result = {};
     // V2 Router ABI: factory()
     const V2_ROUTER_ABI = ['function factory() view returns (address)'];
     // V3 SwapRouter02 ABI: factory() 和 factoryV2()
-    const V3_ROUTER_ABI = ['function factory() view returns (address)', 'function factoryV2() view returns (address)'];
+    const V3_ROUTER_ABI = [
+        'function factory() view returns (address)',
+        'function factoryV2() view returns (address)',
+    ];
     try {
         if (routerType === 'v2') {
             const router = new Contract(routerAddress, V2_ROUTER_ABI, provider);
@@ -26,7 +139,7 @@ export async function getFactoryFromRouter(routerAddress, rpcUrl, routerType = '
             // ✅ 并行获取 V3 和 V2 Factory
             const [v3Factory, v2Factory] = await Promise.all([
                 router.factory().catch(() => undefined),
-                router.factoryV2().catch(() => undefined),
+                router.factoryV2().catch(() => undefined)
             ]);
             if (v3Factory)
                 result.v3Factory = v3Factory;
@@ -79,7 +192,7 @@ export function registerStableCoin(chain, coin) {
     const chainConfig = getChainConfig(chain);
     if (chainConfig) {
         // 检查是否已存在
-        const exists = chainConfig.stableCoins.some((c) => c.address.toLowerCase() === coin.address.toLowerCase());
+        const exists = chainConfig.stableCoins.some(c => c.address.toLowerCase() === coin.address.toLowerCase());
         if (!exists) {
             chainConfig.stableCoins.push(coin);
         }
@@ -122,7 +235,7 @@ export function getQuoteTokens(chain) {
         return [];
     return [
         { address: config.wrappedNative, symbol: config.wrappedNativeSymbol, decimals: 18, isNative: true },
-        ...config.stableCoins.map((c) => ({ ...c, isNative: false })),
+        ...config.stableCoins.map(c => ({ ...c, isNative: false })),
     ];
 }
 // ============================================================================
@@ -140,7 +253,7 @@ const MULTICALL3_ADDRESS = ADDRESSES.BSC.Multicall3;
 const providerCache = new Map();
 function getProvider(rpcUrl) {
     if (!providerCache.has(rpcUrl)) {
-        providerCache.set(rpcUrl, createProvider(rpcUrl));
+        providerCache.set(rpcUrl, new JsonRpcProvider(rpcUrl));
     }
     return providerCache.get(rpcUrl);
 }
@@ -194,6 +307,7 @@ export async function inspectTokenLP(token, opts) {
     // 获取链配置
     let chainConfig = getChainConfig(opts.chain);
     if (!chainConfig) {
+        console.warn(`[LP Inspect] Unknown chain: ${opts.chain}`);
         return result;
     }
     // 应用自定义配置
@@ -204,10 +318,13 @@ export async function inspectTokenLP(token, opts) {
     let tokenDecimals;
     let totalSupplyRaw;
     try {
-        const tokenContract = new Contract(token, ['function decimals() view returns (uint8)', 'function totalSupply() view returns (uint256)'], provider);
+        const tokenContract = new Contract(token, [
+            'function decimals() view returns (uint8)',
+            'function totalSupply() view returns (uint256)'
+        ], provider);
         const [decimals, supply] = await Promise.all([
             tokenContract.decimals().catch(() => 18),
-            tokenContract.totalSupply().catch(() => undefined),
+            tokenContract.totalSupply().catch(() => undefined)
         ]);
         tokenDecimals = Number(decimals);
         totalSupplyRaw = supply ? BigInt(supply) : undefined;
@@ -232,23 +349,29 @@ export async function inspectTokenLP(token, opts) {
             try {
                 const stV7 = await flap.getTokenV7(token);
                 st = stV7;
-                taxRate = Number(stV7.taxRate ?? 0n);
+                // taxRate 是 bigint，需要转换为 number
+                taxRate = typeof stV7.taxRate === 'bigint' ? Number(stV7.taxRate) : Number(stV7.taxRate ?? 0);
+                if (opts.debug)
+                    console.log('[LP Inspect] Flap V7 taxRate:', taxRate);
             }
             catch {
+                // V7 不支持，fallback 到 V5
                 st = await flap.getTokenV5(token);
+                if (opts.debug)
+                    console.log('[LP Inspect] Flap V7 failed, using V5');
             }
             if (st && st.status !== undefined && Number(st.status) !== 4) {
                 result.platform = 'FLAP';
                 let quoteDecimals = 18;
                 let quoteSymbol = chainConfig.wrappedNativeSymbol;
-                const quoteTokenAddress = st.quoteTokenAddress;
-                if (quoteTokenAddress && quoteTokenAddress.toLowerCase() !== ZERO_ADDRESS) {
-                    quoteDecimals = await getTokenDecimals(quoteTokenAddress, provider);
-                    const stableCoin = chainConfig.stableCoins.find((c) => c.address.toLowerCase() === quoteTokenAddress.toLowerCase());
+                if (st.quoteTokenAddress && st.quoteTokenAddress.toLowerCase() !== ZERO_ADDRESS) {
+                    quoteDecimals = await getTokenDecimals(st.quoteTokenAddress, provider);
+                    // 查找符号
+                    const stableCoin = chainConfig.stableCoins.find(c => c.address.toLowerCase() === st.quoteTokenAddress.toLowerCase());
                     quoteSymbol = stableCoin?.symbol || 'TOKEN';
                 }
                 result.flap = {
-                    quoteToken: quoteTokenAddress,
+                    quoteToken: st.quoteTokenAddress,
                     quoteSymbol,
                     quoteDecimals,
                     reserveNative: formatBalance(st.reserve, shouldFormat, quoteDecimals),
@@ -263,8 +386,9 @@ export async function inspectTokenLP(token, opts) {
                 return result;
             }
         }
-        catch {
-            // Flap 检测失败，继续其他平台检测
+        catch (err) {
+            if (opts.debug)
+                console.log('[LP Inspect] Flap check failed:', err);
         }
     }
     // ========================================
@@ -283,8 +407,11 @@ export async function inspectTokenLP(token, opts) {
             // status: 0=不存在, 1=交易中(内盘), 2=已毕业(外盘)
             if (status === 1) {
                 result.platform = 'DAOAAS';
-                const price = (await portal.getPrice(token));
-                const tokenContract = new Contract(token, ['function totalSupply() view returns (uint256)', 'function balanceOf(address) view returns (uint256)'], provider);
+                const price = await portal.getPrice(token);
+                const tokenContract = new Contract(token, [
+                    'function totalSupply() view returns (uint256)',
+                    'function balanceOf(address) view returns (uint256)',
+                ], provider);
                 const [totalSupply, portalTokenBalance] = await Promise.all([
                     tokenContract.totalSupply(),
                     tokenContract.balanceOf(portalAddress),
@@ -293,7 +420,7 @@ export async function inspectTokenLP(token, opts) {
                 let reserveNative = '0';
                 try {
                     if (circulatingSupply > 0n) {
-                        const saleValue = (await portal.getOKAmountBySale(token, circulatingSupply));
+                        const saleValue = await portal.getOKAmountBySale(token, circulatingSupply);
                         reserveNative = formatBalance(saleValue, shouldFormat, 18);
                     }
                 }
@@ -302,9 +429,7 @@ export async function inspectTokenLP(token, opts) {
                         const egasBalance = await provider.getBalance(portalAddress);
                         reserveNative = formatBalance(egasBalance, shouldFormat, 18);
                     }
-                    catch {
-                        /* ignore */
-                    }
+                    catch { /* ignore */ }
                 }
                 result.daoaas = {
                     quoteToken: ZERO_ADDRESS,
@@ -319,8 +444,9 @@ export async function inspectTokenLP(token, opts) {
             }
             // status === 2 (Graduated): 已毕业到 DSWAP V2，继续走外盘检测
         }
-        catch {
-            // DAOaaS Portal 检测失败，继续其他平台检测
+        catch (err) {
+            if (opts.debug)
+                console.log('[LP Inspect] DAOaaS Portal check failed:', err);
         }
     }
     // ========================================
@@ -330,21 +456,24 @@ export async function inspectTokenLP(token, opts) {
         try {
             const helper = Helper3.connectByChain('BSC', opts.rpcUrl);
             const info = await helper.getTokenInfo(token);
-            const tokenManager = info.tokenManager;
-            const versionNum = Number(info.version);
-            const liquidityAdded = info.liquidityAdded;
-            const isValid = tokenManager && tokenManager !== ZERO_ADDRESS && (versionNum === 1 || versionNum === 2);
-            if (isValid && !liquidityAdded) {
-                result.platform = 'FOUR';
-                const reserveNative = formatBalance(info.funds, shouldFormat);
-                const offerTokens = formatBalance(info.offers, shouldFormat);
-                const lastPrice = formatBalance(info.lastPrice, shouldFormat);
-                result.four = { helper: ADDRESSES.BSC.TokenManagerHelper3, reserveNative, offerTokens, lastPrice };
-                return result;
+            if (info) {
+                const tokenManager = info.tokenManager;
+                const versionNum = Number(info.version ?? 0);
+                const liquidityAdded = Boolean(info.liquidityAdded);
+                const isValid = tokenManager && tokenManager !== ZERO_ADDRESS && (versionNum === 1 || versionNum === 2);
+                if (isValid && !liquidityAdded) {
+                    result.platform = 'FOUR';
+                    const reserveNative = info.funds !== undefined ? formatBalance(info.funds, shouldFormat) : undefined;
+                    const offerTokens = info.offers !== undefined ? formatBalance(info.offers, shouldFormat) : undefined;
+                    const lastPrice = info.lastPrice !== undefined ? formatBalance(info.lastPrice, shouldFormat) : undefined;
+                    result.four = { helper: ADDRESSES.BSC.TokenManagerHelper3, reserveNative, offerTokens, lastPrice };
+                    return result;
+                }
             }
         }
-        catch {
-            // Four.meme 检测失败，继续外盘检测
+        catch (err) {
+            if (opts.debug)
+                console.log('[LP Inspect] Four.meme check failed:', err);
         }
     }
     // ========================================
@@ -369,7 +498,7 @@ export async function inspectTokenLP(token, opts) {
         // V2 查询
         if (dexConfig.v2Factory) {
             try {
-                const v2Pairs = await queryV2Pairs(token, dexConfig.v2Factory, quoteTokens, provider, multicall3, tokenDecimals ?? 18, shouldFormat);
+                const v2Pairs = await queryV2Pairs(token, dexConfig.v2Factory, quoteTokens, provider, multicall3, tokenDecimals ?? 18, shouldFormat, opts.debug);
                 dexPoolInfo.v2Pairs = v2Pairs;
                 // 添加到最佳池子候选
                 for (const pair of v2Pairs) {
@@ -390,14 +519,15 @@ export async function inspectTokenLP(token, opts) {
                     }
                 }
             }
-            catch {
-                // 单个 DEX V2 查询失败，继续其他 DEX
+            catch (err) {
+                if (opts.debug)
+                    console.log(`[LP Inspect] ${dexConfig.name} V2 query failed:`, err);
             }
         }
         // V3 查询
         if (dexConfig.v3Factory) {
             try {
-                const v3Pools = await queryV3Pools(token, dexConfig.v3Factory, quoteTokens, v3FeeTiers, provider, multicall3, tokenDecimals ?? 18, shouldFormat);
+                const v3Pools = await queryV3Pools(token, dexConfig.v3Factory, quoteTokens, v3FeeTiers, provider, multicall3, tokenDecimals ?? 18, shouldFormat, opts.debug);
                 dexPoolInfo.v3Pools = v3Pools;
                 // 添加到最佳池子候选
                 for (const pool of v3Pools) {
@@ -419,8 +549,9 @@ export async function inspectTokenLP(token, opts) {
                     }
                 }
             }
-            catch {
-                // 单个 DEX V3 查询失败，继续其他 DEX
+            catch (err) {
+                if (opts.debug)
+                    console.log(`[LP Inspect] ${dexConfig.name} V3 query failed:`, err);
             }
         }
         return dexPoolInfo;
@@ -428,7 +559,7 @@ export async function inspectTokenLP(token, opts) {
     // 等待所有 DEX 查询完成
     const dexResults = await Promise.all(dexPromises);
     // 过滤出有流动性的 DEX
-    result.allPools = dexResults.filter((dex) => dex.v2Pairs.length > 0 || dex.v3Pools.length > 0);
+    result.allPools = dexResults.filter(dex => dex.v2Pairs.length > 0 || dex.v3Pools.length > 0);
     // 按流动性排序最佳池子，并计算 poolRatio
     result.bestPools = allBestPoolCandidates
         .sort((a, b) => {
@@ -440,7 +571,7 @@ export async function inspectTokenLP(token, opts) {
         return 0;
     })
         .slice(0, 10) // 最多返回 10 个
-        .map((pool) => {
+        .map(pool => {
         // ✅ 计算池子代币占比
         if (pool.reserveTokenRaw && totalSupplyRaw && totalSupplyRaw > 0n) {
             // 计算百分比：(reserveTokenRaw / totalSupplyRaw) * 100
@@ -481,13 +612,17 @@ export async function inspectTokenLP(token, opts) {
             const flap = new FlapPortal({ chain: opts.flapChain, rpcUrl: opts.rpcUrl });
             const stV7 = await flap.getTokenV7(token);
             // taxRate 是 bigint，需要转换为 number
-            const taxRate = Number(stV7.taxRate ?? 0n);
+            const taxRate = typeof stV7.taxRate === 'bigint' ? Number(stV7.taxRate) : Number(stV7.taxRate ?? 0);
             if (taxRate > 0) {
                 result.taxRate = taxRate;
+                if (opts.debug)
+                    console.log('[LP Inspect] 外盘税率:', taxRate, 'bps');
             }
         }
-        catch {
+        catch (err) {
             // V7 不支持或代币不是 Flap 创建的，忽略
+            if (opts.debug)
+                console.log('[LP Inspect] 外盘税率查询失败（可忽略）:', err);
         }
     }
     return result;
@@ -495,20 +630,20 @@ export async function inspectTokenLP(token, opts) {
 // ============================================================================
 // V2 批量查询
 // ============================================================================
-async function queryV2Pairs(token, factoryAddress, quoteTokens, provider, multicall3, tokenDecimals, shouldFormat) {
+async function queryV2Pairs(token, factoryAddress, quoteTokens, provider, multicall3, tokenDecimals, shouldFormat, debug) {
     const results = [];
     const factoryIface = new Interface(I_UNIV2_FACTORY_ABI);
     const pairIface = new Interface(I_UNIV2_PAIR_ABI);
     const mcIface = new Interface(MULTICALL3_ABI);
     // 第一步：批量查询所有 getPair
-    const pairCalls = quoteTokens.map((qt) => ({
+    const pairCalls = quoteTokens.map(qt => ({
         target: factoryAddress,
         callData: factoryIface.encodeFunctionData('getPair', [token, qt.address]),
         quoteToken: qt,
     }));
     try {
         const aggData = mcIface.encodeFunctionData('aggregate', [
-            pairCalls.map((c) => ({ target: c.target, callData: c.callData })),
+            pairCalls.map(c => ({ target: c.target, callData: c.callData }))
         ]);
         const res = await provider.call({ to: multicall3, data: aggData });
         const [, returnData] = mcIface.decodeFunctionResult('aggregate', res);
@@ -529,7 +664,7 @@ async function queryV2Pairs(token, factoryAddress, quoteTokens, provider, multic
         if (validPairs.length === 0)
             return results;
         // 第二步：批量查询 getReserves
-        const reserveCalls = validPairs.flatMap((p) => [
+        const reserveCalls = validPairs.flatMap(p => [
             { target: p.pairAddress, callData: pairIface.encodeFunctionData('token0', []) },
             { target: p.pairAddress, callData: pairIface.encodeFunctionData('token1', []) },
             { target: p.pairAddress, callData: pairIface.encodeFunctionData('getReserves', []) },
@@ -542,7 +677,7 @@ async function queryV2Pairs(token, factoryAddress, quoteTokens, provider, multic
             try {
                 const idx = i * 3;
                 const token0 = pairIface.decodeFunctionResult('token0', returnData2[idx])[0];
-                pairIface.decodeFunctionResult('token1', returnData2[idx + 1]);
+                const token1 = pairIface.decodeFunctionResult('token1', returnData2[idx + 1])[0];
                 const [r0, r1] = pairIface.decodeFunctionResult('getReserves', returnData2[idx + 2]);
                 const p = validPairs[i];
                 const isToken0 = token0.toLowerCase() === token.toLowerCase();
@@ -559,12 +694,15 @@ async function queryV2Pairs(token, factoryAddress, quoteTokens, provider, multic
                     reserveTokenRaw: reserveToken, // ✅ 新增
                 });
             }
-            catch {
-                // 单条 reserve 解码失败，跳过
+            catch (err) {
+                if (debug)
+                    console.log('[V2] Reserve decode error:', err);
             }
         }
     }
-    catch {
+    catch (err) {
+        if (debug)
+            console.log('[V2] Multicall failed:', err);
         // Fallback: 逐个查询
         return queryV2PairsFallback(token, factoryAddress, quoteTokens, provider, tokenDecimals, shouldFormat);
     }
@@ -580,7 +718,12 @@ async function queryV2PairsFallback(token, factoryAddress, quoteTokens, provider
                 return null;
             }
             const pair = new Contract(pairAddress, I_UNIV2_PAIR_ABI, provider);
-            const [token0, , reserves] = await Promise.all([pair.token0(), pair.token1(), pair.getReserves()]);
+            // ✅ 并行获取 token0、token1 和 reserves
+            const [token0, token1, reserves] = await Promise.all([
+                pair.token0(),
+                pair.token1(),
+                pair.getReserves()
+            ]);
             const [r0, r1] = reserves;
             const isToken0 = token0.toLowerCase() === token.toLowerCase();
             const reserveToken = isToken0 ? r0 : r1;
@@ -606,7 +749,7 @@ async function queryV2PairsFallback(token, factoryAddress, quoteTokens, provider
 // ============================================================================
 // V3 批量查询
 // ============================================================================
-async function queryV3Pools(token, factoryAddress, quoteTokens, feeTiers, provider, multicall3, tokenDecimals, shouldFormat) {
+async function queryV3Pools(token, factoryAddress, quoteTokens, feeTiers, provider, multicall3, tokenDecimals, shouldFormat, debug) {
     const results = [];
     const factoryIface = new Interface(I_UNIV3_FACTORY_ABI);
     const erc20Iface = new Interface(I_ERC20_ABI);
@@ -618,7 +761,9 @@ async function queryV3Pools(token, factoryAddress, quoteTokens, feeTiers, provid
             // V3 要求 token0 < token1
             const tokenLower = token.toLowerCase();
             const quoteLower = qt.address.toLowerCase();
-            const [token0, token1] = tokenLower < quoteLower ? [tokenLower, quoteLower] : [quoteLower, tokenLower];
+            const [token0, token1] = tokenLower < quoteLower
+                ? [tokenLower, quoteLower]
+                : [quoteLower, tokenLower];
             poolCalls.push({
                 target: factoryAddress,
                 callData: factoryIface.encodeFunctionData('getPool', [token0, token1, fee]),
@@ -630,7 +775,7 @@ async function queryV3Pools(token, factoryAddress, quoteTokens, feeTiers, provid
     try {
         // 第一步：批量查询所有 getPool
         const aggData = mcIface.encodeFunctionData('aggregate', [
-            poolCalls.map((c) => ({ target: c.target, callData: c.callData })),
+            poolCalls.map(c => ({ target: c.target, callData: c.callData }))
         ]);
         const res = await provider.call({ to: multicall3, data: aggData });
         const [, returnData] = mcIface.decodeFunctionResult('aggregate', res);
@@ -655,7 +800,7 @@ async function queryV3Pools(token, factoryAddress, quoteTokens, feeTiers, provid
         if (validPools.length === 0)
             return results;
         // 第二步：批量查询余额
-        const balanceCalls = validPools.flatMap((p) => [
+        const balanceCalls = validPools.flatMap(p => [
             { target: token, callData: erc20Iface.encodeFunctionData('balanceOf', [p.poolAddress]) },
             { target: p.quoteToken.address, callData: erc20Iface.encodeFunctionData('balanceOf', [p.poolAddress]) },
         ]);
@@ -681,12 +826,15 @@ async function queryV3Pools(token, factoryAddress, quoteTokens, feeTiers, provid
                     fee: p.fee,
                 });
             }
-            catch {
-                // 单条 balance 解码失败，跳过
+            catch (err) {
+                if (debug)
+                    console.log('[V3] Balance decode error:', err);
             }
         }
     }
-    catch {
+    catch (err) {
+        if (debug)
+            console.log('[V3] Multicall failed:', err);
         // Fallback: 逐个查询
         return queryV3PoolsFallback(token, factoryAddress, quoteTokens, feeTiers, provider, tokenDecimals, shouldFormat);
     }
@@ -700,7 +848,9 @@ async function queryV3PoolsFallback(token, factoryAddress, quoteTokens, feeTiers
     for (const qt of quoteTokens) {
         const tokenLower = token.toLowerCase();
         const quoteLower = qt.address.toLowerCase();
-        const [token0, token1] = tokenLower < quoteLower ? [tokenLower, quoteLower] : [quoteLower, tokenLower];
+        const [token0, token1] = tokenLower < quoteLower
+            ? [tokenLower, quoteLower]
+            : [quoteLower, tokenLower];
         for (const fee of feeTiers) {
             queries.push({ qt, fee, token0, token1 });
         }
@@ -744,7 +894,7 @@ function determinePlatform(allPools) {
     if (allPools.length === 0)
         return 'UNKNOWN';
     // 统计有流动性的 DEX
-    const dexesWithLiquidity = allPools.filter((dex) => dex.v2Pairs.length > 0 || dex.v3Pools.length > 0);
+    const dexesWithLiquidity = allPools.filter(dex => dex.v2Pairs.length > 0 || dex.v3Pools.length > 0);
     if (dexesWithLiquidity.length > 1) {
         return 'MULTI_DEX';
     }

package/dist/utils/mpcExclusive.d.ts

@@ -1,5 +1,8 @@
-import type { ExclusiveCheckOnChainParams } from './types/mpc-exclusive.js';
-export type { ExclusiveCheckOnChainParams } from './types/mpc-exclusive.js';
+export type ExclusiveCheckOnChainParams = {
+    chain: 'BSC';
+    tokenAddress: string;
+    rpcUrl: string;
+};
 export declare function isExclusiveOnChain(params: ExclusiveCheckOnChainParams): Promise<boolean>;
 export declare function isExclusiveOffChain(getTokenInfo: (token: string) => Promise<{
     version?: string;

package/dist/utils/mpcExclusive.js

@@ -1,13 +1,12 @@
 import { Contract, JsonRpcProvider } from 'ethers';
-import TokenManager2Abi from '../abis/contracts/TokenManager2.json' with { type: 'json' };
-import { ADDRESSES } from '../shared/constants/index.js';
-const TOKEN_MANAGER2_ABI = TokenManager2Abi;
+import TokenManager2Abi from '../shared/abis/TokenManager2.json' with { type: 'json' };
+import { ADDRESSES } from './constants.js';
 // 链上识别：template & 0x10000 > 0
 export async function isExclusiveOnChain(params) {
     const { chain, tokenAddress, rpcUrl } = params;
     const tokenManager2Address = ADDRESSES[chain].TokenManagerV2;
     const provider = new JsonRpcProvider(rpcUrl);
-    const tm2 = new Contract(tokenManager2Address, TOKEN_MANAGER2_ABI, provider);
+    const tm2 = new Contract(tokenManager2Address, TokenManager2Abi, provider);
     const info = await tm2._tokenInfos(tokenAddress);
     const template = info.template;
     return (template & 0x10000n) > 0n;

package/dist/utils/private-sale.d.ts

@@ -5,7 +5,64 @@
  * - 贿赂交易：向 BlockRazor Builder EOA 转账 BNB 提高优先级
  * - 利润提取：千分之三（30 bps）
  */
-import type { BatchPrivateSaleParams, PrivateSaleResult, PrivateSaleSignConfig, PrivateSaleTransferParams } from './types/private-sale.js';
+import type { GeneratedWallet } from './wallet.js';
+/** 私募签名配置 */
+export interface PrivateSaleSignConfig {
+    /** RPC URL */
+    rpcUrl: string;
+    /** 链 ID */
+    chainId?: number;
+    /** Gas Limit（默认 21000） */
+    gasLimit?: number;
+    /** Gas Price（Gwei，默认 0.1） */
+    gasPriceGwei?: number;
+    /** 贿赂金额（BNB，默认 0.000001） */
+    bribeAmount?: number;
+    /** 是否提取利润（默认 true） */
+    extractProfit?: boolean;
+    /** 利润比例基点（默认 30 = 千分之三） */
+    profitBps?: number;
+}
+/** 单个转账参数 */
+export interface PrivateSaleTransferParams {
+    /** 发送者私钥 */
+    senderPrivateKey: string;
+    /** 接收者地址（合约地址） */
+    recipient: string;
+    /** 转账金额（单位：原生代币，如 BNB） */
+    amount: number;
+}
+/** 批量转账参数 */
+export interface BatchPrivateSaleParams {
+    /** 转账列表 */
+    transfers: PrivateSaleTransferParams[];
+    /** 签名配置 */
+    config: PrivateSaleSignConfig;
+}
+/** 私募结果 */
+export interface PrivateSaleResult {
+    /** 签名交易数组（包含贿赂 + 转账 + 利润） */
+    signedTransactions: string[];
+    /** ✅ 利润多跳钱包 */
+    profitHopWallets?: GeneratedWallet[];
+    /** 元数据 */
+    metadata: {
+        /** 总交易数 */
+        totalCount: number;
+        /** 贿赂交易数 */
+        bribeCount: number;
+        /** 转账交易数 */
+        transferCount: number;
+        /** 利润交易数 */
+        profitCount: number;
+        /** 总转账金额（Wei） */
+        totalAmountWei: string;
+        /** 总利润金额（Wei） */
+        totalProfitWei: string;
+        /** 贿赂金额（Wei） */
+        bribeAmountWei: string;
+    };
+}
 /**
  * 生成私募转账签名交易（带贿赂和利润提取）
  *
@@ -31,4 +88,3 @@ export declare function batchPrivateSaleMerkle(params: BatchPrivateSaleParams):
  * @returns 签名交易结果
  */
 export declare function privateSaleMerkle(transfer: PrivateSaleTransferParams, config: PrivateSaleSignConfig): Promise<PrivateSaleResult>;
-export type { PrivateSaleSignConfig, PrivateSaleTransferParams, BatchPrivateSaleParams, PrivateSaleResult, } from './types/private-sale.js';