four-flap-meme-sdk 2.2.8 → 2.2.11

package/dist/chains/bsc/pancake/bundle-swap.js

@@ -1,15 +1,592 @@
+// ==================== 多跳转账常量（使用统一常量） ====================
+import { GAS_LIMITS, CHAINS } from '../../../shared/constants/index.js';
+const NATIVE_TRANSFER_GAS_LIMIT = GAS_LIMITS.NATIVE_TRANSFER;
+const ERC20_TRANSFER_GAS_LIMIT_HOP = GAS_LIMITS.ERC20_TRANSFER;
+const BRIBE_GAS_LIMIT = GAS_LIMITS.BRIBE;
 /**
- * bundle-swap - 主函数
+ * 生成分发多跳路径
+ */
+function generateDisperseHopPaths(targetAddresses, hopCount, provider) {
+    if (hopCount <= 0) {
+        return targetAddresses.map(addr => ({
+            targetAddress: addr,
+            hopWallets: [],
+            hopWalletsInfo: []
+        }));
+    }
+    return targetAddresses.map(targetAddress => {
+        const hopWalletsInfo = generateWallets(hopCount);
+        const hopWallets = hopWalletsInfo.map(w => new Wallet(w.privateKey, provider));
+        return { targetAddress, hopWallets, hopWalletsInfo };
+    });
+}
+/**
+ * 构建原生代币多跳转账链
+ */
+async function buildNativeHopChain(payer, path, finalAmount, gasPrice, chainId, txType, payerNonce) {
+    const signedTxs = [];
+    const hopCount = path.hopWallets.length;
+    if (hopCount === 0) {
+        const tx = {
+            to: path.targetAddress,
+            value: finalAmount,
+            nonce: payerNonce,
+            gasLimit: NATIVE_TRANSFER_GAS_LIMIT,
+            chainId,
+            type: txType
+        };
+        if (txType === 2) {
+            tx.maxFeePerGas = gasPrice;
+            tx.maxPriorityFeePerGas = gasPrice / 10n || 1n;
+        }
+        else {
+            tx.gasPrice = gasPrice;
+        }
+        signedTxs.push(await payer.signTransaction(tx));
+        return signedTxs;
+    }
+    const hopGasCost = NATIVE_TRANSFER_GAS_LIMIT * gasPrice;
+    // 计算每跳需要的金额
+    const amountsPerHop = [];
+    for (let i = 0; i < hopCount; i++) {
+        const remainingHops = hopCount - i;
+        amountsPerHop.push(finalAmount + hopGasCost * BigInt(remainingHops));
+    }
+    // payer → hop1
+    const firstTx = {
+        to: path.hopWallets[0].address,
+        value: amountsPerHop[0],
+        nonce: payerNonce,
+        gasLimit: NATIVE_TRANSFER_GAS_LIMIT,
+        chainId,
+        type: txType
+    };
+    if (txType === 2) {
+        firstTx.maxFeePerGas = gasPrice;
+        firstTx.maxPriorityFeePerGas = gasPrice / 10n || 1n;
+    }
+    else {
+        firstTx.gasPrice = gasPrice;
+    }
+    signedTxs.push(await payer.signTransaction(firstTx));
+    // hop1 → hop2 → ... → target
+    for (let i = 0; i < hopCount; i++) {
+        const fromWallet = path.hopWallets[i];
+        const toAddress = i === hopCount - 1 ? path.targetAddress : path.hopWallets[i + 1].address;
+        const amount = i === hopCount - 1 ? finalAmount : amountsPerHop[i + 1];
+        const tx = {
+            to: toAddress,
+            value: amount,
+            nonce: 0,
+            gasLimit: NATIVE_TRANSFER_GAS_LIMIT,
+            chainId,
+            type: txType
+        };
+        if (txType === 2) {
+            tx.maxFeePerGas = gasPrice;
+            tx.maxPriorityFeePerGas = gasPrice / 10n || 1n;
+        }
+        else {
+            tx.gasPrice = gasPrice;
+        }
+        signedTxs.push(await fromWallet.signTransaction(tx));
+    }
+    return signedTxs;
+}
+/**
+ * 构建 ERC20 多跳转账链（需要配合 BNB 多跳使用）
+ */
+async function buildERC20HopChain(payer, path, erc20Address, erc20Amount, gasPrice, chainId, txType, payerNonce) {
+    const signedTxs = [];
+    const hopCount = path.hopWallets.length;
+    const erc20Interface = new ethers.Interface(ERC20_ABI);
+    if (hopCount === 0) {
+        const data = erc20Interface.encodeFunctionData('transfer', [path.targetAddress, erc20Amount]);
+        const tx = {
+            to: erc20Address,
+            data,
+            value: 0n,
+            nonce: payerNonce,
+            gasLimit: ERC20_TRANSFER_GAS_LIMIT_HOP,
+            chainId,
+            type: txType
+        };
+        if (txType === 2) {
+            tx.maxFeePerGas = gasPrice;
+            tx.maxPriorityFeePerGas = gasPrice / 10n || 1n;
+        }
+        else {
+            tx.gasPrice = gasPrice;
+        }
+        signedTxs.push(await payer.signTransaction(tx));
+        return signedTxs;
+    }
+    // payer → hop1
+    const firstData = erc20Interface.encodeFunctionData('transfer', [path.hopWallets[0].address, erc20Amount]);
+    const firstTx = {
+        to: erc20Address,
+        data: firstData,
+        value: 0n,
+        nonce: payerNonce,
+        gasLimit: ERC20_TRANSFER_GAS_LIMIT_HOP,
+        chainId,
+        type: txType
+    };
+    if (txType === 2) {
+        firstTx.maxFeePerGas = gasPrice;
+        firstTx.maxPriorityFeePerGas = gasPrice / 10n || 1n;
+    }
+    else {
+        firstTx.gasPrice = gasPrice;
+    }
+    signedTxs.push(await payer.signTransaction(firstTx));
+    // hop1 → hop2 → ... → target (nonce=1，nonce=0 用于 BNB 转发)
+    for (let i = 0; i < hopCount; i++) {
+        const fromWallet = path.hopWallets[i];
+        const toAddress = i === hopCount - 1 ? path.targetAddress : path.hopWallets[i + 1].address;
+        const data = erc20Interface.encodeFunctionData('transfer', [toAddress, erc20Amount]);
+        const tx = {
+            to: erc20Address,
+            data,
+            value: 0n,
+            nonce: 1, // nonce=0 已用于 BNB 转发
+            gasLimit: ERC20_TRANSFER_GAS_LIMIT_HOP,
+            chainId,
+            type: txType
+        };
+        if (txType === 2) {
+            tx.maxFeePerGas = gasPrice;
+            tx.maxPriorityFeePerGas = gasPrice / 10n || 1n;
+        }
+        else {
+            tx.gasPrice = gasPrice;
+        }
+        signedTxs.push(await fromWallet.signTransaction(tx));
+    }
+    return signedTxs;
+}
+/**
+ * 构建 BNB 多跳转账链（为 ERC20 中间钱包预留 gas）
+ */
+async function buildBNBHopChainForERC20(payer, path, finalGasAmount, gasPrice, chainId, txType, payerNonce) {
+    const signedTxs = [];
+    const hopCount = path.hopWallets.length;
+    if (hopCount === 0) {
+        // 无多跳时不需要转 gas
+        return signedTxs;
+    }
+    const hopGasCost = NATIVE_TRANSFER_GAS_LIMIT * gasPrice;
+    const erc20GasCost = ERC20_TRANSFER_GAS_LIMIT_HOP * gasPrice;
+    // 每个中间钱包需要: BNB 转发 gas + ERC20 转发 gas
+    const gasPerHop = hopGasCost + erc20GasCost * 2n; // 2倍安全系数
+    // 计算每跳需要的金额
+    const amountsPerHop = [];
+    for (let i = 0; i < hopCount; i++) {
+        const remainingHops = hopCount - i;
+        amountsPerHop.push(finalGasAmount + gasPerHop * BigInt(remainingHops));
+    }
+    // payer → hop1
+    const firstTx = {
+        to: path.hopWallets[0].address,
+        value: amountsPerHop[0],
+        nonce: payerNonce,
+        gasLimit: NATIVE_TRANSFER_GAS_LIMIT,
+        chainId,
+        type: txType
+    };
+    if (txType === 2) {
+        firstTx.maxFeePerGas = gasPrice;
+        firstTx.maxPriorityFeePerGas = gasPrice / 10n || 1n;
+    }
+    else {
+        firstTx.gasPrice = gasPrice;
+    }
+    signedTxs.push(await payer.signTransaction(firstTx));
+    // hop1 → hop2 → ... → target (nonce=0)
+    for (let i = 0; i < hopCount; i++) {
+        const fromWallet = path.hopWallets[i];
+        const toAddress = i === hopCount - 1 ? path.targetAddress : path.hopWallets[i + 1].address;
+        const amount = i === hopCount - 1 ? finalGasAmount : amountsPerHop[i + 1];
+        const tx = {
+            to: toAddress,
+            value: amount,
+            nonce: 0,
+            gasLimit: NATIVE_TRANSFER_GAS_LIMIT,
+            chainId,
+            type: txType
+        };
+        if (txType === 2) {
+            tx.maxFeePerGas = gasPrice;
+            tx.maxPriorityFeePerGas = gasPrice / 10n || 1n;
+        }
+        else {
+            tx.gasPrice = gasPrice;
+        }
+        signedTxs.push(await fromWallet.signTransaction(tx));
+    }
+    return signedTxs;
+}
+// ==================== 工具函数 ====================
+function createPancakeContext(config) {
+    const chainId = config.chainId ?? 56;
+    const provider = new ethers.JsonRpcProvider(config.rpcUrl, {
+        chainId,
+        name: 'BSC'
+    });
+    return { chainId, provider };
+}
+async function quoteSellOutput({ routeParams, sellAmountWei, provider, v2RouterAddress }) {
+    console.log(`[quoteSellOutput] 开始报价, routeType=${routeParams.routeType}, sellAmount=${sellAmountWei} wei`);
+    // ==================== V2 报价 ====================
+    if (routeParams.routeType === 'v2') {
+        const { v2Path } = routeParams;
+        const tokenIn = v2Path[0];
+        const tokenOut = v2Path[v2Path.length - 1];
+        console.log(`[quoteSellOutput] V2 路径: ${v2Path.join(' → ')}`);
+        const result = await quoteV2(provider, tokenIn, tokenOut, sellAmountWei, 'BSC', v2RouterAddress);
+        if (result.amountOut > 0n) {
+            console.log(`[quoteSellOutput] V2 报价成功: ${ethers.formatEther(result.amountOut)} BNB`);
+            return { estimatedBNBOut: result.amountOut };
+        }
+        throw new Error('V2 报价失败: 所有路径均无效');
+    }
+    // ==================== V3 单跳报价 ====================
+    if (routeParams.routeType === 'v3-single') {
+        const params = routeParams;
+        console.log(`[quoteSellOutput] V3 单跳: ${params.v3TokenIn} → ${params.v3TokenOut}, fee=${params.v3Fee}`);
+        // ✅ 只用 V3 报价，不 fallback 到 V2
+        const result = await quoteV3(provider, params.v3TokenIn, params.v3TokenOut, sellAmountWei, 'BSC', params.v3Fee);
+        if (result.amountOut > 0n) {
+            console.log(`[quoteSellOutput] V3 报价成功 (fee=${result.fee}): ${ethers.formatEther(result.amountOut)} BNB`);
+            return { estimatedBNBOut: result.amountOut };
+        }
+        // ❌ V3 报价失败时不再 fallback 到 V2，因为价格可能差异很大
+        throw new Error(`V3 单跳报价失败: tokenIn=${params.v3TokenIn}, tokenOut=${params.v3TokenOut}, fee=${params.v3Fee}`);
+    }
+    // ==================== V3 多跳报价 ====================
+    if (routeParams.routeType === 'v3-multi') {
+        const params = routeParams;
+        console.log(`[quoteSellOutput] V3 多跳: LPs=${params.v3LpAddresses?.join(', ')}`);
+        // ✅ V3 多跳：只用 V3 报价，不 fallback 到 V2
+        if (params.v3LpAddresses && params.v3LpAddresses.length > 0) {
+            const tokenIn = params.v3ExactTokenIn;
+            const WBNB = '0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c';
+            const result = await quoteV3(provider, tokenIn, WBNB, sellAmountWei, 'BSC');
+            if (result.amountOut > 0n) {
+                console.log(`[quoteSellOutput] V3 多跳报价成功: ${ethers.formatEther(result.amountOut)} BNB`);
+                return { estimatedBNBOut: result.amountOut };
+            }
+        }
+        // ❌ V3 多跳报价失败时不再 fallback 到 V2，因为价格可能差异很大
+        throw new Error(`V3 多跳报价失败: LPs=${params.v3LpAddresses?.join(', ')}, tokenIn=${params.v3ExactTokenIn}`);
+    }
+    throw new Error(`不支持的路由类型: ${routeParams.routeType}`);
+}
+async function buildSwapTransactions({ routeParams, sellAmountWei, buyAmountBNB, buyer, seller, tokenAddress, useNativeToken = true, v2RouterAddress }) {
+    const deadline = getDeadline();
+    const buyValue = useNativeToken ? buyAmountBNB + FLAT_FEE : 0n;
+    if (routeParams.routeType === 'v2') {
+        const { v2Path } = routeParams;
+        const reversePath = [...v2Path].reverse();
+        const routerAddr = v2RouterAddress || PANCAKE_V2_ROUTER_ADDRESS;
+        const v2RouterSeller = new Contract(routerAddr, PANCAKE_V2_ROUTER_ABI, seller);
+        const v2RouterBuyer = new Contract(routerAddr, PANCAKE_V2_ROUTER_ABI, buyer);
+        let sellUnsigned;
+        let buyUnsigned;
+        if (useNativeToken) {
+            // ✅ 原生代币模式（BNB）
+            // 卖出：Token → WBNB → BNB
+            sellUnsigned = await v2RouterSeller.swapExactTokensForETHSupportingFeeOnTransferTokens.populateTransaction(sellAmountWei, 0n, v2Path, seller.address, deadline);
+            // 买入：BNB → WBNB → Token
+            buyUnsigned = await v2RouterBuyer.swapExactETHForTokensSupportingFeeOnTransferTokens.populateTransaction(0n, reversePath, buyer.address, deadline, { value: buyValue });
+        }
+        else {
+            // ✅ ERC20 模式（如 USDT）
+            // 卖出：Token → USDT
+            sellUnsigned = await v2RouterSeller.swapExactTokensForTokensSupportingFeeOnTransferTokens.populateTransaction(sellAmountWei, 0n, v2Path, seller.address, deadline);
+            // 买入：USDT → Token
+            buyUnsigned = await v2RouterBuyer.swapExactTokensForTokensSupportingFeeOnTransferTokens.populateTransaction(buyAmountBNB, // USDT 数量
+            0n, reversePath, buyer.address, deadline);
+        }
+        return { sellUnsigned, buyUnsigned };
+    }
+    if (routeParams.routeType === 'v3-single') {
+        const { v3TokenIn, v3TokenOut, v3Fee } = routeParams;
+        const v3RouterIface = new ethers.Interface(PANCAKE_V3_ROUTER_ABI);
+        const v3RouterSeller = new Contract(PANCAKE_V3_ROUTER_ADDRESS, PANCAKE_V3_ROUTER_ABI, seller);
+        const v3RouterBuyer = new Contract(PANCAKE_V3_ROUTER_ADDRESS, PANCAKE_V3_ROUTER_ABI, buyer);
+        // 卖出：Token → WBNB，需要 unwrapWETH9
+        const sellSwapData = v3RouterIface.encodeFunctionData('exactInputSingle', [{
+                tokenIn: v3TokenIn,
+                tokenOut: v3TokenOut,
+                fee: v3Fee,
+                recipient: PANCAKE_V3_ROUTER_ADDRESS, // 先发给 Router
+                amountIn: sellAmountWei,
+                amountOutMinimum: 0n,
+                sqrtPriceLimitX96: 0n
+            }]);
+        const sellUnwrapData = v3RouterIface.encodeFunctionData('unwrapWETH9', [0n, seller.address]);
+        const sellUnsigned = await v3RouterSeller.multicall.populateTransaction(deadline, [sellSwapData, sellUnwrapData]);
+        // 买入：WBNB → Token
+        const buySwapData = v3RouterIface.encodeFunctionData('exactInputSingle', [{
+                tokenIn: v3TokenOut,
+                tokenOut: v3TokenIn,
+                fee: v3Fee,
+                recipient: buyer.address,
+                amountIn: buyAmountBNB,
+                amountOutMinimum: 0n,
+                sqrtPriceLimitX96: 0n
+            }]);
+        const buyUnsigned = await v3RouterBuyer.multicall.populateTransaction(deadline, [buySwapData], { value: buyValue });
+        return { sellUnsigned, buyUnsigned };
+    }
+    // V3 多跳暂不支持官方合约
+    throw new Error('V3 多跳路由暂不支持官方合约，请使用 V2 路由或 V3 单跳');
+}
+async function calculateBuyerBudget({ buyer, quotedBNBOut, reserveGasBNB, useNativeToken = true, quoteToken, quoteTokenDecimals = 18, provider }) {
+    const reserveGas = ethers.parseEther((reserveGasBNB ?? 0.0005).toString());
+    // ✅ 已移除滑点保护：直接使用报价金额
+    const buyAmountBNB = quotedBNBOut;
+    // ✅ 根据是否使用原生代币获取不同的余额
+    let buyerBalance;
+    if (useNativeToken) {
+        buyerBalance = await buyer.provider.getBalance(buyer.address);
+        const requiredBalance = buyAmountBNB + FLAT_FEE + reserveGas;
+        if (buyerBalance < requiredBalance) {
+            throw new Error(`买方余额不足: 需要 ${ethers.formatEther(requiredBalance)} BNB, 实际 ${ethers.formatEther(buyerBalance)} BNB`);
+        }
+        return { buyerBalance, reserveGas, requiredBalance, buyAmountBNB, useNativeToken };
+    }
+    else {
+        // ERC20 代币余额
+        const erc20 = new Contract(quoteToken, ERC20_BALANCE_OF_ABI, provider || buyer.provider);
+        buyerBalance = await erc20.balanceOf(buyer.address);
+        const requiredBalance = buyAmountBNB + FLAT_FEE; // ERC20 不需要预留 Gas 在代币余额中
+        if (buyerBalance < requiredBalance) {
+            throw new Error(`买方代币余额不足: 需要 ${ethers.formatUnits(requiredBalance, quoteTokenDecimals)}, 实际 ${ethers.formatUnits(buyerBalance, quoteTokenDecimals)}`);
+        }
+        // ✅ ERC20 购买时，还需要检查买方是否有足够 BNB 支付 Gas
+        const buyerBnbBalance = await buyer.provider.getBalance(buyer.address);
+        if (buyerBnbBalance < reserveGas) {
+            throw new Error(`买方 BNB 余额不足 (用于支付 Gas): 需要 ${ethers.formatEther(reserveGas)} BNB, 实际 ${ethers.formatEther(buyerBnbBalance)} BNB`);
+        }
+        return { buyerBalance, reserveGas, requiredBalance, buyAmountBNB, useNativeToken };
+    }
+}
+/**
+ * ✅ 从前端传入的 startNonces 构建 NoncePlan（用于性能优化）
+ * 顺序：[sellerBaseNonce, buyerNonce]
+ */
+function buildNoncePlanFromNonces(startNonces, sameAddress, approvalExists, profitNeeded, needBribeTx) {
+    if (sameAddress) {
+        let idx = 0;
+        const bribeNonce = needBribeTx ? startNonces[0] + idx++ : undefined;
+        if (approvalExists)
+            idx++;
+        const sellerNonce = startNonces[0] + idx++;
+        const buyerNonce = startNonces[0] + idx++;
+        const profitNonce = profitNeeded ? startNonces[0] + idx : undefined;
+        return { sellerNonce, buyerNonce, bribeNonce, profitNonce };
+    }
+    let sellerIdx = 0;
+    const bribeNonce = needBribeTx ? startNonces[0] + sellerIdx++ : undefined;
+    if (approvalExists)
+        sellerIdx++;
+    const sellerNonce = startNonces[0] + sellerIdx++;
+    const profitNonce = profitNeeded ? startNonces[0] + sellerIdx : undefined;
+    const buyerNonce = startNonces[1];
+    return { sellerNonce, buyerNonce, bribeNonce, profitNonce };
+}
+/**
+ * ✅ 规划 nonce
+ * 交易顺序：贿赂 → 授权 → 卖出 → 买入 → 利润
+ * 贿赂和利润由卖方发送
+ */
+async function planNonces({ seller, buyer, sameAddress, approvalExists, profitNeeded, needBribeTx, nonceManager }) {
+    if (sameAddress) {
+        // 同一地址：贿赂(可选) + 授权(可选) + 卖出 + 买入 + 利润(可选)
+        const txCount = countTruthy([needBribeTx, approvalExists, true, true, profitNeeded]);
+        const nonces = await nonceManager.getNextNonceBatch(buyer, txCount);
+        let idx = 0;
+        const bribeNonce = needBribeTx ? nonces[idx++] : undefined;
+        if (approvalExists)
+            idx++;
+        const sellerNonce = nonces[idx++];
+        const buyerNonce = nonces[idx++];
+        const profitNonce = profitNeeded ? nonces[idx] : undefined;
+        return { sellerNonce, buyerNonce, bribeNonce, profitNonce };
+    }
+    if (needBribeTx || approvalExists || profitNeeded) {
+        // 卖方需要多个 nonce：贿赂(可选) + 授权(可选) + 卖出 + 利润(可选)
+        const sellerTxCount = countTruthy([needBribeTx, approvalExists, true, profitNeeded]);
+        // ✅ 并行获取 seller 和 buyer 的 nonce
+        const [sellerNonces, buyerNonce] = await Promise.all([
+            nonceManager.getNextNonceBatch(seller, sellerTxCount),
+            nonceManager.getNextNonce(buyer)
+        ]);
+        let idx = 0;
+        const bribeNonce = needBribeTx ? sellerNonces[idx++] : undefined;
+        if (approvalExists)
+            idx++;
+        const sellerNonce = sellerNonces[idx++];
+        const profitNonce = profitNeeded ? sellerNonces[idx] : undefined;
+        return { sellerNonce, buyerNonce, bribeNonce, profitNonce };
+    }
+    // ✅ 并行获取 seller 和 buyer 的 nonce
+    const [sellerNonce, buyerNonce] = await Promise.all([
+        nonceManager.getNextNonce(seller),
+        nonceManager.getNextNonce(buyer)
+    ]);
+    return { sellerNonce, buyerNonce };
+}
+/**
+ * 根据 userType 计算利润率
+ */
+function getProfitRateBps(userType) {
+    if (userType === 'v0') {
+        return PROFIT_CONFIG.RATE_BPS_V0; // 0.06%
+    }
+    else if (userType === 'v1') {
+        return PROFIT_CONFIG.RATE_BPS_V1; // 0.05%
+    }
+    return PROFIT_CONFIG.RATE_BPS_V0; // 默认 0.06%
+}
+function calculateProfitAmount(estimatedBNBOut, userType) {
+    if (estimatedBNBOut <= 0n) {
+        return 0n;
+    }
+    const rateBps = getProfitRateBps(userType);
+    return (estimatedBNBOut * BigInt(rateBps)) / 10000n;
+}
+/**
+ * ✅ 获取 ERC20 代币 → 原生代币（BNB）的报价
+ * 用于将 ERC20 利润转换为 BNB
+ * 使用共享的报价函数
+ */
+async function getERC20ToNativeQuote(provider, tokenAddress, tokenAmount, version = 'v2', fee) {
+    if (tokenAmount <= 0n)
+        return 0n;
+    const tokenLower = tokenAddress.toLowerCase();
+    const wbnbLower = WBNB_ADDRESS.toLowerCase();
+    // 如果代币本身就是 WBNB，直接返回
+    if (tokenLower === wbnbLower) {
+        return tokenAmount;
+    }
+    // 使用共享的报价函数
+    if (version === 'v3') {
+        const result = await quoteV3(provider, tokenAddress, WBNB_ADDRESS, tokenAmount, 'BSC', fee);
+        if (result.amountOut > 0n) {
+            console.log(`[getERC20ToNativeQuote] V3 报价成功: ${ethers.formatEther(result.amountOut)} BNB`);
+            return result.amountOut;
+        }
+        console.warn(`[getERC20ToNativeQuote] V3 报价失败`);
+        return 0n;
+    }
+    // V2 报价
+    const result = await quoteV2(provider, tokenAddress, WBNB_ADDRESS, tokenAmount, 'BSC');
+    if (result.amountOut > 0n) {
+        console.log(`[getERC20ToNativeQuote] V2 报价成功: ${ethers.formatEther(result.amountOut)} BNB`);
+        return result.amountOut;
+    }
+    console.warn(`[getERC20ToNativeQuote] V2 报价失败`);
+    return 0n;
+}
+async function validateFinalBalances({ sameAddress, buyerBalance, buyAmountBNB, reserveGas, gasLimit, gasPrice, useNativeToken = true, quoteTokenDecimals = 18, provider, buyerAddress }) {
+    const gasCost = gasLimit * gasPrice;
+    if (sameAddress) {
+        // 同一地址：需要足够的余额支付两笔交易
+        if (useNativeToken) {
+            const requiredCombined = buyAmountBNB + FLAT_FEE * 2n + gasCost * 2n;
+            if (buyerBalance < requiredCombined) {
+                throw new Error(`账户余额不足:\n  - 需要: ${ethers.formatEther(requiredCombined)} BNB（含两笔Gas与两笔手续费）\n  - 实际: ${ethers.formatEther(buyerBalance)} BNB`);
+            }
+        }
+        else {
+            // ERC20：检查代币余额 + BNB Gas 余额
+            const requiredToken = buyAmountBNB + FLAT_FEE * 2n;
+            if (buyerBalance < requiredToken) {
+                throw new Error(`账户代币余额不足:\n  - 需要: ${ethers.formatUnits(requiredToken, quoteTokenDecimals)}\n  - 实际: ${ethers.formatUnits(buyerBalance, quoteTokenDecimals)}`);
+            }
+            // 检查 BNB Gas
+            if (provider && buyerAddress) {
+                const bnbBalance = await provider.getBalance(buyerAddress);
+                const requiredGas = gasCost * 2n;
+                if (bnbBalance < requiredGas) {
+                    throw new Error(`账户 BNB 余额不足 (用于支付 Gas):\n  - 需要: ${ethers.formatEther(requiredGas)} BNB\n  - 实际: ${ethers.formatEther(bnbBalance)} BNB`);
+                }
+            }
+        }
+        return;
+    }
+    // 不同地址
+    if (useNativeToken) {
+        const requiredBuyer = buyAmountBNB + FLAT_FEE + reserveGas;
+        if (buyerBalance < requiredBuyer) {
+            throw new Error(`买方余额不足:\n  - 需要: ${ethers.formatEther(requiredBuyer)} BNB\n  - 实际: ${ethers.formatEther(buyerBalance)} BNB`);
+        }
+    }
+    // ERC20 余额已在 calculateBuyerBudget 中检查过
+}
+function countTruthy(values) {
+    return values.filter(Boolean).length;
+}
+/**
+ * PancakeSwap V2/V3 通用捆绑换手（Merkle Bundle）
+ *
+ * 功能：钱包A卖出代币 → 钱包B买入相同数量 → 原子执行
+ * 适用于所有已迁移到外盘的代币（不区分Four/Flap）
  */
