four-flap-meme-sdk 1.4.55 → 1.4.56

package/dist/utils/holders-maker.d.ts

@@ -34,6 +34,8 @@ export type HoldersMakerConfig = {
     maxWalletsPerBatch?: number;
     /** Four API URL */
     fourApiUrl?: string;
+    /** 分发多跳数（0=直接转账，1=1跳，2=2跳...） */
+    disperseHopCount?: number;
     /** V2 路由路径（如 [WBNB, TOKEN]） */
     v2Path?: string[];
     /** V3 单跳输入代币 */
@@ -79,6 +81,8 @@ export type HoldersMakerResult = {
     success: boolean;
     /** 生成的新钱包 */
     newWallets: GeneratedWallet[];
+    /** 分发多跳中间钱包（可选，用于导出） */
+    disperseHopWallets?: GeneratedWallet[];
     /** 签名交易（每批一个数组） */
     signedTransactions: string[][];
     /** 批次结果 */

package/dist/utils/holders-maker.js

@@ -31,26 +31,46 @@ const ERC20_APPROVE_GAS_LIMIT = 50000n;
 const DEFAULT_GAS_LIMIT = 800000;
 const DEFAULT_GAS_PRICE_GWEI = 3;
 const GAS_BUFFER_MULTIPLIER = 2; // 2倍 Gas 费安全系数
-// Bundle 限制计算（原生代币模式）：
-// - 贿赂 1 笔
-// - 利润多跳 PROFIT_HOP_COUNT + 1 笔（payer → hop1 → hop2 → recipient）
-// - 分发 N 笔
-// - 买入 N 笔
-// 1 + (PROFIT_HOP_COUNT + 1) + 2N ≤ 50
-// 2N ≤ 50 - 2 - PROFIT_HOP_COUNT
-// N ≤ (48 - PROFIT_HOP_COUNT) / 2
-const DEFAULT_MAX_WALLETS_PER_BATCH_NATIVE = Math.floor((48 - PROFIT_HOP_COUNT) / 2);
-// Bundle 限制计算（ERC20 模式）：
-// - 贿赂 1 笔
-// - 利润多跳 PROFIT_HOP_COUNT + 1 笔
-// - 分发 BNB N 笔
-// - 分发 ERC20 N 笔
-// - 授权 N 笔
-// - 买入 N 笔
-// 1 + (PROFIT_HOP_COUNT + 1) + 4N ≤ 50
-// 4N ≤ 50 - 2 - PROFIT_HOP_COUNT
-// N ≤ (48 - PROFIT_HOP_COUNT) / 4
-const DEFAULT_MAX_WALLETS_PER_BATCH_ERC20 = Math.floor((48 - PROFIT_HOP_COUNT) / 4);
+const NATIVE_TRANSFER_GAS_LIMIT = 21055n; // 原生代币转账 Gas Limit
+/**
+ * 动态计算每批最大钱包数
+ *
+ * Bundle 限制 = 50 笔交易
+ * 固定开销 = 贿赂 1 笔 + 利润多跳 (PROFIT_HOP_COUNT + 1) 笔
+ *
+ * 原生模式（无分发多跳）：
+ *   每钱包开销 = 分发 1 + 买入 1 = 2
+ *   N ≤ (50 - 固定开销) / 2
+ *
+ * 原生模式（有分发多跳 H）：
+ *   每钱包开销 = 分发 (H+1) + 买入 1 = H+2
+ *   N ≤ (50 - 固定开销) / (H+2)
+ *
+ * ERC20 模式（无分发多跳）：
+ *   每钱包开销 = 分发BNB 1 + 分发ERC20 1 + 授权 1 + 买入 1 = 4
+ *   N ≤ (50 - 固定开销) / 4
+ *
+ * ERC20 模式（有分发多跳 H）：
+ *   每钱包开销 = 分发BNB (H+1) + 分发ERC20 (H+1) + 授权 1 + 买入 1 = 2H+4
+ *   N ≤ (50 - 固定开销) / (2H+4)
+ */
+function calculateMaxWalletsPerBatch(isERC20Mode, disperseHopCount) {
+    const fixedOverhead = 1 + PROFIT_HOP_COUNT + 1; // 贿赂 + 利润多跳
+    const maxTxs = 50 - fixedOverhead;
+    if (isERC20Mode) {
+        // ERC20: 分发BNB (H+1) + 分发ERC20 (H+1) + 授权 1 + 买入 1
+        const perWalletTxs = 2 * (disperseHopCount + 1) + 2;
+        return Math.floor(maxTxs / perWalletTxs);
+    }
+    else {
+        // 原生: 分发 (H+1) + 买入 1
+        const perWalletTxs = disperseHopCount + 2;
+        return Math.floor(maxTxs / perWalletTxs);
+    }
+}
+// 默认值（无分发多跳）
+const DEFAULT_MAX_WALLETS_PER_BATCH_NATIVE = calculateMaxWalletsPerBatch(false, 0);
+const DEFAULT_MAX_WALLETS_PER_BATCH_ERC20 = calculateMaxWalletsPerBatch(true, 0);
 // ============================================================================
 // 辅助函数
 // ============================================================================
@@ -64,6 +84,127 @@ function chunkArray(arr, size) {
     }
     return chunks;
 }
+/**
+ * 生成分发多跳路径
+ * @param targetWallets 目标钱包地址列表
+ * @param hopCount 多跳数量（0=直接转账，1=1个中间钱包，2=2个中间钱包...）
+ * @param provider Provider 实例
+ * @returns 每个目标钱包的多跳路径
+ */
+function generateDisperseHopPaths(targetWallets, hopCount, provider) {
+    if (hopCount <= 0) {
+        // 无多跳，直接返回空路径
+        return targetWallets.map(w => ({
+            targetAddress: w.address,
+            hopWallets: [],
+            hopWalletsInfo: []
+        }));
+    }
+    // 为每个目标钱包生成中间钱包
+    return targetWallets.map(targetWallet => {
+        const hopWalletsInfo = generateWallets(hopCount);
+        const hopWallets = hopWalletsInfo.map(w => new Wallet(w.privateKey, provider));
+        return {
+            targetAddress: targetWallet.address,
+            hopWallets,
+            hopWalletsInfo
+        };
+    });
+}
+/**
+ * 构建分发多跳交易链（原生代币）
+ *
+ * 路径: payer → hop1 → hop2 → ... → target
+ *
+ * @param isERC20Mode 是否为 ERC20 模式（中间钱包需要预留 ERC20 转账 gas）
+ * @returns 签名交易数组
+ */
+async function buildDisperseHopChainNative(payer, path, finalAmount, gasPrice, chainId, txType, payerNonce, isERC20Mode = false) {
+    const signedTxs = [];
+    const hopCount = path.hopWallets.length;
+    if (hopCount === 0) {
+        // 无多跳，直接转账
+        const tx = await buildNativeTransferTx(payer, path.targetAddress, finalAmount, payerNonce, gasPrice, chainId, txType);
+        signedTxs.push(tx);
+        return { signedTxs, payerNoncesUsed: 1 };
+    }
+    // 计算每一跳需要转出的金额（需要预留后续跳的 gas 费）
+    const hopGasCost = NATIVE_TRANSFER_GAS_LIMIT * gasPrice;
+    // ERC20 模式下，中间钱包还需要预留 ERC20 转账的 gas
+    const erc20TransferGasCost = isERC20Mode ? ERC20_TRANSFER_GAS_LIMIT * gasPrice : 0n;
+    // 从后往前计算每一跳需要的金额
+    // 原生模式：
+    //   最后一跳（hopN → target）需要: finalAmount + hopGasCost
+    //   倒数第二跳需要: finalAmount + 2 * hopGasCost
+    // ERC20 模式（中间钱包还需要预留 ERC20 转账 gas）：
+    //   每个中间钱包额外需要: erc20TransferGasCost
+    const amountsPerHop = [];
+    for (let i = 0; i < hopCount; i++) {
+        const remainingHops = hopCount - i;
+        // 中间钱包需要的 BNB = 最终金额 + 后续 BNB 转账 gas + (ERC20模式下) 自己的 ERC20 转账 gas
+        const amount = finalAmount
+            + hopGasCost * BigInt(remainingHops)
+            + (isERC20Mode ? erc20TransferGasCost * BigInt(remainingHops) : 0n);
+        amountsPerHop.push(amount);
+    }
+    // 构建交易链
+    // 1. payer → hop1 (使用 payer nonce)
+    const firstTx = await buildNativeTransferTx(payer, path.hopWallets[0].address, amountsPerHop[0], payerNonce, gasPrice, chainId, txType);
+    signedTxs.push(firstTx);
+    // 2. hop1 → hop2 → ... → hopN → target (每个中间钱包 nonce=0)
+    for (let i = 0; i < hopCount; i++) {
+        const fromWallet = path.hopWallets[i];
+        const toAddress = i === hopCount - 1
+            ? path.targetAddress // 最后一跳到目标
+            : path.hopWallets[i + 1].address; // 中间跳到下一个 hop
+        // 最后一跳只需转最终金额，中间跳需要预留后续费用
+        const amount = i === hopCount - 1
+            ? finalAmount
+            : amountsPerHop[i + 1];
+        const tx = await buildNativeTransferTx(fromWallet, toAddress, amount, 0, // 中间钱包都是新生成的，nonce=0
+        gasPrice, chainId, txType);
+        signedTxs.push(tx);
+    }
+    return { signedTxs, payerNoncesUsed: 1 };
+}
+/**
+ * 构建分发多跳交易链（ERC20 代币）
+ *
+ * 路径: payer → hop1 → hop2 → ... → target
+ *
+ * 注意：ERC20 多跳需要配合 BNB 多跳使用，中间钱包需要先收到 BNB 作为 gas
+ * BNB 多跳先执行，确保中间钱包有 gas 费后再转发 ERC20
+ *
+ * 中间钱包的 nonce 安排：
+ * - nonce=0: BNB 转发（在 buildDisperseHopChainNative 中完成）
+ * - nonce=1: ERC20 转发（在本函数中完成）
+ */
+async function buildDisperseHopChainERC20(payer, path, erc20Address, erc20Amount, gasPrice, chainId, txType, payerNonce) {
+    const signedTxs = [];
+    const hopCount = path.hopWallets.length;
+    if (hopCount === 0) {
+        // 无多跳，直接转账
+        const tx = await buildERC20TransferTx(payer, erc20Address, path.targetAddress, erc20Amount, payerNonce, gasPrice, chainId, txType);
+        signedTxs.push(tx);
+        return { signedTxs, payerNoncesUsed: 1 };
+    }
+    // 构建交易链
+    // payer 发送 ERC20 到 hop1
+    const firstTx = await buildERC20TransferTx(payer, erc20Address, path.hopWallets[0].address, erc20Amount, payerNonce, gasPrice, chainId, txType);
+    signedTxs.push(firstTx);
+    // 每个中间钱包转发 ERC20
+    // nonce=1（因为 nonce=0 已经用于 BNB 转发）
+    for (let i = 0; i < hopCount; i++) {
+        const fromWallet = path.hopWallets[i];
+        const toAddress = i === hopCount - 1
+            ? path.targetAddress
+            : path.hopWallets[i + 1].address;
+        const tx = await buildERC20TransferTx(fromWallet, erc20Address, toAddress, erc20Amount, 1, // ✅ nonce=1（nonce=0 用于 BNB 转发）
+        gasPrice, chainId, txType);
+        signedTxs.push(tx);
+    }
+    return { signedTxs, payerNoncesUsed: 1 };
+}
 /**
  * 获取 ERC20 稳定币地址
  */
@@ -405,10 +546,12 @@ async function buildV3BuyTxWithERC20(wallet, tokenAddress, baseTokenAddress, buy
  */
 export async function holdersMaker(params) {
     const { payerPrivateKey, holdersCount, buyAmountPerHolder, tokenAddress, baseToken = 'native', baseTokenAddress, baseTokenDecimals = 18, config } = params;
-    const { rpcUrl, chain = 'BSC', chainId: configChainId, tradeType = 'flap', gasLimit = DEFAULT_GAS_LIMIT, gasPriceGwei = DEFAULT_GAS_PRICE_GWEI, bribeAmount = 0.000001, txType = 0 } = config;
+    const { rpcUrl, chain = 'BSC', chainId: configChainId, tradeType = 'flap', gasLimit = DEFAULT_GAS_LIMIT, gasPriceGwei = DEFAULT_GAS_PRICE_GWEI, bribeAmount = 0.000001, txType = 0, disperseHopCount = 0 // ✅ 分发多跳数（默认0=直接转账）
+     } = config;
     const result = {
         success: false,
         newWallets: [],
+        disperseHopWallets: [], // ✅ 中间钱包列表
         signedTransactions: [],
         batchResults: [],
         successBatchCount: 0,
@@ -426,9 +569,10 @@ export async function holdersMaker(params) {
         result.error = `不支持的交易类型: ${tradeType}，支持: ${supportedTradeTypes.join(', ')}`;
         return result;
     }
-    // 根据模式选择每批最大钱包数
+    // ✅ 根据分发多跳数动态计算每批最大钱包数
     const maxWalletsPerBatch = config.maxWalletsPerBatch ||
-        (isERC20Mode ? DEFAULT_MAX_WALLETS_PER_BATCH_ERC20 : DEFAULT_MAX_WALLETS_PER_BATCH_NATIVE);
+        calculateMaxWalletsPerBatch(isERC20Mode, disperseHopCount);
+    console.log(`[HoldersMaker] 分发多跳数: ${disperseHopCount}, 每批最大钱包数: ${maxWalletsPerBatch}`);
     try {
         // 1. 初始化
         const provider = new JsonRpcProvider(rpcUrl);
@@ -479,13 +623,27 @@ export async function holdersMaker(params) {
         const totalProfit = (totalBuyAmountForProfit * BigInt(profitRateBps)) / 10000n;
         const profitPerBatch = totalProfit / BigInt(walletBatches.length);
         console.log(`[HoldersMaker] 总利润: ${ethers.formatEther(totalProfit)} BNB`);
-        // 6. 并行生成所有批次的签名
+        // 6. 生成分发多跳路径（如果启用）
+        let allDisperseHopWallets = [];
+        const disperseHopPaths = generateDisperseHopPaths(newWallets, disperseHopCount, provider);
+        if (disperseHopCount > 0) {
+            // 收集所有中间钱包信息用于导出
+            for (const path of disperseHopPaths) {
+                allDisperseHopWallets.push(...path.hopWalletsInfo);
+            }
+            result.disperseHopWallets = allDisperseHopWallets;
+            console.log(`[HoldersMaker] 分发多跳: ${disperseHopCount} 跳，共生成 ${allDisperseHopWallets.length} 个中间钱包`);
+        }
+        // 7. 并行生成所有批次的签名
         const batchPromises = walletBatches.map(async (batch, batchIdx) => {
             try {
                 const signedTxs = [];
                 // 计算这批需要的 payer nonce 数量
-                // 原生模式: 贿赂 1 + 分发 N + 利润 (PROFIT_HOP_COUNT + 1)
-                // ERC20模式: 贿赂 1 + 分发BNB N + 分发ERC20 N + 利润 (PROFIT_HOP_COUNT + 1)
+                // 原生模式（无多跳）: 贿赂 1 + 分发 N + 利润 (PROFIT_HOP_COUNT + 1)
+                // 原生模式（有多跳H）: 贿赂 1 + 分发首跳 N + 利润 (PROFIT_HOP_COUNT + 1)
+                // ERC20模式（无多跳）: 贿赂 1 + 分发BNB N + 分发ERC20 N + 利润 (PROFIT_HOP_COUNT + 1)
+                // ERC20模式（有多跳H）: 贿赂 1 + 分发BNB首跳 N + 分发ERC20首跳 N + 利润 (PROFIT_HOP_COUNT + 1)
+                // 注：多跳中间钱包的交易不消耗 payer nonce
                 const payerNonceCount = isERC20Mode
                     ? 1 + batch.length * 2 + PROFIT_HOP_COUNT + 1
                     : 1 + batch.length + PROFIT_HOP_COUNT + 1;
@@ -494,16 +652,22 @@ export async function holdersMaker(params) {
                 // (1) 贿赂交易
                 const bribeTx = await buildNativeTransferTx(payer, BLOCKRAZOR_BUILDER_EOA, bribeAmountWei, payerNonces[payerNonceIdx++], gasPrice, chainId, txType);
                 signedTxs.push(bribeTx);
-                // (2) 分发原生代币（gas 费或买入资金）
-                for (const newWallet of batch) {
-                    const transferTx = await buildNativeTransferTx(payer, newWallet.address, transferNativePerWallet, payerNonces[payerNonceIdx++], gasPrice, chainId, txType);
-                    signedTxs.push(transferTx);
+                // 获取当前批次对应的多跳路径
+                const batchStartIdx = batchIdx * maxWalletsPerBatch;
+                const batchPaths = disperseHopPaths.slice(batchStartIdx, batchStartIdx + batch.length);
+                // (2) 分发原生代币（支持多跳）
+                for (let i = 0; i < batch.length; i++) {
+                    const path = batchPaths[i];
+                    const { signedTxs: hopTxs } = await buildDisperseHopChainNative(payer, path, transferNativePerWallet, gasPrice, chainId, txType, payerNonces[payerNonceIdx++], isERC20Mode // ✅ ERC20 模式下，中间钱包需要预留 ERC20 转账 gas
+                    );
+                    signedTxs.push(...hopTxs);
                 }
-                // (3) ERC20 模式：分发 ERC20 代币
+                // (3) ERC20 模式：分发 ERC20 代币（支持多跳）
                 if (isERC20Mode && erc20TokenAddress) {
-                    for (const newWallet of batch) {
-                        const erc20TransferTx = await buildERC20TransferTx(payer, erc20TokenAddress, newWallet.address, buyAmountWei, payerNonces[payerNonceIdx++], gasPrice, chainId, txType);
-                        signedTxs.push(erc20TransferTx);
+                    for (let i = 0; i < batch.length; i++) {
+                        const path = batchPaths[i];
+                        const { signedTxs: hopTxs } = await buildDisperseHopChainERC20(payer, path, erc20TokenAddress, buyAmountWei, gasPrice, chainId, txType, payerNonces[payerNonceIdx++]);
+                        signedTxs.push(...hopTxs);
                     }
                 }
                 // (4) ERC20 模式：授权交易（新钱包 nonce=0）

package/package.json

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