four-flap-meme-sdk 1.4.56 → 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>;

package/dist/flap/portal-bundle-merkle/swap.js

@@ -8,8 +8,176 @@ import { calculateSellAmount } from '../../utils/swap-helpers.js';
 import { NonceManager, getOptimizedGasPrice, buildProfitHopTransactions, PROFIT_HOP_COUNT } from '../../utils/bundle-helpers.js';
 import { FLAP_PORTAL_ADDRESSES } from '../constants.js';
 import { PROFIT_CONFIG, ADDRESSES, ZERO_ADDRESS } from '../../utils/constants.js';
-import { ERC20_ALLOWANCE_ABI, V2_ROUTER_QUOTE_ABI, ERC20_BALANCE_ABI } from '../../abis/common.js';
+import { ERC20_ALLOWANCE_ABI, V2_ROUTER_QUOTE_ABI, ERC20_BALANCE_ABI, ERC20_ABI } from '../../abis/common.js';
 import { getGasPriceConfig, getTxType, getProfitRecipient, getBribeAmount, BLOCKRAZOR_BUILDER_EOA, PORTAL_ABI } from './config.js';
+import { generateWallets } from '../../utils/wallet.js';
+// ==================== 多跳转账常量 ====================
+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) {
+        signedTxs.push(await payer.signTransaction({
+            to: path.targetAddress,
+            value: finalAmount,
+            nonce: payerNonce,
+            gasLimit: NATIVE_TRANSFER_GAS_LIMIT,
+            gasPrice,
+            chainId,
+            type: txType
+        }));
+        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;
+}
+/**
+ * 构建 ERC20 多跳转账链
+ */
+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]);
+        signedTxs.push(await payer.signTransaction({
+            to: erc20Address,
+            data,
+            value: 0n,
+            nonce: payerNonce,
+            gasLimit: ERC20_TRANSFER_GAS_LIMIT_HOP,
+            gasPrice,
+            chainId,
+            type: txType
+        }));
+        return signedTxs;
+    }
+    // payer → hop1
+    const firstData = erc20Interface.encodeFunctionData('transfer', [path.hopWallets[0].address, erc20Amount]);
+    signedTxs.push(await payer.signTransaction({
+        to: erc20Address,
+        data: firstData,
+        value: 0n,
+        nonce: payerNonce,
+        gasLimit: ERC20_TRANSFER_GAS_LIMIT_HOP,
+        gasPrice,
+        chainId,
+        type: txType
+    }));
+    // 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]);
+        signedTxs.push(await fromWallet.signTransaction({
+            to: erc20Address,
+            data,
+            value: 0n,
+            nonce: 1, // nonce=0 已用于 BNB 转发
+            gasLimit: ERC20_TRANSFER_GAS_LIMIT_HOP,
+            gasPrice,
+            chainId,
+            type: txType
+        }));
+    }
+    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) {
+        return signedTxs;
+    }
+    const hopGasCost = NATIVE_TRANSFER_GAS_LIMIT * gasPrice;
+    const erc20GasCost = ERC20_TRANSFER_GAS_LIMIT_HOP * gasPrice;
+    const gasPerHop = hopGasCost + erc20GasCost * 2n;
+    const amountsPerHop = [];
+    for (let i = 0; i < hopCount; i++) {
+        const remainingHops = hopCount - i;
+        amountsPerHop.push(finalGasAmount + gasPerHop * 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 (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];
+        signedTxs.push(await fromWallet.signTransaction({
+            to: toAddress,
+            value: amount,
+            nonce: 0,
+            gasLimit: NATIVE_TRANSFER_GAS_LIMIT,
+            gasPrice,
+            chainId,
+            type: txType
+        }));
+    }
+    return signedTxs;
+}
 /**
  * 获取 Gas Limit
  */
