four-flap-meme-sdk 1.9.49 → 2.1.0

package/dist/utils/holders-maker/addresses.d.ts

@@ -0,0 +1,12 @@
+export declare const FOUR_TM2_ABI: string[];
+export declare const PANCAKE_V2_ROUTER_ADDRESS: "0x10ED43C718714eb63d5aA57B78B54704E256024E";
+export declare const PANCAKE_V3_ROUTER_ADDRESS: "0x13f4EA83D0bd40E75C8222255bc855a974568Dd4";
+export declare const WBNB_ADDRESS: "0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c";
+export declare const USDT_ADDRESS: "0x55d398326f99059fF775485246999027B3197955";
+export declare const USDC_ADDRESS: "0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d";
+export declare const XLAYER_V2_ROUTER_ADDRESS: "0x881fb2f98c13d521009464e7d1cbf16e1b394e8e";
+export declare const XLAYER_V3_ROUTER_ADDRESS: "0xBB069e9465BcabC4F488d21e793BDEf0F2d41D41";
+export declare const WOKB_ADDRESS: "0xe538905cf8410324e03a5a23c1c177a474d59b2b";
+export declare const ENI_V2_ROUTER_ADDRESS: "0x97ed8be49d9a8b86247090aa41e908e76b8fcf22";
+export declare const ENI_DAOAAS_PORTAL_ADDRESS: "0x0078341F4CD09D7E6D3125ef6eb4cB2F46CA8310";
+export declare const WEGAS_ADDRESS: "0x6d1e851446f4d004ae2a72f9afed85e8829a205e";

package/dist/utils/holders-maker/addresses.js

@@ -0,0 +1,15 @@
+import { ADDRESSES } from '../constants.js';
+export const FOUR_TM2_ABI = [
+    'function buyTokenAMAP(uint256 origin, address token, address to, uint256 funds, uint256 minAmount) payable',
+];
+export const PANCAKE_V2_ROUTER_ADDRESS = ADDRESSES.BSC.PancakeV2Router;
+export const PANCAKE_V3_ROUTER_ADDRESS = ADDRESSES.BSC.PancakeV3Router;
+export const WBNB_ADDRESS = ADDRESSES.BSC.WBNB;
+export const USDT_ADDRESS = ADDRESSES.BSC.USDT;
+export const USDC_ADDRESS = ADDRESSES.BSC.USDC;
+export const XLAYER_V2_ROUTER_ADDRESS = ADDRESSES.XLAYER.PotatoSwapV2Router;
+export const XLAYER_V3_ROUTER_ADDRESS = ADDRESSES.XLAYER.PotatoSwapV3Router;
+export const WOKB_ADDRESS = ADDRESSES.XLAYER.WOKB;
+export const ENI_V2_ROUTER_ADDRESS = ADDRESSES.ENI.DswapV2Router;
+export const ENI_DAOAAS_PORTAL_ADDRESS = ADDRESSES.ENI.DaoaasPortal;
+export const WEGAS_ADDRESS = ADDRESSES.ENI.WEGAS;

package/dist/utils/holders-maker/buy-tx.d.ts

