four-flap-meme-sdk 1.7.82 → 1.7.83

package/dist/bsc/bundle-merkle/config.d.ts

@@ -0,0 +1,87 @@
+/**
+ * BSC Bundle Merkle 配置
+ * - 贿赂交易
+ * - 利润多跳
+ * - Gas 配置
+ */
+/** BSC 链 ID */
+export declare const BSC_CHAIN_ID = 56;
+/** BSC 链名称 */
+export declare const BSC_CHAIN_NAME = "BSC";
+/** BlockRazor Builder EOA 地址（用于 BSC 链贿赂） */
+export declare const BLOCKRAZOR_BUILDER_EOA = "0x1266C6bE60392A8Ff346E8d5ECCd3E69dD9c5F20";
+/** 利润多跳次数（固定 2 跳中转） */
+export declare const PROFIT_HOP_COUNT = 2;
+/** 最低利润（Wei）：报价成功但金额过低时的阈值 */
+export declare const MIN_PROFIT_WEI = 10000000000n;
+/** 原生代币转账 Gas Limit */
+export declare const NATIVE_TRANSFER_GAS_LIMIT = 21000n;
+/** 利润多跳 Gas Limit */
+export declare const PROFIT_HOP_GAS_LIMIT = 21055n;
+/** ERC20 转账 Gas Limit（多跳场景） */
+export declare const ERC20_TRANSFER_GAS_LIMIT = 65000n;
+/** 贿赂交易 Gas Limit */
+export declare const BRIBE_GAS_LIMIT = 21000n;
+/** BSC 配置接口 */
+export interface BscBundleConfig {
+    /** RPC URL */
+    rpcUrl: string;
+    /** 链 ID（默认 56） */
+    chainId?: number;
+    /** 交易类型（0: legacy, 2: EIP-1559） */
+    txType?: 0 | 2;
+    /** Gas 价格配置 */
+    gasPriceConfig?: {
+        type?: 'auto' | 'fast' | 'instant';
+        multiplier?: number;
+    };
+    /** 贿赂金额（BNB） */
+    bribeAmount?: number;
+    /** 是否提取利润 */
+    extractProfit?: boolean;
+    /** 利润接收地址 */
+    profitRecipient?: string;
+    /** Gas Limit */
+    gasLimit?: number;
+    /** 是否使用 21000 作为原生代币 Gas Limit */
+    prefer21000ForNative?: boolean;
+    /** 检查 BNB 余额（ERC20 无多跳时） */
+    checkBnbForErc20NoHop?: boolean;
+}
+/** 池子类型 */
+export type TokenPoolType = 'v2' | 'v3' | 'four' | 'flap';
+/** 报价代币类型 */
+export type QuoteTokenType = 'native' | 'usdt' | 'usdc';
+/** 用户类型（影响利润率） */
+export type UserType = 'v0' | 'v1';
+/**
+ * 判断是否为 BSC 链
+ */
+export declare function isBscChain(chainId?: number): boolean;
+/**
+ * 从配置中读取贿赂金额，转换为 Wei
+ */
+export declare function getBribeAmount(config?: BscBundleConfig): bigint;
+/**
+ * 判断是否需要贿赂交易
+ */
+export declare function needsBribeTx(config?: BscBundleConfig, chainId?: number): boolean;
+/**
+ * 获取交易类型
+ */
+export declare function getTxType(config?: BscBundleConfig): number;
+/**
+ * 获取 Gas 价格配置
+ */
+export declare function getGasPriceConfig(config?: BscBundleConfig): {
+    type?: "auto" | "fast" | "instant";
+    multiplier?: number;
+};
+/**
+ * 判断是否提取利润
+ */
+export declare function shouldExtractProfit(config?: BscBundleConfig): boolean;
+/**
+ * 获取利润接收地址
+ */
+export declare function getProfitRecipient(config?: BscBundleConfig): string;

package/dist/bsc/bundle-merkle/config.js

