four-flap-meme-sdk 1.4.39 → 1.4.41

package/dist/utils/holders-maker.js

@@ -0,0 +1,350 @@
+/**
+ * ============================================================================
+ * 刷持有人（Holders Maker）
+ * ============================================================================
+ * 一键完成：生成钱包 → 分发资金 → 批量买入
+ * 支持原生代币（BNB/MON）和 ERC20 代币（USDT/USDC）作为购买资金
+ */
+import { JsonRpcProvider } from 'ethers';
+import { generateWallets } from './wallet.js';
+import { disperseWithBundleMerkle } from '../contracts/tm-bundle-merkle/utils.js';
+import { batchBuyWithBundleMerkle } from '../contracts/tm-bundle-merkle/core.js';
+import { approveTokenBatch } from './erc20.js';
+// ============================================================================
+// 常量
+// ============================================================================
+const DEFAULT_GAS_LIMIT = 800000;
+const DEFAULT_GAS_PRICE_GWEI = 3;
+const DEFAULT_MAX_WALLETS_PER_BATCH = 46; // 50 - 1(bribe) - 3(profit hops)
+const GAS_BUFFER_MULTIPLIER = 2; // 2倍 Gas 费安全系数
+// ============================================================================
+// 辅助函数
+// ============================================================================
+/**
+ * 分批数组
+ */
+function chunkArray(arr, size) {
+    const chunks = [];
+    for (let i = 0; i < arr.length; i += size) {
+        chunks.push(arr.slice(i, i + size));
+    }
+    return chunks;
+}
+// ============================================================================
+// 主方法
+// ============================================================================
+/**
+ * 刷持有人（一键完成）
+ *
+ * 流程：
+ * 1. 生成新钱包
+ * 2. 分发原生代币（Gas 费 + 购买金额 / 仅 Gas 费）
+ * 3. 如果使用 ERC20 基础代币，分发 ERC20 代币
+ * 4. 如果使用 ERC20 基础代币，授权
+ * 5. 批量买入目标代币
+ *
+ * @returns 包含所有阶段签名交易的结果，由前端提交
+ */
+export async function holdersMaker(params) {
+    const { payerPrivateKey, holdersCount, buyAmountPerHolder, tokenAddress, baseToken = 'native', baseTokenAddress, baseTokenDecimals = 18, config } = params;
+    const { rpcUrl, chain = 'BSC', chainId: configChainId, tradeType = 'four', gasLimit = DEFAULT_GAS_LIMIT, gasPriceGwei = DEFAULT_GAS_PRICE_GWEI, bribeAmount = 0.000001, txType = 0, maxWalletsPerBatch = DEFAULT_MAX_WALLETS_PER_BATCH, fourApiUrl, hopCount = 0 // ✅ 多跳数量，默认不多跳
+     } = config;
+    const result = {
+        success: false,
+        newWallets: [],
+        allSignedTransactions: {
+            disperseNative: [],
+            buy: []
+        },
+        hopWallets: [], // ✅ 多跳钱包
+        batchResults: [],
+        successBatchCount: 0,
+        totalBatchCount: 0
+    };
+    try {
+        // 1. 初始化 Provider
+        const provider = new JsonRpcProvider(rpcUrl);
+        const chainId = configChainId || Number((await provider.getNetwork()).chainId);
+        console.log(`[HoldersMaker] 开始刷持有人: chain=${chain}, chainId=${chainId}, holdersCount=${holdersCount}`);
+        // 2. 生成新钱包
+        const newWallets = generateWallets(holdersCount);
+        result.newWallets = newWallets;
+        console.log(`[HoldersMaker] 生成 ${newWallets.length} 个新钱包`);
+        // 3. 计算分发金额
+        const isNativeBase = baseToken === 'native';
+        const gasFeePerWallet = (gasLimit * gasPriceGwei) / 1e9; // 转为原生代币单位
+        const gasWithBuffer = gasFeePerWallet * GAS_BUFFER_MULTIPLIER;
+        // 原生代币分发金额 = Gas 费（+ 购买金额，如果是原生代币模式）
+        const nativeAmountPerWallet = isNativeBase
+            ? String(parseFloat(buyAmountPerHolder) + gasWithBuffer)
+            : String(gasWithBuffer);
+        console.log(`[HoldersMaker] 分发金额: nativePerWallet=${nativeAmountPerWallet}, isNativeBase=${isNativeBase}, hopCount=${hopCount}`);
+        // 4. 分批处理
+        const walletBatches = chunkArray(newWallets, maxWalletsPerBatch);
+        result.totalBatchCount = walletBatches.length;
+        console.log(`[HoldersMaker] 分 ${walletBatches.length} 批处理`);
+        // ============================================================
+        // ✅ 阶段1：并行生成所有批次的分发原生代币签名
+        // ============================================================
+        console.log(`[HoldersMaker] 阶段1: 并行生成 ${walletBatches.length} 批原生代币分发签名...`);
+        const disperseNativePromises = walletBatches.map(async (batch, batchIdx) => {
+            const recipients = batch.map(w => w.address);
+            try {
+                const disperseResult = await disperseWithBundleMerkle({
+                    fromPrivateKey: payerPrivateKey,
+                    recipients,
+                    amount: nativeAmountPerWallet,
+                    hopCount,
+                    config: {
+                        rpcUrl,
+                        gasLimit,
+                        minGasPriceGwei: gasPriceGwei,
+                        txType,
+                        bribeAmount
+                    }
+                });
+                return {
+                    batchIndex: batchIdx,
+                    success: true,
+                    phase: 'disperse_native',
+                    signedTransactions: disperseResult.signedTransactions,
+                    hopWallets: disperseResult.hopWallets,
+                    walletCount: recipients.length
+                };
+            }
+            catch (error) {
+                return {
+                    batchIndex: batchIdx,
+                    success: false,
+                    phase: 'disperse_native',
+                    error: error.message,
+                    walletCount: recipients.length
+                };
+            }
+        });
+        const disperseNativeResults = await Promise.all(disperseNativePromises);
+        // 处理分发原生代币结果
+        for (const res of disperseNativeResults) {
+            if (res.success && res.signedTransactions) {
+                result.allSignedTransactions.disperseNative.push(res.signedTransactions);
+                if (res.hopWallets && res.hopWallets.length > 0) {
+                    result.hopWallets.push(res.hopWallets);
+                }
+            }
+            result.batchResults.push({
+                batchIndex: res.batchIndex,
+                success: res.success,
+                phase: res.phase,
+                signedTransactions: res.signedTransactions,
+                error: res.error,
+                walletCount: res.walletCount
+            });
+        }
+        const successDisperseNative = disperseNativeResults.filter(r => r.success);
+        console.log(`[HoldersMaker] 阶段1完成: ${successDisperseNative.length}/${walletBatches.length} 批成功`);
+        // ============================================================
+        // ✅ 阶段2：如果是 ERC20，并行生成分发 ERC20 签名
+        // ============================================================
+        if (!isNativeBase && baseTokenAddress) {
+            console.log(`[HoldersMaker] 阶段2: 并行生成 ${walletBatches.length} 批 ERC20 分发签名...`);
+            const disperseErc20Promises = walletBatches.map(async (batch, batchIdx) => {
+                const recipients = batch.map(w => w.address);
+                try {
+                    const disperseResult = await disperseWithBundleMerkle({
+                        fromPrivateKey: payerPrivateKey,
+                        recipients,
+                        amount: buyAmountPerHolder,
+                        tokenAddress: baseTokenAddress,
+                        tokenDecimals: baseTokenDecimals,
+                        hopCount,
+                        config: {
+                            rpcUrl,
+                            gasLimit,
+                            minGasPriceGwei: gasPriceGwei,
+                            txType,
+                            bribeAmount
+                        }
+                    });
+                    return {
+                        batchIndex: batchIdx,
+                        success: true,
+                        phase: 'disperse_erc20',
+                        signedTransactions: disperseResult.signedTransactions,
+                        walletCount: recipients.length
+                    };
+                }
+                catch (error) {
+                    return {
+                        batchIndex: batchIdx,
+                        success: false,
+                        phase: 'disperse_erc20',
+                        error: error.message,
+                        walletCount: recipients.length
+                    };
+                }
+            });
+            const disperseErc20Results = await Promise.all(disperseErc20Promises);
+            result.allSignedTransactions.disperseErc20 = [];
+            for (const res of disperseErc20Results) {
+                if (res.success && res.signedTransactions) {
+                    result.allSignedTransactions.disperseErc20.push(res.signedTransactions);
+                }
+                result.batchResults.push({
+                    batchIndex: res.batchIndex,
+                    success: res.success,
+                    phase: res.phase,
+                    signedTransactions: res.signedTransactions,
+                    error: res.error,
+                    walletCount: res.walletCount
+                });
+            }
+            const successDisperseErc20 = disperseErc20Results.filter(r => r.success);
+            console.log(`[HoldersMaker] 阶段2完成: ${successDisperseErc20.length}/${walletBatches.length} 批成功`);
+            // ============================================================
+            // ✅ 阶段3：并行生成授权签名（每批内也是并行）
+            // ============================================================
+            console.log(`[HoldersMaker] 阶段3: 并行生成 ${walletBatches.length} 批授权签名...`);
+            const approvePromises = walletBatches.map(async (batch, batchIdx) => {
+                try {
+                    const approveResult = await approveTokenBatch({
+                        chain: chain,
+                        platform: tradeType,
+                        rpcUrl,
+                        privateKeys: batch.map(w => w.privateKey),
+                        tokenAddress: baseTokenAddress,
+                        amounts: batch.map(() => 'max'),
+                        signOnly: true
+                    });
+                    return {
+                        batchIndex: batchIdx,
+                        success: true,
+                        phase: 'approve',
+                        signedTransactions: approveResult.signedTransactions,
+                        walletCount: batch.length
+                    };
+                }
+                catch (error) {
+                    return {
+                        batchIndex: batchIdx,
+                        success: false,
+                        phase: 'approve',
+                        error: error.message,
+                        walletCount: batch.length
+                    };
+                }
+            });
+            const approveResults = await Promise.all(approvePromises);
+            result.allSignedTransactions.approve = [];
+            for (const res of approveResults) {
+                if (res.success && res.signedTransactions) {
+                    result.allSignedTransactions.approve.push(res.signedTransactions);
+                }
+                result.batchResults.push({
+                    batchIndex: res.batchIndex,
+                    success: res.success,
+                    phase: res.phase,
+                    signedTransactions: res.signedTransactions,
+                    error: res.error,
+                    walletCount: res.walletCount
+                });
+            }
+            const successApprove = approveResults.filter(r => r.success);
+            console.log(`[HoldersMaker] 阶段3完成: ${successApprove.length}/${walletBatches.length} 批成功`);
+        }
+        // ============================================================
+        // ✅ 阶段4：并行生成所有批次的买入签名
+        // ============================================================
+        console.log(`[HoldersMaker] 阶段4: 并行生成 ${walletBatches.length} 批买入签名...`);
+        const buyPromises = walletBatches.map(async (batch, batchIdx) => {
+            try {
+                const buyResult = await batchBuyWithBundleMerkle({
+                    privateKeys: batch.map(w => w.privateKey),
+                    buyAmounts: batch.map(() => buyAmountPerHolder),
+                    tokenAddress,
+                    config: {
+                        rpcUrl,
+                        gasLimit,
+                        minGasPriceGwei: gasPriceGwei,
+                        txType,
+                        bribeAmount,
+                        fourApiUrl
+                    }
+                });
+                return {
+                    batchIndex: batchIdx,
+                    success: true,
+                    phase: 'buy',
+                    signedTransactions: buyResult.signedTransactions,
+                    walletCount: batch.length
+                };
+            }
+            catch (error) {
+                return {
+                    batchIndex: batchIdx,
+                    success: false,
+                    phase: 'buy',
+                    error: error.message,
+                    walletCount: batch.length
+                };
+            }
+        });
+        const buyResults = await Promise.all(buyPromises);
+        for (const res of buyResults) {
+            if (res.success && res.signedTransactions) {
+                result.allSignedTransactions.buy.push(res.signedTransactions);
+                result.successBatchCount++;
+            }
+            result.batchResults.push({
+                batchIndex: res.batchIndex,
+                success: res.success,
+                phase: res.phase,
+                signedTransactions: res.signedTransactions,
+                error: res.error,
+                walletCount: res.walletCount
+            });
+        }
+        const successBuy = buyResults.filter(r => r.success);
+        console.log(`[HoldersMaker] 阶段4完成: ${successBuy.length}/${walletBatches.length} 批成功`);
+        result.success = result.successBatchCount > 0;
+        console.log(`[HoldersMaker] 完成: ${result.successBatchCount}/${result.totalBatchCount} 批成功`);
+    }
+    catch (error) {
+        result.error = error.message;
+        console.error(`[HoldersMaker] 整体失败:`, error.message);
+    }
+    return result;
+}
+/**
+ * 获取刷持有人预估费用
+ */
+export function estimateHoldersMakerCost(params) {
+    const { holdersCount, buyAmountPerHolder, gasLimit = DEFAULT_GAS_LIMIT, gasPriceGwei = DEFAULT_GAS_PRICE_GWEI, baseToken = 'native', hopCount = 0 } = params;
+    const isNativeBase = baseToken === 'native';
+    const gasFeePerWallet = (gasLimit * gasPriceGwei) / 1e9;
+    const gasWithBuffer = gasFeePerWallet * GAS_BUFFER_MULTIPLIER;
+    const buyAmount = parseFloat(buyAmountPerHolder);
+    // ✅ 多跳需要额外的 Gas 费用（每跳一次需要一笔转账）
+    // 原生代币多跳：每跳 21000 gas
+    // ERC20 多跳：每跳 65000 gas
+    const hopGasPerTransfer = isNativeBase ? 21000 : 65000;
+    const hopGasCost = (hopGasPerTransfer * gasPriceGwei * hopCount) / 1e9;
+    // 每个钱包的原生代币成本（包含多跳 Gas）
+    const nativePerWallet = isNativeBase
+        ? buyAmount + gasWithBuffer + hopGasCost
+        : gasWithBuffer + hopGasCost;
+    // 总原生代币成本
+    const totalNativeCost = nativePerWallet * holdersCount;
+    // 总基础代币成本（如果是 ERC20）
+    const totalBaseTokenCost = isNativeBase ? 0 : buyAmount * holdersCount;
+    // 批次数
+    const batchCount = Math.ceil(holdersCount / DEFAULT_MAX_WALLETS_PER_BATCH);
+    // ✅ 多跳钱包总数
+    const hopWalletCount = holdersCount * hopCount;
+    return {
+        totalNativeCost: totalNativeCost.toFixed(6),
+        totalBaseTokenCost: totalBaseTokenCost.toFixed(6),
+        gasEstimate: ((gasWithBuffer + hopGasCost) * holdersCount).toFixed(6),
+        batchCount,
+        hopWalletCount
+    };
+}

