four-flap-meme-sdk 2.2.2 → 2.2.4

package/dist/dex/direct-router-helpers.js

@@ -0,0 +1,539 @@
+import { ethers, Contract } from 'ethers';
+import { createProvider } from '../utils/provider-factory.js';
+import { V2_ROUTER_ABI as _V2_ROUTER_ABI, V3_ROUTER02_ABI as _V3_ROUTER02_ABI, V3_ROUTER_LEGACY_ABI as _V3_ROUTER_LEGACY_ABI, SWAP_ROUTER02_V2_ABI as _SWAP_ROUTER02_V2_ABI, } from '../abis/common.js';
+import { ADDRESSES, GAS_LIMITS, getProfitRecipient, getProfitRateBps, ZERO_ADDRESS, BLOCKRAZOR_BUILDER_EOA, } from '../shared/constants/index.js';
+import { getOptimizedGasPrice, buildProfitHopTransactions, PROFIT_HOP_COUNT, getDeadline as bundleGetDeadline, buildGasFields, } from '../utils/bundle-helpers.js';
+/**
+ * 直接 Router 交易（不走代理合约）
+ *
+ * 支持：
+ * - BSC: PancakeSwap V2/V3
+ * - Monad: PancakeSwap V2, Uniswap V2/V3
+ *
+ * 收费方式：交易末尾附加利润提取交易（和内盘一致）
+ */
+// ============================================================================
+// ✅ 方案 C：Provider 缓存（避免重复创建）
+// ============================================================================
+export const providerCache = new Map();
+export const PROVIDER_CACHE_TTL = 60000; // 60秒后过期
+export const providerCacheTimestamps = new Map();
+/**
+ * 获取缓存的 Provider 实例
+ * - 根据 rpcUrl + chainId 作为缓存 key
+ * - 60秒后自动失效，避免长连接问题
+ */
+export function getCachedProvider(rpcUrl, chainId, chainName) {
+    const cacheKey = `${rpcUrl}_${chainId}`;
+    const now = Date.now();
+    // 检查缓存是否存在且未过期
+    const cachedProvider = providerCache.get(cacheKey);
+    const timestamp = providerCacheTimestamps.get(cacheKey) || 0;
+    if (cachedProvider && now - timestamp < PROVIDER_CACHE_TTL) {
+        return cachedProvider;
+    }
+    // ✅ 禁用 ENS: 避免 "network does not support ENS" 错误
+    const provider = createProvider(rpcUrl, chainId, chainName);
+    providerCache.set(cacheKey, provider);
+    providerCacheTimestamps.set(cacheKey, now);
+    return provider;
+}
+export const DEFAULT_GAS_LIMIT = 300000;
+export const DEADLINE_MINUTES = 20;
+// ✅ BLOCKRAZOR_BUILDER_EOA 从公共模块导入
+/**
+ * 截断小数位数，避免超过代币精度导致 parseUnits 报错
+ * 例如：truncateDecimals("21906.025000000000000000", 1) => "21906.0"
+ */
+export function truncateDecimals(value, decimals) {
+    if (!value || decimals < 0)
+        return value;
+    const parts = value.split('.');
+    if (parts.length === 1)
+        return value; // 没有小数点
+    const integerPart = parts[0];
+    const decimalPart = parts[1];
+    if (decimals === 0)
+        return integerPart;
+    // 截断到指定小数位数
+    const truncatedDecimal = decimalPart.slice(0, decimals);
+    // 如果截断后没有小数部分，只返回整数部分
+    if (!truncatedDecimal || truncatedDecimal === '')
+        return integerPart;
+    return `${integerPart}.${truncatedDecimal}`;
+}
+/** Router 地址配置 - ✅ 使用公共模块中的地址 */
+export const DIRECT_ROUTERS = {
+    BSC: {
+        PANCAKESWAP_V2: ADDRESSES.BSC.PancakeV2Router,
+        PANCAKESWAP_V3: ADDRESSES.BSC.PancakeV3Router,
+        IROSWAP_V2: ADDRESSES.BSC.IroSwapV2Router,
+        WBNB: ADDRESSES.BSC.WBNB,
+    },
+    MONAD: {
+        // PancakeSwap
+        PANCAKESWAP_V2: '0xB1Bc24c34e88f7D43D5923034E3a14B24DaACfF9',
+        PANCAKESWAP_V3: '0x1b81D678ffb9C0263b24A97847620C99d213eB14',
+        // Uniswap
+        UNISWAP_V2: '0x4b2ab38dbf28d31d467aa8993f6c2585981d6804',
+        UNISWAP_V3: '0xd6145b2d3f379919e8cdeda7b97e37c4b2ca9c40',
+        // Wrapped Native
+        WMON: ADDRESSES.MONAD.WMON,
+    },
+    // XLayer (PotatoSwap + DYORSwap)
+    XLAYER: {
+        POTATOSWAP_V2: '0x881fb2f98c13d521009464e7d1cbf16e1b394e8e',
+        POTATOSWAP_V3: '0xB45D0149249488333E3F3f9F359807F4b810C1FC',
+        DYORSWAP_ROUTER: '0xfb001fbbace32f09cb6d3c449b935183de53ee96',
+        DYORSWAP_FACTORY: '0x2CcaDb1e437AA9cDc741574bDa154686B1F04C09',
+        V3_ROUTER: '0xBB069e9465BcabC4F488d21e793BDEf0F2d41D41',
+        V3_FACTORY: '0xa1415fAe79c4B196d087F02b8aD5a622B8A827E5',
+        WOKB: '0xe538905cf8410324e03a5a23c1c177a474d59b2b',
+    },
+    ENI: {
+        DSWAP_V2: ADDRESSES.ENI.DswapV2Router,
+        DSWAP_V3: ADDRESSES.ENI.DswapV3Router02,
+        IROSWAP_V2: ADDRESSES.ENI.IroSwapV2Router,
+        WEGAS: ADDRESSES.ENI.WEGAS,
+    },
+};
+/** 链 ID 映射 */
+export const CHAIN_IDS = {
+    BSC: 56,
+    MONAD: 143,
+    XLAYER: 196,
+    ENI: 173,
+};
+/** 获取原生包装代币地址 */
+export function getWrappedNative(chain) {
+    const chainUpper = chain.toUpperCase();
+    if (chainUpper === 'BSC')
+        return DIRECT_ROUTERS.BSC.WBNB;
+    if (chainUpper === 'MONAD')
+        return DIRECT_ROUTERS.MONAD.WMON;
+    if (chainUpper === 'XLAYER')
+        return DIRECT_ROUTERS.XLAYER.WOKB;
+    if (chainUpper === 'ENI')
+        return DIRECT_ROUTERS.ENI.WEGAS;
+    throw new Error(`Unsupported chain: ${chain}`);
+}
+// ============================================================================
+// ABI - ✅ 使用公共模块
+// ============================================================================
+/** V2 Router ABI */
+export const V2_ROUTER_ABI = _V2_ROUTER_ABI;
+/** SwapRouter02 的 V2 方法 ABI - ✅ 从公共模块导入 */
+export const SWAP_ROUTER02_V2_ABI = _SWAP_ROUTER02_V2_ABI;
+/**
+ * DYORSwap SwapRouter02 的 V2 方法
+ *
+ * ⚠️ 重要：DYORSwap 使用自定义的函数签名，无法通过标准 ABI 编码
+ * 必须手动构造 calldata
+ *
+ * swapExactTokensForTokens selector: 0x3234fe0d
+ * unwrapWETH9 selector: 0x7342292e
+ * refundETH selector: 0x6d29fcf4
+ */
+export const DYORSWAP_SELECTORS = {
+    swapExactTokensForTokens: '0x3234fe0d',
+    unwrapWETH9: '0x7342292e',
+    refundETH: '0x6d29fcf4',
+    multicall: '0x5ae401dc',
+};
+/**
+ * 手动编码 DYORSwap 的 swapExactTokensForTokens calldata
+ *
+ * 参数格式 (根据成功交易分析):
+ * - amountIn: uint256
+ * - amountOutMin: uint256
+ * - path: address[] (动态) - offset from start
+ * - pools: address[] (动态) - offset from start
+ * - to: uint256 (address(2) = 2)
+ * - flag: uint256 (1)
+ * - factory: address
+ *
+ * 成功交易的布局:
+ * [0] amountIn
+ * [1] amountOutMin
+ * [2] offset to path = 0xa0 = 160 = 5 * 32 (从参数区域开始)
+ * [3] offset to pools = 0xe0 = 224 = 7 * 32
+ * [4] to = 2
+ * [5] flag = 1
+ * [6] factory
+ * [7] path.length
+ * [8+] path elements
+ * [N] pools.length
+ * [N+1+] pools elements
+ */
+export function encodeDYORSwapExactTokensForTokens(amountIn, amountOutMin, path, pools, to, // 可以是地址 (string) 或 address(2) 这样的特殊值 (bigint)
+flag, factory) {
+    const pathOffset = 5n * 32n; // 160
+    // poolsOffset = pathOffset + (1 + path.length) * 32 = 160 + 96 = 256?
+    // 不对，成功交易是 224 = 160 + 64 = pathOffset + path.length * 32
+    const poolsOffset = pathOffset + BigInt(path.length) * 32n; // 160 + 2*32 = 224
+    // 手动构建数据
+    const pad32 = (hex) => hex.replace('0x', '').padStart(64, '0');
+    const toHex = (n) => n.toString(16).padStart(64, '0');
+    // 处理 to 参数：可以是地址 (string) 或特殊值 (bigint)
+    const toValue = typeof to === 'string' ? pad32(to) : toHex(to);
+    let data = DYORSWAP_SELECTORS.swapExactTokensForTokens;
+    data += toHex(amountIn);
+    data += toHex(amountOutMin);
+    data += toHex(pathOffset);
+    data += toHex(poolsOffset);
+    data += toValue;
+    data += toHex(flag);
+    data += pad32(factory);
+    // path 数据
+    data += toHex(BigInt(path.length));
+    for (const addr of path) {
+        data += pad32(addr);
+    }
+    // ⚠️ 不包含 pools 数据！成功交易中 pools 是空的
+    // poolsOffset 指向的位置没有数据
+    return '0x' + data.replace('0x', '');
+}
+/**
+ * 手动编码 DYORSwap 的 unwrapWETH9 calldata
+ *
+ * 参数格式 (根据成功交易分析):
+ * - amountMinimum: uint256
+ * - recipient: address
+ * - pools: bytes (动态) - 包含特殊的 pool 数据
+ *
+ * 成功交易的布局:
+ * [0] amountMinimum
+ * [1] recipient
+ * [2] offset to pools = 0x60 = 96 = 3 * 32
+ * [3] pools 数据 (bytes)
+ */
+export function encodeDYORUnwrapWETH9(amountMinimum, recipient, poolsData = '') {
+    const pad32 = (hex) => hex.slice(2).padStart(64, '0');
+    const toHex = (n) => n.toString(16).padStart(64, '0');
+    const poolsOffset = 3n * 32n; // 96
+    const poolsBytes = poolsData.startsWith('0x') ? poolsData.slice(2) : poolsData;
+    const poolsLength = poolsBytes.length / 2;
+    let data = DYORSWAP_SELECTORS.unwrapWETH9;
+    data += toHex(amountMinimum);
+    data += pad32(recipient);
+    data += toHex(poolsOffset);
+    data += toHex(BigInt(poolsLength));
+    // pools 数据需要 padding 到 32 字节的倍数
+    if (poolsBytes.length > 0) {
+        const paddedLength = Math.ceil(poolsBytes.length / 64) * 64;
+        data += poolsBytes.padEnd(paddedLength, '0');
+    }
+    return '0x' + data.replace('0x', '');
+}
+/**
+ * DYORSwap 的 ETHBack_Dividend 合约地址
+ * 这是 refundETH 中使用的固定地址，不是 LP 池地址
+ */
+export const DYORSWAP_ETHBACK_DIVIDEND = '0x2e61b0b4410f6fb941d47205191cbb8963d44bcc';
+/**
+ * 手动编码 DYORSwap 的 refundETH calldata
+ *
+ * 根据成功交易分析，refundETH 的格式是:
+ * refundETH(bytes pools)
+ *
+ * 成功交易的 refundETH (0x6d29fcf4):
+ * [0] offset to pools = 0x20 = 32
+ * [1] pools 数组长度 = 1
+ * [2] fee = 30 (0x1e)
+ * [3] ETHBack_Dividend 合约地址
+ */
+export function encodeDYORRefundETH(fee = 30) {
+    const toHex = (n) => n.toString(16).padStart(64, '0');
+    const pad32 = (hex) => hex.replace('0x', '').padStart(64, '0');
+    // 使用固定的 ETHBack_Dividend 合约地址
+    let data = DYORSWAP_SELECTORS.refundETH;
+    data += toHex(32n); // offset = 0x20
+    data += toHex(1n); // 数组长度 = 1
+    data += toHex(BigInt(fee)); // fee = 30
+    data += pad32(DYORSWAP_ETHBACK_DIVIDEND); // ETHBack_Dividend 地址
+    return '0x' + data.replace('0x', '');
+}
+/**
+ * 手动编码 DYORSwap 的 multicall calldata
+ *
+ * multicall(uint256 deadline, bytes[] data)
+ * 这个函数使用标准 ABI 编码
+ */
+export function encodeDYORMulticall(deadline, data) {
+    const abiCoder = ethers.AbiCoder.defaultAbiCoder();
+    // multicall(uint256 deadline, bytes[] data)
+    // 确保每个 data 元素都是正确的 hex 格式
+    const formattedData = data.map((d) => (d.startsWith('0x') ? d : '0x' + d));
+    const encoded = abiCoder.encode(['uint256', 'bytes[]'], [deadline, formattedData]).slice(2);
+    return '0x' + DYORSWAP_SELECTORS.multicall.slice(2) + encoded;
+}
+/** V3 SwapRouter02 ABI (PancakeSwap V3, 新版 Uniswap) */
+export const V3_ROUTER02_ABI = _V3_ROUTER02_ABI;
+/** V3 SwapRouter（旧版）ABI (Monad Uniswap V3) */
+export const V3_ROUTER_LEGACY_ABI = _V3_ROUTER_LEGACY_ABI;
+/**
+ * 判断是否使用旧版 SwapRouter
+ *
+ * 旧版特征：
+ * - exactInputSingle 包含 deadline 字段
+ * - multicall 只有 bytes[] 参数
+ *
+ * Monad 上的 V3 DEX 都使用旧版：
+ * - Uniswap V3: 0xd6145b2d3f379919e8cdeda7b97e37c4b2ca9c40
+ * - PancakeSwap V3: 0x1b81D678ffb9C0263b24A97847620C99d213eB14
+ *
+ * XLayer:
+ * - V3 Router (0xBB069e9465BcabC4F488d21e793BDEf0F2d41D41) - 旧版（exactInputSingle 包含 deadline）
+ * - SwapRouter02 (0xB45D0149249488333E3F3f9F359807F4b810C1FC) - 新版（V2+V3 混合）
+ *
+ * BSC PancakeSwap V3 使用新版 SwapRouter02
+ */
+export function isLegacySwapRouter(chain, routerAddress) {
+    const chainUpper = chain.toUpperCase();
+    const routerLower = routerAddress.toLowerCase();
+    // ✅ Monad 上的所有 V3 Router 都是旧版
+    if (chainUpper === 'MONAD') {
+        if (routerLower === DIRECT_ROUTERS.MONAD.UNISWAP_V3.toLowerCase()) {
+            return true;
+        }
+        if (routerLower === DIRECT_ROUTERS.MONAD.PANCAKESWAP_V3.toLowerCase()) {
+            return true;
+        }
+    }
+    // ✅ XLayer V3 专用 Router 是旧版（exactInputSingle 包含 deadline）
+    if (chainUpper === 'XLAYER') {
+        if (routerLower === DIRECT_ROUTERS.XLAYER.V3_ROUTER.toLowerCase()) {
+            return true; // V3 Router 是旧版
+        }
+        // SwapRouter02 是新版
+        return false;
+    }
+    // ✅ BSC PancakeSwap V3 使用新版 SwapRouter02
+    return false;
+}
+/** ERC20 ABI - ✅ 从公共模块导入 */
+// ============================================================================
+// 类型定义
+// ============================================================================
+// 工具函数
+// ============================================================================
+// ✅ 使用公共模块的 getDeadline
+export function getDeadline(minutes = DEADLINE_MINUTES) {
+    return bundleGetDeadline(minutes);
+}
+export function getGasLimit(config, defaultGas = DEFAULT_GAS_LIMIT) {
+    if (config.gasLimit !== undefined) {
+        return typeof config.gasLimit === 'bigint' ? config.gasLimit : BigInt(config.gasLimit);
+    }
+    const multiplier = config.gasLimitMultiplier ?? 1.2;
+    return BigInt(Math.ceil(defaultGas * multiplier));
+}
+export async function getGasPrice(provider, config) {
+    if (config.gasPrice)
+        return config.gasPrice;
+    // 转换 Gwei 配置为 Wei
+    const gasPriceConfig = {};
+    if (config.minGasPriceGwei !== undefined) {
+        gasPriceConfig.minGasPrice = ethers.parseUnits(String(config.minGasPriceGwei), 'gwei');
+    }
+    if (config.maxGasPriceGwei !== undefined) {
+        gasPriceConfig.maxGasPrice = ethers.parseUnits(String(config.maxGasPriceGwei), 'gwei');
+    }
+    return getOptimizedGasPrice(provider, gasPriceConfig);
+}
+export function isNativeToken(quoteToken) {
+    return !quoteToken || quoteToken === ZERO_ADDRESS;
+}
+// ============================================================================
+// XLAYER V3 报价（slot0 现货价，纯 V3，不串 V2）
+// - 只用于“利润换算”为原生币，避免 XLAYER 没有 v3Quoter 导致 profit=0
+// - 不改 BSC 的任何配置/逻辑
+// ============================================================================
+export const XLAYER_V3_FACTORY_ABI = [
+    'function getPool(address tokenA, address tokenB, uint24 fee) view returns (address pool)',
+];
+export const XLAYER_V3_POOL_ABI = [
+    'function slot0() view returns (uint160 sqrtPriceX96,int24 tick,uint16 observationIndex,uint16 observationCardinality,uint16 observationCardinalityNext,uint8 feeProtocol,bool unlocked)',
+    'function token0() view returns (address)',
+    'function token1() view returns (address)',
+];
+export const V3_FEE_DENOMINATOR = 1000000n; // UniswapV3 fee: X / 1e6
+export async function quoteXLayerV3TokenToNativeBySlot0(params) {
+    try {
+        const { provider, tokenIn, amountIn, fee } = params;
+        if (!tokenIn || amountIn <= 0n)
+            return 0n;
+        const chainFactory = DIRECT_ROUTERS.XLAYER.V3_FACTORY;
+        const wrappedNative = DIRECT_ROUTERS.XLAYER.WOKB;
+        if (!chainFactory || !wrappedNative)
+            return 0n;
+        const tokenInLower = tokenIn.toLowerCase();
+        const wrappedLower = wrappedNative.toLowerCase();
+        if (tokenInLower === wrappedLower)
+            return amountIn;
+        const factory = new Contract(chainFactory, XLAYER_V3_FACTORY_ABI, provider);
+        const poolAddr = await factory.getPool?.(tokenIn, wrappedNative, fee);
+        if (!poolAddr || poolAddr.toLowerCase() === ZERO_ADDRESS.toLowerCase())
+            return 0n;
+        const pool = new Contract(poolAddr, XLAYER_V3_POOL_ABI, provider);
+        const [t0, t1, slot0] = await Promise.all([pool.token0?.(), pool.token1?.(), pool.slot0?.()]);
+        if (!t0 || !t1 || !slot0)
+            return 0n;
+        const sqrtPriceX96 = BigInt(slot0[0]);
+        if (sqrtPriceX96 <= 0n)
+            return 0n;
+        const amountInLessFee = (amountIn * (V3_FEE_DENOMINATOR - BigInt(fee))) / V3_FEE_DENOMINATOR;
+        if (amountInLessFee <= 0n)
+            return 0n;
+        const Q192 = 2n ** 192n;
+        const num = sqrtPriceX96 * sqrtPriceX96;
+        const t0Lower = String(t0).toLowerCase();
+        const t1Lower = String(t1).toLowerCase();
+        // sqrtPriceX96 表示 token1/token0 的现货价（raw）
+        if (tokenInLower === t0Lower && wrappedLower === t1Lower) {
+            return (amountInLessFee * num) / Q192;
+        }
+        if (tokenInLower === t1Lower && wrappedLower === t0Lower) {
+            return (amountInLessFee * Q192) / num;
+        }
+        return 0n;
+    }
+    catch {
+        return 0n;
+    }
+}
+// ✅ getTokenToNativeQuote 函数已移至 ../utils/quote-helpers.ts
+/**
+ * ✅ 找到金额最大的钱包索引（和 core.ts 逻辑一致）
+ */
+export function findMaxFlowIndex(amounts) {
+    if (amounts.length === 0)
+        return 0;
+    let maxIndex = 0;
+    let maxValue = amounts[0];
+    for (let i = 1; i < amounts.length; i++) {
+        if (amounts[i] > maxValue) {
+            maxValue = amounts[i];
+            maxIndex = i;
+        }
+    }
+    return maxIndex;
+}
+/** 计算利润金额 */
+export function calculateProfitAmount(totalFlowWei) {
+    return (totalFlowWei * BigInt(getProfitRateBps('normal'))) / 10000n;
+}
+/**
+ * 构建利润多跳转账交易（强制 2 跳中转）
+ */
+export async function buildProfitTransactionWithHops(provider, wallet, profitAmountWei, nonce, gasPrice, chainId, txType = 0, profitRecipient) {
+    if (profitAmountWei <= 0n)
+        return { signedTransactions: [], hopWallets: undefined };
+    const profitHopResult = await buildProfitHopTransactions({
+        provider,
+        payerWallet: wallet,
+        profitAmount: profitAmountWei,
+        profitRecipient: profitRecipient || getProfitRecipient(),
+        hopCount: PROFIT_HOP_COUNT,
+        gasPrice,
+        chainId,
+        txType,
+        startNonce: nonce,
+    });
+    return { signedTransactions: profitHopResult.signedTransactions, hopWallets: profitHopResult.hopWallets };
+}
+/**
+ * 获取贿赂金额（wei）
+ * ✅ 仅 BSC 链支持贿赂
+ */
+export function getBribeAmount(config, chain) {
+    // 只有 BSC 链支持贿赂
+    if (chain.toUpperCase() !== 'BSC')
+        return 0n;
+    const bribeAmount = config.bribeAmount;
+    if (typeof bribeAmount !== 'number' || bribeAmount <= 0)
+        return 0n;
+    // 转换为 wei
+    return ethers.parseEther(String(bribeAmount));
+}
+/** 构建贿赂交易（向 BlockRazor Builder EOA 转账 BNB） */
+export async function buildBribeTransaction(wallet, bribeAmountWei, nonce, gasPrice, chainId, txType = 0) {
+    const tx = {
+        to: BLOCKRAZOR_BUILDER_EOA,
+        value: bribeAmountWei,
+        nonce,
+        gasLimit: GAS_LIMITS.BRIBE,
+        ...buildGasFields(txType, gasPrice),
+        chainId,
+    };
+    return wallet.signTransaction(tx);
+}
+// ============================================================================
+// V2 直接交易
+// ============================================================================
+/**
+ * 判断是否是 SwapRouter02 (XLayer PotatoSwap V3)
+ *
+ * SwapRouter02 风格的 Router 使用 multicall 包装 V2 方法：
+ * - multicall(uint256 deadline, bytes[] data)
+ * - data 内包含 swapExactTokensForTokens 等 V2 方法
+ *
+ * SwapRouter02 的 V2 方法签名不同：
+ * - swapExactTokensForTokens(amountIn, amountOutMin, path[], to) - 没有 deadline
+ * - 需要通过 multicall 的 deadline 参数传递 deadline
+ *
+ * ⚠️ 注意：DYORSwap 虽然也用 multicall，但它的 ABI 完全不同，需要单独处理
+ */
+export function isSwapRouter02(chain, routerAddress) {
+    const chainUpper = chain.toUpperCase();
+    const addrLower = routerAddress.toLowerCase();
+    if (chainUpper === 'XLAYER') {
+        // ✅ XLayer PotatoSwap SwapRouter02 (V3 风格)
+        if (addrLower === DIRECT_ROUTERS.XLAYER.POTATOSWAP_V3.toLowerCase()) {
+            return true;
+        }
+    }
+    // ❌ XLayer POTATOSWAP_V2 (0x881fb...) 是标准 V2 Router，不走 SwapRouter02 逻辑
+    // ❌ XLayer DYORSWAP_ROUTER 有自己独特的 ABI，不走 SwapRouter02 逻辑
+    // ❌ BSC V2 交易使用传统 PancakeSwap V2 Router，不走 SwapRouter02 逻辑
+    // ❌ Monad V2 交易使用传统 V2 Router，不走 SwapRouter02 逻辑
+    return false;
+}
+/**
+ * 判断是否是 DYORSwap Router
+ *
+ * DYORSwap 使用 multicall，但它的 swapExactTokensForTokens 有特殊的 ABI：
+ * - swapExactTokensForTokens(amountIn, amountOutMin, path[], payer, flags, factory, pools)
+ * - unwrapWETH9(amountMinimum, recipient, pools)
+ */
+export function isDYORSwap(chain, routerAddress) {
+    const chainUpper = chain.toUpperCase();
+    const addrLower = routerAddress.toLowerCase();
+    if (chainUpper === 'XLAYER') {
+        if (addrLower === DIRECT_ROUTERS.XLAYER.DYORSWAP_ROUTER.toLowerCase()) {
+            return true;
+        }
+    }
+    return false;
+}
+export function filterEniNativeBuyIndices(balances, flowAmounts, gasLimit, gasPrice, profitWei) {
+    const maxFlowIdx = findMaxFlowIndex(flowAmounts);
+    const profitGasCost = GAS_LIMITS.NATIVE_TRANSFER * gasPrice;
+    const validIdx = [];
+    for (let i = 0; i < balances.length; i++) {
+        let required = flowAmounts[i] + BigInt(gasLimit) * gasPrice;
+        if (i === maxFlowIdx && profitWei > 0n) {
+            required += profitWei + profitGasCost;
+        }
+        if (balances[i] < required)
+            continue;
+        validIdx.push(i);
+    }
+    if (validIdx.length === 0) {
+        throw new Error('[V2 BatchBuy ENI] 所有钱包余额不足（含 swap + gas + 利润费），无法执行');
+    }
+    return validIdx.length < balances.length ? validIdx : null;
+}
+/**
+ * V2 批量买入（直接调用 Router）
+ */