@@ -0,0 +1,44 @@
+import { Wallet } from 'ethers';
+import type { HoldersMakerChain } from '../../shared/foundation/types/holders-maker.js';
+/**
+ * 构建 Flap 买入交易
+ * 使用 swapExactInput 方法
+ */
+export declare function buildFlapBuyTx(wallet: Wallet, tokenAddress: string, buyAmount: bigint, nonce: number, gasPrice: bigint, gasLimit: number, chainId: number, txType: 0 | 2, chain: HoldersMakerChain): Promise<string>;
+/**
+ * 构建 Four 内盘买入交易
+ * 使用 buyTokenAMAP 方法
+ */
+export declare function buildFourBuyTx(wallet: Wallet, tokenAddress: string, buyAmount: bigint, nonce: number, gasPrice: bigint, gasLimit: number, chainId: number, txType: 0 | 2): Promise<string>;
+/**
+ * 构建 DAOaaS 内盘买入交易 (ENI 链)
+ * EGAS → Token (使用 DAOaaS Portal buy)
+ */
+export declare function buildDaoaasBuyTx(wallet: Wallet, tokenAddress: string, buyAmount: bigint, nonce: number, gasPrice: bigint, gasLimit: number, chainId: number): Promise<string>;
+/**
+ * 构建 V2 买入交易
+ * BNB/OKB → Token (使用 swapExactETHForTokensSupportingFeeOnTransferTokens)
+ */
+export declare function buildV2BuyTx(wallet: Wallet, tokenAddress: string, buyAmount: bigint, nonce: number, gasPrice: bigint, gasLimit: number, chainId: number, txType: 0 | 2, v2Path?: string[], chain?: HoldersMakerChain, v2RouterOverride?: string): Promise<string>;
+/**
+ * 构建 V3 单跳买入交易
+ * BNB/OKB → Token (使用 exactInputSingle + multicall)
+ *
+ * ✅ 修复：根据链类型选择正确的 Router ABI 版本
+ * - XLayer/Monad: 旧版 Router（exactInputSingle 包含 deadline，multicall(bytes[])）
+ * - BSC: 新版 SwapRouter02（exactInputSingle 不含 deadline，multicall(uint256,bytes[])）
+ */
+export declare function buildV3BuyTx(wallet: Wallet, tokenAddress: string, buyAmount: bigint, nonce: number, gasPrice: bigint, gasLimit: number, chainId: number, txType: 0 | 2, v3Fee?: number, // 默认 0.25% 手续费
+chain?: HoldersMakerChain): Promise<string>;
+/**
+ * 构建 V2 买入交易（ERC20 输入）
+ * USDT/USDC → Token (使用 swapExactTokensForTokensSupportingFeeOnTransferTokens)
+ */
+export declare function buildV2BuyTxWithERC20(wallet: Wallet, tokenAddress: string, baseTokenAddress: string, buyAmount: bigint, nonce: number, gasPrice: bigint, gasLimit: number, chainId: number, txType: 0 | 2, v2RouterOverride?: string, chain?: HoldersMakerChain): Promise<string>;
+/**
+ * 构建 V3 买入交易（ERC20 输入）
+ * USDT/USDC → Token (使用 exactInputSingle + multicall)
+ *
+ * ✅ 修复：使用 ethers.Interface 手动编码 calldata，避免 multicall 重载问题
+ */
+export declare function buildV3BuyTxWithERC20(wallet: Wallet, tokenAddress: string, baseTokenAddress: string, buyAmount: bigint, nonce: number, gasPrice: bigint, gasLimit: number, chainId: number, txType: 0 | 2, v3Fee?: number): Promise<string>;

package/dist/utils/holders-maker/buy-tx.js

@@ -0,0 +1,278 @@
+import { ethers, Contract } from 'ethers';
+import { getDeadline } from '../bundle-helpers.js';
+import { ADDRESSES } from '../constants.js';
+import { FLAP_PORTAL_ADDRESSES } from '../../shared/flap/constants.js';
+import { V2_ROUTER_ABI, V3_ROUTER02_ABI, V3_ROUTER_LEGACY_ABI } from '../../abis/common.js';
+import { ENI_DAOAAS_PORTAL_ADDRESS, FOUR_TM2_ABI, PANCAKE_V3_ROUTER_ADDRESS, XLAYER_V3_ROUTER_ADDRESS, } from './addresses.js';
+import { getRouterAddress, getWrappedNativeAddress } from './routing.js';
+/**
+ * 构建 Flap 买入交易
+ * 使用 swapExactInput 方法
+ */
+export 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 方法
+ */
+export 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)
+ */
+export 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)
+ */
+export 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[])）
+ */
+export 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)
+ */
+export 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 重载问题
+ */
+export 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);
+}

package/dist/utils/holders-maker/constants.d.ts

@@ -0,0 +1,6 @@
+export declare const ERC20_TRANSFER_GAS_LIMIT: 65000n;
+export declare const ERC20_APPROVE_GAS_LIMIT = 50000n;
+export declare const DEFAULT_GAS_LIMIT = 800000;
+export declare const DEFAULT_GAS_PRICE_GWEI = 3;
+export declare const GAS_BUFFER_MULTIPLIER = 2;
+export declare const NATIVE_TRANSFER_GAS_LIMIT: 21055n;

package/dist/utils/holders-maker/constants.js

@@ -0,0 +1,7 @@
+import { GAS_LIMITS } from '../../shared/constants/index.js';
+export const ERC20_TRANSFER_GAS_LIMIT = GAS_LIMITS.ERC20_TRANSFER;
+export const ERC20_APPROVE_GAS_LIMIT = 50000n;
+export const DEFAULT_GAS_LIMIT = 800000;
+export const DEFAULT_GAS_PRICE_GWEI = 3;
+export const GAS_BUFFER_MULTIPLIER = 2;
+export const NATIVE_TRANSFER_GAS_LIMIT = GAS_LIMITS.NATIVE_TRANSFER;

package/dist/utils/holders-maker/disperse.d.ts

