four-flap-meme-sdk 1.4.55 → 1.4.57

package/dist/contracts/tm-bundle-merkle/swap.d.ts

@@ -4,6 +4,7 @@
  * 功能：钱包A卖出代币 → 钱包B买入相同数量 → 原子执行
  */
 import { CommonBundleConfig } from '../../utils/bundle-helpers.js';
+import { type GeneratedWallet } from '../../utils/wallet.js';
 export interface FourSwapSignConfig {
     rpcUrl: string;
     gasLimit?: number | bigint;
@@ -105,6 +106,7 @@ export interface FourQuickBatchSwapSignParams {
     buyerAmounts?: string[];
     tokenAddress: string;
     config: FourSwapSignConfig;
+    disperseHopCount?: number;
     startNonces?: number[];
 }
 /**
@@ -112,6 +114,7 @@ export interface FourQuickBatchSwapSignParams {
  */
 export interface FourQuickBatchSwapResult {
     signedTransactions: string[];
+    disperseHopWallets?: GeneratedWallet[];
     metadata?: {
         sellerAddress: string;
         buyerAddresses: string[];
@@ -119,18 +122,20 @@ export interface FourQuickBatchSwapResult {
         estimatedBNBOut: string;
         transferAmounts: string[];
         profitAmount?: string;
+        disperseHopCount?: number;
     };
 }
 /**
  * Four 内盘快捷批量换手（资金利用率模式）
  *
- * 流程：[贿赂] → [卖出] → [转账1, 转账2, ...] → [买入1, 买入2, ...] → [利润]
+ * 流程：[贿赂] → [卖出] → [转账多跳...] → [买入1, 买入2, ...] → [利润]
  *
  * 特点：
  * - 子钱包不需要预先有 BNB
  * - 资金来自主钱包卖出代币所得
  * - 提升资金利用率
+ * - ✅ 支持转账多跳，隐藏资金流向
  *
- * 限制：最多 23 个买方（2N + 3 ≤ 50）
+ * 限制：根据多跳数动态计算最大买方数量
  */
 export declare function fourQuickBatchSwapMerkle(params: FourQuickBatchSwapSignParams): Promise<FourQuickBatchSwapResult>;

package/dist/contracts/tm-bundle-merkle/swap.js

@@ -9,6 +9,79 @@ import { NonceManager, getOptimizedGasPrice, getGasLimit, getGasPriceConfig, get
 import { ADDRESSES, PROFIT_CONFIG, BLOCKRAZOR_BUILDER_EOA } from '../../utils/constants.js';
 import { TM_ABI, HELPER3_ABI, TM_ADDRESS } from './swap-internal.js';
 import { getBribeAmount, getProfitRecipient } from './config.js';
+import { generateWallets } from '../../utils/wallet.js';
+// ==================== 多跳转账常量 ====================
+const NATIVE_TRANSFER_GAS_LIMIT = 21055n;
+/**
+ * 生成分发多跳路径
+ */
+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,
+            gasPrice,
+            chainId,
+            type: txType
+        };
+        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
+    signedTxs.push(await payer.signTransaction({
+        to: path.hopWallets[0].address,
+        value: amountsPerHop[0],
+        nonce: payerNonce,
+        gasLimit: NATIVE_TRANSFER_GAS_LIMIT,
+        gasPrice,
+        chainId,
+        type: txType
+    }));
+    // 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];
+        signedTxs.push(await fromWallet.signTransaction({
+            to: toAddress,
+            value: amount,
+            nonce: 0,
+            gasLimit: NATIVE_TRANSFER_GAS_LIMIT,
+            gasPrice,
+            chainId,
+            type: txType
+        }));
+    }
+    return signedTxs;
+}
 /**
  * Four内盘捆绑换手
  */