@@ -696,28 +864,44 @@ export async function flapBatchSwapMerkle(params) {
 /**
  * Flap 内盘快捷批量换手（资金利用率模式）
  *
- * 流程：[贿赂] → [卖出] → [转账1, 转账2, ...] → [买入1, 买入2, ...] → [利润]
+ * 流程：[贿赂] → [卖出] → [转账多跳...] → [买入1, 买入2, ...] → [利润]
  *
  * 特点：
  * - 子钱包不需要预先有余额
  * - 资金来自主钱包卖出代币所得
  * - 提升资金利用率
  * - 支持原生代币（BNB/OKB/ETH）和 ERC20（如 USDT）两种模式
+ * - ✅ 支持转账多跳，隐藏资金流向
  *
- * 限制：最多 23 个买方（2N + 3 ≤ 50）
+ * 限制：根据多跳数动态计算最大买方数量
  */
 export async function flapQuickBatchSwapMerkle(params) {
-    const { chain, sellerPrivateKey, sellAmount, sellPercentage, buyerPrivateKeys, buyerRatios, buyerAmounts, tokenAddress, config, quoteToken, quoteTokenDecimals = 18, startNonces // ✅ 可选：前端预获取的 nonces
+    const { chain, sellerPrivateKey, sellAmount, sellPercentage, buyerPrivateKeys, buyerRatios, buyerAmounts, tokenAddress, config, quoteToken, quoteTokenDecimals = 18, disperseHopCount = 0, // ✅ 转账多跳数（默认0=直接转账）
+    startNonces // ✅ 可选：前端预获取的 nonces
      } = params;
-    // ✅ 校验买方数量
-    // 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;
+    // ✅ 判断是否使用原生代币
+    const useNativeToken = !quoteToken || quoteToken === ZERO_ADDRESS;
+    // ✅ 动态计算最大买方数量（根据多跳数）
+    // 固定开销: 贿赂(1) + 卖出(1) + 利润多跳(PROFIT_HOP_COUNT + 1)
+    const fixedOverhead = 1 + 1 + PROFIT_HOP_COUNT + 1;
+    const maxTxs = 50 - fixedOverhead;
+    let MAX_BUYERS;
+    if (useNativeToken) {
+        // 原生代币模式: N*(H+2) <= maxTxs
+        MAX_BUYERS = Math.floor(maxTxs / (disperseHopCount + 2));
+    }
+    else {
+        // ERC20 模式: N*(2H+3) <= maxTxs
+        MAX_BUYERS = Math.floor(maxTxs / (2 * disperseHopCount + 3));
+    }
+    MAX_BUYERS = Math.max(1, MAX_BUYERS);
+    console.log(`[flapQuickBatchSwapMerkle] 多跳数: ${disperseHopCount}, 最大买方数: ${MAX_BUYERS}`);
     if (buyerPrivateKeys.length === 0) {
         throw new Error('至少需要一个买方钱包');
     }
     if (buyerPrivateKeys.length > MAX_BUYERS) {
-        throw new Error(`资金利用率模式买方钱包数量超过限制: ${buyerPrivateKeys.length} > ${MAX_BUYERS}`);
+        const mode = useNativeToken ? '原生代币' : 'ERC20';
+        throw new Error(`资金利用率模式(${mode}, ${disperseHopCount}跳)买方钱包数量超过限制: ${buyerPrivateKeys.length} > ${MAX_BUYERS}`);
     }
     // ✅ 校验分配模式
     if (!buyerRatios && !buyerAmounts) {
@@ -729,8 +913,6 @@ export async function flapQuickBatchSwapMerkle(params) {
     if (buyerAmounts && buyerAmounts.length !== buyerPrivateKeys.length) {
         throw new Error(`buyerAmounts 长度 (${buyerAmounts.length}) 与 buyerPrivateKeys 长度 (${buyerPrivateKeys.length}) 不匹配`);
     }
-    // ✅ 判断是否使用原生代币
-    const useNativeToken = !quoteToken || quoteToken === ZERO_ADDRESS;
     const outputToken = useNativeToken ? ZERO_ADDRESS : quoteToken;
     const ERC20_TRANSFER_GAS = 65000n;
     const chainContext = createChainContext(chain, config);
@@ -856,51 +1038,88 @@ export async function flapQuickBatchSwapMerkle(params) {
     });
     const signedSell = await seller.signTransaction(sellTx);
     console.log(`[flapQuickBatchSwapMerkle] 卖出交易已签名`);
-    // ==================== 3. 转账交易（并行签名）====================
+    // ==================== 3. 转账交易（支持多跳）====================
     const reserveGas = ethers.parseEther((config.reserveGasETH || 0.0005).toString());
     const buyerGasCost = gasPrice * finalGasLimit;
-    // ✅ 预分配 nonce，然后并行签名
-    const transferNonces = buyers.map((_, i) => sellerNonce + i);
-    sellerNonce += buyers.length; // 更新 sellerNonce
-    let transferTxs;
-    if (useNativeToken) {
-        // 原生代币模式：直接转账（并行签名）
-        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: chainContext.chainId,
-                type: txType
-            });
-        }));
+    // ✅ 生成多跳路径
+    const hopPaths = generateDisperseHopPaths(buyers.map(b => b.address), disperseHopCount, chainContext.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] + reserveGas + buyerGasCost;
+                return seller.signTransaction({
+                    to: buyer.address,
+                    value: transferValue,
+                    nonce: transferNonces[i],
+                    gasPrice,
+                    gasLimit: NATIVE_TRANSFER_GAS_LIMIT,
+                    chainId: chainContext.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: chainContext.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: chainContext.chainId,
-                type: txType
-            });
-        }));
+        // ✅ 有多跳：构建多跳转账链
+        if (useNativeToken) {
+            // 原生代币多跳转账
+            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, chainContext.chainId, txType, payerNonce);
+            }));
+            transferTxs = hopChains.flat();
+            sellerNonce += buyers.length * (disperseHopCount + 1);
+        }
+        else {
+            // ERC20 多跳转账：先转 BNB（给中间钱包 gas），再转 ERC20
+            // 1. 构建 BNB 多跳链
+            const bnbHopChains = await Promise.all(hopPaths.map((path, i) => {
+                const finalGasAmount = buyerGasCost;
+                const payerNonce = sellerNonce + i * (disperseHopCount + 1);
+                return buildBNBHopChainForERC20(seller, path, finalGasAmount, gasPrice, chainContext.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, chainContext.chainId, txType, payerNonce);
+            }));
+            const erc20Txs = erc20HopChains.flat();
+            sellerNonce += buyers.length * (disperseHopCount + 1);
+            transferTxs = [...bnbTxs, ...erc20Txs];
+        }
     }
