four-flap-meme-sdk 2.2.19 → 3.0.0

package/dist/{contracts/tm-bundle-merkle → bundle/four-meme}/swap.js

@@ -1,139 +1,34 @@
 /**
  * Four.meme 内盘捆绑换手（Merkle Bundle）
- *
- * 功能：钱包A卖出代币 → 钱包B买入相同数量 → 原子执行
  */
 import { ethers, Contract, Wallet } from 'ethers';
+import { countSellerNonceSlots, createFourSwapGasContext, fetchFourSwapSellQuoteAndAllowance, fetchFourSwapSellQuoteAllowanceAndBalances, getFourSwapProfitRateBps, needsTmTokenApproval, planSellerNonces, quoteFourSwapSellFunds, signTmMaxApprovalTx, } from './swap-sign-helpers.js';
+import { generateDisperseHopPaths, buildNativeHopChain, NATIVE_TRANSFER_GAS_LIMIT } from './swap-hop-helpers.js';
+import { signBribeTransaction } from '../sign-context-helpers.js';
 import { calculateSellAmount } from '../../utils/swap-helpers.js';
-import { NonceManager, getOptimizedGasPrice, getGasLimit, getGasPriceConfig, getTxType, buildProfitHopTransactions, PROFIT_HOP_COUNT } from '../../utils/bundle-helpers.js';
-import { ADDRESSES, PROFIT_CONFIG, BLOCKRAZOR_BUILDER_EOA } from '../../utils/constants.js';
-/**
- * 根据 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%
-}
-import { TM_ABI, HELPER3_ABI, TM_ADDRESS } from './swap-internal.js';
-import { getBribeAmount, getProfitRecipient } from './config.js';
-import { generateWallets } from '../../utils/wallet.js';
-// ==================== 多跳转账常量 ====================
-const NATIVE_TRANSFER_GAS_LIMIT = 21055n;
-/**
- * 生成分发多跳路径
- */
-function generateDisperseHopPaths(targetAddresses, hopCount, provider) {
-    if (hopCount <= 0) {
-        return targetAddresses.map(addr => ({
-            targetAddress: addr,
-            hopWallets: [],
-            hopWalletsInfo: []
-        }));
-    }
-    return targetAddresses.map(targetAddress => {
-        const hopWalletsInfo = generateWallets(hopCount);
-        const hopWallets = hopWalletsInfo.map(w => new Wallet(w.privateKey, provider));
-        return { targetAddress, hopWallets, hopWalletsInfo };
-    });
-}
-/**
- * 构建原生代币多跳转账链
- */
-async function buildNativeHopChain(payer, path, finalAmount, gasPrice, chainId, txType, payerNonce) {
-    const signedTxs = [];
-    const hopCount = path.hopWallets.length;
-    if (hopCount === 0) {
-        const tx = {
-            to: path.targetAddress,
-            value: finalAmount,
-            nonce: payerNonce,
-            gasLimit: NATIVE_TRANSFER_GAS_LIMIT,
-            gasPrice,
-            chainId,
-            type: txType
-        };
-        signedTxs.push(await payer.signTransaction(tx));
-        return signedTxs;
-    }
-    const hopGasCost = NATIVE_TRANSFER_GAS_LIMIT * gasPrice;
-    // 计算每跳需要的金额
-    const amountsPerHop = [];
-    for (let i = 0; i < hopCount; i++) {
-        const remainingHops = hopCount - i;
-        amountsPerHop.push(finalAmount + hopGasCost * BigInt(remainingHops));
-    }
-    // payer → hop1
-    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;
-}
+import { NonceManager, getOptimizedGasPrice, getGasPriceConfig, buildProfitHopTransactions, PROFIT_HOP_COUNT, } from '../../utils/bundle-helpers.js';
+import { getBribeAmount, getProfitRecipient } from '../config-helpers.js';
+import { TM_ABI, TM_ADDRESS } from './swap-internal.js';
 /**
  * Four内盘捆绑换手
  */
 export async function fourBundleSwapMerkle(params) {
-    const { sellerPrivateKey, sellAmount, sellPercentage, buyerPrivateKey, tokenAddress, config, startNonces // ✅ 可选：前端预获取的 nonces
+    const { sellerPrivateKey, sellAmount, sellPercentage, buyerPrivateKey, tokenAddress, config, startNonces, // ✅ 可选：前端预获取的 nonces
      } = params;
-    const chainIdNum = config.chainId ?? 56;
-    const provider = new ethers.JsonRpcProvider(config.rpcUrl, {
-        chainId: chainIdNum,
-        name: 'BSC'
-    });
+    const { chainIdNum, provider, bundleConfig, finalGasLimit, txType } = createFourSwapGasContext(config);
     const seller = new Wallet(sellerPrivateKey, provider);
     const buyer = new Wallet(buyerPrivateKey, provider);
     const nonceManager = new NonceManager(provider);
-    // ✅ 创建适配的配置对象
-    const bundleConfig = {
-        minGasPriceGwei: config.minGasPriceGwei,
-        maxGasPriceGwei: config.maxGasPriceGwei,
-        gasLimit: typeof config.gasLimit === 'bigint' ? Number(config.gasLimit) : config.gasLimit,
-        gasLimitMultiplier: config.gasLimitMultiplier,
-        txType: config.txType,
-        chainId: config.chainId
-    };
-    const finalGasLimit = getGasLimit(bundleConfig);
-    const txType = getTxType(bundleConfig);
     // ✅ 优化：第一批并行 - calculateSellAmount、gasPrice
     const [sellAmountResult, gasPrice] = await Promise.all([
         calculateSellAmount(provider, tokenAddress, seller.address, sellAmount, sellPercentage),
-        getOptimizedGasPrice(provider, getGasPriceConfig(bundleConfig))
+        getOptimizedGasPrice(provider, getGasPriceConfig(bundleConfig)),
     ]);
     const { amount: sellAmountWei, decimals } = sellAmountResult;
-    // ✅ 优化：第二批并行 - sellQuote、allowance、buyerBalance
-    const helper3 = new Contract(ADDRESSES.BSC.TokenManagerHelper3, HELPER3_ABI, provider);
-    const erc20Contract = new Contract(tokenAddress, ['function allowance(address,address) view returns (uint256)'], provider);
-    const [sellQuote, currentAllowance, buyerBalance] = await Promise.all([
-        helper3.trySell(tokenAddress, sellAmountWei),
-        erc20Contract.allowance(seller.address, TM_ADDRESS),
-        provider.getBalance(buyer.address)
+    const [{ sellFunds: sellerWillGetBNB, allowance: currentAllowance }, buyerBalance] = await Promise.all([
+        fetchFourSwapSellQuoteAndAllowance(provider, tokenAddress, seller.address, sellAmountWei),
+        provider.getBalance(buyer.address),
     ]);
-    const sellerWillGetBNB = sellQuote.funds;
     const buyerFunds = sellerWillGetBNB;
     // 验证买方余额
     const reserveGas = ethers.parseEther((config.reserveGasBNB || 0.0005).toString());
@@ -144,28 +39,18 @@ export async function fourBundleSwapMerkle(params) {
             `  - 实际: ${ethers.formatEther(buyerBalance)} BNB`);
     }
     // 检查是否需要授权
-    const APPROVAL_THRESHOLD = ethers.parseUnits('1000000000', decimals);
-    const needApproval = currentAllowance < APPROVAL_THRESHOLD;
+    const needApproval = needsTmTokenApproval(currentAllowance, decimals);
     // 利润配置
     const extractProfit = true;
-    const profitRateBps = getProfitRateBps(config.userType);
-    const profitAmount = extractProfit && sellerWillGetBNB > 0n
-        ? (sellerWillGetBNB * BigInt(profitRateBps)) / 10000n
-        : 0n;
+    const profitRateBps = getFourSwapProfitRateBps(config.userType);
+    const profitAmount = extractProfit && sellerWillGetBNB > 0n ? (sellerWillGetBNB * BigInt(profitRateBps)) / 10000n : 0n;
     // ✅ 获取贿赂金额
     const bribeAmount = getBribeAmount(config);
     const needBribeTx = bribeAmount > 0n;
     // ✅ 优化：第三批并行 - 构建交易、获取 nonces
     const tmSeller = new Contract(TM_ADDRESS, TM_ABI, seller);
     const tmBuyer = new Contract(TM_ADDRESS, TM_ABI, buyer);
-    // 计算需要的 nonce 数量
-    let sellerNonceCount = 1; // 卖出交易
-    if (needBribeTx)
-        sellerNonceCount++; // 贿赂交易
-    if (needApproval)
-        sellerNonceCount++; // 授权交易
-    if (extractProfit)
-        sellerNonceCount++; // 利润交易
+    const sellerNonceCount = countSellerNonceSlots(needBribeTx, needApproval, extractProfit);
     // ✅ 优化：使用批量 nonce 获取（JSON-RPC 批量请求）
     // 如果前端传入了 startNonces，直接使用；否则从链上获取
     const [sellUnsigned, buyUnsigned, noncesResult] = await Promise.all([
@@ -183,57 +68,25 @@ export async function fourBundleSwapMerkle(params) {
             const sellerNonces = Array.from({ length: sellerNonceCount }, (_, i) => initialNonces[0] + i);
             const buyerNonce = initialNonces[1];
             return { sellerNonces, buyerNonce };
-        })()
+        })(),
     ]);
     const { sellerNonces, buyerNonce } = noncesResult;
