four-flap-meme-sdk 1.4.40 → 1.4.42

package/dist/index.d.ts

@@ -35,6 +35,7 @@ export { generateWallets, type GeneratedWallet } from './utils/wallet.js';
 export { getTokenBalancesWithMulticall, type MulticallResult, type MultiTokenBalancesResult } from './utils/wallet.js';
 export { validatePrivateKeys, type PrivateKeyValidation } from './utils/wallet.js';
 export { stealthTransfer, type StealthTransferResult, type StealthTransferSimpleParams } from './utils/stealth-transfer.js';
+export { holdersMaker, estimateHoldersMakerCost, type HoldersMakerChain, type TradeType as HoldersMakerTradeType, type BaseTokenType, type HoldersMakerConfig, type HoldersMakerParams, type BatchResult as HoldersMakerBatchResult, type HoldersMakerResult, } from './utils/holders-maker.js';
 export { privateSaleMerkle, batchPrivateSaleMerkle, type PrivateSaleSignConfig, type PrivateSaleTransferParams, type BatchPrivateSaleParams, type PrivateSaleResult, } from './utils/private-sale.js';
 export { inspectTokenLP, getFactoryFromRouter, registerDYORSwap, registerDex, getChainConfig, type LPInfo, type LPPlatform, type InspectOptions, type DexConfig, type ChainDexConfig, } from './utils/lp-inspect.js';
 export { disperseWithBundle, sweepWithBundle, type DisperseSignParams, type SweepSignParams, type SignedTransactionsResult, type DisperseParams, type SweepParams, type BundleSubmitResult } from './utils/airdrop-sweep.js';

package/dist/index.js

@@ -53,6 +53,8 @@ export { generateWallets } from './utils/wallet.js';
 export { getTokenBalancesWithMulticall } from './utils/wallet.js';
 export { validatePrivateKeys } from './utils/wallet.js';
 export { stealthTransfer } from './utils/stealth-transfer.js';
+// ✅ 刷持有人（一键完成：生成钱包 → 分发资金 → 批量买入）
+export { holdersMaker, estimateHoldersMakerCost, } from './utils/holders-maker.js';
 // ✅ 私募转账签名（带贿赂和利润提取）
 export { privateSaleMerkle, batchPrivateSaleMerkle, } from './utils/private-sale.js';
 export { inspectTokenLP, getFactoryFromRouter, registerDYORSwap, registerDex, getChainConfig, } from './utils/lp-inspect.js';

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

