four-flap-meme-sdk 2.0.0 → 2.1.0

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

@@ -1,470 +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;
-import { getErc20DecimalsMerkle as _getErc20DecimalsMerkle, generateHopWallets as _generateHopWallets, normalizeAmounts as _normalizeAmounts, calculateGasLimit as _calculateGasLimit, isNativeTokenAddress as _isNativeTokenAddress } from './internal.js';
-// ==================== 钱包转账按地址收费 ====================
-/**
- * 分发（仅签名版本 - 不依赖 Merkle）
- * ✅ 精简版：只负责签名交易，不提交到 Merkle
- * ✅ 优化版：支持 startNonce 参数避免并行调用时的 nonce 冲突
- */
-export async function disperseWithBundleMerkle(params) {
-    const { fromPrivateKey, recipients, amount, amounts, tokenAddress, tokenDecimals, hopCount = 0, hopPrivateKeys, items, config, startNonce } = params;
-    // 快速返回空结果
-    if (!recipients || recipients.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 mainWallet = new Wallet(fromPrivateKey, provider);
-    const isNative = _isNativeTokenAddress(tokenAddress);
-    const txType = getTxType(config);
-    // ✅ 优化：预处理数据（不需要 RPC）
-    const normalizedAmounts = items && items.length > 0
-        ? items.map(it => (typeof it.amount === 'bigint' ? it.amount.toString() : String(it.amount)))
-        : _normalizeAmounts(recipients, amount, amounts);
-    const providedHops = (() => {
-        if (hopPrivateKeys && hopPrivateKeys.length > 0) {
-            if (hopPrivateKeys.length !== recipients.length) {
-                throw new Error(`hopPrivateKeys length (${hopPrivateKeys.length}) must match recipients length (${recipients.length})`);
-            }
-            return hopPrivateKeys.every(h => h.length === 0) ? null : hopPrivateKeys;
-        }
-        if (items && items.length > 0) {
-            const hops = items.map(it => it.hopPrivateKeys ?? []);
-            return hops.every(h => h.length === 0) ? null : hops;
-        }
-        return null;
-    })();
-    const hopCountInput = (() => {
-        if (items && items.length > 0) {
-            const baseArray = Array.isArray(hopCount) ? hopCount : new Array(recipients.length).fill(hopCount);
-            return items.map((it, i) => (typeof it.hopCount === 'number' ? it.hopCount : (baseArray[i] ?? 0)));
-        }
-        return hopCount;
-    })();
-    const preparedHops = providedHops ?? _generateHopWallets(recipients.length, hopCountInput);
-    const hasHops = preparedHops !== null;
-    const maxHopCount = hasHops ? Math.max(...preparedHops.map(h => h.length)) : 0;
-    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; // ✅ 收集利润多跳钱包
-    // ✅ 优化：并行获取 gasPrice 和 nonces（或使用传入的 startNonce）
-    const nonceManager = new NonceManager(provider);
-    if (!preparedHops) {
-        // ========== 无多跳：直接批量转账 ==========
-        // ✅ BSC 链贿赂支持
-        const bribeAmount = chainIdNum === CHAINS.BSC.chainId ? getBribeAmount(config) : 0n;
-        const needBribeTx = bribeAmount > 0n;
-        const extraTxCount = (extractProfit ? 1 : 0) + (needBribeTx ? 1 : 0);
-        const totalTxCount = recipients.length + extraTxCount;
-        // ✅ 优化：并行获取 gasPrice 和 nonces
-        const [gasPrice, nonces] = await Promise.all([
-            getOptimizedGasPrice(provider, getGasPriceConfig(config)),
-            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);
-        }
-        if (isNative) {
-            // ✅ 原生币：按地址数量收取固定费用，全额转账
-            if (extractProfit) {
-                totalProfit = calculateTransferFee(chainIdNum, recipients.length);
-            }
-            const txDataList = recipients.map((to, i) => {
-                const originalAmount = ethers.parseEther(normalizedAmounts[i]);
-                totalAmountBeforeProfit += originalAmount;
-                return { to, value: originalAmount, 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)));
-            // ✅ 利润多跳转账（强制 2 跳中转）
-            if (extractProfit && totalProfit > 0n) {
-                const profitHopResult = await buildProfitHopTransactions({
-                    provider,
-                    payerWallet: mainWallet,
-                    profitAmount: totalProfit,
-                    profitRecipient: profitAddr,
-                    hopCount: PROFIT_HOP_COUNT,
-                    gasPrice,
-                    chainId: chainIdNum,
-                    txType,
-                    startNonce: nonces[nonceOffset + recipients.length]
-                });
-                signedTxs.push(...profitHopResult.signedTransactions);
-                profitHopWallets = profitHopResult.hopWallets; // ✅ 收集利润多跳钱包
-            }
-        }
-        else {
-            // ✅ ERC20：并行获取 decimals（传入 chainIdNum 避免 NETWORK_ERROR）
-            const decimals = tokenDecimals ?? (await _getErc20DecimalsMerkle(provider, tokenAddress, chainIdNum));
-            const iface = new ethers.Interface(['function transfer(address,uint256) returns (bool)']);
-            // ✅ 先计算所有原始金额
-            const originalAmounts = [];
-            for (let i = 0; i < recipients.length; i++) {
-                const originalAmount = ethers.parseUnits(normalizedAmounts[i], decimals);
-                originalAmounts.push(originalAmount);
-                totalAmountBeforeProfit += originalAmount;
-            }
-            // ✅ 按地址数量收取固定费用（原生代币）
-            let nativeProfitAmount = 0n;
-            if (extractProfit) {
-                nativeProfitAmount = calculateTransferFee(chainIdNum, recipients.length);
-                totalProfit = nativeProfitAmount;
-            }
-            // ✅ ERC20 全额分发，费用以原生币单独支付
-            const txDataList = recipients.map((to, i) => {
-                const originalAmount = originalAmounts[i];
-                const data = iface.encodeFunctionData('transfer', [to, originalAmount]);
-                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)));
-            // ✅ 费用多跳转账（强制 2 跳中转）
-            if (extractProfit && nativeProfitAmount > 0n) {
-                const profitHopResult = await buildProfitHopTransactions({
-                    provider,
-                    payerWallet: mainWallet,
-                    profitAmount: nativeProfitAmount,
-                    profitRecipient: profitAddr,
-                    hopCount: PROFIT_HOP_COUNT,
-                    gasPrice,
-                    chainId: chainIdNum,
-                    txType,
-                    startNonce: nonces[nonceOffset + recipients.length]
-                });
-                signedTxs.push(...profitHopResult.signedTransactions);
-                profitHopWallets = profitHopResult.hopWallets; // ✅ 收集利润多跳钱包
-            }
-        }
-    }
-    else {
-        // ========== 有多跳：构建跳转链 ==========
-        // ✅ BSC 链贿赂支持
-        const bribeAmountHop = chainIdNum === CHAINS.BSC.chainId ? getBribeAmount(config) : 0n;
-        const needBribeTxHop = bribeAmountHop > 0n;
-        // ✅ 优化：并行获取 gasPrice 和 decimals
-        const [gasPrice, decimals] = await Promise.all([
-            getOptimizedGasPrice(provider, getGasPriceConfig(config)),
-            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)']);
-        // ✅ Gas limit 设置（与 swap.ts 保持一致）
-        // - 原生代币转账：使用 GAS_LIMITS.NATIVE_TRANSFER（固定）
-        // - ERC20 转账：使用 GAS_LIMITS.ERC20_TRANSFER（固定，因为 gas 波动较大）
-        const nativeTransferGasLimit = NATIVE_TRANSFER_GAS_LIMIT;
-        const erc20TransferGasLimit = GAS_LIMITS.ERC20_TRANSFER;
-        // ✅ 原生代币多跳的 gas 费（每跳需要 21055）
-        const nativeHopGasFee = nativeTransferGasLimit * gasPrice;
-        // ✅ ERC20 多跳时，中转钱包需要执行 2 笔交易（转 gas + 转 ERC20）
-        const erc20HopGasFee = erc20TransferGasLimit * gasPrice;
-        const nativeHopGasFeeForErc20 = nativeTransferGasLimit * gasPrice;
-        // ✅ 优化：预先计算主钱包需要的总 nonce 数量
-        // - 原生代币多跳：主钱包只需要 1 个 nonce（一笔转账包含后续所有 gas）
-        // - ERC20 多跳：主钱包需要 2 个 nonce（转 gas + 转 ERC20）
-        let mainWalletNonceCount = 0;
-        // 贿赂交易需要 1 个额外的 nonce
-        if (needBribeTxHop)
-            mainWalletNonceCount += 1;
-        for (let i = 0; i < recipients.length; i++) {
-            const hopChain = preparedHops[i];
-            if (hopChain.length === 0) {
-                // 无跳转：1 个 nonce
-                mainWalletNonceCount += 1;
-            }
-            else {
-                // 有跳转：
-                // - Native: 1（一笔转账）
-                // - ERC20: 2（转 gas + 转 ERC20）
-                mainWalletNonceCount += isNative ? 1 : 2;
-            }
-        }
-        // 利润交易需要额外 1 个 nonce
-        if (extractProfit)
-            mainWalletNonceCount += 1;
-        // ✅ 一次性获取所有主钱包的 nonces
-        const allMainNonces = startNonce !== undefined
-            ? Array.from({ length: mainWalletNonceCount }, (_, i) => startNonce + i)
-            : await nonceManager.getNextNonceBatch(mainWallet, mainWalletNonceCount);
-        let mainNonceIdx = 0;
-        // ✅ 贿赂交易放在最前面（多跳场景）
-        if (needBribeTxHop) {
-            const bribeTx = await mainWallet.signTransaction({
-                to: BLOCKRAZOR_BUILDER_EOA,
-                value: bribeAmountHop,
-                nonce: allMainNonces[mainNonceIdx++],
-                gasPrice,
-                gasLimit: BRIBE_GAS_LIMIT,
-                chainId: chainIdNum,
-                type: txType
-            });
-            signedTxs.push(bribeTx);
-        }
-        const txsToSign = [];
-        // ✅ 按地址数量收取固定费用（原生代币），不再扣除转账金额
-        if (extractProfit) {
-            totalProfit = calculateTransferFee(chainIdNum, recipients.length);
-        }
-        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;
-            const amountWei = originalAmountWei; // 全额转账
-            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;
-            }
-            // 有跳转
-            // ✅ 支持 string 和 GeneratedWallet 两种类型
-            const fullChain = [mainWallet, ...hopChain.map(w => new Wallet(typeof w === 'string' ? w : w.privateKey, provider))];
-            const addresses = [...fullChain.map(w => w.address), finalRecipient];
-            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 ? allMainNonces[mainNonceIdx++] : 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 多跳：gas 也逐层传递（保护隐私）==========
-                // 计算每个中转钱包需要的 gas（从后往前）
-                // - 最后一个中转钱包：只需要 ERC20 转账的 gas
-                // - 其他中转钱包：需要 转 gas 的 gas + 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];
-                txsToSign.push({
-                    wallet: mainWallet,
-                    tx: {
-                        to: fullChain[1].address,
-                        value: totalGasForFirstHop,
-                        nonce: allMainNonces[mainNonceIdx++],
-                        gasPrice,
-                        gasLimit: nativeTransferGasLimit,
-                        chainId: chainIdNum,
-                        type: txType
-                    }
-                });
-                // 第二步：主钱包给第一个中转钱包转 ERC20
-                const mainToFirstHopData = iface.encodeFunctionData('transfer', [fullChain[1].address, amountWei]);
-                txsToSign.push({
-                    wallet: mainWallet,
-                    tx: {
-                        to: tokenAddress,
-                        data: mainToFirstHopData,
-                        value: 0n,
-                        nonce: allMainNonces[mainNonceIdx++],
-                        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
-                        txsToSign.push({
-                            wallet: fromWallet,
-                            tx: {
-                                to: toAddress,
-                                value: gasToTransfer,
-                                nonce: 0, // 中转钱包的第一笔交易
-                                gasPrice,
-                                gasLimit: nativeTransferGasLimit,
-                                chainId: chainIdNum,
-                                type: txType
-                            }
-                        });
-                        // 再转 ERC20
-                        const erc20Data = iface.encodeFunctionData('transfer', [toAddress, amountWei]);
-                        txsToSign.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, amountWei]);
-                        txsToSign.push({
-                            wallet: fromWallet,
-                            tx: {
-                                to: tokenAddress,
-                                data: erc20Data,
-                                value: 0n,
-                                nonce: 0, // 最后一个中转钱包只有一笔交易
-                                gasPrice,
-                                gasLimit: erc20TransferGasLimit,
-                                chainId: chainIdNum,
-                                type: txType
-                            }
-                        });
-                    }
-                }
-            }
-        }
-        // ✅ 并行签名所有交易
-        const signedTxsResult = await Promise.all(txsToSign.map(({ wallet, tx }) => wallet.signTransaction(tx)));
-        signedTxs.push(...signedTxsResult);
-        // ✅ 利润多跳转账（强制 2 跳中转）
-        if (extractProfit && totalProfit > 0n) {
-            const profitNonce = allMainNonces[mainNonceIdx];
-            const profitHopResult = await buildProfitHopTransactions({
-                provider,
-                payerWallet: mainWallet,
-                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: ethers.formatEther(totalAmountBeforeProfit),
-            profitAmount: ethers.formatEther(totalProfit),
-            profitRecipient: profitAddr,
-            recipientCount: recipients.length,
-            isNative,
-            tokenAddress: isNative ? undefined : tokenAddress
-        } : undefined
-    };
-}
-/**
- * 归集（仅签名版本 - 不依赖 Merkle）
- * ✅ 精简版：只负责签名交易，不提交到 Merkle
- * ✅ 优化版：支持 startNonce 参数避免并行调用时的 nonce 冲突
- */

package/dist/chains/bsc/four/pairwise.d.ts

@@ -1,7 +0,0 @@
-import { PairwiseTransferSignParams, PairwiseTransferMerkleResult } from './types.js';
-/**
- * 分发（仅签名版本 - 不依赖 Merkle）
- * ✅ 精简版：只负责签名交易，不提交到 Merkle
- * ✅ 优化版：支持 startNonce 参数避免并行调用时的 nonce 冲突
- */
-export declare function pairwiseTransferWithBundleMerkle(params: PairwiseTransferSignParams): Promise<PairwiseTransferMerkleResult>;