-    // 分配 nonces
-    let idx = 0;
-    let bribeNonce;
-    let approvalNonce;
-    if (needBribeTx)
-        bribeNonce = sellerNonces[idx++];
-    if (needApproval)
-        approvalNonce = sellerNonces[idx++];
-    const sellerNonce = sellerNonces[idx++];
-    const profitNonce = extractProfit ? sellerNonces[idx] : undefined;
-    // ✅ 并行签名所有交易
+    const noncePlan = planSellerNonces(sellerNonces, needBribeTx, needApproval, extractProfit);
     const signPromises = [];
-    // ✅ 贿赂交易放在首位
-    if (needBribeTx && bribeNonce !== undefined) {
-        signPromises.push(seller.signTransaction({
-            to: BLOCKRAZOR_BUILDER_EOA,
-            value: bribeAmount,
-            nonce: bribeNonce,
-            gasPrice,
-            gasLimit: 21000n,
-            chainId: chainIdNum,
-            type: txType
-        }));
+    if (needBribeTx && noncePlan.bribeNonce !== undefined) {
+        signPromises.push(signBribeTransaction(seller, bribeAmount, noncePlan.bribeNonce, gasPrice, chainIdNum, txType));
     }
-    // 授权交易
-    if (needApproval && approvalNonce !== undefined) {
-        const approveInterface = new ethers.Interface(['function approve(address,uint256) returns (bool)']);
-        const approveData = approveInterface.encodeFunctionData('approve', [TM_ADDRESS, ethers.MaxUint256]);
-        signPromises.push(seller.signTransaction({
-            to: tokenAddress,
-            data: approveData,
-            value: 0n,
-            nonce: approvalNonce,
-            gasLimit: 80000n,
-            gasPrice,
-            chainId: chainIdNum,
-            type: txType
-        }));
+    if (needApproval && noncePlan.approvalNonce !== undefined) {
+        signPromises.push(signTmMaxApprovalTx(seller, tokenAddress, noncePlan.approvalNonce, gasPrice, chainIdNum, txType));
     }
-    // 卖出和买入交易
     signPromises.push(seller.signTransaction({
         ...sellUnsigned,
         from: seller.address,
-        nonce: sellerNonce,
+        nonce: noncePlan.sellerNonce,
         gasLimit: finalGasLimit,
         gasPrice,
         chainId: chainIdNum,
-        type: txType
+        type: txType,
     }), buyer.signTransaction({
         ...buyUnsigned,
         from: buyer.address,
@@ -242,10 +95,9 @@ export async function fourBundleSwapMerkle(params) {
         gasPrice,
         chainId: chainIdNum,
         type: txType,
-        value: buyerFunds
+        value: buyerFunds,
     }));
     const signedTxs = await Promise.all(signPromises);
-    // 解析签名结果
     let signIdx = 0;
     let bribeTx = null;
     let approvalTx = null;
@@ -254,7 +106,8 @@ export async function fourBundleSwapMerkle(params) {
     if (needApproval)
         approvalTx = signedTxs[signIdx++];
     const signedSell = signedTxs[signIdx++];
-    const signedBuy = signedTxs[signIdx++];
+    const signedBuy = signedTxs[signIdx];
+    const profitNonce = noncePlan.profitNonce;
     nonceManager.clearTemp();
     // ✅ 组装交易列表：贿赂 → 授权 → 卖出 → 买入
     const allTransactions = [];
@@ -275,7 +128,7 @@ export async function fourBundleSwapMerkle(params) {
             gasPrice,
             chainId: chainIdNum,
             txType,
-            startNonce: profitNonce
+            startNonce: profitNonce,
         });
         allTransactions.push(...profitHopResult.signedTransactions);
         profitHopWallets = profitHopResult.hopWallets; // ✅ 收集利润多跳钱包
@@ -289,18 +142,16 @@ export async function fourBundleSwapMerkle(params) {
             sellAmount: ethers.formatUnits(sellAmountWei, decimals),
             buyAmount: ethers.formatEther(buyerFunds),
             hasApproval: !!approvalTx,
-            profitAmount: extractProfit ? ethers.formatEther(profitAmount) : undefined
-        }
+            profitAmount: extractProfit ? ethers.formatEther(profitAmount) : undefined,
+        },
     };
 }