@@ -0,0 +1,18 @@
+import { JsonRpcProvider, Wallet } from 'ethers';
+import type { GeneratedWallet } from '../types/wallet.js';
+import type { DisperseHopPath } from '../types/hop-chains.js';
+import type { HoldersMakerChain } from '../../shared/foundation/types/holders-maker.js';
+export type { DisperseHopPath } from '../types/hop-chains.js';
+export declare function generateDisperseHopPaths(targetWallets: GeneratedWallet[], hopCount: number, provider: JsonRpcProvider): DisperseHopPath[];
+export declare function buildDisperseHopChainNative(payer: Wallet, path: DisperseHopPath, finalAmount: bigint, gasPrice: bigint, chainId: number, txType: 0 | 2, payerNonce: number, isERC20Mode?: boolean): Promise<{
+    signedTxs: string[];
+    payerNoncesUsed: number;
+}>;
+export declare function buildDisperseHopChainERC20(payer: Wallet, path: DisperseHopPath, erc20Address: string, erc20Amount: bigint, gasPrice: bigint, chainId: number, txType: 0 | 2, payerNonce: number): Promise<{
+    signedTxs: string[];
+    payerNoncesUsed: number;
+}>;
+export declare function calculateMaxWalletsPerBatch(isERC20Mode: boolean, disperseHopCount: number, chain?: HoldersMakerChain): number;
+export declare const DEFAULT_MAX_WALLETS_PER_BATCH_NATIVE: number;
+export declare const DEFAULT_MAX_WALLETS_PER_BATCH_ERC20: number;
+export declare function chunkArray<T>(arr: T[], size: number): T[][];

package/dist/utils/holders-maker/disperse.js

@@ -0,0 +1,90 @@
+import { Wallet } from 'ethers';
+import { generateWallets } from '../wallet.js';
+import { PROFIT_HOP_COUNT } from '../bundle-helpers.js';
+import { ERC20_TRANSFER_GAS_LIMIT, NATIVE_TRANSFER_GAS_LIMIT } from './constants.js';
+import { buildERC20TransferTx, buildNativeTransferTx } from './transfer-tx.js';
+export 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,
+        };
+    });
+}
+export 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 };
+    }
+    const hopGasCost = NATIVE_TRANSFER_GAS_LIMIT * gasPrice;
+    const erc20TransferGasCost = isERC20Mode ? ERC20_TRANSFER_GAS_LIMIT * gasPrice : 0n;
+    const amountsPerHop = [];
+    for (let i = 0; i < hopCount; i++) {
+        const remainingHops = hopCount - i;
+        const amount = finalAmount +
+            hopGasCost * BigInt(remainingHops) +
+            (isERC20Mode ? erc20TransferGasCost * BigInt(remainingHops) : 0n);
+        amountsPerHop.push(amount);
+    }
+    const firstTx = await buildNativeTransferTx(payer, path.hopWallets[0].address, amountsPerHop[0], payerNonce, gasPrice, chainId, txType);
+    signedTxs.push(firstTx);
+    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 = await buildNativeTransferTx(fromWallet, toAddress, amount, 0, gasPrice, chainId, txType);
+        signedTxs.push(tx);
+    }
+    return { signedTxs, payerNoncesUsed: 1 };
+}
+export 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 };
+    }
+    const firstTx = await buildERC20TransferTx(payer, erc20Address, path.hopWallets[0].address, erc20Amount, payerNonce, gasPrice, chainId, txType);
+    signedTxs.push(firstTx);
+    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, gasPrice, chainId, txType);
+        signedTxs.push(tx);
+    }
+    return { signedTxs, payerNoncesUsed: 1 };
+}
+export function calculateMaxWalletsPerBatch(isERC20Mode, disperseHopCount, chain) {
+    const isSimpleChain = chain === 'XLAYER' || chain === 'ENI';
+    const fixedOverhead = isSimpleChain ? 1 : 1 + PROFIT_HOP_COUNT + 1;
+    const maxTxs = 50 - fixedOverhead;
+    if (isERC20Mode) {
+        const perWalletTxs = 2 * (disperseHopCount + 1) + 2;
+        return Math.floor(maxTxs / perWalletTxs);
+    }
+    const perWalletTxs = disperseHopCount + 2;
+    return Math.floor(maxTxs / perWalletTxs);
+}
+export const DEFAULT_MAX_WALLETS_PER_BATCH_NATIVE = calculateMaxWalletsPerBatch(false, 0);
+export const DEFAULT_MAX_WALLETS_PER_BATCH_ERC20 = calculateMaxWalletsPerBatch(true, 0);
+export function chunkArray(arr, size) {
+    const chunks = [];
+    for (let i = 0; i < arr.length; i += size) {
+        chunks.push(arr.slice(i, i + size));
+    }
+    return chunks;
+}

package/dist/utils/holders-maker/routing.d.ts

@@ -0,0 +1,4 @@
+import type { BaseTokenType, HoldersMakerChain, HoldersMakerTradeType } from '../../shared/foundation/types/holders-maker.js';
+export declare function getBaseTokenAddress(baseToken: BaseTokenType, chain: HoldersMakerChain, customAddress?: string): string;
+export declare function getRouterAddress(tradeType: HoldersMakerTradeType, chain?: HoldersMakerChain, v2RouterOverride?: string): string;
+export declare function getWrappedNativeAddress(chain?: HoldersMakerChain): string;