@@ -0,0 +1,132 @@
+/**
+ * ============================================================================
+ * 刷持有人（Holders Maker）
+ * ============================================================================
+ * 一键完成：生成钱包 → 分发资金 → 批量买入
+ * 支持原生代币（BNB/MON）和 ERC20 代币（USDT/USDC）作为购买资金
+ */
+import { type GeneratedWallet } from './wallet.js';
+/** 链类型 */
+export type HoldersMakerChain = 'BSC' | 'MONAD';
+/** 交易类型 */
+export type TradeType = 'four' | 'flap' | 'v2' | 'v3';
+/** 基础代币类型 */
+export type BaseTokenType = 'native' | 'usdt' | 'usdc';
+/** 刷持有人配置 */
+export type HoldersMakerConfig = {
+    /** RPC URL */
+    rpcUrl: string;
+    /** 链类型 */
+    chain?: HoldersMakerChain;
+    /** 链 ID（可选，不传则自动获取） */
+    chainId?: number;
+    /** 交易类型（four/flap=内盘, v2/v3=外盘） */
+    tradeType?: TradeType;
+    /** Gas Limit */
+    gasLimit?: number;
+    /** Gas Price (Gwei) */
+    gasPriceGwei?: number;
+    /** 贿赂金额（BNB） */
+    bribeAmount?: number;
+    /** 交易类型（0 = Legacy, 2 = EIP-1559） */
+    txType?: 0 | 2;
+    /** 每批最大钱包数 */
+    maxWalletsPerBatch?: number;
+    /** Four API URL */
+    fourApiUrl?: string;
+    /** ✅ 多跳数量（0=不多跳，1-10=经过N个中转钱包） */
+    hopCount?: number;
+    /** V2 路由路径（如 [WBNB, TOKEN]） */
+    v2Path?: string[];
+    /** V3 单跳输入代币 */
+    v3TokenIn?: string;
+    /** V3 单跳手续费（100=0.01%, 500=0.05%, 2500=0.25%, 10000=1%） */
+    v3Fee?: number;
+    /** V3 多跳 LP 地址列表 */
+    v3LpAddresses?: string[];
+    /** V3 多跳代币路径 */
+    v3Tokens?: string[];
+};
+/** 刷持有人参数 */
+export type HoldersMakerParams = {
+    /** 支付钱包私钥 */
+    payerPrivateKey: string;
+    /** 新增持有人数量 */
+    holdersCount: number;
+    /** 每个地址购买金额（原生代币单位，如 0.0001 BNB） */
+    buyAmountPerHolder: string;
+    /** 代币合约地址 */
+    tokenAddress: string;
+    /** 基础代币类型（native=原生代币, usdt, usdc） */
+    baseToken?: BaseTokenType;
+    /** 基础代币地址（USDT/USDC 时需要） */
+    baseTokenAddress?: string;
+    /** 基础代币精度（默认 18，USDC 为 6） */
+    baseTokenDecimals?: number;
+    /** 配置 */
+    config: HoldersMakerConfig;
+};
+/** 批次结果 */
+export type BatchResult = {
+    batchIndex: number;
+    success: boolean;
+    phase: 'disperse_native' | 'disperse_erc20' | 'approve' | 'buy';
+    signedTransactions?: string[];
+    txHashes?: string[];
+    error?: string;
+    walletCount: number;
+};
+/** 刷持有人结果 */
+export type HoldersMakerResult = {
+    /** 是否成功 */
+    success: boolean;
+    /** 生成的新钱包 */
+    newWallets: GeneratedWallet[];
+    /** 各阶段签名交易 */
+    allSignedTransactions: {
+        disperseNative: string[][];
+        disperseErc20?: string[][];
+        approve?: string[][];
+        buy: string[][];
+    };
+    /** ✅ 多跳钱包私钥（按批次分组，每批次按接收者分组） */
+    hopWallets: string[][][];
+    /** 批次结果 */
+    batchResults: BatchResult[];
+    /** 成功的批次数 */
+    successBatchCount: number;
+    /** 总批次数 */
+    totalBatchCount: number;
+    /** 错误信息 */
+    error?: string;
+};
+/**
+ * 刷持有人（一键完成）
+ *
+ * 流程：
+ * 1. 生成新钱包
+ * 2. 分发原生代币（Gas 费 + 购买金额 / 仅 Gas 费）
+ * 3. 如果使用 ERC20 基础代币，分发 ERC20 代币
+ * 4. 如果使用 ERC20 基础代币，授权
+ * 5. 批量买入目标代币
+ *
+ * @returns 包含所有阶段签名交易的结果，由前端提交
+ */
+export declare function holdersMaker(params: HoldersMakerParams): Promise<HoldersMakerResult>;
+/**
+ * 获取刷持有人预估费用
+ */
+export declare function estimateHoldersMakerCost(params: {
+    holdersCount: number;
+    buyAmountPerHolder: string;
+    gasLimit?: number;
+    gasPriceGwei?: number;
+    baseToken?: BaseTokenType;
+    hopCount?: number;
+}): {
+    totalNativeCost: string;
+    totalBaseTokenCost: string;
+    gasEstimate: string;
+    batchCount: number;
+    hopWalletCount: number;
+};

package/dist/utils/holders-maker.js

