four-flap-meme-sdk 1.4.54 → 1.4.56

package/dist/clients/four.js

@@ -1,7 +1,7 @@
 export class FourClient {
     constructor(cfg) {
         // 默认使用 Cloudflare Workers 代理，已配置 CORS，浏览器可直接使用
-        this.baseUrl = cfg?.baseUrl || 'https://throbbing-shape-a160.paulalsop072.workers.dev';
+        this.baseUrl = cfg?.baseUrl || 'https://bscfourapi.emit.tools';
     }
     async generateNonce(req) {
         const r = await fetch(`${this.baseUrl}/v1/private/user/nonce/generate`, {

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

@@ -1,3 +1,3 @@
 export declare const TM_ABI: string[];
 export declare const HELPER3_ABI: string[];
-export declare const TM_ADDRESS: "0x342399a59943B5815849657Aa0e06D7058D9d5C6";
+export declare const TM_ADDRESS: "0x5c952063c7fc8610FFDB798152D69F0B9550762b";

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

@@ -14,4 +14,5 @@ export const HELPER3_ABI = [
     'function tryBuy(address token, uint256 amount, uint256 funds) view returns (address tokenManager, address quote, uint256 estimatedAmount, uint256 estimatedCost, uint256 estimatedFee, uint256 amountMsgValue, uint256 amountApproval, uint256 amountFunds)',
     'function trySell(address token, uint256 amount) view returns (address tokenManager, address quote, uint256 funds, uint256 fee)'
 ];
-export const TM_ADDRESS = ADDRESSES.BSC.TokenManagerV2Proxy;
+// ✅ Four.meme 使用 TokenManagerOriginal（代理合约已移除）
+export const TM_ADDRESS = ADDRESSES.BSC.TokenManagerOriginal;

package/dist/contracts/tm-bundle.js

@@ -176,7 +176,7 @@ export async function createTokenWithBundleBuy(params) {
         clickFun: false,
     });
     // 4. 构建交易
-    const tmAddr = ADDRESSES.BSC.TokenManagerV2Proxy;
+    const tmAddr = ADDRESSES.BSC.TokenManagerOriginal;
     // ✅ 获取 gas price
     let gasPrice;
     if (club48) {
@@ -403,7 +403,7 @@ export async function batchBuyWithBundle(params) {
         explorerEndpoint: config.club48ExplorerEndpoint
     });
     const blockOffset = config.bundleBlockOffset ?? 100;
-    const tmAddr = ADDRESSES.BSC.TokenManagerV2Proxy;
+    const tmAddr = ADDRESSES.BSC.TokenManagerOriginal;
     const gasPrice = await club48.getMinGasPrice();
     const signedTxs = [];
     const nextNonceMap = new Map();
@@ -535,7 +535,7 @@ export async function batchSellWithBundle(params) {
         explorerEndpoint: config.club48ExplorerEndpoint
     });
     const blockOffset = config.bundleBlockOffset ?? 100;
-    const tmAddr = ADDRESSES.BSC.TokenManagerV2Proxy;
+    const tmAddr = ADDRESSES.BSC.TokenManagerOriginal;
     const gasPrice = await club48.getMinGasPrice();
     const signedTxs = [];
     const nextNonceMap = new Map();
@@ -666,7 +666,7 @@ export async function fourPrivateBuy(params) {
     const provider = new JsonRpcProvider(rpcUrl);
     const wallet = new Wallet(privateKey, provider);
     const club48 = new Club48Client({ endpoint: club48Endpoint, explorerEndpoint: club48ExplorerEndpoint });
-    const tmAddr = ADDRESSES.BSC.TokenManagerV2Proxy;
+    const tmAddr = ADDRESSES.BSC.TokenManagerOriginal;
     const gasPrice = await club48.getMinGasPrice();
     const fundsWei = ethers.parseEther(funds);
     const minAmount = 0n;
@@ -686,7 +686,7 @@ export async function fourPrivateSell(params) {
     const provider = new JsonRpcProvider(rpcUrl);
     const wallet = new Wallet(privateKey, provider);
     const club48 = new Club48Client({ endpoint: club48Endpoint, explorerEndpoint: club48ExplorerEndpoint });
-    const tmAddr = ADDRESSES.BSC.TokenManagerV2Proxy;
+    const tmAddr = ADDRESSES.BSC.TokenManagerOriginal;
     const gasPrice = await club48.getMinGasPrice();
     const amountWei = ethers.parseUnits(amount, 18);
     const minOut = minFunds ?? 0n;
@@ -707,7 +707,7 @@ export async function fourBatchPrivateBuy(params) {
         throw new Error('privateKeys and fundsList length mismatch');
     const provider = new JsonRpcProvider(rpcUrl);
     const club48 = new Club48Client({ endpoint: club48Endpoint, explorerEndpoint: club48ExplorerEndpoint });
-    const tmAddr = ADDRESSES.BSC.TokenManagerV2Proxy;
+    const tmAddr = ADDRESSES.BSC.TokenManagerOriginal;
     // ✅ 并行处理
     const wallets = privateKeys.map(pk => new Wallet(pk, provider));
     const fundsWeiList = fundsList.map(f => ethers.parseEther(f));
@@ -757,7 +757,7 @@ export async function fourBatchPrivateSell(params) {
         throw new Error('privateKeys and amounts length mismatch');
     const provider = new JsonRpcProvider(rpcUrl);
     const club48 = new Club48Client({ endpoint: club48Endpoint, explorerEndpoint: club48ExplorerEndpoint });
-    const tmAddr = ADDRESSES.BSC.TokenManagerV2Proxy;
+    const tmAddr = ADDRESSES.BSC.TokenManagerOriginal;
     const minOut = minFundsEach ?? 0n;
     // ✅ 并行处理
     const wallets = privateKeys.map(pk => new Wallet(pk, provider));

package/dist/utils/constants.d.ts

@@ -55,8 +55,6 @@ export declare const ADDRESSES: {
         readonly USDC: "0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d";
         readonly BUSD: "0xe9e7CEA3DedcA5984780Bafc599bD69ADd087D56";
         readonly TokenManagerOriginal: "0x5c952063c7fc8610FFDB798152D69F0B9550762b";
-        readonly TokenManagerV1Proxy: "0xf7F823d0E790219dBf727bDb971837574655fCB0";
-        readonly TokenManagerV2Proxy: "0x342399a59943B5815849657Aa0e06D7058D9d5C6";
         readonly TokenManagerV1: "0xf7F823d0E790219dBf727bDb971837574655fCB0";
         readonly TokenManagerV2: "0x342399a59943B5815849657Aa0e06D7058D9d5C6";
         readonly TokenManagerHelper3: "0xF251F83e40a78868FcfA3FA4599Dad6494E46034";

package/dist/utils/constants.js

@@ -51,9 +51,6 @@ export const ADDRESSES = {
         // ========== Four.meme 合约 ==========
         // 原始合约（TokenManager2，创建代币专用，不收费）
         TokenManagerOriginal: '0x5c952063c7fc8610FFDB798152D69F0B9550762b',
-        // 代理合约（收费版，仅交易）
-        TokenManagerV1Proxy: '0xf7F823d0E790219dBf727bDb971837574655fCB0',
-        TokenManagerV2Proxy: '0x342399a59943B5815849657Aa0e06D7058D9d5C6',
         // ✅ 向后兼容别名（保持旧代码可用）
         TokenManagerV1: '0xf7F823d0E790219dBf727bDb971837574655fCB0',
         TokenManagerV2: '0x342399a59943B5815849657Aa0e06D7058D9d5C6',

package/dist/utils/erc20.js

@@ -299,7 +299,7 @@ function resolveSpenderAddress(chain, platform) {
             MONAD: ADDRESSES.MONAD.FlapPortal, // ✅ Monad Flap Portal
         },
         four: {
-            // Four.meme 使用 TokenManagerOriginal（买卖交易实际使用的合约）
+            // ✅ Four.meme 使用 TokenManagerOriginal（代理合约已移除）
             BSC: ADDRESSES.BSC.TokenManagerOriginal,
             BASE: ADDRESSES.BASE.TokenManagerHelper3,
             XLAYER: ZERO_ADDRESS, // XLAYER 暂不支持 Four.meme

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 稳定币地址
  */
@@ -264,26 +405,35 @@ async function buildV2BuyTx(wallet, tokenAddress, buyAmount, nonce, gasPrice, ga
 /**
  * 构建 V3 单跳买入交易
  * BNB → Token (使用 exactInputSingle + multicall)
+ *
+ * ✅ 修复：使用 ethers.Interface 手动编码 calldata，避免 multicall 重载问题
  */
 async function buildV3BuyTx(wallet, tokenAddress, buyAmount, nonce, gasPrice, gasLimit, chainId, txType, v3Fee = 2500 // 默认 0.25% 手续费
 ) {
     const deadline = getDeadline();
     const v3RouterIface = new ethers.Interface(V3_ROUTER02_ABI);
     // 构建 exactInputSingle calldata
-    const exactInputSingleData = v3RouterIface.encodeFunctionData('exactInputSingle', [{
-            tokenIn: WBNB_ADDRESS,
-            tokenOut: tokenAddress,
-            fee: v3Fee,
-            recipient: wallet.address,
-            amountIn: buyAmount,
-            amountOutMinimum: 0n,
-            sqrtPriceLimitX96: 0n
-        }]);
-    // 使用 multicall 包装，传入 deadline 和 ETH value
-    const v3Router = new Contract(PANCAKE_V3_ROUTER_ADDRESS, V3_ROUTER02_ABI, wallet);
-    const unsigned = await v3Router.multicall.populateTransaction(deadline, [exactInputSingleData], { value: buyAmount });
+    const swapParams = {
+        tokenIn: WBNB_ADDRESS,
+        tokenOut: tokenAddress,
+        fee: v3Fee,
+        recipient: wallet.address,
+        amountIn: buyAmount,
+        amountOutMinimum: 0n,
+        sqrtPriceLimitX96: 0n
+    };
+    const exactInputSingleData = v3RouterIface.encodeFunctionData('exactInputSingle', [swapParams]);
+    // ✅ 添加 refundETH，退还多余的 ETH
+    const refundETHData = v3RouterIface.encodeFunctionData('refundETH', []);
+    // ✅ 使用明确的函数签名编码 multicall，避免重载问题
+    const multicallData = v3RouterIface.encodeFunctionData('multicall(uint256,bytes[])', [
+        deadline,
+        [exactInputSingleData, refundETHData]
+    ]);
     const tx = {
-        ...unsigned,
+        to: PANCAKE_V3_ROUTER_ADDRESS,
+        data: multicallData,
+        value: buyAmount,
         nonce,
         gasLimit: BigInt(gasLimit),
         chainId
@@ -331,25 +481,32 @@ async function buildV2BuyTxWithERC20(wallet, tokenAddress, baseTokenAddress, buy
 /**
  * 构建 V3 买入交易（ERC20 输入）
  * USDT/USDC → Token (使用 exactInputSingle + multicall)
+ *
+ * ✅ 修复：使用 ethers.Interface 手动编码 calldata，避免 multicall 重载问题
  */
 async function buildV3BuyTxWithERC20(wallet, tokenAddress, baseTokenAddress, buyAmount, nonce, gasPrice, gasLimit, chainId, txType, v3Fee = 2500) {
     const deadline = getDeadline();
     const v3RouterIface = new ethers.Interface(V3_ROUTER02_ABI);
     // 构建 exactInputSingle calldata
-    const exactInputSingleData = v3RouterIface.encodeFunctionData('exactInputSingle', [{
-            tokenIn: baseTokenAddress,
-            tokenOut: tokenAddress,
-            fee: v3Fee,
-            recipient: wallet.address,
-            amountIn: buyAmount,
-            amountOutMinimum: 0n,
-            sqrtPriceLimitX96: 0n
-        }]);
-    // 使用 multicall 包装（无需 ETH value）
-    const v3Router = new Contract(PANCAKE_V3_ROUTER_ADDRESS, V3_ROUTER02_ABI, wallet);
-    const unsigned = await v3Router.multicall.populateTransaction(deadline, [exactInputSingleData]);
+    const swapParams = {
+        tokenIn: baseTokenAddress,
+        tokenOut: tokenAddress,
+        fee: v3Fee,
+        recipient: wallet.address,
+        amountIn: buyAmount,
+        amountOutMinimum: 0n,
+        sqrtPriceLimitX96: 0n
+    };
+    const exactInputSingleData = v3RouterIface.encodeFunctionData('exactInputSingle', [swapParams]);
+    // ✅ 使用明确的函数签名编码 multicall，避免重载问题
+    const multicallData = v3RouterIface.encodeFunctionData('multicall(uint256,bytes[])', [
+        deadline,
+        [exactInputSingleData]
+    ]);
     const tx = {
-        ...unsigned,
+        to: PANCAKE_V3_ROUTER_ADDRESS,
+        data: multicallData,
+        value: 0n,
         nonce,
         gasLimit: BigInt(gasLimit),
         chainId
@@ -389,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,
@@ -410,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);
@@ -463,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;
@@ -478,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.54",
+  "version": "1.4.56",
   "description": "SDK for Flap bonding curve and four.meme TokenManager",
   "type": "module",
   "main": "dist/index.js",