four-flap-meme-sdk 2.0.0 → 2.2.0

package/dist/shared/flap/portal-bundle-merkle/swap/index.js

@@ -1,1448 +0,0 @@
-/**
- * Flap Protocol 内盘捆绑换手（Merkle Bundle）
- *
- * 功能：钱包A卖出代币 → 钱包B买入相同数量 → 原子执行
- */
-import { ethers, Contract, Wallet } from 'ethers';
-import { calculateSellAmount } from '../../../../utils/swap-helpers.js';
-import { NonceManager, getOptimizedGasPrice, buildProfitHopTransactions, PROFIT_HOP_COUNT } from '../../../../utils/bundle-helpers.js';
-import { FLAP_PORTAL_ADDRESSES } from '../../constants.js';
-import { PROFIT_CONFIG, ADDRESSES, ZERO_ADDRESS } from '../../../../utils/constants.js';
-import { ERC20_ALLOWANCE_ABI, V2_ROUTER_QUOTE_ABI, ERC20_BALANCE_ABI, ERC20_ABI } from '../../../abis/common.js';
-import { getGasPriceConfig, getTxType, getProfitRecipient, getBribeAmount, BLOCKRAZOR_BUILDER_EOA, PORTAL_ABI } from '../config.js';
-import { generateWallets } from '../../../../utils/wallet.js';
-import { GAS_LIMITS, CHAINS } from '../../../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;
-hopWallets: Wallet[];
-hopWalletsInfo: GeneratedWallet[];
-;
-/**
- * 生成分发多跳路径
- */
-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) {
-        signedTxs.push(await payer.signTransaction({
-            to: path.targetAddress,
-            value: finalAmount,
-            nonce: payerNonce,
-            gasLimit: NATIVE_TRANSFER_GAS_LIMIT,
-            gasPrice,
-            chainId,
-            type: txType
-        }));
-        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
-    signedTxs.push(await payer.signTransaction({
-        to: path.hopWallets[0].address,
-        value: amountsPerHop[0],
-        nonce: payerNonce,
-        gasLimit: NATIVE_TRANSFER_GAS_LIMIT,
-        gasPrice,
-        chainId,
-        type: txType
-    }));
-    // 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];
-        signedTxs.push(await fromWallet.signTransaction({
-            to: toAddress,
-            value: amount,
-            nonce: 0,
-            gasLimit: NATIVE_TRANSFER_GAS_LIMIT,
-            gasPrice,
-            chainId,
-            type: txType
-        }));
-    }
-    return signedTxs;
-}
-/**
- * 构建 ERC20 多跳转账链
- */
-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]);
-        signedTxs.push(await payer.signTransaction({
-            to: erc20Address,
-            data,
-            value: 0n,
-            nonce: payerNonce,
-            gasLimit: ERC20_TRANSFER_GAS_LIMIT_HOP,
-            gasPrice,
-            chainId,
-            type: txType
-        }));
-        return signedTxs;
-    }
-    // payer → hop1
-    const firstData = erc20Interface.encodeFunctionData('transfer', [path.hopWallets[0].address, erc20Amount]);
-    signedTxs.push(await payer.signTransaction({
-        to: erc20Address,
-        data: firstData,
-        value: 0n,
-        nonce: payerNonce,
-        gasLimit: ERC20_TRANSFER_GAS_LIMIT_HOP,
-        gasPrice,
-        chainId,
-        type: txType
-    }));
-    // 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]);
-        signedTxs.push(await fromWallet.signTransaction({
-            to: erc20Address,
-            data,
-            value: 0n,
-            nonce: 1, // nonce=0 已用于 BNB 转发
-            gasLimit: ERC20_TRANSFER_GAS_LIMIT_HOP,
-            gasPrice,
-            chainId,
-            type: txType
-        }));
-    }
-    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) {
-        return signedTxs;
-    }
-    const hopGasCost = NATIVE_TRANSFER_GAS_LIMIT * gasPrice;
-    const erc20GasCost = ERC20_TRANSFER_GAS_LIMIT_HOP * gasPrice;
-    const gasPerHop = hopGasCost + erc20GasCost * 2n;
-    const amountsPerHop = [];
-    for (let i = 0; i < hopCount; i++) {
-        const remainingHops = hopCount - i;
-        amountsPerHop.push(finalGasAmount + gasPerHop * BigInt(remainingHops));
-    }
-    // payer → hop1
-    signedTxs.push(await payer.signTransaction({
-        to: path.hopWallets[0].address,
-        value: amountsPerHop[0],
-        nonce: payerNonce,
-        gasLimit: NATIVE_TRANSFER_GAS_LIMIT,
-        gasPrice,
-        chainId,
-        type: txType
-    }));
-    // 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];
-        signedTxs.push(await fromWallet.signTransaction({
-            to: toAddress,
-            value: amount,
-            nonce: 0,
-            gasLimit: NATIVE_TRANSFER_GAS_LIMIT,
-            gasPrice,
-            chainId,
-            type: txType
-        }));
-    }
-    return signedTxs;
-}
-// ✅ 用户类型（影响利润率）
-// ✅ 简化的签名配置
-/**
- * 获取 Gas Limit
- */
-function getGasLimit(config, defaultGas = 500000) {
-    if (config.gasLimit !== undefined) {
-        return typeof config.gasLimit === 'bigint' ? config.gasLimit : BigInt(config.gasLimit);
-    }
-    const multiplier = config.gasLimitMultiplier ?? 1.0;
-    return BigInt(Math.ceil(defaultGas * multiplier));
-}
-// ✅ ABI 别名
-const ROUTER_ABI = V2_ROUTER_QUOTE_ABI;
-const ERC20_BALANCE_OF_ABI = ERC20_BALANCE_ABI;
-const APPROVE_INTERFACE = new ethers.Interface(['function approve(address,uint256) returns (bool)']);
-// ✅ 链常量
-const BSC_PANCAKE_V2_ROUTER = ADDRESSES.BSC.PancakeV2Router;
-const BSC_WBNB = ADDRESSES.BSC.WBNB;
-const MONAD_PANCAKE_V2_ROUTER = '0xb1bc24c34e88f7d43d5923034e3a14b24daacff9';
-const MONAD_WMON = ADDRESSES.MONAD.WMON;
-/**
- * 获取 ERC20 代币 → 原生代币的报价
- * @param provider - Provider 实例
- * @param tokenAddress - ERC20 代币地址
- * @param tokenAmount - 代币数量（wei）
- * @param chainId - 链 ID（56=BSC, 143=Monad）
- * @returns 等值的原生代币数量（wei），失败返回 0n
- */
-async function getTokenToNativeQuote(provider, tokenAddress, tokenAmount, chainId) {
-    if (tokenAmount <= 0n)
-        return 0n;
-    try {
-        if (chainId === CHAINS.BSC.chainId) {
-            // BSC: 使用 PancakeSwap V2 Router
-            const router = new Contract(BSC_PANCAKE_V2_ROUTER, ROUTER_ABI, provider);
-            const amounts = await router.getAmountsOut(tokenAmount, [tokenAddress, BSC_WBNB]);
-            return amounts[1];
-        }
-        if (chainId === CHAINS.MONAD.chainId) {
-            // ✅ Monad: 使用 PancakeSwap V2 Router
-            const router = new Contract(MONAD_PANCAKE_V2_ROUTER, ROUTER_ABI, provider);
-            const amounts = await router.getAmountsOut(tokenAmount, [tokenAddress, MONAD_WMON]);
-            return amounts[1];
-        }
-        // ✅ Base (8453) / XLayer (196) 等链暂不支持 V2 报价，返回 0
-        return 0n;
-    }
-    catch {
-        // 报价失败返回 0（可能是流动性不足或路径不存在）
-        return 0n;
-    }
-}
-// ✅ Merkle 配置（保留兼容）
-// ✅ 签名参数（不依赖 Merkle）
-// ✅ Merkle 参数（保留兼容）
-profitHopWallets ?  : GeneratedWallet[]; // ✅ 利润多跳中间钱包
-metadata ?  : {
-    sellerAddress: string,
-    buyerAddress: string,
-    sellAmount: string,
-    buyAmount: string,
-    hasApproval: boolean, // 是否包含授权交易
-    profitAmount: string
-};
-;
-/**
- * 获取链ID
- */
-function getChainId(chain) {
-    switch (chain) {
-        case 'bsc': return 56;
-        case 'xlayer': return 196;
-        case 'base': return 8453;
-    }
-}
-/**
- * 获取原生代币名称
- */
-function getNativeTokenName(chain) {
-    switch (chain) {
-        case 'bsc': return 'BNB';
-        case 'xlayer': return 'OKB';
-        case 'base': return 'ETH';
-    }
-}
-/**
- * Flap内盘捆绑换手
- * ✅ 支持 quoteToken：传入 USDT 等地址时，卖出得到该代币，买入使用该代币
- */
-export async function flapBundleSwapMerkle(params) {
-    const { chain, sellerPrivateKey, sellAmount, sellPercentage, buyerPrivateKey, tokenAddress, config, quoteToken, quoteTokenDecimals, startNonces // ✅ 可选：前端预获取的 nonces
-     } = params;
-    const chainContext = createChainContext(chain, config);
-    const seller = new Wallet(sellerPrivateKey, chainContext.provider);
-    const buyer = new Wallet(buyerPrivateKey, chainContext.provider);
-    const nonceManager = new NonceManager(chainContext.provider);
-    const finalGasLimit = getGasLimit(config);
-    const txType = getTxType(config);
-    // ✅ 判断是否使用原生代币（BNB）或 ERC20 代币（如 USDT）
-    const useNativeToken = !quoteToken || quoteToken === ZERO_ADDRESS;
-    const outputToken = useNativeToken ? ZERO_ADDRESS : quoteToken;
-    // ✅ 优化：第一批并行 - calculateSellAmount、gasPrice
-    const [sellAmountResult, gasPrice] = await Promise.all([
-        calculateSellAmount(chainContext.provider, tokenAddress, seller.address, sellAmount, sellPercentage),
-        getOptimizedGasPrice(chainContext.provider, getGasPriceConfig(config))
-    ]);
-    const { amount: sellAmountWei, decimals } = sellAmountResult;
-    const priorityFee = gasPrice / 10n === 0n ? 1n : gasPrice / 10n;
-    // ✅ 优化：第二批并行 - approval、quote（已移除滑点保护）
-    const [approvalTx, quote] = await Promise.all([
-        config.skipApprovalCheck
-            ? Promise.resolve(null)
-            : buildApprovalTransaction({
-                tokenAddress,
-                seller,
-                provider: chainContext.provider,
-                decimals,
-                portalAddress: chainContext.portalAddress,
-                chainId: chainContext.chainId,
-                config
-            }),
-        quoteSellOutput({
-            portalAddress: chainContext.portalAddress,
-            tokenAddress,
-            sellAmountWei,
-            provider: chainContext.provider,
-            skipQuoteOnError: config.skipQuoteOnError,
-            outputToken // ✅ 传递输出代币
-        })
-    ]);
-    // ✅ 优化：第三批并行 - buyerNeed、validateBalances
-    const buyerNeed = await calculateBuyerNeed({
-        buyer,
-        quotedNative: quote.quotedNative,
-        reserveGasEth: config.reserveGasETH,
-        nativeToken: chainContext.nativeToken,
-        useNativeToken,
-        quoteToken,
-        quoteTokenDecimals,
-        provider: chainContext.provider
-    });
-    // ✅ 计算利润（基于卖出报价，根据 userType 动态调整）
-    const tokenProfitAmount = calculateProfitAmount(quote.quotedNative, config.userType);
-    // ✅ ERC20 输出：获取代币利润等值的原生代币（BNB）报价
-    let nativeProfitAmount = tokenProfitAmount; // 原生代币输出时直接使用
-    if (!useNativeToken && tokenProfitAmount > 0n) {
-        // 将代币利润转换为等值 BNB
-        nativeProfitAmount = await getTokenToNativeQuote(chainContext.provider, quoteToken, tokenProfitAmount, chainContext.chainId);
-    }
-    // ✅ 获取贿赂金额
-    const bribeAmount = getBribeAmount(config);
-    const needBribeTx = bribeAmount > 0n;
-    // ✅ 优化：第四批并行 - 构建交易、获取 nonces、验证余额
-    const portalSeller = new Contract(chainContext.portalAddress, PORTAL_ABI, seller);
-    const portalBuyer = new Contract(chainContext.portalAddress, PORTAL_ABI, buyer);
-    const [sellUnsigned, buyUnsigned, noncePlan] = await Promise.all([
-        portalSeller.swapExactInput.populateTransaction({
-            inputToken: tokenAddress,
-            outputToken, // ✅ 使用动态输出代币
-            inputAmount: sellAmountWei,
-            minOutputAmount: 0,
-            permitData: '0x'
-        }),
-        portalBuyer.swapExactInput.populateTransaction({
-            inputToken: outputToken, // ✅ 使用动态输入代币
-            outputToken: tokenAddress,
-            inputAmount: buyerNeed.maxBuyerValue,
-            minOutputAmount: 0,
-            permitData: '0x'
-        }, useNativeToken ? { value: buyerNeed.maxBuyerValue } : {} // ✅ ERC20 购买时 value=0
-        ),
-        // ✅ 如果前端传入了 startNonces，直接使用（性能优化）
-        startNonces && startNonces.length >= 2
-            ? buildNoncePlan(startNonces, !!approvalTx, nativeProfitAmount > 0n, needBribeTx)
-            : planNonces({
-                seller,
-                buyer,
-                approvalExists: !!approvalTx,
-                extractProfit: nativeProfitAmount > 0n,
-                needBribeTx,
-                nonceManager
-            }),
-        validateBalances({
-            buyerNeed,
-            buyerAddress: buyer.address,
-            portalGasCost: finalGasLimit * gasPrice,
-            provider: chainContext.provider,
-            chainContext,
-            seller,
-            useNativeToken, // ✅ 传递是否使用原生代币
-            quoteTokenDecimals // ✅ 传递代币精度
-        })
-    ]);
-    // 构建交易请求
-    // ✅ 卖出交易 value 必须为 0，不能发送原生代币
-    const sellTx = buildTransactionRequest(sellUnsigned, {
-        from: seller.address,
-        nonce: noncePlan.sellerNonce,
-        gasLimit: finalGasLimit,
-        gasPrice,
-        priorityFee,
-        chainId: chainContext.chainId,
-        txType,
-        value: 0n // ✅ 卖出交易不发送原生代币
-    });
-    const buyTx = buildTransactionRequest(buyUnsigned, {
-        from: buyer.address,
-        nonce: noncePlan.buyerNonce,
-        gasLimit: finalGasLimit,
-        gasPrice,
-        priorityFee,
-        chainId: chainContext.chainId,
-        txType,
-        value: useNativeToken ? buyerNeed.maxBuyerValue : 0n // ✅ ERC20 购买时 value=0
-    });
-    // ✅ 贿赂交易放在首位
-    let bribeTx = null;
-    if (needBribeTx && noncePlan.bribeNonce !== undefined) {
-        bribeTx = await seller.signTransaction({
-            to: BLOCKRAZOR_BUILDER_EOA,
-            value: bribeAmount,
-            nonce: noncePlan.bribeNonce,
-            gasPrice,
-            gasLimit: BRIBE_GAS_LIMIT,
-            chainId: chainContext.chainId,
-            type: txType
-        });
-    }
-    // ✅ 并行签名卖出和买入交易
-    const [signedSell, signedBuy] = await Promise.all([
-        seller.signTransaction(sellTx),
-        buyer.signTransaction(buyTx)
-    ]);
-    nonceManager.clearTemp();
-    // ✅ 组装顺序：贿赂 → 授权 → 卖出 → 买入
-    const allTransactions = [];
-    if (bribeTx)
-        allTransactions.push(bribeTx);
-    if (approvalTx)
-        allTransactions.push(approvalTx);
-    allTransactions.push(signedSell, signedBuy);
-    // ✅ 利润多跳转账（强制 2 跳中转）
-    const profitResult = await buildProfitTransaction({
-        provider: chainContext.provider,
-        seller,
-        profitAmount: nativeProfitAmount,
-        profitNonce: noncePlan.profitNonce,
-        gasPrice,
-        chainId: chainContext.chainId,
-        txType
-    });
-    if (profitResult)
-        allTransactions.push(...profitResult.signedTransactions);
-    return {
-        signedTransactions: allTransactions,
-        profitHopWallets: profitResult?.hopWallets, // ✅ 导出利润多跳钱包
-        metadata: {
-            sellerAddress: seller.address,
-            buyerAddress: buyer.address,
-            sellAmount: ethers.formatUnits(sellAmountWei, decimals),
-            buyAmount: useNativeToken
-                ? ethers.formatEther(buyerNeed.maxBuyerValue)
-                : ethers.formatUnits(buyerNeed.maxBuyerValue, quoteTokenDecimals ?? 18),
-            hasApproval: !!approvalTx,
-            profitAmount: nativeProfitAmount > 0n ? ethers.formatEther(nativeProfitAmount) : undefined // ✅ 显示原生代币利润
-        }
-    };
-}
-// ==================== 工具函数 ====================
-// ✅ Provider 缓存（复用连接，减少初始化开销）
-const providerCache = new Map();
-const PROVIDER_CACHE_TTL_MS = 60 * 1000; // 60秒缓存
-function createChainContext(chain, config) {
-    const chainId = config.chainId ?? getChainId(chain);
-    const nativeToken = getNativeTokenName(chain);
-    const portalAddress = FLAP_PORTAL_ADDRESSES[chain.toUpperCase()];
-    // ✅ Provider 缓存
-    const cacheKey = `${chain}-${config.rpcUrl}`;
-    const now = Date.now();
-    const cached = providerCache.get(cacheKey);
-    let provider;
-    if (cached && cached.expireAt > now) {
-        provider = cached.provider;
-    }
-    else {
-        provider = new ethers.JsonRpcProvider(config.rpcUrl, {
-            chainId,
-            name: chain.toUpperCase()
-        });
-        providerCache.set(cacheKey, { provider, expireAt: now + PROVIDER_CACHE_TTL_MS });
-    }
-    return { chainId, nativeToken, portalAddress, provider };
-}
-async function buildApprovalTransaction({ tokenAddress, seller, provider, decimals, portalAddress, chainId, config }) {
-    const erc20 = new Contract(tokenAddress, ERC20_ALLOWANCE_ABI, provider);
-    const currentAllowance = await erc20.allowance(seller.address, portalAddress);
-    const threshold = ethers.parseUnits('1000000000', decimals);
-    if (currentAllowance >= threshold) {
-        return null;
-    }
-    const nonceManager = new NonceManager(provider);
-    const approvalNonce = await nonceManager.getNextNonce(seller);
-    const gasPrice = await getOptimizedGasPrice(provider, getGasPriceConfig(config));
-    const txType = getTxType(config);
-    return await seller.signTransaction({
-        to: tokenAddress,
-        data: APPROVE_INTERFACE.encodeFunctionData('approve', [portalAddress, ethers.MaxUint256]),
-        value: 0n,
-        nonce: approvalNonce,
-        gasLimit: 80000n,
-        gasPrice,
-        chainId,
-        type: txType
-    });
-}
-async function quoteSellOutput({ portalAddress, tokenAddress, sellAmountWei, provider, skipQuoteOnError, outputToken = ZERO_ADDRESS // ✅ 默认使用原生代币
- }) {
-    const portal = new Contract(portalAddress, PORTAL_ABI, provider);
-    try {
-        const quotedNative = await portal.quoteExactInput.staticCall({
-            inputToken: tokenAddress,
-            outputToken, // ✅ 使用动态输出代币
-            inputAmount: sellAmountWei
-        });
-        // ✅ 已移除滑点保护：minOutNative 固定为 0
-        return { quotedNative, minOutNative: 0n };
-    }
-    catch (err) {
-        if (skipQuoteOnError ?? true) {
-            return { quotedNative: 0n, minOutNative: 0n };
-        }
-        throw new Error(`卖出报价失败: ${err}`);
-    }
-}
-// ✅ ERC20_BALANCE_OF_ABI 已在文件开头定义
-async function calculateBuyerNeed({ buyer, quotedNative, reserveGasEth, nativeToken, useNativeToken = true, quoteToken, quoteTokenDecimals = 18, provider }) {
-    const reserveGas = ethers.parseEther((reserveGasEth || 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);
-    }
-    // ✅ 已移除滑点保护：直接使用报价金额
-    const estimatedBuyerNeed = quotedNative;
-    // ✅ 原生代币需要预留 Gas，ERC20 不需要
-    const buyerNeedTotal = useNativeToken
-        ? estimatedBuyerNeed + reserveGas
-        : estimatedBuyerNeed;
-    if (buyerBalance < buyerNeedTotal) {
-        if (useNativeToken) {
-            throw new Error(`买方余额不足:\n` +
-                `  - 需要: ${ethers.formatEther(buyerNeedTotal)} ${nativeToken}\n` +
-                `  - 实际: ${ethers.formatEther(buyerBalance)} ${nativeToken}`);
-        }
-        else {
-            throw new Error(`买方代币余额不足:\n` +
-                `  - 需要: ${ethers.formatUnits(buyerNeedTotal, quoteTokenDecimals)}\n` +
-                `  - 实际: ${ethers.formatUnits(buyerBalance, quoteTokenDecimals)}`);
-        }
-    }
-    const maxBuyerValue = estimatedBuyerNeed > 0n
-        ? estimatedBuyerNeed
-        : (useNativeToken ? buyerBalance - reserveGas : buyerBalance);
-    return { reserveGas, buyerBalance, buyerNeedTotal, maxBuyerValue };
-}
-async function validateBalances({ buyerNeed, buyerAddress, portalGasCost, provider, chainContext, seller, useNativeToken, quoteTokenDecimals = 18 }) {
-    const sellerBalance = await provider.getBalance(seller.address);
-    // ✅ 修复：买方余额已在 calculateBuyerNeed 中检查过
-    // 这里只需要检查：
-    // 1. 使用原生代币时：buyerNeed.buyerBalance 已包含购买金额 + Gas
-    // 2. 使用 ERC20 时：需要额外检查买方是否有足够 BNB 支付 Gas
-    if (!useNativeToken) {
-        // ERC20 购买时，买方仍需要 BNB 支付 Gas
-        const buyerBnbBalance = await provider.getBalance(buyerAddress);
-        const buyerGasCost = portalGasCost; // 买方交易的 Gas 费用
-        if (buyerBnbBalance < buyerGasCost) {
-            throw new Error(`买方 BNB 余额不足 (用于支付 Gas):\n` +
-                `  - 需要: ${ethers.formatEther(buyerGasCost)} ${chainContext.nativeToken}\n` +
-                `  - 实际: ${ethers.formatEther(buyerBnbBalance)} ${chainContext.nativeToken}`);
-        }
-    }
-    if (sellerBalance < portalGasCost) {
-        throw new Error(`卖方余额不足: 需要 ${ethers.formatEther(portalGasCost)} ${chainContext.nativeToken} (Gas)，实际 ${ethers.formatEther(sellerBalance)} ${chainContext.nativeToken}`);
-    }
-}
-/**
- * ✅ 从前端传入的 startNonces 构建 NoncePlan（用于性能优化）
- * 顺序：[sellerBaseNonce, buyerNonce]
- */
-function buildNoncePlan(startNonces, approvalExists, extractProfit, needBribeTx) {
-    let sellerNonce = startNonces[0];
-    const buyerNonce = startNonces[1];
-    let bribeNonce;
-    let profitNonce;
-    if (needBribeTx)
-        bribeNonce = sellerNonce++;
-    if (approvalExists)
-        sellerNonce++; // 授权交易占用一个 nonce
-    const sellNonce = sellerNonce++;
-    if (extractProfit)
-        profitNonce = sellerNonce;
-    return { sellerNonce: sellNonce, buyerNonce, bribeNonce, profitNonce };
-}
-/**
- * ✅ 优化：使用批量 nonce 获取（JSON-RPC 批量请求）
- * 交易顺序：贿赂 → 授权 → 卖出 → 买入 → 利润
- */
-async function planNonces({ seller, buyer, approvalExists, extractProfit, needBribeTx, nonceManager }) {
-    if (needBribeTx || approvalExists || extractProfit) {
-        // 卖方需要多个 nonce：贿赂(可选) + 授权(可选) + 卖出 + 利润(可选)
-        const sellerTxCount = countTruthy([needBribeTx, approvalExists, true, extractProfit]);
-        // ✅ 优化：并行获取 seller 和 buyer 的 nonce
-        const [sellerNonces, buyerNonces] = await Promise.all([
-            nonceManager.getNextNonceBatch(seller, sellerTxCount),
-            nonceManager.getNextNoncesForWallets([buyer])
-        ]);
-        let idx = 0;
-        const bribeNonce = needBribeTx ? sellerNonces[idx++] : undefined;
-        if (approvalExists)
-            idx++;
-        const sellerNonce = sellerNonces[idx++];
-        const profitNonce = extractProfit ? sellerNonces[idx] : undefined;
-        const buyerNonce = buyerNonces[0];
-        return { sellerNonce, buyerNonce, bribeNonce, profitNonce };
-    }
-    // ✅ 优化：使用 getNextNoncesForWallets 批量获取（单次网络往返）
-    const nonces = await nonceManager.getNextNoncesForWallets([seller, buyer]);
-    return { sellerNonce: nonces[0], buyerNonce: nonces[1] };
-}
-function buildTransactionRequest(unsigned, { from, nonce, gasLimit, gasPrice, priorityFee, chainId, txType, value }) {
-    const tx = {
-        ...unsigned,
-        from,
-        nonce,
-        gasLimit,
-        chainId,
-        type: txType
-    };
-    if (value !== undefined) {
-        tx.value = value;
-    }
-    if (txType === 2) {
-        tx.maxFeePerGas = gasPrice;
-        tx.maxPriorityFeePerGas = priorityFee;
-    }
-    else {
-        tx.gasPrice = gasPrice;
-    }
-    return tx;
-}
-hopWallets: GeneratedWallet[];
-/**
- * 构建利润多跳转账交易（强制 2 跳中转）
- */
-async function buildProfitTransaction({ provider, seller, profitAmount, profitNonce, gasPrice, chainId, txType }) {
-    if (!profitNonce || profitAmount === 0n) {
-        return null;
-    }
-    const profitHopResult = await buildProfitHopTransactions({
-        provider,
-        payerWallet: seller,
-        profitAmount,
-        profitRecipient: getProfitRecipient(),
-        hopCount: PROFIT_HOP_COUNT,
-        gasPrice,
-        chainId,
-        txType,
-        startNonce: profitNonce
-    });
-    return {
-        signedTransactions: profitHopResult.signedTransactions,
-        hopWallets: profitHopResult.hopWallets
-    };
-}
-/**
- * 根据 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(quotedNative, userType) {
-    if (quotedNative <= 0n) {
-        return 0n;
-    }
-    const rateBps = getProfitRateBps(userType);
-    return (quotedNative * BigInt(rateBps)) / 10000n;
-}
-function countTruthy(values) {
-    return values.filter(Boolean).length;
-}
-// ==================== 批量换手（一卖多买）====================
-sellerPrivateKey: string; // 卖方私钥（主钱包）
-sellAmount ?  : string; // 卖出数量
-sellPercentage ?  : number; // 卖出比例（0-100）
-buyerPrivateKeys: string[]; // 买方私钥数组（子钱包）
-buyerRatios ?  : number[]; // 每个买方的分配比例（如 [0.3, 0.5, 0.2]）
-tokenAddress: string; // 代币地址
-config: FlapSwapSignConfig; // 配置
-quoteToken ?  : string; // 报价代币（USDT 等）
-quoteTokenDecimals ?  : number; // 报价代币精度
-// ✅ 可选：前端预获取的 nonces（性能优化）
-// 顺序：[sellerNonce, buyer1Nonce, buyer2Nonce, ...]
-startNonces ?  : number[];
-profitHopWallets ?  : GeneratedWallet[]; // ✅ 利润多跳中间钱包
-metadata ?  : {
-    sellerAddress: string,
-    buyerAddresses: string[],
-    sellAmount: string,
-    buyAmounts: string[],
-    hasApproval: boolean,
-    profitAmount: string
-};
-/**
- * Flap 内盘批量换手（一卖多买）
- *
- * 功能：主钱包一次卖出 → 多个子钱包同时买入 → 在同一个区块中完成
- * 限制：最多 24 个买方（服务器限制 25 笔交易，包含 1 笔利润交易）
- */
-export async function flapBatchSwapMerkle(params) {
-    const { chain, sellerPrivateKey, sellAmount, sellPercentage, buyerPrivateKeys, tokenAddress, config, quoteToken, quoteTokenDecimals = 18, startNonces // ✅ 可选：前端预获取的 nonces
-     } = params;
-    // ✅ 校验买方数量（最多 24 个）
-    const MAX_BUYERS = 24;
-    if (buyerPrivateKeys.length === 0) {
-        throw new Error('至少需要一个买方钱包');
-    }
-    if (buyerPrivateKeys.length > MAX_BUYERS) {
-        throw new Error(`买方钱包数量超过限制: ${buyerPrivateKeys.length} > ${MAX_BUYERS}`);
-    }
-    const chainContext = createChainContext(chain, config);
-    const seller = new Wallet(sellerPrivateKey, chainContext.provider);
-    const buyers = buyerPrivateKeys.map(pk => new Wallet(pk, chainContext.provider));
-    const nonceManager = new NonceManager(chainContext.provider);
-    const finalGasLimit = getGasLimit(config);
-    const txType = getTxType(config);
-    // ✅ 判断是否使用原生代币
-    const useNativeToken = !quoteToken || quoteToken === ZERO_ADDRESS;
-    const outputToken = useNativeToken ? ZERO_ADDRESS : quoteToken;
-    // ✅ 并行获取：卖出数量、gasPrice
-    const [sellAmountResult, gasPrice] = await Promise.all([
-        calculateSellAmount(chainContext.provider, tokenAddress, seller.address, sellAmount, sellPercentage),
-        getOptimizedGasPrice(chainContext.provider, getGasPriceConfig(config))
-    ]);
-    const { amount: sellAmountWei, decimals } = sellAmountResult;
-    const priorityFee = gasPrice / 10n === 0n ? 1n : gasPrice / 10n;
-    // ✅ 并行获取：授权、报价（已移除滑点保护）
-    const [approvalTx, quote] = await Promise.all([
-        config.skipApprovalCheck
-            ? Promise.resolve(null)
-            : buildApprovalTransaction({
-                tokenAddress,
-                seller,
-                provider: chainContext.provider,
-                decimals,
-                portalAddress: chainContext.portalAddress,
-                chainId: chainContext.chainId,
-                config
-            }),
-        quoteSellOutput({
-            portalAddress: chainContext.portalAddress,
-            tokenAddress,
-            sellAmountWei,
-            provider: chainContext.provider,
-            skipQuoteOnError: config.skipQuoteOnError,
-            outputToken
-        })
-    ]);
-    // ✅ 计算每个买方的买入金额（按比例分配，已移除滑点保护）
-    const totalBuyAmount = quote.quotedNative;
-    let buyAmountsWei;
-    if (params.buyerRatios && params.buyerRatios.length === buyers.length) {
-        // 按比例分配
-        buyAmountsWei = params.buyerRatios.map((ratio, index) => {
-            const amount = (totalBuyAmount * BigInt(Math.round(ratio * 10000))) / 10000n;
-            return amount;
-        });
-    }
-    else {
-        // 平均分配
-        const amountPerBuyer = totalBuyAmount / BigInt(buyers.length);
-        buyAmountsWei = buyers.map(() => amountPerBuyer);
-    }
-    // ✅ 并行验证所有买方余额
-    const reserveGas = ethers.parseEther((config.reserveGasETH || 0.0005).toString());
-    const erc20Contract = useNativeToken ? null : new Contract(quoteToken, ERC20_BALANCE_OF_ABI, chainContext.provider);
-    await Promise.all(buyers.map(async (buyer, i) => {
-        const buyAmount = buyAmountsWei[i];
-        if (useNativeToken) {
-            const buyerBalance = await buyer.provider.getBalance(buyer.address);
-            const required = buyAmount + reserveGas;
-            if (buyerBalance < required) {
-                throw new Error(`买方 ${i + 1} 余额不足: 需要 ${ethers.formatEther(required)} ${chainContext.nativeToken}, 实际 ${ethers.formatEther(buyerBalance)}`);
-            }
-        }
-        else {
-            const buyerBalance = await erc20Contract.balanceOf(buyer.address);
-            if (buyerBalance < buyAmount) {
-                throw new Error(`买方 ${i + 1} 代币余额不足: 需要 ${ethers.formatUnits(buyAmount, quoteTokenDecimals)}, 实际 ${ethers.formatUnits(buyerBalance, quoteTokenDecimals)}`);
-            }
-        }
-    }));
-    // ✅ 计算利润（根据 userType 动态调整）
-    const tokenProfitAmount = calculateProfitAmount(quote.quotedNative, config.userType);
-    let nativeProfitAmount = tokenProfitAmount;
-    if (!useNativeToken && tokenProfitAmount > 0n) {
-        nativeProfitAmount = await getTokenToNativeQuote(chainContext.provider, quoteToken, tokenProfitAmount, chainContext.chainId);
-    }
-    // ✅ 并行构建所有买入交易
-    const portalSeller = new Contract(chainContext.portalAddress, PORTAL_ABI, seller);
-    const [sellUnsigned, ...buyUnsignedList] = await Promise.all([
-        // 卖出交易
-        portalSeller.swapExactInput.populateTransaction({
-            inputToken: tokenAddress,
-            outputToken,
-            inputAmount: sellAmountWei,
-            minOutputAmount: 0,
-            permitData: '0x'
-        }),
-        // 所有买入交易
-        ...buyers.map((buyer, i) => {
-            const portalBuyer = new Contract(chainContext.portalAddress, PORTAL_ABI, buyer);
-            const buyAmount = buyAmountsWei[i];
-            return portalBuyer.swapExactInput.populateTransaction({
-                inputToken: outputToken,
-                outputToken: tokenAddress,
-                inputAmount: buyAmount,
-                minOutputAmount: 0,
-                permitData: '0x'
-            }, useNativeToken ? { value: buyAmount } : {});
-        })
-    ]);
-    // ✅ 并行获取所有 nonce（如果前端传入了 startNonces，直接使用）
-    const allWallets = [seller, ...buyers];
-    let sellNonce;
-    let buyerNonces;
-    if (startNonces && startNonces.length >= allWallets.length) {
-        sellNonce = startNonces[0];
-        buyerNonces = startNonces.slice(1);
-    }
-    else {
-        sellNonce = await nonceManager.getNextNonce(seller);
-        buyerNonces = await Promise.all(buyers.map(buyer => nonceManager.getNextNonce(buyer)));
-    }
-    // ✅ 贿赂交易和利润交易都由卖方发送（保持一致）
-    const bribeAmount = getBribeAmount(config);
-    let bribeTx = null;
-    let bribeNonceOffset = 0;
-    if (bribeAmount > 0n) {
-        const bribeNonce = sellNonce; // 使用卖方的第一个 nonce
-        bribeTx = await seller.signTransaction({
-            to: BLOCKRAZOR_BUILDER_EOA,
-            value: bribeAmount,
-            nonce: bribeNonce,
-            gasPrice,
-            gasLimit: BRIBE_GAS_LIMIT,
-            chainId: chainContext.chainId,
-            type: txType
-        });
-        bribeNonceOffset = 1; // 卖出交易的 nonce 需要 +1
-    }
-    nonceManager.clearTemp();
-    // 利润多跳交易 nonce 计算
-    const profitNonce = nativeProfitAmount > 0n ? sellNonce + bribeNonceOffset + 1 : undefined;
-    // ✅ 并行签名所有交易
-    const sellTx = buildTransactionRequest(sellUnsigned, {
-        from: seller.address,
-        nonce: sellNonce + bribeNonceOffset, // ✅ 考虑贿赂交易的 nonce 偏移
-        gasLimit: finalGasLimit,
-        gasPrice,
-        priorityFee,
-        chainId: chainContext.chainId,
-        txType,
-        value: 0n
-    });
-    const [signedSell, ...signedBuys] = await Promise.all([
-        seller.signTransaction(sellTx),
-        ...buyers.map((buyer, i) => {
-            const buyTx = buildTransactionRequest(buyUnsignedList[i], {
-                from: buyer.address,
-                nonce: buyerNonces[i],
-                gasLimit: finalGasLimit,
-                gasPrice,
-                priorityFee,
-                chainId: chainContext.chainId,
-                txType,
-                value: useNativeToken ? buyAmountsWei[i] : 0n
-            });
-            return buyer.signTransaction(buyTx);
-        })
-    ]);
-    // ✅ 按顺序组装交易数组：贿赂 → 授权 → 卖出 → 买入
-    const signedTransactions = [];
-    if (bribeTx)
-        signedTransactions.push(bribeTx);
-    if (approvalTx)
-        signedTransactions.push(approvalTx);
-    signedTransactions.push(signedSell);
-    signedTransactions.push(...signedBuys);
-    // ✅ 利润多跳转账（强制 2 跳中转）
-    let profitHopWallets;
-    if (profitNonce !== undefined && nativeProfitAmount > 0n) {
-        const profitResult = await buildProfitTransaction({
-            provider: chainContext.provider,
-            seller,
-            profitAmount: nativeProfitAmount,
-            profitNonce,
-            gasPrice,
-            chainId: chainContext.chainId,
-            txType
-        });
-        if (profitResult) {
-            signedTransactions.push(...profitResult.signedTransactions);
-            profitHopWallets = profitResult.hopWallets; // ✅ 收集利润多跳钱包
-        }
-    }
-    return {
-        signedTransactions,
-        profitHopWallets, // ✅ 导出利润多跳钱包
-        metadata: {
-            sellerAddress: seller.address,
-            buyerAddresses: buyers.map(b => b.address),
-            sellAmount: ethers.formatUnits(sellAmountWei, decimals),
-            buyAmounts: buyAmountsWei.map(amt => useNativeToken
-                ? ethers.formatEther(amt)
-                : ethers.formatUnits(amt, quoteTokenDecimals)),
-            hasApproval: !!approvalTx,
-            profitAmount: nativeProfitAmount > 0n ? ethers.formatEther(nativeProfitAmount) : undefined
-        }
-    };
-}
-// ==================== 快捷批量换手（资金利用率模式）====================
-sellerPrivateKey: string; // 卖方私钥（主钱包）
-sellAmount ?  : string; // 卖出数量
-sellPercentage ?  : number; // 卖出比例（0-100）
-buyerPrivateKeys: string[]; // 买方私钥数组（子钱包）
-buyerRatios ?  : number[]; // 每个买方的分配比例（如 [0.3, 0.5, 0.2]）
-buyerAmounts ?  : string[]; // 每个买方的固定金额（原生代币/ERC20）
-tokenAddress: string; // 代币地址
-config: FlapSwapSignConfig; // 配置
-quoteToken ?  : string; // 报价代币（USDT 等），不传则使用原生代币
-quoteTokenDecimals ?  : number; // 报价代币精度
-// ✅ 转账多跳配置（可选）
-disperseHopCount ?  : number; // 转账多跳数（0=直接转账，1=1跳，2=2跳...）
-// ✅ 可选：前端预获取的 nonces（性能优化）
-// 顺序：[sellerNonce, buyer1Nonce, buyer2Nonce, ...]
-startNonces ?  : number[];
-disperseHopWallets ?  : GeneratedWallet[]; // ✅ 转账多跳中间钱包
-profitHopWallets ?  : GeneratedWallet[]; // ✅ 利润多跳中间钱包
-metadata ?  : {
-    sellerAddress: string,
-    buyerAddresses: string[],
-    sellAmount: string,
-    estimatedOutput: string,
-    transferAmounts: string[],
-    profitAmount: string,
-    useNativeToken: boolean,
-    disperseHopCount: number
-};
-// ==================== 交叉换手（多卖多买，循环执行）====================
-/** 卖方私钥列表（按顺序轮流卖出） */
-sellerPrivateKeys: string[];
-/** 每个卖方的卖出数量（与 sellerPrivateKeys 长度一致） */
-sellAmounts: string[];
-/** 买方私钥列表（按顺序轮流分配，每笔平分） */
-buyerPrivateKeys: string[];
-tokenAddress: string;
-config: FlapSwapSignConfig;
-quoteToken ?  : string;
-quoteTokenDecimals ?  : number;
-/** 每次卖出分配给多少个买方（默认使用全部买方平分） */
-buyersPerSell ?  : number;
-/** 转账多跳数（可选） */
-disperseHopCount ?  : number;
-/** 每轮的元数据列表 */
-rounds: Array;
-/** 汇总的中间钱包信息（转账/利润） */
-disperseHopWallets ?  : GeneratedWallet[];
-profitHopWallets ?  : GeneratedWallet[];
-/**
- * Flap 内盘快捷批量换手（资金利用率模式）
- *
- * 流程：[贿赂] → [卖出] → [转账多跳...] → [买入1, 买入2, ...] → [利润]
- *
- * 特点：
- * - 子钱包不需要预先有余额
- * - 资金来自主钱包卖出代币所得
- * - 提升资金利用率
- * - 支持原生代币（BNB/OKB/ETH）和 ERC20（如 USDT）两种模式
- * - ✅ 支持转账多跳，隐藏资金流向
- *
- * 限制：根据多跳数动态计算最大买方数量
- */
-export async function flapQuickBatchSwapMerkle(params) {
-    const { chain, sellerPrivateKey, sellAmount, sellPercentage, buyerPrivateKeys, buyerRatios, buyerAmounts, tokenAddress, config, quoteToken, quoteTokenDecimals = 18, disperseHopCount = 0, // ✅ 转账多跳数（默认0=直接转账）
-    startNonces // ✅ 可选：前端预获取的 nonces
-     } = params;
-    // ✅ 判断是否使用原生代币
-    const useNativeToken = !quoteToken || quoteToken === ZERO_ADDRESS;
-    // ✅ 动态计算最大买方数量（根据多跳数）
-    // 固定开销: 贿赂(1) + 卖出(1) + 利润多跳(PROFIT_HOP_COUNT + 1)
-    const fixedOverhead = 1 + 1 + PROFIT_HOP_COUNT + 1;
-    const maxTxs = 50 - fixedOverhead;
-    let MAX_BUYERS;
-    if (useNativeToken) {
-        // 原生代币模式: N*(H+2) <= maxTxs
-        MAX_BUYERS = Math.floor(maxTxs / (disperseHopCount + 2));
-    }
-    else {
-        // ERC20 模式: N*(2H+3) <= maxTxs
-        MAX_BUYERS = Math.floor(maxTxs / (2 * disperseHopCount + 3));
-    }
-    MAX_BUYERS = Math.max(1, MAX_BUYERS);
-    console.log(`[flapQuickBatchSwapMerkle] 多跳数: ${disperseHopCount}, 最大买方数: ${MAX_BUYERS}`);
-    if (buyerPrivateKeys.length === 0) {
-        throw new Error('至少需要一个买方钱包');
-    }
-    if (buyerPrivateKeys.length > MAX_BUYERS) {
-        const mode = useNativeToken ? '原生代币' : 'ERC20';
-        throw new Error(`资金利用率模式(${mode}, ${disperseHopCount}跳)买方钱包数量超过限制: ${buyerPrivateKeys.length} > ${MAX_BUYERS}`);
-    }
-    // ✅ 校验分配模式
-    if (!buyerRatios && !buyerAmounts) {
-        throw new Error('必须提供 buyerRatios 或 buyerAmounts');
-    }
-    if (buyerRatios && buyerRatios.length !== buyerPrivateKeys.length) {
-        throw new Error(`buyerRatios 长度 (${buyerRatios.length}) 与 buyerPrivateKeys 长度 (${buyerPrivateKeys.length}) 不匹配`);
-    }
-    if (buyerAmounts && buyerAmounts.length !== buyerPrivateKeys.length) {
-        throw new Error(`buyerAmounts 长度 (${buyerAmounts.length}) 与 buyerPrivateKeys 长度 (${buyerPrivateKeys.length}) 不匹配`);
-    }
-    const outputToken = useNativeToken ? ZERO_ADDRESS : quoteToken;
-    const ERC20_TRANSFER_GAS = GAS_LIMITS.ERC20_TRANSFER;
-    const chainContext = createChainContext(chain, config);
-    const seller = new Wallet(sellerPrivateKey, chainContext.provider);
-    const buyers = buyerPrivateKeys.map(pk => new Wallet(pk, chainContext.provider));
-    const nonceManager = new NonceManager(chainContext.provider);
-    const finalGasLimit = getGasLimit(config);
-    const txType = getTxType(config);
-    // ✅ 并行获取：卖出数量、gasPrice
-    const [sellAmountResult, gasPrice] = await Promise.all([
-        calculateSellAmount(chainContext.provider, tokenAddress, seller.address, sellAmount, sellPercentage),
-        getOptimizedGasPrice(chainContext.provider, getGasPriceConfig(config))
-    ]);
-    const { amount: sellAmountWei, decimals } = sellAmountResult;
-    const priorityFee = gasPrice / 10n === 0n ? 1n : gasPrice / 10n;
-    // ✅ 获取卖出报价
-    const quote = await quoteSellOutput({
-        portalAddress: chainContext.portalAddress,
-        tokenAddress,
-        sellAmountWei,
-        provider: chainContext.provider,
-        skipQuoteOnError: config.skipQuoteOnError,
-        outputToken
-    });
-    const estimatedOutput = quote.quotedNative;
-    const outputFormatted = useNativeToken
-        ? ethers.formatEther(estimatedOutput)
-        : ethers.formatUnits(estimatedOutput, quoteTokenDecimals);
-    console.log(`[flapQuickBatchSwapMerkle] 模式: ${useNativeToken ? '原生代币' : 'ERC20'}`);
-    console.log(`[flapQuickBatchSwapMerkle] 卖出数量: ${ethers.formatUnits(sellAmountWei, decimals)}`);
-    console.log(`[flapQuickBatchSwapMerkle] 预估卖出所得: ${outputFormatted}`);
-    // ✅ 计算利润（根据 userType 动态调整）
-    let tokenProfitAmount = calculateProfitAmount(estimatedOutput, config.userType);
-    let nativeProfitAmount = tokenProfitAmount;
-    if (!useNativeToken && tokenProfitAmount > 0n) {
-        // ERC20 模式：将代币利润转换为等值原生代币
-        nativeProfitAmount = await getTokenToNativeQuote(chainContext.provider, quoteToken, tokenProfitAmount, chainContext.chainId);
-        console.log(`[flapQuickBatchSwapMerkle] ERC20→原生代币 报价: ${ethers.formatUnits(tokenProfitAmount, quoteTokenDecimals)} → ${ethers.formatEther(nativeProfitAmount)}`);
-    }
-    const distributableAmount = useNativeToken
-        ? estimatedOutput - tokenProfitAmount
-        : estimatedOutput; // ERC20 模式利润从原生代币扣
-    // ✅ 计算每个买方分到的金额
-    let transferAmountsWei;
-    if (buyerAmounts && buyerAmounts.length === buyers.length) {
-        // 数量模式
-        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
-                ? ethers.formatEther(distributableAmount)
-                : ethers.formatUnits(distributableAmount, quoteTokenDecimals);
-            throw new Error(`指定的买入总金额超过可分配金额 (${formatted})`);
-        }
-    }
-    else if (buyerRatios && buyerRatios.length === buyers.length) {
-        // 比例模式
-        transferAmountsWei = buyerRatios.map(ratio => {
-            return (distributableAmount * BigInt(Math.round(ratio * 10000))) / 10000n;
-        });
-    }
-    else {
-        throw new Error('必须提供 buyerRatios 或 buyerAmounts');
-    }
-    // ✅ 获取贿赂金额
-    const bribeAmount = getBribeAmount(config);
-    // ✅ 验证主钱包余额
-    const sellerBalance = await seller.provider.getBalance(seller.address);
-    let sellerGasCost;
-    let sellerRequired;
-    if (useNativeToken) {
-        // 原生代币模式：贿赂 + Gas（卖出 + 转账 + 利润）
-        sellerGasCost = gasPrice * (BRIBE_GAS_LIMIT + finalGasLimit + BRIBE_GAS_LIMIT * BigInt(buyers.length) + BRIBE_GAS_LIMIT);
-        sellerRequired = bribeAmount + sellerGasCost;
-    }
-    else {
-        // ERC20 模式：贿赂 + Gas（卖出 + ERC20转账 + 利润）
-        sellerGasCost = gasPrice * (BRIBE_GAS_LIMIT + finalGasLimit + ERC20_TRANSFER_GAS * BigInt(buyers.length) + BRIBE_GAS_LIMIT);
-        sellerRequired = bribeAmount + sellerGasCost;
-    }
-    if (sellerBalance < sellerRequired) {
-        throw new Error(`主钱包 ${chainContext.nativeToken} 余额不足: 需要约 ${ethers.formatEther(sellerRequired)} (贿赂: ${ethers.formatEther(bribeAmount)}, Gas: ${ethers.formatEther(sellerGasCost)}), 实际 ${ethers.formatEther(sellerBalance)}`);
-    }
-    // ==================== 规划 Nonce ====================
-    // ✅ 如果前端传入了 startNonces，直接使用（性能优化）
-    let sellerNonce = startNonces && startNonces.length > 0
-        ? startNonces[0]
-        : await nonceManager.getNextNonce(seller);
-    // ==================== 1. 贿赂交易 ====================
-    let bribeTx = null;
-    if (bribeAmount > 0n) {
-        bribeTx = await seller.signTransaction({
-            to: BLOCKRAZOR_BUILDER_EOA,
-            value: bribeAmount,
-            nonce: sellerNonce++,
-            gasPrice,
-            gasLimit: BRIBE_GAS_LIMIT,
-            chainId: chainContext.chainId,
-            type: txType
-        });
-        console.log(`[flapQuickBatchSwapMerkle] 贿赂交易已签名`);
-    }
-    // ==================== 2. 卖出交易 ====================
-    const portalSeller = new Contract(chainContext.portalAddress, PORTAL_ABI, seller);
-    const sellUnsigned = await portalSeller.swapExactInput.populateTransaction({
-        inputToken: tokenAddress,
-        outputToken,
-        inputAmount: sellAmountWei,
-        minOutputAmount: 0,
-        permitData: '0x'
-    });
-    const sellTx = buildTransactionRequest(sellUnsigned, {
-        from: seller.address,
-        nonce: sellerNonce++,
-        gasLimit: finalGasLimit,
-        gasPrice,
-        priorityFee,
-        chainId: chainContext.chainId,
-        txType,
-        value: 0n
-    });
-    const signedSell = await seller.signTransaction(sellTx);
-    console.log(`[flapQuickBatchSwapMerkle] 卖出交易已签名`);
-    // ==================== 3. 转账交易（支持多跳）====================
-    const reserveGas = ethers.parseEther((config.reserveGasETH || 0.0005).toString());
-    const buyerGasCost = gasPrice * finalGasLimit;
-    // ✅ 生成多跳路径
-    const hopPaths = generateDisperseHopPaths(buyers.map(b => b.address), disperseHopCount, chainContext.provider);
-    // 收集所有中间钱包信息
-    const allHopWallets = [];
-    hopPaths.forEach(path => {
-        allHopWallets.push(...path.hopWalletsInfo);
-    });
-    let transferTxs = [];
-    if (disperseHopCount === 0) {
-        // ✅ 无多跳：直接转账
-        const transferNonces = buyers.map((_, i) => sellerNonce + i);
-        sellerNonce += buyers.length;
-        if (useNativeToken) {
-            transferTxs = await Promise.all(buyers.map((buyer, i) => {
-                const transferValue = transferAmountsWei[i] + reserveGas + buyerGasCost;
-                return seller.signTransaction({
-                    to: buyer.address,
-                    value: transferValue,
-                    nonce: transferNonces[i],
-                    gasPrice,
-                    gasLimit: NATIVE_TRANSFER_GAS_LIMIT,
-                    chainId: chainContext.chainId,
-                    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]
-                ]);
-                return seller.signTransaction({
-                    to: quoteToken,
-                    data: transferData,
-                    value: 0n,
-                    nonce: transferNonces[i],
-                    gasPrice,
-                    gasLimit: ERC20_TRANSFER_GAS,
-                    chainId: chainContext.chainId,
-                    type: txType
-                });
-            }));
-        }
-    }
-    else {
-        // ✅ 有多跳：构建多跳转账链
-        if (useNativeToken) {
-            // 原生代币多跳转账
-            // ✅ 修复：payer 每次只发送 1 笔交易（到第一个hop钱包），hop钱包用自己的nonce=0
-            const hopChains = await Promise.all(hopPaths.map((path, i) => {
-                const finalAmount = transferAmountsWei[i] + reserveGas + buyerGasCost;
-                const payerNonce = sellerNonce + i; // ✅ payer 每个 buyer 只用 1 个 nonce
-                return buildNativeHopChain(seller, path, finalAmount, gasPrice, chainContext.chainId, txType, payerNonce);
-            }));
-            transferTxs = hopChains.flat();
-            sellerNonce += buyers.length; // ✅ payer 只增加 buyers.length 个 nonce
-        }
-        else {
-            // ERC20 多跳转账：先转 BNB（给中间钱包 gas），再转 ERC20
-            // ✅ 修复：payer 每次只发送 1 笔交易（到第一个hop钱包），hop钱包用自己的nonce=0/1
-            // 1. 构建 BNB 多跳链
-            const bnbHopChains = await Promise.all(hopPaths.map((path, i) => {
-                const finalGasAmount = buyerGasCost;
-                const payerNonce = sellerNonce + i; // ✅ payer 每个 buyer 只用 1 个 nonce
-                return buildBNBHopChainForERC20(seller, path, finalGasAmount, gasPrice, chainContext.chainId, txType, payerNonce);
-            }));
-            const bnbTxs = bnbHopChains.flat();
-            sellerNonce += buyers.length; // ✅ payer 只增加 buyers.length 个 nonce
-            // 2. 构建 ERC20 多跳链
-            const erc20HopChains = await Promise.all(hopPaths.map((path, i) => {
-                const payerNonce = sellerNonce + i; // ✅ payer 每个 buyer 只用 1 个 nonce
-                return buildERC20HopChain(seller, path, quoteToken, transferAmountsWei[i], gasPrice, chainContext.chainId, txType, payerNonce);
-            }));
-            const erc20Txs = erc20HopChains.flat();
-            sellerNonce += buyers.length; // ✅ payer 只增加 buyers.length 个 nonce
-            transferTxs = [...bnbTxs, ...erc20Txs];
-        }
-    }
-    console.log(`[flapQuickBatchSwapMerkle] ${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)));
-    const signedBuys = await Promise.all(buyers.map(async (buyer, i) => {
-        const buyAmount = transferAmountsWei[i];
-        const portalBuyer = new Contract(chainContext.portalAddress, PORTAL_ABI, buyer);
-        const buyUnsigned = await portalBuyer.swapExactInput.populateTransaction({
-            inputToken: outputToken,
-            outputToken: tokenAddress,
-            inputAmount: buyAmount,
-            minOutputAmount: 0,
-            permitData: '0x'
-        }, useNativeToken ? { value: buyAmount } : {});
-        const buyTx = buildTransactionRequest(buyUnsigned, {
-            from: buyer.address,
-            nonce: buyerNonces[i],
-            gasLimit: finalGasLimit,
-            gasPrice,
-            priorityFee,
-            chainId: chainContext.chainId,
-            txType,
-            value: useNativeToken ? buyAmount : 0n
-        });
-        return buyer.signTransaction(buyTx);
-    }));
-    console.log(`[flapQuickBatchSwapMerkle] ${signedBuys.length} 笔买入交易已签名`);
-    nonceManager.clearTemp();
-    // ==================== 组装交易数组 ====================
-    const signedTransactions = [];
-    if (bribeTx)
-        signedTransactions.push(bribeTx);
-    signedTransactions.push(signedSell);
-    signedTransactions.push(...transferTxs);
-    signedTransactions.push(...signedBuys);
-    // ==================== 5. 利润多跳转账（强制 2 跳中转）====================
-    let profitHopWallets;
-    if (nativeProfitAmount > 0n) {
-        const profitResult = await buildProfitTransaction({
-            provider: chainContext.provider,
-            seller,
-            profitAmount: nativeProfitAmount,
-            profitNonce: sellerNonce++,
-            gasPrice,
-            chainId: chainContext.chainId,
-            txType
-        });
-        if (profitResult) {
-            signedTransactions.push(...profitResult.signedTransactions);
-            profitHopWallets = profitResult.hopWallets; // ✅ 收集利润多跳钱包
-        }
-        // 多跳交易已签名
-    }
-    console.log(`[flapQuickBatchSwapMerkle] 交易组装完成: ${signedTransactions.length} 笔`);
-    console.log(`  - 贿赂: ${bribeTx ? 1 : 0}`);
-    console.log(`  - 卖出: 1`);
-    console.log(`  - 转账: ${transferTxs.length}`);
-    console.log(`  - 买入: ${signedBuys.length}`);
-    return {
-        signedTransactions,
-        disperseHopWallets: allHopWallets.length > 0 ? allHopWallets : undefined, // ✅ 返回转账多跳钱包
-        profitHopWallets, // ✅ 返回利润多跳钱包
-        metadata: {
-            sellerAddress: seller.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)),
-            profitAmount: nativeProfitAmount > 0n ? ethers.formatEther(nativeProfitAmount) : undefined,
-            useNativeToken,
-            disperseHopCount: disperseHopCount > 0 ? disperseHopCount : undefined // ✅ 返回多跳数
-        }
-    };
-}
-/**
- * Flap 交叉换手（多卖多买，循环执行）
- * - 每个卖方单独卖出，买入金额由卖出所得等分分配给当轮买方
- * - 利润刮取、转账多跳逻辑继承 flapQuickBatchSwapMerkle
- * - 结果按顺序拼接 signedTransactions（可交由前端/后端顺序广播）
- * - ✅ 正确处理 nonce：同一钱包在多轮中使用时 nonce 自动递增
- */
-export async function flapCrossSwapMerkle(params) {
-    const { chain, sellerPrivateKeys, sellAmounts, buyerPrivateKeys, tokenAddress, config, quoteToken, quoteTokenDecimals = 18, buyersPerSell, disperseHopCount = 0 } = params;
-    if (sellerPrivateKeys.length === 0) {
-        throw new Error('至少需要一个卖方');
-    }
-    if (sellerPrivateKeys.length !== sellAmounts.length) {
-        throw new Error(`sellAmounts 长度 (${sellAmounts.length}) 必须与卖方数量 (${sellerPrivateKeys.length}) 一致`);
-    }
-    if (buyerPrivateKeys.length === 0) {
-        throw new Error('至少需要一个买方');
-    }
-    // ✅ 创建 Provider 和 NonceManager
-    const chainContext = createChainContext(chain, config);
-    const nonceManager = new NonceManager(chainContext.provider);
-    // ✅ 预先获取所有钱包的初始 nonce
-    const allSellerWallets = sellerPrivateKeys.map(pk => new Wallet(pk, chainContext.provider));
-    const allBuyerWallets = buyerPrivateKeys.map(pk => new Wallet(pk, chainContext.provider));
-    // 使用 Map 去重（同一私钥可能出现多次）
-    const addressToNonce = new Map();
-    // 获取所有卖方 nonce
-    for (const wallet of allSellerWallets) {
-        if (!addressToNonce.has(wallet.address)) {
-            const nonce = await nonceManager.getNextNonce(wallet);
-            addressToNonce.set(wallet.address, nonce);
-        }
-    }
-    // 获取所有买方 nonce
-    for (const wallet of allBuyerWallets) {
-        if (!addressToNonce.has(wallet.address)) {
-            const nonce = await nonceManager.getNextNonce(wallet);
-            addressToNonce.set(wallet.address, nonce);
-        }
-    }
-    console.log(`[flapCrossSwapMerkle] 初始化完成: ${sellerPrivateKeys.length} 卖方, ${buyerPrivateKeys.length} 买方`);
-    const allSigned = [];
-    const allDisperse = [];
-    const allProfit = [];
-    const rounds = [];
-    // 轮流分配买方：每轮取 buyersPerSell 个（默认所有买方），不足则从头继续
-    let buyerCursor = 0;
-    const buyerBatchSize = Math.max(1, buyersPerSell ?? buyerPrivateKeys.length);
-    for (let i = 0; i < sellerPrivateKeys.length; i++) {
-        const sellerPk = sellerPrivateKeys[i];
-        const sellAmount = sellAmounts[i];
-        const sellerWallet = allSellerWallets[i];
-        // 选取本轮买方私钥和钱包
-        const roundBuyerPks = [];
-        const roundBuyerWallets = [];
-        for (let k = 0; k < buyerBatchSize; k++) {
-            const idx = buyerCursor % buyerPrivateKeys.length;
-            roundBuyerPks.push(buyerPrivateKeys[idx]);
-            roundBuyerWallets.push(allBuyerWallets[idx]);
-            buyerCursor++;
-        }
-        // ✅ 获取卖方当前 nonce
-        const sellerNonce = addressToNonce.get(sellerWallet.address);
-        // ✅ 获取并更新买方 nonces（每个买方本轮需要 1 个 nonce）
-        const roundBuyerNonces = roundBuyerWallets.map(w => {
-            const nonce = addressToNonce.get(w.address);
-            addressToNonce.set(w.address, nonce + 1); // 每个买方用 1 个 nonce
-            return nonce;
-        });
-        // 平分买入金额（使用比例模式，避免固定金额超出可分配金额）
-        const ratio = 1 / roundBuyerPks.length;
-        const buyerRatios = roundBuyerPks.map(() => ratio);
-        // ✅ 构建 startNonces: [sellerNonce, buyer1Nonce, buyer2Nonce, ...]
-        const startNonces = [sellerNonce, ...roundBuyerNonces];
-        // ✅ 预先计算卖方 nonce 消耗（精确计算）
-        // 卖方 nonce 消耗 = 贿赂(0/1) + 卖出(1) + 转账(N 或 N*2) + 利润(1)
-        const useNativeToken = !quoteToken || quoteToken === ZERO_ADDRESS;
-        const hasBribe = getBribeAmount(config) > 0n;
-        const hasProfit = true; // 默认有利润刮取
-        let sellerNonceConsumed = 0;
-        if (hasBribe)
-            sellerNonceConsumed += 1; // 贿赂
-        sellerNonceConsumed += 1; // 卖出
-        if (disperseHopCount === 0) {
-            sellerNonceConsumed += roundBuyerPks.length; // 直接转账
-        }
-        else if (useNativeToken) {
-            sellerNonceConsumed += roundBuyerPks.length; // 原生多跳：seller→hop1
-        }
-        else {
-            sellerNonceConsumed += roundBuyerPks.length * 2; // ERC20 多跳：BNB + ERC20 两批
-        }
-        if (hasProfit)
-            sellerNonceConsumed += 1; // 利润
-        // 调用单卖多买的签名函数
-        const res = await flapQuickBatchSwapMerkle({
-            chain,
-            sellerPrivateKey: sellerPk,
-            sellAmount,
-            buyerPrivateKeys: roundBuyerPks,
-            buyerRatios,
-            tokenAddress,
-            config,
-            quoteToken,
-            quoteTokenDecimals,
-            disperseHopCount,
-            startNonces // ✅ 传入预计算的 nonces
-        });
-        // ✅ 更新卖方 nonce（使用精确计算的值）
-        addressToNonce.set(sellerWallet.address, sellerNonce + sellerNonceConsumed);
-        console.log(`[flapCrossSwapMerkle] 轮次 ${i + 1}: 卖方=${sellerWallet.address.slice(0, 10)}..., 买方=${roundBuyerPks.length}, 交易=${res.signedTransactions.length}`);
-        // 累积签名与中间钱包
-        allSigned.push(...res.signedTransactions);
-        if (res.disperseHopWallets)
-            allDisperse.push(...res.disperseHopWallets);
-        if (res.profitHopWallets)
-            allProfit.push(...res.profitHopWallets);
-        rounds.push({
-            sellerAddress: res.metadata?.sellerAddress || '',
-            buyerAddresses: res.metadata?.buyerAddresses || roundBuyerPks.map(() => ''),
-            sellAmount,
-            bundleHash: undefined
-        });
-    }
-    nonceManager.clearTemp();
-    console.log(`[flapCrossSwapMerkle] 完成: ${rounds.length} 轮, ${allSigned.length} 笔交易`);
-    return {
-        signedTransactions: allSigned,
-        rounds,
-        disperseHopWallets: allDisperse.length > 0 ? allDisperse : undefined,
-        profitHopWallets: allProfit.length > 0 ? allProfit : undefined
-    };
-}