four-flap-meme-sdk 3.0.0 → 4.0.0

package/dist/domains/flap/portal-bundle-merkle/utils/sweep.js

@@ -0,0 +1,570 @@
+import { ethers, Wallet } from 'ethers';
+import { getOptimizedGasPrice, NonceManager, buildProfitHopTransactions, PROFIT_HOP_COUNT, } from '../../../../utils/bundle-helpers.js';
+import { GAS_LIMITS, calculateTransferFee } from '../../../../core/constants/index.js';
+import { CHAIN_ID_MAP, getTxType, getGasPriceConfig, shouldExtractProfit, getProfitRecipient } from '../config.js';
+import { batchGetBalances, calculateGasLimit, generateHopWallets, getErc20Decimals, isNativeTokenAddress, } from '../../../../bundle/internal.js';
+import { createSignProvider, resolveHopCountInput, resolveProvidedHops, } from '../../../../bundle/sign-context-helpers.js';
+/**
+ * Flap Protocol: 归集（仅签名版本）
+ * ✅ 支持利润提取（按地址数量收取固定费用）
+ * ✅ 查询余额最大的钱包支付利润
+ * ✅ 支持多跳
+ * ✅ 支持 Multicall3 批量获取余额
+ */
+export async function flapSweepWithBundleMerkle(params) {
+    const { chain, sourcePrivateKeys, target, 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 = CHAIN_ID_MAP[chain] ?? 56;
+    const provider = createSignProvider(config.rpcUrl, chainIdNum, chain);
+    const isNative = isNativeTokenAddress(tokenAddress);
+    const txType = getTxType(config);
+    const clamp = (n) => typeof n === 'number' && Number.isFinite(n) ? Math.max(0, Math.min(100, Math.floor(n))) : undefined;
+    const ratio = clamp(ratioPct);
+    const actualKeys = (() => {
+        if (sources && sources.length > 0)
+            return sources.map((s) => s.privateKey);
+        return sourcePrivateKeys;
+    })();
+    const providedHops = resolveProvidedHops(actualKeys.length, hopPrivateKeys, sources);
+    const hopCountInput = resolveHopCountInput(actualKeys.length, hopCount, sources);
+    const preparedHops = providedHops ?? generateHopWallets(actualKeys.length, hopCountInput);
+    const hasHops = preparedHops !== null;
+    const maxHopCount = preparedHops ? Math.max(...preparedHops.map((h) => h.length)) : 0;
+    const finalGasLimit = calculateGasLimit(config, isNative, hasHops, maxHopCount);
+    const nativeGasLimit = GAS_LIMITS.BRIBE;
+    const signedTxs = [];
+    const extractProfit = shouldExtractProfit();
+    const profitAddr = getProfitRecipient();
+    let totalProfit = 0n;
+    let totalAmountBeforeProfit = 0n;
+    let profitHopWallets; // ✅ 收集利润多跳钱包
+    if (!preparedHops) {
+        // ========== 无多跳：直接批量归集 ==========
+        const wallets = actualKeys.map((pk) => new Wallet(pk, provider));
+        const addresses = wallets.map((w) => w.address);
+        const nonceManager = new NonceManager(provider);
+        // ✅ 按地址数量收取固定费用（原生代币）
+        if (extractProfit) {
+            totalProfit = calculateTransferFee(chainIdNum, wallets.length);
+        }
+        if (isNative) {
+            const [gasPrice, balances] = await Promise.all([
+                getOptimizedGasPrice(provider, getGasPriceConfig(config)),
+                batchGetBalances(provider, addresses),
+            ]);
+            const gasCostBase = nativeGasLimit * gasPrice;
+            const profitTxGas = GAS_LIMITS.NATIVE_TRANSFER * 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;
+                })();
+                const gasCost = gasCostBase;
+                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;
+                }
+            }
+            // 检查支付者余额是否足够支付利润
+            if (extractProfit && totalProfit > 0n && maxSweepIndex >= 0) {
+                const payerBalance = balances[maxSweepIndex];
+                const payerSweepAmount = sweepAmounts[maxSweepIndex];
+                const payerNeedGas = gasCostBase + profitTxGas;
+                if (payerBalance < payerSweepAmount + payerNeedGas + totalProfit) {
+                    // 余额不足支付利润，减少归集金额
+                    const maxPayerSweep = payerBalance > payerNeedGas + totalProfit ? payerBalance - payerNeedGas - totalProfit : 0n;
+                    sweepAmounts[maxSweepIndex] = maxPayerSweep;
+                    totalAmountBeforeProfit = sweepAmounts.reduce((sum, amt) => sum + amt, 0n);
+                }
+            }
+            // 第二步：生成归集交易
+            let payerProfitNonce;
+            if (extractProfit && totalProfit > 0n && maxSweepIndex >= 0) {
+                const payerWallet = wallets[maxSweepIndex];
+                const nonces = await nonceManager.getNextNonceBatch(payerWallet, 2);
+                payerProfitNonce = nonces[1];
+            }
+            const walletsToSweep = wallets.filter((_, i) => sweepAmounts[i] > 0n && 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;
+                // ✅ 全额归集，不从转账金额中扣除利润
+                let nonce;
+                if (i === maxSweepIndex && payerProfitNonce !== undefined) {
+                    nonce = payerProfitNonce - 1;
+                }
+                else {
+                    nonce = nonces[nonceIdx++];
+                }
+                const mainTx = await w.signTransaction({
+                    to: target,
+                    value: toSend,
+                    nonce,
+                    gasPrice,
+                    gasLimit: nativeGasLimit,
+                    chainId: chainIdNum,
+                    type: txType,
+                });
+                return mainTx;
+            });
+            const allTxs = (await Promise.all(txPromises)).filter((tx) => tx !== null);
+            signedTxs.push(...allTxs);
+            // ✅ 利润多跳转账（固定费用，原生代币）
+            if (extractProfit && totalProfit > 0n && maxSweepIndex >= 0 && payerProfitNonce !== undefined) {
+                const payerWallet = wallets[maxSweepIndex];
+                const profitHopResult = await buildProfitHopTransactions({
+                    provider,
+                    payerWallet,
+                    profitAmount: totalProfit,
+                    profitRecipient: profitAddr,
+                    hopCount: PROFIT_HOP_COUNT,
+                    gasPrice,
+                    chainId: chainIdNum,
+                    txType,
+                    startNonce: payerProfitNonce,
+                });
+                signedTxs.push(...profitHopResult.signedTransactions);
+                profitHopWallets = profitHopResult.hopWallets;
+            }
+        }
+        else {
+            // ERC20 归集
+            const [gasPrice, decimals, balances, nativeBalances] = await Promise.all([
+                getOptimizedGasPrice(provider, getGasPriceConfig(config)),
+                Promise.resolve(tokenDecimals ?? (await getErc20Decimals(provider, tokenAddress))),
+                batchGetBalances(provider, addresses, tokenAddress),
+                batchGetBalances(provider, addresses),
+            ]);
+            const iface = new ethers.Interface(['function transfer(address,uint256) returns (bool)']);
+            const profitTxGas = GAS_LIMITS.NATIVE_TRANSFER * 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;
+                }
+                const totalGasNeeded = finalGasLimit * gasPrice;
+                const nativeBal = nativeBalances[i] ?? 0n;
+                if (skipIfInsufficient && nativeBal < totalGasNeeded) {
+                    sweepAmounts.push(0n);
+                    continue;
+                }
+                sweepAmounts.push(toSend);
+                totalAmountBeforeProfit += toSend;
+                // ✅ 找出原生代币余额最大的钱包作为利润支付者
+                if (nativeBal > maxSweepAmount) {
+                    maxSweepAmount = nativeBal;
+                    maxSweepIndex = i;
+                }
+            }
+            // 检查支付者原生代币余额是否足够支付固定费用
+            if (extractProfit && totalProfit > 0n && maxSweepIndex >= 0) {
+                const payerNativeBalance = nativeBalances[maxSweepIndex] ?? 0n;
+                const payerNeedGas = finalGasLimit * gasPrice + profitTxGas + totalProfit;
+                if (payerNativeBalance < payerNeedGas) {
+                    // 余额不足，跳过利润收取
+                    totalProfit = 0n;
+                }
+            }
+            let payerProfitNonce;
+            if (extractProfit && totalProfit > 0n && maxSweepIndex >= 0) {
+                const payerWallet = wallets[maxSweepIndex];
+                const nonces = await nonceManager.getNextNonceBatch(payerWallet, 2);
+                payerProfitNonce = nonces[1];
+            }
+            const walletsToSweepErc20 = wallets.filter((_, i) => sweepAmounts[i] > 0n && 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;
+                let nonce;
+                if (i === maxSweepIndex && payerProfitNonce !== undefined) {
+                    nonce = payerProfitNonce - 1;
+                }
+                else {
+                    nonce = noncesErc20[nonceIdxErc20++];
+                }
+                // ✅ 全额归集 ERC20，不从转账金额中扣除利润
+                const data = iface.encodeFunctionData('transfer', [target, toSend]);
+                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);
+            // ✅ 利润多跳转账（固定费用，原生代币）
+            if (extractProfit && totalProfit > 0n && maxSweepIndex >= 0 && payerProfitNonce !== undefined) {
+                const payerWallet = wallets[maxSweepIndex];
+                const profitHopResult = await buildProfitHopTransactions({
+                    provider,
+                    payerWallet,
+                    profitAmount: totalProfit,
+                    profitRecipient: profitAddr,
+                    hopCount: PROFIT_HOP_COUNT,
+                    gasPrice,
+                    chainId: chainIdNum,
+                    txType,
+                    startNonce: payerProfitNonce,
+                });
+                signedTxs.push(...profitHopResult.signedTransactions);
+                profitHopWallets = profitHopResult.hopWallets;
+            }
+        }
+    }
+    else {
+        // ========== 有多跳：构建跳转链归集 ==========
+        const sourceWallets = actualKeys.map((pk) => new Wallet(pk, provider));
+        // ✅ 按地址数量收取固定费用（原生代币）
+        if (extractProfit) {
+            totalProfit = calculateTransferFee(chainIdNum, sourceWallets.length);
+        }
+        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);
+        const [gasPrice, decimals, balances, nativeBalances] = await Promise.all([
+            getOptimizedGasPrice(provider, getGasPriceConfig(config)),
+            isNative
+                ? Promise.resolve(18)
+                : Promise.resolve(tokenDecimals ?? (await getErc20Decimals(provider, tokenAddress))),
+            batchGetBalances(provider, sourceAddresses, tokenAddress),
+            isNative ? Promise.resolve([]) : batchGetBalances(provider, sourceAddresses),
+        ]);
+        const iface = isNative ? null : new ethers.Interface(['function transfer(address,uint256) returns (bool)']);
+        const gasFeePerHop = finalGasLimit * gasPrice;
+        const nonceManager = new NonceManager(provider);
+        const sweepAmounts = new Array(sourceWallets.length).fill(0n);
+        // 处理无跳转的地址
+        for (const i of withoutHopIndexes) {
+            const sourceWallet = sourceWallets[i];
+            const bal = balances[i];
+            let toSend = 0n;
+            if (isNative) {
+                const gasCost = nativeGasLimit * gasPrice;
+                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) {
+                    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;
+                }
+                if (toSend > 0n) {
+                    sweepAmounts[i] = toSend;
+                    totalAmountBeforeProfit += toSend;
+                    const nonce = await nonceManager.getNextNonce(sourceWallet);
+                    const tx = await sourceWallet.signTransaction({
+                        to: target,
+                        value: toSend,
+                        nonce,
+                        gasPrice,
+                        gasLimit: nativeGasLimit,
+                        chainId: chainIdNum,
+                        type: txType,
+                    });
+                    signedTxs.push(tx);
+                }
+            }
+            else {
+                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[i] = toSend;
+                    totalAmountBeforeProfit += toSend;
+                    const nonce = await nonceManager.getNextNonce(sourceWallet);
+                    const data = iface.encodeFunctionData('transfer', [target, toSend]);
+                    const tx = await sourceWallet.signTransaction({
+                        to: tokenAddress,
+                        data,
+                        value: 0n,
+                        nonce,
+                        gasPrice,
+                        gasLimit: finalGasLimit,
+                        chainId: chainIdNum,
+                        type: txType,
+                    });
+                    signedTxs.push(tx);
+                }
+            }
+        }
+        // 处理有跳转的地址
+        for (const i of withHopIndexes) {
+            const sourceWallet = sourceWallets[i];
+            const hopChain = preparedHops[i];
+            let toSend = 0n;
+            const bal = balances[i];
+            if (isNative) {
+                const totalGasCost = finalGasLimit * gasPrice * BigInt(hopChain.length + 1);
+                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) {
+                    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 nativeBal = nativeBalances[i];
+                const nativeNeeded = gasFeePerHop * BigInt(hopChain.length) + finalGasLimit * gasPrice;
+                if (nativeBal < nativeNeeded && skipIfInsufficient)
+                    continue;
+                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 (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];
+            if (!isNative) {
+                const gasNonces = await nonceManager.getNextNonceBatch(sourceWallet, hopChain.length);
+                for (let j = 0; j < hopChain.length; j++) {
+                    const tx = await sourceWallet.signTransaction({
+                        to: fullChain[j + 1].address,
+                        value: gasFeePerHop,
+                        nonce: gasNonces[j],
+                        gasPrice,
+                        gasLimit: nativeGasLimit,
+                        chainId: chainIdNum,
+                        type: txType,
+                    });
+                    signedTxs.push(tx);
+                }
+            }
+            for (let j = 0; j < addresses.length - 1; j++) {
+                const fromWallet = fullChain[j];
+                const toAddress = addresses[j + 1];
+                const nonce = j === 0 ? await nonceManager.getNextNonce(sourceWallet) : 0;
+                if (isNative) {
+                    const remainingHops = addresses.length - 2 - j;
+                    const additionalGas = gasFeePerHop * BigInt(remainingHops);
+                    const valueToTransfer = toSend + additionalGas;
+                    const tx = await fromWallet.signTransaction({
+                        to: toAddress,
+                        value: valueToTransfer,
+                        nonce,
+                        gasPrice,
+                        gasLimit: finalGasLimit,
+                        chainId: chainIdNum,
+                        type: txType,
+                    });
+                    signedTxs.push(tx);
+                }
+                else {
+                    const data = iface.encodeFunctionData('transfer', [toAddress, toSend]);
+                    const tx = await fromWallet.signTransaction({
+                        to: tokenAddress,
+                        data,
+                        value: 0n,
+                        nonce,
+                        gasPrice,
+                        gasLimit: finalGasLimit,
+                        chainId: chainIdNum,
+                        type: txType,
+                    });
+                    signedTxs.push(tx);
+                }
+            }
+        }
+        // ✅ 利润多跳转账（固定费用，原生代币）- totalProfit 已在函数开头计算
+        if (extractProfit && totalProfit > 0n && totalAmountBeforeProfit > 0n) {
+            // 找出余额最大的钱包作为利润支付者
+            let maxSweepIndex = -1;
+            let maxSweepAmount = 0n;
+            for (let i = 0; i < sweepAmounts.length; i++) {
+                if (sweepAmounts[i] > maxSweepAmount) {
+                    maxSweepAmount = sweepAmounts[i];
+                    maxSweepIndex = i;
+                }
+            }
+            if (maxSweepIndex >= 0) {
+                const payerWallet = sourceWallets[maxSweepIndex];
+                const profitNonce = await nonceManager.getNextNonce(payerWallet);
+                const profitHopResult = await buildProfitHopTransactions({
+                    provider,
+                    payerWallet,
+                    profitAmount: totalProfit,
+                    profitRecipient: profitAddr,
+                    hopCount: PROFIT_HOP_COUNT,
+                    gasPrice,
+                    chainId: chainIdNum,
+                    txType,
+                    startNonce: profitNonce,
+                });
+                signedTxs.push(...profitHopResult.signedTransactions);
+                profitHopWallets = profitHopResult.hopWallets;
+            }
+        }
+    }
+    return {
+        signedTransactions: signedTxs,
+        hopWallets: preparedHops || undefined,
+        profitHopWallets, // ✅ 返回利润多跳钱包
+        metadata: extractProfit
+            ? {
+                totalAmount: isNative
+                    ? ethers.formatEther(totalAmountBeforeProfit)
+                    : ethers.formatUnits(totalAmountBeforeProfit, tokenDecimals ?? 18),
+                profitAmount: ethers.formatEther(totalProfit),
+                profitRecipient: profitAddr,
+                sourceCount: actualKeys.length,
+                isNative,
+                tokenAddress: isNative ? undefined : tokenAddress,
+            }
+            : undefined,
+    };
+}

package/dist/domains/flap/portal-bundle-merkle/utils.d.ts

@@ -1,10 +1,7 @@
-import type { FlapDisperseMerkleResult, FlapDisperseSignParams, FlapSweepMerkleResult, FlapSweepSignParams } from './types.js';
-export declare function flapDisperseWithBundleMerkle(params: FlapDisperseSignParams): Promise<FlapDisperseMerkleResult>;
 /**
- * Flap Protocol: 归集（仅签名版本）
- * ✅ 支持利润提取（按地址数量收取固定费用）
- * ✅ 查询余额最大的钱包支付利润
- * ✅ 支持多跳
- * ✅ 支持 Multicall3 批量获取余额
+ * Flap Protocol 分散 / 归集（Merkle Bundle）
+ *
+ * 原超长文件按职责拆分为 utils/ 目录下的多个子文件，
+ * 对外 export 符号与路径保持不变（见 utils/index.ts）。
  */
-export declare function flapSweepWithBundleMerkle(params: FlapSweepSignParams): Promise<FlapSweepMerkleResult>;
+export * from './utils/index.js';