four-flap-meme-sdk 1.9.49 → 2.0.0

package/dist/utils/holders-maker.js

@@ -1,641 +1,16 @@
 /**
- * ============================================================================
- * 刷持有人（Holders Maker）
- * ============================================================================
- * 一键完成：生成钱包 → 分发资金 → 批量买入（同一个 bundle 完成）
- * 支持原生代币（BNB/MON）和 ERC20 代币（USDT/USDC）作为购买资金
+ * holders-maker - 主函数
  */
-import { ethers, JsonRpcProvider, Wallet, Contract } from 'ethers';
+import { ethers, JsonRpcProvider, Wallet } from 'ethers';
 import { generateWallets } from './wallet.js';
-import { NonceManager, getOptimizedGasPrice, buildProfitHopTransactions, PROFIT_HOP_COUNT, getDeadline } from './bundle-helpers.js';
-import { ADDRESSES, BLOCKRAZOR_BUILDER_EOA } from './constants.js';
-import { getProfitRecipient, getProfitRateBps } from '../shared/constants/index.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 包含所有签名交易的结果，由前端提交
- */
+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';
 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;
@@ -647,7 +22,7 @@ export async function holdersMaker(params) {
         signedTransactions: [],
         batchResults: [],
         successBatchCount: 0,
-        totalBatchCount: 0
+        totalBatchCount: 0,
     };
     const isERC20Mode = baseToken !== 'native';
     // ✅ ERC20 模式只支持 v2/v3 外盘
@@ -664,8 +39,7 @@ 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);
     try {
         // 1. 初始化
         const provider = new JsonRpcProvider(rpcUrl);
@@ -706,7 +80,7 @@ export async function holdersMaker(params) {
         const totalBuyAmountForProfit = isERC20Mode
             ? ethers.parseEther(buyAmountPerHolder) * BigInt(holdersCount) // 按等值 BNB 计算
             : buyAmountWei * BigInt(holdersCount);
-        const profitRateBps = getProfitRateBps('normal');
+        const profitRateBps = getSharedProfitRateBps('normal');
         const totalProfit = (totalBuyAmountForProfit * BigInt(profitRateBps)) / 10000n;
         let profitPerBatch = totalProfit / BigInt(walletBatches.length);
         if (profitPerBatch > 0n && chain === 'ENI') {
@@ -737,7 +111,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;
@@ -754,8 +128,7 @@ 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 // ✅ ERC20 模式下，中间钱包需要预留 ERC20 转账 gas
-                    );
+                    const { signedTxs: hopTxs } = await buildDisperseHopChainNative(payer, path, transferNativePerWallet, gasPrice, chainId, txType, payerNonces[payerNonceIdx++], isERC20Mode);
                     signedTxs.push(...hopTxs);
                 }
                 // (3) ERC20 模式：分发 ERC20 代币（支持多跳）
@@ -836,7 +209,7 @@ export async function holdersMaker(params) {
                             gasPrice,
                             chainId,
                             txType,
-                            startNonce: payerNonces[payerNonceIdx]
+                            startNonce: payerNonces[payerNonceIdx],
                         });
                         signedTxs.push(...profitHopResult.signedTransactions);
                         profitHopWallets = profitHopResult.hopWallets;
@@ -852,16 +225,15 @@ export async function holdersMaker(params) {
                     success: true,
                     signedTransactions: signedTxs,
                     walletCount: batch.length,
-                    profitHopWallets // ✅ 返回利润多跳钱包
+                    profitHopWallets, // ✅ 返回利润多跳钱包
                 };
             }
             catch (error) {
-                const msg = error instanceof Error ? error.message : String(error);
                 return {
                     batchIndex: batchIdx,
                     success: false,
-                    error: msg,
-                    walletCount: batch.length
+                    error: getErrorMessageFromUnknown(error),
+                    walletCount: batch.length,
                 };
             }
         });
@@ -883,7 +255,7 @@ export async function holdersMaker(params) {
                 signedTransactions: res.signedTransactions,
                 error: res.error,
                 walletCount: res.walletCount,
-                disperseHopCount: effectiveDisperseHopCount // ✅ 添加分发多跳数
+                disperseHopCount: effectiveDisperseHopCount, // ✅ 添加分发多跳数
             });
         }
         // ✅ 添加利润多跳钱包到结果
@@ -895,7 +267,7 @@ export async function holdersMaker(params) {
         result.success = result.successBatchCount > 0;
     }
     catch (error) {
-        const msg = error instanceof Error ? error.message : String(error);
+        const msg = getErrorMessageFromUnknown(error);
         result.error = msg;
         console.error(`[HoldersMaker] 整体失败:`, msg);
     }
@@ -905,7 +277,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;
@@ -922,7 +294,7 @@ export function estimateHoldersMakerCost(params) {
             totalNativeCost: totalNativeCost.toFixed(6),
             totalERC20Cost: totalERC20Cost.toFixed(6),
             gasEstimate: (gasWithBuffer * holdersCount).toFixed(6),
-            batchCount
+            batchCount,
         };
     }
     else {
@@ -932,7 +304,7 @@ export function estimateHoldersMakerCost(params) {
         return {
             totalNativeCost: totalNativeCost.toFixed(6),
             gasEstimate: (gasWithBuffer * holdersCount).toFixed(6),
-            batchCount
+            batchCount,
         };
     }
 }