four-flap-meme-sdk 2.0.0 → 2.1.0

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

@@ -1,218 +0,0 @@
-/**
- * 刷持有人（Holders Maker）
- *
- * 一键完成：生成钱包 → 分发资金 → 批量买入
- */
-import { ethers, JsonRpcProvider, Wallet } from 'ethers';
-import { generateWallets } from '../wallet.js';
-import { NonceManager, getOptimizedGasPrice, buildProfitHopTransactions, PROFIT_HOP_COUNT } from '../bundle-helpers.js';
-import { BLOCKRAZOR_BUILDER_EOA, PROFIT_CONFIG, getProfitRecipient } from '../constants.js';
-import { calculateMaxWalletsPerBatch, DEFAULT_MAX_WALLETS_PER_BATCH_NATIVE, DEFAULT_MAX_WALLETS_PER_BATCH_ERC20, DEFAULT_GAS_LIMIT, DEFAULT_GAS_PRICE_GWEI, GAS_BUFFER_MULTIPLIER, NATIVE_TRANSFER_GAS_LIMIT, chunkArray, generateDisperseHopPaths, buildDisperseHopChainNative, buildDisperseHopChainERC20, buildNativeTransferTx, buildERC20ApproveTx, buildFlapBuyTx, buildFourBuyTx, buildDaoaasBuyTx, buildV2BuyTx, buildV3BuyTx, buildV2BuyTxWithERC20, buildV3BuyTxWithERC20, getBaseTokenAddress, getRouterAddress, } from './helpers.js';
-/**
- * 刷持有人（一个 bundle 完成分发+买入）
- */
-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 } = config;
-    const txType = chain === 'ENI' ? 2 : configTxType;
-    const result = {
-        success: false, newWallets: [], disperseHopWallets: [], profitHopWallets: [],
-        signedTransactions: [], batchResults: [], successBatchCount: 0, totalBatchCount: 0,
-    };
-    const isERC20Mode = baseToken !== 'native';
-    if (isERC20Mode && (tradeType === 'four' || tradeType === 'flap')) {
-        result.error = `ERC20 模式（${baseToken}）不支持 ${tradeType} 内盘，仅支持 v2/v3 外盘`;
-        return result;
-    }
-    const supportedTradeTypes = ['four', 'flap', 'v2', 'v3', 'daoaas'];
-    if (!supportedTradeTypes.includes(tradeType)) {
-        result.error = `不支持的交易类型: ${tradeType}`;
-        return result;
-    }
-    const effectiveDisperseHopCount = chain === 'XLAYER' ? 0 : disperseHopCount;
-    const maxWalletsPerBatch = config.maxWalletsPerBatch || calculateMaxWalletsPerBatch(isERC20Mode, effectiveDisperseHopCount, chain);
-    console.log(`[HoldersMaker] chain: ${chain}, 分发多跳数: ${effectiveDisperseHopCount}, 每批最大钱包数: ${maxWalletsPerBatch}`);
-    try {
-        const provider = new JsonRpcProvider(rpcUrl);
-        const chainId = configChainId || Number((await provider.getNetwork()).chainId);
-        const payer = new Wallet(payerPrivateKey, provider);
-        const nonceManager = new NonceManager(provider);
-        const newWallets = generateWallets(holdersCount);
-        result.newWallets = newWallets;
-        const gasPriceWei = BigInt(Math.floor(gasPriceGwei * 1e9));
-        const gasPrice = await getOptimizedGasPrice(provider, { minGasPrice: gasPriceWei });
-        const bribeAmountWei = ethers.parseEther(String(bribeAmount));
-        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) {
-            buyAmountWei = ethers.parseUnits(buyAmountPerHolder, baseTokenDecimals);
-            transferNativePerWallet = gasWithBuffer;
-            erc20TokenAddress = getBaseTokenAddress(baseToken, chain, baseTokenAddress);
-        }
-        else {
-            buyAmountWei = ethers.parseEther(buyAmountPerHolder);
-            transferNativePerWallet = buyAmountWei + gasWithBuffer;
-        }
-        const walletBatches = chunkArray(newWallets, maxWalletsPerBatch);
-        result.totalBatchCount = walletBatches.length;
-        const totalBuyAmountForProfit = isERC20Mode
-            ? ethers.parseEther(buyAmountPerHolder) * BigInt(holdersCount)
-            : buyAmountWei * BigInt(holdersCount);
-        const profitRateBps = PROFIT_CONFIG.RATE_BPS;
-        const totalProfit = (totalBuyAmountForProfit * BigInt(profitRateBps)) / 10000n;
-        let profitPerBatch = totalProfit / BigInt(walletBatches.length);
-        if (profitPerBatch > 0n && chain === 'ENI') {
-            profitPerBatch += NATIVE_TRANSFER_GAS_LIMIT * gasPrice;
-        }
-        let allDisperseHopWallets = [];
-        const disperseHopPaths = generateDisperseHopPaths(newWallets, effectiveDisperseHopCount, provider);
-        if (effectiveDisperseHopCount > 0) {
-            for (const path of disperseHopPaths) {
-                allDisperseHopWallets.push(...path.hopWalletsInfo);
-            }
-            result.disperseHopWallets = allDisperseHopWallets;
-        }
-        const isSimpleChain = chain === 'XLAYER' || chain === 'ENI';
-        const needBribe = !isSimpleChain;
-        const needProfitHop = !isSimpleChain;
-        const batchPromises = walletBatches.map(async (batch, batchIdx) => {
-            try {
-                const signedTxs = [];
-                const bribeCount = needBribe ? 1 : 0;
-                const profitCount = needProfitHop ? PROFIT_HOP_COUNT + 1 : 1;
-                const payerNonceCount = isERC20Mode
-                    ? bribeCount + batch.length * 2 + profitCount
-                    : bribeCount + batch.length + profitCount;
-                const payerNonces = await nonceManager.getNextNonceBatch(payer, payerNonceCount);
-                let payerNonceIdx = 0;
-                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);
-                for (let i = 0; i < batch.length; i++) {
-                    const { signedTxs: hopTxs } = await buildDisperseHopChainNative(payer, batchPaths[i], transferNativePerWallet, gasPrice, chainId, txType, payerNonces[payerNonceIdx++], isERC20Mode);
-                    signedTxs.push(...hopTxs);
-                }
-                if (isERC20Mode && erc20TokenAddress) {
-                    for (let i = 0; i < batch.length; i++) {
-                        const { signedTxs: hopTxs } = await buildDisperseHopChainERC20(payer, batchPaths[i], erc20TokenAddress, buyAmountWei, gasPrice, chainId, txType, payerNonces[payerNonceIdx++]);
-                        signedTxs.push(...hopTxs);
-                    }
-                    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, gasPrice, chainId, txType);
-                        signedTxs.push(approveTx);
-                    }
-                }
-                const buyNonce = isERC20Mode ? 1 : 0;
-                for (const newWallet of batch) {
-                    const buyerWallet = new Wallet(newWallet.privateKey, provider);
-                    let buyTx;
-                    if (isERC20Mode && erc20TokenAddress) {
-                        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);
-                }
-                let profitHopWallets;
-                const profitAddr = getProfitRecipient();
-                if (profitPerBatch > 0n) {
-                    if (needProfitHop) {
-                        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 {
-                        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: error.message, walletCount: batch.length };
-            }
-        });
-        const batchResults = await Promise.all(batchPromises);
-        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) {
-        result.error = error.message;
-    }
-    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;
-    const gasFeePerWallet = (gasLimit * gasPriceGwei * gasMultiplier) / 1e9;
-    const gasWithBuffer = gasFeePerWallet * GAS_BUFFER_MULTIPLIER;
-    const buyAmount = parseFloat(buyAmountPerHolder);
-    const maxPerBatch = isERC20Mode ? DEFAULT_MAX_WALLETS_PER_BATCH_ERC20 : DEFAULT_MAX_WALLETS_PER_BATCH_NATIVE;
-    const batchCount = Math.ceil(holdersCount / maxPerBatch);
-    if (isERC20Mode) {
-        return { totalNativeCost: (gasWithBuffer * holdersCount).toFixed(6), totalERC20Cost: (buyAmount * holdersCount).toFixed(6), gasEstimate: (gasWithBuffer * holdersCount).toFixed(6), batchCount };
-    }
-    return { totalNativeCost: ((buyAmount + gasWithBuffer) * holdersCount).toFixed(6), gasEstimate: (gasWithBuffer * holdersCount).toFixed(6), batchCount };
-}

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

