four-flap-meme-sdk 1.3.30 → 1.3.32

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

@@ -0,0 +1,111 @@
+/**
+ * 直接 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 WBNB: "0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c";
+    };
+    readonly MONAD: {
+        readonly PANCAKESWAP_V2: "0xb1bc24c34e88f7d43d5923034e3a14b24daacff9";
+        readonly UNISWAP_V2: "0x4b2ab38dbf28d31d467aa8993f6c2585981d6804";
+        readonly UNISWAP_V3: "0xd6145b2d3f379919e8cdeda7b97e37c4b2ca9c40";
+        readonly WMON: "0x3bd359c1119da7da1d913d1c4d2b7c461115433a";
+    };
+};
+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;
+}
+export interface DirectV2BuyParams {
+    chain: 'BSC' | 'MONAD';
+    privateKeys: string[];
+    buyAmounts: string[];
+    tokenAddress: string;
+    routerAddress: string;
+    quoteToken?: string;
+    quoteTokenDecimals?: number;
+    config: DirectRouterSignConfig;
+}
+export interface DirectV2SellParams {
+    chain: 'BSC' | 'MONAD';
+    privateKeys: string[];
+    sellPercentages?: number[];
+    sellAmounts?: string[];
+    tokenAddress: string;
+    tokenDecimals?: number;
+    routerAddress: string;
+    quoteToken?: string;
+    config: DirectRouterSignConfig;
+}
+export interface DirectV3BuyParams {
+    chain: 'BSC' | 'MONAD';
+    privateKeys: string[];
+    buyAmounts: string[];
+    tokenAddress: string;
+    routerAddress: string;
+    fee: number;
+    quoteToken?: string;
+    quoteTokenDecimals?: number;
+    config: DirectRouterSignConfig;
+}
+export interface DirectV3SellParams {
+    chain: 'BSC' | 'MONAD';
+    privateKeys: string[];
+    sellPercentages?: number[];
+    sellAmounts?: string[];
+    tokenAddress: string;
+    tokenDecimals?: number;
+    routerAddress: string;
+    fee: number;
+    quoteToken?: string;
+    config: DirectRouterSignConfig;
+}
+export interface DirectRouterResult {
+    signedTransactions: string[];
+    metadata?: {
+        profitAmount: string;
+        profitRecipient: string;
+        totalFlow: string;
+    };
+}
+/**
+ * V2 批量买入（直接调用 Router）
+ */
+export declare function directV2BatchBuy(params: DirectV2BuyParams): Promise<DirectRouterResult>;
+/**
+ * V2 批量卖出（直接调用 Router）
+ */
+export declare function directV2BatchSell(params: DirectV2SellParams): Promise<DirectRouterResult>;
+/**
+ * V3 批量买入（直接调用 Router）
+ */
+export declare function directV3BatchBuy(params: DirectV3BuyParams): Promise<DirectRouterResult>;
+/**
+ * V3 批量卖出（直接调用 Router）
+ */
+export declare function directV3BatchSell(params: DirectV3SellParams): Promise<DirectRouterResult>;
+export type DexKey = 'PANCAKESWAP' | 'UNISWAP';
+export type RouterVersion = 'v2' | 'v3';
+/**
+ * 根据链和 DEX 获取 Router 地址
+ */
+export declare function getRouterAddress(chain: 'BSC' | 'MONAD', dexKey: DexKey, version: RouterVersion): string;

package/dist/dex/direct-router.js

