four-flap-meme-sdk 2.2.19 → 3.0.0

package/dist/domains/holders/holders-maker.js

@@ -0,0 +1,324 @@
+/**
+ * holders-maker - 主函数
+ */
+import { ethers, JsonRpcProvider, Wallet } from 'ethers';
+import { generateWallets } from '../../utils/wallet.js';
+import { NonceManager, getOptimizedGasPrice, buildProfitHopTransactions, PROFIT_HOP_COUNT } from '../../utils/bundle-helpers.js';
+import { BLOCKRAZOR_BUILDER_EOA, getProfitRecipient, getProfitRateBps as getSharedProfitRateBps, } from '../../core/constants/index.js';
+import { getErrorMessageFromUnknown } from '../../core/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';
+function formatUnitsFixed(value, decimals, precision = 6) {
+    const raw = ethers.formatUnits(value, decimals);
+    const [intPart, fracPart = ''] = raw.split('.');
+    if (precision <= 0)
+        return intPart;
+    return `${intPart}.${(fracPart + '0'.repeat(precision)).slice(0, precision)}`;
+}
+function parseGasPriceGwei(gasPriceGwei) {
+    if (!Number.isFinite(gasPriceGwei) || gasPriceGwei <= 0) {
+        throw new Error(`gasPriceGwei 非法: ${String(gasPriceGwei)}`);
+    }
+    return ethers.parseUnits(String(gasPriceGwei), 'gwei');
+}
+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=直接转账）
+     } = config;
+    // ENI 链强制使用 EIP-1559 (type 2)
+    const txType = chain === 'ENI' ? 2 : configTxType;
+    const result = {
+        success: false,
+        newWallets: [],
+        disperseHopWallets: [], // ✅ 分发多跳中间钱包
+        profitHopWallets: [], // ✅ 利润多跳中间钱包
+        signedTransactions: [],
+        batchResults: [],
+        successBatchCount: 0,
+        totalBatchCount: 0,
+    };
+    const isERC20Mode = baseToken !== 'native';
+    // ✅ ERC20 模式只支持 v2/v3 外盘
+    if (isERC20Mode && (tradeType === 'four' || tradeType === 'flap')) {
+        result.error = `ERC20 模式（${baseToken}）不支持 ${tradeType} 内盘，仅支持 v2/v3 外盘`;
+        return result;
+    }
+    // ✅ 支持 four、flap 内盘和 v2、v3 外盘、daoaas 内盘
+    const supportedTradeTypes = ['four', 'flap', 'v2', 'v3', 'daoaas'];
+    if (!supportedTradeTypes.includes(tradeType)) {
+        result.error = `不支持的交易类型: ${tradeType}，支持: ${supportedTradeTypes.join(', ')}`;
+        return result;
+    }
+    // ✅ 根据分发多跳数动态计算每批最大钱包数
+    // XLayer 强制禁用分发多跳（ENI 已支持前端分层广播）
+    const effectiveDisperseHopCount = chain === 'XLAYER' ? 0 : disperseHopCount;
+    const maxWalletsPerBatch = config.maxWalletsPerBatch || calculateMaxWalletsPerBatch(isERC20Mode, effectiveDisperseHopCount, chain);
+    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);
+        // 2. 生成新钱包
+        const newWallets = generateWallets(holdersCount);
+        result.newWallets = newWallets;
+        // 3. 计算金额
+        const gasPriceWei = parseGasPriceGwei(gasPriceGwei);
+        const gasPrice = await getOptimizedGasPrice(provider, { minGasPrice: gasPriceWei });
+        const bribeAmountWei = ethers.parseEther(String(bribeAmount));
+        // ERC20 模式需要更多 gas（授权 + 购买）
+        const gasMultiplier = isERC20Mode ? 2 : 1;
+        const gasFeePerWallet = BigInt(gasLimit) * gasPrice * BigInt(gasMultiplier);
+        const gasWithBuffer = gasFeePerWallet * BigInt(GAS_BUFFER_MULTIPLIER);
+        let buyAmountWei;
+        let transferNativePerWallet;
+        let erc20TokenAddress;
+        if (isERC20Mode) {
+            // ERC20 模式：解析购买金额（考虑精度）
+            buyAmountWei = ethers.parseUnits(buyAmountPerHolder, baseTokenDecimals);
+            // 只需要分发 gas 费
+            transferNativePerWallet = gasWithBuffer;
+            // 获取 ERC20 地址
+            erc20TokenAddress = getBaseTokenAddress(baseToken, chain, baseTokenAddress);
+        }
+        else {
+            // 原生代币模式
+            buyAmountWei = ethers.parseEther(buyAmountPerHolder);
+            transferNativePerWallet = buyAmountWei + gasWithBuffer;
+        }
+        // 4. 分批处理
+        const walletBatches = chunkArray(newWallets, maxWalletsPerBatch);
+        result.totalBatchCount = walletBatches.length;
+        // 5. 计算利润（基于原生代币）
+        const totalBuyAmountForProfit = isERC20Mode
+            ? ethers.parseEther(buyAmountPerHolder) * BigInt(holdersCount) // 按等值 BNB 计算
+            : buyAmountWei * BigInt(holdersCount);
+        const profitRateBps = getSharedProfitRateBps('normal');
+        const totalProfit = (totalBuyAmountForProfit * BigInt(profitRateBps)) / 10000n;
+        let profitPerBatch = totalProfit / BigInt(walletBatches.length);
+        if (profitPerBatch > 0n && chain === 'ENI') {
+            profitPerBatch += NATIVE_TRANSFER_GAS_LIMIT * gasPrice;
+        }
+        // 利润计算完成
+        // 6. 生成分发多跳路径（如果启用）
+        const allDisperseHopWallets = [];
+        const disperseHopPaths = generateDisperseHopPaths(newWallets, effectiveDisperseHopCount, provider);
+        if (effectiveDisperseHopCount > 0) {
+            // 收集所有中间钱包信息用于导出
+            for (const path of disperseHopPaths) {
+                allDisperseHopWallets.push(...path.hopWalletsInfo);
+            }
+            result.disperseHopWallets = allDisperseHopWallets;
+        }
+        // ✅ XLayer/ENI 特殊处理：不需要贿赂和利润多跳
+        const isSimpleChain = chain === 'XLAYER' || chain === 'ENI';
+        const needBribe = !isSimpleChain;
+        const needProfitHop = !isSimpleChain;
+        // 7. 并行生成所有批次的签名
+        const batchPromises = walletBatches.map(async (batch, batchIdx) => {
+            try {
+                const signedTxs = [];
+                // 计算这批需要的 payer nonce 数量
+                // XLayer: 分发 N + 买入后利润 1
+                // BSC 原生模式（无多跳）: 贿赂 1 + 分发 N + 利润 (PROFIT_HOP_COUNT + 1)
+                // 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 payerNonceCount = isERC20Mode
+                    ? bribeCount + batch.length * 2 + profitCount
+                    : bribeCount + batch.length + profitCount;
+                const payerNonces = await nonceManager.getNextNonceBatch(payer, payerNonceCount);
+                let payerNonceIdx = 0;
+                // (1) 贿赂交易（仅 BSC）
+                if (needBribe) {
+                    const bribeTx = await buildNativeTransferTx(payer, BLOCKRAZOR_BUILDER_EOA, bribeAmountWei, payerNonces[payerNonceIdx++], gasPrice, chainId, txType);
+                    signedTxs.push(bribeTx);
+                }
+                // 获取当前批次对应的多跳路径
+                const batchStartIdx = batchIdx * maxWalletsPerBatch;
+                const batchPaths = disperseHopPaths.slice(batchStartIdx, batchStartIdx + batch.length);
+                // (2) 分发原生代币（支持多跳）
+                for (let i = 0; i < batch.length; i++) {
+                    const path = batchPaths[i];
+                    const { signedTxs: hopTxs } = await buildDisperseHopChainNative(payer, path, transferNativePerWallet, gasPrice, chainId, txType, payerNonces[payerNonceIdx++], isERC20Mode);
+                    signedTxs.push(...hopTxs);
+                }
+                // (3) ERC20 模式：分发 ERC20 代币（支持多跳）
+                if (isERC20Mode && erc20TokenAddress) {
+                    for (let i = 0; i < batch.length; i++) {
+                        const path = batchPaths[i];
+                        const { signedTxs: hopTxs } = await buildDisperseHopChainERC20(payer, path, erc20TokenAddress, buyAmountWei, gasPrice, chainId, txType, payerNonces[payerNonceIdx++]);
+                        signedTxs.push(...hopTxs);
+                    }
+                }
+                // (4) ERC20 模式：授权交易（新钱包 nonce=0）
+                if (isERC20Mode && erc20TokenAddress) {
+                    const routerAddress = getRouterAddress(tradeType, chain, config.v2RouterAddress);
+                    for (const newWallet of batch) {
+                        const buyerWallet = new Wallet(newWallet.privateKey, provider);
+                        const approveTx = await buildERC20ApproveTx(buyerWallet, erc20TokenAddress, routerAddress, ethers.MaxUint256, // 无限授权
+                        0, // 新钱包 nonce=0
+                        gasPrice, chainId, txType);
+                        signedTxs.push(approveTx);
+                    }
+                }
+                // (5) 买入交易
+                // 原生模式: nonce=0
+                // ERC20模式: nonce=1（授权后）
+                const buyNonce = isERC20Mode ? 1 : 0;
+                for (const newWallet of batch) {
+                    const buyerWallet = new Wallet(newWallet.privateKey, provider);
+                    let buyTx;
+                    if (isERC20Mode && erc20TokenAddress) {
+                        // ERC20 购买
+                        switch (tradeType) {
+                            case 'v2':
+                                buyTx = await buildV2BuyTxWithERC20(buyerWallet, tokenAddress, erc20TokenAddress, buyAmountWei, buyNonce, gasPrice, gasLimit, chainId, txType, config.v2RouterAddress, chain);
+                                break;
+                            case 'v3':
+                                buyTx = await buildV3BuyTxWithERC20(buyerWallet, tokenAddress, erc20TokenAddress, buyAmountWei, buyNonce, gasPrice, gasLimit, chainId, txType, config.v3Fee);
+                                break;
+                            default:
+                                throw new Error(`ERC20 模式不支持交易类型: ${tradeType}`);
+                        }
+                    }
+                    else {
+                        // 原生代币购买
+                        switch (tradeType) {
+                            case 'four':
+                                buyTx = await buildFourBuyTx(buyerWallet, tokenAddress, buyAmountWei, buyNonce, gasPrice, gasLimit, chainId, txType);
+                                break;
+                            case 'flap':
+                                buyTx = await buildFlapBuyTx(buyerWallet, tokenAddress, buyAmountWei, buyNonce, gasPrice, gasLimit, chainId, txType, chain);
+                                break;
+                            case 'v2':
+                                buyTx = await buildV2BuyTx(buyerWallet, tokenAddress, buyAmountWei, buyNonce, gasPrice, gasLimit, chainId, txType, config.v2Path, chain, config.v2RouterAddress);
+                                break;
+                            case 'v3':
+                                buyTx = await buildV3BuyTx(buyerWallet, tokenAddress, buyAmountWei, buyNonce, gasPrice, gasLimit, chainId, txType, config.v3Fee, chain);
+                                break;
+                            case 'daoaas':
+                                buyTx = await buildDaoaasBuyTx(buyerWallet, tokenAddress, buyAmountWei, buyNonce, gasPrice, gasLimit, chainId);
+                                break;
+                            default:
+                                throw new Error(`不支持的交易类型: ${tradeType}`);
+                        }
+                    }
+                    signedTxs.push(buyTx);
+                }
+                // (6) 利润转账（XLayer 直接转账，BSC 使用多跳）
+                let profitHopWallets;
+                const profitAddr = getProfitRecipient();
+                if (profitPerBatch > 0n) {
+                    if (needProfitHop) {
+                        // BSC: 使用利润多跳
+                        const profitHopResult = await buildProfitHopTransactions({
+                            provider,
+                            payerWallet: payer,
+                            profitAmount: profitPerBatch,
+                            profitRecipient: profitAddr,
+                            hopCount: PROFIT_HOP_COUNT,
+                            gasPrice,
+                            chainId,
+                            txType,
+                            startNonce: payerNonces[payerNonceIdx],
+                        });
+                        signedTxs.push(...profitHopResult.signedTransactions);
+                        profitHopWallets = profitHopResult.hopWallets;
+                    }
+                    else {
+                        // XLayer: 直接转账给利润接收者
+                        const profitTx = await buildNativeTransferTx(payer, profitAddr, profitPerBatch, payerNonces[payerNonceIdx], gasPrice, chainId, txType);
+                        signedTxs.push(profitTx);
+                    }
+                }
+                return {
+                    batchIndex: batchIdx,
+                    success: true,
+                    signedTransactions: signedTxs,
+                    walletCount: batch.length,
+                    profitHopWallets, // ✅ 返回利润多跳钱包
+                };
+            }
+            catch (error) {
+                return {
+                    batchIndex: batchIdx,
+                    success: false,
+                    error: getErrorMessageFromUnknown(error),
+                    walletCount: batch.length,
+                };
+            }
+        });
+        const batchResults = await Promise.all(batchPromises);
+        // 7. 处理结果
+        const allProfitHopWallets = [];
+        for (const res of batchResults) {
+            if (res.success && res.signedTransactions) {
+                result.signedTransactions.push(res.signedTransactions);
+                result.successBatchCount++;
+                // ✅ 收集利润多跳钱包
+                if (res.profitHopWallets) {
+                    allProfitHopWallets.push(...res.profitHopWallets);
+                }
+            }
+            result.batchResults.push({
+                batchIndex: res.batchIndex,
+                success: res.success,
+                signedTransactions: res.signedTransactions,
+                error: res.error,
+                walletCount: res.walletCount,
+                disperseHopCount: effectiveDisperseHopCount, // ✅ 添加分发多跳数
+            });
+        }
+        // ✅ 添加利润多跳钱包到结果
+        if (allProfitHopWallets.length > 0) {
+            result.profitHopWallets = allProfitHopWallets;
+        }
+        // ✅ 添加分发多跳数到结果
+        result.disperseHopCount = effectiveDisperseHopCount;
+        result.success = result.successBatchCount > 0;
+    }
+    catch (error) {
+        const msg = getErrorMessageFromUnknown(error);
+        result.error = msg;
+        console.error(`[HoldersMaker] 整体失败:`, msg);
+    }
+    return result;
+}
+/**
+ * 获取刷持有人预估费用
+ */
+export function estimateHoldersMakerCost(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 gasPriceWei = parseGasPriceGwei(gasPriceGwei);
+    const gasFeePerWalletWei = BigInt(gasLimit) * gasPriceWei * BigInt(gasMultiplier);
+    const gasWithBufferWei = gasFeePerWalletWei * BigInt(GAS_BUFFER_MULTIPLIER);
+    const buyAmountWei = ethers.parseUnits(buyAmountPerHolder, 18);
+    // 批次数
+    const maxPerBatch = isERC20Mode ? DEFAULT_MAX_WALLETS_PER_BATCH_ERC20 : DEFAULT_MAX_WALLETS_PER_BATCH_NATIVE;
+    const batchCount = Math.ceil(holdersCount / maxPerBatch);
+    if (isERC20Mode) {
+        // ERC20 模式：原生代币只用于 gas
+        const totalNativeCostWei = gasWithBufferWei * BigInt(holdersCount);
+        const totalERC20CostWei = buyAmountWei * BigInt(holdersCount);
+        return {
+            totalNativeCost: formatUnitsFixed(totalNativeCostWei, 18, 6),
+            totalERC20Cost: formatUnitsFixed(totalERC20CostWei, 18, 6),
+            gasEstimate: formatUnitsFixed(totalNativeCostWei, 18, 6),
+            batchCount,
+        };
+    }
+    else {
+        // 原生代币模式：包含购买金额 + gas
+        const costPerWalletWei = buyAmountWei + gasWithBufferWei;
+        const totalNativeCostWei = costPerWalletWei * BigInt(holdersCount);
+        const totalGasEstimateWei = gasWithBufferWei * BigInt(holdersCount);
+        return {
+            totalNativeCost: formatUnitsFixed(totalNativeCostWei, 18, 6),
+            gasEstimate: formatUnitsFixed(totalGasEstimateWei, 18, 6),
+            batchCount,
+        };
+    }
+}

package/dist/domains/holders/index.d.ts

@@ -0,0 +1 @@
+export * from './holders-maker.js';

package/dist/domains/holders/index.js

@@ -0,0 +1 @@
+export * from './holders-maker.js';

package/dist/domains/holders/internal/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/domains/holders/internal/addresses.js

@@ -0,0 +1,15 @@
+import { ADDRESSES } from '../../../utils/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/domains/holders/internal/buy-tx.d.ts

@@ -0,0 +1,44 @@
+import { Wallet } from 'ethers';
+import type { HoldersMakerChain } from '../../../core/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>;