@@ -430,26 +503,33 @@ export async function fourBatchSwapMerkle(params) {
 /**
  * Four 内盘快捷批量换手（资金利用率模式）
  *
- * 流程：[贿赂] → [卖出] → [转账1, 转账2, ...] → [买入1, 买入2, ...] → [利润]
+ * 流程：[贿赂] → [卖出] → [转账多跳...] → [买入1, 买入2, ...] → [利润]
  *
  * 特点：
  * - 子钱包不需要预先有 BNB
  * - 资金来自主钱包卖出代币所得
  * - 提升资金利用率
+ * - ✅ 支持转账多跳，隐藏资金流向
  *
- * 限制：最多 23 个买方（2N + 3 ≤ 50）
+ * 限制：根据多跳数动态计算最大买方数量
  */
 export async function fourQuickBatchSwapMerkle(params) {
-    const { sellerPrivateKey, sellAmount, sellPercentage, buyerPrivateKeys, buyerRatios, buyerAmounts, tokenAddress, config, startNonces // ✅ 可选：前端预获取的 nonces
+    const { sellerPrivateKey, sellAmount, sellPercentage, buyerPrivateKeys, buyerRatios, buyerAmounts, tokenAddress, config, disperseHopCount = 0, // ✅ 转账多跳数（默认0=直接转账）
+    startNonces // ✅ 可选：前端预获取的 nonces
      } = params;
-    // ✅ 校验买方数量
-    // 贿赂(1) + 卖出(1) + 转账(N) + 买入(N) + 利润(1) ≤ 50 → 2N + 3 ≤ 50 → N ≤ 23
-    const MAX_BUYERS = 23;
+    // ✅ 动态计算最大买方数量（根据多跳数）
+    // 固定开销: 贿赂(1) + 卖出(1) + 利润多跳(PROFIT_HOP_COUNT + 1)
+    // 转账(N*(H+1)) + 买入(N) = N*(H+2)
+    const fixedOverhead = 1 + 1 + PROFIT_HOP_COUNT + 1;
+    const maxTxs = 50 - fixedOverhead;
+    let MAX_BUYERS = Math.floor(maxTxs / (disperseHopCount + 2));
+    MAX_BUYERS = Math.max(1, MAX_BUYERS);
+    console.log(`[fourQuickBatchSwapMerkle] 多跳数: ${disperseHopCount}, 最大买方数: ${MAX_BUYERS}`);
     if (buyerPrivateKeys.length === 0) {
         throw new Error('至少需要一个买方钱包');
     }
     if (buyerPrivateKeys.length > MAX_BUYERS) {
-        throw new Error(`资金利用率模式买方钱包数量超过限制: ${buyerPrivateKeys.length} > ${MAX_BUYERS}`);
+        throw new Error(`资金利用率模式(${disperseHopCount}跳)买方钱包数量超过限制: ${buyerPrivateKeys.length} > ${MAX_BUYERS}`);
     }
     // ✅ 校验分配模式
     if (!buyerRatios && !buyerAmounts) {
@@ -559,25 +639,45 @@ export async function fourQuickBatchSwapMerkle(params) {
         type: txType
     });
     console.log(`[fourQuickBatchSwapMerkle] 卖出交易已签名`);
-    // ==================== 3. 转账交易（并行签名）====================
+    // ==================== 3. 转账交易（支持多跳）====================
     const reserveGas = ethers.parseEther((config.reserveGasBNB || 0.0005).toString());
     const buyerGasCost = gasPrice * finalGasLimit;
-    // ✅ 预分配 nonce，然后并行签名
-    const transferNonces = buyers.map((_, i) => sellerNonce + i);
-    sellerNonce += buyers.length; // 更新 sellerNonce
-    const transferTxs = await Promise.all(buyers.map((buyer, i) => {
-        const transferValue = transferAmountsWei[i] + reserveGas + buyerGasCost;
-        return seller.signTransaction({
-            to: buyer.address,
-            value: transferValue,
-            nonce: transferNonces[i],
-            gasPrice,
-            gasLimit: 21000n,
-            chainId: chainIdNum,
-            type: txType
-        });
-    }));
-    console.log(`[fourQuickBatchSwapMerkle] ${transferTxs.length} 笔转账交易已签名`);
+    // ✅ 生成多跳路径
+    const hopPaths = generateDisperseHopPaths(buyers.map(b => b.address), disperseHopCount, 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;
+        transferTxs = await Promise.all(buyers.map((buyer, i) => {
+            const transferValue = transferAmountsWei[i] + reserveGas + buyerGasCost;
+            return seller.signTransaction({
+                to: buyer.address,
+                value: transferValue,
+                nonce: transferNonces[i],
+                gasPrice,
+                gasLimit: NATIVE_TRANSFER_GAS_LIMIT,
+                chainId: chainIdNum,
+                type: txType
+            });
+        }));
+    }
+    else {
+        // ✅ 有多跳：构建多跳转账链
+        const hopChains = await Promise.all(hopPaths.map((path, i) => {
+            const finalAmount = transferAmountsWei[i] + reserveGas + buyerGasCost;
+            const payerNonce = sellerNonce + i * (disperseHopCount + 1);
+            return buildNativeHopChain(seller, path, finalAmount, gasPrice, chainIdNum, txType, payerNonce);
+        }));
+        transferTxs = hopChains.flat();
+        sellerNonce += buyers.length * (disperseHopCount + 1);
+    }
+    console.log(`[fourQuickBatchSwapMerkle] ${transferTxs.length} 笔转账交易已签名 (多跳数=${disperseHopCount})`);
     // ==================== 4. 买入交易 ====================
     // ✅ 如果前端传入了 startNonces，使用 buyer 部分（从索引 1 开始）
     const buyerNonces = startNonces && startNonces.length > 1
@@ -631,13 +731,15 @@ export async function fourQuickBatchSwapMerkle(params) {
     console.log(`  - 利润多跳: ${profitAmount > 0n ? PROFIT_HOP_COUNT + 1 : 0}`);
     return {
         signedTransactions,
+        disperseHopWallets: allHopWallets.length > 0 ? allHopWallets : undefined, // ✅ 返回中间钱包信息
         metadata: {
             sellerAddress: seller.address,
             buyerAddresses: buyers.map(b => b.address),
             sellAmount: ethers.formatUnits(sellAmountWei, decimals),
             estimatedBNBOut: ethers.formatEther(estimatedBNBOut),
             transferAmounts: transferAmountsWei.map(amt => ethers.formatEther(amt)),
-            profitAmount: profitAmount > 0n ? ethers.formatEther(profitAmount) : undefined
+            profitAmount: profitAmount > 0n ? ethers.formatEther(profitAmount) : undefined,
+            disperseHopCount: disperseHopCount > 0 ? disperseHopCount : undefined // ✅ 返回多跳数
         }
     };
 }

package/dist/flap/portal-bundle-merkle/swap.d.ts

@@ -4,6 +4,7 @@
  * 功能：钱包A卖出代币 → 钱包B买入相同数量 → 原子执行
  */
 import { CommonBundleConfig } from '../../utils/bundle-helpers.js';
+import { type GeneratedWallet } from '../../utils/wallet.js';
 export interface FlapSwapSignConfig {
     rpcUrl: string;
     gasLimit?: number | bigint;
@@ -118,6 +119,7 @@ export interface FlapQuickBatchSwapSignParams {
     config: FlapSwapSignConfig;
     quoteToken?: string;
     quoteTokenDecimals?: number;
+    disperseHopCount?: number;
     startNonces?: number[];
 }
 /**
@@ -125,6 +127,7 @@ export interface FlapQuickBatchSwapSignParams {
  */
 export interface FlapQuickBatchSwapResult {
     signedTransactions: string[];
+    disperseHopWallets?: GeneratedWallet[];
     metadata?: {
         sellerAddress: string;
         buyerAddresses: string[];
@@ -133,19 +136,21 @@ export interface FlapQuickBatchSwapResult {
         transferAmounts: string[];
         profitAmount?: string;
         useNativeToken: boolean;
+        disperseHopCount?: number;
     };
 }
 /**
  * Flap 内盘快捷批量换手（资金利用率模式）
  *
- * 流程：[贿赂] → [卖出] → [转账1, 转账2, ...] → [买入1, 买入2, ...] → [利润]
+ * 流程：[贿赂] → [卖出] → [转账多跳...] → [买入1, 买入2, ...] → [利润]
  *
  * 特点：
  * - 子钱包不需要预先有余额
  * - 资金来自主钱包卖出代币所得
  * - 提升资金利用率
  * - 支持原生代币（BNB/OKB/ETH）和 ERC20（如 USDT）两种模式
+ * - ✅ 支持转账多跳，隐藏资金流向
  *
- * 限制：最多 23 个买方（2N + 3 ≤ 50）
+ * 限制：根据多跳数动态计算最大买方数量
  */
 export declare function flapQuickBatchSwapMerkle(params: FlapQuickBatchSwapSignParams): Promise<FlapQuickBatchSwapResult>;