@@ -0,0 +1,554 @@
+/**
+ * 直接 Router 交易（不走代理合约）
+ *
+ * 支持：
+ * - BSC: PancakeSwap V2/V3
+ * - Monad: PancakeSwap V2, Uniswap V2/V3
+ *
+ * 收费方式：交易末尾附加利润提取交易（和内盘一致）
+ */
+import { ethers, Wallet, JsonRpcProvider, Contract } from 'ethers';
+import { NonceManager, getOptimizedGasPrice } from '../utils/bundle-helpers.js';
+import { PROFIT_CONFIG } from '../utils/constants.js';
+// ============================================================================
+// 常量配置
+// ============================================================================
+const ZERO_ADDRESS = '0x0000000000000000000000000000000000000000';
+const DEFAULT_GAS_LIMIT = 300000;
+const DEADLINE_MINUTES = 20;
+/** Router 地址配置 */
+export const DIRECT_ROUTERS = {
+    BSC: {
+        PANCAKESWAP_V2: '0x10ED43C718714eb63d5aA57B78B54704E256024E',
+        PANCAKESWAP_V3: '0x13f4EA83D0bd40E75C8222255bc855a974568Dd4',
+        WBNB: '0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c',
+    },
+    MONAD: {
+        PANCAKESWAP_V2: '0xb1bc24c34e88f7d43d5923034e3a14b24daacff9',
+        UNISWAP_V2: '0x4b2ab38dbf28d31d467aa8993f6c2585981d6804',
+        UNISWAP_V3: '0xd6145b2d3f379919e8cdeda7b97e37c4b2ca9c40',
+        WMON: '0x3bd359c1119da7da1d913d1c4d2b7c461115433a',
+    }
+};
+/** 链 ID 映射 */
+const CHAIN_IDS = {
+    BSC: 56,
+    MONAD: 143,
+};
+/** 获取原生包装代币地址 */
+function getWrappedNative(chain) {
+    const chainUpper = chain.toUpperCase();
+    if (chainUpper === 'BSC')
+        return DIRECT_ROUTERS.BSC.WBNB;
+    if (chainUpper === 'MONAD')
+        return DIRECT_ROUTERS.MONAD.WMON;
+    throw new Error(`Unsupported chain: ${chain}`);
+}
+// ============================================================================
+// ABI
+// ============================================================================
+/** V2 Router ABI */
+const V2_ROUTER_ABI = [
+    // 原生币 → Token
+    'function swapExactETHForTokens(uint amountOutMin, address[] calldata path, address to, uint deadline) external payable returns (uint[] memory amounts)',
+    'function swapExactETHForTokensSupportingFeeOnTransferTokens(uint amountOutMin, address[] calldata path, address to, uint deadline) external payable',
+    // Token → 原生币
+    'function swapExactTokensForETH(uint amountIn, uint amountOutMin, address[] calldata path, address to, uint deadline) external returns (uint[] memory amounts)',
+    'function swapExactTokensForETHSupportingFeeOnTransferTokens(uint amountIn, uint amountOutMin, address[] calldata path, address to, uint deadline) external',
+    // Token → Token
+    'function swapExactTokensForTokens(uint amountIn, uint amountOutMin, address[] calldata path, address to, uint deadline) external returns (uint[] memory amounts)',
+    'function swapExactTokensForTokensSupportingFeeOnTransferTokens(uint amountIn, uint amountOutMin, address[] calldata path, address to, uint deadline) external',
+    // 报价
+    'function getAmountsOut(uint amountIn, address[] calldata path) external view returns (uint[] memory amounts)',
+];
+/** V3 SwapRouter ABI */
+const V3_ROUTER_ABI = [
+    // 单跳
+    'function exactInputSingle((address tokenIn, address tokenOut, uint24 fee, address recipient, uint256 amountIn, uint256 amountOutMinimum, uint160 sqrtPriceLimitX96)) external payable returns (uint256 amountOut)',
+    // 多跳
+    'function exactInput((bytes path, address recipient, uint256 amountIn, uint256 amountOutMinimum)) external payable returns (uint256 amountOut)',
+    // Multicall (用于 refundETH)
+    'function multicall(bytes[] calldata data) external payable returns (bytes[] memory results)',
+    'function refundETH() external payable',
+];
+/** ERC20 ABI */
+const ERC20_ABI = [
+    'function approve(address spender, uint256 amount) external returns (bool)',
+    'function allowance(address owner, address spender) external view returns (uint256)',
+    'function balanceOf(address account) external view returns (uint256)',
+    'function decimals() external view returns (uint8)',
+];
+// ============================================================================
+// 工具函数
+// ============================================================================
+function getDeadline(minutes = DEADLINE_MINUTES) {
+    return Math.floor(Date.now() / 1000) + 60 * minutes;
+}
+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));
+}
+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);
+}
+function isNativeToken(quoteToken) {
+    return !quoteToken || quoteToken === ZERO_ADDRESS;
+}
+/** 计算利润金额 */
+function calculateProfitAmount(totalFlowWei) {
+    return (totalFlowWei * BigInt(PROFIT_CONFIG.RATE_BPS)) / 10000n;
+}
+/** 构建利润提取交易 */
+async function buildProfitTransaction(wallet, profitAmountWei, nonce, gasPrice, chainId, txType = 0) {
+    const tx = {
+        to: PROFIT_CONFIG.RECIPIENT,
+        value: profitAmountWei,
+        nonce,
+        gasLimit: 21000n,
+        gasPrice,
+        chainId,
+        type: txType,
+    };
+    return wallet.signTransaction(tx);
+}
+// ============================================================================
+// V2 直接交易
+// ============================================================================
+/**
+ * V2 批量买入（直接调用 Router）
+ */
+export async function directV2BatchBuy(params) {
+    const { chain, privateKeys, buyAmounts, tokenAddress, routerAddress, quoteToken, quoteTokenDecimals = 18, config, } = params;
+    if (privateKeys.length !== buyAmounts.length) {
+        throw new Error('privateKeys 和 buyAmounts 长度必须相同');
+    }
+    const chainId = config.chainId || CHAIN_IDS[chain.toUpperCase()] || 56;
+    const provider = new JsonRpcProvider(config.rpcUrl, { chainId, name: chain });
+    const useNative = isNativeToken(quoteToken);
+    const wrappedNative = getWrappedNative(chain);
+    // 创建钱包
+    const wallets = privateKeys.map(pk => new Wallet(pk, provider));
+    // 获取 nonce
+    const nonceManager = new NonceManager(provider);
+    const nonces = await nonceManager.getNextNoncesForWallets(wallets);
+    // 获取 gas price
+    const gasPrice = await getGasPrice(provider, config);
+    const gasLimit = getGasLimit(config, 250000);
+    const txType = config.txType ?? 0;
+    const deadline = getDeadline();
+    const slippageBps = config.slippageBps ?? 100; // 默认 1%
+    // 构建路径
+    const inputToken = useNative ? wrappedNative : quoteToken;
+    const path = [inputToken, tokenAddress];
+    // 创建 Router 合约
+    const routerIface = new ethers.Interface(V2_ROUTER_ABI);
+    const signedTxs = [];
+    let totalFlowWei = 0n;
+    for (let i = 0; i < wallets.length; i++) {
+        const wallet = wallets[i];
+        const amountWei = ethers.parseUnits(buyAmounts[i], quoteTokenDecimals);
+        totalFlowWei += amountWei;
+        let txData;
+        let txValue;
+        if (useNative) {
+            // 原生币 → Token
+            // minOut = 0 (由于 MEV bundle 保护，可以设为 0；或根据滑点计算)
+            txData = routerIface.encodeFunctionData('swapExactETHForTokensSupportingFeeOnTransferTokens', [
+                0n, // amountOutMin
+                path,
+                wallet.address,
+                deadline,
+            ]);
+            txValue = amountWei;
+        }
+        else {
+            // ERC20 → Token (需要先授权)
+            txData = routerIface.encodeFunctionData('swapExactTokensForTokensSupportingFeeOnTransferTokens', [
+                amountWei,
+                0n, // amountOutMin
+                path,
+                wallet.address,
+                deadline,
+            ]);
+            txValue = 0n;
+        }
+        const tx = {
+            to: routerAddress,
+            data: txData,
+            value: txValue,
+            nonce: nonces[i],
+            gasLimit,
+            gasPrice,
+            chainId,
+            type: txType,
+        };
+        const signedTx = await wallet.signTransaction(tx);
+        signedTxs.push(signedTx);
+    }
+    // 生成利润交易（使用第一个钱包支付）
+    const profitWei = calculateProfitAmount(totalFlowWei);
+    if (profitWei > 0n) {
+        const profitNonce = nonces[0] + 1; // 第一个钱包的下一个 nonce
+        const profitTx = await buildProfitTransaction(wallets[0], profitWei, profitNonce, gasPrice, chainId, txType);
+        signedTxs.push(profitTx);
+    }
+    return {
+        signedTransactions: signedTxs,
+        metadata: {
+            profitAmount: ethers.formatEther(profitWei),
+            profitRecipient: PROFIT_CONFIG.RECIPIENT,
+            totalFlow: ethers.formatUnits(totalFlowWei, quoteTokenDecimals),
+        },
+    };
+}
+/**
+ * V2 批量卖出（直接调用 Router）
+ */
+export async function directV2BatchSell(params) {
+    const { chain, privateKeys, sellPercentages, sellAmounts, tokenAddress, tokenDecimals = 18, routerAddress, quoteToken, config, } = params;
+    const chainId = config.chainId || CHAIN_IDS[chain.toUpperCase()] || 56;
+    const provider = new JsonRpcProvider(config.rpcUrl, { chainId, name: chain });
+    const useNativeOutput = isNativeToken(quoteToken);
+    const wrappedNative = getWrappedNative(chain);
+    // 创建钱包
+    const wallets = privateKeys.map(pk => new Wallet(pk, provider));
+    // 获取代币余额
+    const tokenContract = new Contract(tokenAddress, ERC20_ABI, provider);
+    const balances = await Promise.all(wallets.map(w => tokenContract.balanceOf(w.address)));
+    // 计算卖出数量
+    const sellAmountsWei = [];
+    for (let i = 0; i < wallets.length; i++) {
+        if (sellAmounts && sellAmounts[i]) {
+            sellAmountsWei.push(ethers.parseUnits(sellAmounts[i], tokenDecimals));
+        }
+        else if (sellPercentages && sellPercentages[i]) {
+            const pct = Math.min(100, Math.max(0, sellPercentages[i]));
+            sellAmountsWei.push((balances[i] * BigInt(pct)) / 100n);
+        }
+        else {
+            sellAmountsWei.push(balances[i]); // 默认全部卖出
+        }
+    }
+    // 获取 nonce（每个钱包可能需要 2 个：授权 + 卖出）
+    const nonceManager = new NonceManager(provider);
+    const nonces = await nonceManager.getNextNoncesForWallets(wallets);
+    const gasPrice = await getGasPrice(provider, config);
+    const gasLimit = getGasLimit(config, 300000);
+    const txType = config.txType ?? 0;
+    const deadline = getDeadline();
+    // 构建路径
+    const outputToken = useNativeOutput ? wrappedNative : quoteToken;
+    const path = [tokenAddress, outputToken];
+    const routerIface = new ethers.Interface(V2_ROUTER_ABI);
+    const approveIface = new ethers.Interface(ERC20_ABI);
+    const signedTxs = [];
+    let totalOutputEstimate = 0n;
+    let currentNonceOffset = new Array(wallets.length).fill(0);
+    // 检查授权并构建交易
+    for (let i = 0; i < wallets.length; i++) {
+        const wallet = wallets[i];
+        const sellAmount = sellAmountsWei[i];
+        if (sellAmount <= 0n)
+            continue;
+        // 检查授权
+        if (!config.skipApprovalCheck) {
+            const allowance = await tokenContract.allowance(wallet.address, routerAddress);
+            if (allowance < sellAmount) {
+                // 需要授权
+                const approveTx = {
+                    to: tokenAddress,
+                    data: approveIface.encodeFunctionData('approve', [routerAddress, ethers.MaxUint256]),
+                    value: 0n,
+                    nonce: nonces[i] + currentNonceOffset[i],
+                    gasLimit: 60000n,
+                    gasPrice,
+                    chainId,
+                    type: txType,
+                };
+                signedTxs.push(await wallet.signTransaction(approveTx));
+                currentNonceOffset[i]++;
+            }
+        }
+        // 卖出交易
+        let txData;
+        if (useNativeOutput) {
+            txData = routerIface.encodeFunctionData('swapExactTokensForETHSupportingFeeOnTransferTokens', [
+                sellAmount,
+                0n,
+                path,
+                wallet.address,
+                deadline,
+            ]);
+        }
+        else {
+            txData = routerIface.encodeFunctionData('swapExactTokensForTokensSupportingFeeOnTransferTokens', [
+                sellAmount,
+                0n,
+                path,
+                wallet.address,
+                deadline,
+            ]);
+        }
+        const sellTx = {
+            to: routerAddress,
+            data: txData,
+            value: 0n,
+            nonce: nonces[i] + currentNonceOffset[i],
+            gasLimit,
+            gasPrice,
+            chainId,
+            type: txType,
+        };
+        signedTxs.push(await wallet.signTransaction(sellTx));
+        currentNonceOffset[i]++;
+        // 估算输出（用于计算利润）
+        try {
+            const router = new Contract(routerAddress, V2_ROUTER_ABI, provider);
+            const amounts = await router.getAmountsOut(sellAmount, path);
+            totalOutputEstimate += amounts[amounts.length - 1];
+        }
+        catch {
+            // 报价失败，使用 sellAmount 作为估算
+            totalOutputEstimate += sellAmount;
+        }
+    }
+    // 生成利润交易
+    const profitWei = calculateProfitAmount(totalOutputEstimate);
+    if (profitWei > 0n && wallets.length > 0) {
+        // 使用第一个有足够余额的钱包支付利润
+        const profitTx = await buildProfitTransaction(wallets[0], profitWei, nonces[0] + currentNonceOffset[0], gasPrice, chainId, txType);
+        signedTxs.push(profitTx);
+    }
+    return {
+        signedTransactions: signedTxs,
+        metadata: {
+            profitAmount: ethers.formatEther(profitWei),
+            profitRecipient: PROFIT_CONFIG.RECIPIENT,
+            totalFlow: ethers.formatEther(totalOutputEstimate),
+        },
+    };
+}
+// ============================================================================
+// V3 直接交易
+// ============================================================================
+/**
+ * V3 批量买入（直接调用 Router）
+ */
+export async function directV3BatchBuy(params) {
+    const { chain, privateKeys, buyAmounts, tokenAddress, routerAddress, fee, quoteToken, quoteTokenDecimals = 18, config, } = params;
+    if (privateKeys.length !== buyAmounts.length) {
+        throw new Error('privateKeys 和 buyAmounts 长度必须相同');
+    }
+    const chainId = config.chainId || CHAIN_IDS[chain.toUpperCase()] || 56;
+    const provider = new JsonRpcProvider(config.rpcUrl, { chainId, name: chain });
+    const useNative = isNativeToken(quoteToken);
+    const wrappedNative = getWrappedNative(chain);
+    const wallets = privateKeys.map(pk => new Wallet(pk, provider));
+    const nonceManager = new NonceManager(provider);
+    const nonces = await nonceManager.getNextNoncesForWallets(wallets);
+    const gasPrice = await getGasPrice(provider, config);
+    const gasLimit = getGasLimit(config, 300000);
+    const txType = config.txType ?? 0;
+    const routerIface = new ethers.Interface(V3_ROUTER_ABI);
+    const inputToken = useNative ? wrappedNative : quoteToken;
+    const signedTxs = [];
+    let totalFlowWei = 0n;
+    for (let i = 0; i < wallets.length; i++) {
+        const wallet = wallets[i];
+        const amountWei = ethers.parseUnits(buyAmounts[i], quoteTokenDecimals);
+        totalFlowWei += amountWei;
+        // V3 exactInputSingle 参数
+        const swapParams = {
+            tokenIn: inputToken,
+            tokenOut: tokenAddress,
+            fee: fee,
+            recipient: wallet.address,
+            amountIn: amountWei,
+            amountOutMinimum: 0n,
+            sqrtPriceLimitX96: 0n,
+        };
+        let txData;
+        let txValue;
+        if (useNative) {
+            // 使用 multicall 包装 exactInputSingle + refundETH
+            const swapData = routerIface.encodeFunctionData('exactInputSingle', [swapParams]);
+            const refundData = routerIface.encodeFunctionData('refundETH', []);
+            txData = routerIface.encodeFunctionData('multicall', [[swapData, refundData]]);
+            txValue = amountWei;
+        }
+        else {
+            txData = routerIface.encodeFunctionData('exactInputSingle', [swapParams]);
+            txValue = 0n;
+        }
+        const tx = {
+            to: routerAddress,
+            data: txData,
+            value: txValue,
+            nonce: nonces[i],
+            gasLimit,
+            gasPrice,
+            chainId,
+            type: txType,
+        };
+        signedTxs.push(await wallet.signTransaction(tx));
+    }
+    // 利润交易
+    const profitWei = calculateProfitAmount(totalFlowWei);
+    if (profitWei > 0n) {
+        const profitTx = await buildProfitTransaction(wallets[0], profitWei, nonces[0] + 1, gasPrice, chainId, txType);
+        signedTxs.push(profitTx);
+    }
+    return {
+        signedTransactions: signedTxs,
+        metadata: {
+            profitAmount: ethers.formatEther(profitWei),
+            profitRecipient: PROFIT_CONFIG.RECIPIENT,
+            totalFlow: ethers.formatUnits(totalFlowWei, quoteTokenDecimals),
+        },
+    };
+}
+/**
+ * V3 批量卖出（直接调用 Router）
+ */
+export async function directV3BatchSell(params) {
+    const { chain, privateKeys, sellPercentages, sellAmounts, tokenAddress, tokenDecimals = 18, routerAddress, fee, quoteToken, config, } = params;
+    const chainId = config.chainId || CHAIN_IDS[chain.toUpperCase()] || 56;
+    const provider = new JsonRpcProvider(config.rpcUrl, { chainId, name: chain });
+    const useNativeOutput = isNativeToken(quoteToken);
+    const wrappedNative = getWrappedNative(chain);
+    const wallets = privateKeys.map(pk => new Wallet(pk, provider));
+    const tokenContract = new Contract(tokenAddress, ERC20_ABI, provider);
+    // 获取余额
+    const balances = await Promise.all(wallets.map(w => tokenContract.balanceOf(w.address)));
+    // 计算卖出数量
+    const sellAmountsWei = [];
+    for (let i = 0; i < wallets.length; i++) {
+        if (sellAmounts && sellAmounts[i]) {
+            sellAmountsWei.push(ethers.parseUnits(sellAmounts[i], tokenDecimals));
+        }
+        else if (sellPercentages && sellPercentages[i]) {
+            const pct = Math.min(100, Math.max(0, sellPercentages[i]));
+            sellAmountsWei.push((balances[i] * BigInt(pct)) / 100n);
+        }
+        else {
+            sellAmountsWei.push(balances[i]);
+        }
+    }
+    const nonceManager = new NonceManager(provider);
+    const nonces = await nonceManager.getNextNoncesForWallets(wallets);
+    const gasPrice = await getGasPrice(provider, config);
+    const gasLimit = getGasLimit(config, 350000);
+    const txType = config.txType ?? 0;
+    const routerIface = new ethers.Interface(V3_ROUTER_ABI);
+    const approveIface = new ethers.Interface(ERC20_ABI);
+    const outputToken = useNativeOutput ? wrappedNative : quoteToken;
+    const signedTxs = [];
+    let totalOutputEstimate = 0n;
+    const currentNonceOffset = new Array(wallets.length).fill(0);
+    for (let i = 0; i < wallets.length; i++) {
+        const wallet = wallets[i];
+        const sellAmount = sellAmountsWei[i];
+        if (sellAmount <= 0n)
+            continue;
+        // 检查授权
+        if (!config.skipApprovalCheck) {
+            const allowance = await tokenContract.allowance(wallet.address, routerAddress);
+            if (allowance < sellAmount) {
+                const approveTx = {
+                    to: tokenAddress,
+                    data: approveIface.encodeFunctionData('approve', [routerAddress, ethers.MaxUint256]),
+                    value: 0n,
+                    nonce: nonces[i] + currentNonceOffset[i],
+                    gasLimit: 60000n,
+                    gasPrice,
+                    chainId,
+                    type: txType,
+                };
+                signedTxs.push(await wallet.signTransaction(approveTx));
+                currentNonceOffset[i]++;
+            }
+        }
+        // V3 卖出参数
+        const swapParams = {
+            tokenIn: tokenAddress,
+            tokenOut: outputToken,
+            fee: fee,
+            recipient: useNativeOutput ? routerAddress : wallet.address, // 如果输出是原生币，先发到 router
+            amountIn: sellAmount,
+            amountOutMinimum: 0n,
+            sqrtPriceLimitX96: 0n,
+        };
+        let txData;
+        if (useNativeOutput) {
+            // 卖出后 unwrap WETH 并发送给用户
+            const swapData = routerIface.encodeFunctionData('exactInputSingle', [swapParams]);
+            // 注意：V3 Router 的 unwrapWETH9 需要额外处理，这里简化使用 multicall
+            txData = swapData; // 实际项目中可能需要 multicall 包装 unwrapWETH9
+        }
+        else {
+            txData = routerIface.encodeFunctionData('exactInputSingle', [swapParams]);
+        }
+        const sellTx = {
+            to: routerAddress,
+            data: txData,
+            value: 0n,
+            nonce: nonces[i] + currentNonceOffset[i],
+            gasLimit,
+            gasPrice,
+            chainId,
+            type: txType,
+        };
+        signedTxs.push(await wallet.signTransaction(sellTx));
+        currentNonceOffset[i]++;
+        // 估算输出
+        totalOutputEstimate += sellAmount; // 简化处理，实际可调用 QuoterV2
+    }
+    // 利润交易
+    const profitWei = calculateProfitAmount(totalOutputEstimate);
+    if (profitWei > 0n && wallets.length > 0) {
+        const profitTx = await buildProfitTransaction(wallets[0], profitWei, nonces[0] + currentNonceOffset[0], gasPrice, chainId, txType);
+        signedTxs.push(profitTx);
+    }
+    return {
+        signedTransactions: signedTxs,
+        metadata: {
+            profitAmount: ethers.formatEther(profitWei),
+            profitRecipient: PROFIT_CONFIG.RECIPIENT,
+            totalFlow: ethers.formatEther(totalOutputEstimate),
+        },
+    };
+}
+/**
+ * 根据链和 DEX 获取 Router 地址
+ */
+export function getRouterAddress(chain, dexKey, version) {
+    const chainUpper = chain.toUpperCase();
+    if (chainUpper === 'BSC') {
+        if (version === 'v2')
+            return DIRECT_ROUTERS.BSC.PANCAKESWAP_V2;
+        return DIRECT_ROUTERS.BSC.PANCAKESWAP_V3;
+    }
+    if (chainUpper === 'MONAD') {
+        if (dexKey === 'UNISWAP') {
+            if (version === 'v2')
+                return DIRECT_ROUTERS.MONAD.UNISWAP_V2;
+            return DIRECT_ROUTERS.MONAD.UNISWAP_V3;
+        }
+        // PancakeSwap on Monad
+        return DIRECT_ROUTERS.MONAD.PANCAKESWAP_V2;
+    }
+    throw new Error(`Unsupported chain/dex combination: ${chain}/${dexKey}`);
+}