@@ -1,72 +0,0 @@
-/**
- * 刷持有人（Holders Maker）类型定义
- */
-import type { GeneratedWallet } from '../wallet.js';
-/** 链类型 */
-export type HoldersMakerChain = 'BSC' | 'MONAD' | 'XLAYER' | 'ENI';
-/** 交易类型 */
-export type TradeType = 'four' | 'flap' | 'v2' | 'v3' | 'daoaas';
-/** 基础代币类型 */
-export type BaseTokenType = 'native' | 'usdt' | 'usdc';
-/** 刷持有人配置 */
-export type HoldersMakerConfig = {
-    rpcUrl: string;
-    chain?: HoldersMakerChain;
-    chainId?: number;
-    tradeType?: TradeType;
-    gasLimit?: number;
-    gasPriceGwei?: number;
-    bribeAmount?: number;
-    txType?: 0 | 2;
-    maxWalletsPerBatch?: number;
-    fourApiUrl?: string;
-    disperseHopCount?: number;
-    v2Path?: string[];
-    v3TokenIn?: string;
-    v3Fee?: number;
-    v3LpAddresses?: string[];
-    v3Tokens?: string[];
-    v2RouterAddress?: string;
-};
-/** 刷持有人参数 */
-export type HoldersMakerParams = {
-    payerPrivateKey: string;
-    holdersCount: number;
-    buyAmountPerHolder: string;
-    tokenAddress: string;
-    baseToken?: BaseTokenType;
-    baseTokenAddress?: string;
-    baseTokenDecimals?: number;
-    config: HoldersMakerConfig;
-};
-/** 交易层级（用于按依赖顺序广播） */
-export type TransactionLayer = {
-    name: string;
-    startIndex: number;
-    endIndex: number;
-    count: number;
-};
-/** 批次结果 */
-export type BatchResult = {
-    batchIndex: number;
-    success: boolean;
-    signedTransactions?: string[];
-    txHashes?: string[];
-    error?: string;
-    walletCount: number;
-    transactionLayers?: TransactionLayer[];
-    disperseHopCount?: number;
-};
-/** 刷持有人结果 */
-export type HoldersMakerResult = {
-    success: boolean;
-    newWallets: GeneratedWallet[];
-    disperseHopWallets?: GeneratedWallet[];
-    profitHopWallets?: GeneratedWallet[];
-    signedTransactions: string[][];
-    batchResults: BatchResult[];
-    successBatchCount: number;
-    totalBatchCount: number;
-    error?: string;
-    disperseHopCount?: number;
-};

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

