four-flap-meme-sdk 2.0.0 → 2.2.0

package/dist/chains/bsc/four/sweep.js

@@ -1,788 +0,0 @@
-import { ethers, Wallet } from 'ethers';
-import { getOptimizedGasPrice, NonceManager, buildProfitHopTransactions, PROFIT_HOP_COUNT } from '../../../utils/bundle-helpers.js';
-import { BLOCKRAZOR_BUILDER_EOA, calculateTransferFee } from '../../../utils/constants.js';
-import { GAS_LIMITS, CHAINS } from '../../../shared/constants/index.js';
-import { getTxType, getGasPriceConfig, shouldExtractProfit, getProfitRecipient, getBribeAmount } from './config.js';
-// ==================== Gas 常量（使用统一常量） ====================
-const NATIVE_TRANSFER_GAS_LIMIT = GAS_LIMITS.NATIVE_TRANSFER;
-const BRIBE_GAS_LIMIT = GAS_LIMITS.BRIBE;
-const PROFIT_HOP_GAS_LIMIT = GAS_LIMITS.NATIVE_TRANSFER; // 利润多跳使用 NATIVE_TRANSFER
-import { getErc20DecimalsMerkle as _getErc20DecimalsMerkle, generateHopWallets as _generateHopWallets, batchGetBalances as _batchGetBalances, calculateGasLimit as _calculateGasLimit, isNativeTokenAddress as _isNativeTokenAddress } from './internal.js';
-// ==================== 钱包转账按地址收费 ====================
-/**
- * 分发（仅签名版本 - 不依赖 Merkle）
- * ✅ 精简版：只负责签名交易，不提交到 Merkle
- * ✅ 优化版：支持 startNonce 参数避免并行调用时的 nonce 冲突
- */
-export async function sweepWithBundleMerkle(params) {
-    const { sourcePrivateKeys, target, targetPrivateKey, ratioPct, ratios, amount, amounts, tokenAddress, tokenDecimals, skipIfInsufficient = true, hopCount = 0, hopPrivateKeys, sources, config } = params;
-    // 快速返回空结果
-    if (!sourcePrivateKeys || sourcePrivateKeys.length === 0) {
-        return {
-            signedTransactions: [],
-            hopWallets: undefined
-        };
-    }
-    // 初始化
-    const chainIdNum = config.chainId ?? CHAINS.BSC.chainId;
-    const chainName = chainIdNum === CHAINS.MONAD.chainId ? 'Monad' : chainIdNum === CHAINS.BSC.chainId ? 'BSC' : `Chain-${chainIdNum}`;
-    const provider = new ethers.JsonRpcProvider(config.rpcUrl, {
-        chainId: chainIdNum,
-        name: chainName
-    });
-    const isNative = _isNativeTokenAddress(tokenAddress);
-    const txType = getTxType(config);
-    // ✅ 如果提供了 targetPrivateKey，创建 targetWallet 用于支付利润
-    const targetWallet = targetPrivateKey ? new Wallet(targetPrivateKey, provider) : null;
-    // 归集比例处理
-    const clamp = (n) => (typeof n === 'number' && Number.isFinite(n)
-        ? Math.max(0, Math.min(100, Math.floor(n)))
-        : undefined);
-    const ratio = clamp(ratioPct);
-    // 生成跳转钱包
-    // 统一 sources 输入
-    const actualKeys = (() => {
-        if (sources && sources.length > 0)
-            return sources.map(s => s.privateKey);
-        return sourcePrivateKeys;
-    })();
-    // hop 私钥链优先使用传入
-    const providedHops = (() => {
-        if (hopPrivateKeys && hopPrivateKeys.length > 0) {
-            if (hopPrivateKeys.length !== actualKeys.length) {
-                throw new Error(`hopPrivateKeys length (${hopPrivateKeys.length}) must match sourcePrivateKeys length (${actualKeys.length})`);
-            }
-            return hopPrivateKeys.every(h => h.length === 0) ? null : hopPrivateKeys;
-        }
-        if (sources && sources.length > 0) {
-            const hops = sources.map(s => s.hopPrivateKeys ?? []);
-            return hops.every(h => h.length === 0) ? null : hops;
-        }
-        return null;
-    })();
-    // hop 数量数组
-    const hopCountInput = (() => {
-        if (sources && sources.length > 0) {
-            const baseArray = Array.isArray(hopCount) ? hopCount : new Array(actualKeys.length).fill(hopCount);
-            return sources.map((s, i) => (typeof s.hopCount === 'number' ? s.hopCount : (baseArray[i] ?? 0)));
-        }
-        return hopCount;
-    })();
-    const preparedHops = providedHops ?? _generateHopWallets(actualKeys.length, hopCountInput);
-    const hasHops = preparedHops !== null;
-    const maxHopCount = hasHops ? Math.max(...preparedHops.map(h => h.length)) : 0;
-    // 智能计算 Gas Limit
-    const finalGasLimit = _calculateGasLimit(config, isNative, hasHops, maxHopCount);
-    const nativeGasLimit = (config.prefer21000ForNative ?? false) ? BRIBE_GAS_LIMIT : finalGasLimit;
-    const signedTxs = [];
-    // ✅ 利润提取配置
-    const extractProfit = shouldExtractProfit(config);
-    const profitAddr = getProfitRecipient();
-    let totalProfit = 0n;
-    let totalAmountBeforeProfit = 0n;
-    let profitHopWallets; // ✅ 收集利润多跳钱包
-    // ✅ BSC 链贿赂支持（由 targetWallet 支付，如果提供了 targetPrivateKey）
-    const bribeAmount = chainIdNum === CHAINS.BSC.chainId ? getBribeAmount(config) : 0n;
-    const needBribeTx = bribeAmount > 0n && targetWallet !== null;
-    const bribeSignedTx = [];
-    // ✅ 修复 nonce 冲突：统一管理 targetWallet 的 nonce
-    // 贿赂交易和利润多跳交易都由 targetWallet 签名，需要一次性获取所有 nonce
-    let targetWalletNonceStart;
-    let targetWalletNonceUsed = 0;
-    if (targetWallet && (needBribeTx || extractProfit)) {
-        // 预先获取 targetWallet 的 pending nonce，后续按顺序使用
-        targetWalletNonceStart = await provider.getTransactionCount(targetWallet.address, 'pending');
-    }
-    // ✅ 贿赂交易放在最前面（由 targetWallet 签名）
-    if (needBribeTx && targetWallet && targetWalletNonceStart !== undefined) {
-        const bribeGasPrice = await getOptimizedGasPrice(provider, getGasPriceConfig(config));
-        const bribeNonce = targetWalletNonceStart + targetWalletNonceUsed;
-        targetWalletNonceUsed += 1; // ✅ 递增 nonce 计数
-        const bribeTx = await targetWallet.signTransaction({
-            to: BLOCKRAZOR_BUILDER_EOA,
-            value: bribeAmount,
-            nonce: bribeNonce,
-            gasPrice: bribeGasPrice,
-            gasLimit: BRIBE_GAS_LIMIT,
-            chainId: chainIdNum,
-            type: txType
-        });
-        bribeSignedTx.push(bribeTx);
-    }
-    if (!preparedHops) {
-        // ========== 无多跳：直接批量归集 ==========
-        const wallets = actualKeys.map(pk => new Wallet(pk, provider));
-        const addresses = wallets.map(w => w.address);
-        const nonceManager = new NonceManager(provider);
-        // ✅ 优化：并行获取 gasPrice 和余额
-        if (isNative) {
-            // ✅ 原生币：并行获取 gasPrice 和余额
-            const [gasPrice, balances] = await Promise.all([
-                getOptimizedGasPrice(provider, getGasPriceConfig(config)),
-                _batchGetBalances(provider, addresses)
-            ]);
-            const gasCostBase = nativeGasLimit * gasPrice;
-            // ✅ 利润多跳需要 PROFIT_HOP_COUNT + 1 笔交易的 gas（payer → hop1 → hop2 → 利润地址）
-            const profitTxGas = PROFIT_HOP_GAS_LIMIT * gasPrice * BigInt(PROFIT_HOP_COUNT + 1);
-            // ✅ 第一步：计算所有钱包的归集金额和利润，找出归集金额最大的钱包
-            const sweepAmounts = [];
-            let maxSweepIndex = -1;
-            let maxSweepAmount = 0n;
-            for (let i = 0; i < wallets.length; i++) {
-                const bal = balances[i];
-                let toSend = 0n;
-                const ratioForI = (() => {
-                    if (sources && sources[i] && sources[i].ratioPct !== undefined)
-                        return clamp(sources[i].ratioPct);
-                    if (ratios && ratios[i] !== undefined)
-                        return clamp(ratios[i]);
-                    return ratio;
-                })();
-                const amountStrForI = (() => {
-                    if (sources && sources[i] && sources[i].amount !== undefined)
-                        return String(sources[i].amount);
-                    if (amounts && amounts[i] !== undefined)
-                        return String(amounts[i]);
-                    return amount !== undefined ? String(amount) : undefined;
-                })();
-                // ✅ 只有支付者需要 2 笔交易的 gas，其他钱包只需要 1 笔
-                const gasCost = gasCostBase; // 所有钱包都只计算主转账的 gas
-                if (ratioForI !== undefined) {
-                    const want = (bal * BigInt(ratioForI)) / 100n;
-                    const maxSendable = bal > gasCost ? (bal - gasCost) : 0n;
-                    toSend = want > maxSendable ? maxSendable : want;
-                }
-                else if (amountStrForI && amountStrForI.trim().length > 0) {
-                    const amt = ethers.parseEther(amountStrForI);
-                    const need = amt + gasCost;
-                    if (!skipIfInsufficient || bal >= need)
-                        toSend = amt;
-                }
-                sweepAmounts.push(toSend);
-                totalAmountBeforeProfit += toSend;
-                // 找出归集金额最大的钱包
-                if (toSend > maxSweepAmount) {
-                    maxSweepAmount = toSend;
-                    maxSweepIndex = i;
-                }
-            }
-            // ✅ 按地址数量收取固定费用（原生代币）
-            const activeNativeAddressCount = sweepAmounts.filter(a => a > 0n).length;
-            if (extractProfit && activeNativeAddressCount > 0) {
-                totalProfit = calculateTransferFee(chainIdNum, activeNativeAddressCount);
-            }
-            // ✅ 如果需要提取费用，检查支付者是否有足够余额
-            if (extractProfit && totalProfit > 0n && maxSweepIndex >= 0) {
-                const payerBalance = balances[maxSweepIndex];
-                const payerSweepAmount = sweepAmounts[maxSweepIndex];
-                const payerNeedGas = gasCostBase + profitTxGas + totalProfit;
-                if (payerBalance < payerSweepAmount + payerNeedGas) {
-                    const maxPayerSweep = payerBalance > payerNeedGas ? payerBalance - payerNeedGas : 0n;
-                    sweepAmounts[maxSweepIndex] = maxPayerSweep;
-                    totalAmountBeforeProfit = sweepAmounts.reduce((sum, amt) => sum + amt, 0n);
-                }
-            }
-            // ✅ 第二步：生成归集交易
-            // ✅ 确定利润支付者：优先使用 targetWallet，否则使用归集金额最大的源钱包
-            const useTargetAsPayer = targetWallet !== null;
-            const profitPayerWallet = useTargetAsPayer ? targetWallet : (maxSweepIndex >= 0 ? wallets[maxSweepIndex] : null);
-            // ✅ 修复 nonce 冲突：统一管理 targetWallet 的 nonce
-            // 如果 targetWallet 作为利润支付者，使用预先获取的 nonce 起点 + 偏移量
-            let payerProfitNonce;
-            if (extractProfit && totalProfit > 0n && profitPayerWallet) {
-                if (useTargetAsPayer && targetWalletNonceStart !== undefined) {
-                    // ✅ targetWallet：使用统一管理的 nonce（贿赂交易已使用 targetWalletNonceUsed 个）
-                    payerProfitNonce = targetWalletNonceStart + targetWalletNonceUsed;
-                }
-                else {
-                    // ✅ 源钱包支付利润：使用 NonceManager 获取 2 个 nonce（归集 + 利润）
-                    const nonces = await nonceManager.getNextNonceBatch(profitPayerWallet, 2);
-                    payerProfitNonce = nonces[1];
-                }
-            }
-            // ✅ 优化：批量获取所有钱包的 nonce（JSON-RPC 批量请求）
-            // 过滤出需要归集的钱包（如果用 targetWallet 支付利润，则不排除 maxSweepIndex）
-            const walletsToSweep = wallets.filter((_, i) => sweepAmounts[i] > 0n && (useTargetAsPayer || i !== maxSweepIndex));
-            const nonces = walletsToSweep.length > 0
-                ? await nonceManager.getNextNoncesForWallets(walletsToSweep)
-                : [];
-            let nonceIdx = 0;
-            const txPromises = wallets.map(async (w, i) => {
-                const toSend = sweepAmounts[i];
-                if (toSend <= 0n)
-                    return null;
-                // ✅ 全额归集，费用由支付者额外支付原生代币
-                const actualToSend = toSend;
-                // ✅ 支付者使用预留的第一个 nonce，其他钱包使用批量获取的 nonce
-                let nonce;
-                if (!useTargetAsPayer && i === maxSweepIndex && payerProfitNonce !== undefined) {
-                    nonce = payerProfitNonce - 1; // 使用预留的第一个 nonce
-                }
-                else {
-                    nonce = nonces[nonceIdx++];
-                }
-                const mainTx = await w.signTransaction({
-                    to: target,
-                    value: actualToSend,
-                    nonce,
-                    gasPrice,
-                    gasLimit: nativeGasLimit,
-                    chainId: chainIdNum,
-                    type: txType
-                });
-                return mainTx;
-            });
-            const allTxs = (await Promise.all(txPromises)).filter(tx => tx !== null);
-            signedTxs.push(...allTxs);
-            // ✅ 第三步：利润多跳转账（强制 2 跳中转）
-            if (extractProfit && totalProfit > 0n && profitPayerWallet && payerProfitNonce !== undefined) {
-                const profitHopResult = await buildProfitHopTransactions({
-                    provider,
-                    payerWallet: profitPayerWallet,
-                    profitAmount: totalProfit,
-                    profitRecipient: profitAddr,
-                    hopCount: PROFIT_HOP_COUNT,
-                    gasPrice,
-                    chainId: chainIdNum,
-                    txType,
-                    startNonce: payerProfitNonce
-                });
-                signedTxs.push(...profitHopResult.signedTransactions);
-                profitHopWallets = profitHopResult.hopWallets; // ✅ 收集利润多跳钱包
-            }
-        }
-        else {
-            // ✅ ERC20：并行获取 gasPrice、decimals、余额（传入 chainIdNum 避免 NETWORK_ERROR）
-            const [gasPrice, decimals, balances, bnbBalances] = await Promise.all([
-                getOptimizedGasPrice(provider, getGasPriceConfig(config)),
-                Promise.resolve(tokenDecimals ?? await _getErc20DecimalsMerkle(provider, tokenAddress, chainIdNum)),
-                _batchGetBalances(provider, addresses, tokenAddress),
-                config.checkBnbForErc20NoHop ? _batchGetBalances(provider, addresses) : Promise.resolve([])
-            ]);
-            const iface = new ethers.Interface(['function transfer(address,uint256) returns (bool)']);
-            // ✅ 利润多跳需要 PROFIT_HOP_COUNT + 1 笔交易的 gas
-            const profitTxGas = PROFIT_HOP_GAS_LIMIT * gasPrice * BigInt(PROFIT_HOP_COUNT + 1);
-            // ✅ 第一步：计算所有钱包的归集金额和利润，找出归集金额最大的钱包
-            const sweepAmounts = [];
-            let maxSweepIndex = -1;
-            let maxSweepAmount = 0n;
-            for (let i = 0; i < wallets.length; i++) {
-                const bal = balances[i];
-                let toSend = 0n;
-                const ratioForI = (() => {
-                    if (sources && sources[i] && sources[i].ratioPct !== undefined)
-                        return clamp(sources[i].ratioPct);
-                    if (ratios && ratios[i] !== undefined)
-                        return clamp(ratios[i]);
-                    return ratio;
-                })();
-                const amountStrForI = (() => {
-                    if (sources && sources[i] && sources[i].amount !== undefined)
-                        return String(sources[i].amount);
-                    if (amounts && amounts[i] !== undefined)
-                        return String(amounts[i]);
-                    return amount !== undefined ? String(amount) : undefined;
-                })();
-                if (ratioForI !== undefined) {
-                    toSend = (bal * BigInt(ratioForI)) / 100n;
-                }
-                else if (amountStrForI && amountStrForI.trim().length > 0) {
-                    toSend = ethers.parseUnits(amountStrForI, decimals);
-                }
-                if (toSend <= 0n || (skipIfInsufficient && bal < toSend)) {
-                    sweepAmounts.push(0n);
-                    continue;
-                }
-                // ✅ 检查 BNB 余额（只需主转账的 gas，支付者后面单独检查）
-                const totalGasNeeded = finalGasLimit * gasPrice;
-                if (config.checkBnbForErc20NoHop) {
-                    const bnb = bnbBalances[i] ?? 0n;
-                    if (skipIfInsufficient && bnb < totalGasNeeded) {
-                        sweepAmounts.push(0n);
-                        continue;
-                    }
-                }
-                sweepAmounts.push(toSend);
-                totalAmountBeforeProfit += toSend;
-                // 找出归集金额最大的钱包
-                if (toSend > maxSweepAmount) {
-                    maxSweepAmount = toSend;
-                    maxSweepIndex = i;
-                }
-            }
-            // ✅ 按地址数量收取固定费用（原生代币支付，不受转账金额影响）
-            const activeAddressCountErc20 = sweepAmounts.filter(a => a > 0n).length;
-            let nativeProfitAmount = 0n;
-            if (extractProfit && activeAddressCountErc20 > 0) {
-                nativeProfitAmount = calculateTransferFee(chainIdNum, activeAddressCountErc20);
-                totalProfit = nativeProfitAmount;
-            }
-            // ✅ 确定费用支付者：优先使用 targetWallet，否则使用归集金额最大的源钱包
-            const useTargetAsPayerErc20 = targetWallet !== null;
-            const profitPayerWalletErc20 = useTargetAsPayerErc20 ? targetWallet : (maxSweepIndex >= 0 ? wallets[maxSweepIndex] : null);
-            // ✅ 如果需要提取费用，检查支付者是否有足够原生代币支付
-            if (extractProfit && nativeProfitAmount > 0n && profitPayerWalletErc20 && config.checkBnbForErc20NoHop) {
-                const payerBnbBalance = useTargetAsPayerErc20
-                    ? await provider.getBalance(target)
-                    : (bnbBalances[maxSweepIndex] ?? 0n);
-                const payerNeedGas = (useTargetAsPayerErc20 ? 0n : finalGasLimit * gasPrice) + profitTxGas + nativeProfitAmount;
-                if (payerBnbBalance < payerNeedGas) {
-                    nativeProfitAmount = 0n;
-                    totalProfit = 0n;
-                }
-            }
-            // ✅ 第二步：生成归集交易（ERC20 全额归集，费用以原生币单独支付）
-            let payerProfitNonce;
-            if (extractProfit && nativeProfitAmount > 0n && profitPayerWalletErc20) {
-                if (useTargetAsPayerErc20 && targetWalletNonceStart !== undefined) {
-                    payerProfitNonce = targetWalletNonceStart + targetWalletNonceUsed;
-                }
-                else {
-                    const nonces = await nonceManager.getNextNonceBatch(profitPayerWalletErc20, 2);
-                    payerProfitNonce = nonces[1];
-                }
-            }
-            // ✅ 优化：批量获取所有钱包的 nonce（JSON-RPC 批量请求）
-            // 过滤出需要归集的钱包（如果用 targetWallet 支付利润，则不排除 maxSweepIndex）
-            const walletsToSweepErc20 = wallets.filter((_, i) => sweepAmounts[i] > 0n && (useTargetAsPayerErc20 || i !== maxSweepIndex));
-            const noncesErc20 = walletsToSweepErc20.length > 0
-                ? await nonceManager.getNextNoncesForWallets(walletsToSweepErc20)
-                : [];
-            let nonceIdxErc20 = 0;
-            const txPromises = wallets.map(async (w, i) => {
-                const toSend = sweepAmounts[i];
-                if (toSend <= 0n)
-                    return null;
-                // ✅ ERC20 归集：全部归集，不扣除代币（利润从 BNB 支付）
-                const actualToSend = toSend;
-                // ✅ 支付者使用预留的第一个 nonce，其他钱包使用批量获取的 nonce
-                let nonce;
-                if (!useTargetAsPayerErc20 && i === maxSweepIndex && payerProfitNonce !== undefined) {
-                    nonce = payerProfitNonce - 1; // 使用预留的第一个 nonce
-                }
-                else {
-                    nonce = noncesErc20[nonceIdxErc20++];
-                }
-                const data = iface.encodeFunctionData('transfer', [target, actualToSend]);
-                const mainTx = await w.signTransaction({
-                    to: tokenAddress,
-                    data,
-                    value: 0n,
-                    nonce,
-                    gasPrice,
-                    gasLimit: finalGasLimit,
-                    chainId: chainIdNum,
-                    type: txType
-                });
-                return mainTx;
-            });
-            const allTxs = (await Promise.all(txPromises)).filter(tx => tx !== null);
-            signedTxs.push(...allTxs);
-            // ✅ 第三步：费用多跳转账（强制 2 跳中转）
-            if (extractProfit && nativeProfitAmount > 0n && profitPayerWalletErc20 && payerProfitNonce !== undefined) {
-                const profitHopResult = await buildProfitHopTransactions({
-                    provider,
-                    payerWallet: profitPayerWalletErc20,
-                    profitAmount: nativeProfitAmount,
-                    profitRecipient: profitAddr,
-                    hopCount: PROFIT_HOP_COUNT,
-                    gasPrice,
-                    chainId: chainIdNum,
-                    txType,
-                    startNonce: payerProfitNonce
-                });
-                signedTxs.push(...profitHopResult.signedTransactions);
-                profitHopWallets = profitHopResult.hopWallets; // ✅ 收集利润多跳钱包
-            }
-        }
-    }
-    else {
-        // ========== 有多跳：构建跳转链归集 ==========
-        // ✅ 优化版：批量计算 + 批量获取 nonce + 并行签名
-        const sourceWallets = actualKeys.map(pk => new Wallet(pk, provider));
-        const withHopIndexes = [];
-        const withoutHopIndexes = [];
-        for (let i = 0; i < preparedHops.length; i++) {
-            if (preparedHops[i].length > 0) {
-                withHopIndexes.push(i);
-            }
-            else {
-                withoutHopIndexes.push(i);
-            }
-        }
-        const sourceAddresses = sourceWallets.map(w => w.address);
-        // ✅ 优化：并行获取 gasPrice、decimals、余额
-        const [gasPrice, decimals, balances, bnbBalances] = await Promise.all([
-            getOptimizedGasPrice(provider, getGasPriceConfig(config)),
-            isNative ? Promise.resolve(18) : Promise.resolve(tokenDecimals ?? await _getErc20DecimalsMerkle(provider, tokenAddress, chainIdNum)),
-            _batchGetBalances(provider, sourceAddresses, tokenAddress),
-            isNative ? Promise.resolve([]) : _batchGetBalances(provider, sourceAddresses)
-        ]);
-        const iface = isNative ? null : new ethers.Interface(['function transfer(address,uint256) returns (bool)']);
-        // ✅ Gas limit 设置（与分散函数保持一致）
-        // - 原生代币转账：使用 GAS_LIMITS.NATIVE_TRANSFER（固定）
-        // - ERC20 转账：使用 GAS_LIMITS.ERC20_TRANSFER（固定，因为 gas 波动较大）
-        const nativeTransferGasLimit = NATIVE_TRANSFER_GAS_LIMIT;
-        const erc20TransferGasLimit = GAS_LIMITS.ERC20_TRANSFER;
-        // ✅ 原生代币多跳的 gas 费（每跳只需要 21000）
-        const nativeHopGasFee = nativeTransferGasLimit * gasPrice;
-        // ✅ ERC20 多跳时，中转钱包需要执行 2 笔交易（转 gas + 转 ERC20）
-        const erc20HopGasFee = erc20TransferGasLimit * gasPrice;
-        const nativeHopGasFeeForErc20 = nativeTransferGasLimit * gasPrice;
-        const nonceManager = new NonceManager(provider);
-        // ✅ 用于记录每个钱包的归集金额
-        const sweepAmounts = new Array(sourceWallets.length).fill(0n);
-        // ✅ 辅助函数：获取比例和金额
-        const getRatioForI = (i) => {
-            if (sources && sources[i] && sources[i].ratioPct !== undefined)
-                return clamp(sources[i].ratioPct);
-            if (ratios && ratios[i] !== undefined)
-                return clamp(ratios[i]);
-            return ratio;
-        };
-        const getAmountStrForI = (i) => {
-            if (sources && sources[i] && sources[i].amount !== undefined)
-                return String(sources[i].amount);
-            if (amounts && amounts[i] !== undefined)
-                return String(amounts[i]);
-            return amount !== undefined ? String(amount) : undefined;
-        };
-        const noHopTxDataList = [];
-        for (const i of withoutHopIndexes) {
-            const bal = balances[i];
-            let toSend = 0n;
-            const ratioForI = getRatioForI(i);
-            const amountStrForI = getAmountStrForI(i);
-            if (isNative) {
-                const gasCost = nativeGasLimit * gasPrice;
-                if (ratioForI !== undefined) {
-                    const want = (bal * BigInt(ratioForI)) / 100n;
-                    const maxSendable = bal > gasCost ? (bal - gasCost) : 0n;
-                    toSend = want > maxSendable ? maxSendable : want;
-                }
-                else if (amountStrForI && amountStrForI.trim().length > 0) {
-                    const amt = ethers.parseEther(amountStrForI);
-                    const need = amt + gasCost;
-                    if (!skipIfInsufficient || bal >= need)
-                        toSend = amt;
-                }
-            }
-            else {
-                if (ratioForI !== undefined) {
-                    toSend = (bal * BigInt(ratioForI)) / 100n;
-                }
-                else if (amountStrForI && amountStrForI.trim().length > 0) {
-                    toSend = ethers.parseUnits(amountStrForI, decimals);
-                }
-                if (skipIfInsufficient && bal < toSend)
-                    toSend = 0n;
-            }
-            if (toSend > 0n) {
-                sweepAmounts[i] = toSend;
-                totalAmountBeforeProfit += toSend;
-                noHopTxDataList.push({ index: i, wallet: sourceWallets[i], toSend });
-            }
-        }
-        // ========== 第2步：批量获取无跳转钱包的 nonces ==========
-        const noHopWallets = noHopTxDataList.map(d => d.wallet);
-        const noHopNonces = noHopWallets.length > 0
-            ? await nonceManager.getNextNoncesForWallets(noHopWallets)
-            : [];
-        // ========== 第3步：并行签名无跳转交易 ==========
-        const noHopTxPromises = noHopTxDataList.map((data, idx) => {
-            const { wallet, toSend } = data;
-            const nonce = noHopNonces[idx];
-            if (isNative) {
-                return wallet.signTransaction({
-                    to: target,
-                    value: toSend,
-                    nonce,
-                    gasPrice,
-                    gasLimit: nativeGasLimit,
-                    chainId: chainIdNum,
-                    type: txType
-                });
-            }
-            else {
-                const txData = iface.encodeFunctionData('transfer', [target, toSend]);
-                return wallet.signTransaction({
-                    to: tokenAddress,
-                    data: txData,
-                    value: 0n,
-                    nonce,
-                    gasPrice,
-                    gasLimit: finalGasLimit,
-                    chainId: chainIdNum,
-                    type: txType
-                });
-            }
-        });
-        if (noHopTxPromises.length > 0) {
-            const noHopSignedTxs = await Promise.all(noHopTxPromises);
-            signedTxs.push(...noHopSignedTxs);
-        }
-        const hopTxDataList = [];
-        for (const i of withHopIndexes) {
-            const sourceWallet = sourceWallets[i];
-            const hopChain = preparedHops[i];
-            const bal = balances[i];
-            let toSend = 0n;
-            const ratioForI = getRatioForI(i);
-            const amountStrForI = getAmountStrForI(i);
-            if (isNative) {
-                // 原生代币多跳每跳只需要 21000 gas
-                const totalGasCost = nativeTransferGasLimit * gasPrice * BigInt(hopChain.length + 1);
-                if (ratioForI !== undefined) {
-                    const want = (bal * BigInt(ratioForI)) / 100n;
-                    const maxSendable = bal > totalGasCost ? (bal - totalGasCost) : 0n;
-                    toSend = want > maxSendable ? maxSendable : want;
-                }
-                else if (amountStrForI && amountStrForI.trim().length > 0) {
-                    const amt = ethers.parseEther(amountStrForI);
-                    const need = amt + totalGasCost;
-                    if (!skipIfInsufficient || bal >= need)
-                        toSend = amt;
-                }
-            }
-            else {
-                const bnbBal = bnbBalances[i];
-                // 计算 ERC20 多跳所需的 BNB（逐层传递模式）：
-                // - 源钱包执行 2 笔交易的 gas（转 gas 21000 + 转 ERC20）
-                // - 源钱包转给第一个中转钱包的 gas（包含后续所有）
-                // 简化计算：每个中转钱包 ≈ (21000 + erc20GasLimit) * gasPrice
-                const sourceGas = (nativeTransferGasLimit + erc20TransferGasLimit) * gasPrice;
-                const hopGas = (nativeHopGasFeeForErc20 + erc20HopGasFee) * BigInt(hopChain.length);
-                const bnbNeeded = sourceGas + hopGas;
-                if (bnbBal < bnbNeeded && skipIfInsufficient)
-                    continue;
-                if (ratioForI !== undefined) {
-                    toSend = (bal * BigInt(ratioForI)) / 100n;
-                }
-                else if (amountStrForI && amountStrForI.trim().length > 0) {
-                    toSend = ethers.parseUnits(amountStrForI, decimals);
-                }
-                if (skipIfInsufficient && bal < toSend)
-                    toSend = 0n;
-            }
-            if (toSend <= 0n)
-                continue;
-            sweepAmounts[i] = toSend;
-            totalAmountBeforeProfit += toSend;
-            // ✅ 支持 string 和 GeneratedWallet 两种类型
-            const fullChain = [sourceWallet, ...hopChain.map(w => new Wallet(typeof w === 'string' ? w : w.privateKey, provider))];
-            const addresses = [...fullChain.map(w => w.address), target];
-            hopTxDataList.push({ index: i, sourceWallet, toSend, hopChain, fullChain, addresses });
-        }
-        // ========== 第5步：计算每个有跳转钱包需要的 nonce 数量并批量获取 ==========
-        // 每个源钱包需要的 nonce 数量：
-        // - Native: 1（一笔转账包含后续所有 gas）
-        // - ERC20: 2（转 gas + 转 ERC20）
-        const hopNonceNeeds = hopTxDataList.map(() => isNative ? 1 : 2);
-        const hopSourceWallets = hopTxDataList.map(d => d.sourceWallet);
-        // ✅ 批量获取所有有跳转钱包的 nonces
-        const hopNoncesFlat = [];
-        if (hopSourceWallets.length > 0) {
-            const batchNoncePromises = hopSourceWallets.map((w, idx) => nonceManager.getNextNonceBatch(w, hopNonceNeeds[idx]));
-            const batchNonces = await Promise.all(batchNoncePromises);
-            batchNonces.forEach(nonces => hopNoncesFlat.push(...nonces));
-        }
-        const hopTxsToSign = [];
-        let nonceOffset = 0;
-        for (let dataIdx = 0; dataIdx < hopTxDataList.length; dataIdx++) {
-            const { sourceWallet, toSend, hopChain, fullChain, addresses } = hopTxDataList[dataIdx];
-            const nonceCount = hopNonceNeeds[dataIdx];
-            const nonces = hopNoncesFlat.slice(nonceOffset, nonceOffset + nonceCount);
-            nonceOffset += nonceCount;
-            if (isNative) {
-                // ========== 原生代币多跳：gas 包含在转账金额中逐层传递 ==========
-                for (let j = 0; j < addresses.length - 1; j++) {
-                    const fromWallet = fullChain[j];
-                    const toAddress = addresses[j + 1];
-                    const nonce = j === 0 ? nonces[0] : 0;
-                    const remainingHops = addresses.length - 2 - j;
-                    const additionalGas = nativeHopGasFee * BigInt(remainingHops);
-                    const valueToTransfer = toSend + additionalGas;
-                    hopTxsToSign.push({
-                        wallet: fromWallet,
-                        tx: {
-                            to: toAddress,
-                            value: valueToTransfer,
-                            nonce,
-                            gasPrice,
-                            gasLimit: nativeTransferGasLimit,
-                            chainId: chainIdNum,
-                            type: txType
-                        }
-                    });
-                }
-            }
-            else {
-                // ========== ERC20 多跳：gas 也逐层传递（保护隐私）==========
-                // 计算每个中转钱包需要的 gas（从后往前）
-                const hopGasNeeds = [];
-                for (let j = hopChain.length - 1; j >= 0; j--) {
-                    if (j === hopChain.length - 1) {
-                        // 最后一个中转钱包：只需要 ERC20 转账的 gas
-                        hopGasNeeds.unshift(erc20HopGasFee);
-                    }
-                    else {
-                        // 其他中转钱包：转 gas(21000) + 转 ERC20 + 后续的 gas
-                        const nextHopGas = hopGasNeeds[0];
-                        hopGasNeeds.unshift(nativeHopGasFeeForErc20 + erc20HopGasFee + nextHopGas);
-                    }
-                }
-                // 第一步：源钱包给第一个中转钱包转 gas（包含所有后续的 gas）
-                const totalGasForFirstHop = hopGasNeeds[0];
-                hopTxsToSign.push({
-                    wallet: sourceWallet,
-                    tx: {
-                        to: fullChain[1].address,
-                        value: totalGasForFirstHop,
-                        nonce: nonces[0],
-                        gasPrice,
-                        gasLimit: nativeTransferGasLimit,
-                        chainId: chainIdNum,
-                        type: txType
-                    }
-                });
-                // 第二步：源钱包给第一个中转钱包转 ERC20
-                const sourceToFirstHopData = iface.encodeFunctionData('transfer', [fullChain[1].address, toSend]);
-                hopTxsToSign.push({
-                    wallet: sourceWallet,
-                    tx: {
-                        to: tokenAddress,
-                        data: sourceToFirstHopData,
-                        value: 0n,
-                        nonce: nonces[1],
-                        gasPrice,
-                        gasLimit: erc20TransferGasLimit,
-                        chainId: chainIdNum,
-                        type: txType
-                    }
-                });
-                // 第三步：中转钱包逐层传递（gas 和 ERC20）
-                for (let j = 1; j < fullChain.length; j++) {
-                    const fromWallet = fullChain[j];
-                    const toAddress = addresses[j + 1]; // 下一个地址（可能是中转钱包或最终目标）
-                    const isLastHop = j === fullChain.length - 1;
-                    if (!isLastHop) {
-                        // 非最后一个中转钱包：先转 gas 给下一个中转钱包
-                        const gasToTransfer = hopGasNeeds[j]; // 下一个中转钱包需要的 gas
-                        hopTxsToSign.push({
-                            wallet: fromWallet,
-                            tx: {
-                                to: toAddress,
-                                value: gasToTransfer,
-                                nonce: 0, // 中转钱包的第一笔交易
-                                gasPrice,
-                                gasLimit: nativeTransferGasLimit,
-                                chainId: chainIdNum,
-                                type: txType
-                            }
-                        });
-                        // 再转 ERC20
-                        const erc20Data = iface.encodeFunctionData('transfer', [toAddress, toSend]);
-                        hopTxsToSign.push({
-                            wallet: fromWallet,
-                            tx: {
-                                to: tokenAddress,
-                                data: erc20Data,
-                                value: 0n,
-                                nonce: 1, // 中转钱包的第二笔交易
-                                gasPrice,
-                                gasLimit: erc20TransferGasLimit,
-                                chainId: chainIdNum,
-                                type: txType
-                            }
-                        });
-                    }
-                    else {
-                        // 最后一个中转钱包：只转 ERC20 给最终目标
-                        const erc20Data = iface.encodeFunctionData('transfer', [toAddress, toSend]);
-                        hopTxsToSign.push({
-                            wallet: fromWallet,
-                            tx: {
-                                to: tokenAddress,
-                                data: erc20Data,
-                                value: 0n,
-                                nonce: 0, // 最后一个中转钱包只有一笔交易
-                                gasPrice,
-                                gasLimit: erc20TransferGasLimit,
-                                chainId: chainIdNum,
-                                type: txType
-                            }
-                        });
-                    }
-                }
-            }
-        }
-        // ✅ 并行签名所有有跳转的交易
-        if (hopTxsToSign.length > 0) {
-            const hopSignedTxs = await Promise.all(hopTxsToSign.map(({ wallet, tx }) => wallet.signTransaction(tx)));
-            signedTxs.push(...hopSignedTxs);
-        }
-        // ========== 第7步：按地址数量收取固定费用（原生代币） ==========
-        const activeHopAddressCount = sweepAmounts.filter(a => a > 0n).length;
-        if (extractProfit && activeHopAddressCount > 0) {
-            // ✅ 确定费用支付者：优先使用 targetWallet，否则使用归集金额最大的源钱包
-            let maxSweepIndex = -1;
-            let maxSweepAmount = 0n;
-            for (let i = 0; i < sweepAmounts.length; i++) {
-                if (sweepAmounts[i] > maxSweepAmount) {
-                    maxSweepAmount = sweepAmounts[i];
-                    maxSweepIndex = i;
-                }
-            }
-            const useTargetAsPayerHop = targetWallet !== null;
-            const profitPayerWalletHop = useTargetAsPayerHop ? targetWallet : (maxSweepIndex >= 0 ? sourceWallets[maxSweepIndex] : null);
-            // ✅ 按地址数量收取固定费用
-            const nativeProfitAmount = calculateTransferFee(chainIdNum, activeHopAddressCount);
-            totalProfit = nativeProfitAmount;
-            // ✅ 费用多跳转账（强制 2 跳中转）
-            if (nativeProfitAmount > 0n && profitPayerWalletHop) {
-                let profitNonce;
-                if (useTargetAsPayerHop && targetWalletNonceStart !== undefined) {
-                    profitNonce = targetWalletNonceStart + targetWalletNonceUsed;
-                }
-                else {
-                    profitNonce = await nonceManager.getNextNonce(profitPayerWalletHop);
-                }
-                const profitHopResult = await buildProfitHopTransactions({
-                    provider,
-                    payerWallet: profitPayerWalletHop,
-                    profitAmount: nativeProfitAmount,
-                    profitRecipient: profitAddr,
-                    hopCount: PROFIT_HOP_COUNT,
-                    gasPrice,
-                    chainId: chainIdNum,
-                    txType,
-                    startNonce: profitNonce
-                });
-                signedTxs.push(...profitHopResult.signedTransactions);
-                profitHopWallets = profitHopResult.hopWallets;
-            }
-        }
-    }
-    // ✅ 简化返回：贿赂交易放在最前面，然后是签名交易、多跳钱包和元数据
-    return {
-        signedTransactions: [...bribeSignedTx, ...signedTxs],
-        hopWallets: preparedHops || undefined,
-        profitHopWallets, // ✅ 返回利润多跳钱包
-        metadata: extractProfit ? {
-            totalAmount: isNative ? ethers.formatEther(totalAmountBeforeProfit) : ethers.formatUnits(totalAmountBeforeProfit, tokenDecimals ?? 18),
-            profitAmount: ethers.formatEther(totalProfit), // ✅ 利润统一用原生代币（BNB/ETH）显示
-            profitRecipient: profitAddr,
-            sourceCount: actualKeys.length,
-            isNative,
-            tokenAddress: isNative ? undefined : tokenAddress,
-            hasBribeTx: bribeSignedTx.length > 0, // ✅ 标记是否有贿赂交易
-            bribeAmount: bribeSignedTx.length > 0 ? ethers.formatEther(bribeAmount) : undefined
-        } : undefined
-    };
-}
-/**
- * 多对多（地址一一对应）转账（仅签名版本 - 不依赖 Merkle）
- * - 支持原生币 / ERC20
- * - 支持多跳（逐对）
- * - 支持利润刮取：利润由第一个 sender 支付（作为额外费用，不扣减每对转账金额）
- */