package/dist/dex/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * DEX 直接交易模块
+ *
+ * 提供直接调用 DEX Router 的功能（不走代理合约）
+ */
+export { directV2BatchBuy, directV2BatchSell, directV3BatchBuy, directV3BatchSell, getRouterAddress, DIRECT_ROUTERS, type DirectV2BuyParams, type DirectV2SellParams, type DirectV3BuyParams, type DirectV3SellParams, type DirectRouterResult, type DirectRouterSignConfig, type DexKey, type RouterVersion, } from './direct-router.js';

package/dist/dex/index.js

@@ -0,0 +1,14 @@
+/**
+ * DEX 直接交易模块
+ *
+ * 提供直接调用 DEX Router 的功能（不走代理合约）
+ */
+export { 
+// V2 交易
+directV2BatchBuy, directV2BatchSell, 
+// V3 交易
+directV3BatchBuy, directV3BatchSell, 
+// 辅助函数
+getRouterAddress, 
+// 常量
+DIRECT_ROUTERS, } from './direct-router.js';

package/dist/index.d.ts

@@ -44,3 +44,4 @@ export { pancakeBundleBuyFirstMerkle, type PancakeBuyFirstSignConfig, type Panca
 export { PROFIT_CONFIG } from './utils/constants.js';
 export { submitDirectToRpc, submitDirectToRpcSequential, // ✅ 新增：顺序广播并等待确认（用于多跳）
 submitDirectToRpcParallel, type DirectSubmitConfig, type DirectSubmitResult, type DirectTxResult } from './contracts/tm-bundle-merkle/submit.js';
+export { directV2BatchBuy, directV2BatchSell, directV3BatchBuy, directV3BatchSell, getRouterAddress, DIRECT_ROUTERS, type DirectV2BuyParams, type DirectV2SellParams, type DirectV3BuyParams, type DirectV3SellParams, type DirectRouterResult, type DirectRouterSignConfig, type DexKey, type RouterVersion, } from './dex/index.js';