four-flap-meme-sdk 1.4.55 → 1.4.57

package/dist/pancake/bundle-swap.js

@@ -1,3 +1,229 @@
+// ==================== 多跳转账常量 ====================
+const NATIVE_TRANSFER_GAS_LIMIT = 21055n;
+const ERC20_TRANSFER_GAS_LIMIT_HOP = 65000n;
+/**
+ * 生成分发多跳路径
+ */
+function generateDisperseHopPaths(targetAddresses, hopCount, provider) {
+    if (hopCount <= 0) {
+        return targetAddresses.map(addr => ({
+            targetAddress: addr,
+            hopWallets: [],
+            hopWalletsInfo: []
+        }));
+    }
+    return targetAddresses.map(targetAddress => {
+        const hopWalletsInfo = generateWallets(hopCount);
+        const hopWallets = hopWalletsInfo.map(w => new Wallet(w.privateKey, provider));
+        return { targetAddress, hopWallets, hopWalletsInfo };
+    });
+}
+/**
+ * 构建原生代币多跳转账链
+ */
+async function buildNativeHopChain(payer, path, finalAmount, gasPrice, chainId, txType, payerNonce) {
+    const signedTxs = [];
+    const hopCount = path.hopWallets.length;
+    if (hopCount === 0) {
+        const tx = {
+            to: path.targetAddress,
+            value: finalAmount,
+            nonce: payerNonce,
+            gasLimit: NATIVE_TRANSFER_GAS_LIMIT,
+            chainId,
+            type: txType
+        };
+        if (txType === 2) {
+            tx.maxFeePerGas = gasPrice;
+            tx.maxPriorityFeePerGas = gasPrice / 10n || 1n;
+        }
+        else {
+            tx.gasPrice = gasPrice;
+        }
+        signedTxs.push(await payer.signTransaction(tx));
+        return signedTxs;
+    }
+    const hopGasCost = NATIVE_TRANSFER_GAS_LIMIT * gasPrice;
+    // 计算每跳需要的金额
+    const amountsPerHop = [];
+    for (let i = 0; i < hopCount; i++) {
+        const remainingHops = hopCount - i;
+        amountsPerHop.push(finalAmount + hopGasCost * BigInt(remainingHops));
+    }
+    // payer → hop1
+    const firstTx = {
+        to: path.hopWallets[0].address,
+        value: amountsPerHop[0],
+        nonce: payerNonce,
+        gasLimit: NATIVE_TRANSFER_GAS_LIMIT,
+        chainId,
+        type: txType
+    };
+    if (txType === 2) {
+        firstTx.maxFeePerGas = gasPrice;
+        firstTx.maxPriorityFeePerGas = gasPrice / 10n || 1n;
+    }
+    else {
+        firstTx.gasPrice = gasPrice;
+    }
+    signedTxs.push(await payer.signTransaction(firstTx));
+    // hop1 → hop2 → ... → target
+    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 amount = i === hopCount - 1 ? finalAmount : amountsPerHop[i + 1];
+        const tx = {
+            to: toAddress,
+            value: amount,
+            nonce: 0,
+            gasLimit: NATIVE_TRANSFER_GAS_LIMIT,
+            chainId,
+            type: txType
+        };
+        if (txType === 2) {
+            tx.maxFeePerGas = gasPrice;
+            tx.maxPriorityFeePerGas = gasPrice / 10n || 1n;
+        }
+        else {
+            tx.gasPrice = gasPrice;
+        }
+        signedTxs.push(await fromWallet.signTransaction(tx));
+    }
+    return signedTxs;
+}
+/**
+ * 构建 ERC20 多跳转账链（需要配合 BNB 多跳使用）
+ */
+async function buildERC20HopChain(payer, path, erc20Address, erc20Amount, gasPrice, chainId, txType, payerNonce) {
+    const signedTxs = [];
+    const hopCount = path.hopWallets.length;
+    const erc20Interface = new ethers.Interface(ERC20_ABI);
+    if (hopCount === 0) {
+        const data = erc20Interface.encodeFunctionData('transfer', [path.targetAddress, erc20Amount]);
+        const tx = {
+            to: erc20Address,
+            data,
+            value: 0n,
+            nonce: payerNonce,
+            gasLimit: ERC20_TRANSFER_GAS_LIMIT_HOP,
+            chainId,
+            type: txType
+        };
+        if (txType === 2) {
+            tx.maxFeePerGas = gasPrice;
+            tx.maxPriorityFeePerGas = gasPrice / 10n || 1n;
+        }
+        else {
+            tx.gasPrice = gasPrice;
+        }
+        signedTxs.push(await payer.signTransaction(tx));
+        return signedTxs;
+    }
+    // payer → hop1
+    const firstData = erc20Interface.encodeFunctionData('transfer', [path.hopWallets[0].address, erc20Amount]);
+    const firstTx = {
+        to: erc20Address,
+        data: firstData,
+        value: 0n,
+        nonce: payerNonce,
+        gasLimit: ERC20_TRANSFER_GAS_LIMIT_HOP,
+        chainId,
+        type: txType
+    };
+    if (txType === 2) {
+        firstTx.maxFeePerGas = gasPrice;
+        firstTx.maxPriorityFeePerGas = gasPrice / 10n || 1n;
+    }
+    else {
+        firstTx.gasPrice = gasPrice;
+    }
+    signedTxs.push(await payer.signTransaction(firstTx));
+    // hop1 → hop2 → ... → target (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 data = erc20Interface.encodeFunctionData('transfer', [toAddress, erc20Amount]);
+        const tx = {
+            to: erc20Address,
+            data,
+            value: 0n,
+            nonce: 1, // nonce=0 已用于 BNB 转发
+            gasLimit: ERC20_TRANSFER_GAS_LIMIT_HOP,
+            chainId,
+            type: txType
+        };
+        if (txType === 2) {
+            tx.maxFeePerGas = gasPrice;
+            tx.maxPriorityFeePerGas = gasPrice / 10n || 1n;
+        }
+        else {
+            tx.gasPrice = gasPrice;
+        }
+        signedTxs.push(await fromWallet.signTransaction(tx));
+    }
+    return signedTxs;
+}
+/**
+ * 构建 BNB 多跳转账链（为 ERC20 中间钱包预留 gas）
+ */
+async function buildBNBHopChainForERC20(payer, path, finalGasAmount, gasPrice, chainId, txType, payerNonce) {
+    const signedTxs = [];
+    const hopCount = path.hopWallets.length;
+    if (hopCount === 0) {
+        // 无多跳时不需要转 gas
+        return signedTxs;
+    }
+    const hopGasCost = NATIVE_TRANSFER_GAS_LIMIT * gasPrice;
+    const erc20GasCost = ERC20_TRANSFER_GAS_LIMIT_HOP * gasPrice;
+    // 每个中间钱包需要: BNB 转发 gas + ERC20 转发 gas
+    const gasPerHop = hopGasCost + erc20GasCost * 2n; // 2倍安全系数
+    // 计算每跳需要的金额
+    const amountsPerHop = [];
+    for (let i = 0; i < hopCount; i++) {
+        const remainingHops = hopCount - i;
+        amountsPerHop.push(finalGasAmount + gasPerHop * BigInt(remainingHops));
+    }
+    // payer → hop1
+    const firstTx = {
+        to: path.hopWallets[0].address,
+        value: amountsPerHop[0],
+        nonce: payerNonce,
+        gasLimit: NATIVE_TRANSFER_GAS_LIMIT,
+        chainId,
+        type: txType
+    };
+    if (txType === 2) {
+        firstTx.maxFeePerGas = gasPrice;
+        firstTx.maxPriorityFeePerGas = gasPrice / 10n || 1n;
+    }
+    else {
+        firstTx.gasPrice = gasPrice;
+    }
+    signedTxs.push(await payer.signTransaction(firstTx));
+    // hop1 → hop2 → ... → 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;
+        const amount = i === hopCount - 1 ? finalGasAmount : amountsPerHop[i + 1];
+        const tx = {
+            to: toAddress,
+            value: amount,
+            nonce: 0,
+            gasLimit: NATIVE_TRANSFER_GAS_LIMIT,
+            chainId,
+            type: txType
+        };
+        if (txType === 2) {
+            tx.maxFeePerGas = gasPrice;
+            tx.maxPriorityFeePerGas = gasPrice / 10n || 1n;
+        }
+        else {
+            tx.gasPrice = gasPrice;
+        }
+        signedTxs.push(await fromWallet.signTransaction(tx));
+    }
+    return signedTxs;
+}
 // ==================== 工具函数 ====================
 function createPancakeContext(config) {
     const chainId = config.chainId ?? 56;
@@ -302,7 +528,8 @@ import { calculateSellAmount } from '../utils/swap-helpers.js';
 import { NonceManager, getDeadline, buildProfitHopTransactions, PROFIT_HOP_COUNT } from '../utils/bundle-helpers.js';
 import { ADDRESSES, PROFIT_CONFIG, BLOCKRAZOR_BUILDER_EOA } from '../utils/constants.js';
 import { quoteV2, quoteV3 } from '../utils/quote-helpers.js';
-import { V2_ROUTER_ABI, V3_ROUTER02_ABI, ERC20_BALANCE_ABI } from '../abis/common.js';
+import { V2_ROUTER_ABI, V3_ROUTER02_ABI, ERC20_BALANCE_ABI, ERC20_ABI } from '../abis/common.js';
+import { generateWallets } from '../utils/wallet.js';
 /**
  * 获取 Gas Limit
  */
@@ -788,32 +1015,49 @@ export async function pancakeBatchSwapMerkle(params) {
 /**
  * PancakeSwap 快捷批量换手（资金自动流转）
  *
- * 流程：[贿赂] → [卖出] → [转账1, 转账2, ...] → [买入1, 买入2, ...] → [利润]
+ * 流程：[贿赂] → [卖出] → [转账多跳...] → [买入1, 买入2, ...] → [利润]
  *
  * 特点：
  * - 子钱包不需要预先有余额
  * - 资金来自主钱包卖出代币所得
  * - 提升资金利用率
  * - 支持 BNB 和 ERC20（如 USDT）两种模式
+ * - ✅ 支持转账多跳，隐藏资金流向
  *
- * 限制：最多 23 个买方（转账 + 买入 = 46 笔，加上贿赂/卖出/利润 = 50 笔限制）
+ * 限制：根据多跳数动态计算最大买方数量
  */
 export async function pancakeQuickBatchSwapMerkle(params) {
-    const { sellerPrivateKey, sellAmount, sellPercentage, buyerPrivateKeys, buyerRatios, buyerAmounts, tokenAddress, routeParams, config, quoteToken, quoteTokenDecimals = 18, startNonces // ✅ 可选：前端预获取的 nonces
+    const { sellerPrivateKey, sellAmount, sellPercentage, buyerPrivateKeys, buyerRatios, buyerAmounts, tokenAddress, routeParams, config, quoteToken, quoteTokenDecimals = 18, disperseHopCount = 0, // ✅ 转账多跳数（默认0=直接转账）
+    startNonces // ✅ 可选：前端预获取的 nonces
      } = params;
     // ✅ 判断是否使用原生代币
     const useNativeToken = !quoteToken || quoteToken === ZERO_ADDRESS;
     const WBNB = '0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c'.toLowerCase();
-    // ✅ 校验买方数量（子钱包已预留 BNB，不需要主钱包转 Gas）
-    // BNB 模式：贿赂(1) + 卖出(1) + 转账(N) + 买入(N) + 利润(1) ≤ 50 → 2N + 3 ≤ 50 → N ≤ 23
-    // ERC20 模式：贿赂(1) + 卖出(1) + ERC20转账(N) + 买入(N) + 利润(1) ≤ 50 → 2N + 3 ≤ 50 → N ≤ 23
-    const MAX_BUYERS = 23;
+    // ✅ 动态计算最大买方数量（根据多跳数）
+    // 固定开销: 贿赂(1) + 卖出(1) + 利润多跳(PROFIT_HOP_COUNT + 1)
+    // BNB 模式（无多跳）: 转账(N) + 买入(N) = 2N
+    // BNB 模式（有多跳H）: 转账(N*(H+1)) + 买入(N) = N*(H+2)
+    // ERC20 模式（无多跳）: 转账(N) + 买入(N) = 2N
+    // ERC20 模式（有多跳H）: BNB转账(N*(H+1)) + ERC20转账(N*(H+1)) + 买入(N) = N*(2H+3)
+    const fixedOverhead = 1 + 1 + PROFIT_HOP_COUNT + 1; // 贿赂 + 卖出 + 利润多跳
+    const maxTxs = 50 - fixedOverhead;
+    let MAX_BUYERS;
+    if (useNativeToken) {
+        // BNB 模式: N*(H+2) <= maxTxs => N <= maxTxs / (H+2)
+        MAX_BUYERS = Math.floor(maxTxs / (disperseHopCount + 2));
+    }
+    else {
+        // ERC20 模式: N*(2H+3) <= maxTxs => N <= maxTxs / (2H+3)
+        MAX_BUYERS = Math.floor(maxTxs / (2 * disperseHopCount + 3));
+    }
+    MAX_BUYERS = Math.max(1, MAX_BUYERS); // 至少1个
+    console.log(`[pancakeQuickBatchSwapMerkle] 多跳数: ${disperseHopCount}, 最大买方数: ${MAX_BUYERS}`);
     if (buyerPrivateKeys.length === 0) {
         throw new Error('至少需要一个买方钱包');
     }
     if (buyerPrivateKeys.length > MAX_BUYERS) {
         const mode = useNativeToken ? 'BNB' : 'ERC20';
-        throw new Error(`资金利用率模式(${mode})买方钱包数量超过限制: ${buyerPrivateKeys.length} > ${MAX_BUYERS}`);
+        throw new Error(`资金利用率模式(${mode}, ${disperseHopCount}跳)买方钱包数量超过限制: ${buyerPrivateKeys.length} > ${MAX_BUYERS}`);
     }
     // ✅ 校验分配模式
     if (!buyerRatios && !buyerAmounts) {
@@ -1020,50 +1264,89 @@ export async function pancakeQuickBatchSwapMerkle(params) {
         type: txType
     });
     console.log(`[pancakeQuickBatchSwapMerkle] 卖出交易已签名`);
-    // ==================== 3. 转账交易（并行签名）====================
+    // ==================== 3. 转账交易（支持多跳）====================
     const buyerGasCost = gasPrice * finalGasLimit;
-    // ✅ 预分配 nonce，然后并行签名
-    const transferNonces = buyers.map((_, i) => sellerNonce + i);
-    sellerNonce += buyers.length; // 更新 sellerNonce
-    let transferTxs;
-    if (useNativeToken) {
-        // ✅ 原生代币模式：直接 BNB 转账（并行签名）
-        transferTxs = await Promise.all(buyers.map((buyer, i) => {
-            const transferValue = transferAmountsWei[i] + FLAT_FEE + buyerGasCost;
-            return seller.signTransaction({
-                to: buyer.address,
-                value: transferValue,
-                nonce: transferNonces[i],
-                gasPrice,
-                gasLimit: 21000n,
-                chainId: context.chainId,
-                type: txType
-            });
-        }));
+    // ✅ 生成多跳路径
+    const hopPaths = generateDisperseHopPaths(buyers.map(b => b.address), disperseHopCount, context.provider);
+    // 收集所有中间钱包信息
+    const allHopWallets = [];
+    hopPaths.forEach(path => {
+        allHopWallets.push(...path.hopWalletsInfo);
+    });
+    let transferTxs = [];
+    if (disperseHopCount === 0) {
+        // ✅ 无多跳：直接转账
+        const transferNonces = buyers.map((_, i) => sellerNonce + i);
+        sellerNonce += buyers.length;
+        if (useNativeToken) {
+            transferTxs = await Promise.all(buyers.map((buyer, i) => {
+                const transferValue = transferAmountsWei[i] + FLAT_FEE + buyerGasCost;
+                return seller.signTransaction({
+                    to: buyer.address,
+                    value: transferValue,
+                    nonce: transferNonces[i],
+                    gasPrice,
+                    gasLimit: NATIVE_TRANSFER_GAS_LIMIT,
+                    chainId: context.chainId,
+                    type: txType
+                });
+            }));
+        }
+        else {
+            const erc20Interface = new ethers.Interface(ERC20_ABI);
+            transferTxs = await Promise.all(buyers.map((buyer, i) => {
+                const transferData = erc20Interface.encodeFunctionData('transfer', [
+                    buyer.address,
+                    transferAmountsWei[i]
+                ]);
+                return seller.signTransaction({
+                    to: quoteToken,
+                    data: transferData,
+                    value: 0n,
+                    nonce: transferNonces[i],
+                    gasPrice,
+                    gasLimit: ERC20_TRANSFER_GAS,
+                    chainId: context.chainId,
+                    type: txType
+                });
+            }));
+        }
     }
     else {
-        // ✅ ERC20 模式：ERC20 transfer（并行签名）
-        const erc20Interface = new ethers.Interface([
-            'function transfer(address to, uint256 amount) returns (bool)'
-        ]);
-        transferTxs = await Promise.all(buyers.map((buyer, i) => {
-            const transferData = erc20Interface.encodeFunctionData('transfer', [
-                buyer.address,
-                transferAmountsWei[i]
-            ]);
-            return seller.signTransaction({
-                to: quoteToken,
-                data: transferData,
-                value: 0n,
-                nonce: transferNonces[i],
-                gasPrice,
-                gasLimit: ERC20_TRANSFER_GAS,
-                chainId: context.chainId,
-                type: txType
-            });
-        }));
+        // ✅ 有多跳：构建多跳转账链
+        if (useNativeToken) {
+            // BNB 多跳转账
+            const hopChains = await Promise.all(hopPaths.map((path, i) => {
+                const finalAmount = transferAmountsWei[i] + FLAT_FEE + buyerGasCost;
+                const payerNonce = sellerNonce + i * (disperseHopCount + 1);
+                return buildNativeHopChain(seller, path, finalAmount, gasPrice, context.chainId, txType, payerNonce);
+            }));
+            transferTxs = hopChains.flat();
+            sellerNonce += buyers.length * (disperseHopCount + 1);
+        }
+        else {
+            // ERC20 多跳转账：先转 BNB（给中间钱包 gas），再转 ERC20
+            // 每个 buyer 需要 (H+1) 笔 BNB 转账 + (H+1) 笔 ERC20 转账
+            // 1. 构建 BNB 多跳链（为中间钱包和最终钱包预留 gas）
+            const bnbHopChains = await Promise.all(hopPaths.map((path, i) => {
+                // 最终钱包需要的 gas（用于买入交易）
+                const finalGasAmount = buyerGasCost;
+                const payerNonce = sellerNonce + i * (disperseHopCount + 1);
+                return buildBNBHopChainForERC20(seller, path, finalGasAmount, gasPrice, context.chainId, txType, payerNonce);
+            }));
+            const bnbTxs = bnbHopChains.flat();
+            sellerNonce += buyers.length * (disperseHopCount + 1);
+            // 2. 构建 ERC20 多跳链
+            const erc20HopChains = await Promise.all(hopPaths.map((path, i) => {
+                const payerNonce = sellerNonce + i * (disperseHopCount + 1);
+                return buildERC20HopChain(seller, path, quoteToken, transferAmountsWei[i], gasPrice, context.chainId, txType, payerNonce);
+            }));
+            const erc20Txs = erc20HopChains.flat();
+            sellerNonce += buyers.length * (disperseHopCount + 1);
+            transferTxs = [...bnbTxs, ...erc20Txs];
+        }
     }
-    console.log(`[pancakeQuickBatchSwapMerkle] ${transferTxs.length} 笔转账交易已签名`);
+    console.log(`[pancakeQuickBatchSwapMerkle] ${transferTxs.length} 笔转账交易已签名 (多跳数=${disperseHopCount})`);
     // ==================== 4. 买入交易 ====================
     // ✅ 如果前端传入了 startNonces，使用 buyer 部分（从索引 1 开始）
     const buyerNonces = startNonces && startNonces.length > 1
@@ -1150,6 +1433,7 @@ export async function pancakeQuickBatchSwapMerkle(params) {
     const outputUnit = useNativeToken ? 'BNB' : 'ERC20';
     return {
         signedTransactions,
+        disperseHopWallets: allHopWallets.length > 0 ? allHopWallets : undefined, // ✅ 返回中间钱包信息
         metadata: {
             sellerAddress: seller.address,
             buyerAddresses: buyers.map(b => b.address),
@@ -1161,7 +1445,8 @@ export async function pancakeQuickBatchSwapMerkle(params) {
                 ? ethers.formatEther(amt)
                 : ethers.formatUnits(amt, quoteTokenDecimals)),
             profitAmount: profitAmount > 0n ? ethers.formatEther(profitAmount) : undefined,
-            useNativeToken
+            useNativeToken,
+            disperseHopCount: disperseHopCount > 0 ? disperseHopCount : undefined // ✅ 返回多跳数
         }
     };
 }

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[][];
     /** 批次结果 */