@@ -0,0 +1,75 @@
+/**
+ * BSC Bundle Merkle 配置
+ * - 贿赂交易
+ * - 利润多跳
+ * - Gas 配置
+ */
+import { ethers } from 'ethers';
+// ==================== BSC 链常量 ====================
+/** BSC 链 ID */
+export const BSC_CHAIN_ID = 56;
+/** BSC 链名称 */
+export const BSC_CHAIN_NAME = 'BSC';
+/** BlockRazor Builder EOA 地址（用于 BSC 链贿赂） */
+export const BLOCKRAZOR_BUILDER_EOA = '0x1266C6bE60392A8Ff346E8d5ECCd3E69dD9c5F20';
+/** 利润多跳次数（固定 2 跳中转） */
+export const PROFIT_HOP_COUNT = 2;
+/** 最低利润（Wei）：报价成功但金额过低时的阈值 */
+export const MIN_PROFIT_WEI = 10000000000n; // 0.00000001 BNB
+// ==================== Gas 配置 ====================
+/** 原生代币转账 Gas Limit */
+export const NATIVE_TRANSFER_GAS_LIMIT = 21000n;
+/** 利润多跳 Gas Limit */
+export const PROFIT_HOP_GAS_LIMIT = 21055n;
+/** ERC20 转账 Gas Limit（多跳场景） */
+export const ERC20_TRANSFER_GAS_LIMIT = 65000n;
+/** 贿赂交易 Gas Limit */
+export const BRIBE_GAS_LIMIT = 21000n;
+// ==================== 工具函数 ====================
+/**
+ * 判断是否为 BSC 链
+ */
+export function isBscChain(chainId) {
+    return chainId === BSC_CHAIN_ID;
+}
+/**
+ * 从配置中读取贿赂金额，转换为 Wei
+ */
+export function getBribeAmount(config) {
+    if (!config || !config.bribeAmount || config.bribeAmount <= 0) {
+        return 0n;
+    }
+    return ethers.parseEther(String(config.bribeAmount));
+}
+/**
+ * 判断是否需要贿赂交易
+ */
+export function needsBribeTx(config, chainId) {
+    return isBscChain(chainId) && getBribeAmount(config) > 0n;
+}
+/**
+ * 获取交易类型
+ */
+export function getTxType(config) {
+    return config?.txType ?? 0; // BSC 默认使用 legacy 交易
+}
+/**
+ * 获取 Gas 价格配置
+ */
+export function getGasPriceConfig(config) {
+    return config?.gasPriceConfig ?? { type: 'auto', multiplier: 1.0 };
+}
+/**
+ * 判断是否提取利润
+ */
+export function shouldExtractProfit(config) {
+    return config?.extractProfit !== false; // 默认提取
+}
+/**
+ * 获取利润接收地址
+ */
+export function getProfitRecipient(config) {
+    // 默认利润地址
+    const DEFAULT_PROFIT_RECIPIENT = '0x0000000000000000000000000000000000000000'; // TODO: 设置真实地址
+    return config?.profitRecipient ?? DEFAULT_PROFIT_RECIPIENT;
+}

package/dist/bsc/bundle-merkle/disperse.d.ts

@@ -0,0 +1,19 @@
+/**
+ * BSC 分发模块 - 完全独立实现
+ *
+ * 特点：
+ * - ✅ 支持贿赂交易（BlockRazor）
+ * - ✅ 支持利润多跳
+ * - ✅ 支持原生币和 ERC20
+ * - ✅ 支持转账多跳
+ */
+import type { BscDisperseParams, BscSignedResult } from './types.js';
+/**
+ * BSC 分发（完全独立实现）
+ */
+export declare function bscDisperse(params: BscDisperseParams): Promise<BscSignedResult>;
+export declare function bscDisperseERC20(params: Omit<BscDisperseParams, 'tokenAddress'> & {
+    tokenAddress: string;
+}): Promise<BscSignedResult>;
+export declare function bscDisperseBNB(params: Omit<BscDisperseParams, 'tokenAddress' | 'tokenDecimals'>): Promise<BscSignedResult>;
+export type { BscDisperseParams, BscSignedResult } from './types.js';

package/dist/bsc/bundle-merkle/disperse.js

