four-flap-meme-sdk 1.9.49 → 2.1.0

package/dist/utils/lp-inspect.js

@@ -1,133 +1,20 @@
-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';
-// ============================================================================
-// 链配置
-// ============================================================================
-/** 默认 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
+ * 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 { 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';
 export async function getFactoryFromRouter(routerAddress, rpcUrl, routerType = 'v2') {
-    const provider = new JsonRpcProvider(rpcUrl);
+    const provider = createProvider(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);
@@ -139,7 +26,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;
@@ -192,7 +79,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);
         }
@@ -235,7 +122,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 })),
     ];
 }
 // ============================================================================
@@ -253,7 +140,7 @@ const MULTICALL3_ADDRESS = ADDRESSES.BSC.Multicall3;
 const providerCache = new Map();
 function getProvider(rpcUrl) {
     if (!providerCache.has(rpcUrl)) {
-        providerCache.set(rpcUrl, new JsonRpcProvider(rpcUrl));
+        providerCache.set(rpcUrl, createProvider(rpcUrl));
     }
     return providerCache.get(rpcUrl);
 }
@@ -307,7 +194,6 @@ export async function inspectTokenLP(token, opts) {
     // 获取链配置
     let chainConfig = getChainConfig(opts.chain);
     if (!chainConfig) {
-        console.warn(`[LP Inspect] Unknown chain: ${opts.chain}`);
         return result;
     }
     // 应用自定义配置
@@ -318,13 +204,10 @@ 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;
@@ -349,26 +232,23 @@ export async function inspectTokenLP(token, opts) {
             try {
                 const stV7 = await flap.getTokenV7(token);
                 st = stV7;
-                // taxRate 是 bigint，需要转换为 number
-                taxRate = typeof stV7.taxRate === 'bigint' ? Number(stV7.taxRate) : Number(stV7.taxRate ?? 0);
+                taxRate = Number(stV7.taxRate ?? 0n);
             }
             catch {
-                // V7 不支持，fallback 到 V5
                 st = await flap.getTokenV5(token);
             }
             if (st && st.status !== undefined && Number(st.status) !== 4) {
-                const s = st;
                 result.platform = 'FLAP';
                 let quoteDecimals = 18;
                 let quoteSymbol = chainConfig.wrappedNativeSymbol;
-                if (s.quoteTokenAddress && s.quoteTokenAddress.toLowerCase() !== ZERO_ADDRESS) {
-                    quoteDecimals = await getTokenDecimals(s.quoteTokenAddress, provider);
-                    // 查找符号
-                    const stableCoin = chainConfig.stableCoins.find(c => c.address.toLowerCase() === s.quoteTokenAddress.toLowerCase());
+                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());
                     quoteSymbol = stableCoin?.symbol || 'TOKEN';
                 }
                 result.flap = {
-                    quoteToken: st.quoteTokenAddress,
+                    quoteToken: quoteTokenAddress,
                     quoteSymbol,
                     quoteDecimals,
                     reserveNative: formatBalance(st.reserve, shouldFormat, quoteDecimals),
@@ -384,7 +264,7 @@ export async function inspectTokenLP(token, opts) {
             }
         }
         catch {
-            void 0;
+            // Flap 检测失败，继续其他平台检测
         }
     }
     // ========================================
@@ -403,11 +283,8 @@ 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),
@@ -416,7 +293,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);
                     }
                 }
@@ -425,7 +302,9 @@ 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,
@@ -441,7 +320,7 @@ export async function inspectTokenLP(token, opts) {
             // status === 2 (Graduated): 已毕业到 DSWAP V2，继续走外盘检测
         }
         catch {
-            void 0;
+            // DAOaaS Portal 检测失败，继续其他平台检测
         }
     }
     // ========================================
@@ -451,23 +330,21 @@ export async function inspectTokenLP(token, opts) {
         try {
             const helper = Helper3.connectByChain('BSC', opts.rpcUrl);
             const info = await helper.getTokenInfo(token);
-            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;
-                }
+            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;
             }
         }
         catch {
-            void 0;
+            // Four.meme 检测失败，继续外盘检测
         }
     }
     // ========================================
@@ -492,7 +369,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, opts.debug);
+                const v2Pairs = await queryV2Pairs(token, dexConfig.v2Factory, quoteTokens, provider, multicall3, tokenDecimals ?? 18, shouldFormat);
                 dexPoolInfo.v2Pairs = v2Pairs;
                 // 添加到最佳池子候选
                 for (const pair of v2Pairs) {
@@ -514,13 +391,13 @@ export async function inspectTokenLP(token, opts) {
                 }
             }
             catch {
-                void 0;
+                // 单个 DEX V2 查询失败，继续其他 DEX
             }
         }
         // V3 查询
         if (dexConfig.v3Factory) {
             try {
-                const v3Pools = await queryV3Pools(token, dexConfig.v3Factory, quoteTokens, v3FeeTiers, provider, multicall3, tokenDecimals ?? 18, shouldFormat, opts.debug);
+                const v3Pools = await queryV3Pools(token, dexConfig.v3Factory, quoteTokens, v3FeeTiers, provider, multicall3, tokenDecimals ?? 18, shouldFormat);
                 dexPoolInfo.v3Pools = v3Pools;
                 // 添加到最佳池子候选
                 for (const pool of v3Pools) {
@@ -543,7 +420,7 @@ export async function inspectTokenLP(token, opts) {
                 }
             }
             catch {
-                void 0;
+                // 单个 DEX V3 查询失败，继续其他 DEX
             }
         }
         return dexPoolInfo;
@@ -551,7 +428,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) => {
@@ -563,7 +440,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
@@ -604,7 +481,7 @@ 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 = typeof stV7.taxRate === 'bigint' ? Number(stV7.taxRate) : Number(stV7.taxRate ?? 0);
+            const taxRate = Number(stV7.taxRate ?? 0n);
             if (taxRate > 0) {
                 result.taxRate = taxRate;
             }
@@ -618,20 +495,20 @@ export async function inspectTokenLP(token, opts) {
 // ============================================================================
 // V2 批量查询
 // ============================================================================
-async function queryV2Pairs(token, factoryAddress, quoteTokens, provider, multicall3, tokenDecimals, shouldFormat, _debug) {
+async function queryV2Pairs(token, factoryAddress, quoteTokens, provider, multicall3, tokenDecimals, shouldFormat) {
     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);
@@ -652,7 +529,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', []) },
@@ -665,7 +542,7 @@ async function queryV2Pairs(token, factoryAddress, quoteTokens, provider, multic
             try {
                 const idx = i * 3;
                 const token0 = pairIface.decodeFunctionResult('token0', returnData2[idx])[0];
-                void pairIface.decodeFunctionResult('token1', returnData2[idx + 1]);
+                pairIface.decodeFunctionResult('token1', returnData2[idx + 1]);
                 const [r0, r1] = pairIface.decodeFunctionResult('getReserves', returnData2[idx + 2]);
                 const p = validPairs[i];
                 const isToken0 = token0.toLowerCase() === token.toLowerCase();
@@ -683,7 +560,7 @@ async function queryV2Pairs(token, factoryAddress, quoteTokens, provider, multic
                 });
             }
             catch {
-                void 0;
+                // 单条 reserve 解码失败，跳过
             }
         }
     }
@@ -703,12 +580,7 @@ async function queryV2PairsFallback(token, factoryAddress, quoteTokens, provider
                 return null;
             }
             const pair = new Contract(pairAddress, I_UNIV2_PAIR_ABI, provider);
-            // ✅ 并行获取 token0、token1 和 reserves
-            const [token0, , reserves] = await Promise.all([
-                pair.token0(),
-                pair.token1(),
-                pair.getReserves()
-            ]);
+            const [token0, , 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;
@@ -734,7 +606,7 @@ async function queryV2PairsFallback(token, factoryAddress, quoteTokens, provider
 // ============================================================================
 // V3 批量查询
 // ============================================================================
-async function queryV3Pools(token, factoryAddress, quoteTokens, feeTiers, provider, multicall3, tokenDecimals, shouldFormat, _debug) {
+async function queryV3Pools(token, factoryAddress, quoteTokens, feeTiers, provider, multicall3, tokenDecimals, shouldFormat) {
     const results = [];
     const factoryIface = new Interface(I_UNIV3_FACTORY_ABI);
     const erc20Iface = new Interface(I_ERC20_ABI);
@@ -746,9 +618,7 @@ 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]),
@@ -760,7 +630,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);
@@ -785,7 +655,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]) },
         ]);
@@ -812,7 +682,7 @@ async function queryV3Pools(token, factoryAddress, quoteTokens, feeTiers, provid
                 });
             }
             catch {
-                void 0;
+                // 单条 balance 解码失败，跳过
             }
         }
     }
@@ -830,9 +700,7 @@ 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 });
         }
@@ -876,7 +744,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,8 +1,5 @@
-export type ExclusiveCheckOnChainParams = {
-    chain: 'BSC';
-    tokenAddress: string;
-    rpcUrl: string;
-};
+import type { ExclusiveCheckOnChainParams } from './types/mpc-exclusive.js';
+export type { ExclusiveCheckOnChainParams } from './types/mpc-exclusive.js';
 export declare function isExclusiveOnChain(params: ExclusiveCheckOnChainParams): Promise<boolean>;
 export declare function isExclusiveOffChain(getTokenInfo: (token: string) => Promise<{
     version?: string;

package/dist/utils/mpcExclusive.js

@@ -1,12 +1,13 @@
 import { Contract, JsonRpcProvider } from 'ethers';
-import TokenManager2Abi from '../shared/abis/TokenManager2.json' with { type: 'json' };
-import { ADDRESSES } from './constants.js';
+import TokenManager2Abi from '../abis/contracts/TokenManager2.json' with { type: 'json' };
+import { ADDRESSES } from '../shared/constants/index.js';
+const TOKEN_MANAGER2_ABI = TokenManager2Abi;
 // 链上识别：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, TokenManager2Abi, provider);
+    const tm2 = new Contract(tokenManager2Address, TOKEN_MANAGER2_ABI, provider);
     const info = await tm2._tokenInfos(tokenAddress);
     const template = info.template;
     return (template & 0x10000n) > 0n;

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

@@ -5,64 +5,7 @@
  * - 贿赂交易：向 BlockRazor Builder EOA 转账 BNB 提高优先级
  * - 利润提取：千分之三（30 bps）
  */
