four-flap-meme-sdk 2.0.0 → 2.2.0

package/dist/chains/bsc/pancake/bundle-buy-first/index.js

@@ -1,907 +0,0 @@
-/**
- * PancakeSwap V2/V3 通用捆绑换手（Merkle Bundle）- 先买后卖
- *
- * 功能：钱包B先买入代币 → 钱包A卖出相同数量 → 原子执行
- */
-import { ethers, Contract, Wallet } from 'ethers';
-import { NonceManager, getDeadline, buildProfitHopTransactions, PROFIT_HOP_COUNT } from '../../../../utils/bundle-helpers.js';
-import { ADDRESSES, PROFIT_CONFIG, BLOCKRAZOR_BUILDER_EOA, ZERO_ADDRESS } from '../../../../utils/constants.js';
-import { GAS_LIMITS } from '../../../../shared/constants/index.js';
-import { quoteV2, quoteV3, getTokenToNativeQuote } from '../../../../utils/quote-helpers.js';
-import { V2_ROUTER_ABI, V3_ROUTER02_ABI, ERC20_BALANCE_ABI } from '../../../../shared/abis/common.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;
-// ==================== 多笔买卖常量 ====================
-/** 最大 Bundle 签名数 */
-const MAX_BUNDLE_SIGNATURES = 50;
-/** 贿赂交易数 */
-const BRIBE_TX_COUNT = 1;
-/** 利润中转交易数（支付者 1 笔 + 中转钱包 PROFIT_HOP_COUNT 笔 + 最终接收 1 笔） */
-const PROFIT_TX_COUNT = PROFIT_HOP_COUNT + 2; // 2 + 2 = 4
-/** 最大买卖交易数 */
-const MAX_SWAP_TX_COUNT = MAX_BUNDLE_SIGNATURES - BRIBE_TX_COUNT - PROFIT_TX_COUNT; // 50 - 1 - 4 = 45
-// ✅ 用户类型（影响利润率）
-/**
- * 根据 userType 获取每笔交易的利润率
- */
-function getProfitRatePerTxBps(userType) {
-    if (userType === 'v1') {
-        return PROFIT_CONFIG.RATE_BPS_V1_DOUBLE;
-    }
-    return PROFIT_CONFIG.RATE_BPS_V0_DOUBLE; // v0 或默认
-}
-/**
- * 验证买卖笔数
- */
-function validateSwapCounts(buyCount, sellCount) {
-    if (buyCount < 1) {
-        throw new Error(`买入笔数必须至少为 1，当前为 ${buyCount}`);
-    }
-    if (sellCount < 1) {
-        throw new Error(`卖出笔数必须至少为 1，当前为 ${sellCount}`);
-    }
-    const totalSwaps = buyCount + sellCount;
-    if (totalSwaps > MAX_SWAP_TX_COUNT) {
-        throw new Error(`买卖笔数总和 (${totalSwaps}) 超出限制 (${MAX_SWAP_TX_COUNT})，` +
-            `最大签名数为 ${MAX_BUNDLE_SIGNATURES}（${BRIBE_TX_COUNT} 贿赂 + ${PROFIT_TX_COUNT} 利润 + ${MAX_SWAP_TX_COUNT} 买卖）`);
-    }
-}
-/**
- * ✅ 将金额随机拆分成多份（更自然，不像机器人）
- * 每份金额在平均值的 50%-150% 之间随机浮动
- */
-function splitAmount(totalAmount, count) {
-    if (count <= 0) {
-        throw new Error('拆分份数必须大于 0');
-    }
-    if (count === 1) {
-        return [totalAmount];
-    }
-    // 生成随机权重（0.5 - 1.5 之间）
-    const weights = [];
-    for (let i = 0; i < count; i++) {
-        // 随机值在 0.5 - 1.5 之间，使每份金额有 ±50% 的浮动
-        weights.push(0.5 + Math.random());
-    }
-    // 计算权重总和
-    const totalWeight = weights.reduce((a, b) => a + b, 0);
-    // 根据权重分配金额
-    const amounts = [];
-    let allocated = 0n;
-    for (let i = 0; i < count - 1; i++) {
-        // 按权重比例分配
-        const ratio = weights[i] / totalWeight;
-        const amount = BigInt(Math.floor(Number(totalAmount) * ratio));
-        amounts.push(amount);
-        allocated += amount;
-    }
-    // 最后一份分配剩余的全部（确保总和精确）
-    amounts.push(totalAmount - allocated);
-    // 随机打乱顺序（让大小金额交错出现）
-    for (let i = amounts.length - 1; i > 0; i--) {
-        const j = Math.floor(Math.random() * (i + 1));
-        [amounts[i], amounts[j]] = [amounts[j], amounts[i]];
-    }
-    return amounts;
-}
-sellerNonces: number[];
-bribeNonce ?  : number;
-profitNonce ?  : number;
-;
-// ✅ getDeadline 从 bundle-helpers.js 导入
-// ✅ Merkle 配置（保留兼容）
-// ✅ 签名参数（不依赖 Merkle）
-// ✅ Merkle 参数（保留兼容）
-profitHopWallets ?  : GeneratedWallet[]; // ✅ 利润多跳钱包
-metadata ?  : {
-    buyerAddress: string,
-    sellerAddress: string,
-    buyAmount: string,
-    sellAmount: string,
-    profitAmount: string, // 利润金额（BNB）
-    // ✅ 多笔买卖信息
-    buyCount: number,
-    sellCount: number,
-    buyAmounts: string[], // ✅ 每笔买入金额数组（随机分配）
-    sellAmounts: string[]
-};
-;
-export async function pancakeBundleBuyFirstMerkle(params) {
-    const { buyerPrivateKey, buyerPrivateKeys, sellerPrivateKey, sellerPrivateKeys, tokenAddress, routeParams, buyerFunds, buyerFundsPercentage, config, quoteToken, quoteTokenDecimals = 18, startNonces, // ✅ 可选：前端预获取的 nonces
-    buyCount: _buyCount, sellCount: _sellCount, taxRateBps = 0 // ✅ 税率（基点），用于计算实际可卖出代币数量
-     } = params;
-    // ✅ 判断是否为多钱包模式
-    const isMultiWalletMode = !!(buyerPrivateKeys && buyerPrivateKeys.length > 0) ||
-        !!(sellerPrivateKeys && sellerPrivateKeys.length > 0);
-    // ✅ 多钱包模式：buyCount/sellCount 代表钱包数量
-    // 单钱包模式（向后兼容）：buyCount/sellCount 代表同一钱包执行的交易笔数
-    const buyCount = _buyCount ?? 1;
-    const sellCount = _sellCount ?? 1;
-    // ✅ 多钱包模式：使用单独的处理逻辑
-    if (isMultiWalletMode) {
-        return await pancakeBundleBuyFirstMultiWallet({
-            buyerPrivateKeys: buyerPrivateKeys || (buyerPrivateKey ? [buyerPrivateKey] : []),
-            sellerPrivateKeys: sellerPrivateKeys || (sellerPrivateKey ? [sellerPrivateKey] : []),
-            tokenAddress,
-            routeParams,
-            buyerFunds,
-            config,
-            quoteToken,
-            quoteTokenDecimals,
-            taxRateBps // ✅ 传递税率
-        });
-    }
-    // ✅ 单钱包模式（向后兼容）：验证买卖笔数
-    if (!buyerPrivateKey || !sellerPrivateKey) {
-        throw new Error('单钱包模式需要提供 buyerPrivateKey 和 sellerPrivateKey');
-    }
-    validateSwapCounts(buyCount, sellCount);
-    // ✅ 计算利润比例（根据 userType 动态调整）
-    const totalTxCount = buyCount + sellCount;
-    const profitRateBps = getProfitRatePerTxBps(config.userType) * totalTxCount;
-    // ✅ 判断是否使用原生代币（BNB）或 ERC20 代币（如 USDT）
-    const useNativeToken = !quoteToken || quoteToken === ZERO_ADDRESS;
-    const context = createPancakeContext(config);
-    const buyer = new Wallet(buyerPrivateKey, context.provider);
-    const seller = new Wallet(sellerPrivateKey, context.provider);
-    const sameAddress = buyer.address.toLowerCase() === seller.address.toLowerCase();
-    const buyerFundsInfo = await calculateBuyerFunds({
-        buyer,
-        buyerFunds,
-        buyerFundsPercentage,
-        reserveGas: config.reserveGasBNB,
-        useNativeToken,
-        quoteToken,
-        quoteTokenDecimals,
-        provider: context.provider
-    });
-    const quoteResult = await quoteTokenOutput({
-        routeParams,
-        buyerFundsWei: buyerFundsInfo.buyerFundsWei,
-        provider: context.provider,
-        v2RouterOverride: config.v2RouterAddress
-    });
-    // ✅ 拆分买入和卖出金额
-    const buyAmountsWei = splitAmount(buyerFundsInfo.buyerFundsWei, buyCount);
-    // ✅ 税币支持：买入时会被扣税，实际获得的代币 = 报价 * (1 - 税率)
-    // 卖出金额需要按扣税后的实际代币数量来计算
-    let actualTokenOut = quoteResult.quotedTokenOut;
-    if (taxRateBps > 0) {
-        // 税率基点转换：500 bps = 5% = 0.05，实际获得 = 报价 * (10000 - 税率) / 10000
-        actualTokenOut = (quoteResult.quotedTokenOut * BigInt(10000 - taxRateBps)) / 10000n;
-        console.log(`[pancakeBundleBuyFirst] 税币模式: 税率=${taxRateBps}bps, 报价=${quoteResult.quotedTokenOut}, 实际可卖=${actualTokenOut}`);
-    }
-    const sellAmountsWei = splitAmount(actualTokenOut, sellCount);
-    // ✅ 构建多笔买入和卖出交易
-    const swapUnsignedArray = await buildMultiRouteTransactions({
-        routeParams,
-        buyAmountsWei,
-        sellAmountsWei,
-        buyer,
-        seller,
-        tokenAddress,
-        useNativeToken,
-        v2RouterAddress: config.v2RouterAddress
-    });
-    const finalGasLimit = getGasLimit(config);
-    const gasPrice = await getGasPrice(context.provider, config);
-    const txType = config.txType ?? 0;
-    const nonceManager = new NonceManager(context.provider);
-    // ✅ 直接使用买入金额作为利润基础（先买后卖模式）
-    // profitRateBps = 每笔交易利润率(bps) * 交易笔数
-    // 例如：v1用户，1买1卖 → 5 * 2 = 10 bps = 0.1%
-    const tokenProfitAmount = (buyerFundsInfo.buyerFundsWei * BigInt(profitRateBps)) / 10000n;
-    // ✅ ERC20 购买：将代币利润转换为等值 BNB（因为利润是用 BNB 转账的）
-    let profitAmount = tokenProfitAmount;
-    if (!useNativeToken && tokenProfitAmount > 0n && quoteToken) {
-        const version = routeParams.routeType === 'v2' ? 'v2' : 'v3';
-        const fee = routeParams.routeType === 'v3-single' ? routeParams.v3Fee : undefined;
-        profitAmount = await getTokenToNativeQuote(context.provider, quoteToken, tokenProfitAmount, 'BSC', version, fee);
-        // ERC20→BNB 转换完成
-    }
-    // ✅ 获取贿赂金额
-    const bribeAmount = config.bribeAmount && config.bribeAmount > 0
-        ? ethers.parseEther(String(config.bribeAmount))
-        : 0n;
-    const needBribeTx = bribeAmount > 0n;
-    // ✅ 规划多笔交易 nonce（忽略 startNonces，使用新的多笔规划）
-    const multiNoncePlan = await planMultiNonces({
-        buyer,
-        seller,
-        buyCount,
-        sellCount,
-        sameAddress,
-        extractProfit: profitAmount > 0n,
-        needBribeTx,
-        nonceManager
-    });
-    // ✅ 贿赂交易放在首位（由卖方发送，与利润交易同一钱包）
-    let bribeTx = null;
-    if (needBribeTx && multiNoncePlan.bribeNonce !== undefined) {
-        bribeTx = await seller.signTransaction({
-            to: BLOCKRAZOR_BUILDER_EOA,
-            value: bribeAmount,
-            nonce: multiNoncePlan.bribeNonce,
-            gasPrice,
-            gasLimit: GAS_LIMITS.BRIBE,
-            chainId: context.chainId,
-            type: txType
-        });
-    }
-    // ✅ 并行签名所有买入交易
-    const signedBuys = await Promise.all(swapUnsignedArray.buyUnsignedArray.map((unsigned, i) => buyer.signTransaction({
-        ...unsigned,
-        from: buyer.address,
-        nonce: multiNoncePlan.buyerNonces[i],
-        gasLimit: finalGasLimit,
-        gasPrice,
-        chainId: context.chainId,
-        type: txType
-    })));
-    // ✅ 并行签名所有卖出交易
-    const signedSells = await Promise.all(swapUnsignedArray.sellUnsignedArray.map((unsigned, i) => seller.signTransaction({
-        ...unsigned,
-        from: seller.address,
-        nonce: multiNoncePlan.sellerNonces[i],
-        gasLimit: finalGasLimit,
-        gasPrice,
-        chainId: context.chainId,
-        type: txType
-    })));
-    nonceManager.clearTemp();
-    validateFinalBalances({
-        sameAddress,
-        buyerFundsWei: buyerFundsInfo.buyerFundsWei,
-        buyerBalance: buyerFundsInfo.buyerBalance,
-        reserveGas: buyerFundsInfo.reserveGas,
-        gasLimit: finalGasLimit,
-        gasPrice,
-        useNativeToken,
-        quoteTokenDecimals,
-        provider: context.provider,
-        buyerAddress: buyer.address
-    });
-    // ✅ 组装顺序：贿赂 → 买入(多笔) → 卖出(多笔)（与 Flap 一致）
-    const allTransactions = [];
-    if (bribeTx)
-        allTransactions.push(bribeTx);
-    allTransactions.push(...signedBuys, ...signedSells);
-    // ✅ 利润多跳转账（强制 2 跳中转）
-    const profitResult = await buildProfitTransaction({
-        provider: context.provider,
-        seller,
-        profitAmount,
-        profitNonce: multiNoncePlan.profitNonce,
-        gasPrice,
-        chainId: context.chainId,
-        txType
-    });
-    let profitHopWallets;
-    if (profitResult) {
-        allTransactions.push(...profitResult.signedTransactions);
-        profitHopWallets = profitResult.hopWallets; // ✅ 收集利润多跳钱包
-    }
-    return {
-        signedTransactions: allTransactions,
-        profitHopWallets, // ✅ 返回利润多跳钱包
-        metadata: {
-            buyerAddress: buyer.address,
-            sellerAddress: seller.address,
-            buyAmount: useNativeToken
-                ? ethers.formatEther(buyerFundsInfo.buyerFundsWei)
-                : ethers.formatUnits(buyerFundsInfo.buyerFundsWei, quoteTokenDecimals),
-            sellAmount: quoteResult.quotedTokenOut.toString(),
-            profitAmount: profitAmount > 0n ? ethers.formatEther(profitAmount) : undefined,
-            // ✅ 返回多笔买卖信息
-            buyCount,
-            sellCount,
-            // ✅ 返回每笔交易的具体金额（随机分配后的数组）
-            buyAmounts: buyAmountsWei.map(amt => useNativeToken
-                ? ethers.formatEther(amt)
-                : ethers.formatUnits(amt, quoteTokenDecimals)),
-            sellAmounts: sellAmountsWei.map(amt => amt.toString())
-        }
-    };
-}
-function createPancakeContext(config) {
-    const chainId = config.chainId ?? 56;
-    const provider = new ethers.JsonRpcProvider(config.rpcUrl, {
-        chainId,
-        name: 'BSC'
-    });
-    return { chainId, provider };
-}
-async function calculateBuyerFunds({ buyer, buyerFunds, buyerFundsPercentage, reserveGas, useNativeToken = true, quoteToken, quoteTokenDecimals = 18, provider }) {
-    const reserveGasWei = ethers.parseEther((reserveGas ?? 0.0005).toString());
-    // ✅ 根据是否使用原生代币获取不同的余额
-    let buyerBalance;
-    if (useNativeToken) {
-        buyerBalance = await buyer.provider.getBalance(buyer.address);
-    }
-    else {
-        // ERC20 代币余额
-        const erc20 = new Contract(quoteToken, ERC20_BALANCE_OF_ABI, provider || buyer.provider);
-        buyerBalance = await erc20.balanceOf(buyer.address);
-    }
-    let buyerFundsWei;
-    if (buyerFunds !== undefined) {
-        // ✅ 根据代币精度解析金额
-        buyerFundsWei = useNativeToken
-            ? ethers.parseEther(String(buyerFunds))
-            : ethers.parseUnits(String(buyerFunds), quoteTokenDecimals);
-    }
-    else if (buyerFundsPercentage !== undefined) {
-        const pct = Math.max(0, Math.min(100, buyerFundsPercentage));
-        // ✅ 原生代币需要预留 Gas，ERC20 不需要
-        const spendable = useNativeToken
-            ? (buyerBalance > reserveGasWei ? buyerBalance - reserveGasWei : 0n)
-            : buyerBalance;
-        buyerFundsWei = (spendable * BigInt(Math.floor(pct * 100))) / 10000n;
-    }
-    else {
-        throw new Error('必须提供 buyerFunds 或 buyerFundsPercentage');
-    }
-    if (buyerFundsWei <= 0n) {
-        throw new Error('buyerFunds 需要大于 0');
-    }
-    // ✅ 余额检查
-    if (useNativeToken) {
-        if (buyerBalance < buyerFundsWei + reserveGasWei) {
-            throw new Error(`买方余额不足: 需要 ${ethers.formatEther(buyerFundsWei + reserveGasWei)} BNB，实际 ${ethers.formatEther(buyerBalance)} BNB`);
-        }
-    }
-    else {
-        // ERC20 购买：检查代币余额
-        if (buyerBalance < buyerFundsWei) {
-            throw new Error(`买方代币余额不足: 需要 ${ethers.formatUnits(buyerFundsWei, quoteTokenDecimals)}，实际 ${ethers.formatUnits(buyerBalance, quoteTokenDecimals)}`);
-        }
-        // ✅ ERC20 购买时，还需要检查买方是否有足够 BNB 支付 Gas
-        const buyerBnbBalance = await buyer.provider.getBalance(buyer.address);
-        if (buyerBnbBalance < reserveGasWei) {
-            throw new Error(`买方 BNB 余额不足 (用于支付 Gas): 需要 ${ethers.formatEther(reserveGasWei)} BNB，实际 ${ethers.formatEther(buyerBnbBalance)} BNB`);
-        }
-    }
-    return { buyerFundsWei, buyerBalance, reserveGas: reserveGasWei };
-}
-/**
- * ✅ 使用 quote-helpers 统一报价
- */
-async function quoteTokenOutput({ routeParams, buyerFundsWei, provider, v2RouterOverride }) {
-    // V2 路由
-    if (routeParams.routeType === 'v2') {
-        const { v2Path } = routeParams;
-        const tokenIn = v2Path[0];
-        const tokenOut = v2Path[v2Path.length - 1];
-        const result = await quoteV2(provider, tokenIn, tokenOut, buyerFundsWei, 'BSC', v2RouterOverride);
-        if (result.amountOut <= 0n) {
-            throw new Error('V2 报价失败');
-        }
-        return { quotedTokenOut: result.amountOut };
-    }
-    // V3 Single 路由
-    if (routeParams.routeType === 'v3-single') {
-        const paramsV3 = routeParams;
-        const result = await quoteV3(provider, paramsV3.v3TokenIn, paramsV3.v3TokenOut, buyerFundsWei, 'BSC', paramsV3.v3Fee);
-        if (result.amountOut <= 0n) {
-            throw new Error('V3 报价失败');
-        }
-        return { quotedTokenOut: result.amountOut };
-    }
-    // V3 Multi 路由
-    const paramsV3m = routeParams;
-    if (!paramsV3m.v2Path || paramsV3m.v2Path.length < 2) {
-        throw new Error('V3 多跳需要提供 v2Path 用于路径推断');
-    }
-    const tokenIn = paramsV3m.v2Path[0];
-    const tokenOut = paramsV3m.v2Path[paramsV3m.v2Path.length - 1];
-    const result = await quoteV3(provider, tokenIn, tokenOut, buyerFundsWei, 'BSC');
-    if (result.amountOut <= 0n) {
-        throw new Error('V3 多跳报价失败');
-    }
-    return { quotedTokenOut: result.amountOut };
-}
-/**
- * ✅ 构建多笔买入和卖出交易
- */
-async function buildMultiRouteTransactions({ routeParams, buyAmountsWei, sellAmountsWei, buyer, seller, tokenAddress, useNativeToken = true, v2RouterAddress }) {
-    const deadline = getDeadline();
-    if (routeParams.routeType === 'v2') {
-        const { v2Path } = routeParams;
-        const reversePath = [...v2Path].reverse();
-        const v2Addr = v2RouterAddress || PANCAKE_V2_ROUTER_ADDRESS;
-        const v2RouterBuyer = new Contract(v2Addr, PANCAKE_V2_ROUTER_ABI, buyer);
-        const v2RouterSeller = new Contract(v2Addr, PANCAKE_V2_ROUTER_ABI, seller);
-        // ✅ 根据是否使用原生代币选择不同的函数
-        if (useNativeToken) {
-            // BNB 池子：使用 swapExactETHForTokens / swapExactTokensForETH
-            const buyUnsignedArray = await Promise.all(buyAmountsWei.map(amount => {
-                const buyValue = amount + FLAT_FEE;
-                return v2RouterBuyer.swapExactETHForTokensSupportingFeeOnTransferTokens.populateTransaction(0n, v2Path, buyer.address, deadline, { value: buyValue });
-            }));
-            const sellUnsignedArray = await Promise.all(sellAmountsWei.map(amount => v2RouterSeller.swapExactTokensForETHSupportingFeeOnTransferTokens.populateTransaction(amount, 0n, reversePath, seller.address, deadline)));
-            return { buyUnsignedArray, sellUnsignedArray };
-        }
-        else {
-            // ✅ ERC20 池子（如 USDT）：使用 swapExactTokensForTokens
-            const buyUnsignedArray = await Promise.all(buyAmountsWei.map(amount => v2RouterBuyer.swapExactTokensForTokensSupportingFeeOnTransferTokens.populateTransaction(amount, 0n, v2Path, buyer.address, deadline)));
-            const sellUnsignedArray = await Promise.all(sellAmountsWei.map(amount => v2RouterSeller.swapExactTokensForTokensSupportingFeeOnTransferTokens.populateTransaction(amount, 0n, reversePath, seller.address, deadline)));
-            return { buyUnsignedArray, sellUnsignedArray };
-        }
-    }
-    if (routeParams.routeType === 'v3-single') {
-        const { v3TokenIn, v3TokenOut, v3Fee } = routeParams;
-        const v3RouterIface = new ethers.Interface(PANCAKE_V3_ROUTER_ABI);
-        const v3RouterBuyer = new Contract(PANCAKE_V3_ROUTER_ADDRESS, PANCAKE_V3_ROUTER_ABI, buyer);
-        const v3RouterSeller = new Contract(PANCAKE_V3_ROUTER_ADDRESS, PANCAKE_V3_ROUTER_ABI, seller);
-        // 构建多笔买入交易（ERC20 模式 value = 0，因为通过代币授权支付）
-        const buyUnsignedArray = await Promise.all(buyAmountsWei.map(amount => {
-            const buyValue = useNativeToken ? amount + FLAT_FEE : 0n;
-            const buySwapData = v3RouterIface.encodeFunctionData('exactInputSingle', [{
-                    tokenIn: v3TokenIn,
-                    tokenOut: v3TokenOut,
-                    fee: v3Fee,
-                    recipient: buyer.address,
-                    amountIn: amount,
-                    amountOutMinimum: 0n,
-                    sqrtPriceLimitX96: 0n
-                }]);
-            return v3RouterBuyer.multicall.populateTransaction(deadline, [buySwapData], { value: buyValue });
-        }));
-        // ✅ 根据是否使用原生代币构建不同的卖出交易
-        if (useNativeToken) {
-            // BNB 池子：卖出后 unwrap WBNB 为 BNB
-            const sellUnsignedArray = await Promise.all(sellAmountsWei.map(amount => {
-                const sellSwapData = v3RouterIface.encodeFunctionData('exactInputSingle', [{
-                        tokenIn: v3TokenOut,
-                        tokenOut: v3TokenIn,
-                        fee: v3Fee,
-                        recipient: PANCAKE_V3_ROUTER_ADDRESS,
-                        amountIn: amount,
-                        amountOutMinimum: 0n,
-                        sqrtPriceLimitX96: 0n
-                    }]);
-                const sellUnwrapData = v3RouterIface.encodeFunctionData('unwrapWETH9', [0n, seller.address]);
-                return v3RouterSeller.multicall.populateTransaction(deadline, [sellSwapData, sellUnwrapData]);
-            }));
-            return { buyUnsignedArray, sellUnsignedArray };
-        }
-        else {
-            // ✅ ERC20 池子：卖出后直接获得 ERC20
-            const sellUnsignedArray = await Promise.all(sellAmountsWei.map(amount => {
-                const sellSwapData = v3RouterIface.encodeFunctionData('exactInputSingle', [{
-                        tokenIn: v3TokenOut,
-                        tokenOut: v3TokenIn,
-                        fee: v3Fee,
-                        recipient: seller.address, // 直接发送到卖方地址
-                        amountIn: amount,
-                        amountOutMinimum: 0n,
-                        sqrtPriceLimitX96: 0n
-                    }]);
-                return v3RouterSeller.multicall.populateTransaction(deadline, [sellSwapData]);
-            }));
-            return { buyUnsignedArray, sellUnsignedArray };
-        }
-    }
-    throw new Error('V3 多跳路由暂不支持官方合约，请使用 V2 路由或 V3 单跳');
-}
-/**
- * ✅ 规划多笔交易 nonce（与 Flap 一致）
- * 交易顺序：贿赂 → 买入(多笔) → 卖出(多笔) → 利润
- */
-async function planMultiNonces({ buyer, seller, buyCount, sellCount, sameAddress, extractProfit, needBribeTx, nonceManager }) {
-    const profitNonceCount = extractProfit ? 1 : 0;
-    if (sameAddress) {
-        // 同一地址：贿赂(可选) + 买入(多笔) + 卖出(多笔) + 利润(可选)
-        const bribeTxCount = needBribeTx ? 1 : 0;
-        const totalTxCount = bribeTxCount + buyCount + sellCount + profitNonceCount;
-        const nonces = await nonceManager.getNextNonceBatch(buyer, totalTxCount);
-        let idx = 0;
-        const bribeNonce = needBribeTx ? nonces[idx++] : undefined;
-        const buyerNonces = nonces.slice(idx, idx + buyCount);
-        idx += buyCount;
-        const sellerNonces = nonces.slice(idx, idx + sellCount);
-        idx += sellCount;
-        const profitNonce = extractProfit ? nonces[idx] : undefined;
-        return { buyerNonces, sellerNonces, bribeNonce, profitNonce };
-    }
-    // 不同地址
-    // 买方：buyCount 个 nonce
-    // 卖方：贿赂(可选) + sellCount + 利润(可选) 个 nonce
-    const bribeTxCount = needBribeTx ? 1 : 0;
-    const sellerTxCount = bribeTxCount + sellCount + profitNonceCount;
-    const [buyerNonces, sellerNoncesAll] = await Promise.all([
-        nonceManager.getNextNonceBatch(buyer, buyCount),
-        nonceManager.getNextNonceBatch(seller, sellerTxCount)
-    ]);
-    let idx = 0;
-    const bribeNonce = needBribeTx ? sellerNoncesAll[idx++] : undefined;
-    const sellerNonces = sellerNoncesAll.slice(idx, idx + sellCount);
-    idx += sellCount;
-    const profitNonce = extractProfit ? sellerNoncesAll[idx] : undefined;
-    return { buyerNonces, sellerNonces, bribeNonce, profitNonce };
-}
-/**
- * 构建利润多跳转账交易（强制 2 跳中转）
- */
-async function buildProfitTransaction({ provider, seller, profitAmount, profitNonce, gasPrice, chainId, txType }) {
-    if (profitNonce === undefined || profitAmount === 0n) {
-        return null;
-    }
-    const profitHopResult = await buildProfitHopTransactions({
-        provider,
-        payerWallet: seller,
-        profitAmount,
-        profitRecipient: PROFIT_CONFIG.RECIPIENT,
-        hopCount: PROFIT_HOP_COUNT,
-        gasPrice,
-        chainId,
-        txType,
-        startNonce: profitNonce
-    });
-    return { signedTransactions: profitHopResult.signedTransactions, hopWallets: profitHopResult.hopWallets };
-}
-async function validateFinalBalances({ sameAddress, buyerFundsWei, buyerBalance, reserveGas, gasLimit, gasPrice, useNativeToken = true, quoteTokenDecimals = 18, provider, buyerAddress }) {
-    const gasCost = gasLimit * gasPrice;
-    if (sameAddress) {
-        // 同一地址：需要足够的余额支付两笔交易
-        if (useNativeToken) {
-            const requiredCombined = buyerFundsWei + 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 = buyerFundsWei + 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 = buyerFundsWei + FLAT_FEE + reserveGas;
-        if (buyerBalance < requiredBuyer) {
-            throw new Error(`买方余额不足:\n  - 需要: ${ethers.formatEther(requiredBuyer)} BNB\n  - 实际: ${ethers.formatEther(buyerBalance)} BNB`);
-        }
-    }
-    // ERC20 余额已在 calculateBuyerFunds 中检查过
-}
-// ==================== 多钱包模式 ====================
-/**
- * ✅ 多钱包捆绑换手
- * - 多个买方钱包执行买入（每个钱包1笔）
- * - 多个卖方钱包执行卖出（每个钱包1笔）
- * - 买入总价值 = 卖出总价值
- * - ✅ 优化：最大化并行操作
- */
-async function pancakeBundleBuyFirstMultiWallet(params) {
-    const { buyerPrivateKeys, sellerPrivateKeys, tokenAddress, routeParams, buyerFunds, config, quoteToken, quoteTokenDecimals = 18, taxRateBps = 0 // ✅ 税率（基点）
-     } = params;
-    const buyCount = buyerPrivateKeys.length;
-    const sellCount = sellerPrivateKeys.length;
-    if (buyCount === 0)
-        throw new Error('买方钱包数量不能为0');
-    if (sellCount === 0)
-        throw new Error('卖方钱包数量不能为0');
-    // 验证总交易数不超过限制
-    validateSwapCounts(buyCount, sellCount);
-    // ✅ 计算利润比例（根据 userType 动态调整）
-    const totalTxCount = buyCount + sellCount;
-    const profitRateBps = getProfitRatePerTxBps(config.userType) * totalTxCount;
-    // ✅ 判断是否使用原生代币
-    const useNativeToken = !quoteToken || quoteToken === ZERO_ADDRESS;
-    const context = createPancakeContext(config);
-    const nonceManager = new NonceManager(context.provider);
-    // 创建所有钱包实例
-    const buyers = buyerPrivateKeys.map(pk => new Wallet(pk, context.provider));
-    const sellers = sellerPrivateKeys.map(pk => new Wallet(pk, context.provider));
-    // 使用第一个卖方作为主卖方（支付贿赂和利润）
-    const mainSeller = sellers[0];
-    // ✅ 计算总交易金额
-    let totalFundsWei;
-    if (buyerFunds) {
-        totalFundsWei = useNativeToken
-            ? ethers.parseEther(String(buyerFunds))
-            : ethers.parseUnits(String(buyerFunds), quoteTokenDecimals);
-    }
-    else {
-        throw new Error('多钱包模式必须提供 buyerFunds（总交易金额）');
-    }
-    if (totalFundsWei <= 0n) {
-        throw new Error('交易金额必须大于0');
-    }
-    const finalGasLimit = getGasLimit(config);
-    const txType = config.txType ?? 0;
-    const deadline = BigInt(getDeadline());
-    const bribeAmount = config.bribeAmount && config.bribeAmount > 0
-        ? ethers.parseEther(String(config.bribeAmount))
-        : 0n;
-    const needBribeTx = bribeAmount > 0n;
-    // ✅ 第一批并行：报价 + Gas价格 + 所有钱包 nonces
-    // 预先计算所有唯一钱包地址（去重）
-    const allWallets = [...sellers, ...buyers];
-    const uniqueWallets = allWallets.filter((w, i) => {
-        const addr = w.address.toLowerCase();
-        const firstIdx = allWallets.findIndex(x => x.address.toLowerCase() === addr);
-        return firstIdx === i;
-    });
-    const [quoteResult, gasPrice, noncesArray] = await Promise.all([
-        quoteTokenOutput({
-            routeParams,
-            buyerFundsWei: totalFundsWei,
-            provider: context.provider,
-            v2RouterOverride: config.v2RouterAddress
-        }),
-        getGasPrice(context.provider, config),
-        nonceManager.getNextNoncesForWallets(uniqueWallets)
-    ]);
-    // 构建 nonces Map
-    const noncesMap = new Map();
-    uniqueWallets.forEach((wallet, i) => {
-        noncesMap.set(wallet.address.toLowerCase(), noncesArray[i]);
-    });
-    // ✅ 将总金额平均分配给买方
-    const buyAmountsWei = splitAmount(totalFundsWei, buyCount);
-    // ✅ 税币支持：买入时会被扣税，实际获得的代币 = 报价 * (1 - 税率)
-    let actualTokenOut = quoteResult.quotedTokenOut;
-    if (taxRateBps > 0) {
-        actualTokenOut = (quoteResult.quotedTokenOut * BigInt(10000 - taxRateBps)) / 10000n;
-        console.log(`[pancakeBundleBuyFirstMultiWallet] 税币模式: 税率=${taxRateBps}bps, 报价=${quoteResult.quotedTokenOut}, 实际可卖=${actualTokenOut}`);
-    }
-    // ✅ 将代币平均分配给卖方
-    const sellAmountsWei = splitAmount(actualTokenOut, sellCount);
-    // ✅ 直接使用总交易金额作为利润基础（多钱包模式）
-    // profitRateBps = 每笔交易利润率(bps) * 交易笔数
-    const tokenProfitAmount = (totalFundsWei * BigInt(profitRateBps)) / 10000n;
-    // ✅ ERC20 购买：将代币利润转换为等值 BNB（因为利润是用 BNB 转账的）
-    let profitAmount = tokenProfitAmount;
-    if (!useNativeToken && tokenProfitAmount > 0n && quoteToken) {
-        const version = routeParams.routeType === 'v2' ? 'v2' : 'v3';
-        const fee = routeParams.routeType === 'v3-single' ? routeParams.v3Fee : undefined;
-        profitAmount = await getTokenToNativeQuote(context.provider, quoteToken, tokenProfitAmount, 'BSC', version, fee);
-        // ERC20→BNB 转换完成
-    }
-    // ✅ 第三批并行：构建并签名所有交易
-    const allTransactions = [];
-    // 1. 贿赂交易（由主卖方支付）- 先处理以确定 nonce 偏移
-    let bribeTxPromise = null;
-    if (needBribeTx) {
-        const mainSellerAddr = mainSeller.address.toLowerCase();
-        const bribeNonce = noncesMap.get(mainSellerAddr);
-        noncesMap.set(mainSellerAddr, bribeNonce + 1);
-        bribeTxPromise = mainSeller.signTransaction({
-            to: BLOCKRAZOR_BUILDER_EOA,
-            value: bribeAmount,
-            nonce: bribeNonce,
-            gasPrice,
-            gasLimit: GAS_LIMITS.BRIBE,
-            chainId: context.chainId,
-            type: txType
-        });
-    }
-    // 2. 预分配所有 nonces（同步操作，避免竞态）
-    const buyerNonces = [];
-    const sellerNonces = [];
-    buyers.forEach(buyer => {
-        const addr = buyer.address.toLowerCase();
-        const nonce = noncesMap.get(addr);
-        buyerNonces.push(nonce);
-        noncesMap.set(addr, nonce + 1);
-    });
-    sellers.forEach(seller => {
-        const addr = seller.address.toLowerCase();
-        const nonce = noncesMap.get(addr);
-        sellerNonces.push(nonce);
-        noncesMap.set(addr, nonce + 1);
-    });
-    // 3. 并行构建所有买入交易
-    const buyTxPromises = buyers.map(async (buyer, i) => {
-        const unsigned = await buildSingleBuyTx({
-            routeParams,
-            buyAmount: buyAmountsWei[i],
-            buyer,
-            tokenAddress,
-            useNativeToken,
-            deadline,
-            v2RouterAddress: config.v2RouterAddress
-        });
-        return buyer.signTransaction({
-            ...unsigned,
-            from: buyer.address,
-            nonce: buyerNonces[i],
-            gasLimit: finalGasLimit,
-            gasPrice,
-            chainId: context.chainId,
-            type: txType
-        });
-    });
-    // 4. 并行构建所有卖出交易
-    const sellTxPromises = sellers.map(async (seller, i) => {
-        const unsigned = await buildSingleSellTx({
-            routeParams,
-            sellAmount: sellAmountsWei[i],
-            seller,
-            tokenAddress,
-            useNativeToken,
-            deadline,
-            v2RouterAddress: config.v2RouterAddress
-        });
-        return seller.signTransaction({
-            ...unsigned,
-            from: seller.address,
-            nonce: sellerNonces[i],
-            gasLimit: finalGasLimit,
-            gasPrice,
-            chainId: context.chainId,
-            type: txType
-        });
-    });
-    // ✅ 并行签名所有交易（贿赂 + 买入 + 卖出）
-    const [bribeTx, signedBuys, signedSells] = await Promise.all([
-        bribeTxPromise,
-        Promise.all(buyTxPromises),
-        Promise.all(sellTxPromises)
-    ]);
-    // 组装交易顺序：贿赂 → 买入 → 卖出
-    if (bribeTx)
-        allTransactions.push(bribeTx);
-    allTransactions.push(...signedBuys, ...signedSells);
-    // 5. 利润多跳转账（由主卖方支付）
-    let profitHopWallets;
-    if (profitAmount > 0n) {
-        const mainSellerAddr = mainSeller.address.toLowerCase();
-        const profitNonce = noncesMap.get(mainSellerAddr);
-        const profitResult = await buildProfitTransaction({
-            provider: context.provider,
-            seller: mainSeller,
-            profitAmount,
-            profitNonce,
-            gasPrice,
-            chainId: context.chainId,
-            txType
-        });
-        if (profitResult) {
-            allTransactions.push(...profitResult.signedTransactions);
-            profitHopWallets = profitResult.hopWallets;
-        }
-    }
-    nonceManager.clearTemp();
-    return {
-        signedTransactions: allTransactions,
-        profitHopWallets,
-        metadata: {
-            buyerAddress: buyers.map(b => b.address).join(','),
-            sellerAddress: sellers.map(s => s.address).join(','),
-            buyAmount: useNativeToken
-                ? ethers.formatEther(totalFundsWei)
-                : ethers.formatUnits(totalFundsWei, quoteTokenDecimals),
-            sellAmount: quoteResult.quotedTokenOut.toString(),
-            profitAmount: profitAmount > 0n ? ethers.formatEther(profitAmount) : undefined,
-            buyCount,
-            sellCount,
-            buyAmounts: buyAmountsWei.map(amt => useNativeToken
-                ? ethers.formatEther(amt)
-                : ethers.formatUnits(amt, quoteTokenDecimals)),
-            sellAmounts: sellAmountsWei.map(amt => amt.toString())
-        }
-    };
-}
-// ✅ 构建单笔买入交易
-async function buildSingleBuyTx({ routeParams, buyAmount, buyer, tokenAddress, useNativeToken, deadline, v2RouterAddress }) {
-    if (routeParams.routeType === 'v2') {
-        const { v2Path } = routeParams;
-        const v2Router = new Contract(v2RouterAddress || PANCAKE_V2_ROUTER_ADDRESS, PANCAKE_V2_ROUTER_ABI, buyer);
-        if (useNativeToken) {
-            return await v2Router.swapExactETHForTokensSupportingFeeOnTransferTokens.populateTransaction(0n, v2Path, buyer.address, deadline, { value: buyAmount });
-        }
-        else {
-            return await v2Router.swapExactTokensForTokensSupportingFeeOnTransferTokens.populateTransaction(buyAmount, 0n, v2Path, buyer.address, deadline);
-        }
-    }
-    if (routeParams.routeType === 'v3-single') {
-        const { v3TokenIn, v3TokenOut, v3Fee } = routeParams;
-        const v3RouterIface = new ethers.Interface(PANCAKE_V3_ROUTER_ABI);
-        const v3Router = new Contract(PANCAKE_V3_ROUTER_ADDRESS, PANCAKE_V3_ROUTER_ABI, buyer);
-        const buyValue = useNativeToken ? buyAmount : 0n;
-        const buySwapData = v3RouterIface.encodeFunctionData('exactInputSingle', [{
-                tokenIn: v3TokenIn,
-                tokenOut: v3TokenOut,
-                fee: v3Fee,
-                recipient: buyer.address,
-                amountIn: buyAmount,
-                amountOutMinimum: 0n,
-                sqrtPriceLimitX96: 0n
-            }]);
-        return await v3Router.multicall.populateTransaction(deadline, [buySwapData], { value: buyValue });
-    }
-    throw new Error('V3 多跳路由暂不支持');
-}
-// ✅ 构建单笔卖出交易
-async function buildSingleSellTx({ routeParams, sellAmount, seller, tokenAddress, useNativeToken, deadline, v2RouterAddress }) {
-    if (routeParams.routeType === 'v2') {
-        const { v2Path } = routeParams;
-        const reversePath = [...v2Path].reverse();
-        const v2Router = new Contract(v2RouterAddress || PANCAKE_V2_ROUTER_ADDRESS, PANCAKE_V2_ROUTER_ABI, seller);
-        if (useNativeToken) {
-            return await v2Router.swapExactTokensForETHSupportingFeeOnTransferTokens.populateTransaction(sellAmount, 0n, reversePath, seller.address, deadline);
-        }
-        else {
-            return await v2Router.swapExactTokensForTokensSupportingFeeOnTransferTokens.populateTransaction(sellAmount, 0n, reversePath, seller.address, deadline);
-        }
-    }
-    if (routeParams.routeType === 'v3-single') {
-        const { v3TokenIn, v3TokenOut, v3Fee } = routeParams;
-        const v3RouterIface = new ethers.Interface(PANCAKE_V3_ROUTER_ABI);
-        const v3Router = new Contract(PANCAKE_V3_ROUTER_ADDRESS, PANCAKE_V3_ROUTER_ABI, seller);
-        if (useNativeToken) {
-            const sellSwapData = v3RouterIface.encodeFunctionData('exactInputSingle', [{
-                    tokenIn: v3TokenOut,
-                    tokenOut: v3TokenIn,
-                    fee: v3Fee,
-                    recipient: PANCAKE_V3_ROUTER_ADDRESS,
-                    amountIn: sellAmount,
-                    amountOutMinimum: 0n,
-                    sqrtPriceLimitX96: 0n
-                }]);
-            const sellUnwrapData = v3RouterIface.encodeFunctionData('unwrapWETH9', [0n, seller.address]);
-            return await v3Router.multicall.populateTransaction(deadline, [sellSwapData, sellUnwrapData]);
-        }
-        else {
-            const sellSwapData = v3RouterIface.encodeFunctionData('exactInputSingle', [{
-                    tokenIn: v3TokenOut,
-                    tokenOut: v3TokenIn,
-                    fee: v3Fee,
-                    recipient: seller.address,
-                    amountIn: sellAmount,
-                    amountOutMinimum: 0n,
-                    sqrtPriceLimitX96: 0n
-                }]);
-            return await v3Router.multicall.populateTransaction(deadline, [sellSwapData]);
-        }
-    }
-    throw new Error('V3 多跳路由暂不支持');
-}