@@ -0,0 +1,408 @@
+/**
+ * BSC 分发模块 - 完全独立实现
+ *
+ * 特点：
+ * - ✅ 支持贿赂交易（BlockRazor）
+ * - ✅ 支持利润多跳
+ * - ✅ 支持原生币和 ERC20
+ * - ✅ 支持转账多跳
+ */
+import { ethers, Wallet, JsonRpcProvider } from 'ethers';
+import { getOptimizedGasPrice, NonceManager, buildProfitHopTransactions, PROFIT_HOP_COUNT } from '../../utils/bundle-helpers.js';
+import { PROFIT_CONFIG, ADDRESSES } from '../../utils/constants.js';
+import { getErc20DecimalsMerkle, generateHopWallets, normalizeAmounts, calculateGasLimit, isNativeTokenAddress, } from '../../contracts/tm-bundle-merkle/internal.js';
+import { quoteV2, quoteV3 } from '../../utils/quote-helpers.js';
+import { BSC_CHAIN_ID, BLOCKRAZOR_BUILDER_EOA, MIN_PROFIT_WEI, BRIBE_GAS_LIMIT, getBribeAmount, getTxType, shouldExtractProfit, getProfitRecipient, } from './config.js';
+// ==================== ERC20 → BNB 报价 ====================
+async function getTokenToNativeQuote(provider, tokenAddress, tokenAmount, _chainId, tokenPoolType, _quoteToken, _rpcUrl) {
+    if (tokenAmount <= 0n)
+        return 0n;
+    try {
+        const wbnb = ADDRESSES.BSC.WBNB;
+        const version = tokenPoolType === 'v3' ? 'v3' : 'v2';
+        let result;
+        if (version === 'v3') {
+            result = await quoteV3(provider, tokenAddress, wbnb, tokenAmount, 'BSC');
+        }
+        else {
+            result = await quoteV2(provider, tokenAddress, wbnb, tokenAmount, 'BSC');
+        }
+        console.log(`[getTokenToNativeQuote] ${version} 报价成功: ${result.amountOut} wei`);
+        return result.amountOut;
+    }
+    catch (error) {
+        console.warn(`[getTokenToNativeQuote] 报价失败:`, error);
+        return 0n;
+    }
+}
+function getProfitRateBps(userType) {
+    if (userType === 'v1')
+        return PROFIT_CONFIG.RATE_BPS_V1_DOUBLE;
+    return PROFIT_CONFIG.RATE_BPS_V0_DOUBLE;
+}
+function calculateProfit(amount, userType) {
+    const rateBps = getProfitRateBps(userType);
+    const profit = (amount * BigInt(rateBps)) / 10000n;
+    const remaining = amount - profit;
+    return { profit, remaining };
+}
+// ==================== 主函数 ====================
+/**
+ * BSC 分发（完全独立实现）
+ */
+export async function bscDisperse(params) {
+    const { fromPrivateKey, recipients: inputRecipients, amount, amounts, tokenAddress, tokenDecimals, hopCount = 0, hopPrivateKeys, items, config, startNonce, tokenPoolType = 'v2', quoteToken = 'native', userType = 'v0', } = params;
+    // ==================== 参数处理 ====================
+    // 声明式输入转换
+    const recipients = items ? items.map(i => i.to) : inputRecipients;
+    const normalizedAmounts = items
+        ? items.map(i => (typeof i.amount === 'bigint' ? i.amount.toString() : String(i.amount)))
+        : normalizeAmounts(recipients, amount, amounts);
+    // 初始化
+    const chainIdNum = BSC_CHAIN_ID;
+    const provider = new JsonRpcProvider(config.rpcUrl, { chainId: chainIdNum, name: 'BSC' });
+    const mainWallet = new Wallet(fromPrivateKey, provider);
+    const txType = getTxType(config);
+    const isNative = isNativeTokenAddress(tokenAddress);
+    // 多跳钱包处理
+    const providedHops = hopPrivateKeys?.every(h => h.length === 0) ? null : hopPrivateKeys ?? null;
+    const itemHops = items?.map(i => i.hopPrivateKeys ?? []);
+    const itemHopsNull = itemHops?.every(h => h.length === 0) ? null : itemHops;
+    const hopCountInput = items ? items.map(i => i.hopCount ?? 0) : hopCount;
+    const preparedHops = providedHops ?? itemHopsNull ?? generateHopWallets(recipients.length, hopCountInput);
+    const hasHops = preparedHops !== null;
+    const maxHopCount = hasHops ? Math.max(...preparedHops.map(h => h.length)) : 0;
+    // Gas 配置
+    const finalGasLimit = calculateGasLimit(config, isNative, hasHops, maxHopCount);
+    const nativeGasLimit = config.prefer21000ForNative ? 21000n : finalGasLimit;
+    // 利润和贿赂配置
+    const extractProfit = shouldExtractProfit(config);
+    const bribeAmount = getBribeAmount(config);
+    const needBribeTx = bribeAmount > 0n;
+    // 结果数组
+    const signedTxs = [];
+    let totalProfit = 0n;
+    let totalAmountBeforeProfit = 0n;
+    let profitHopWallets;
+    const nonceManager = new NonceManager(provider);
+    // ==================== 无多跳场景 ====================
+    if (!preparedHops) {
+        const extraTxCount = (extractProfit ? 1 : 0) + (needBribeTx ? 1 : 0);
+        const totalTxCount = recipients.length + extraTxCount;
+        const [gasPrice, nonces] = await Promise.all([
+            getOptimizedGasPrice(provider),
+            startNonce !== undefined
+                ? Promise.resolve(Array.from({ length: totalTxCount }, (_, i) => startNonce + i))
+                : nonceManager.getNextNonceBatch(mainWallet, totalTxCount)
+        ]);
+        let nonceOffset = 0;
+        // ✅ 贿赂交易（放在最前面）
+        if (needBribeTx) {
+            const bribeTx = await mainWallet.signTransaction({
+                to: BLOCKRAZOR_BUILDER_EOA,
+                value: bribeAmount,
+                nonce: nonces[nonceOffset++],
+                gasPrice,
+                gasLimit: BRIBE_GAS_LIMIT,
+                chainId: chainIdNum,
+                type: txType
+            });
+            signedTxs.push(bribeTx);
+            console.log(`[bscDisperse] 贿赂交易已添加: ${ethers.formatEther(bribeAmount)} BNB`);
+        }
+        if (isNative) {
+            // ✅ 原生币分发
+            const txDataList = recipients.map((to, i) => {
+                const originalAmount = ethers.parseEther(normalizedAmounts[i]);
+                totalAmountBeforeProfit += originalAmount;
+                let actualAmount = originalAmount;
+                if (extractProfit) {
+                    const { profit, remaining } = calculateProfit(originalAmount, userType);
+                    actualAmount = remaining;
+                    totalProfit += profit;
+                }
+                return { to, value: actualAmount, nonce: nonces[nonceOffset + i] };
+            });
+            const txPromises = txDataList.map(({ to, value, nonce }) => mainWallet.signTransaction({
+                to,
+                value,
+                nonce,
+                gasPrice,
+                gasLimit: nativeGasLimit,
+                chainId: chainIdNum,
+                type: txType
+            }));
+            signedTxs.push(...(await Promise.all(txPromises)));
+            // ✅ 利润多跳
+            if (extractProfit && totalProfit > 0n) {
+                const profitHopResult = await buildProfitHopTransactions({
+                    provider,
+                    payerWallet: mainWallet,
+                    profitAmount: totalProfit,
+                    profitRecipient: getProfitRecipient(config),
+                    hopCount: PROFIT_HOP_COUNT,
+                    gasPrice,
+                    chainId: chainIdNum,
+                    txType,
+                    startNonce: nonces[nonceOffset + recipients.length]
+                });
+                signedTxs.push(...profitHopResult.signedTransactions);
+                profitHopWallets = profitHopResult.hopWallets;
+                console.log(`[bscDisperse] 利润多跳已添加: ${ethers.formatEther(totalProfit)} BNB`);
+            }
+        }
+        else {
+            // ✅ ERC20 分发
+            const decimals = tokenDecimals ?? await getErc20DecimalsMerkle(provider, tokenAddress, chainIdNum);
+            const iface = new ethers.Interface(['function transfer(address,uint256) returns (bool)']);
+            const originalAmounts = [];
+            let totalTokenProfit = 0n;
+            for (let i = 0; i < recipients.length; i++) {
+                const originalAmount = ethers.parseUnits(normalizedAmounts[i], decimals);
+                originalAmounts.push(originalAmount);
+                totalAmountBeforeProfit += originalAmount;
+                if (extractProfit) {
+                    const { profit } = calculateProfit(originalAmount, userType);
+                    totalTokenProfit += profit;
+                }
+            }
+            // ✅ ERC20 → BNB 报价
+            let nativeProfitAmount = 0n;
+            let profitIsNative = false;
+            if (extractProfit && totalTokenProfit > 0n) {
+                nativeProfitAmount = await getTokenToNativeQuote(provider, tokenAddress, totalTokenProfit, chainIdNum, tokenPoolType, quoteToken, config.rpcUrl);
+                profitIsNative = nativeProfitAmount > MIN_PROFIT_WEI;
+                if (profitIsNative) {
+                    totalProfit = nativeProfitAmount;
+                    console.log(`[bscDisperse ERC20] 报价成功，以 BNB 扣除利润: ${ethers.formatEther(nativeProfitAmount)} BNB`);
+                }
+                else {
+                    console.log(`[bscDisperse ERC20] 报价失败或过低，以 ERC20 扣除利润: ${ethers.formatUnits(totalTokenProfit, decimals)} Token`);
+                }
+            }
+            const txDataList = recipients.map((to, i) => {
+                const originalAmount = originalAmounts[i];
+                let actualAmount = originalAmount;
+                if (extractProfit && !profitIsNative) {
+                    const { remaining } = calculateProfit(originalAmount, userType);
+                    actualAmount = remaining;
+                }
+                const data = iface.encodeFunctionData('transfer', [to, actualAmount]);
+                return { data, nonce: nonces[nonceOffset + i] };
+            });
+            const txPromises = txDataList.map(({ data, nonce }) => mainWallet.signTransaction({
+                to: tokenAddress,
+                data,
+                value: 0n,
+                nonce,
+                gasPrice,
+                gasLimit: finalGasLimit,
+                chainId: chainIdNum,
+                type: txType
+            }));
+            signedTxs.push(...(await Promise.all(txPromises)));
+            // ✅ 利润多跳（仅报价成功时）
+            if (extractProfit && profitIsNative && nativeProfitAmount > 0n) {
+                const profitHopResult = await buildProfitHopTransactions({
+                    provider,
+                    payerWallet: mainWallet,
+                    profitAmount: nativeProfitAmount,
+                    profitRecipient: getProfitRecipient(config),
+                    hopCount: PROFIT_HOP_COUNT,
+                    gasPrice,
+                    chainId: chainIdNum,
+                    txType,
+                    startNonce: nonces[nonceOffset + recipients.length]
+                });
+                signedTxs.push(...profitHopResult.signedTransactions);
+                profitHopWallets = profitHopResult.hopWallets;
+                console.log(`[bscDisperse ERC20] 利润多跳已添加: ${ethers.formatEther(nativeProfitAmount)} BNB`);
+            }
+        }
+    }
+    else {
+        // ==================== 有多跳场景 ====================
+        const [gasPrice, decimals] = await Promise.all([
+            getOptimizedGasPrice(provider),
+            isNative ? Promise.resolve(18) : Promise.resolve(tokenDecimals ?? await getErc20DecimalsMerkle(provider, tokenAddress, chainIdNum))
+        ]);
+        const iface = isNative ? null : new ethers.Interface(['function transfer(address,uint256) returns (bool)']);
+        const nativeTransferGasLimit = 21000n;
+        const erc20TransferGasLimit = 65000n;
+        const nativeHopGasFee = nativeTransferGasLimit * gasPrice;
+        const erc20HopGasFee = erc20TransferGasLimit * gasPrice;
+        const nativeHopGasFeeForErc20 = nativeTransferGasLimit * gasPrice;
+        // 计算主钱包需要的 nonce 数量
+        let mainWalletNonceCount = needBribeTx ? 1 : 0;
+        for (let i = 0; i < recipients.length; i++) {
+            const hopChain = preparedHops[i];
+            if (hopChain.length === 0) {
+                mainWalletNonceCount += 1;
+            }
+            else {
+                mainWalletNonceCount += isNative ? 1 : 2;
+            }
+        }
+        if (extractProfit)
+            mainWalletNonceCount += 1;
+        const allMainNonces = startNonce !== undefined
+            ? Array.from({ length: mainWalletNonceCount }, (_, i) => startNonce + i)
+            : await nonceManager.getNextNonceBatch(mainWallet, mainWalletNonceCount);
+        let mainNonceIdx = 0;
+        // ✅ 贿赂交易（放在最前面）
+        if (needBribeTx) {
+            const bribeTx = await mainWallet.signTransaction({
+                to: BLOCKRAZOR_BUILDER_EOA,
+                value: bribeAmount,
+                nonce: allMainNonces[mainNonceIdx++],
+                gasPrice,
+                gasLimit: BRIBE_GAS_LIMIT,
+                chainId: chainIdNum,
+                type: txType
+            });
+            signedTxs.push(bribeTx);
+            console.log(`[bscDisperse with hops] 贿赂交易已添加: ${ethers.formatEther(bribeAmount)} BNB`);
+        }
+        const txsToSign = [];
+        let totalTokenProfit = 0n;
+        for (let i = 0; i < recipients.length; i++) {
+            const finalRecipient = recipients[i];
+            const originalAmountWei = isNative
+                ? ethers.parseEther(normalizedAmounts[i])
+                : ethers.parseUnits(normalizedAmounts[i], decimals);
+            totalAmountBeforeProfit += originalAmountWei;
+            let amountWei = originalAmountWei;
+            if (extractProfit) {
+                const { profit, remaining } = calculateProfit(originalAmountWei, userType);
+                amountWei = remaining;
+                if (isNative) {
+                    totalProfit += profit;
+                }
+                else {
+                    totalTokenProfit += profit;
+                }
+            }
+            const hopChain = preparedHops[i];
+            if (hopChain.length === 0) {
+                const nonce = allMainNonces[mainNonceIdx++];
+                if (isNative) {
+                    txsToSign.push({
+                        wallet: mainWallet,
+                        tx: { to: finalRecipient, value: amountWei, nonce, gasPrice, gasLimit: nativeGasLimit, chainId: chainIdNum, type: txType }
+                    });
+                }
+                else {
+                    const data = iface.encodeFunctionData('transfer', [finalRecipient, amountWei]);
+                    txsToSign.push({
+                        wallet: mainWallet,
+                        tx: { to: tokenAddress, data, value: 0n, nonce, gasPrice, gasLimit: finalGasLimit, chainId: chainIdNum, type: txType }
+                    });
+                }
+                continue;
+            }
+            // 有多跳的情况
+            const hopWallets = hopChain.map(h => new Wallet(typeof h === 'string' ? h : h.privateKey, provider));
+            const fullChain = [mainWallet, ...hopWallets];
+            const addresses = [...fullChain.map(w => w.address), finalRecipient];
+            if (isNative) {
+                const mainNonce = allMainNonces[mainNonceIdx++];
+                for (let j = 0; j < addresses.length - 1; j++) {
+                    const fromWallet = fullChain[j];
+                    const toAddress = addresses[j + 1];
+                    const nonce = j === 0 ? mainNonce : 0;
+                    const remainingHops = addresses.length - 2 - j;
+                    const additionalGas = nativeHopGasFee * BigInt(remainingHops);
+                    const transferValue = amountWei + additionalGas;
+                    txsToSign.push({
+                        wallet: fromWallet,
+                        tx: { to: toAddress, value: transferValue, nonce, gasPrice, gasLimit: nativeTransferGasLimit, chainId: chainIdNum, type: txType }
+                    });
+                }
+            }
+            else {
+                // ERC20 多跳: 主钱包需要 2 个 nonce（转 gas + 转 ERC20）
+                const mainGasNonce = allMainNonces[mainNonceIdx++];
+                const mainErc20Nonce = allMainNonces[mainNonceIdx++];
+                const hop1 = hopWallets[0];
+                const totalGasNeeded = (nativeHopGasFeeForErc20 + erc20HopGasFee) * BigInt(hopWallets.length);
+                txsToSign.push({
+                    wallet: mainWallet,
+                    tx: { to: hop1.address, value: totalGasNeeded, nonce: mainGasNonce, gasPrice, gasLimit: nativeTransferGasLimit, chainId: chainIdNum, type: txType }
+                });
+                const erc20Data = iface.encodeFunctionData('transfer', [hop1.address, amountWei]);
+                txsToSign.push({
+                    wallet: mainWallet,
+                    tx: { to: tokenAddress, data: erc20Data, value: 0n, nonce: mainErc20Nonce, gasPrice, gasLimit: erc20TransferGasLimit, chainId: chainIdNum, type: txType }
+                });
+                for (let j = 0; j < hopWallets.length; j++) {
+                    const fromWallet = hopWallets[j];
+                    const toAddress = j === hopWallets.length - 1 ? finalRecipient : hopWallets[j + 1].address;
+                    const remainingHops = hopWallets.length - 1 - j;
+                    if (remainingHops > 0) {
+                        const gasToForward = (nativeHopGasFeeForErc20 + erc20HopGasFee) * BigInt(remainingHops);
+                        txsToSign.push({
+                            wallet: fromWallet,
+                            tx: { to: toAddress, value: gasToForward, nonce: 0, gasPrice, gasLimit: nativeTransferGasLimit, chainId: chainIdNum, type: txType }
+                        });
+                    }
+                    const erc20DataHop = iface.encodeFunctionData('transfer', [toAddress, amountWei]);
+                    txsToSign.push({
+                        wallet: fromWallet,
+                        tx: { to: tokenAddress, data: erc20DataHop, value: 0n, nonce: remainingHops > 0 ? 1 : 0, gasPrice, gasLimit: erc20TransferGasLimit, chainId: chainIdNum, type: txType }
+                    });
+                }
+            }
+        }
+        // 签名所有交易
+        const signedTransfers = await Promise.all(txsToSign.map(({ wallet, tx }) => wallet.signTransaction(tx)));
+        signedTxs.push(...signedTransfers);
+        // ✅ ERC20 多跳利润处理
+        if (!isNative && extractProfit && totalTokenProfit > 0n) {
+            const nativeProfitAmount = await getTokenToNativeQuote(provider, tokenAddress, totalTokenProfit, chainIdNum, tokenPoolType, quoteToken, config.rpcUrl);
+            if (nativeProfitAmount > MIN_PROFIT_WEI) {
+                totalProfit = nativeProfitAmount;
+            }
+        }
+        // ✅ 利润多跳
+        if (extractProfit && totalProfit > 0n) {
+            const profitNonce = allMainNonces[mainNonceIdx++];
+            const profitHopResult = await buildProfitHopTransactions({
+                provider,
+                payerWallet: mainWallet,
+                profitAmount: totalProfit,
+                profitRecipient: getProfitRecipient(config),
+                hopCount: PROFIT_HOP_COUNT,
+                gasPrice,
+                chainId: chainIdNum,
+                txType,
+                startNonce: profitNonce
+            });
+            signedTxs.push(...profitHopResult.signedTransactions);
+            profitHopWallets = profitHopResult.hopWallets;
+            console.log(`[bscDisperse with hops] 利润多跳已添加: ${ethers.formatEther(totalProfit)} BNB`);
+        }
+    }
+    // ==================== 返回结果 ====================
+    return {
+        signedTransactions: signedTxs,
+        hopWallets: preparedHops || undefined,
+        profitHopWallets,
+        metadata: extractProfit ? {
+            totalAmount: ethers.formatEther(totalAmountBeforeProfit),
+            profitAmount: ethers.formatEther(totalProfit),
+            profitRecipient: getProfitRecipient(config),
+            recipientCount: recipients.length,
+            isNative,
+            tokenAddress: isNative ? undefined : tokenAddress,
+            hasBribeTx: needBribeTx,
+            bribeAmount: needBribeTx ? ethers.formatEther(bribeAmount) : undefined
+        } : undefined
+    };
+}
+// ==================== 便捷函数 ====================
+export async function bscDisperseERC20(params) {
+    return bscDisperse(params);
+}
+export async function bscDisperseBNB(params) {
+    return bscDisperse({ ...params, tokenAddress: undefined });
+}

