four-flap-meme-sdk 2.0.0 → 2.2.0

package/dist/chains/xlayer/eip7702/bundle-swap/index.js

@@ -1,921 +0,0 @@
-/**
- * EIP-7702 捆绑换手
- *
- * 在一笔交易中完成:
- * 1. 主钱包卖币 → 获得 OKB
- * 2. OKB 多跳转账 → 中间钱包1 → 中间钱包2 → 最终钱包
- * 3. 最终钱包买币
- *
- * 支持 FLAP 内盘、V2 和 V3 三种交易类型
- * 只生成签名，由调用方决定如何提交
- */
-import { ethers, Contract, JsonRpcProvider } from 'ethers';
-import { quoteV2, quoteV3 } from '../../../../utils/quote-helpers.js';
-// ✅ 扩展参数类型，添加 userType 和 useFundUtilization 支持
-import { getCachedProvider, createWallet, signAuthorization, signAuthorizationsWithNonces, batchGetNonces, buildEIP7702TransactionSync, calculateProfitAmountByUserType, calculateProfitAmountByTxCount, getProfitRecipient, generateRandomWallets, } from '../utils.js';
-import { UNIFIED_DELEGATE_ADDRESS, POTATOSWAP_V2_ROUTER, POTATOSWAP_V3_ROUTER, FLAP_PORTAL_ADDRESS, WOKB_ADDRESS, V3_FEE_TIERS, UNIFIED_DELEGATE_ABI, FLAP_PORTAL_ABI, ERC20_ABI, XLAYER_RPC_URL, XLAYER_CHAIN_ID, } from '../constants.js';
-// ========================================
-// 路由地址获取
-// ========================================
-function getDefaultRouter(tradeType) {
-    switch (tradeType) {
-        case 'FLAP':
-            return FLAP_PORTAL_ADDRESS;
-        case 'V2':
-            return POTATOSWAP_V2_ROUTER;
-        case 'V3':
-            return POTATOSWAP_V3_ROUTER;
-    }
-}
-/**
- * 截断小数位数，避免 parseEther/parseUnits 报错
- * @param value 数值字符串
- * @param decimals 保留的小数位数（默认 18）
- */
-function truncateDecimals(value, decimals = 18) {
-    if (!value || value === '0')
-        return value;
-    const parts = String(value).split('.');
-    if (parts.length === 1)
-        return value;
-    const intPart = parts[0] || '0';
-    const decPart = (parts[1] || '').slice(0, decimals);
-    return decPart ? `${intPart}.${decPart}` : intPart;
-}
-// ========================================
-// 卖出报价（Token → OKB）
-// ========================================
-/**
- * 获取卖出报价：预估卖出代币能得到多少 OKB
- */
-async function quoteSellOutput(sellAmount, tokenAddress, tradeType, fee, rpcUrl) {
-    if (sellAmount <= 0n)
-        return 0n;
-    const provider = new JsonRpcProvider(rpcUrl || XLAYER_RPC_URL, { chainId: XLAYER_CHAIN_ID, name: 'xlayer', ensAddress: undefined });
-    try {
-        switch (tradeType) {
-            case 'FLAP': {
-                // FLAP Portal 报价
-                const portalContract = new Contract(FLAP_PORTAL_ADDRESS, FLAP_PORTAL_ABI, provider);
-                // ✅ 优先使用 quoteExactInput.staticCall（与 AA 模式一致）
-                try {
-                    const okbOut = await portalContract.quoteExactInput.staticCall({
-                        inputToken: tokenAddress,
-                        outputToken: ethers.ZeroAddress,
-                        inputAmount: sellAmount,
-                    });
-                    console.log(`[Bundle Swap] FLAP quoteExactInput 成功: ${ethers.formatEther(okbOut)} OKB`);
-                    return BigInt(okbOut.toString());
-                }
-                catch (e) {
-                    console.warn(`[Bundle Swap] FLAP quoteExactInput 失败:`, e);
-                }
-                // 回退到 previewSell
-                try {
-                    const okbOut = await portalContract.previewSell(tokenAddress, sellAmount);
-                    console.log(`[Bundle Swap] FLAP previewSell 成功: ${ethers.formatEther(okbOut)} OKB`);
-                    return BigInt(okbOut.toString());
-                }
-                catch {
-                    console.warn(`[Bundle Swap] FLAP previewSell 失败，尝试 V2...`);
-                }
-                // 回退到 V2
-                const v2Result = await quoteV2(provider, tokenAddress, WOKB_ADDRESS, sellAmount, 'XLAYER');
-                if (v2Result.amountOut > 0n) {
-                    console.log(`[Bundle Swap] FLAP 回退 V2 报价成功: ${ethers.formatEther(v2Result.amountOut)} OKB`);
-                    return v2Result.amountOut;
-                }
-                break;
-            }
-            case 'V2': {
-                const result = await quoteV2(provider, tokenAddress, WOKB_ADDRESS, sellAmount, 'XLAYER');
-                if (result.amountOut > 0n) {
-                    console.log(`[Bundle Swap] V2 报价成功: ${ethers.formatEther(result.amountOut)} OKB`);
-                    return result.amountOut;
-                }
-                break;
-            }
-            case 'V3': {
-                const result = await quoteV3(provider, tokenAddress, WOKB_ADDRESS, sellAmount, 'XLAYER', fee);
-                if (result.amountOut > 0n) {
-                    console.log(`[Bundle Swap] V3 报价成功 (fee=${result.fee}): ${ethers.formatEther(result.amountOut)} OKB`);
-                    return result.amountOut;
-                }
-                // 回退到 V2
-                const v2Result = await quoteV2(provider, tokenAddress, WOKB_ADDRESS, sellAmount, 'XLAYER');
-                if (v2Result.amountOut > 0n) {
-                    console.log(`[Bundle Swap] V3 回退 V2 报价成功: ${ethers.formatEther(v2Result.amountOut)} OKB`);
-                    return v2Result.amountOut;
-                }
-                break;
-            }
-        }
-    }
-    catch (error) {
-        console.error(`[Bundle Swap] 报价失败:`, error);
-    }
-    console.warn(`[Bundle Swap] 无法获取报价，利润计算可能不准确`);
-    return 0n;
-}
-// ========================================
-// 构建卖出并转账调用
-// ========================================
-function buildSellAndTransferCall(sellerWallet, sellAmount, tokenAddress, recipient, tradeType, routerAddress, fee) {
-    const delegateInterface = new ethers.Interface(UNIFIED_DELEGATE_ABI);
-    const portalInterface = new ethers.Interface(FLAP_PORTAL_ABI);
-    switch (tradeType) {
-        case 'FLAP': {
-            // ✅ FLAP: 使用 swapExactInput 卖出（与 AA 模式保持一致）
-            const portalCallData = portalInterface.encodeFunctionData('swapExactInput', [{
-                    inputToken: tokenAddress,
-                    outputToken: ethers.ZeroAddress, // 0x0 = OKB
-                    inputAmount: sellAmount,
-                    minOutputAmount: 0n,
-                    permitData: '0x',
-                }]);
-            // 通过 executeBatch 让 seller 钱包调用 Portal
-            const batchCalls = [{ target: FLAP_PORTAL_ADDRESS, value: 0n, data: portalCallData }];
-            const callData = delegateInterface.encodeFunctionData('executeBatch', [batchCalls]);
-            return {
-                target: sellerWallet.address,
-                allowFailure: false,
-                value: 0n,
-                callData,
-            };
-        }
-        case 'V2': {
-            // V2: 使用 executeSellAndTransferV2
-            const path = [tokenAddress, WOKB_ADDRESS];
-            const callData = delegateInterface.encodeFunctionData('executeSellAndTransferV2', [
-                routerAddress,
-                path,
-                sellAmount,
-                recipient,
-            ]);
-            return {
-                target: sellerWallet.address,
-                allowFailure: false,
-                value: 0n,
-                callData,
-            };
-        }
-        case 'V3': {
-            // V3: 使用 executeSellAndTransfer
-            const callData = delegateInterface.encodeFunctionData('executeSellAndTransfer', [
-                routerAddress,
-                tokenAddress,
-                WOKB_ADDRESS,
-                fee,
-                sellAmount,
-                recipient,
-            ]);
-            return {
-                target: sellerWallet.address,
-                allowFailure: false,
-                value: 0n,
-                callData,
-            };
-        }
-    }
-}
-// ========================================
-// 构建买入调用
-// ========================================
-function buildBuyCall(buyerWallet, tokenAddress, tradeType, routerAddress, fee, buyAmount // ✅ 新增：买入金额（防止使用全部余额导致问题）
-) {
-    const delegateInterface = new ethers.Interface(UNIFIED_DELEGATE_ABI);
-    const portalInterface = new ethers.Interface(FLAP_PORTAL_ABI);
-    switch (tradeType) {
-        case 'FLAP': {
-            // ✅ FLAP: 使用 swapExactInput 买入（与 AA 模式保持一致）
-            // 原 buy(address token) ABI 与 Portal 不匹配，改用 swapExactInput
-            const portalCallData = portalInterface.encodeFunctionData('swapExactInput', [{
-                    inputToken: ethers.ZeroAddress, // 0x0 = OKB (原生代币)
-                    outputToken: tokenAddress,
-                    inputAmount: buyAmount,
-                    minOutputAmount: 0n,
-                    permitData: '0x',
-                }]);
-            const batchCalls = [{ target: FLAP_PORTAL_ADDRESS, value: buyAmount, data: portalCallData }];
-            return {
-                target: buyerWallet.address,
-                allowFailure: false,
-                value: 0n,
-                callData: delegateInterface.encodeFunctionData('executeBatch', [batchCalls]),
-            };
-        }
-        case 'V2': {
-            // ✅ V2: 使用 executeBuyV2，传入指定金额
-            const path = [WOKB_ADDRESS, tokenAddress];
-            const callData = delegateInterface.encodeFunctionData('executeBuyV2', [
-                routerAddress,
-                path,
-                buyAmount, // ✅ 使用指定金额，不是 0
-            ]);
-            return {
-                target: buyerWallet.address,
-                allowFailure: false,
-                value: 0n,
-                callData,
-            };
-        }
-        case 'V3': {
-            // ✅ V3: 使用 executeBuy，传入指定金额
-            const callData = delegateInterface.encodeFunctionData('executeBuy', [
-                routerAddress,
-                WOKB_ADDRESS,
-                tokenAddress,
-                fee,
-                buyAmount, // ✅ 使用指定金额，不是 0
-            ]);
-            return {
-                target: buyerWallet.address,
-                allowFailure: false,
-                value: 0n,
-                callData,
-            };
-        }
-    }
-}
-/**
- * 构建捆绑换手交易
- */
-async function buildSwapCalls(sellerWallet, buyerWallet, hopWallets, sellAmount, buyAmount, // ✅ 新增：买入金额（防止使用全部余额）
-tokenAddress, tradeType, routerAddress, fee) {
-    const delegateInterface = new ethers.Interface(UNIFIED_DELEGATE_ABI);
-    const calls = [];
-    // 第一步：卖家卖币并转账给第一个中间钱包
-    const firstRecipient = hopWallets.length > 0 ? hopWallets[0].address : buyerWallet.address;
-    const sellCall = buildSellAndTransferCall(sellerWallet, sellAmount, tokenAddress, firstRecipient, tradeType, routerAddress, fee);
-    calls.push(sellCall);
-    // FLAP 模式需要额外的转账调用（因为 sell 函数不支持直接转账）
-    if (tradeType === 'FLAP') {
-        const transferData = delegateInterface.encodeFunctionData('transferTo', [firstRecipient]);
-        calls.push({
-            target: sellerWallet.address,
-            allowFailure: false,
-            value: 0n,
-            callData: transferData,
-        });
-    }
-    // 中间钱包之间的转账
-    for (let i = 0; i < hopWallets.length; i++) {
-        const nextRecipient = i < hopWallets.length - 1 ? hopWallets[i + 1].address : buyerWallet.address;
-        const transferData = delegateInterface.encodeFunctionData('transferTo', [nextRecipient]);
-        calls.push({
-            target: hopWallets[i].address,
-            allowFailure: false,
-            value: 0n,
-            callData: transferData,
-        });
-    }
-    // ✅ 最后一步：买家买币（使用指定金额）
-    const buyCall = buildBuyCall(buyerWallet, tokenAddress, tradeType, routerAddress, fee, buyAmount);
-    calls.push(buyCall);
-    return calls;
-}
-/**
- * 捆绑换手 - 生成签名后的交易
- *
- * @param params 换手参数
- * @returns 签名后的交易和元数据
- *
- * @example
- * // FLAP 内盘换手
- * const result = await bundleSwap({
- *   sellerPrivateKey: '0x...',
- *   buyerPrivateKey: '0x...',
- *   tokenAddress: '0x...',
- *   sellAmount: '100',
- *   tradeType: 'FLAP',
- *   hopCount: 2,
- * });
- */
-export async function bundleSwap(params) {
-    const { sellerPrivateKey, buyerPrivateKey, tokenAddress, tokenDecimals = 18, sellAmount, hopCount = 0, tradeType = 'V3', routerAddress, fee = V3_FEE_TIERS.MEDIUM, userType = 'v0', useFundUtilization = false, // ✅ 默认普通模式
-    config, } = params;
-    const provider = getCachedProvider(config?.rpcUrl);
-    const delegateAddress = (config?.delegateAddress && config.delegateAddress.trim()) || UNIFIED_DELEGATE_ADDRESS;
-    const delegateInterface = new ethers.Interface(UNIFIED_DELEGATE_ABI);
-    const actualRouter = routerAddress ?? getDefaultRouter(tradeType);
-    const portalInterface = new ethers.Interface(FLAP_PORTAL_ABI);
-    // ========================================
-    // 同步操作 - 创建钱包
-    // ========================================
-    const sellerWallet = createWallet(sellerPrivateKey, provider);
-    const buyerWallet = createWallet(buyerPrivateKey, provider);
-    // 资金利用率模式才需要中间钱包
-    const actualHopCount = useFundUtilization ? hopCount : 0;
-    const hopWalletInfos = actualHopCount > 0 ? generateRandomWallets(actualHopCount) : [];
-    const hopWallets = hopWalletInfos.map(info => createWallet(info.privateKey, provider));
-    const sellAmountWei = ethers.parseUnits(truncateDecimals(sellAmount, tokenDecimals), tokenDecimals);
-    // 获取卖出报价
-    const estimatedOkbOut = await quoteSellOutput(sellAmountWei, tokenAddress, tradeType, fee, config?.rpcUrl);
-    // 使用双边费率计算利润（换手 = 卖 + 买）
-    const profitAmount = estimatedOkbOut > 0n
-        ? calculateProfitAmountByUserType(estimatedOkbOut, userType, true)
-        : 0n;
-    const profitRecipient = getProfitRecipient(config);
-    // 计算买入金额
-    const buyAmountAfterProfit = estimatedOkbOut > profitAmount
-        ? estimatedOkbOut - profitAmount
-        : 0n;
-    const modeLabel = useFundUtilization ? '资金利用率' : '普通';
-    console.log(`[Bundle Swap] 模式: ${modeLabel}`);
-    console.log(`[Bundle Swap] 卖出数量: ${sellAmount} Token`);
-    console.log(`[Bundle Swap] 预估获得: ${ethers.formatEther(estimatedOkbOut)} OKB`);
-    console.log(`[Bundle Swap] 利润: ${ethers.formatEther(profitAmount)} OKB (userType=${userType})`);
-    console.log(`[Bundle Swap] 买入金额: ${ethers.formatEther(buyAmountAfterProfit)} OKB`);
-    // ========================================
-    // 并行获取数据
-    // ========================================
-    const [nonces, feeData, buyerBalance] = await Promise.all([
-        batchGetNonces([sellerWallet.address, buyerWallet.address], provider),
-        provider.getFeeData(),
-        provider.getBalance(buyerWallet.address),
-    ]);
-    const sellerNonce = nonces[0];
-    const buyerNonce = nonces[1];
-    // ========================================
-    // 验证余额
-    // ========================================
-    if (tradeType === 'FLAP' && buyAmountAfterProfit <= 0n) {
-        throw new Error('FLAP 内盘模式需要有效的报价，请检查代币地址或稍后重试');
-    }
-    // 普通模式：买家需要预存足够的 OKB
-    if (!useFundUtilization && tradeType === 'FLAP') {
-        if (buyerBalance < buyAmountAfterProfit) {
-            throw new Error(`普通模式需要买家钱包有足够的 OKB，需要 ${ethers.formatEther(buyAmountAfterProfit)}，当前 ${ethers.formatEther(buyerBalance)}`);
-        }
-    }
-    // ========================================
-    // 签署授权
-    // ========================================
-    const authPromises = [];
-    // 卖家授权（交易发起者，nonce +1）
-    authPromises.push(signAuthorization(sellerWallet, delegateAddress, BigInt(sellerNonce + 1)));
-    // 买家授权
-    authPromises.push(signAuthorization(buyerWallet, delegateAddress, BigInt(buyerNonce)));
-    // 中间钱包授权（资金利用率模式）
-    for (const hopWallet of hopWallets) {
-        authPromises.push(signAuthorization(hopWallet, delegateAddress, 0n));
-    }
-    const authorizations = await Promise.all(authPromises);
-    // ========================================
-    // 构建调用
-    // ========================================
-    const calls = [];
-    if (useFundUtilization) {
-        // ========================================
-        // ✅ 资金利用率模式
-        // 核心逻辑：卖出获得的 OKB 按比例转给买家
-        // 1. 卖家卖出代币 → 获得 OKB
-        // 2. 利润从卖家 OKB 中扣除
-        // 3. （可选多跳）卖家 → hop1 → hop2 → ... → 分发者
-        // 4. 分发者按比例转账给买家
-        // 5. 买家买入
-        // ========================================
-        console.log(`[Bundle Swap] 资金利用率模式，hopCount=${actualHopCount}`);
-        // 1. 卖家卖出
-        const sellCall = buildSellCallWithAmountInternal(sellerWallet, sellAmountWei, tokenAddress, tradeType, actualRouter, fee, delegateInterface, portalInterface);
-        calls.push(sellCall);
-        // 2. 利润刮取（从卖家余额扣除）
-        if (profitAmount > 0n) {
-            calls.push({
-                target: sellerWallet.address,
-                allowFailure: false,
-                value: 0n,
-                callData: delegateInterface.encodeFunctionData('transferAmount', [profitRecipient, profitAmount]),
-            });
-        }
-        // 3. 确定分发者：如果有多跳，最后一个 hop 是分发者；否则卖家是分发者
-        const distributor = hopWallets.length > 0 ? hopWallets[hopWallets.length - 1] : sellerWallet;
-        // 多跳转账（如果有）
-        if (hopWallets.length > 0) {
-            // ✅ 修复：卖家只转移"卖出所得 - 利润"，不是全部余额
-            // 避免把卖家原有的 OKB 也转走
-            calls.push({
-                target: sellerWallet.address,
-                allowFailure: false,
-                value: 0n,
-                callData: delegateInterface.encodeFunctionData('transferAmount', [hopWallets[0].address, buyAmountAfterProfit]),
-            });
-            // hop1 → hop2 → ... → 最后一个 hop（分发者）：使用 transferTo（全部余额）
-            for (let i = 0; i < hopWallets.length - 1; i++) {
-                calls.push({
-                    target: hopWallets[i].address,
-                    allowFailure: false,
-                    value: 0n,
-                    callData: delegateInterface.encodeFunctionData('transferTo', [hopWallets[i + 1].address]),
-                });
-            }
-        }
-        // 4. 分发者转账给买家：使用 transferTo（全部余额，确保资金不滞留）
-        calls.push({
-            target: distributor.address,
-            allowFailure: false,
-            value: 0n,
-            callData: delegateInterface.encodeFunctionData('transferTo', [buyerWallet.address]),
-        });
-        // 5. 买家买入（使用收到的 OKB）
-        const buyCall = buildBuyCallInternal(buyerWallet, buyAmountAfterProfit, tokenAddress, tradeType, actualRouter, fee, delegateInterface, portalInterface);
-        calls.push(buyCall);
-    }
-    else {
-        // ========================================
-        // ✅ 普通模式
-        // 1. 卖家卖出代币 → OKB 留在卖家账户
-        // 2. 买家用自己预存的 OKB 买入代币
-        // 3. 利润从买家的 OKB 中扣除
-        // ========================================
-        console.log(`[Bundle Swap] 普通模式`);
-        // 1. 卖家卖出（OKB 留在卖家账户）
-        const sellCall = buildSellCallWithAmountInternal(sellerWallet, sellAmountWei, tokenAddress, tradeType, actualRouter, fee, delegateInterface, portalInterface);
-        calls.push(sellCall);
-        // 2. 利润刮取（从买家余额扣除）
-        if (profitAmount > 0n) {
-            calls.push({
-                target: buyerWallet.address,
-                allowFailure: false,
-                value: 0n,
-                callData: delegateInterface.encodeFunctionData('transferAmount', [profitRecipient, profitAmount]),
-            });
-        }
-        // 3. 买家用自己的 OKB 买入（金额 = 卖家卖出所得，避免买卖资金不匹配）
-        const buyCall = buildBuyCallInternal(buyerWallet, buyAmountAfterProfit, tokenAddress, tradeType, actualRouter, fee, delegateInterface, portalInterface);
-        calls.push(buyCall);
-    }
-    // ========================================
-    // 构建交易
-    // ========================================
-    const signedTransaction = buildEIP7702TransactionSync(sellerWallet, authorizations, calls, 0n, sellerNonce, feeData, config);
-    return {
-        signedTransaction,
-        hopWallets: hopWalletInfos,
-        metadata: {
-            sellerAddress: sellerWallet.address,
-            buyerAddresses: [buyerWallet.address],
-            sellAmount: ethers.formatUnits(sellAmountWei, tokenDecimals),
-            estimatedOkbOut: ethers.formatEther(estimatedOkbOut),
-            estimatedBuyAmount: ethers.formatEther(buyAmountAfterProfit),
-            profitAmount: ethers.formatEther(profitAmount),
-            profitRecipient,
-            userType,
-            useFundUtilization,
-        },
-    };
-}
-/**
- * 批量换手（一卖多买）- 生成签名后的交易
- *
- * @param params 批量换手参数
- * @returns 签名后的交易和元数据
- *
- * @example
- * // FLAP 内盘一对多换手
- * const result = await bundleBatchSwap({
- *   sellerPrivateKey: '0x...',
- *   buyerPrivateKeys: ['0x...', '0x...'],
- *   tokenAddress: '0x...',
- *   sellAmount: '100',
- *   tradeType: 'FLAP',
- * });
- */
-export async function bundleBatchSwap(params) {
-    const { sellerPrivateKey, buyerPrivateKeys, buyerRatios, tokenAddress, tokenDecimals = 18, sellAmount, hopCount = 0, tradeType = 'V3', routerAddress, fee = V3_FEE_TIERS.MEDIUM, userType = 'v0', useFundUtilization = false, // ✅ 默认普通模式
-    config, } = params;
-    const provider = getCachedProvider(config?.rpcUrl);
-    const delegateAddress = (config?.delegateAddress && config.delegateAddress.trim()) || UNIFIED_DELEGATE_ADDRESS;
-    const actualRouter = routerAddress ?? getDefaultRouter(tradeType);
-    const delegateInterface = new ethers.Interface(UNIFIED_DELEGATE_ABI);
-    const portalInterface = new ethers.Interface(FLAP_PORTAL_ABI);
-    // ========================================
-    // 创建钱包
-    // ========================================
-    const sellerWallet = createWallet(sellerPrivateKey, provider);
-    const buyerWallets = buyerPrivateKeys.map(pk => createWallet(pk, provider));
-    // 资金利用率模式才需要中间钱包
-    const actualHopCount = useFundUtilization ? hopCount : 0;
-    const hopWalletInfos = actualHopCount > 0 ? generateRandomWallets(actualHopCount) : [];
-    const hopWallets = hopWalletInfos.map(info => createWallet(info.privateKey, provider));
-    const sellAmountWei = ethers.parseUnits(truncateDecimals(sellAmount, tokenDecimals), tokenDecimals);
-    // 获取卖出报价
-    const estimatedOkbOut = await quoteSellOutput(sellAmountWei, tokenAddress, tradeType, fee, config?.rpcUrl);
-    // 计算利润和买入金额
-    const profitAmount = estimatedOkbOut > 0n
-        ? calculateProfitAmountByUserType(estimatedOkbOut, userType, true)
-        : 0n;
-    const profitRecipient = getProfitRecipient(config);
-    const totalBuyAmountAfterProfit = estimatedOkbOut > profitAmount
-        ? estimatedOkbOut - profitAmount
-        : 0n;
-    const modeLabel = useFundUtilization ? '资金利用率' : '普通';
-    console.log(`[Bundle Batch Swap] 模式: ${modeLabel}`);
-    console.log(`[Bundle Batch Swap] 卖出数量: ${sellAmount} Token`);
-    console.log(`[Bundle Batch Swap] 预估获得: ${ethers.formatEther(estimatedOkbOut)} OKB`);
-    console.log(`[Bundle Batch Swap] 利润: ${ethers.formatEther(profitAmount)} OKB (userType=${userType})`);
-    console.log(`[Bundle Batch Swap] 买入金额: ${ethers.formatEther(totalBuyAmountAfterProfit)} OKB`);
-    // 验证报价
-    if (tradeType === 'FLAP' && totalBuyAmountAfterProfit <= 0n) {
-        throw new Error('FLAP 内盘模式需要有效的报价，请检查代币地址或稍后重试');
-    }
-    // ========================================
-    // 并行获取数据
-    // ========================================
-    const addressesToQuery = [sellerWallet.address, ...buyerWallets.map(w => w.address)];
-    const [nonces, feeData, ...buyerBalances] = await Promise.all([
-        batchGetNonces(addressesToQuery, provider),
-        provider.getFeeData(),
-        ...buyerWallets.map(w => provider.getBalance(w.address)),
-    ]);
-    const sellerNonce = nonces[0];
-    const buyerNonces = nonces.slice(1);
-    // 普通模式验证：买家需要预存足够的 OKB
-    if (!useFundUtilization && tradeType === 'FLAP') {
-        const totalBuyerBalance = buyerBalances.reduce((sum, b) => sum + BigInt(b.toString()), 0n);
-        if (totalBuyerBalance < totalBuyAmountAfterProfit) {
-            throw new Error(`普通模式需要买家钱包总余额足够，需要 ${ethers.formatEther(totalBuyAmountAfterProfit)}，当前总计 ${ethers.formatEther(totalBuyerBalance)}`);
-        }
-    }
-    // ========================================
-    // 签署授权
-    // ========================================
-    const authPromises = [];
-    authPromises.push(signAuthorization(sellerWallet, delegateAddress, BigInt(sellerNonce + 1)));
-    for (let i = 0; i < buyerWallets.length; i++) {
-        authPromises.push(signAuthorization(buyerWallets[i], delegateAddress, BigInt(buyerNonces[i])));
-    }
-    // 中间钱包授权（资金利用率模式）
-    for (const hopWallet of hopWallets) {
-        authPromises.push(signAuthorization(hopWallet, delegateAddress, 0n));
-    }
-    const authorizations = await Promise.all(authPromises);
-    // ========================================
-    // 构建调用
-    // ========================================
-    const calls = [];
-    // ✅ 计算每个买家的买入金额
-    // 所有模式都按比例分配卖家卖出所得，避免买卖资金不匹配
-    let buyAmountsPerBuyer;
-    if (buyerWallets.length === 1) {
-        // 单买家：使用全部卖出所得
-        buyAmountsPerBuyer = [totalBuyAmountAfterProfit];
-    }
-    else if (buyerRatios && buyerRatios.length === buyerWallets.length) {
-        // 多买家 + 有比例：按前端传入的比例分配
-        let allocated = 0n;
-        buyAmountsPerBuyer = buyerRatios.map((ratio, i) => {
-            const amount = (totalBuyAmountAfterProfit * BigInt(Math.round(ratio * 10000))) / 10000n;
-            if (i === buyerRatios.length - 1) {
-                return totalBuyAmountAfterProfit - allocated;
-            }
-            allocated += amount;
-            return amount;
-        });
-    }
-    else {
-        // 多买家无比例：均分
-        const avgAmount = totalBuyAmountAfterProfit / BigInt(buyerWallets.length);
-        const remainder = totalBuyAmountAfterProfit % BigInt(buyerWallets.length);
-        buyAmountsPerBuyer = buyerWallets.map((_, i) => i === buyerWallets.length - 1 ? avgAmount + remainder : avgAmount);
-    }
-    console.log(`[bundleBatchSwap] 买入金额分配:`, buyAmountsPerBuyer.map(a => ethers.formatEther(a)));
-    if (useFundUtilization) {
-        // ========================================
-        // ✅ 资金利用率模式（一卖多买）
-        // 1. 卖家卖出代币 → 获得 OKB
-        // 2. 利润从卖家 OKB 中扣除
-        // 3. 卖家（或最后一个 hop）按比例转账给各买家
-        // 4. 各买家用收到的 OKB 买入
-        // ========================================
-        console.log(`[Bundle Batch Swap] 资金利用率模式，hopCount=${actualHopCount}`);
-        // 1. 卖家卖出
-        const sellCall = buildSellCallWithAmountInternal(sellerWallet, sellAmountWei, tokenAddress, tradeType, actualRouter, fee, delegateInterface, portalInterface);
-        calls.push(sellCall);
-        // 2. 利润刮取（从卖家余额扣除）
-        if (profitAmount > 0n) {
-            calls.push({
-                target: sellerWallet.address,
-                allowFailure: false,
-                value: 0n,
-                callData: delegateInterface.encodeFunctionData('transferAmount', [profitRecipient, profitAmount]),
-            });
-        }
-        // 3. OKB 转账逻辑
-        // 确定分发者：如果有多跳，最后一个 hop 是分发者；否则卖家是分发者
-        const distributor = hopWallets.length > 0 ? hopWallets[hopWallets.length - 1] : sellerWallet;
-        if (hopWallets.length > 0) {
-            // ✅ 修复：卖家只转移"卖出所得 - 利润"，不是全部余额
-            // 避免把卖家原有的 OKB 也转走
-            calls.push({
-                target: sellerWallet.address,
-                allowFailure: false,
-                value: 0n,
-                callData: delegateInterface.encodeFunctionData('transferAmount', [hopWallets[0].address, totalBuyAmountAfterProfit]),
-            });
-            // 中间钱包之间转账（到最后一个 hop）：使用 transferTo（全部余额）
-            for (let i = 0; i < hopWallets.length - 1; i++) {
-                calls.push({
-                    target: hopWallets[i].address,
-                    allowFailure: false,
-                    value: 0n,
-                    callData: delegateInterface.encodeFunctionData('transferTo', [hopWallets[i + 1].address]),
-                });
-            }
-        }
-        // 分发者按比例转给各买家
-        for (let i = 0; i < buyerWallets.length; i++) {
-            const amountToTransfer = buyAmountsPerBuyer[i];
-            if (amountToTransfer <= 0n)
-                continue;
-            // ✅ 最后一个买家使用 transferTo（全部余额），确保资金不滞留
-            const isLastBuyer = i === buyerWallets.length - 1;
-            calls.push({
-                target: distributor.address,
-                allowFailure: false,
-                value: 0n,
-                callData: isLastBuyer
-                    ? delegateInterface.encodeFunctionData('transferTo', [buyerWallets[i].address])
-                    : delegateInterface.encodeFunctionData('transferAmount', [buyerWallets[i].address, amountToTransfer]),
-            });
-        }
-        // 4. 所有买家买入
-        for (let i = 0; i < buyerWallets.length; i++) {
-            const buyCall = buildBuyCallInternal(buyerWallets[i], buyAmountsPerBuyer[i], tokenAddress, tradeType, actualRouter, fee, delegateInterface, portalInterface);
-            calls.push(buyCall);
-        }
-    }
-    else {
-        // ========================================
-        // ✅ 普通模式（一卖多买）
-        // 1. 卖家卖出代币 → OKB 留在卖家账户
-        // 2. 利润从第一个买家 OKB 中扣除
-        // 3. 各买家用自己预存的 OKB 买入
-        // ========================================
-        console.log(`[Bundle Batch Swap] 普通模式`);
-        // 1. 卖家卖出（OKB 留在卖家账户）
-        const sellCall = buildSellCallWithAmountInternal(sellerWallet, sellAmountWei, tokenAddress, tradeType, actualRouter, fee, delegateInterface, portalInterface);
-        calls.push(sellCall);
-        // 2. 利润刮取（从第一个买家余额扣除）
-        if (profitAmount > 0n) {
-            calls.push({
-                target: buyerWallets[0].address,
-                allowFailure: false,
-                value: 0n,
-                callData: delegateInterface.encodeFunctionData('transferAmount', [profitRecipient, profitAmount]),
-            });
-        }
-        // 3. 所有买家买入（使用自己预存的 OKB）
-        for (let i = 0; i < buyerWallets.length; i++) {
-            const buyCall = buildBuyCallInternal(buyerWallets[i], buyAmountsPerBuyer[i], tokenAddress, tradeType, actualRouter, fee, delegateInterface, portalInterface);
-            calls.push(buyCall);
-        }
-    }
-    // ========================================
-    // 构建交易
-    // ========================================
-    const signedTransaction = buildEIP7702TransactionSync(sellerWallet, authorizations, calls, 0n, sellerNonce, feeData, config);
-    return {
-        signedTransaction,
-        hopWallets: hopWalletInfos,
-        metadata: {
-            sellerAddress: sellerWallet.address,
-            buyerAddresses: buyerWallets.map(w => w.address),
-            sellAmount: ethers.formatUnits(sellAmountWei, tokenDecimals),
-            estimatedOkbOut: ethers.formatEther(estimatedOkbOut),
-            estimatedBuyAmount: ethers.formatEther(totalBuyAmountAfterProfit),
-            profitAmount: ethers.formatEther(profitAmount),
-            profitRecipient,
-            userType,
-            useFundUtilization,
-        },
-    };
-}
-// ========================================
-// 多对多换手 (M sellers → N buyers)
-// ========================================
-/**
- * 多对多换手 - 多个卖家 + 多个买家
- *
- * 核心逻辑：[利润刮取] + [卖出Ops...] + [买入Ops...]
- *
- * 特点：
- * - 多个卖家同时卖出
- * - 多个买家同时买入
- * - 所有操作在一笔交易中原子执行
- * - 利润根据 userType 动态计算
- *
- * @example
- * const result = await bundleMultiSwap({
- *   mainPrivateKey: '0x...',  // Payer 支付 Gas
- *   sellerPrivateKeys: ['0x...', '0x...'],
- *   buyerPrivateKeys: ['0x...', '0x...'],
- *   totalBuyAmount: '0.1',  // 总买入 0.1 OKB
- *   tokenAddress: '0x...',
- *   tradeType: 'V3',
- *   userType: 'v0',
- * });
- */
-export async function bundleMultiSwap(params) {
-    const { mainPrivateKey, sellerPrivateKeys, buyerPrivateKeys, totalBuyAmount, tokenAddress, tokenDecimals = 18, sellPercent = 100, tradeType = 'V3', routerAddress, fee = V3_FEE_TIERS.MEDIUM, userType = 'v0', config, } = params;
-    // ✅ 验证私钥格式的辅助函数
-    const isValidPrivateKey = (pk) => {
-        const trimmed = (pk || '').trim();
-        return trimmed.length >= 64 && (trimmed.startsWith('0x') || /^[0-9a-fA-F]{64}$/.test(trimmed));
-    };
-    if (!mainPrivateKey || !isValidPrivateKey(mainPrivateKey)) {
-        throw new Error('必须提供有效的 mainPrivateKey（Payer 钱包私钥）');
-    }
-    // ✅ 验证卖家私钥
-    const validSellerPrivateKeys = sellerPrivateKeys.filter(pk => isValidPrivateKey(pk));
-    if (validSellerPrivateKeys.length === 0) {
-        throw new Error('没有有效的卖家私钥');
-    }
-    // ✅ 验证买家私钥
-    const validBuyerPrivateKeys = buyerPrivateKeys.filter(pk => isValidPrivateKey(pk));
-    if (validBuyerPrivateKeys.length === 0) {
-        throw new Error('没有有效的买家私钥');
-    }
-    if (validSellerPrivateKeys.length !== sellerPrivateKeys.length || validBuyerPrivateKeys.length !== buyerPrivateKeys.length) {
-        console.warn(`[bundleMultiSwap] 跳过无效私钥: 卖家 ${sellerPrivateKeys.length - validSellerPrivateKeys.length} 个, 买家 ${buyerPrivateKeys.length - validBuyerPrivateKeys.length} 个`);
-    }
-    const provider = getCachedProvider(config?.rpcUrl);
-    // ✅ 空字符串也使用默认值
-    const delegateAddress = (config?.delegateAddress && config.delegateAddress.trim()) || UNIFIED_DELEGATE_ADDRESS;
-    const delegateInterface = new ethers.Interface(UNIFIED_DELEGATE_ABI);
-    const portalInterface = new ethers.Interface(FLAP_PORTAL_ABI);
-    const actualRouter = routerAddress ?? getDefaultRouter(tradeType);
-    // ✅ 创建 Payer 钱包（支付 Gas 费）
-    const mainWallet = createWallet(mainPrivateKey, provider);
-    // 创建钱包
-    const sellerWallets = validSellerPrivateKeys.map(pk => createWallet(pk, provider));
-    const buyerWallets = validBuyerPrivateKeys.map(pk => createWallet(pk, provider));
-    // 合并所有钱包（去重，包括 mainWallet）
-    const allWalletsMap = new Map();
-    allWalletsMap.set(mainWallet.address.toLowerCase(), mainWallet);
-    sellerWallets.forEach(w => allWalletsMap.set(w.address.toLowerCase(), w));
-    buyerWallets.forEach(w => allWalletsMap.set(w.address.toLowerCase(), w));
-    const allWallets = Array.from(allWalletsMap.values());
-    // 找出 mainWallet 在 allWallets 中的索引
-    const mainWalletIndex = allWallets.findIndex(w => w.address.toLowerCase() === mainWallet.address.toLowerCase());
-    // 计算买入金额
-    const totalBuyAmountWei = ethers.parseEther(truncateDecimals(totalBuyAmount));
-    const buyAmountPerWallet = totalBuyAmountWei / BigInt(buyerWallets.length);
-    // ✅ 计算利润（根据 userType 和交易数量）
-    const totalTxCount = sellerWallets.length + buyerWallets.length;
-    const profitAmount = calculateProfitAmountByTxCount(totalBuyAmountWei, totalTxCount, userType);
-    const profitRecipient = getProfitRecipient(config);
-    // ========================================
-    // 并行获取数据
-    // ========================================
-    const allAddresses = allWallets.map(w => w.address);
-    // 获取卖出钱包的代币余额
-    const tokenContract = new ethers.Contract(tokenAddress, ERC20_ABI, provider);
-    const [nonces, feeData, sellerBalances] = await Promise.all([
-        batchGetNonces(allAddresses, provider),
-        provider.getFeeData(),
-        Promise.all(sellerWallets.map(w => tokenContract.balanceOf(w.address))),
-    ]);
-    // 计算每个卖家的卖出金额（按百分比）
-    const percentBigInt = BigInt(Math.min(100, Math.max(1, sellPercent)));
-    const sellAmountsWei = sellerBalances.map((balance) => (BigInt(balance.toString()) * percentBigInt) / 100n);
-    const totalSellAmount = sellAmountsWei.reduce((sum, amt) => sum + amt, 0n);
-    // ========================================
-    // 同步签署授权
-    // ========================================
-    const authorizations = signAuthorizationsWithNonces(allWallets, nonces, delegateAddress, mainWalletIndex);
-    // ========================================
-    // 构建调用
-    // ========================================
-    const calls = [];
-    // 卖出调用
-    for (let i = 0; i < sellerWallets.length; i++) {
-        if (sellAmountsWei[i] <= 0n)
-            continue;
-        const sellCall = buildSellCallWithAmountInternal(sellerWallets[i], sellAmountsWei[i], tokenAddress, tradeType, actualRouter, fee, delegateInterface, portalInterface);
-        calls.push(sellCall);
-    }
-    // ✅ 修复：利润刮取放在卖出之后、买入之前（从第一个卖家余额转账）
-    if (profitAmount > 0n && sellerWallets.length > 0) {
-        calls.push({
-            target: sellerWallets[0].address, // 从第一个卖家扣利润
-            allowFailure: false,
-            value: 0n,
-            callData: delegateInterface.encodeFunctionData('transferAmount', [profitRecipient, profitAmount]),
-        });
-    }
-    // 买入调用
-    for (let i = 0; i < buyerWallets.length; i++) {
-        const buyCall = buildBuyCallInternal(buyerWallets[i], buyAmountPerWallet, tokenAddress, tradeType, actualRouter, fee, delegateInterface, portalInterface);
-        calls.push(buyCall);
-    }
-    // ========================================
-    // 构建交易
-    // ========================================
-    // ✅ 修复：利润使用 transferAmount 从卖家余额转账，不需要通过 msg.value 传递
-    const totalValue = 0n;
-    const signedTransaction = buildEIP7702TransactionSync(mainWallet, authorizations, calls, totalValue, nonces[mainWalletIndex], feeData, config);
-    return {
-        signedTransaction,
-        metadata: {
-            payerAddress: mainWallet.address,
-            sellerAddresses: sellerWallets.map(w => w.address),
-            buyerAddresses: buyerWallets.map(w => w.address),
-            sellerCount: sellerWallets.filter((_, i) => sellAmountsWei[i] > 0n).length,
-            buyerCount: buyerWallets.length,
-            totalBuyAmount: ethers.formatEther(totalBuyAmountWei),
-            totalSellAmount: ethers.formatUnits(totalSellAmount, tokenDecimals),
-            profitAmount: ethers.formatEther(profitAmount),
-            profitRecipient,
-            userType,
-        },
-    };
-}
-// ========================================
-// 内部工具函数
-// ========================================
-function buildBuyCallInternal(wallet, amount, tokenAddress, tradeType, routerAddress, fee, delegateInterface, portalInterface) {
-    switch (tradeType) {
-        case 'FLAP': {
-            // ✅ FLAP: 使用 swapExactInput 买入（与 AA 模式保持一致）
-            // 原 buy(address token) ABI 与 Portal 不匹配，改用 swapExactInput
-            const portalCallData = portalInterface.encodeFunctionData('swapExactInput', [{
-                    inputToken: ethers.ZeroAddress, // 0x0 = OKB (原生代币)
-                    outputToken: tokenAddress,
-                    inputAmount: amount,
-                    minOutputAmount: 0n,
-                    permitData: '0x',
-                }]);
-            const batchCalls = [{ target: FLAP_PORTAL_ADDRESS, value: amount, data: portalCallData }];
-            return {
-                target: wallet.address,
-                allowFailure: false,
-                value: 0n,
-                callData: delegateInterface.encodeFunctionData('executeBatch', [batchCalls]),
-            };
-        }
-        case 'V2': {
-            const path = [WOKB_ADDRESS, tokenAddress];
-            // ✅ 修复：使用指定的买入金额，而不是 0（使用全部余额会导致严重 bug）
-            return {
-                target: wallet.address,
-                allowFailure: false,
-                value: 0n,
-                callData: delegateInterface.encodeFunctionData('executeBuyV2', [routerAddress, path, amount]),
-            };
-        }
-        case 'V3': {
-            // ✅ 修复：使用指定的买入金额，而不是 0（使用全部余额会导致严重 bug）
-            return {
-                target: wallet.address,
-                allowFailure: false,
-                value: 0n,
-                callData: delegateInterface.encodeFunctionData('executeBuy', [
-                    routerAddress, WOKB_ADDRESS, tokenAddress, fee, amount
-                ]),
-            };
-        }
-    }
-}
-function buildSellCallWithAmountInternal(wallet, amount, tokenAddress, tradeType, routerAddress, fee, delegateInterface, portalInterface) {
-    switch (tradeType) {
-        case 'FLAP': {
-            // ✅ 使用 swapExactInput 卖出（与 AA 模式保持一致）
-            const portalCallData = portalInterface.encodeFunctionData('swapExactInput', [{
-                    inputToken: tokenAddress,
-                    outputToken: ethers.ZeroAddress, // 0x0 = OKB
-                    inputAmount: amount,
-                    minOutputAmount: 0n,
-                    permitData: '0x',
-                }]);
-            const batchCalls = [{ target: FLAP_PORTAL_ADDRESS, value: 0n, data: portalCallData }];
-            return {
-                target: wallet.address,
-                allowFailure: false,
-                value: 0n,
-                callData: delegateInterface.encodeFunctionData('executeBatch', [batchCalls]),
-            };
-        }
-        case 'V2': {
-            const path = [tokenAddress, WOKB_ADDRESS];
-            return {
-                target: wallet.address,
-                allowFailure: false,
-                value: 0n,
-                // ✅ 修复：传入实际数量，避免卖出全部
-                callData: delegateInterface.encodeFunctionData('executeSellV2', [routerAddress, path, amount]),
-            };
-        }
-        case 'V3': {
-            return {
-                target: wallet.address,
-                allowFailure: false,
-                value: 0n,
-                // ✅ 修复：传入实际数量，避免卖出全部
-                callData: delegateInterface.encodeFunctionData('executeSell', [
-                    routerAddress, tokenAddress, WOKB_ADDRESS, fee, amount
-                ]),
-            };
-        }
-    }
-}