four-flap-meme-sdk 1.4.24 → 1.4.26

package/dist/contracts/tm-bundle-merkle/pancake-proxy.js

@@ -1,59 +1,37 @@
+/**
+ * PancakeSwap 官方 Router 交易模块
+ *
+ * ✅ 使用官方 PancakeSwap V2/V3 Router（非代理合约）
+ * - V2 Router: 0x10ED43C718714eb63d5aA57B78B54704E256024E
+ * - V3 Router: 0x13f4EA83D0bd40E75C8222255bc855a974568Dd4
+ * - V3 Quoter: 0xB048Bbc1Ee6b733FFfCFb9e9CeF7375518e25997
+ */
 import { ethers, Wallet, JsonRpcProvider, Contract, Interface } from 'ethers';
-import { NonceManager, getOptimizedGasPrice } from '../../utils/bundle-helpers.js';
-import { ADDRESSES } from '../../utils/constants.js';
+import { NonceManager, getOptimizedGasPrice, getDeadline, encodeV3Path } from '../../utils/bundle-helpers.js';
+import { ADDRESSES, BLOCKRAZOR_BUILDER_EOA } from '../../utils/constants.js';
+import { MULTICALL3_ABI, V2_ROUTER_ABI, V3_ROUTER02_ABI, V3_QUOTER_ABI, ERC20_ABI } from '../../abis/common.js';
 import { getTxType, getGasPriceConfig, shouldExtractProfit, calculateProfit, calculateBatchProfit, getProfitRecipient, getBribeAmount } from './config.js';