package/dist/bsc/bundle-merkle/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * BSC Bundle Merkle 模块入口
+ *
+ * 提供 BSC 链上的分发、归集、多对多转账功能
+ * 支持贿赂交易和利润多跳
+ */
+export { bscDisperse, bscDisperseERC20, bscDisperseBNB, } from './disperse.js';
+export { bscSweep, bscSweepERC20, bscSweepBNB, } from './sweep.js';
+export { bscPairwiseTransfer, bscPairwiseTransferERC20, bscPairwiseTransferBNB, } from './pairwise.js';
+export { BSC_CHAIN_ID, BSC_CHAIN_NAME, BLOCKRAZOR_BUILDER_EOA, PROFIT_HOP_COUNT, MIN_PROFIT_WEI, NATIVE_TRANSFER_GAS_LIMIT, PROFIT_HOP_GAS_LIMIT, ERC20_TRANSFER_GAS_LIMIT, BRIBE_GAS_LIMIT, isBscChain, getBribeAmount, needsBribeTx, getTxType, getGasPriceConfig, shouldExtractProfit, getProfitRecipient, } from './config.js';
+export type { BscBundleConfig, TokenPoolType, QuoteTokenType, UserType, } from './config.js';
+export type { AmountLike, BscSignedResult, BscDisperseParams, BscSweepParams, BscPairwiseParams, } from './types.js';