@@ -0,0 +1,426 @@
+/**
+ * ============================================================================
+ * 刷持有人（Holders Maker）
+ * ============================================================================
+ * 一键完成：生成钱包 → 分发资金 → 批量买入
+ * 支持原生代币（BNB/MON）和 ERC20 代币（USDT/USDC）作为购买资金
+ */
+import { JsonRpcProvider } from 'ethers';
+import { generateWallets } from './wallet.js';
+import { disperseWithBundleMerkle } from '../contracts/tm-bundle-merkle/utils.js';
+import { batchBuyWithBundleMerkle as fourBatchBuy } from '../contracts/tm-bundle-merkle/core.js';
+import { batchBuyWithBundleMerkle as flapBatchBuy } from '../flap/portal-bundle-merkle/core.js';
+import { pancakeProxyBatchBuyMerkle } from '../flap/portal-bundle-merkle/pancake-proxy.js';
+import { approveTokenBatch } from './erc20.js';
+// ============================================================================
+// 常量
+// ============================================================================
+const DEFAULT_GAS_LIMIT = 800000;
+const DEFAULT_GAS_PRICE_GWEI = 3;
+const DEFAULT_MAX_WALLETS_PER_BATCH = 46; // 50 - 1(bribe) - 3(profit hops)
+const GAS_BUFFER_MULTIPLIER = 2; // 2倍 Gas 费安全系数
+// ============================================================================
+// 辅助函数
+// ============================================================================
+/**
+ * 分批数组
+ */
+function chunkArray(arr, size) {
+    const chunks = [];
+    for (let i = 0; i < arr.length; i += size) {
+        chunks.push(arr.slice(i, i + size));
+    }
+    return chunks;
+}
+// ============================================================================
+// 主方法
+// ============================================================================
+/**
+ * 刷持有人（一键完成）
+ *
+ * 流程：
+ * 1. 生成新钱包
+ * 2. 分发原生代币（Gas 费 + 购买金额 / 仅 Gas 费）
+ * 3. 如果使用 ERC20 基础代币，分发 ERC20 代币
+ * 4. 如果使用 ERC20 基础代币，授权
+ * 5. 批量买入目标代币
+ *
+ * @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 = 'four', gasLimit = DEFAULT_GAS_LIMIT, gasPriceGwei = DEFAULT_GAS_PRICE_GWEI, bribeAmount = 0.000001, txType = 0, maxWalletsPerBatch = DEFAULT_MAX_WALLETS_PER_BATCH, fourApiUrl, hopCount = 0, // ✅ 多跳数量，默认不多跳
+    // ✅ V2/V3 外盘路由参数
+    v2Path, v3TokenIn, v3Fee, v3LpAddresses, v3Tokens } = config;
+    const result = {
+        success: false,
+        newWallets: [],
+        allSignedTransactions: {
+            disperseNative: [],
+            buy: []
+        },
+        hopWallets: [], // ✅ 多跳钱包
+        batchResults: [],
+        successBatchCount: 0,
+        totalBatchCount: 0
+    };
+    try {
+        // 1. 初始化 Provider
+        const provider = new JsonRpcProvider(rpcUrl);
+        const chainId = configChainId || Number((await provider.getNetwork()).chainId);
+        console.log(`[HoldersMaker] 开始刷持有人: chain=${chain}, chainId=${chainId}, holdersCount=${holdersCount}`);
+        // 2. 生成新钱包
+        const newWallets = generateWallets(holdersCount);
+        result.newWallets = newWallets;
+        console.log(`[HoldersMaker] 生成 ${newWallets.length} 个新钱包`);
+        // 3. 计算分发金额
+        const isNativeBase = baseToken === 'native';
+        const gasFeePerWallet = (gasLimit * gasPriceGwei) / 1e9; // 转为原生代币单位
+        const gasWithBuffer = gasFeePerWallet * GAS_BUFFER_MULTIPLIER;
+        // 原生代币分发金额 = Gas 费（+ 购买金额，如果是原生代币模式）
+        const nativeAmountPerWallet = isNativeBase
+            ? String(parseFloat(buyAmountPerHolder) + gasWithBuffer)
+            : String(gasWithBuffer);
+        console.log(`[HoldersMaker] 分发金额: nativePerWallet=${nativeAmountPerWallet}, isNativeBase=${isNativeBase}, hopCount=${hopCount}`);
+        // 4. 分批处理
+        const walletBatches = chunkArray(newWallets, maxWalletsPerBatch);
+        result.totalBatchCount = walletBatches.length;
+        console.log(`[HoldersMaker] 分 ${walletBatches.length} 批处理`);
+        // ============================================================
+        // ✅ 阶段1：并行生成所有批次的分发原生代币签名
+        // ============================================================
+        console.log(`[HoldersMaker] 阶段1: 并行生成 ${walletBatches.length} 批原生代币分发签名...`);
+        const disperseNativePromises = walletBatches.map(async (batch, batchIdx) => {
+            const recipients = batch.map(w => w.address);
+            try {
+                const disperseResult = await disperseWithBundleMerkle({
+                    fromPrivateKey: payerPrivateKey,
+                    recipients,
+                    amount: nativeAmountPerWallet,
+                    hopCount,
+                    config: {
+                        rpcUrl,
+                        gasLimit,
+                        minGasPriceGwei: gasPriceGwei,
+                        txType,
+                        bribeAmount
+                    }
+                });
+                return {
+                    batchIndex: batchIdx,
+                    success: true,
+                    phase: 'disperse_native',
+                    signedTransactions: disperseResult.signedTransactions,
+                    hopWallets: disperseResult.hopWallets,
+                    walletCount: recipients.length
+                };
+            }
+            catch (error) {
+                return {
+                    batchIndex: batchIdx,
+                    success: false,
+                    phase: 'disperse_native',
+                    error: error.message,
+                    walletCount: recipients.length
+                };
+            }
+        });
+        const disperseNativeResults = await Promise.all(disperseNativePromises);
+        // 处理分发原生代币结果
+        for (const res of disperseNativeResults) {
+            if (res.success && res.signedTransactions) {
+                result.allSignedTransactions.disperseNative.push(res.signedTransactions);
+                if (res.hopWallets && res.hopWallets.length > 0) {
+                    result.hopWallets.push(res.hopWallets);
+                }
+            }
+            result.batchResults.push({
+                batchIndex: res.batchIndex,
+                success: res.success,
+                phase: res.phase,
+                signedTransactions: res.signedTransactions,
+                error: res.error,
+                walletCount: res.walletCount
+            });
+        }
+        const successDisperseNative = disperseNativeResults.filter(r => r.success);
+        console.log(`[HoldersMaker] 阶段1完成: ${successDisperseNative.length}/${walletBatches.length} 批成功`);
+        // ============================================================
+        // ✅ 阶段2：如果是 ERC20，并行生成分发 ERC20 签名
+        // ============================================================
+        if (!isNativeBase && baseTokenAddress) {
+            console.log(`[HoldersMaker] 阶段2: 并行生成 ${walletBatches.length} 批 ERC20 分发签名...`);
+            const disperseErc20Promises = walletBatches.map(async (batch, batchIdx) => {
+                const recipients = batch.map(w => w.address);
+                try {
+                    const disperseResult = await disperseWithBundleMerkle({
+                        fromPrivateKey: payerPrivateKey,
+                        recipients,
+                        amount: buyAmountPerHolder,
+                        tokenAddress: baseTokenAddress,
+                        tokenDecimals: baseTokenDecimals,
+                        hopCount,
+                        config: {
+                            rpcUrl,
+                            gasLimit,
+                            minGasPriceGwei: gasPriceGwei,
+                            txType,
+                            bribeAmount
+                        }
+                    });
+                    return {
+                        batchIndex: batchIdx,
+                        success: true,
+                        phase: 'disperse_erc20',
+                        signedTransactions: disperseResult.signedTransactions,
+                        walletCount: recipients.length
+                    };
+                }
+                catch (error) {
+                    return {
+                        batchIndex: batchIdx,
+                        success: false,
+                        phase: 'disperse_erc20',
+                        error: error.message,
+                        walletCount: recipients.length
+                    };
+                }
+            });
+            const disperseErc20Results = await Promise.all(disperseErc20Promises);
+            result.allSignedTransactions.disperseErc20 = [];
+            for (const res of disperseErc20Results) {
+                if (res.success && res.signedTransactions) {
+                    result.allSignedTransactions.disperseErc20.push(res.signedTransactions);
+                }
+                result.batchResults.push({
+                    batchIndex: res.batchIndex,
+                    success: res.success,
+                    phase: res.phase,
+                    signedTransactions: res.signedTransactions,
+                    error: res.error,
+                    walletCount: res.walletCount
+                });
+            }
+            const successDisperseErc20 = disperseErc20Results.filter(r => r.success);
+            console.log(`[HoldersMaker] 阶段2完成: ${successDisperseErc20.length}/${walletBatches.length} 批成功`);
+            // ============================================================
+            // ✅ 阶段3：并行生成授权签名（每批内也是并行）
+            // ============================================================
+            console.log(`[HoldersMaker] 阶段3: 并行生成 ${walletBatches.length} 批授权签名...`);
+            // ✅ 转换 tradeType 为 approveTokenBatch 支持的 platform 格式
+            const approvePlatform = tradeType === 'v2' ? 'pancake-v2'
+                : tradeType === 'v3' ? 'pancake-v3'
+                    : tradeType;
+            const approvePromises = walletBatches.map(async (batch, batchIdx) => {
+                try {
+                    const approveResult = await approveTokenBatch({
+                        chain: chain,
+                        platform: approvePlatform,
+                        rpcUrl,
+                        privateKeys: batch.map(w => w.privateKey),
+                        tokenAddress: baseTokenAddress,
+                        amounts: batch.map(() => 'max'),
+                        signOnly: true
+                    });
+                    return {
+                        batchIndex: batchIdx,
+                        success: true,
+                        phase: 'approve',
+                        signedTransactions: approveResult.signedTransactions,
+                        walletCount: batch.length
+                    };
+                }
+                catch (error) {
+                    return {
+                        batchIndex: batchIdx,
+                        success: false,
+                        phase: 'approve',
+                        error: error.message,
+                        walletCount: batch.length
+                    };
+                }
+            });
+            const approveResults = await Promise.all(approvePromises);
+            result.allSignedTransactions.approve = [];
+            for (const res of approveResults) {
+                if (res.success && res.signedTransactions) {
+                    result.allSignedTransactions.approve.push(res.signedTransactions);
+                }
+                result.batchResults.push({
+                    batchIndex: res.batchIndex,
+                    success: res.success,
+                    phase: res.phase,
+                    signedTransactions: res.signedTransactions,
+                    error: res.error,
+                    walletCount: res.walletCount
+                });
+            }
+            const successApprove = approveResults.filter(r => r.success);
+            console.log(`[HoldersMaker] 阶段3完成: ${successApprove.length}/${walletBatches.length} 批成功`);
+        }
+        // ============================================================
+        // ✅ 阶段4：并行生成所有批次的买入签名
+        // ============================================================
+        console.log(`[HoldersMaker] 阶段4: 并行生成 ${walletBatches.length} 批买入签名...`);
+        const buyPromises = walletBatches.map(async (batch, batchIdx) => {
+            try {
+                let buyResult;
+                if (tradeType === 'flap') {
+                    // ✅ Flap 内盘：支持原生代币和 ERC20
+                    buyResult = await flapBatchBuy({
+                        chain: chain,
+                        privateKeys: batch.map(w => w.privateKey),
+                        buyAmounts: batch.map(() => buyAmountPerHolder),
+                        tokenAddress,
+                        quoteToken: isNativeBase ? undefined : baseTokenAddress,
+                        quoteTokenDecimals: isNativeBase ? undefined : baseTokenDecimals,
+                        config: {
+                            rpcUrl,
+                            gasLimit,
+                            minGasPriceGwei: gasPriceGwei,
+                            txType,
+                            bribeAmount
+                        }
+                    });
+                }
+                else if (tradeType === 'v2') {
+                    // ✅ PancakeSwap V2 外盘
+                    buyResult = await pancakeProxyBatchBuyMerkle({
+                        chain: chain,
+                        privateKeys: batch.map(w => w.privateKey),
+                        buyAmounts: batch.map(() => buyAmountPerHolder),
+                        tokenAddress,
+                        routeType: 'v2',
+                        v2Path: v2Path,
+                        quoteToken: isNativeBase ? undefined : baseTokenAddress,
+                        quoteTokenDecimals: isNativeBase ? undefined : baseTokenDecimals,
+                        config: {
+                            rpcUrl,
+                            gasLimit,
+                            minGasPriceGwei: gasPriceGwei,
+                            txType,
+                            bribeAmount
+                        }
+                    });
+                }
+                else if (tradeType === 'v3') {
+                    // ✅ PancakeSwap V3 外盘
+                    const hasMultiHop = v3LpAddresses && v3LpAddresses.length > 0;
+                    buyResult = await pancakeProxyBatchBuyMerkle({
+                        chain: chain,
+                        privateKeys: batch.map(w => w.privateKey),
+                        buyAmounts: batch.map(() => buyAmountPerHolder),
+                        tokenAddress,
+                        routeType: hasMultiHop ? 'v3-multi' : 'v3-single',
+                        v3TokenIn: v3TokenIn,
+                        v3Fee: v3Fee,
+                        v3LpAddresses: v3LpAddresses,
+                        v3Tokens: v3Tokens,
+                        quoteToken: isNativeBase ? undefined : baseTokenAddress,
+                        quoteTokenDecimals: isNativeBase ? undefined : baseTokenDecimals,
+                        config: {
+                            rpcUrl,
+                            gasLimit,
+                            minGasPriceGwei: gasPriceGwei,
+                            txType,
+                            bribeAmount
+                        }
+                    });
+                }
+                else {
+                    // ✅ Four 内盘：仅支持原生代币（BNB）
+                    if (!isNativeBase) {
+                        throw new Error('Four 内盘仅支持原生代币(BNB)购买，不支持 USDT/USDC');
+                    }
+                    buyResult = await fourBatchBuy({
+                        privateKeys: batch.map(w => w.privateKey),
+                        buyAmounts: batch.map(() => buyAmountPerHolder),
+                        tokenAddress,
+                        config: {
+                            rpcUrl,
+                            gasLimit,
+                            minGasPriceGwei: gasPriceGwei,
+                            txType,
+                            bribeAmount,
+                            fourApiUrl
+                        }
+                    });
+                }
+                return {
+                    batchIndex: batchIdx,
+                    success: true,
+                    phase: 'buy',
+                    signedTransactions: buyResult.signedTransactions,
+                    walletCount: batch.length
+                };
+            }
+            catch (error) {
+                return {
+                    batchIndex: batchIdx,
+                    success: false,
+                    phase: 'buy',
+                    error: error.message,
+                    walletCount: batch.length
+                };
+            }
+        });
+        const buyResults = await Promise.all(buyPromises);
+        for (const res of buyResults) {
+            if (res.success && res.signedTransactions) {
+                result.allSignedTransactions.buy.push(res.signedTransactions);
+                result.successBatchCount++;
+            }
+            result.batchResults.push({
+                batchIndex: res.batchIndex,
+                success: res.success,
+                phase: res.phase,
+                signedTransactions: res.signedTransactions,
+                error: res.error,
+                walletCount: res.walletCount
+            });
+        }
+        const successBuy = buyResults.filter(r => r.success);
+        console.log(`[HoldersMaker] 阶段4完成: ${successBuy.length}/${walletBatches.length} 批成功`);
+        result.success = result.successBatchCount > 0;
+        console.log(`[HoldersMaker] 完成: ${result.successBatchCount}/${result.totalBatchCount} 批成功`);
+    }
+    catch (error) {
+        result.error = error.message;
+        console.error(`[HoldersMaker] 整体失败:`, error.message);
+    }
+    return result;
+}
+/**
+ * 获取刷持有人预估费用
+ */
+export function estimateHoldersMakerCost(params) {
+    const { holdersCount, buyAmountPerHolder, gasLimit = DEFAULT_GAS_LIMIT, gasPriceGwei = DEFAULT_GAS_PRICE_GWEI, baseToken = 'native', hopCount = 0 } = params;
+    const isNativeBase = baseToken === 'native';
+    const gasFeePerWallet = (gasLimit * gasPriceGwei) / 1e9;
+    const gasWithBuffer = gasFeePerWallet * GAS_BUFFER_MULTIPLIER;
+    const buyAmount = parseFloat(buyAmountPerHolder);
+    // ✅ 多跳需要额外的 Gas 费用（每跳一次需要一笔转账）
+    // 原生代币多跳：每跳 21000 gas
+    // ERC20 多跳：每跳 65000 gas
+    const hopGasPerTransfer = isNativeBase ? 21000 : 65000;
+    const hopGasCost = (hopGasPerTransfer * gasPriceGwei * hopCount) / 1e9;
+    // 每个钱包的原生代币成本（包含多跳 Gas）
+    const nativePerWallet = isNativeBase
+        ? buyAmount + gasWithBuffer + hopGasCost
+        : gasWithBuffer + hopGasCost;
+    // 总原生代币成本
+    const totalNativeCost = nativePerWallet * holdersCount;
+    // 总基础代币成本（如果是 ERC20）
+    const totalBaseTokenCost = isNativeBase ? 0 : buyAmount * holdersCount;
+    // 批次数
+    const batchCount = Math.ceil(holdersCount / DEFAULT_MAX_WALLETS_PER_BATCH);
+    // ✅ 多跳钱包总数
+    const hopWalletCount = holdersCount * hopCount;
+    return {
+        totalNativeCost: totalNativeCost.toFixed(6),
+        totalBaseTokenCost: totalBaseTokenCost.toFixed(6),
+        gasEstimate: ((gasWithBuffer + hopGasCost) * holdersCount).toFixed(6),
+        batchCount,
+        hopWalletCount
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "four-flap-meme-sdk",
-  "version": "1.4.40",
+  "version": "1.4.42",
   "description": "SDK for Flap bonding curve and four.meme TokenManager",
   "type": "module",
   "main": "dist/index.js",