-import { GAS_LIMITS, CHAINS, getProfitRecipient } from '../../../shared/constants/index.js';
 import { ethers, Contract, Wallet } from 'ethers';
 import { calculateSellAmount } from '../../../utils/swap-helpers.js';
-import { NonceManager, getDeadline, buildProfitHopTransactions, PROFIT_HOP_COUNT, } from '../../../utils/bundle-helpers.js';
-import { ADDRESSES, BLOCKRAZOR_BUILDER_EOA } from '../../../shared/constants/index.js';
-import { ERC20_ABI } from '../../../abis/common.js';
-import { BRIBE_GAS_LIMIT, ERC20_BALANCE_OF_ABI, FLAT_FEE, NATIVE_TRANSFER_GAS_LIMIT, PANCAKE_V2_ROUTER_ABI, PANCAKE_V2_ROUTER_ADDRESS, PANCAKE_V3_ROUTER_ABI, PANCAKE_V3_ROUTER_ADDRESS, ZERO_ADDRESS, buildBNBHopChainForERC20, buildERC20HopChain, buildNativeHopChain, buildNoncePlanFromNonces, buildSwapTransactions, calculateBuyerBudget, calculateProfitAmount, createPancakeContext, generateDisperseHopPaths, getERC20ToNativeQuote, getGasLimit, getGasPrice, planNonces, quoteSellOutput, validateFinalBalances, } from './bundle-swap-helpers.js';
+import { NonceManager, getDeadline, buildProfitHopTransactions, PROFIT_HOP_COUNT } from '../../../utils/bundle-helpers.js';
+import { ADDRESSES, PROFIT_CONFIG, BLOCKRAZOR_BUILDER_EOA } from '../../../utils/constants.js';
+import { quoteV2, quoteV3 } from '../../../utils/quote-helpers.js';
+import { V2_ROUTER_ABI, V3_ROUTER02_ABI, ERC20_BALANCE_ABI, ERC20_ABI } from '../../../shared/abis/common.js';
+import { generateWallets } from '../../../utils/wallet.js';
+/**
+ * 获取 Gas Limit
+ */
+function getGasLimit(config, defaultGas = 800000) {
+    if (config.gasLimit !== undefined) {
+        return typeof config.gasLimit === 'bigint' ? config.gasLimit : BigInt(config.gasLimit);
+    }
+    const multiplier = config.gasLimitMultiplier ?? 1.0;
+    const calculatedGas = Math.ceil(defaultGas * multiplier);
+    return BigInt(calculatedGas);
+}
+async function getGasPrice(provider, config) {
+    const feeData = await provider.getFeeData();
+    let gasPrice = feeData.gasPrice || ethers.parseUnits('3', 'gwei');
+    if (config.minGasPriceGwei) {
+        const minGas = ethers.parseUnits(config.minGasPriceGwei.toString(), 'gwei');
+        if (gasPrice < minGas)
+            gasPrice = minGas;
+    }
+    if (config.maxGasPriceGwei) {
+        const maxGas = ethers.parseUnits(config.maxGasPriceGwei.toString(), 'gwei');
+        if (gasPrice > maxGas)
+            gasPrice = maxGas;
+    }
+    return gasPrice;
+}
+// ✅ ABI 别名（从公共模块导入）
+const PANCAKE_V2_ROUTER_ABI = V2_ROUTER_ABI;
+const PANCAKE_V3_ROUTER_ABI = V3_ROUTER02_ABI;
+const ERC20_BALANCE_OF_ABI = ERC20_BALANCE_ABI;
+// ✅ 使用官方 PancakeSwap Router 地址
+const PANCAKE_V2_ROUTER_ADDRESS = ADDRESSES.BSC.PancakeV2Router;
+const PANCAKE_V3_ROUTER_ADDRESS = ADDRESSES.BSC.PancakeV3Router;
+// 常量
+const FLAT_FEE = 0n;
+const WBNB_ADDRESS = ADDRESSES.BSC.WBNB;
+const ZERO_ADDRESS = '0x0000000000000000000000000000000000000000';
+// ✅ ERC20_BALANCE_OF_ABI 已在文件开头定义
+/**
+ * PancakeSwap捆绑换手（V2/V3通用）
+ * ✅ 支持 quoteToken：传入 USDT 等地址时，卖出得到该代币，买入使用该代币
+ */
 export async function pancakeBundleSwapMerkle(params) {
-    const { sellerPrivateKey, sellAmount, sellPercentage, buyerPrivateKey, tokenAddress, routeParams, config, quoteToken, quoteTokenDecimals = 18, startNonces, // ✅ 可选：前端预获取的 nonces
+    const { sellerPrivateKey, sellAmount, sellPercentage, buyerPrivateKey, tokenAddress, routeParams, config, quoteToken, quoteTokenDecimals = 18, startNonces // ✅ 可选：前端预获取的 nonces
      } = params;
     // ✅ 判断是否使用原生代币（BNB）或 ERC20 代币（如 USDT）
     const useNativeToken = !quoteToken || quoteToken === ZERO_ADDRESS;
@@ -24,14 +601,14 @@ export async function pancakeBundleSwapMerkle(params) {
     // ✅ 并行获取 gasPrice 和卖出数量
     const [gasPrice, sellAmountResult] = await Promise.all([
         getGasPrice(context.provider, config),
-        calculateSellAmount(context.provider, tokenAddress, seller.address, sellAmount, sellPercentage),
+        calculateSellAmount(context.provider, tokenAddress, seller.address, sellAmount, sellPercentage)
     ]);
     const { amount: sellAmountWei, decimals } = sellAmountResult;
     const quoteResult = await quoteSellOutput({
         routeParams,
         sellAmountWei,
         provider: context.provider,
-        v2RouterAddress: config.v2RouterAddress,
+        v2RouterAddress: config.v2RouterAddress
     });
     const buyerBudget = await calculateBuyerBudget({
         buyer,
@@ -40,7 +617,7 @@ export async function pancakeBundleSwapMerkle(params) {
         useNativeToken,
         quoteToken,
         quoteTokenDecimals,
-        provider: context.provider,
+        provider: context.provider
     });
     const swapUnsigned = await buildSwapTransactions({
         routeParams,
@@ -50,7 +627,7 @@ export async function pancakeBundleSwapMerkle(params) {
         seller,
         tokenAddress,
         useNativeToken,
-        v2RouterAddress: config.v2RouterAddress,
+        v2RouterAddress: config.v2RouterAddress
     });
     // ✅ 修复：利润计算应基于 BNB 数量，不是 ERC20 数量
     // 如果输出是原生代币（BNB），直接使用报价结果
@@ -71,7 +648,9 @@ export async function pancakeBundleSwapMerkle(params) {
         // ERC20→BNB 报价完成
     }
     // ✅ 获取贿赂金额
-    const bribeAmount = config.bribeAmount && config.bribeAmount > 0 ? ethers.parseEther(String(config.bribeAmount)) : 0n;
+    const bribeAmount = config.bribeAmount && config.bribeAmount > 0
+        ? ethers.parseEther(String(config.bribeAmount))
+        : 0n;
     const needBribeTx = bribeAmount > 0n;
     // ✅ 使用共享的 NonceManager 规划 nonce
     // 如果前端传入了 startNonces，直接使用（性能优化）
@@ -84,54 +663,48 @@ export async function pancakeBundleSwapMerkle(params) {
             approvalExists: false, // ✅ 已移除授权
             profitNeeded: profitAmount > 0n,
             needBribeTx,
-            nonceManager,
+            nonceManager
         });
     // ✅ 并行签名所有交易
     const signPromises = [];
     // 贿赂交易
     if (needBribeTx && noncePlan.bribeNonce !== undefined) {
-        signPromises.push(seller
-            .signTransaction({
+        signPromises.push(seller.signTransaction({
             to: BLOCKRAZOR_BUILDER_EOA,
             value: bribeAmount,
             nonce: noncePlan.bribeNonce,
             gasPrice,
             gasLimit: BRIBE_GAS_LIMIT,
             chainId: context.chainId,
-            type: txType,
-        })
-            .then((tx) => ({ type: 'bribe', tx })));
+            type: txType
+        }).then(tx => ({ type: 'bribe', tx })));
     }
     // 卖出交易
-    signPromises.push(seller
-        .signTransaction({
+    signPromises.push(seller.signTransaction({
         ...swapUnsigned.sellUnsigned,
         from: seller.address,
         nonce: noncePlan.sellerNonce,
         gasLimit: finalGasLimit,
         gasPrice,
         chainId: context.chainId,
-        type: txType,
-    })
-        .then((tx) => ({ type: 'sell', tx })));
+        type: txType
+    }).then(tx => ({ type: 'sell', tx })));
     // 买入交易
-    signPromises.push(buyer
-        .signTransaction({
+    signPromises.push(buyer.signTransaction({
         ...swapUnsigned.buyUnsigned,
         from: buyer.address,
         nonce: noncePlan.buyerNonce,
         gasLimit: finalGasLimit,
         gasPrice,
         chainId: context.chainId,
-        type: txType,
-    })
-        .then((tx) => ({ type: 'buy', tx })));
+        type: txType
+    }).then(tx => ({ type: 'buy', tx })));
     // ✅ 并行执行所有签名
     const signedResults = await Promise.all(signPromises);
     // 按类型提取结果
-    const bribeTx = signedResults.find((r) => r.type === 'bribe')?.tx || null;
-    const signedSell = signedResults.find((r) => r.type === 'sell').tx;
-    const signedBuy = signedResults.find((r) => r.type === 'buy').tx;
+    const bribeTx = signedResults.find(r => r.type === 'bribe')?.tx || null;
+    const signedSell = signedResults.find(r => r.type === 'sell').tx;
+    const signedBuy = signedResults.find(r => r.type === 'buy').tx;
     nonceManager.clearTemp();
     validateFinalBalances({
         sameAddress,
@@ -143,7 +716,7 @@ export async function pancakeBundleSwapMerkle(params) {
         useNativeToken,
         quoteTokenDecimals,
         provider: context.provider,
-        buyerAddress: buyer.address,
+        buyerAddress: buyer.address
     });
     // ✅ 组装顺序：贿赂 → 卖出 → 买入
     const signedTransactions = [];
@@ -157,12 +730,12 @@ export async function pancakeBundleSwapMerkle(params) {
             provider: context.provider,
             payerWallet: seller,
             profitAmount,
-            profitRecipient: getProfitRecipient(),
+            profitRecipient: PROFIT_CONFIG.RECIPIENT,
             hopCount: PROFIT_HOP_COUNT,
             gasPrice,
             chainId: context.chainId,
             txType,
-            startNonce: noncePlan.profitNonce,
+            startNonce: noncePlan.profitNonce
         });
         signedTransactions.push(...profitHopResult.signedTransactions);
         profitHopWallets = profitHopResult.hopWallets; // ✅ 收集利润多跳钱包
@@ -177,8 +750,8 @@ export async function pancakeBundleSwapMerkle(params) {
             buyAmount: useNativeToken
                 ? ethers.formatEther(buyerBudget.buyAmountBNB)
                 : ethers.formatUnits(buyerBudget.buyAmountBNB, quoteTokenDecimals),
-            profitAmount: profitAmount > 0n ? ethers.formatEther(profitAmount) : undefined,
-        },
+            profitAmount: profitAmount > 0n ? ethers.formatEther(profitAmount) : undefined
+        }
     };
 }
 /**
@@ -190,7 +763,7 @@ export async function pancakeBundleSwapMerkle(params) {
  * 交易顺序：[授权(可选)] → [卖出] → [买入1, 买入2, ..., 买入N] → [利润]
  */
 export async function pancakeBatchSwapMerkle(params) {
-    const { sellerPrivateKey, sellAmount, sellPercentage, buyerPrivateKeys, buyerAmounts, tokenAddress, routeParams, config, quoteToken, quoteTokenDecimals = 18, startNonces, // ✅ 可选：前端预获取的 nonces
+    const { sellerPrivateKey, sellAmount, sellPercentage, buyerPrivateKeys, buyerAmounts, tokenAddress, routeParams, config, quoteToken, quoteTokenDecimals = 18, startNonces // ✅ 可选：前端预获取的 nonces
      } = params;
     // ✅ 校验买方数量（最多 24 个）
     const MAX_BUYERS = 24;
@@ -203,7 +776,7 @@ export async function pancakeBatchSwapMerkle(params) {
     const useNativeToken = !quoteToken || quoteToken === ZERO_ADDRESS;
     const context = createPancakeContext(config);
     const seller = new Wallet(sellerPrivateKey, context.provider);
-    const buyers = buyerPrivateKeys.map((pk) => new Wallet(pk, context.provider));
+    const buyers = buyerPrivateKeys.map(pk => new Wallet(pk, context.provider));
     // ✅ 创建共享资源
     const nonceManager = new NonceManager(context.provider);
     const finalGasLimit = getGasLimit(config);
@@ -211,14 +784,14 @@ export async function pancakeBatchSwapMerkle(params) {
     // ✅ 并行获取 gasPrice 和卖出数量
     const [gasPrice, sellAmountResult] = await Promise.all([
         getGasPrice(context.provider, config),
-        calculateSellAmount(context.provider, tokenAddress, seller.address, sellAmount, sellPercentage),
+        calculateSellAmount(context.provider, tokenAddress, seller.address, sellAmount, sellPercentage)
     ]);
     const { amount: sellAmountWei, decimals } = sellAmountResult;
     const quoteResult = await quoteSellOutput({
         routeParams,
         sellAmountWei,
         provider: context.provider,
-        v2RouterAddress: config.v2RouterAddress,
+        v2RouterAddress: config.v2RouterAddress
     });
     const estimatedBNBOut = quoteResult.estimatedBNBOut;
     // ✅ 计算每个买方的买入金额（已移除滑点保护：直接使用报价金额）
@@ -226,12 +799,14 @@ export async function pancakeBatchSwapMerkle(params) {
     const totalBuyAmount = estimatedBNBOut;
     if (buyerAmounts && buyerAmounts.length === buyers.length) {
         // 方式1：使用指定的买入金额（USDT）
-        buyAmountsWei = buyerAmounts.map((amt) => useNativeToken ? ethers.parseEther(amt) : ethers.parseUnits(amt, quoteTokenDecimals));
+        buyAmountsWei = buyerAmounts.map(amt => useNativeToken
+            ? ethers.parseEther(amt)
+            : ethers.parseUnits(amt, quoteTokenDecimals));
     }
     else if (params.buyerRatios && params.buyerRatios.length === buyers.length) {
         // ✅ 方式2：按比例分配卖出所得
         // buyerRatios 如 [0.3, 0.5, 0.2] 表示第一个买方分 30%，第二个 50%，第三个 20%
-        buyAmountsWei = params.buyerRatios.map((ratio) => {
+        buyAmountsWei = params.buyerRatios.map((ratio, index) => {
             // 按比例计算每个买方的金额
             const amount = (totalBuyAmount * BigInt(Math.round(ratio * 10000))) / 10000n;
             return amount;
@@ -281,17 +856,15 @@ export async function pancakeBatchSwapMerkle(params) {
     else if (routeParams.routeType === 'v3-single') {
         const { v3TokenIn, v3TokenOut, v3Fee } = routeParams;
         const v3RouterSeller = new Contract(PANCAKE_V3_ROUTER_ADDRESS, PANCAKE_V3_ROUTER_ABI, seller);
-        const sellSwapData = v3RouterIface.encodeFunctionData('exactInputSingle', [
-            {
+        const sellSwapData = v3RouterIface.encodeFunctionData('exactInputSingle', [{
                 tokenIn: v3TokenIn,
                 tokenOut: v3TokenOut,
                 fee: v3Fee,
                 recipient: useNativeToken ? PANCAKE_V3_ROUTER_ADDRESS : seller.address,
                 amountIn: sellAmountWei,
                 amountOutMinimum: 0n,
-                sqrtPriceLimitX96: 0n,
-            },
-        ]);
+                sqrtPriceLimitX96: 0n
+            }]);
         if (useNativeToken) {
             // 原生代币：需要 unwrap WBNB
             const sellUnwrapData = v3RouterIface.encodeFunctionData('unwrapWETH9', [0n, seller.address]);
@@ -324,17 +897,15 @@ export async function pancakeBatchSwapMerkle(params) {
         else if (routeParams.routeType === 'v3-single') {
             const { v3TokenIn, v3TokenOut, v3Fee } = routeParams;
             const v3RouterBuyer = new Contract(PANCAKE_V3_ROUTER_ADDRESS, PANCAKE_V3_ROUTER_ABI, buyer);
-            const buySwapData = v3RouterIface.encodeFunctionData('exactInputSingle', [
-                {
+            const buySwapData = v3RouterIface.encodeFunctionData('exactInputSingle', [{
                     tokenIn: v3TokenOut,
                     tokenOut: v3TokenIn,
                     fee: v3Fee,
                     recipient: buyer.address,
                     amountIn: buyAmount,
                     amountOutMinimum: 0n,
-                    sqrtPriceLimitX96: 0n,
-                },
-            ]);
+                    sqrtPriceLimitX96: 0n
+                }]);
             return await v3RouterBuyer.multicall.populateTransaction(deadline, [buySwapData], { value: buyValue });
         }
         else {
@@ -342,14 +913,16 @@ export async function pancakeBatchSwapMerkle(params) {
         }
     }));
     // ✅ 获取贿赂金额
-    const bribeAmount = config.bribeAmount && config.bribeAmount > 0 ? ethers.parseEther(String(config.bribeAmount)) : 0n;
+    const bribeAmount = config.bribeAmount && config.bribeAmount > 0
+        ? ethers.parseEther(String(config.bribeAmount))
+        : 0n;
     // ✅ 规划 Nonce（贿赂和利润都由卖方发送）
     // 卖方: [贿赂(可选)] → [卖出] → [利润(可选)]
     let bribeNonce;
     let sellNonce;
     let buyerNonces;
     // ✅ 如果前端传入了 startNonces，直接使用（性能优化）
-    if (startNonces && startNonces.length >= 1 + buyers.length) {
+    if (startNonces && startNonces.length >= (1 + buyers.length)) {
         let sellerIdx = 0;
         if (bribeAmount > 0n) {
             bribeNonce = startNonces[0] + sellerIdx++;
@@ -362,7 +935,7 @@ export async function pancakeBatchSwapMerkle(params) {
             bribeNonce = await nonceManager.getNextNonce(seller);
         }
         sellNonce = await nonceManager.getNextNonce(seller);
-        buyerNonces = await Promise.all(buyers.map((buyer) => nonceManager.getNextNonce(buyer)));
+        buyerNonces = await Promise.all(buyers.map(buyer => nonceManager.getNextNonce(buyer)));
     }
     // ✅ 贿赂交易放在首位（由卖方发送）
     let bribeTx = null;
@@ -374,7 +947,7 @@ export async function pancakeBatchSwapMerkle(params) {
             gasPrice,
             gasLimit: BRIBE_GAS_LIMIT,
             chainId: context.chainId,
-            type: txType,
+            type: txType
         });
     }
     // ✅ 修复：利润计算应基于 BNB 数量，不是 ERC20 数量
@@ -392,9 +965,7 @@ export async function pancakeBatchSwapMerkle(params) {
     }
     // 计算利润 nonce
     const profitNonce = profitAmount > 0n
-        ? startNonces && startNonces.length >= 1
-            ? sellNonce + 1
-            : await nonceManager.getNextNonce(seller)
+        ? (startNonces && startNonces.length >= 1 ? sellNonce + 1 : await nonceManager.getNextNonce(seller))
         : undefined;
     nonceManager.clearTemp();
     // ✅ 并行签名所有交易
@@ -406,7 +977,7 @@ export async function pancakeBatchSwapMerkle(params) {
         gasLimit: finalGasLimit,
         gasPrice,
         chainId: context.chainId,
-        type: txType,
+        type: txType
     });
     // 2. 并行签名所有买入交易
     const signedBuyPromises = buyers.map((buyer, i) => buyer.signTransaction({
@@ -416,10 +987,13 @@ export async function pancakeBatchSwapMerkle(params) {
         gasLimit: finalGasLimit,
         gasPrice,
         chainId: context.chainId,
-        type: txType,
+        type: txType
     }));
     // 3. 等待所有签名完成
-    const [signedSell, ...signedBuys] = await Promise.all([signedSellPromise, ...signedBuyPromises]);
+    const [signedSell, ...signedBuys] = await Promise.all([
+        signedSellPromise,
+        ...signedBuyPromises
+    ]);
     // 4. 按顺序组装交易数组：贿赂 → 卖出 → 买入
     const signedTransactions = [];
     if (bribeTx)
@@ -433,12 +1007,12 @@ export async function pancakeBatchSwapMerkle(params) {
             provider: context.provider,
             payerWallet: seller,
             profitAmount,
-            profitRecipient: getProfitRecipient(),
+            profitRecipient: PROFIT_CONFIG.RECIPIENT,
             hopCount: PROFIT_HOP_COUNT,
             gasPrice,
             chainId: context.chainId,
             txType,
-            startNonce: profitNonce,
+            startNonce: profitNonce
         });
         signedTransactions.push(...profitHopResult.signedTransactions);
         profitHopWallets = profitHopResult.hopWallets; // ✅ 收集利润多跳钱包
@@ -448,11 +1022,13 @@ export async function pancakeBatchSwapMerkle(params) {
         profitHopWallets, // ✅ 导出利润多跳钱包
         metadata: {
             sellerAddress: seller.address,
-            buyerAddresses: buyers.map((b) => b.address),
+            buyerAddresses: buyers.map(b => b.address),
             sellAmount: ethers.formatUnits(sellAmountWei, decimals),
-            buyAmounts: buyAmountsWei.map((amt) => useNativeToken ? ethers.formatEther(amt) : ethers.formatUnits(amt, quoteTokenDecimals)),
-            profitAmount: profitAmount > 0n ? ethers.formatEther(profitAmount) : undefined,
-        },
+            buyAmounts: buyAmountsWei.map(amt => useNativeToken
+                ? ethers.formatEther(amt)
+                : ethers.formatUnits(amt, quoteTokenDecimals)),
+            profitAmount: profitAmount > 0n ? ethers.formatEther(profitAmount) : undefined
+        }
     };
 }
 /**
@@ -471,7 +1047,7 @@ export async function pancakeBatchSwapMerkle(params) {
  */
 export async function pancakeQuickBatchSwapMerkle(params) {
     const { sellerPrivateKey, sellAmount, sellPercentage, buyerPrivateKeys, buyerRatios, buyerAmounts, tokenAddress, routeParams, config, quoteToken, quoteTokenDecimals = 18, disperseHopCount = 0, // ✅ 转账多跳数（默认0=直接转账）
-    startNonces, // ✅ 可选：前端预获取的 nonces
+    startNonces // ✅ 可选：前端预获取的 nonces
      } = params;
     // ✅ 判断是否使用原生代币
     const useNativeToken = !quoteToken || quoteToken === ZERO_ADDRESS;
@@ -498,6 +1074,7 @@ export async function pancakeQuickBatchSwapMerkle(params) {
         MAX_BUYERS = Math.floor(maxTxs / (2 * disperseHopCount + 3));
     }
     MAX_BUYERS = Math.max(1, MAX_BUYERS); // 至少1个
+    console.log(`[pancakeQuickBatchSwapMerkle] 多跳数: ${disperseHopCount}, 最大买方数: ${MAX_BUYERS}`);
     if (buyerPrivateKeys.length === 0) {
         throw new Error('至少需要一个买方钱包');
     }
@@ -517,7 +1094,7 @@ export async function pancakeQuickBatchSwapMerkle(params) {
     }
     const context = createPancakeContext(config);
     const seller = new Wallet(sellerPrivateKey, context.provider);
-    const buyers = buyerPrivateKeys.map((pk) => new Wallet(pk, context.provider));
+    const buyers = buyerPrivateKeys.map(pk => new Wallet(pk, context.provider));
     // ✅ 校验卖出路径输出代币是否匹配
     let sellOutputToken;
     if (routeParams.routeType === 'v2') {
@@ -557,16 +1134,30 @@ export async function pancakeQuickBatchSwapMerkle(params) {
     // ✅ 并行获取 gasPrice 和卖出数量
     const [gasPrice, sellAmountResult] = await Promise.all([
         getGasPrice(context.provider, config),
-        calculateSellAmount(context.provider, tokenAddress, seller.address, sellAmount, sellPercentage),
+        calculateSellAmount(context.provider, tokenAddress, seller.address, sellAmount, sellPercentage)
     ]);
     const { amount: sellAmountWei, decimals } = sellAmountResult;
+    // ✅ 调试日志
+    console.log(`[pancakeQuickBatchSwapMerkle] 模式: ${useNativeToken ? 'BNB' : 'ERC20'}`);
+    console.log(`[pancakeQuickBatchSwapMerkle] 卖出数量: ${ethers.formatUnits(sellAmountWei, decimals)}`);
+    console.log(`[pancakeQuickBatchSwapMerkle] routeParams:`, JSON.stringify({
+        routeType: routeParams.routeType,
+        v2Path: routeParams.v2Path,
+        v3TokenIn: routeParams.v3TokenIn,
+        v3TokenOut: routeParams.v3TokenOut,
+        v3Fee: routeParams.v3Fee
+    }));
     const quoteResult = await quoteSellOutput({
         routeParams,
         sellAmountWei,
         provider: context.provider,
-        v2RouterAddress: config.v2RouterAddress,
+        v2RouterAddress: config.v2RouterAddress
     });
     const estimatedOutput = quoteResult.estimatedBNBOut;
+    const outputFormatted = useNativeToken
+        ? ethers.formatEther(estimatedOutput)
+        : ethers.formatUnits(estimatedOutput, quoteTokenDecimals);
+    console.log(`[pancakeQuickBatchSwapMerkle] 预估卖出所得: ${outputFormatted} ${useNativeToken ? 'BNB' : 'ERC20'}`);
     // ✅ 计算利润（万分之六）
     let profitAmount;
     if (useNativeToken) {
@@ -578,13 +1169,16 @@ export async function pancakeQuickBatchSwapMerkle(params) {
         const fee = routeParams.routeType === 'v3-single' ? routeParams.v3Fee : undefined;
         const estimatedBNBValue = await getERC20ToNativeQuote(context.provider, quoteToken, estimatedOutput, version, fee);
         profitAmount = calculateProfitAmount(estimatedBNBValue, config.userType);
+        console.log(`[pancakeQuickBatchSwapMerkle] ERC20→BNB 报价: ${outputFormatted} → ${ethers.formatEther(estimatedBNBValue)} BNB`);
     }
     const distributableAmount = estimatedOutput - (useNativeToken ? profitAmount : 0n);
     // ✅ 计算每个买方分到的金额
     let transferAmountsWei;
     if (buyerAmounts && buyerAmounts.length === buyers.length) {
         // 数量模式
-        transferAmountsWei = buyerAmounts.map((amt) => useNativeToken ? ethers.parseEther(amt) : ethers.parseUnits(amt, quoteTokenDecimals));
+        transferAmountsWei = buyerAmounts.map(amt => useNativeToken
+            ? ethers.parseEther(amt)
+            : ethers.parseUnits(amt, quoteTokenDecimals));
         const totalTransfer = transferAmountsWei.reduce((a, b) => a + b, 0n);
         if (totalTransfer > distributableAmount) {
             const formatted = useNativeToken
@@ -595,7 +1189,7 @@ export async function pancakeQuickBatchSwapMerkle(params) {
     }
     else if (buyerRatios && buyerRatios.length === buyers.length) {
         // 比例模式
-        transferAmountsWei = buyerRatios.map((ratio) => {
+        transferAmountsWei = buyerRatios.map(ratio => {
             return (distributableAmount * BigInt(Math.round(ratio * 10000))) / 10000n;
         });
     }
@@ -603,22 +1197,22 @@ export async function pancakeQuickBatchSwapMerkle(params) {
         throw new Error('必须提供 buyerRatios 或 buyerAmounts');
     }
     // ✅ 获取贿赂金额
-    const bribeAmount = config.bribeAmount && config.bribeAmount > 0 ? ethers.parseEther(String(config.bribeAmount)) : 0n;
+    const bribeAmount = config.bribeAmount && config.bribeAmount > 0
+        ? ethers.parseEther(String(config.bribeAmount))
+        : 0n;
     // ✅ 验证主钱包余额
     const sellerBalance = await seller.provider.getBalance(seller.address);
     let sellerGasCost;
     let sellerRequired;
     if (useNativeToken) {
         // BNB 模式：贿赂(BRIBE) + 卖出(gasLimit) + N个原生转账(BRIBE each) + 利润(BRIBE)
-        sellerGasCost =
-            gasPrice * (BRIBE_GAS_LIMIT + finalGasLimit + BRIBE_GAS_LIMIT * BigInt(buyers.length) + BRIBE_GAS_LIMIT);
+        sellerGasCost = gasPrice * (BRIBE_GAS_LIMIT + finalGasLimit + BRIBE_GAS_LIMIT * BigInt(buyers.length) + BRIBE_GAS_LIMIT);
         sellerRequired = bribeAmount + sellerGasCost;
     }
     else {
         // ERC20 模式：子钱包已预留 BNB，不需要主钱包转 Gas
         // 卖方 Gas: 贿赂(BRIBE) + 卖出(gasLimit) + N个ERC20转账(65000 each) + 利润(BRIBE)
-        sellerGasCost =
-            gasPrice * (BRIBE_GAS_LIMIT + finalGasLimit + ERC20_TRANSFER_GAS * BigInt(buyers.length) + BRIBE_GAS_LIMIT);
+        sellerGasCost = gasPrice * (BRIBE_GAS_LIMIT + finalGasLimit + ERC20_TRANSFER_GAS * BigInt(buyers.length) + BRIBE_GAS_LIMIT);
         sellerRequired = bribeAmount + sellerGasCost;
     }
     if (sellerBalance < sellerRequired) {
@@ -626,7 +1220,9 @@ export async function pancakeQuickBatchSwapMerkle(params) {
     }
     // ==================== 规划 Nonce ====================
     // ✅ 如果前端传入了 startNonces，直接使用（性能优化）
-    let sellerNonce = startNonces && startNonces.length > 0 ? startNonces[0] : await nonceManager.getNextNonce(seller);
+    let sellerNonce = startNonces && startNonces.length > 0
+        ? startNonces[0]
+        : await nonceManager.getNextNonce(seller);
     const deadline = Math.floor(Date.now() / 1000) + 600;
     // ==================== 1. 贿赂交易 ====================
     let bribeTx = null;
@@ -638,8 +1234,9 @@ export async function pancakeQuickBatchSwapMerkle(params) {
             gasPrice,
             gasLimit: BRIBE_GAS_LIMIT,
             chainId: context.chainId,
-            type: txType,
+            type: txType
         });
+        console.log(`[pancakeQuickBatchSwapMerkle] 贿赂交易已签名`);
     }
     // ==================== 2. 卖出交易 ====================
     const v3RouterIface2 = new ethers.Interface(PANCAKE_V3_ROUTER_ABI);
@@ -660,17 +1257,15 @@ export async function pancakeQuickBatchSwapMerkle(params) {
     else if (routeParams.routeType === 'v3-single') {
         const { v3TokenIn, v3TokenOut, v3Fee } = routeParams;
         const v3RouterSeller = new Contract(PANCAKE_V3_ROUTER_ADDRESS, PANCAKE_V3_ROUTER_ABI, seller);
-        const sellSwapData = v3RouterIface2.encodeFunctionData('exactInputSingle', [
-            {
+        const sellSwapData = v3RouterIface2.encodeFunctionData('exactInputSingle', [{
                 tokenIn: v3TokenIn,
                 tokenOut: v3TokenOut,
                 fee: v3Fee,
                 recipient: useNativeToken ? PANCAKE_V3_ROUTER_ADDRESS : seller.address,
                 amountIn: sellAmountWei,
                 amountOutMinimum: 0n,
-                sqrtPriceLimitX96: 0n,
-            },
-        ]);
+                sqrtPriceLimitX96: 0n
+            }]);
         if (useNativeToken) {
             // 原生代币：需要 unwrap WBNB
             const sellUnwrapData = v3RouterIface2.encodeFunctionData('unwrapWETH9', [0n, seller.address]);
@@ -691,18 +1286,19 @@ export async function pancakeQuickBatchSwapMerkle(params) {
         gasLimit: finalGasLimit,
         gasPrice,
         chainId: context.chainId,
-        type: txType,
+        type: txType
     });
+    console.log(`[pancakeQuickBatchSwapMerkle] 卖出交易已签名`);
     // ==================== 3. 转账交易（支持多跳）====================
     const buyerGasCost = gasPrice * finalGasLimit;
     // ✅ 生成多跳路径
-    const hopPaths = generateDisperseHopPaths(buyers.map((b) => b.address), disperseHopCount, context.provider);
+    const hopPaths = generateDisperseHopPaths(buyers.map(b => b.address), disperseHopCount, context.provider);
     // 收集所有中间钱包信息
     const allHopWallets = [];
-    hopPaths.forEach((path) => {
+    hopPaths.forEach(path => {
         allHopWallets.push(...path.hopWalletsInfo);
     });
-    let transferTxs;
+    let transferTxs = [];
     if (disperseHopCount === 0) {
         // ✅ 无多跳：直接转账
         const transferNonces = buyers.map((_, i) => sellerNonce + i);
@@ -717,14 +1313,17 @@ export async function pancakeQuickBatchSwapMerkle(params) {
                     gasPrice,
                     gasLimit: NATIVE_TRANSFER_GAS_LIMIT,
                     chainId: context.chainId,
-                    type: txType,
+                    type: txType
                 });
             }));
         }
         else {
             const erc20Interface = new ethers.Interface(ERC20_ABI);
             transferTxs = await Promise.all(buyers.map((buyer, i) => {
-                const transferData = erc20Interface.encodeFunctionData('transfer', [buyer.address, transferAmountsWei[i]]);
+                const transferData = erc20Interface.encodeFunctionData('transfer', [
+                    buyer.address,
+                    transferAmountsWei[i]
+                ]);
                 return seller.signTransaction({
                     to: quoteToken,
                     data: transferData,
@@ -733,7 +1332,7 @@ export async function pancakeQuickBatchSwapMerkle(params) {
                     gasPrice,
                     gasLimit: ERC20_TRANSFER_GAS,
                     chainId: context.chainId,
-                    type: txType,
+                    type: txType
                 });
             }));
         }
@@ -773,11 +1372,12 @@ export async function pancakeQuickBatchSwapMerkle(params) {
             transferTxs = [...bnbTxs, ...erc20Txs];
         }
     }
+    console.log(`[pancakeQuickBatchSwapMerkle] ${transferTxs.length} 笔转账交易已签名 (多跳数=${disperseHopCount})`);
     // ==================== 4. 买入交易 ====================
     // ✅ 如果前端传入了 startNonces，使用 buyer 部分（从索引 1 开始）
     const buyerNonces = startNonces && startNonces.length > 1
         ? startNonces.slice(1)
-        : await Promise.all(buyers.map((buyer) => nonceManager.getNextNonce(buyer)));
+        : await Promise.all(buyers.map(buyer => nonceManager.getNextNonce(buyer)));
     const signedBuys = await Promise.all(buyers.map(async (buyer, i) => {
         const buyAmount = transferAmountsWei[i];
         // ✅ ERC20 模式：value = 0（通过代币授权支付）
@@ -797,17 +1397,15 @@ export async function pancakeQuickBatchSwapMerkle(params) {
         else if (routeParams.routeType === 'v3-single') {
             const { v3TokenIn, v3TokenOut, v3Fee } = routeParams;
             const v3RouterBuyer = new Contract(PANCAKE_V3_ROUTER_ADDRESS, PANCAKE_V3_ROUTER_ABI, buyer);
-            const buySwapData = v3RouterIface2.encodeFunctionData('exactInputSingle', [
-                {
+            const buySwapData = v3RouterIface2.encodeFunctionData('exactInputSingle', [{
                     tokenIn: v3TokenOut,
                     tokenOut: v3TokenIn,
                     fee: v3Fee,
                     recipient: buyer.address,
                     amountIn: buyAmount,
                     amountOutMinimum: 0n,
-                    sqrtPriceLimitX96: 0n,
-                },
-            ]);
+                    sqrtPriceLimitX96: 0n
+                }]);
             buyUnsigned = await v3RouterBuyer.multicall.populateTransaction(deadline, [buySwapData], { value: buyValue });
         }
         else {
@@ -820,9 +1418,10 @@ export async function pancakeQuickBatchSwapMerkle(params) {
             gasLimit: finalGasLimit,
             gasPrice,
             chainId: context.chainId,
-            type: txType,
+            type: txType
         });
     }));
+    console.log(`[pancakeQuickBatchSwapMerkle] ${signedBuys.length} 笔买入交易已签名`);
     nonceManager.clearTemp();
     // ==================== 组装交易数组 ====================
     // BNB 模式：贿赂 → 卖出 → 转账 → 买入 → 利润多跳
@@ -840,33 +1439,41 @@ export async function pancakeQuickBatchSwapMerkle(params) {
             provider: context.provider,
             payerWallet: seller,
             profitAmount,
-            profitRecipient: getProfitRecipient(),
+            profitRecipient: PROFIT_CONFIG.RECIPIENT,
             hopCount: PROFIT_HOP_COUNT,
             gasPrice,
             chainId: context.chainId,
             txType,
-            startNonce: sellerNonce++,
+            startNonce: sellerNonce++
         });
         signedTransactions.push(...profitHopResult.signedTransactions);
         profitHopWallets = profitHopResult.hopWallets; // ✅ 收集利润多跳钱包
         // 多跳交易已签名
     }
+    console.log(`[pancakeQuickBatchSwapMerkle] 交易组装完成: ${signedTransactions.length} 笔`);
+    console.log(`  - 贿赂: ${bribeTx ? 1 : 0}`);
+    console.log(`  - 卖出: 1`);
+    console.log(`  - 转账: ${transferTxs.length}`);
+    console.log(`  - 买入: ${signedBuys.length}`);
+    const outputUnit = useNativeToken ? 'BNB' : 'ERC20';
     return {
         signedTransactions,
         disperseHopWallets: allHopWallets.length > 0 ? allHopWallets : undefined, // ✅ 返回转账多跳钱包
         profitHopWallets, // ✅ 返回利润多跳钱包
         metadata: {
             sellerAddress: seller.address,
-            buyerAddresses: buyers.map((b) => b.address),
+            buyerAddresses: buyers.map(b => b.address),
             sellAmount: ethers.formatUnits(sellAmountWei, decimals),
             estimatedOutput: useNativeToken
                 ? ethers.formatEther(estimatedOutput)
                 : ethers.formatUnits(estimatedOutput, quoteTokenDecimals),
-            transferAmounts: transferAmountsWei.map((amt) => useNativeToken ? ethers.formatEther(amt) : ethers.formatUnits(amt, quoteTokenDecimals)),
+            transferAmounts: transferAmountsWei.map(amt => useNativeToken
+                ? ethers.formatEther(amt)
+                : ethers.formatUnits(amt, quoteTokenDecimals)),
             profitAmount: profitAmount > 0n ? ethers.formatEther(profitAmount) : undefined,
             useNativeToken,
-            disperseHopCount: disperseHopCount > 0 ? disperseHopCount : undefined, // ✅ 返回多跳数
-        },
+            disperseHopCount: disperseHopCount > 0 ? disperseHopCount : undefined // ✅ 返回多跳数
+        }
     };
 }
 /**
@@ -877,7 +1484,7 @@ export async function pancakeQuickBatchSwapMerkle(params) {
  * - ✅ 正确处理 nonce：同一钱包在多轮中使用时 nonce 自动递增
  */
 export async function pancakeCrossSwapMerkle(params) {
-    const { sellerPrivateKeys, sellAmounts, buyerPrivateKeys, tokenAddress, routeParams, config, quoteToken, quoteTokenDecimals = 18, buyersPerSell, disperseHopCount = 0, } = params;
+    const { sellerPrivateKeys, sellAmounts, buyerPrivateKeys, tokenAddress, routeParams, config, quoteToken, quoteTokenDecimals = 18, buyersPerSell, disperseHopCount = 0 } = params;
     if (sellerPrivateKeys.length === 0) {
         throw new Error('至少需要一个卖方');
     }
@@ -891,8 +1498,8 @@ export async function pancakeCrossSwapMerkle(params) {
     const context = createPancakeContext(config);
     const nonceManager = new NonceManager(context.provider);
     // ✅ 预先获取所有钱包的初始 nonce
-    const allSellerWallets = sellerPrivateKeys.map((pk) => new Wallet(pk, context.provider));
-    const allBuyerWallets = buyerPrivateKeys.map((pk) => new Wallet(pk, context.provider));
+    const allSellerWallets = sellerPrivateKeys.map(pk => new Wallet(pk, context.provider));
+    const allBuyerWallets = buyerPrivateKeys.map(pk => new Wallet(pk, context.provider));
     // 使用 Map 去重（同一私钥可能出现多次）
     const addressToNonce = new Map();
     // 获取所有卖方 nonce
@@ -909,6 +1516,7 @@ export async function pancakeCrossSwapMerkle(params) {
             addressToNonce.set(wallet.address, nonce);
         }
     }
+    console.log(`[pancakeCrossSwapMerkle] 初始化完成: ${sellerPrivateKeys.length} 卖方, ${buyerPrivateKeys.length} 买方`);
     const allSigned = [];
     const allDisperse = [];
     const allProfit = [];
@@ -919,7 +1527,9 @@ export async function pancakeCrossSwapMerkle(params) {
     // 判断是否使用原生代币
     const useNativeToken = !quoteToken || quoteToken === ZERO_ADDRESS;
     // 获取贿赂金额
-    const bribeAmount = config.bribeAmount && config.bribeAmount > 0 ? ethers.parseEther(String(config.bribeAmount)) : 0n;
+    const bribeAmount = config.bribeAmount && config.bribeAmount > 0
+        ? ethers.parseEther(String(config.bribeAmount))
+        : 0n;
     const hasBribe = bribeAmount > 0n;
     for (let i = 0; i < sellerPrivateKeys.length; i++) {
         const sellerPk = sellerPrivateKeys[i];
@@ -937,7 +1547,7 @@ export async function pancakeCrossSwapMerkle(params) {
         // ✅ 获取卖方当前 nonce
         const sellerNonce = addressToNonce.get(sellerWallet.address);
         // ✅ 获取并更新买方 nonces（每个买方本轮需要 1 个 nonce）
-        const roundBuyerNonces = roundBuyerWallets.map((w) => {
+        const roundBuyerNonces = roundBuyerWallets.map(w => {
             const nonce = addressToNonce.get(w.address);
             addressToNonce.set(w.address, nonce + 1); // 每个买方用 1 个 nonce
             return nonce;
@@ -977,10 +1587,11 @@ export async function pancakeCrossSwapMerkle(params) {
             quoteToken,
             quoteTokenDecimals,
             disperseHopCount,
-            startNonces, // ✅ 传入预计算的 nonces
+            startNonces // ✅ 传入预计算的 nonces
         });
         // ✅ 更新卖方 nonce（使用精确计算的值）
         addressToNonce.set(sellerWallet.address, sellerNonce + sellerNonceConsumed);
+        console.log(`[pancakeCrossSwapMerkle] 轮次 ${i + 1}: 卖方=${sellerWallet.address.slice(0, 10)}..., 买方=${roundBuyerPks.length}, 交易=${res.signedTransactions.length}`);
         // 累积签名与中间钱包
         allSigned.push(...res.signedTransactions);
         if (res.disperseHopWallets)
@@ -991,14 +1602,15 @@ export async function pancakeCrossSwapMerkle(params) {
             sellerAddress: res.metadata?.sellerAddress || '',
             buyerAddresses: res.metadata?.buyerAddresses || roundBuyerPks.map(() => ''),
             sellAmount,
-            bundleHash: undefined,
+            bundleHash: undefined
         });
     }
     nonceManager.clearTemp();
+    console.log(`[pancakeCrossSwapMerkle] 完成: ${rounds.length} 轮, ${allSigned.length} 笔交易`);
     return {
         signedTransactions: allSigned,
         rounds,
         disperseHopWallets: allDisperse.length > 0 ? allDisperse : undefined,
-        profitHopWallets: allProfit.length > 0 ? allProfit : undefined,
+        profitHopWallets: allProfit.length > 0 ? allProfit : undefined
     };
 }