package/dist/bsc/bundle-merkle/index.js

@@ -0,0 +1,14 @@
+/**
+ * BSC Bundle Merkle 模块入口
+ *
+ * 提供 BSC 链上的分发、归集、多对多转账功能
+ * 支持贿赂交易和利润多跳
+ */
+// ==================== 分发 ====================
+export { bscDisperse, bscDisperseERC20, bscDisperseBNB, } from './disperse.js';
+// ==================== 归集 ====================
+export { bscSweep, bscSweepERC20, bscSweepBNB, } from './sweep.js';
+// ==================== 多对多 ====================
+export { bscPairwiseTransfer, bscPairwiseTransferERC20, bscPairwiseTransferBNB, } from './pairwise.js';
+// ==================== 配置 ====================
+export { BSC_CHAIN_ID, BSC_CHAIN_NAME, BLOCKRAZOR_BUILDER_EOA, PROFIT_HOP_COUNT, MIN_PROFIT_WEI, NATIVE_TRANSFER_GAS_LIMIT, PROFIT_HOP_GAS_LIMIT, ERC20_TRANSFER_GAS_LIMIT, BRIBE_GAS_LIMIT, isBscChain, getBribeAmount, needsBribeTx, getTxType, getGasPriceConfig, shouldExtractProfit, getProfitRecipient, } from './config.js';

package/dist/bsc/bundle-merkle/pairwise.d.ts

@@ -0,0 +1,19 @@
+/**
+ * BSC 多对多转账模块 - 完全独立实现
+ *
+ * 特点：
+ * - ✅ 支持贿赂交易（由第一个 sender 支付）
+ * - ✅ 支持利润多跳
+ * - ✅ 支持原生币和 ERC20
+ * - ✅ 支持转账多跳
+ */
+import type { BscPairwiseParams, BscSignedResult } from './types.js';
+/**
+ * BSC 多对多转账（完全独立实现）
+ */
+export declare function bscPairwiseTransfer(params: BscPairwiseParams): Promise<BscSignedResult>;
+export declare function bscPairwiseTransferERC20(params: Omit<BscPairwiseParams, 'tokenAddress'> & {
+    tokenAddress: string;
+}): Promise<BscSignedResult>;
+export declare function bscPairwiseTransferBNB(params: Omit<BscPairwiseParams, 'tokenAddress' | 'tokenDecimals'>): Promise<BscSignedResult>;
+export type { BscPairwiseParams } from './types.js';