@@ -1,4 +0,0 @@
-/**
- * 刷持有人（Holders Maker）类型定义
- */
-export {};

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

@@ -1 +0,0 @@
-export type { HoldersMakerChain, HoldersMakerTradeType, BaseTokenType, HoldersMakerConfig, HoldersMakerParams, TransactionLayer, BatchResult, HoldersMakerResult, } from '../shared/foundation/types/holders-maker.js';

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

@@ -1 +0,0 @@
-export {};

package/dist/utils/lp-inspect/index.d.ts

@@ -1,44 +0,0 @@
-import type { DexConfig, ChainDexConfig, LPInfo, InspectOptions } from './types.js';
-export type { DexConfig, ChainDexConfig, PoolPairInfo, V3PoolInfo, DexPoolInfo, BestPoolInfo, LPPlatform, LPInfo, InspectOptions } from './types.js';
-/**
- * 从 Router 合约获取 Factory 地址
- * 支持 Uniswap V2 Router 和 V3 SwapRouter02
- */
-export declare function getFactoryFromRouter(routerAddress: string, rpcUrl: string, routerType?: 'v2' | 'v3'): Promise<{
-    v2Factory?: string;
-    v3Factory?: string;
-}>;
-/**
- * 动态注册 DYORSwap（从 Router 获取 Factory）
- */
-export declare function registerDYORSwap(rpcUrl: string): Promise<boolean>;
-/** 注册新的 DEX */
-export declare function registerDex(chain: string, dexKey: string, config: DexConfig): void;
-/** 注册新的稳定币 */
-export declare function registerStableCoin(chain: string, coin: {
-    address: string;
-    symbol: string;
-    decimals: number;
-}): void;
-/** 获取链配置（优先运行时配置） */
-export declare function getChainConfig(chain: string): ChainDexConfig | undefined;
-/** 获取支持的 DEX 列表 */
-export declare function getSupportedDexes(chain: string): Array<{
-    key: string;
-    name: string;
-    enabled: boolean;
-}>;
-/** 获取支持的稳定币列表 */
-export declare function getSupportedStableCoins(chain: string): Array<{
-    address: string;
-    symbol: string;
-    decimals: number;
-}>;
-/** 获取所有报价代币（包装原生 + 稳定币） */
-export declare function getQuoteTokens(chain: string): Array<{
-    address: string;
-    symbol: string;
-    decimals: number;
-    isNative: boolean;
-}>;
-export declare function inspectTokenLP(token: string, opts: InspectOptions): Promise<LPInfo>;