+// ==================== 批量换手（一卖多买）====================
 /**
  * Four 内盘批量换手（一卖多买）
- *
- * 功能：主钱包一次卖出 → 多个子钱包同时买入 → 在同一个区块中完成
- * 限制：最多 24 个买方（服务器限制 25 笔交易，包含 1 笔利润交易）
  */
 export async function fourBatchSwapMerkle(params) {
-    const { sellerPrivateKey, sellAmount, sellPercentage, buyerPrivateKeys, tokenAddress, config, startNonces // ✅ 可选：前端预获取的 nonces
+    const { sellerPrivateKey, sellAmount, sellPercentage, buyerPrivateKeys, tokenAddress, config, startNonces, // ✅ 可选：前端预获取的 nonces
      } = params;
     // ✅ 校验买方数量（最多 24 个）
     const MAX_BUYERS = 24;
@@ -310,45 +161,22 @@ export async function fourBatchSwapMerkle(params) {
     if (buyerPrivateKeys.length > MAX_BUYERS) {
         throw new Error(`买方钱包数量超过限制: ${buyerPrivateKeys.length} > ${MAX_BUYERS}`);
     }
-    const chainIdNum = config.chainId ?? 56;
-    const provider = new ethers.JsonRpcProvider(config.rpcUrl, {
-        chainId: chainIdNum,
-        name: 'BSC'
-    });
+    const { chainIdNum, provider, bundleConfig, finalGasLimit, txType } = createFourSwapGasContext(config);
     const seller = new Wallet(sellerPrivateKey, provider);
-    const buyers = buyerPrivateKeys.map(pk => new Wallet(pk, provider));
+    const buyers = buyerPrivateKeys.map((pk) => new Wallet(pk, provider));
     const nonceManager = new NonceManager(provider);
-    // 创建适配的配置对象
-    const bundleConfig = {
-        minGasPriceGwei: config.minGasPriceGwei,
-        maxGasPriceGwei: config.maxGasPriceGwei,
-        gasLimit: typeof config.gasLimit === 'bigint' ? Number(config.gasLimit) : config.gasLimit,
-        gasLimitMultiplier: config.gasLimitMultiplier,
-        txType: config.txType,
-        chainId: config.chainId
-    };
-    const finalGasLimit = getGasLimit(bundleConfig);
-    const txType = getTxType(bundleConfig);
     // ✅ 并行获取：卖出数量、gasPrice
     const [sellAmountResult, gasPrice] = await Promise.all([
         calculateSellAmount(provider, tokenAddress, seller.address, sellAmount, sellPercentage),
-        getOptimizedGasPrice(provider, getGasPriceConfig(bundleConfig))
+        getOptimizedGasPrice(provider, getGasPriceConfig(bundleConfig)),
     ]);
     const { amount: sellAmountWei, decimals } = sellAmountResult;
-    // ✅ 并行获取：sellQuote、allowance、所有买方余额
-    const helper3 = new Contract(ADDRESSES.BSC.TokenManagerHelper3, HELPER3_ABI, provider);
-    const erc20Contract = new Contract(tokenAddress, ['function allowance(address,address) view returns (uint256)'], provider);
-    const [sellQuote, currentAllowance, ...buyerBalances] = await Promise.all([
-        helper3.trySell(tokenAddress, sellAmountWei),
-        erc20Contract.allowance(seller.address, TM_ADDRESS),
-        ...buyers.map(buyer => provider.getBalance(buyer.address))
-    ]);
-    const totalBuyerFunds = sellQuote.funds;
+    const { sellFunds: totalBuyerFunds, allowance: currentAllowance, buyerBalances, } = await fetchFourSwapSellQuoteAllowanceAndBalances(provider, tokenAddress, seller.address, sellAmountWei, buyers.map((b) => b.address));
     // ✅ 计算每个买方的买入金额（按比例分配）
     let buyAmountsWei;
     if (params.buyerRatios && params.buyerRatios.length === buyers.length) {
         // 按比例分配
-        buyAmountsWei = params.buyerRatios.map((ratio, index) => {
+        buyAmountsWei = params.buyerRatios.map((ratio) => {
             const amount = (totalBuyerFunds * BigInt(Math.round(ratio * 10000))) / 10000n;
             return amount;
         });
@@ -367,13 +195,10 @@ export async function fourBatchSwapMerkle(params) {
         }
     });
     // 检查是否需要授权
-    const APPROVAL_THRESHOLD = ethers.parseUnits('1000000000', decimals);
-    const needApproval = currentAllowance < APPROVAL_THRESHOLD;
+    const needApproval = needsTmTokenApproval(currentAllowance, decimals);
     // 利润配置
-    const profitRateBps = getProfitRateBps(config.userType);
-    const profitAmount = totalBuyerFunds > 0n
-        ? (totalBuyerFunds * BigInt(profitRateBps)) / 10000n
-        : 0n;
+    const profitRateBps = getFourSwapProfitRateBps(config.userType);
+    const profitAmount = totalBuyerFunds > 0n ? (totalBuyerFunds * BigInt(profitRateBps)) / 10000n : 0n;
     // ✅ 获取贿赂金额
     const bribeAmount = getBribeAmount(config);
     const needBribeTx = bribeAmount > 0n;
@@ -386,17 +211,12 @@ export async function fourBatchSwapMerkle(params) {
         ...buyers.map((buyer, i) => {
             const tmBuyer = new Contract(TM_ADDRESS, TM_ABI, buyer);
             const buyAmount = buyAmountsWei[i];
-            return tmBuyer.buyTokenAMAP.populateTransaction(0n, tokenAddress, buyer.address, buyAmount, 0n, { value: buyAmount });
-        })
+            return tmBuyer.buyTokenAMAP.populateTransaction(0n, tokenAddress, buyer.address, buyAmount, 0n, {
+                value: buyAmount,
+            });
+        }),
     ]);
-    // ✅ 计算 nonce
-    // seller 需要的 nonce 数量
-    let sellerNonceCount = 1; // 卖出交易
-    if (needBribeTx)
-        sellerNonceCount++; // 贿赂交易
-    if (needApproval)
-        sellerNonceCount++; // 授权交易
-    sellerNonceCount++; // 利润交易
+    const sellerNonceCount = countSellerNonceSlots(needBribeTx, needApproval, true);
     // ✅ 如果前端传入了 startNonces，直接使用（性能优化）
     // 否则从链上获取
     const allWallets = [seller, ...buyers];
@@ -405,55 +225,24 @@ export async function fourBatchSwapMerkle(params) {
         : await nonceManager.getNextNoncesForWallets(allWallets);
     // 分配 seller nonces
     const sellerNonces = Array.from({ length: sellerNonceCount }, (_, i) => initialNonces[0] + i);
-    let idx = 0;
-    let bribeNonce;
-    let approvalNonce;
-    if (needBribeTx)
-        bribeNonce = sellerNonces[idx++];
-    if (needApproval)
-        approvalNonce = sellerNonces[idx++];
-    const sellerNonce = sellerNonces[idx++];
-    const profitNonce = sellerNonces[idx];
-    // buyer nonces
+    const noncePlan = planSellerNonces(sellerNonces, needBribeTx, needApproval, true);
+    const profitNonce = noncePlan.profitNonce;
     const buyerNonces = initialNonces.slice(1);
-    // ✅ 并行签名所有交易
     const signPromises = [];
-    // ✅ 贿赂交易放在首位
-    if (needBribeTx && bribeNonce !== undefined) {
-        signPromises.push(seller.signTransaction({
-            to: BLOCKRAZOR_BUILDER_EOA,
-            value: bribeAmount,
-            nonce: bribeNonce,
-            gasPrice,
-            gasLimit: 21000n,
-            chainId: chainIdNum,
-            type: txType
-        }));
+    if (needBribeTx && noncePlan.bribeNonce !== undefined) {
+        signPromises.push(signBribeTransaction(seller, bribeAmount, noncePlan.bribeNonce, gasPrice, chainIdNum, txType));
     }
-    // 授权交易
-    if (needApproval && approvalNonce !== undefined) {
-        const approveInterface = new ethers.Interface(['function approve(address,uint256) returns (bool)']);
-        const approveData = approveInterface.encodeFunctionData('approve', [TM_ADDRESS, ethers.MaxUint256]);
-        signPromises.push(seller.signTransaction({
-            to: tokenAddress,
-            data: approveData,
-            value: 0n,
-            nonce: approvalNonce,
-            gasLimit: 80000n,
-            gasPrice,
-            chainId: chainIdNum,
-            type: txType
-        }));
+    if (needApproval && noncePlan.approvalNonce !== undefined) {
+        signPromises.push(signTmMaxApprovalTx(seller, tokenAddress, noncePlan.approvalNonce, gasPrice, chainIdNum, txType));
     }
-    // 卖出交易
     signPromises.push(seller.signTransaction({
         ...sellUnsigned,
         from: seller.address,
-        nonce: sellerNonce,
+        nonce: noncePlan.sellerNonce,
         gasLimit: finalGasLimit,
         gasPrice,
         chainId: chainIdNum,
-        type: txType
+        type: txType,
     }));
     // 所有买入交易
     buyers.forEach((buyer, i) => {
@@ -465,7 +254,7 @@ export async function fourBatchSwapMerkle(params) {
             gasPrice,
             chainId: chainIdNum,
             type: txType,
-            value: buyAmountsWei[i]
+            value: buyAmountsWei[i],
         }));
     });
     const signedTxs = await Promise.all(signPromises);
@@ -500,7 +289,7 @@ export async function fourBatchSwapMerkle(params) {
             gasPrice,
             chainId: chainIdNum,
             txType,
-            startNonce: profitNonce
+            startNonce: profitNonce,
         });
         signedTransactions.push(...profitHopResult.signedTransactions);
         profitHopWallets = profitHopResult.hopWallets; // ✅ 收集利润多跳钱包
@@ -510,30 +299,21 @@ export async function fourBatchSwapMerkle(params) {
         profitHopWallets, // ✅ 导出利润多跳钱包
         metadata: {
             sellerAddress: seller.address,
-            buyerAddresses: buyers.map(b => b.address),
+            buyerAddresses: buyers.map((b) => b.address),
             sellAmount: ethers.formatUnits(sellAmountWei, decimals),
-            buyAmounts: buyAmountsWei.map(amt => ethers.formatEther(amt)),
+            buyAmounts: buyAmountsWei.map((amt) => ethers.formatEther(amt)),
             hasApproval: !!approvalTx,
-            profitAmount: ethers.formatEther(profitAmount)
-        }
+            profitAmount: ethers.formatEther(profitAmount),
+        },
     };
 }
