four-flap-meme-sdk 2.2.2 → 2.2.4

package/dist/bundle-core/four-meme/utils-disperse.d.ts

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

package/dist/bundle-core/four-meme/utils-disperse.js

@@ -0,0 +1,396 @@
+import { ethers, Wallet } from 'ethers';
+import { getOptimizedGasPrice, NonceManager, buildProfitHopTransactions, PROFIT_HOP_COUNT, } from '../../utils/bundle-helpers.js';
+import { calculateTransferFee } from '../../shared/constants/index.js';
+import { getGasPriceConfig, shouldExtractProfit, getProfitRecipient, getBribeAmount } from '../config-helpers.js';
+import { getErc20Decimals as _getErc20Decimals, generateHopWallets as _generateHopWallets, normalizeAmounts as _normalizeAmounts, calculateGasLimit as _calculateGasLimit, isNativeTokenAddress as _isNativeTokenAddress, } from '../internal.js';
+import { normalizeItemsOrRecipientsAmounts, resolveHopCountInput, resolveProvidedHops, resolveSignContext, signBribeTransaction, } from '../sign-context-helpers.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, provider, mainWallet, txType } = resolveSignContext(config, fromPrivateKey);
+    const isNative = _isNativeTokenAddress(tokenAddress);
+    // ✅ 优化：预处理数据（不需要 RPC）
+    const normalizedAmounts = normalizeItemsOrRecipientsAmounts(recipients, items, amount, amounts, _normalizeAmounts);
+    const providedHops = resolveProvidedHops(recipients.length, hopPrivateKeys, items);
+    const hopCountInput = resolveHopCountInput(recipients.length, hopCount, items);
+    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) ? 21000n : finalGasLimit;
+    const signedTxs = [];
+    const extractProfit = shouldExtractProfit();
+    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 === 56 ? 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) {
+            signedTxs.push(await signBribeTransaction(mainWallet, bribeAmount, nonces[nonceOffset++], gasPrice, chainIdNum, txType));
+        }
+        // ✅ 按地址数量收取固定费用（不受转账金额和中转次数影响）
+        if (extractProfit) {
+            totalProfit = calculateTransferFee(chainIdNum, recipients.length);
+        }
+        if (isNative) {
+            // ✅ 原生币：全额转账（不扣利润），再并行签名
+            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: BigInt(chainIdNum),
+                type: txType,
+            }));
+            signedTxs.push(...(await Promise.all(txPromises)));
+        }
+        else {
+            // ✅ ERC20：全额转账（费用以原生币单独收取）
+            const decimals = tokenDecimals ?? (await _getErc20Decimals(provider, tokenAddress, chainIdNum));
+            const iface = new ethers.Interface(['function transfer(address,uint256) returns (bool)']);
+            const txDataList = recipients.map((to, i) => {
+                const originalAmount = ethers.parseUnits(normalizedAmounts[i], decimals);
+                totalAmountBeforeProfit += originalAmount;
+                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: BigInt(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 {
+        // ========== 有多跳：构建跳转链 ==========
+        // ✅ BSC 链贿赂支持
+        const bribeAmountHop = chainIdNum === 56 ? 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 _getErc20Decimals(provider, tokenAddress, chainIdNum))),
+        ]);
+        const iface = isNative ? null : new ethers.Interface(['function transfer(address,uint256) returns (bool)']);
+        // ✅ Gas limit 设置
+        // - 原生代币转账：21000（固定）
+        // - ERC20 转账：65000（固定，因为 gas 波动较大，不再使用模拟预估）
+        const nativeTransferGasLimit = 21000n;
+        const erc20TransferGasLimit = 65000n;
+        // ✅ 原生代币多跳的 gas 费（每跳只需要 21000）
+        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) {
+            signedTxs.push(await signBribeTransaction(mainWallet, bribeAmountHop, allMainNonces[mainNonceIdx++], gasPrice, chainIdNum, txType));
+        }
+        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: BigInt(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: BigInt(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: BigInt(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: BigInt(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: BigInt(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: BigInt(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: BigInt(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: BigInt(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,
+    };
+}

package/dist/bundle-core/four-meme/utils-pairwise.d.ts

@@ -0,0 +1,8 @@
+import type { PairwiseTransferSignParams, PairwiseTransferMerkleResult } from './types.js';
+/**
+ * 多对多（地址一一对应）转账（仅签名版本 - 不依赖 Merkle）
+ * - 支持原生币 / ERC20
+ * - 支持多跳（逐对）
+ * - 支持利润刮取：利润由第一个 sender 支付（作为额外费用，不扣减每对转账金额）
+ */
+export declare function pairwiseTransferWithBundleMerkle(params: PairwiseTransferSignParams): Promise<PairwiseTransferMerkleResult>;