package/dist/dex/direct-router.d.ts

@@ -1,126 +1,6 @@
-/**
- * 直接 Router 交易（不走代理合约）
- *
- * 支持：
- * - BSC: PancakeSwap V2/V3
- * - Monad: PancakeSwap V2, Uniswap V2/V3
- *
- * 收费方式：交易末尾附加利润提取交易（和内盘一致）
- */
-/** Router 地址配置 - ✅ 使用公共模块中的地址 */
-export declare const DIRECT_ROUTERS: {
-    readonly BSC: {
-        readonly PANCAKESWAP_V2: "0x10ED43C718714eb63d5aA57B78B54704E256024E";
-        readonly PANCAKESWAP_V3: "0x13f4EA83D0bd40E75C8222255bc855a974568Dd4";
-        readonly IROSWAP_V2: "0xe90fb729E458092592a79EdaFefB3404ecb3C463";
-        readonly WBNB: "0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c";
-    };
-    readonly MONAD: {
-        readonly PANCAKESWAP_V2: "0xB1Bc24c34e88f7D43D5923034E3a14B24DaACfF9";
-        readonly PANCAKESWAP_V3: "0x1b81D678ffb9C0263b24A97847620C99d213eB14";
-        readonly UNISWAP_V2: "0x4b2ab38dbf28d31d467aa8993f6c2585981d6804";
-        readonly UNISWAP_V3: "0xd6145b2d3f379919e8cdeda7b97e37c4b2ca9c40";
-        readonly WMON: "0x3bd359c1119da7da1d913d1c4d2b7c461115433a";
-    };
-    readonly XLAYER: {
-        readonly POTATOSWAP_V2: "0x881fb2f98c13d521009464e7d1cbf16e1b394e8e";
-        readonly POTATOSWAP_V3: "0xB45D0149249488333E3F3f9F359807F4b810C1FC";
-        readonly DYORSWAP_ROUTER: "0xfb001fbbace32f09cb6d3c449b935183de53ee96";
-        readonly DYORSWAP_FACTORY: "0x2CcaDb1e437AA9cDc741574bDa154686B1F04C09";
-        readonly V3_ROUTER: "0xBB069e9465BcabC4F488d21e793BDEf0F2d41D41";
-        readonly V3_FACTORY: "0xa1415fAe79c4B196d087F02b8aD5a622B8A827E5";
-        readonly WOKB: "0xe538905cf8410324e03a5a23c1c177a474d59b2b";
-    };
-    readonly ENI: {
-        readonly DSWAP_V2: "0x97ed8be49d9a8b86247090aa41e908e76b8fcf22";
-        readonly DSWAP_V3: "0xcdE487F5B460a516f31FaC520D4e18BA1C8cda49";
-        readonly IROSWAP_V2: "0x93b1199fA96f6b9b1f993AA0226eB6076968a9BF";
-        readonly WEGAS: "0x6d1e851446f4d004ae2a72f9afed85e8829a205e";
-    };
-};
-/** ERC20 ABI - ✅ 从公共模块导入 */
-export interface DirectRouterSignConfig {
-    rpcUrl: string;
-    chainId?: number;
-    gasLimit?: number | bigint;
-    gasLimitMultiplier?: number;
-    gasPrice?: bigint;
-    minGasPriceGwei?: number;
-    maxGasPriceGwei?: number;
-    txType?: 0 | 2;
-    /** 是否跳过授权检查 */
-    skipApprovalCheck?: boolean;
-    /** 滑点（基点），默认 100 = 1% */
-    slippageBps?: number;
-    /** BlockRazor 贿赂金额（BNB），仅 BSC 链有效，用于提高 bundle 打包优先级 */
-    bribeAmount?: number;
-    /** ✅ 利润模式：'single'（默认，从最大钱包统一扣）或 'distributed'（每个钱包独立扣） */
-    profitMode?: 'single' | 'distributed';
-    /** ✅ 是否跳过利润扣除（EOA 普通模式使用） */
-    skipProfit?: boolean;
-}
-export interface DirectV2BuyParams {
-    chain: 'BSC' | 'MONAD' | 'XLAYER' | 'ENI';
-    privateKeys: string[];
-    buyAmounts: string[];
-    tokenAddress: string;
-    routerAddress: string;
-    quoteToken?: string;
-    quoteTokenDecimals?: number;
-    startNonces?: number[];
-    config: DirectRouterSignConfig;
-}
-export interface DirectV2SellParams {
-    chain: 'BSC' | 'MONAD' | 'XLAYER' | 'ENI';
-    privateKeys: string[];
-    sellPercentages?: number[];
-    sellAmounts?: string[];
-    startNonces?: number[];
-    tokenAddress: string;
-    tokenDecimals?: number;
-    routerAddress: string;
-    quoteToken?: string;
-    config: DirectRouterSignConfig;
-}
-export interface DirectV3BuyParams {
-    chain: 'BSC' | 'MONAD' | 'XLAYER' | 'ENI';
-    privateKeys: string[];
-    buyAmounts: string[];
-    tokenAddress: string;
-    routerAddress: string;
-    fee: number;
-    quoteToken?: string;
-    quoteTokenDecimals?: number;
-    startNonces?: number[];
-    config: DirectRouterSignConfig;
-}
-export interface DirectV3SellParams {
-    chain: 'BSC' | 'MONAD' | 'XLAYER' | 'ENI';
-    privateKeys: string[];
-    sellPercentages?: number[];
-    sellAmounts?: string[];
-    tokenAddress: string;
-    tokenDecimals?: number;
-    routerAddress: string;
-    fee: number;
-    quoteToken?: string;
-    startNonces?: number[];
-    config: DirectRouterSignConfig;
-}
-import type { GeneratedWallet } from '../utils/wallet.js';
-export interface DirectRouterResult {
-    signedTransactions: string[];
-    profitHopWallets?: GeneratedWallet[];
-    metadata?: {
-        profitMode?: 'single' | 'distributed';
-        profitAmount: string;
-        profitRecipient: string;
-        totalFlow: string;
-    };
-}
-/**
- * V2 批量买入（直接调用 Router）
- */
+import type { DirectV2BuyParams, DirectV2SellParams, DirectV3BuyParams, DirectV3SellParams, DirectRouterResult, DexKey, RouterVersion } from './types.js';
+export type { DirectV2BuyParams, DirectV2SellParams, DirectV3BuyParams, DirectV3SellParams, DirectRouterResult, DirectRouterSignConfig, DexKey, RouterVersion, } from './types.js';
+export { DIRECT_ROUTERS } from './direct-router-helpers.js';
 export declare function directV2BatchBuy(params: DirectV2BuyParams): Promise<DirectRouterResult>;
 /**
  * V2 批量卖出（直接调用 Router）
@@ -142,8 +22,6 @@ export declare function directV3BatchBuy(params: DirectV3BuyParams): Promise<Dir
  * - SwapRouter (旧版 Uniswap V3): exactInputSingle 含 deadline，multicall 不含 deadline
  */
 export declare function directV3BatchSell(params: DirectV3SellParams): Promise<DirectRouterResult>;
-export type DexKey = 'PANCAKESWAP' | 'UNISWAP' | 'POTATOSWAP' | 'DYORSWAP' | 'IROSWAP';
-export type RouterVersion = 'v2' | 'v3';
 /**
  * 根据链和 DEX 获取 Router 地址
  */