+// ==================== 快捷批量换手（资金利用率模式）====================
 /**
  * Four 内盘快捷批量换手（资金利用率模式）
- *
- * 流程：[贿赂] → [卖出] → [转账多跳...] → [买入1, 买入2, ...] → [利润]
- *
- * 特点：
- * - 子钱包不需要预先有 BNB
- * - 资金来自主钱包卖出代币所得
- * - 提升资金利用率
- * - ✅ 支持转账多跳，隐藏资金流向
- *
- * 限制：根据多跳数动态计算最大买方数量
  */
 export async function fourQuickBatchSwapMerkle(params) {
     const { sellerPrivateKey, sellAmount, sellPercentage, buyerPrivateKeys, buyerRatios, buyerAmounts, tokenAddress, config, disperseHopCount = 0, // ✅ 转账多跳数（默认0=直接转账）
-    startNonces // ✅ 可选：前端预获取的 nonces
+    startNonces, // ✅ 可选：前端预获取的 nonces
      } = params;
     // ✅ 动态计算最大买方数量（根据多跳数）
     // 固定开销: 贿赂(1) + 卖出(1) + 利润多跳(PROFIT_HOP_COUNT + 1)
@@ -542,7 +322,6 @@ export async function fourQuickBatchSwapMerkle(params) {
     const maxTxs = 50 - fixedOverhead;
     let MAX_BUYERS = Math.floor(maxTxs / (disperseHopCount + 2));
     MAX_BUYERS = Math.max(1, MAX_BUYERS);
-    console.log(`[fourQuickBatchSwapMerkle] 多跳数: ${disperseHopCount}, 最大买方数: ${MAX_BUYERS}`);
     if (buyerPrivateKeys.length === 0) {
         throw new Error('至少需要一个买方钱包');
     }
@@ -559,48 +338,26 @@ export async function fourQuickBatchSwapMerkle(params) {
     if (buyerAmounts && buyerAmounts.length !== buyerPrivateKeys.length) {
         throw new Error(`buyerAmounts 长度 (${buyerAmounts.length}) 与 buyerPrivateKeys 长度 (${buyerPrivateKeys.length}) 不匹配`);
     }
-    const chainIdNum = config.chainId ?? 56;
-    const provider = new ethers.JsonRpcProvider(config.rpcUrl, {
-        chainId: chainIdNum,
-        name: 'BSC'
-    });
+    const { chainIdNum, provider, bundleConfig, finalGasLimit, txType } = createFourSwapGasContext(config);
     const seller = new Wallet(sellerPrivateKey, provider);
-    const buyers = buyerPrivateKeys.map(pk => new Wallet(pk, provider));
+    const buyers = buyerPrivateKeys.map((pk) => new Wallet(pk, provider));
     const nonceManager = new NonceManager(provider);
-    // 创建适配的配置对象
-    const bundleConfig = {
-        minGasPriceGwei: config.minGasPriceGwei,
-        maxGasPriceGwei: config.maxGasPriceGwei,
-        gasLimit: typeof config.gasLimit === 'bigint' ? Number(config.gasLimit) : config.gasLimit,
-        gasLimitMultiplier: config.gasLimitMultiplier,
-        txType: config.txType,
-        chainId: config.chainId
-    };
-    const finalGasLimit = getGasLimit(bundleConfig);
-    const txType = getTxType(bundleConfig);
     // ✅ 并行获取：卖出数量、gasPrice
     const [sellAmountResult, gasPrice] = await Promise.all([
         calculateSellAmount(provider, tokenAddress, seller.address, sellAmount, sellPercentage),
-        getOptimizedGasPrice(provider, getGasPriceConfig(bundleConfig))
+        getOptimizedGasPrice(provider, getGasPriceConfig(bundleConfig)),
     ]);
     const { amount: sellAmountWei, decimals } = sellAmountResult;
-    // ✅ 获取卖出报价
-    const helper3 = new Contract(ADDRESSES.BSC.TokenManagerHelper3, HELPER3_ABI, provider);
-    const sellQuote = await helper3.trySell(tokenAddress, sellAmountWei);
-    const estimatedBNBOut = sellQuote.funds;
-    console.log(`[fourQuickBatchSwapMerkle] 卖出数量: ${ethers.formatUnits(sellAmountWei, decimals)}`);
-    console.log(`[fourQuickBatchSwapMerkle] 预估卖出所得: ${ethers.formatEther(estimatedBNBOut)} BNB`);
+    const estimatedBNBOut = await quoteFourSwapSellFunds(provider, tokenAddress, sellAmountWei);
     // ✅ 计算利润（根据 userType 动态调整）
-    const profitRateBps = getProfitRateBps(config.userType);
-    const profitAmount = estimatedBNBOut > 0n
-        ? (estimatedBNBOut * BigInt(profitRateBps)) / 10000n
-        : 0n;
+    const profitRateBps = getFourSwapProfitRateBps(config.userType);
+    const profitAmount = estimatedBNBOut > 0n ? (estimatedBNBOut * BigInt(profitRateBps)) / 10000n : 0n;
     const distributableAmount = estimatedBNBOut - profitAmount;
     // ✅ 计算每个买方分到的金额
     let transferAmountsWei;
     if (buyerAmounts && buyerAmounts.length === buyers.length) {
         // 数量模式
-        transferAmountsWei = buyerAmounts.map(amt => ethers.parseEther(amt));
+        transferAmountsWei = buyerAmounts.map((amt) => ethers.parseEther(amt));
         const totalTransfer = transferAmountsWei.reduce((a, b) => a + b, 0n);
         if (totalTransfer > distributableAmount) {
             throw new Error(`指定的买入总金额超过可分配金额 (${ethers.formatEther(distributableAmount)} BNB)`);
@@ -608,7 +365,7 @@ export async function fourQuickBatchSwapMerkle(params) {
     }
     else if (buyerRatios && buyerRatios.length === buyers.length) {
         // 比例模式
-        transferAmountsWei = buyerRatios.map(ratio => {
+        transferAmountsWei = buyerRatios.map((ratio) => {
             return (distributableAmount * BigInt(Math.round(ratio * 10000))) / 10000n;
         });
     }
@@ -627,22 +384,12 @@ export async function fourQuickBatchSwapMerkle(params) {
     }
     // ==================== 规划 Nonce ====================
     // ✅ 如果前端传入了 startNonces，直接使用（性能优化）
-    let sellerNonce = startNonces && startNonces.length > 0
-        ? startNonces[0]
-        : await nonceManager.getNextNonce(seller);
+    let sellerNonce = startNonces && startNonces.length > 0 ? startNonces[0] : await nonceManager.getNextNonce(seller);
     // ==================== 1. 贿赂交易 ====================
     let bribeTx = null;
     if (bribeAmount > 0n) {
-        bribeTx = await seller.signTransaction({
-            to: BLOCKRAZOR_BUILDER_EOA,
-            value: bribeAmount,
-            nonce: sellerNonce++,
-            gasPrice,
-            gasLimit: 21000n,
-            chainId: chainIdNum,
-            type: txType
-        });
-        console.log(`[fourQuickBatchSwapMerkle] 贿赂交易已签名`);
+        bribeTx = await signBribeTransaction(seller, bribeAmount, sellerNonce, gasPrice, chainIdNum, txType);
+        sellerNonce++;
     }
     // ==================== 2. 卖出交易 ====================
     const tmSeller = new Contract(TM_ADDRESS, TM_ABI, seller);
@@ -654,20 +401,19 @@ export async function fourQuickBatchSwapMerkle(params) {
         gasLimit: finalGasLimit,
         gasPrice,
         chainId: chainIdNum,
-        type: txType
+        type: txType,
     });
-    console.log(`[fourQuickBatchSwapMerkle] 卖出交易已签名`);
     // ==================== 3. 转账交易（支持多跳）====================
     const reserveGas = ethers.parseEther((config.reserveGasBNB || 0.0005).toString());
     const buyerGasCost = gasPrice * finalGasLimit;
     // ✅ 生成多跳路径
-    const hopPaths = generateDisperseHopPaths(buyers.map(b => b.address), disperseHopCount, provider);
+    const hopPaths = generateDisperseHopPaths(buyers.map((b) => b.address), disperseHopCount, provider);
     // 收集所有中间钱包信息
     const allHopWallets = [];
-    hopPaths.forEach(path => {
+    hopPaths.forEach((path) => {
         allHopWallets.push(...path.hopWalletsInfo);
     });
-    let transferTxs = [];
+    let transferTxs;
     if (disperseHopCount === 0) {
         // ✅ 无多跳：直接转账
         const transferNonces = buyers.map((_, i) => sellerNonce + i);
@@ -681,7 +427,7 @@ export async function fourQuickBatchSwapMerkle(params) {
                 gasPrice,
                 gasLimit: NATIVE_TRANSFER_GAS_LIMIT,
                 chainId: chainIdNum,
-                type: txType
+                type: txType,
             });
         }));
     }
@@ -696,12 +442,11 @@ export async function fourQuickBatchSwapMerkle(params) {
         transferTxs = hopChains.flat();
         sellerNonce += buyers.length; // ✅ payer 只增加 buyers.length 个 nonce
     }
-    console.log(`[fourQuickBatchSwapMerkle] ${transferTxs.length} 笔转账交易已签名 (多跳数=${disperseHopCount})`);
     // ==================== 4. 买入交易 ====================
     // ✅ 如果前端传入了 startNonces，使用 buyer 部分（从索引 1 开始）
     const buyerNonces = startNonces && startNonces.length > 1
         ? startNonces.slice(1)
-        : await Promise.all(buyers.map(buyer => nonceManager.getNextNonce(buyer)));
+        : await Promise.all(buyers.map((buyer) => nonceManager.getNextNonce(buyer)));
     const signedBuys = await Promise.all(buyers.map(async (buyer, i) => {
         const buyAmount = transferAmountsWei[i];
         const tmBuyer = new Contract(TM_ADDRESS, TM_ABI, buyer);
@@ -714,10 +459,9 @@ export async function fourQuickBatchSwapMerkle(params) {
             gasPrice,
             chainId: chainIdNum,
             type: txType,
-            value: buyAmount
+            value: buyAmount,
         });
     }));
-    console.log(`[fourQuickBatchSwapMerkle] ${signedBuys.length} 笔买入交易已签名`);
     nonceManager.clearTemp();
     // ==================== 组装交易数组 ====================
     const signedTransactions = [];
@@ -738,29 +482,24 @@ export async function fourQuickBatchSwapMerkle(params) {
             gasPrice,
             chainId: chainIdNum,
             txType,
-            startNonce: sellerNonce++
+            startNonce: sellerNonce++,
         });
         signedTransactions.push(...profitHopResult.signedTransactions);
         profitHopWallets = profitHopResult.hopWallets; // ✅ 收集利润多跳钱包
         // 多跳交易已签名
     }
-    console.log(`[fourQuickBatchSwapMerkle] 交易组装完成: ${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),
+            buyerAddresses: buyers.map((b) => b.address),
             sellAmount: ethers.formatUnits(sellAmountWei, decimals),
             estimatedBNBOut: ethers.formatEther(estimatedBNBOut),
-            transferAmounts: transferAmountsWei.map(amt => ethers.formatEther(amt)),
+            transferAmounts: transferAmountsWei.map((amt) => ethers.formatEther(amt)),
             profitAmount: profitAmount > 0n ? ethers.formatEther(profitAmount) : undefined,
-            disperseHopCount: disperseHopCount > 0 ? disperseHopCount : undefined // ✅ 返回多跳数
-        }
+            disperseHopCount: disperseHopCount > 0 ? disperseHopCount : undefined, // ✅ 返回多跳数
+        },
     };
 }