package/dist/utils/holders-maker/routing.js

@@ -0,0 +1,45 @@
+import { ADDRESSES } from '../constants.js';
+import { ENI_DAOAAS_PORTAL_ADDRESS, ENI_V2_ROUTER_ADDRESS, PANCAKE_V2_ROUTER_ADDRESS, PANCAKE_V3_ROUTER_ADDRESS, USDC_ADDRESS, USDT_ADDRESS, WBNB_ADDRESS, WEGAS_ADDRESS, WOKB_ADDRESS, XLAYER_V2_ROUTER_ADDRESS, XLAYER_V3_ROUTER_ADDRESS, } from './addresses.js';
+export 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}`);
+}
+export 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`);
+    }
+}
+export function getWrappedNativeAddress(chain) {
+    if (chain === 'ENI')
+        return WEGAS_ADDRESS;
+    return chain === 'XLAYER' ? WOKB_ADDRESS : WBNB_ADDRESS;
+}

package/dist/utils/holders-maker/transfer-tx.d.ts

@@ -0,0 +1,4 @@
+import { Wallet } from 'ethers';
+export declare function buildERC20TransferTx(wallet: Wallet, tokenAddress: string, to: string, amount: bigint, nonce: number, gasPrice: bigint, chainId: number, txType: 0 | 2): Promise<string>;
+export declare function buildERC20ApproveTx(wallet: Wallet, tokenAddress: string, spender: string, amount: bigint, nonce: number, gasPrice: bigint, chainId: number, txType: 0 | 2): Promise<string>;
+export declare function buildNativeTransferTx(wallet: Wallet, to: string, amount: bigint, nonce: number, gasPrice: bigint, chainId: number, txType: 0 | 2): Promise<string>;

package/dist/utils/holders-maker/transfer-tx.js

@@ -0,0 +1,67 @@
+import { ethers } from 'ethers';
+import { ERC20_ABI } from '../../abis/common.js';
+import { GAS_LIMITS } from '../../shared/constants/index.js';
+import { ERC20_APPROVE_GAS_LIMIT, ERC20_TRANSFER_GAS_LIMIT } from './constants.js';
+export 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 wallet.signTransaction(tx);
+}
+export 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 wallet.signTransaction(tx);
+}
+export 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 wallet.signTransaction(tx);
+}

package/dist/utils/holders-maker-helpers.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 刷持有人 helpers — facade re-export（实现见 holders-maker/ 子模块）
+ */
+export * from './holders-maker/addresses.js';
+export * from './holders-maker/constants.js';
+export { generateDisperseHopPaths, buildDisperseHopChainNative, buildDisperseHopChainERC20, calculateMaxWalletsPerBatch, DEFAULT_MAX_WALLETS_PER_BATCH_NATIVE, DEFAULT_MAX_WALLETS_PER_BATCH_ERC20, chunkArray, } from './holders-maker/disperse.js';
+export { buildERC20TransferTx, buildERC20ApproveTx, buildNativeTransferTx } from './holders-maker/transfer-tx.js';
+export { getBaseTokenAddress, getRouterAddress, getWrappedNativeAddress } from './holders-maker/routing.js';
+export { buildFlapBuyTx, buildFourBuyTx, buildDaoaasBuyTx, buildV2BuyTx, buildV3BuyTx, buildV2BuyTxWithERC20, buildV3BuyTxWithERC20, } from './holders-maker/buy-tx.js';

package/dist/utils/holders-maker-helpers.js

@@ -0,0 +1,9 @@
+/**
+ * 刷持有人 helpers — facade re-export（实现见 holders-maker/ 子模块）
+ */
+export * from './holders-maker/addresses.js';
+export * from './holders-maker/constants.js';
+export { generateDisperseHopPaths, buildDisperseHopChainNative, buildDisperseHopChainERC20, calculateMaxWalletsPerBatch, DEFAULT_MAX_WALLETS_PER_BATCH_NATIVE, DEFAULT_MAX_WALLETS_PER_BATCH_ERC20, chunkArray, } from './holders-maker/disperse.js';
+export { buildERC20TransferTx, buildERC20ApproveTx, buildNativeTransferTx } from './holders-maker/transfer-tx.js';
+export { getBaseTokenAddress, getRouterAddress, getWrappedNativeAddress } from './holders-maker/routing.js';
+export { buildFlapBuyTx, buildFourBuyTx, buildDaoaasBuyTx, buildV2BuyTx, buildV3BuyTx, buildV2BuyTxWithERC20, buildV3BuyTxWithERC20, } from './holders-maker/buy-tx.js';