-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;
-    };
-}
+import type { BatchPrivateSaleParams, PrivateSaleResult, PrivateSaleSignConfig, PrivateSaleTransferParams } from './types/private-sale.js';
 /**
  * 生成私募转账签名交易（带贿赂和利润提取）
  *
@@ -88,3 +31,4 @@ 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';

package/dist/utils/private-sale.js

@@ -6,12 +6,8 @@
  * - 利润提取：千分之三（30 bps）
  */
 import { ethers, Wallet, JsonRpcProvider } from 'ethers';
-import { BLOCKRAZOR_BUILDER_EOA } from './constants.js';
-import { getProfitRecipient, getProfitRateBps } from '../shared/constants/index.js';
+import { getProfitRecipient, getProfitRateBps, BLOCKRAZOR_BUILDER_EOA } from '../shared/constants/index.js';
 import { NonceManager, buildProfitHopTransactions, PROFIT_HOP_COUNT } from './bundle-helpers.js';
-// ============================================================================
-// 核心功能
-// ============================================================================
 /**
  * 生成私募转账签名交易（带贿赂和利润提取）
  *
@@ -69,7 +65,6 @@ export async function batchPrivateSaleMerkle(params) {
     uniqueWallets.forEach((wallet, i) => {
         nonceMap.set(wallet.address.toLowerCase(), noncesArray[i]);
     });
-    // ✅ 预计算每个钱包的 nonce 分配
     // 第一个钱包：baseNonce(贿赂) → baseNonce+1...+N(转账) → 最后(利润)
     const firstWalletBaseNonce = nonceMap.get(firstWalletKey);
     // ✅ 为每个转账预分配 nonce
@@ -131,7 +126,7 @@ export async function batchPrivateSaleMerkle(params) {
             gasPrice,
             chainId,
             txType: 0,
-            startNonce: profitNonce
+            startNonce: profitNonce,
         });
         signedTransactions.push(...profitHopResult.signedTransactions);
         profitHopWallets = profitHopResult.hopWallets; // ✅ 收集利润多跳钱包

package/dist/utils/provider-factory.d.ts

@@ -25,6 +25,10 @@ export declare function createCachedProvider(rpcUrl: string, chainId: number, ch
  * 清除 Provider 缓存
  */
 export declare function clearProviderCache(): void;
+/**
+ * ENI 专用 Provider（staticNetwork，适合批量 RPC）
+ */
+export declare function createEniProvider(rpcUrl: string, chainId?: number): JsonRpcProvider;
 /**
  * XLayer 专用 Provider 创建函数
  */