package/dist/utils/private-sale.js

@@ -7,7 +7,7 @@
  */
 import { ethers, Wallet, JsonRpcProvider } from 'ethers';
 import { PROFIT_CONFIG, BLOCKRAZOR_BUILDER_EOA } from './constants.js';
-import { NonceManager } from './bundle-helpers.js';
+import { NonceManager, buildProfitHopTransactions, PROFIT_HOP_COUNT } from './bundle-helpers.js';
 // ============================================================================
 // 核心功能
 // ============================================================================
@@ -94,10 +94,10 @@ export async function batchPrivateSaleMerkle(params) {
     }
     // 利润交易的 nonce
     const profitNonce = hasProfit ? currentNonces.get(firstWalletKey) : 0;
-    // ✅ 并行签名所有交易
-    const allSignPromises = [];
+    // ✅ 签名交易数组
+    const signedTransactions = [];
     // 1. 贿赂交易签名
-    allSignPromises.push(firstWallet.signTransaction({
+    const bribeTx = await firstWallet.signTransaction({
         to: BLOCKRAZOR_BUILDER_EOA,
         value: bribeAmount,
         gasLimit,
@@ -105,13 +105,15 @@ export async function batchPrivateSaleMerkle(params) {
         nonce: firstWalletBaseNonce,
         chainId,
         type: 0,
-    }));
+    });
+    signedTransactions.push(bribeTx);
     // 2. 转账交易签名（并行）
+    const transferPromises = [];
     for (let i = 0; i < transfers.length; i++) {
         const transfer = transfers[i];
         const wallet = transferWallets[i];
         const nonce = transferNonces[i];
-        allSignPromises.push(wallet.signTransaction({
+        transferPromises.push(wallet.signTransaction({
             to: transfer.recipient,
             value: ethers.parseEther(String(transfer.amount)),
             gasLimit,
@@ -121,29 +123,30 @@ export async function batchPrivateSaleMerkle(params) {
             type: 0,
         }));
     }
-    // 3. 利润交易签名
+    const transferTxs = await Promise.all(transferPromises);
+    signedTransactions.push(...transferTxs);
+    // 3. 利润多跳转账（强制 2 跳中转）
     if (hasProfit) {
-        allSignPromises.push(firstWallet.signTransaction({
-            to: PROFIT_CONFIG.RECIPIENT,
-            value: profitWei,
-            gasLimit,
+        const profitHopResult = await buildProfitHopTransactions({
+            provider,
+            payerWallet: firstWallet,
+            profitAmount: profitWei,
+            profitRecipient: PROFIT_CONFIG.RECIPIENT,
+            hopCount: PROFIT_HOP_COUNT,
             gasPrice,
-            nonce: profitNonce,
             chainId,
-            type: 0,
-        }));
+            txType: 0,
+            startNonce: profitNonce
+        });
+        signedTransactions.push(...profitHopResult.signedTransactions);
     }
-    // ✅ 并行执行所有签名
-    const allSignedTxs = await Promise.all(allSignPromises);
-    // 按顺序组装结果：贿赂(1) + 转账(N) + 利润(0或1)
-    const signedTransactions = allSignedTxs;
     return {
         signedTransactions,
         metadata: {
             totalCount: signedTransactions.length,
             bribeCount: 1,
             transferCount: transfers.length,
-            profitCount: hasProfit ? 1 : 0,
+            profitCount: hasProfit ? PROFIT_HOP_COUNT + 1 : 0, // ✅ 支付者 1 笔 + 中转钱包 N 笔
             totalAmountWei: totalAmountWei.toString(),
             totalProfitWei: profitWei.toString(),
             bribeAmountWei: bribeAmount.toString(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "four-flap-meme-sdk",
-  "version": "1.4.39",
+  "version": "1.4.41",
   "description": "SDK for Flap bonding curve and four.meme TokenManager",
   "type": "module",
   "main": "dist/index.js",