-// ✅ 已移除授权检查（前端负责确保授权）
-// ✅ BlockRazor Builder EOA 地址（用于贿赂）
-const BLOCKRAZOR_BUILDER_EOA = '0x1266C6bE60392A8Ff346E8d5ECCd3E69dD9c5F20';
-const MULTICALL3_ADDRESS = '0xcA11bde05977b3631167028862bE2a173976CA11';
-const MULTICALL3_ABI = [
-    'function aggregate3(tuple(address target, bool allowFailure, bytes callData)[] calls) external payable returns (tuple(bool success, bytes returnData)[])'
-];
-// 常量
-const WBNB_ADDRESS = '0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c';
-const FLAT_FEE = 0n; // ✅ 已移除合约固定手续费
-const DEFAULT_GAS_LIMIT = 800000; // ✅ 改为 number，配合 getGasLimit 使用
-const DEADLINE_MINUTES = 20;
-// PancakeSwapProxy ABI（PancakeSwap V3 没有 deadline 参数）
-const PANCAKE_PROXY_ABI = [
-    'function swapV2(uint256 amountIn, uint256 amountOutMin, address[] calldata path, address to, uint256 deadline) external payable returns (uint256 amountOut)',
-    'function swapV3Single(address tokenIn, address tokenOut, uint24 fee, uint256 amountIn, uint256 amountOutMin, address to) external payable returns (uint256 amountOut)',
-    'function swapV3MultiHop(address[] calldata lpAddresses, address exactTokenIn, uint256 amountIn, uint256 amountOutMin, address to) external payable returns (uint256 amountOut)'
-];
-// PancakeSwap V2 Router ABI（用于报价）
-const PANCAKE_V2_ROUTER_ABI = [
-    'function getAmountsOut(uint amountIn, address[] calldata path) external view returns (uint[] memory amounts)'
-];
-// PancakeSwap V3 QuoterV2 ABI（用于报价）
-const PANCAKE_V3_QUOTER_ABI = [
-    'function quoteExactInputSingle((address tokenIn, address tokenOut, uint256 amountIn, uint24 fee, uint160 sqrtPriceLimitX96)) external returns (uint256 amountOut, uint160 sqrtPriceX96After, uint32 initializedTicksCrossed, uint256 gasEstimate)'
-];
-const PANCAKE_V2_ROUTER_ADDRESS = '0x10ED43C718714eb63d5aA57B78B54704E256024E';
-const PANCAKE_V3_QUOTER_ADDRESS = '0xB048Bbc1Ee6b733FFfCFb9e9CeF7375518e25997';
-// 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)'
-];
+// ==================== 常量 ====================
+const MULTICALL3_ADDRESS = ADDRESSES.BSC.Multicall3;
+const WBNB_ADDRESS = ADDRESSES.BSC.WBNB;
+const DEFAULT_GAS_LIMIT = 800000;
+// ✅ PancakeSwap 官方合约地址
+const PANCAKE_V2_ROUTER_ADDRESS = ADDRESSES.BSC.PancakeV2Router;
+const PANCAKE_V3_ROUTER_ADDRESS = ADDRESSES.BSC.PancakeV3Router;
+const PANCAKE_V3_QUOTER_ADDRESS = ADDRESSES.BSC.PancakeV3Quoter;
+// ==================== ABI 别名（从公共模块导入）====================
+// ✅ 使用公共 ABI：V2_ROUTER_ABI, V3_ROUTER02_ABI (as V3_ROUTER_ABI), V3_QUOTER_ABI, ERC20_ABI, MULTICALL3_ABI
+const V3_ROUTER_ABI = V3_ROUTER02_ABI;
 // ==================== 辅助函数 ====================
 /**
  * 获取 Gas Limit
- * 优先使用 config.gasLimit，否则使用默认值 * multiplier
- *
- * ✅ ethers v6 最佳实践：直接使用 bigint 类型
  */
 function getGasLimit(config, defaultGas = DEFAULT_GAS_LIMIT) {
-    // 优先使用前端传入的 gasLimit
     if (config.gasLimit !== undefined) {
-        // 如果已经是 bigint，直接返回；否则转换
         return typeof config.gasLimit === 'bigint' ? config.gasLimit : BigInt(config.gasLimit);
     }
-    // 使用默认值 * multiplier
     const multiplier = config.gasLimitMultiplier ?? 1.0;
     const calculatedGas = Math.ceil(defaultGas * multiplier);
-    // JavaScript 原生 BigInt 转换（ethers v6 兼容）
     return BigInt(calculatedGas);
 }
 /**
@@ -66,12 +44,11 @@ async function getTokenDecimals(tokenAddress, provider) {
         return Number(decimals);
     }
     catch {
-        // 默认返回 18，兼容大部分 ERC20
         return 18;
     }
 }
 /**
- * 判断是否需要发送 BNB（tokenIn 是 WBNB 时）
+ * 判断是否需要发送 BNB
  */
 function needSendBNB(routeType, params) {
     if (routeType === 'v2' && params.v2Path && params.v2Path[0].toLowerCase() === WBNB_ADDRESS.toLowerCase()) {
@@ -85,50 +62,149 @@ function needSendBNB(routeType, params) {
     }
     return false;
 }
+// ✅ getDeadline 从 bundle-helpers.js 导入
 /**
- * 计算 deadline
+ * ✅ 构建 V2 交易（使用官方 Router）
  */
-function getDeadline(minutes = DEADLINE_MINUTES) {
-    return Math.floor(Date.now() / 1000) + 60 * minutes;
-}
-/**
- * 构建 V2 交易
- */
-async function buildV2Transactions(proxies, wallets, amountsWei, minOuts, path, isBuy, needBNB) {
+async function buildV2Transactions(routers, wallets, amountsWei, minOuts, path, isBuy, needBNB) {
     const deadline = getDeadline();
-    return Promise.all(proxies.map((proxy, i) => {
-        const txValue = (isBuy && needBNB) ? amountsWei[i] + FLAT_FEE : FLAT_FEE;
-        return proxy.swapV2.populateTransaction(amountsWei[i], minOuts[i], path, wallets[i].address, deadline, { value: txValue });
+    return Promise.all(routers.map(async (router, i) => {
+        if (isBuy && needBNB) {
+            // ✅ 买入：BNB → Token，使用 swapExactETHForTokensSupportingFeeOnTransferTokens
+            return router.swapExactETHForTokensSupportingFeeOnTransferTokens.populateTransaction(minOuts[i], // amountOutMin
+            path, // path
+            wallets[i].address, // to
+            deadline, // deadline
+            { value: amountsWei[i] } // 发送的 BNB
+            );
+        }
+        else {
+            // ✅ 卖出：Token → BNB，使用 swapExactTokensForETHSupportingFeeOnTransferTokens
+            return router.swapExactTokensForETHSupportingFeeOnTransferTokens.populateTransaction(amountsWei[i], // amountIn
+            minOuts[i], // amountOutMin
+            path, // path
+            wallets[i].address, // to
+            deadline // deadline
+            );
+        }
     }));
 }
 /**
- * 构建 V3 单跳交易（PancakeSwap V3 没有 deadline）
+ * ✅ 构建 V3 单跳交易（使用官方 SwapRouter02 + multicall）
  */
-async function buildV3SingleTransactions(proxies, wallets, tokenIn, tokenOut, fee, amountsWei, minOuts, isBuy, needBNB) {
-    return Promise.all(proxies.map((proxy, i) => {
-        const txValue = (isBuy && needBNB) ? amountsWei[i] + FLAT_FEE : FLAT_FEE;
-        return proxy.swapV3Single.populateTransaction(tokenIn, tokenOut, fee, amountsWei[i], minOuts[i], wallets[i].address, { value: txValue });
+async function buildV3SingleTransactions(routers, wallets, tokenIn, tokenOut, fee, amountsWei, minOuts, isBuy, needBNB) {
+    const deadline = getDeadline();
+    const v3RouterIface = new Interface(V3_ROUTER_ABI);
+    return Promise.all(routers.map(async (router, i) => {
+        const isTokenOutWBNB = tokenOut.toLowerCase() === WBNB_ADDRESS.toLowerCase();
+        // ✅ 构建 exactInputSingle calldata
+        const exactInputSingleData = v3RouterIface.encodeFunctionData('exactInputSingle', [{
+                tokenIn: tokenIn,
+                tokenOut: tokenOut,
+                fee: fee,
+                recipient: isTokenOutWBNB ? PANCAKE_V3_ROUTER_ADDRESS : wallets[i].address, // 如果输出是 WBNB，先发给 Router
+                amountIn: amountsWei[i],
+                amountOutMinimum: minOuts[i],
+                sqrtPriceLimitX96: 0n
+            }]);
+        if (isBuy && needBNB) {
+            // ✅ 买入：BNB → Token，只需要 exactInputSingle
+            // 通过 multicall 包装，传入 deadline 和 ETH value
+            return router.multicall.populateTransaction(deadline, [exactInputSingleData], { value: amountsWei[i] });
+        }
+        else if (!isBuy && isTokenOutWBNB) {
+            // ✅ 卖出：Token → WBNB → BNB，需要 exactInputSingle + unwrapWETH9
+            const unwrapData = v3RouterIface.encodeFunctionData('unwrapWETH9', [
+                minOuts[i], // amountMinimum
+                wallets[i].address // recipient
+            ]);
+            return router.multicall.populateTransaction(deadline, [exactInputSingleData, unwrapData]);
+        }
+        else {
+            // ✅ Token → Token，只需要 exactInputSingle
+            return router.multicall.populateTransaction(deadline, [exactInputSingleData]);
+        }
     }));
 }
 /**
- * 构建 V3 多跳交易（PancakeSwap V3 没有 deadline）
+ * ✅ 构建 V3 多跳交易（使用官方 SwapRouter02 的 exactInput）
+ *
+ * @param routers - V3 Router 合约数组
+ * @param wallets - 钱包数组
+ * @param tokens - 代币路径 [tokenIn, tokenMid1, ..., tokenOut]
+ * @param fees - 费率路径 [fee0, fee1, ...]
+ * @param amountsWei - 每个钱包的输入金额
+ * @param minOuts - 最小输出金额
+ * @param isBuy - 是否为买入操作
+ * @param needBNB - 是否需要发送 BNB
  */
-async function buildV3MultiHopTransactions(proxies, wallets, lpAddresses, exactTokenIn, amountsWei, minOuts, isBuy, needBNB) {
-    return Promise.all(proxies.map((proxy, i) => {
-        const txValue = (isBuy && needBNB) ? amountsWei[i] + FLAT_FEE : FLAT_FEE;
-        return proxy.swapV3MultiHop.populateTransaction(lpAddresses, exactTokenIn, amountsWei[i], minOuts[i], wallets[i].address, { value: txValue });
+async function buildV3MultiHopTransactions(routers, wallets, tokens, fees, amountsWei, minOuts, isBuy, needBNB) {
+    if (!tokens || tokens.length < 2) {
+        throw new Error('V3 多跳需要至少 2 个代币（v3Tokens）');
+    }
+    if (!fees || fees.length !== tokens.length - 1) {
+        throw new Error(`V3 多跳费率数量 (${fees?.length || 0}) 必须等于代币数量 - 1 (${tokens.length - 1})（v3Fees）`);
+    }
+    const deadline = getDeadline();
+    const v3RouterIface = new Interface(V3_ROUTER_ABI);
+    // 编码正向 path（用于买入：BNB → Token）
+    const forwardPath = encodeV3Path(tokens, fees);
+    // 编码反向 path（用于卖出：Token → BNB）
+    const reversedTokens = [...tokens].reverse();
+    const reversedFees = [...fees].reverse();
+    const reversePath = encodeV3Path(reversedTokens, reversedFees);
+    const tokenOut = tokens[tokens.length - 1];
+    const isTokenOutWBNB = tokenOut.toLowerCase() === WBNB_ADDRESS.toLowerCase();
+    return Promise.all(routers.map(async (router, i) => {
+        if (isBuy && needBNB) {
+            // ✅ 买入：BNB → ... → Token
+            const swapData = v3RouterIface.encodeFunctionData('exactInput', [{
+                    path: forwardPath,
+                    recipient: wallets[i].address,
+                    amountIn: amountsWei[i],
+                    amountOutMinimum: minOuts[i]
+                }]);
+            return router.multicall.populateTransaction(deadline, [swapData], { value: amountsWei[i] });
+        }
+        else if (!isBuy) {
+            // ✅ 卖出：Token → ... → BNB
+            const swapData = v3RouterIface.encodeFunctionData('exactInput', [{
+                    path: reversePath,
+                    recipient: isTokenOutWBNB ? PANCAKE_V3_ROUTER_ADDRESS : wallets[i].address,
+                    amountIn: amountsWei[i],
+                    amountOutMinimum: minOuts[i]
+                }]);
+            if (isTokenOutWBNB) {
+                // 需要 unwrapWETH9
+                const unwrapData = v3RouterIface.encodeFunctionData('unwrapWETH9', [
+                    minOuts[i],
+                    wallets[i].address
+                ]);
+                return router.multicall.populateTransaction(deadline, [swapData, unwrapData]);
+            }
+            return router.multicall.populateTransaction(deadline, [swapData]);
+        }
+        else {
+            // Token → Token（不需要 BNB）
+            const swapData = v3RouterIface.encodeFunctionData('exactInput', [{
+                    path: forwardPath,
+                    recipient: wallets[i].address,
+                    amountIn: amountsWei[i],
+                    amountOutMinimum: minOuts[i]
+                }]);
+            return router.multicall.populateTransaction(deadline, [swapData]);
+        }
     }));
 }
 /**
- * ✅ 使用 Multicall3 批量获取 V2 报价（单次 RPC）
+ * ✅ 使用 Multicall3 批量获取 V2 报价
  */
 async function batchGetV2Quotes(provider, amountsWei, v2Path) {
     if (amountsWei.length === 0)
         return [];
-    // 如果只有 1 个，直接调用（避免 multicall 开销）
     if (amountsWei.length === 1) {
         try {
-            const v2Router = new Contract(PANCAKE_V2_ROUTER_ADDRESS, PANCAKE_V2_ROUTER_ABI, provider);
+            const v2Router = new Contract(PANCAKE_V2_ROUTER_ADDRESS, V2_ROUTER_ABI, provider);
             const amounts = await v2Router.getAmountsOut(amountsWei[0], v2Path);
             return [amounts[amounts.length - 1]];
         }
@@ -137,7 +213,7 @@ async function batchGetV2Quotes(provider, amountsWei, v2Path) {
         }
     }
     try {
-        const v2RouterIface = new Interface(PANCAKE_V2_ROUTER_ABI);
+        const v2RouterIface = new Interface(V2_ROUTER_ABI);
         const multicall = new Contract(MULTICALL3_ADDRESS, MULTICALL3_ABI, provider);
         const calls = amountsWei.map(amount => ({
             target: PANCAKE_V2_ROUTER_ADDRESS,
@@ -160,10 +236,9 @@ async function batchGetV2Quotes(provider, amountsWei, v2Path) {
         });
     }
     catch {
-        // Multicall 失败，回退到并行调用
         return await Promise.all(amountsWei.map(async (amount) => {
             try {
-                const v2Router = new Contract(PANCAKE_V2_ROUTER_ADDRESS, PANCAKE_V2_ROUTER_ABI, provider);
+                const v2Router = new Contract(PANCAKE_V2_ROUTER_ADDRESS, V2_ROUTER_ABI, provider);
                 const amounts = await v2Router.getAmountsOut(amount, v2Path);
                 return amounts[amounts.length - 1];
             }
@@ -173,26 +248,34 @@ async function batchGetV2Quotes(provider, amountsWei, v2Path) {
         }));
     }
 }
+/**
+ * 根据 routeType 获取授权目标地址
+ */
+function getApprovalTarget(routeType) {
+    if (routeType === 'v2') {
+        return PANCAKE_V2_ROUTER_ADDRESS;
+    }
+    // V3 路由授权给 V3 Router
+    return PANCAKE_V3_ROUTER_ADDRESS;
+}
 // ==================== 主要导出函数 ====================
 /**
- * 授权代币给 PancakeSwapProxy
+ * ✅ 授权代币给 PancakeSwap Router（根据 routeType 选择 V2/V3）
  */
 export async function approveFourPancakeProxy(params) {
-    const { privateKey, tokenAddress, amount, rpcUrl } = params;
-    const pancakeProxyAddress = ADDRESSES.BSC.PancakeProxy;
+    const { privateKey, tokenAddress, amount, rpcUrl, routeType } = params;
+    // 根据 routeType 选择授权目标
+    const approvalTarget = getApprovalTarget(routeType || 'v2');
     const provider = new JsonRpcProvider(rpcUrl);
     const wallet = new Wallet(privateKey, provider);
     const token = new Contract(tokenAddress, ERC20_ABI, wallet);
-    // 查询 decimals
     const decimals = await getTokenDecimals(tokenAddress, provider);
-    // 检查当前授权额度
-    const currentAllowance = await token.allowance(wallet.address, pancakeProxyAddress);
+    const currentAllowance = await token.allowance(wallet.address, approvalTarget);
     const amountBigInt = amount === 'max' ? ethers.MaxUint256 : ethers.parseUnits(amount, decimals);
     if (currentAllowance >= amountBigInt) {
         return { txHash: '', approved: true };
     }
-    // 执行授权
-    const tx = await token.approve(pancakeProxyAddress, amountBigInt);
+    const tx = await token.approve(approvalTarget, amountBigInt);
     const receipt = await tx.wait();
     return {
         txHash: receipt.hash,
@@ -200,26 +283,26 @@ export async function approveFourPancakeProxy(params) {
     };
 }
 /**
- * 批量授权代币给 PancakeSwapProxy（内部直接广播提交）
+ * ✅ 批量授权代币给 PancakeSwap Router
  */
 export async function approveFourPancakeProxyBatch(params) {
-    const { privateKeys, tokenAddress, amounts, config } = params;
+    const { privateKeys, tokenAddress, amounts, config, routeType } = params;
     if (privateKeys.length === 0 || amounts.length !== privateKeys.length) {
         throw new Error('Private key count and amount count must match');
     }
-    const pancakeProxyAddress = ADDRESSES.BSC.PancakeProxy;
+    // 根据 routeType 选择授权目标
+    const approvalTarget = getApprovalTarget(routeType || 'v2');
     const provider = new ethers.JsonRpcProvider(config.rpcUrl, {
         chainId: 56,
         name: 'BSC'
     });
     const gasPrice = await getOptimizedGasPrice(provider, getGasPriceConfig(config));
-    // 查询 decimals
     const decimals = await getTokenDecimals(tokenAddress, provider);
     const wallets = privateKeys.map(k => new Wallet(k, provider));
     const amountsBigInt = amounts.map(a => a === 'max' ? ethers.MaxUint256 : ethers.parseUnits(a, decimals));
-    // 检查现有授权，过滤掉已经足够的
+    // 检查现有授权
     const tokens = wallets.map(w => new Contract(tokenAddress, ERC20_ABI, w));
-    const allowances = await Promise.all(tokens.map((token, i) => token.allowance(wallets[i].address, pancakeProxyAddress)));
+    const allowances = await Promise.all(tokens.map((token, i) => token.allowance(wallets[i].address, approvalTarget)));
     // 只授权不足的
     const needApproval = wallets.filter((_, i) => allowances[i] < amountsBigInt[i]);
     const needApprovalAmounts = amountsBigInt.filter((amount, i) => allowances[i] < amount);
@@ -233,10 +316,8 @@ export async function approveFourPancakeProxyBatch(params) {
     }
     // 构建授权交易
     const needApprovalTokens = needApproval.map(w => new Contract(tokenAddress, ERC20_ABI, w));
-    const unsignedApprovals = await Promise.all(needApprovalTokens.map((token, i) => token.approve.populateTransaction(pancakeProxyAddress, needApprovalAmounts[i])));
-    // 使用前端传入的 gasLimit，否则使用默认值
+    const unsignedApprovals = await Promise.all(needApprovalTokens.map((token, i) => token.approve.populateTransaction(approvalTarget, needApprovalAmounts[i])));
     const finalGasLimit = getGasLimit(config);
-    // 签名授权交易
     const nonceManager = new NonceManager(provider);
     const nonces = await Promise.all(needApproval.map(w => nonceManager.getNextNonce(w)));
     const txType = getTxType(config);
@@ -250,7 +331,7 @@ export async function approveFourPancakeProxyBatch(params) {
         type: txType
     })));
     nonceManager.clearTemp();
-    // ✅ 内部直接广播提交（逐个发送）
+    // 广播交易
     const txHashes = [];
     const errors = [];
     for (let i = 0; i < signedTxs.length; i++) {
@@ -283,57 +364,47 @@ export async function approveFourPancakeProxyBatch(params) {
     }
 }
 /**
- * 使用 PancakeSwapProxy 批量购买代币（Merkle 版本）
+ * ✅ 使用 PancakeSwap 官方 Router 批量购买代币
  */
 export async function fourPancakeProxyBatchBuyMerkle(params) {
     const { privateKeys, buyAmounts, tokenAddress, routeType, config } = params;
     if (privateKeys.length === 0 || buyAmounts.length !== privateKeys.length) {
         throw new Error('Private key count and buy amount count must match');
     }
-    const pancakeProxyAddress = ADDRESSES.BSC.PancakeProxy;
-    // ✅ 直接使用传入的 RPC URL 创建 provider（不依赖 Merkle）
     const provider = new ethers.JsonRpcProvider(config.rpcUrl, {
         chainId: 56,
         name: 'BSC'
     });
     const txType = getTxType(config);
     const buyers = privateKeys.map(k => new Wallet(k, provider));
-    const originalAmountsWei = buyAmounts.map(a => ethers.parseEther(a)); // BNB 固定 18 位
-    // ✅ 利润提取配置
+    const originalAmountsWei = buyAmounts.map(a => ethers.parseEther(a));
     const extractProfit = shouldExtractProfit(config);
     const { totalProfit, remainingAmounts } = calculateBatchProfit(originalAmountsWei, config);
-    const actualAmountsWei = remainingAmounts; // 扣除利润后用于购买的金额
+    const actualAmountsWei = remainingAmounts;
     const finalGasLimit = getGasLimit(config);
     const nonceManager = new NonceManager(provider);
-    // ✅ 获取贿赂金额
     const bribeAmount = getBribeAmount(config);
     const needBribeTx = bribeAmount > 0n;
-    // ✅ 优化：并行获取 gasPrice 和 tokenDecimals
     const [gasPrice, tokenDecimals] = await Promise.all([
         getOptimizedGasPrice(provider, getGasPriceConfig(config)),
         getTokenDecimals(tokenAddress, provider)
     ]);
-    // ✅ 修复：先计算需要的 nonce 数量，再统一获取
-    // buyers[0] 可能需要 3 个 nonce（贿赂 + 买入 + 利润转账）
+    // 计算 nonce 分配
     const needProfitTx = extractProfit && totalProfit > 0n;
-    let buyer0NeedCount = 1; // 买入交易
+    let buyer0NeedCount = 1;
     if (needBribeTx)
-        buyer0NeedCount++; // 贿赂交易
+        buyer0NeedCount++;
     if (needProfitTx)
-        buyer0NeedCount++; // 利润交易
-    // 获取 buyers[0] 的连续 nonces
+        buyer0NeedCount++;
     const buyer0Nonces = await nonceManager.getNextNonceBatch(buyers[0], buyer0NeedCount);
-    // 获取其他 buyers 的 nonces（如果有）
     let otherNonces = [];
     if (buyers.length > 1) {
         otherNonces = await nonceManager.getNextNoncesForWallets(buyers.slice(1));
     }
-    // 分配 nonces
     let buyer0NonceIdx = 0;
     const bribeNonce = needBribeTx ? buyer0Nonces[buyer0NonceIdx++] : undefined;
     const buyer0BuyNonce = buyer0Nonces[buyer0NonceIdx++];
     const profitNonce = needProfitTx ? buyer0Nonces[buyer0NonceIdx] : undefined;
-    // 组装最终的 nonces 数组
     const nonces = [buyer0BuyNonce, ...otherNonces];
     // 计算 minOutputAmounts
     let minOuts;
@@ -343,35 +414,41 @@ export async function fourPancakeProxyBatchBuyMerkle(params) {
     else {
         minOuts = new Array(buyers.length).fill(0n);
     }
-    // 判断是否需要发送 BNB
     const needBNB = needSendBNB(routeType, params);
-    // 构建交易（使用扣除利润后的金额）
-    const proxies = buyers.map(w => new Contract(pancakeProxyAddress, PANCAKE_PROXY_ABI, w));
+    // ✅ 使用官方 Router
+    let routers;
     let unsignedBuys;
     if (routeType === 'v2') {
         if (!params.v2Path || params.v2Path.length < 2) {
             throw new Error('v2Path is required for V2 routing');
         }
-        unsignedBuys = await buildV2Transactions(proxies, buyers, actualAmountsWei, minOuts, params.v2Path, true, needBNB);
+        routers = buyers.map(w => new Contract(PANCAKE_V2_ROUTER_ADDRESS, V2_ROUTER_ABI, w));
+        unsignedBuys = await buildV2Transactions(routers, buyers, actualAmountsWei, minOuts, params.v2Path, true, needBNB);
     }
     else if (routeType === 'v3-single') {
         if (!params.v3TokenIn || !params.v3Fee) {
             throw new Error('v3TokenIn and v3Fee are required for V3 single-hop');
         }
-        unsignedBuys = await buildV3SingleTransactions(proxies, buyers, params.v3TokenIn, tokenAddress, params.v3Fee, actualAmountsWei, minOuts, true, needBNB);
+        routers = buyers.map(w => new Contract(PANCAKE_V3_ROUTER_ADDRESS, V3_ROUTER_ABI, w));
+        unsignedBuys = await buildV3SingleTransactions(routers, buyers, params.v3TokenIn, tokenAddress, params.v3Fee, actualAmountsWei, minOuts, true, needBNB);
     }
     else if (routeType === 'v3-multi') {
-        if (!params.v3LpAddresses || params.v3LpAddresses.length === 0 || !params.v3ExactTokenIn) {
-            throw new Error('v3LpAddresses and v3ExactTokenIn are required for V3 multi-hop');
+        // ✅ V3 多跳：需要 v3Tokens 和 v3Fees 参数
+        if (!params.v3Tokens || params.v3Tokens.length < 2) {
+            throw new Error('v3Tokens（至少 2 个代币）是 V3 多跳必需的');
         }
-        unsignedBuys = await buildV3MultiHopTransactions(proxies, buyers, params.v3LpAddresses, params.v3ExactTokenIn, actualAmountsWei, minOuts, true, needBNB);
+        if (!params.v3Fees || params.v3Fees.length !== params.v3Tokens.length - 1) {
+            throw new Error(`v3Fees 长度必须等于 v3Tokens 长度 - 1`);
+        }
+        routers = buyers.map(w => new Contract(PANCAKE_V3_ROUTER_ADDRESS, V3_ROUTER_ABI, w));
+        unsignedBuys = await buildV3MultiHopTransactions(routers, buyers, params.v3Tokens, params.v3Fees, actualAmountsWei, minOuts, true, needBNB);
     }
     else {
         throw new Error(`Unsupported routeType: ${routeType}`);
     }
-    // ✅ 并行签名所有交易（贿赂、买入、利润）
+    // 签名交易
     const signPromises = [];
-    // 贿赂交易（索引 0）
+    // 贿赂交易
     if (needBribeTx && bribeNonce !== undefined) {
         signPromises.push(buyers[0].signTransaction({
             to: BLOCKRAZOR_BUILDER_EOA,
@@ -383,7 +460,7 @@ export async function fourPancakeProxyBatchBuyMerkle(params) {
             type: txType
         }));
     }
-    // 买入交易（索引 1 ~ N）
+    // 买入交易
     unsignedBuys.forEach((unsigned, i) => {
         signPromises.push(buyers[i].signTransaction({
             ...unsigned,
@@ -396,7 +473,7 @@ export async function fourPancakeProxyBatchBuyMerkle(params) {
             value: unsigned.value
         }));
     });
-    // 利润交易（索引 N+1）
+    // 利润交易
     if (extractProfit && totalProfit > 0n && profitNonce !== undefined) {
         signPromises.push(buyers[0].signTransaction({
             to: getProfitRecipient(),
@@ -408,28 +485,20 @@ export async function fourPancakeProxyBatchBuyMerkle(params) {
             type: txType
         }));
     }
-    // ✅ 并行签名完成后按顺序返回
     const signedTxs = await Promise.all(signPromises);
-    // ✅ 清理临时 nonce 缓存
     nonceManager.clearTemp();
-    // ✅ 直接返回签名交易（不提交到Merkle）
-    // ✅ 简化返回：只返回签名交易
     return {
         signedTransactions: signedTxs
     };
 }
 /**
- * 使用 PancakeSwapProxy 批量卖出代币（仅签名版本 - 不依赖 Merkle）
- * ✅ 精简版：只负责签名交易，不提交到 Merkle
- * ✅ 自动检查授权，智能处理授权+卖出
+ * ✅ 使用 PancakeSwap 官方 Router 批量卖出代币
  */
 export async function fourPancakeProxyBatchSellMerkle(params) {
     const { privateKeys, sellAmounts, tokenAddress, routeType, config } = params;
     if (privateKeys.length === 0 || sellAmounts.length !== privateKeys.length) {
         throw new Error('Private key count and sell amount count must match');
     }
-    const pancakeProxyAddress = ADDRESSES.BSC.PancakeProxy;
-    // ✅ 直接使用传入的 RPC URL 创建 provider（不依赖 Merkle）
     const provider = new ethers.JsonRpcProvider(config.rpcUrl, {
         chainId: 56,
         name: 'BSC'
@@ -439,26 +508,22 @@ export async function fourPancakeProxyBatchSellMerkle(params) {
     const finalGasLimit = getGasLimit(config);
     const nonceManager = new NonceManager(provider);
     const extractProfit = shouldExtractProfit(config);
-    // ✅ 获取贿赂金额
     const bribeAmount = getBribeAmount(config);
     const needBribeTx = bribeAmount > 0n;
-    // ✅ 优化：并行获取 gasPrice 和 tokenDecimals（已移除授权检查，前端负责）
     const [gasPrice, tokenDecimals] = await Promise.all([
         getOptimizedGasPrice(provider, getGasPriceConfig(config)),
         getTokenDecimals(tokenAddress, provider)
     ]);
     const amountsWei = sellAmounts.map(a => ethers.parseUnits(a, tokenDecimals));
-    // ✅ 获取报价（用于计算利润），已移除滑点保护
+    // 获取报价
     let quotedOutputs;
-    // ✅ 使用 Multicall3 批量获取报价（仅 V2 路由支持）
     if (routeType === 'v2' && params.v2Path && params.v2Path.length >= 2) {
         quotedOutputs = await batchGetV2Quotes(provider, amountsWei, params.v2Path);
     }
     else if (routeType === 'v3-single') {
-        // V3 单跳：并行调用（V3 Quoter 是 non-view 函数，不支持 Multicall3）
         quotedOutputs = await Promise.all(amountsWei.map(async (amount) => {
             try {
-                const quoter = new Contract(PANCAKE_V3_QUOTER_ADDRESS, PANCAKE_V3_QUOTER_ABI, provider);
+                const quoter = new Contract(PANCAKE_V3_QUOTER_ADDRESS, V3_QUOTER_ABI, provider);
                 const result = await quoter.quoteExactInputSingle.staticCall({
                     tokenIn: tokenAddress,
                     tokenOut: params.v3TokenOut,
@@ -474,15 +539,13 @@ export async function fourPancakeProxyBatchSellMerkle(params) {
         }));
     }
     else if (routeType === 'v3-multi' && params.v2Path && params.v2Path.length >= 2) {
-        // V3 多跳：使用 V2 备选路由
         quotedOutputs = await batchGetV2Quotes(provider, amountsWei, params.v2Path);
     }
     else {
         quotedOutputs = new Array(amountsWei.length).fill(0n);
     }
-    // ✅ 已移除滑点保护：minOuts 固定为 0
     const minOuts = new Array(sellers.length).fill(0n);
-    // ✅ 计算利润并找出收益最多的钱包
+    // 计算利润
     let totalProfit = 0n;
     let maxRevenueIndex = 0;
     let maxRevenue = 0n;
@@ -498,37 +561,31 @@ export async function fourPancakeProxyBatchSellMerkle(params) {
             }
         }
     }
-    // ✅ 修复：先计算需要的 nonce 数量，再统一获取
+    // 分配 nonces
     const needProfitTx = extractProfit && totalProfit > 0n && maxRevenue > 0n;
-    // 分配 nonces：收益最多的钱包可能需要 3 个 nonce（贿赂 + 卖出 + 利润转账）
     let nonces;
     let bribeNonce;
     let profitNonce;
     if (needBribeTx || needProfitTx) {
-        // 计算收益最多的钱包需要的 nonce 数量
-        let maxRevenueNonceCount = 1; // 卖出交易
+        let maxRevenueNonceCount = 1;
         if (needBribeTx)
-            maxRevenueNonceCount++; // 贿赂交易
+            maxRevenueNonceCount++;
         if (needProfitTx)
-            maxRevenueNonceCount++; // 利润交易
-        // 收益最多的钱包需要连续 nonce
+            maxRevenueNonceCount++;
         const maxRevenueNonces = await nonceManager.getNextNonceBatch(sellers[maxRevenueIndex], maxRevenueNonceCount);
-        // 其他钱包各需要 1 个 nonce
         const otherSellers = sellers.filter((_, i) => i !== maxRevenueIndex);
         const otherNonces = otherSellers.length > 0
             ? await nonceManager.getNextNoncesForWallets(otherSellers)
             : [];
-        // 分配收益最多钱包的 nonces
         let maxRevenueNonceIdx = 0;
         bribeNonce = needBribeTx ? maxRevenueNonces[maxRevenueNonceIdx++] : undefined;
         const maxRevenueSellNonce = maxRevenueNonces[maxRevenueNonceIdx++];
         profitNonce = needProfitTx ? maxRevenueNonces[maxRevenueNonceIdx] : undefined;
-        // 组装最终的 nonces 数组（保持原顺序）
         nonces = [];
         let otherIdx = 0;
         for (let i = 0; i < sellers.length; i++) {
             if (i === maxRevenueIndex) {
-                nonces.push(maxRevenueSellNonce); // 卖出交易 nonce
+                nonces.push(maxRevenueSellNonce);
             }
             else {
                 nonces.push(otherNonces[otherIdx++]);
@@ -536,38 +593,43 @@ export async function fourPancakeProxyBatchSellMerkle(params) {
         }
     }
     else {
-        // 不需要贿赂和利润交易，所有钱包各 1 个 nonce
         nonces = await nonceManager.getNextNoncesForWallets(sellers);
     }
-    // 卖出不需要发送 BNB，只需要 flatFee
+    // ✅ 使用官方 Router 构建卖出交易
     const needBNB = false;
-    // 构建交易
-    const proxies = sellers.map(w => new Contract(pancakeProxyAddress, PANCAKE_PROXY_ABI, w));
+    let routers;
     let unsignedSells;
     if (routeType === 'v2') {
         if (!params.v2Path || params.v2Path.length < 2) {
             throw new Error('v2Path is required for V2 routing');
         }
-        unsignedSells = await buildV2Transactions(proxies, sellers, amountsWei, minOuts, params.v2Path, false, needBNB);
+        routers = sellers.map(w => new Contract(PANCAKE_V2_ROUTER_ADDRESS, V2_ROUTER_ABI, w));
+        unsignedSells = await buildV2Transactions(routers, sellers, amountsWei, minOuts, params.v2Path, false, needBNB);
     }
     else if (routeType === 'v3-single') {
         if (!params.v3TokenOut || !params.v3Fee) {
             throw new Error('v3TokenOut and v3Fee are required for V3 single-hop');
         }
-        unsignedSells = await buildV3SingleTransactions(proxies, sellers, tokenAddress, params.v3TokenOut, params.v3Fee, amountsWei, minOuts, false, needBNB);
+        routers = sellers.map(w => new Contract(PANCAKE_V3_ROUTER_ADDRESS, V3_ROUTER_ABI, w));
+        unsignedSells = await buildV3SingleTransactions(routers, sellers, tokenAddress, params.v3TokenOut, params.v3Fee, amountsWei, minOuts, false, needBNB);
     }
     else if (routeType === 'v3-multi') {
-        if (!params.v3LpAddresses || params.v3LpAddresses.length === 0 || !params.v3ExactTokenIn) {
-            throw new Error('v3LpAddresses and v3ExactTokenIn are required for V3 multi-hop');
+        // ✅ V3 多跳：需要 v3Tokens 和 v3Fees 参数
+        if (!params.v3Tokens || params.v3Tokens.length < 2) {
+            throw new Error('v3Tokens（至少 2 个代币）是 V3 多跳必需的');
+        }
+        if (!params.v3Fees || params.v3Fees.length !== params.v3Tokens.length - 1) {
+            throw new Error(`v3Fees 长度必须等于 v3Tokens 长度 - 1`);
         }
-        unsignedSells = await buildV3MultiHopTransactions(proxies, sellers, params.v3LpAddresses, params.v3ExactTokenIn, amountsWei, minOuts, false, needBNB);
+        routers = sellers.map(w => new Contract(PANCAKE_V3_ROUTER_ADDRESS, V3_ROUTER_ABI, w));
+        unsignedSells = await buildV3MultiHopTransactions(routers, sellers, params.v3Tokens, params.v3Fees, amountsWei, minOuts, false, needBNB);
     }
     else {
         throw new Error(`Unsupported routeType: ${routeType}`);
     }
-    // ✅ 并行签名所有交易（贿赂、卖出、利润）
+    // 签名交易
     const signPromises = [];
-    // 贿赂交易（索引 0）
+    // 贿赂交易
     if (needBribeTx && bribeNonce !== undefined) {
         signPromises.push(sellers[maxRevenueIndex].signTransaction({
             to: BLOCKRAZOR_BUILDER_EOA,
@@ -579,7 +641,7 @@ export async function fourPancakeProxyBatchSellMerkle(params) {
             type: txType
         }));
     }
-    // 卖出交易（索引 1 ~ N）
+    // 卖出交易
     unsignedSells.forEach((unsigned, i) => {
         signPromises.push(sellers[i].signTransaction({
             ...unsigned,
@@ -592,7 +654,7 @@ export async function fourPancakeProxyBatchSellMerkle(params) {
             value: unsigned.value
         }));
     });
-    // 利润交易（索引 N+1）
+    // 利润交易
     if (extractProfit && totalProfit > 0n && profitNonce !== undefined) {
         signPromises.push(sellers[maxRevenueIndex].signTransaction({
             to: getProfitRecipient(),
@@ -604,12 +666,8 @@ export async function fourPancakeProxyBatchSellMerkle(params) {
             type: txType
         }));
     }
-    // ✅ 并行签名完成后按顺序返回
     const signedTxs = await Promise.all(signPromises);
-    // ✅ 清理临时 nonce 缓存
     nonceManager.clearTemp();
-    // ✅ 直接返回签名交易（不提交到Merkle）
-    // ✅ 简化返回：只返回签名交易
     return {
         signedTransactions: signedTxs
     };