four-flap-meme-sdk 2.2.7 → 2.2.10

package/dist/utils/holders-maker.js

@@ -1,16 +1,640 @@
 /**
- * holders-maker - 主函数
+ * ============================================================================
+ * 刷持有人（Holders Maker）
+ * ============================================================================
+ * 一键完成：生成钱包 → 分发资金 → 批量买入（同一个 bundle 完成）
+ * 支持原生代币（BNB/MON）和 ERC20 代币（USDT/USDC）作为购买资金
  */
-import { ethers, JsonRpcProvider, Wallet } from 'ethers';
+import { ethers, JsonRpcProvider, Wallet, Contract } from 'ethers';
 import { generateWallets } from './wallet.js';
-import { NonceManager, getOptimizedGasPrice, buildProfitHopTransactions, PROFIT_HOP_COUNT } from './bundle-helpers.js';
-import { BLOCKRAZOR_BUILDER_EOA, getProfitRecipient } from '../shared/constants/index.js';
-import { getProfitRateBps as getSharedProfitRateBps } from '../shared/constants/index.js';
-import { getErrorMessageFromUnknown } from '../shared/foundation/index.js';
-import { DEFAULT_GAS_LIMIT, DEFAULT_GAS_PRICE_GWEI, DEFAULT_MAX_WALLETS_PER_BATCH_ERC20, DEFAULT_MAX_WALLETS_PER_BATCH_NATIVE, GAS_BUFFER_MULTIPLIER, NATIVE_TRANSFER_GAS_LIMIT, buildDaoaasBuyTx, buildDisperseHopChainERC20, buildDisperseHopChainNative, buildERC20ApproveTx, buildFlapBuyTx, buildFourBuyTx, buildNativeTransferTx, buildV2BuyTx, buildV2BuyTxWithERC20, buildV3BuyTx, buildV3BuyTxWithERC20, calculateMaxWalletsPerBatch, chunkArray, generateDisperseHopPaths, getBaseTokenAddress, getRouterAddress, } from './holders-maker-helpers.js';
+import { NonceManager, getOptimizedGasPrice, buildProfitHopTransactions, PROFIT_HOP_COUNT, getDeadline } from './bundle-helpers.js';
+import { ADDRESSES, BLOCKRAZOR_BUILDER_EOA, PROFIT_CONFIG, getProfitRecipient } from './constants.js';
+import { GAS_LIMITS } from '../shared/constants/index.js';
+import { FLAP_PORTAL_ADDRESSES } from '../shared/flap/constants.js';
+import { V2_ROUTER_ABI, V3_ROUTER02_ABI, V3_ROUTER_LEGACY_ABI, ERC20_ABI } from '../shared/abis/common.js';
+// Four 内盘 ABI
+const FOUR_TM2_ABI = [
+    'function buyTokenAMAP(uint256 origin, address token, address to, uint256 funds, uint256 minAmount) payable'
+];
+// PancakeSwap Router 地址 (BSC)
+const PANCAKE_V2_ROUTER_ADDRESS = ADDRESSES.BSC.PancakeV2Router;
+const PANCAKE_V3_ROUTER_ADDRESS = ADDRESSES.BSC.PancakeV3Router;
+const WBNB_ADDRESS = ADDRESSES.BSC.WBNB;
+// ERC20 稳定币地址 (BSC)
+const USDT_ADDRESS = ADDRESSES.BSC.USDT;
+const USDC_ADDRESS = ADDRESSES.BSC.USDC;
+// ✅ XLayer Router 地址
+const XLAYER_V2_ROUTER_ADDRESS = ADDRESSES.XLAYER.PotatoSwapV2Router;
+const XLAYER_V3_ROUTER_ADDRESS = ADDRESSES.XLAYER.PotatoSwapV3Router;
+const WOKB_ADDRESS = ADDRESSES.XLAYER.WOKB;
+// ✅ ENI Router 地址
+const ENI_V2_ROUTER_ADDRESS = ADDRESSES.ENI.DswapV2Router;
+const ENI_DAOAAS_PORTAL_ADDRESS = ADDRESSES.ENI.DaoaasPortal;
+const WEGAS_ADDRESS = ADDRESSES.ENI.WEGAS;
+// ERC20 转账和授权 Gas Limit（使用统一常量）
+const ERC20_TRANSFER_GAS_LIMIT = GAS_LIMITS.ERC20_TRANSFER;
+const ERC20_APPROVE_GAS_LIMIT = 50000n; // 授权 gas 相对固定
+// ============================================================================
+// 常量
+// ============================================================================
+const DEFAULT_GAS_LIMIT = 800000;
+const DEFAULT_GAS_PRICE_GWEI = 3;
+const GAS_BUFFER_MULTIPLIER = 2; // 2倍 Gas 费安全系数
+const NATIVE_TRANSFER_GAS_LIMIT = GAS_LIMITS.NATIVE_TRANSFER;
+/**
+ * 动态计算每批最大钱包数
+ *
+ * Bundle 限制 = 50 笔交易
+ * 固定开销:
+ *   BSC: 贿赂 1 笔 + 利润多跳 (PROFIT_HOP_COUNT + 1) 笔
+ *   XLayer: 利润 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, chain) {
+    // XLayer/ENI 不需要贿赂和利润多跳
+    const isSimpleChain = chain === 'XLAYER' || chain === 'ENI';
+    const fixedOverhead = isSimpleChain ? 1 : (1 + PROFIT_HOP_COUNT + 1); // XLayer/ENI: 利润 1; BSC: 贿赂 + 利润多跳
+    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);
+// ============================================================================
+// 辅助函数
+// ============================================================================
+/**
+ * 分批数组
+ */
+function chunkArray(arr, size) {
+    const chunks = [];
+    for (let i = 0; i < arr.length; i += size) {
+        chunks.push(arr.slice(i, i + 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 稳定币地址
+ */
+function getBaseTokenAddress(baseToken, chain, customAddress) {
+    if (customAddress)
+        return customAddress;
+    if (chain === 'ENI') {
+        if (baseToken === 'usdt')
+            return ADDRESSES.ENI.USDT;
+        if (baseToken === 'usdc')
+            return ADDRESSES.ENI.USDC;
+    }
+    if (baseToken === 'usdt')
+        return USDT_ADDRESS;
+    if (baseToken === 'usdc')
+        return USDC_ADDRESS;
+    throw new Error(`未知的基础代币类型: ${baseToken}`);
+}
+/**
+ * 获取 Router 地址（用于授权）
+ */
+function getRouterAddress(tradeType, chain, v2RouterOverride) {
+    if (chain === 'ENI') {
+        switch (tradeType) {
+            case 'v2': return v2RouterOverride || ENI_V2_ROUTER_ADDRESS;
+            case 'daoaas': return ENI_DAOAAS_PORTAL_ADDRESS;
+            default: throw new Error(`ENI 链不支持交易类型: ${tradeType}，仅支持 daoaas/v2`);
+        }
+    }
+    const isXLayer = chain === 'XLAYER';
+    switch (tradeType) {
+        case 'v2':
+            if (v2RouterOverride)
+                return v2RouterOverride;
+            return isXLayer ? XLAYER_V2_ROUTER_ADDRESS : PANCAKE_V2_ROUTER_ADDRESS;
+        case 'v3':
+            return isXLayer ? XLAYER_V3_ROUTER_ADDRESS : PANCAKE_V3_ROUTER_ADDRESS;
+        default:
+            throw new Error(`ERC20 模式不支持交易类型: ${tradeType}，仅支持 v2/v3`);
+    }
+}
+/**
+ * 获取包装原生代币地址
+ */
+function getWrappedNativeAddress(chain) {
+    if (chain === 'ENI')
+        return WEGAS_ADDRESS;
+    return chain === 'XLAYER' ? WOKB_ADDRESS : WBNB_ADDRESS;
+}
+/**
+ * 构建 ERC20 转账交易
+ */
+async function buildERC20TransferTx(wallet, tokenAddress, to, amount, nonce, gasPrice, chainId, txType) {
+    const iface = new ethers.Interface(ERC20_ABI);
+    const data = iface.encodeFunctionData('transfer', [to, amount]);
+    const tx = {
+        to: tokenAddress,
+        data,
+        value: 0n,
+        nonce,
+        gasLimit: ERC20_TRANSFER_GAS_LIMIT,
+        chainId
+    };
+    if (txType === 2) {
+        tx.maxFeePerGas = gasPrice;
+        tx.maxPriorityFeePerGas = gasPrice / 10n || 1n;
+        tx.type = 2;
+    }
+    else {
+        tx.gasPrice = gasPrice;
+        tx.type = 0;
+    }
+    return await wallet.signTransaction(tx);
+}
+/**
+ * 构建 ERC20 授权交易
+ */
+async function buildERC20ApproveTx(wallet, tokenAddress, spender, amount, nonce, gasPrice, chainId, txType) {
+    const iface = new ethers.Interface(ERC20_ABI);
+    const data = iface.encodeFunctionData('approve', [spender, amount]);
+    const tx = {
+        to: tokenAddress,
+        data,
+        value: 0n,
+        nonce,
+        gasLimit: ERC20_APPROVE_GAS_LIMIT,
+        chainId
+    };
+    if (txType === 2) {
+        tx.maxFeePerGas = gasPrice;
+        tx.maxPriorityFeePerGas = gasPrice / 10n || 1n;
+        tx.type = 2;
+    }
+    else {
+        tx.gasPrice = gasPrice;
+        tx.type = 0;
+    }
+    return await wallet.signTransaction(tx);
+}
+/**
+ * 构建原生代币转账交易
+ */
+async function buildNativeTransferTx(wallet, to, amount, nonce, gasPrice, chainId, txType) {
+    const tx = {
+        to,
+        value: amount,
+        nonce,
+        gasLimit: GAS_LIMITS.BRIBE,
+        chainId
+    };
+    if (txType === 2) {
+        tx.maxFeePerGas = gasPrice;
+        tx.maxPriorityFeePerGas = gasPrice / 10n || 1n;
+        tx.type = 2;
+    }
+    else {
+        tx.gasPrice = gasPrice;
+        tx.type = 0;
+    }
+    return await wallet.signTransaction(tx);
+}
+/**
+ * 构建 Flap 买入交易
+ * 使用 swapExactInput 方法
+ */
+async function buildFlapBuyTx(wallet, tokenAddress, buyAmount, nonce, gasPrice, gasLimit, chainId, txType, chain) {
+    const portalAddress = FLAP_PORTAL_ADDRESSES[chain];
+    // ✅ 使用正确的 Flap Portal ABI
+    const iface = new ethers.Interface([
+        'function swapExactInput((address inputToken,address outputToken,uint256 inputAmount,uint256 minOutputAmount,bytes permitData)) external payable returns (uint256)'
+    ]);
+    // ✅ 构建 swapExactInput 参数
+    // inputToken = 0x0 表示原生代币（BNB）
+    // outputToken = tokenAddress（要买入的代币）
+    const data = iface.encodeFunctionData('swapExactInput', [{
+            inputToken: ethers.ZeroAddress, // 原生代币（BNB）
+            outputToken: tokenAddress, // 要买入的代币
+            inputAmount: buyAmount,
+            minOutputAmount: 0n, // 不设滑点保护
+            permitData: '0x'
+        }]);
+    const tx = {
+        to: portalAddress,
+        data,
+        value: buyAmount,
+        nonce,
+        gasLimit: BigInt(gasLimit),
+        chainId
+    };
+    if (txType === 2) {
+        tx.maxFeePerGas = gasPrice;
+        tx.maxPriorityFeePerGas = gasPrice / 10n || 1n;
+        tx.type = 2;
+    }
+    else {
+        tx.gasPrice = gasPrice;
+        tx.type = 0;
+    }
+    return await wallet.signTransaction(tx);
+}
+/**
+ * 构建 Four 内盘买入交易
+ * 使用 buyTokenAMAP 方法
+ */
+async function buildFourBuyTx(wallet, tokenAddress, buyAmount, nonce, gasPrice, gasLimit, chainId, txType) {
+    const tmAddress = ADDRESSES.BSC.TokenManagerOriginal;
+    const iface = new ethers.Interface(FOUR_TM2_ABI);
+    const data = iface.encodeFunctionData('buyTokenAMAP', [
+        0n, // origin
+        tokenAddress, // token
+        wallet.address, // to（接收者为自己）
+        buyAmount, // funds
+        0n // minAmount（不设滑点保护）
+    ]);
+    const tx = {
+        to: tmAddress,
+        data,
+        value: buyAmount,
+        nonce,
+        gasLimit: BigInt(gasLimit),
+        chainId
+    };
+    if (txType === 2) {
+        tx.maxFeePerGas = gasPrice;
+        tx.maxPriorityFeePerGas = gasPrice / 10n || 1n;
+        tx.type = 2;
+    }
+    else {
+        tx.gasPrice = gasPrice;
+        tx.type = 0;
+    }
+    return await wallet.signTransaction(tx);
+}
+/**
+ * 构建 DAOaaS 内盘买入交易 (ENI 链)
+ * EGAS → Token (使用 DAOaaS Portal buy)
+ */
+async function buildDaoaasBuyTx(wallet, tokenAddress, buyAmount, nonce, gasPrice, gasLimit, chainId) {
+    const portalAbi = ['function purchaseToken(address token, uint256 AmountMin) payable'];
+    const iface = new ethers.Interface(portalAbi);
+    const data = iface.encodeFunctionData('purchaseToken', [tokenAddress, 0n]);
+    const tx = {
+        to: ENI_DAOAAS_PORTAL_ADDRESS,
+        data,
+        value: buyAmount,
+        nonce,
+        gasLimit: BigInt(gasLimit),
+        chainId,
+        type: 2,
+        maxFeePerGas: gasPrice,
+        maxPriorityFeePerGas: gasPrice / 10n || 1n,
+    };
+    return await wallet.signTransaction(tx);
+}
+/**
+ * 构建 V2 买入交易
+ * BNB/OKB → Token (使用 swapExactETHForTokensSupportingFeeOnTransferTokens)
+ */
+async function buildV2BuyTx(wallet, tokenAddress, buyAmount, nonce, gasPrice, gasLimit, chainId, txType, v2Path, chain, v2RouterOverride) {
+    const wrappedNative = getWrappedNativeAddress(chain);
+    const routerAddress = v2RouterOverride || getRouterAddress('v2', chain);
+    const path = v2Path ? [...v2Path].reverse() : [wrappedNative, tokenAddress];
+    const deadline = getDeadline();
+    const v2Router = new Contract(routerAddress, V2_ROUTER_ABI, wallet);
+    const unsigned = await v2Router.swapExactETHForTokensSupportingFeeOnTransferTokens.populateTransaction(0n, // amountOutMin（不设滑点保护）
+    path, wallet.address, deadline, { value: buyAmount });
+    const tx = {
+        ...unsigned,
+        nonce,
+        gasLimit: BigInt(gasLimit),
+        chainId
+    };
+    if (txType === 2) {
+        tx.maxFeePerGas = gasPrice;
+        tx.maxPriorityFeePerGas = gasPrice / 10n || 1n;
+        tx.type = 2;
+    }
+    else {
+        tx.gasPrice = gasPrice;
+        tx.type = 0;
+    }
+    return await wallet.signTransaction(tx);
+}
+/**
+ * 构建 V3 单跳买入交易
+ * BNB/OKB → Token (使用 exactInputSingle + multicall)
+ *
+ * ✅ 修复：根据链类型选择正确的 Router ABI 版本
+ * - XLayer/Monad: 旧版 Router（exactInputSingle 包含 deadline，multicall(bytes[])）
+ * - BSC: 新版 SwapRouter02（exactInputSingle 不含 deadline，multicall(uint256,bytes[])）
+ */
+async function buildV3BuyTx(wallet, tokenAddress, buyAmount, nonce, gasPrice, gasLimit, chainId, txType, v3Fee = 2500, // 默认 0.25% 手续费
+chain) {
+    const deadline = getDeadline();
+    const wrappedNative = getWrappedNativeAddress(chain);
+    const routerAddress = chain === 'XLAYER' ? XLAYER_V3_ROUTER_ADDRESS : PANCAKE_V3_ROUTER_ADDRESS;
+    // ✅ 根据链类型选择正确的 ABI 版本
+    // XLayer/Monad 使用旧版 Router（exactInputSingle 包含 deadline）
+    // BSC 使用新版 SwapRouter02（exactInputSingle 不含 deadline）
+    const useLegacyRouter = chain === 'XLAYER' || chain === 'MONAD';
+    const v3RouterIface = new ethers.Interface(useLegacyRouter ? V3_ROUTER_LEGACY_ABI : V3_ROUTER02_ABI);
+    let multicallData;
+    if (useLegacyRouter) {
+        // ✅ 旧版 Router：swapParams 包含 deadline，multicall(bytes[])
+        const swapParams = {
+            tokenIn: wrappedNative,
+            tokenOut: tokenAddress,
+            fee: v3Fee,
+            recipient: wallet.address,
+            deadline, // ✅ 旧版包含 deadline
+            amountIn: buyAmount,
+            amountOutMinimum: 0n,
+            sqrtPriceLimitX96: 0n
+        };
+        const exactInputSingleData = v3RouterIface.encodeFunctionData('exactInputSingle', [swapParams]);
+        const refundETHData = v3RouterIface.encodeFunctionData('refundETH', []);
+        // ✅ 旧版 multicall：只有 bytes[] 参数
+        multicallData = v3RouterIface.encodeFunctionData('multicall(bytes[])', [
+            [exactInputSingleData, refundETHData]
+        ]);
+    }
+    else {
+        // ✅ 新版 SwapRouter02：swapParams 不含 deadline，multicall(uint256,bytes[])
+        const swapParams = {
+            tokenIn: wrappedNative,
+            tokenOut: tokenAddress,
+            fee: v3Fee,
+            recipient: wallet.address,
+            amountIn: buyAmount,
+            amountOutMinimum: 0n,
+            sqrtPriceLimitX96: 0n
+        };
+        const exactInputSingleData = v3RouterIface.encodeFunctionData('exactInputSingle', [swapParams]);
+        const refundETHData = v3RouterIface.encodeFunctionData('refundETH', []);
+        // ✅ 新版 multicall：deadline 作为第一个参数
+        multicallData = v3RouterIface.encodeFunctionData('multicall(uint256,bytes[])', [
+            deadline,
+            [exactInputSingleData, refundETHData]
+        ]);
+    }
+    const tx = {
+        to: routerAddress,
+        data: multicallData,
+        value: buyAmount,
+        nonce,
+        gasLimit: BigInt(gasLimit),
+        chainId
+    };
+    if (txType === 2) {
+        tx.maxFeePerGas = gasPrice;
+        tx.maxPriorityFeePerGas = gasPrice / 10n || 1n;
+        tx.type = 2;
+    }
+    else {
+        tx.gasPrice = gasPrice;
+        tx.type = 0;
+    }
+    return await wallet.signTransaction(tx);
+}
+/**
+ * 构建 V2 买入交易（ERC20 输入）
+ * USDT/USDC → Token (使用 swapExactTokensForTokensSupportingFeeOnTransferTokens)
+ */
+async function buildV2BuyTxWithERC20(wallet, tokenAddress, baseTokenAddress, buyAmount, nonce, gasPrice, gasLimit, chainId, txType, v2RouterOverride, chain) {
+    const path = [baseTokenAddress, tokenAddress];
+    const deadline = getDeadline();
+    const routerAddress = v2RouterOverride || getRouterAddress('v2', chain);
+    const v2Router = new Contract(routerAddress, V2_ROUTER_ABI, wallet);
+    const unsigned = await v2Router.swapExactTokensForTokensSupportingFeeOnTransferTokens.populateTransaction(buyAmount, // amountIn
+    0n, // amountOutMin（不设滑点保护）
+    path, wallet.address, deadline);
+    const tx = {
+        ...unsigned,
+        nonce,
+        gasLimit: BigInt(gasLimit),
+        chainId
+    };
+    if (txType === 2) {
+        tx.maxFeePerGas = gasPrice;
+        tx.maxPriorityFeePerGas = gasPrice / 10n || 1n;
+        tx.type = 2;
+    }
+    else {
+        tx.gasPrice = gasPrice;
+        tx.type = 0;
+    }
+    return await wallet.signTransaction(tx);
+}
+/**
+ * 构建 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 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 = {
+        to: PANCAKE_V3_ROUTER_ADDRESS,
+        data: multicallData,
+        value: 0n,
+        nonce,
+        gasLimit: BigInt(gasLimit),
+        chainId
+    };
+    if (txType === 2) {
+        tx.maxFeePerGas = gasPrice;
+        tx.maxPriorityFeePerGas = gasPrice / 10n || 1n;
+        tx.type = 2;
+    }
+    else {
+        tx.gasPrice = gasPrice;
+        tx.type = 0;
+    }
+    return await wallet.signTransaction(tx);
+}
+// ============================================================================
+// 主方法
+// ============================================================================
+/**
+ * 刷持有人（一个 bundle 完成分发+买入）
+ *
+ * 原生代币模式流程（同一个 bundle）：
+ * 1. 贿赂交易
+ * 2. 分发原生代币（dev → 新钱包）
+ * 3. 买入交易（新钱包 nonce=0）
+ * 4. 利润多跳
+ *
+ * ERC20 模式流程（同一个 bundle）：
+ * 1. 贿赂交易
+ * 2. 分发原生代币（gas 费）
+ * 3. 分发 ERC20 代币（购买资金）
+ * 4. 授权交易（新钱包 nonce=0）
+ * 5. 买入交易（新钱包 nonce=1）
+ * 6. 利润多跳
+ *
+ * @returns 包含所有签名交易的结果，由前端提交
+ */
 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: configTxType = 0, disperseHopCount = 0, // ✅ 分发多跳数（默认0=直接转账）
+    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: configTxType = 0, disperseHopCount = 0 // ✅ 分发多跳数（默认0=直接转账）
      } = config;
     // ENI 链强制使用 EIP-1559 (type 2)
     const txType = chain === 'ENI' ? 2 : configTxType;
@@ -22,7 +646,7 @@ export async function holdersMaker(params) {
         signedTransactions: [],
         batchResults: [],
         successBatchCount: 0,
-        totalBatchCount: 0,
+        totalBatchCount: 0
     };
     const isERC20Mode = baseToken !== 'native';
     // ✅ ERC20 模式只支持 v2/v3 外盘
@@ -39,16 +663,20 @@ export async function holdersMaker(params) {
     // ✅ 根据分发多跳数动态计算每批最大钱包数
     // XLayer 强制禁用分发多跳（ENI 已支持前端分层广播）
     const effectiveDisperseHopCount = chain === 'XLAYER' ? 0 : disperseHopCount;
-    const maxWalletsPerBatch = config.maxWalletsPerBatch || calculateMaxWalletsPerBatch(isERC20Mode, effectiveDisperseHopCount, chain);
+    const maxWalletsPerBatch = config.maxWalletsPerBatch ||
+        calculateMaxWalletsPerBatch(isERC20Mode, effectiveDisperseHopCount, chain);
+    console.log(`[HoldersMaker] chain: ${chain}, 分发多跳数: ${effectiveDisperseHopCount}, 每批最大钱包数: ${maxWalletsPerBatch}`);
     try {
         // 1. 初始化
         const provider = new JsonRpcProvider(rpcUrl);
         const chainId = configChainId || Number((await provider.getNetwork()).chainId);
         const payer = new Wallet(payerPrivateKey, provider);
         const nonceManager = new NonceManager(provider);
+        console.log(`[HoldersMaker] 开始刷持有人: chain=${chain}, chainId=${chainId}, holdersCount=${holdersCount}, baseToken=${baseToken}`);
         // 2. 生成新钱包
         const newWallets = generateWallets(holdersCount);
         result.newWallets = newWallets;
+        console.log(`[HoldersMaker] 生成 ${newWallets.length} 个新钱包`);
         // 3. 计算金额
         const gasPriceWei = BigInt(Math.floor(gasPriceGwei * 1e9));
         const gasPrice = await getOptimizedGasPrice(provider, { minGasPrice: gasPriceWei });
@@ -67,20 +695,24 @@ export async function holdersMaker(params) {
             transferNativePerWallet = gasWithBuffer;
             // 获取 ERC20 地址
             erc20TokenAddress = getBaseTokenAddress(baseToken, chain, baseTokenAddress);
+            console.log(`[HoldersMaker] ERC20 模式: ${baseToken} (${erc20TokenAddress})`);
+            console.log(`[HoldersMaker] 每个钱包分发: ${ethers.formatEther(transferNativePerWallet)} BNB (Gas) + ${buyAmountPerHolder} ${baseToken.toUpperCase()}`);
         }
         else {
             // 原生代币模式
             buyAmountWei = ethers.parseEther(buyAmountPerHolder);
             transferNativePerWallet = buyAmountWei + gasWithBuffer;
+            console.log(`[HoldersMaker] 每个钱包分发: ${ethers.formatEther(transferNativePerWallet)} BNB (买入 ${buyAmountPerHolder} + Gas ${ethers.formatEther(gasWithBuffer)})`);
         }
         // 4. 分批处理
         const walletBatches = chunkArray(newWallets, maxWalletsPerBatch);
         result.totalBatchCount = walletBatches.length;
+        console.log(`[HoldersMaker] 分 ${walletBatches.length} 批处理，每批最多 ${maxWalletsPerBatch} 个钱包`);
         // 5. 计算利润（基于原生代币）
         const totalBuyAmountForProfit = isERC20Mode
             ? ethers.parseEther(buyAmountPerHolder) * BigInt(holdersCount) // 按等值 BNB 计算
             : buyAmountWei * BigInt(holdersCount);
-        const profitRateBps = getSharedProfitRateBps('normal');
+        const profitRateBps = PROFIT_CONFIG.RATE_BPS;
         const totalProfit = (totalBuyAmountForProfit * BigInt(profitRateBps)) / 10000n;
         let profitPerBatch = totalProfit / BigInt(walletBatches.length);
         if (profitPerBatch > 0n && chain === 'ENI') {
@@ -88,7 +720,7 @@ export async function holdersMaker(params) {
         }
         // 利润计算完成
         // 6. 生成分发多跳路径（如果启用）
-        const allDisperseHopWallets = [];
+        let allDisperseHopWallets = [];
         const disperseHopPaths = generateDisperseHopPaths(newWallets, effectiveDisperseHopCount, provider);
         if (effectiveDisperseHopCount > 0) {
             // 收集所有中间钱包信息用于导出
@@ -96,11 +728,13 @@ export async function holdersMaker(params) {
                 allDisperseHopWallets.push(...path.hopWalletsInfo);
             }
             result.disperseHopWallets = allDisperseHopWallets;
+            console.log(`[HoldersMaker] 分发多跳: ${effectiveDisperseHopCount} 跳，共生成 ${allDisperseHopWallets.length} 个中间钱包`);
         }
         // ✅ XLayer/ENI 特殊处理：不需要贿赂和利润多跳
         const isSimpleChain = chain === 'XLAYER' || chain === 'ENI';
         const needBribe = !isSimpleChain;
         const needProfitHop = !isSimpleChain;
+        const effectiveProfitHopCount = needProfitHop ? PROFIT_HOP_COUNT : 0;
         // 7. 并行生成所有批次的签名
         const batchPromises = walletBatches.map(async (batch, batchIdx) => {
             try {
@@ -111,7 +745,7 @@ export async function holdersMaker(params) {
                 // BSC 原生模式（有多跳H）: 贿赂 1 + 分发首跳 N + 利润 (PROFIT_HOP_COUNT + 1)
                 // BSC ERC20模式（无多跳）: 贿赂 1 + 分发BNB N + 分发ERC20 N + 利润 (PROFIT_HOP_COUNT + 1)
                 const bribeCount = needBribe ? 1 : 0;
-                const profitCount = needProfitHop ? PROFIT_HOP_COUNT + 1 : 1; // XLayer 只有 1 笔利润转账
+                const profitCount = needProfitHop ? (PROFIT_HOP_COUNT + 1) : 1; // XLayer 只有 1 笔利润转账
                 const payerNonceCount = isERC20Mode
                     ? bribeCount + batch.length * 2 + profitCount
                     : bribeCount + batch.length + profitCount;
@@ -128,7 +762,8 @@ export async function holdersMaker(params) {
                 // (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);
+                    const { signedTxs: hopTxs } = await buildDisperseHopChainNative(payer, path, transferNativePerWallet, gasPrice, chainId, txType, payerNonces[payerNonceIdx++], isERC20Mode // ✅ ERC20 模式下，中间钱包需要预留 ERC20 转账 gas
+                    );
                     signedTxs.push(...hopTxs);
                 }
                 // (3) ERC20 模式：分发 ERC20 代币（支持多跳）
@@ -209,7 +844,7 @@ export async function holdersMaker(params) {
                             gasPrice,
                             chainId,
                             txType,
-                            startNonce: payerNonces[payerNonceIdx],
+                            startNonce: payerNonces[payerNonceIdx]
                         });
                         signedTxs.push(...profitHopResult.signedTransactions);
                         profitHopWallets = profitHopResult.hopWallets;
@@ -225,15 +860,15 @@ export async function holdersMaker(params) {
                     success: true,
                     signedTransactions: signedTxs,
                     walletCount: batch.length,
-                    profitHopWallets, // ✅ 返回利润多跳钱包
+                    profitHopWallets // ✅ 返回利润多跳钱包
                 };
             }
             catch (error) {
                 return {
                     batchIndex: batchIdx,
                     success: false,
-                    error: getErrorMessageFromUnknown(error),
-                    walletCount: batch.length,
+                    error: error.message,
+                    walletCount: batch.length
                 };
             }
         });
@@ -255,7 +890,7 @@ export async function holdersMaker(params) {
                 signedTransactions: res.signedTransactions,
                 error: res.error,
                 walletCount: res.walletCount,
-                disperseHopCount: effectiveDisperseHopCount, // ✅ 添加分发多跳数
+                disperseHopCount: effectiveDisperseHopCount // ✅ 添加分发多跳数
             });
         }
         // ✅ 添加利润多跳钱包到结果
@@ -265,11 +900,11 @@ export async function holdersMaker(params) {
         // ✅ 添加分发多跳数到结果
         result.disperseHopCount = effectiveDisperseHopCount;
         result.success = result.successBatchCount > 0;
+        console.log(`[HoldersMaker] 完成: ${result.successBatchCount}/${result.totalBatchCount} 批成功`);
     }
     catch (error) {
-        const msg = getErrorMessageFromUnknown(error);
-        result.error = msg;
-        console.error(`[HoldersMaker] 整体失败:`, msg);
+        result.error = error.message;
+        console.error(`[HoldersMaker] 整体失败:`, error.message);
     }
     return result;
 }
@@ -277,7 +912,7 @@ export async function holdersMaker(params) {
  * 获取刷持有人预估费用
  */
 export function estimateHoldersMakerCost(params) {
-    const { holdersCount, buyAmountPerHolder, baseToken = 'native', gasLimit = DEFAULT_GAS_LIMIT, gasPriceGwei = DEFAULT_GAS_PRICE_GWEI, } = params;
+    const { holdersCount, buyAmountPerHolder, baseToken = 'native', gasLimit = DEFAULT_GAS_LIMIT, gasPriceGwei = DEFAULT_GAS_PRICE_GWEI } = params;
     const isERC20Mode = baseToken !== 'native';
     const gasMultiplier = isERC20Mode ? 2 : 1; // ERC20 模式需要授权+购买
     const gasFeePerWallet = (gasLimit * gasPriceGwei * gasMultiplier) / 1e9;
@@ -294,7 +929,7 @@ export function estimateHoldersMakerCost(params) {
             totalNativeCost: totalNativeCost.toFixed(6),
             totalERC20Cost: totalERC20Cost.toFixed(6),
             gasEstimate: (gasWithBuffer * holdersCount).toFixed(6),
-            batchCount,
+            batchCount
         };
     }
     else {
@@ -304,7 +939,7 @@ export function estimateHoldersMakerCost(params) {
         return {
             totalNativeCost: totalNativeCost.toFixed(6),
             gasEstimate: (gasWithBuffer * holdersCount).toFixed(6),
-            batchCount,
+            batchCount
         };
     }
 }