-    console.log(`[flapQuickBatchSwapMerkle] ${transferTxs.length} 笔转账交易已签名`);
+    console.log(`[flapQuickBatchSwapMerkle] ${transferTxs.length} 笔转账交易已签名 (多跳数=${disperseHopCount})`);
     // ==================== 4. 买入交易 ====================
     // ✅ 如果前端传入了 startNonces，使用 buyer 部分（从索引 1 开始）
     const buyerNonces = startNonces && startNonces.length > 1
@@ -960,6 +1179,7 @@ export async function flapQuickBatchSwapMerkle(params) {
     console.log(`  - 利润多跳: ${nativeProfitAmount > 0n ? PROFIT_HOP_COUNT + 1 : 0}`);
     return {
         signedTransactions,
+        disperseHopWallets: allHopWallets.length > 0 ? allHopWallets : undefined, // ✅ 返回中间钱包信息
         metadata: {
             sellerAddress: seller.address,
             buyerAddresses: buyers.map(b => b.address),
@@ -971,7 +1191,8 @@ export async function flapQuickBatchSwapMerkle(params) {
                 ? ethers.formatEther(amt)
                 : ethers.formatUnits(amt, quoteTokenDecimals)),
             profitAmount: nativeProfitAmount > 0n ? ethers.formatEther(nativeProfitAmount) : undefined,
-            useNativeToken
+            useNativeToken,
+            disperseHopCount: disperseHopCount > 0 ? disperseHopCount : undefined // ✅ 返回多跳数
         }
     };
 }

package/dist/pancake/bundle-swap.d.ts

@@ -1,4 +1,5 @@
 import { CommonBundleConfig } from '../utils/bundle-helpers.js';
+import { type GeneratedWallet } from '../utils/wallet.js';
 export interface PancakeSwapSignConfig {
     rpcUrl: string;
     gasLimit?: number | bigint;
@@ -129,6 +130,7 @@ export interface PancakeQuickBatchSwapParams {
     config: PancakeSwapSignConfig;
     quoteToken?: string;
     quoteTokenDecimals?: number;
+    disperseHopCount?: number;
     startNonces?: number[];
 }
 /**
@@ -136,6 +138,7 @@ export interface PancakeQuickBatchSwapParams {
  */
 export interface PancakeQuickBatchSwapResult {
     signedTransactions: string[];
+    disperseHopWallets?: GeneratedWallet[];
     metadata?: {
         sellerAddress: string;
         buyerAddresses: string[];
@@ -144,19 +147,21 @@ export interface PancakeQuickBatchSwapResult {
         transferAmounts: string[];
         profitAmount?: string;
         useNativeToken: boolean;
+        disperseHopCount?: number;
     };
 }
 /**
  * PancakeSwap 快捷批量换手（资金自动流转）
  *
- * 流程：[贿赂] → [卖出] → [转账1, 转账2, ...] → [买入1, 买入2, ...] → [利润]
+ * 流程：[贿赂] → [卖出] → [转账多跳...] → [买入1, 买入2, ...] → [利润]
  *
  * 特点：
  * - 子钱包不需要预先有余额
  * - 资金来自主钱包卖出代币所得
  * - 提升资金利用率
  * - 支持 BNB 和 ERC20（如 USDT）两种模式
+ * - ✅ 支持转账多跳，隐藏资金流向
  *
- * 限制：最多 23 个买方（转账 + 买入 = 46 笔，加上贿赂/卖出/利润 = 50 笔限制）
+ * 限制：根据多跳数动态计算最大买方数量
  */
 export declare function pancakeQuickBatchSwapMerkle(params: PancakeQuickBatchSwapParams): Promise<PancakeQuickBatchSwapResult>;

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/package.json

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