four-flap-meme-sdk 1.3.91 → 1.3.93

package/dist/sol/utils/lp-inspect.js

@@ -1,529 +0,0 @@
-/**
- * Solana LP 检测工具
- * 自动判断代币在哪个平台（内盘/外盘）
- * @module sol/utils/lp-inspect
- */
-import { PublicKey } from '@solana/web3.js';
-import { createConnection } from './connection.js';
-// ============================================================================
-// 常量
-// ============================================================================
-/** Wrapped SOL */
-const WSOL = 'So11111111111111111111111111111111111111112';
-/** 常用 Quote Token */
-const QUOTE_TOKENS = {
-    [WSOL]: { symbol: 'SOL', decimals: 9 },
-    'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v': { symbol: 'USDC', decimals: 6 },
-    'Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB': { symbol: 'USDT', decimals: 6 },
-};
-// ============================================================================
-// 动态导入（避免循环依赖和类型冲突）
-// ============================================================================
-/** 懒加载 Pump.fun SDK */
-async function loadPumpSdk() {
-    const { getBondingCurveInfo } = await import('../dex/pump/pump.js');
-    const { getPumpSwapPoolInfo } = await import('../dex/pump/pump-swap.js');
-    return { getBondingCurveInfo, getPumpSwapPoolInfo };
-}
-/** 懒加载 Meteora SDK */
-async function loadMeteoraSdk() {
-    const { findDbcPoolByBaseMint, getDbcPoolInfo } = await import('../dex/meteora/dbc.js');
-    const { findDlmmPool, getDlmmPoolInfo } = await import('../dex/meteora/dlmm.js');
-    return { findDbcPoolByBaseMint, getDbcPoolInfo, findDlmmPool, getDlmmPoolInfo };
-}
-/** 懒加载 Orca SDK */
-async function loadOrcaSdk() {
-    try {
-        const { getWavebreakBondingCurveInfo } = await import('../dex/orca/wavebreak.js');
-        const { findOrcaPool, getOrcaPoolInfo } = await import('../dex/orca/orca.js');
-        return { getWavebreakBondingCurveInfo, findOrcaPool, getOrcaPoolInfo };
-    }
-    catch {
-        return null;
-    }
-}
-/** 懒加载 Raydium SDK */
-async function loadRaydiumSdk() {
-    try {
-        const { initRaydium, getRaydiumPoolInfo } = await import('../dex/raydium/raydium.js');
-        return { initRaydium, getRaydiumPoolInfo };
-    }
-    catch {
-        return null;
-    }
-}
-// ============================================================================
-// 内盘检测
-// ============================================================================
-/**
- * 检测 Pump.fun Bonding Curve
- */
-async function detectPumpBondingCurve(mint, connection, debug) {
-    try {
-        const { getBondingCurveInfo } = await loadPumpSdk();
-        const info = await getBondingCurveInfo(connection, mint);
-        if (!info)
-            return null;
-        // 计算价格 (virtualSolReserves / virtualTokenReserves)
-        const price = Number(info.virtualSolReserves) / Number(info.virtualTokenReserves);
-        // 计算进度 (realSolReserves / 85 SOL threshold)
-        const GRADUATION_THRESHOLD = 85000000000n; // 85 SOL in lamports
-        const progress = Math.min(100, Number(info.realSolReserves * 100n / GRADUATION_THRESHOLD));
-        return {
-            type: 'pump',
-            address: info.bondingCurve,
-            complete: info.complete,
-            reserveQuote: (Number(info.virtualSolReserves) / 1e9).toFixed(4),
-            reserveQuoteRaw: info.virtualSolReserves,
-            reserveToken: (Number(info.virtualTokenReserves) / 1e6).toFixed(0),
-            reserveTokenRaw: info.virtualTokenReserves,
-            price,
-            progress,
-            creator: info.creator,
-        };
-    }
-    catch (err) {
-        if (debug)
-            console.log('[LP Inspect] Pump bonding curve check failed:', err);
-        return null;
-    }
-}
-/**
- * 检测 Meteora DBC
- */
-async function detectMeteoraDbc(mint, connection, debug) {
-    try {
-        const { findDbcPoolByBaseMint, getDbcPoolInfo } = await loadMeteoraSdk();
-        const poolAddress = await findDbcPoolByBaseMint(mint, connection);
-        if (!poolAddress)
-            return null;
-        const poolInfo = await getDbcPoolInfo(poolAddress, connection);
-        return {
-            type: 'meteora_dbc',
-            address: poolAddress,
-            complete: poolInfo.isMigrated,
-            reserveQuote: poolInfo.quoteReserve,
-            reserveQuoteRaw: BigInt(poolInfo.quoteReserve),
-            reserveToken: poolInfo.baseReserve,
-            reserveTokenRaw: BigInt(poolInfo.baseReserve),
-            price: poolInfo.currentPrice,
-            progress: poolInfo.progressPercent,
-            creator: poolInfo.creator,
-        };
-    }
-    catch (err) {
-        if (debug)
-            console.log('[LP Inspect] Meteora DBC check failed:', err);
-        return null;
-    }
-}
-/**
- * 检测 Orca Wavebreak
- */
-async function detectOrcaWavebreak(mint, connection, debug) {
-    try {
-        const sdk = await loadOrcaSdk();
-        if (!sdk)
-            return null;
-        const { getWavebreakBondingCurveInfo } = sdk;
-        const info = await getWavebreakBondingCurveInfo(mint, connection);
-        if (!info)
-            return null;
-        return {
-            type: 'orca_wavebreak',
-            address: info.bondingCurveAddress,
-            complete: info.isGraduated,
-            reserveQuote: (Number(info.quoteAmount) / 1e9).toFixed(4),
-            reserveQuoteRaw: info.quoteAmount,
-            reserveToken: info.baseAmount.toString(),
-            reserveTokenRaw: info.baseAmount,
-            price: info.currentPrice,
-            progress: info.progressPercent,
-            creator: info.creator,
-        };
-    }
-    catch (err) {
-        if (debug)
-            console.log('[LP Inspect] Orca Wavebreak check failed:', err);
-        return null;
-    }
-}
-/**
- * 检测 Raydium LaunchLab
- * 注意：LaunchLab API 可能需要特定的端点，这里做基础检测
- */
-async function detectRaydiumLaunchLab(_mint, _connection, _debug) {
-    // Raydium LaunchLab 检测暂未实现
-    // 需要 Raydium 提供专门的 LaunchLab API
-    return null;
-}
-// ============================================================================
-// 外盘检测
-// ============================================================================
-/**
- * 检测 Pump.fun Swap Pool
- */
-async function detectPumpSwapPool(mint, connection, debug) {
-    try {
-        const { getPumpSwapPoolInfo } = await loadPumpSdk();
-        const info = await getPumpSwapPoolInfo(connection, mint);
-        if (!info)
-            return null;
-        // 获取池子余额
-        const poolPubkey = new PublicKey(info.poolAddress);
-        const balance = await connection.getBalance(poolPubkey);
-        return {
-            platform: 'PUMP_SWAP',
-            poolAddress: info.poolAddress,
-            quoteToken: info.quoteMint,
-            quoteSymbol: 'SOL',
-            quoteDecimals: 9,
-            baseToken: info.baseMint,
-            reserveQuote: (balance / 1e9).toFixed(4),
-            reserveQuoteRaw: BigInt(balance),
-            reserveBase: info.lpSupply.toString(),
-            reserveBaseRaw: info.lpSupply,
-            extra: {
-                lpMint: info.lpMint,
-                creator: info.creator,
-            },
-        };
-    }
-    catch (err) {
-        if (debug)
-            console.log('[LP Inspect] Pump Swap pool check failed:', err);
-        return null;
-    }
-}
-/**
- * 检测 Meteora DLMM Pool
- */
-async function detectMeteoraDlmm(mint, connection, debug) {
-    try {
-        const { findDlmmPool, getDlmmPoolInfo } = await loadMeteoraSdk();
-        // 尝试与 SOL 配对
-        const poolAddress = await findDlmmPool(mint, WSOL, connection);
-        if (!poolAddress)
-            return null;
-        const poolInfo = await getDlmmPoolInfo(poolAddress, connection);
-        // 判断哪个是 base token
-        const isTokenX = poolInfo.tokenXMint === mint;
-        const reserveQuote = isTokenX ? poolInfo.tokenYReserve : poolInfo.tokenXReserve;
-        const reserveBase = isTokenX ? poolInfo.tokenXReserve : poolInfo.tokenYReserve;
-        return {
-            platform: 'METEORA_DLMM',
-            poolAddress,
-            quoteToken: isTokenX ? poolInfo.tokenYMint : poolInfo.tokenXMint,
-            quoteSymbol: 'SOL',
-            quoteDecimals: 9,
-            baseToken: mint,
-            reserveQuote: reserveQuote || '0',
-            reserveQuoteRaw: BigInt(reserveQuote || 0),
-            reserveBase: reserveBase || '0',
-            reserveBaseRaw: BigInt(reserveBase || 0),
-            price: poolInfo.currentPrice,
-            feeBps: poolInfo.feeBps,
-            extra: {
-                binStep: poolInfo.binStep,
-                activeId: poolInfo.activeId,
-            },
-        };
-    }
-    catch (err) {
-        if (debug)
-            console.log('[LP Inspect] Meteora DLMM check failed:', err);
-        return null;
-    }
-}
-/**
- * 检测 Orca Whirlpool
- */
-async function detectOrcaWhirlpool(mint, connection, debug) {
-    try {
-        const sdk = await loadOrcaSdk();
-        if (!sdk)
-            return null;
-        const { findOrcaPool, getOrcaPoolInfo } = sdk;
-        // 尝试与 SOL 配对（常见的 tick spacing: 64, 128）
-        let poolAddress = await findOrcaPool(mint, WSOL, 64, connection);
-        if (!poolAddress) {
-            poolAddress = await findOrcaPool(mint, WSOL, 128, connection);
-        }
-        if (!poolAddress)
-            return null;
-        const poolInfo = await getOrcaPoolInfo(poolAddress, connection);
-        // 判断哪个是 base token
-        const isTokenA = poolInfo.tokenMintA === mint;
-        return {
-            platform: 'ORCA_WHIRLPOOL',
-            poolAddress,
-            quoteToken: isTokenA ? poolInfo.tokenMintB : poolInfo.tokenMintA,
-            quoteSymbol: 'SOL',
-            quoteDecimals: isTokenA ? poolInfo.tokenDecimalsB : poolInfo.tokenDecimalsA,
-            baseToken: mint,
-            reserveQuote: '0', // Whirlpool 需要通过 vault 查询
-            reserveQuoteRaw: 0n,
-            reserveBase: '0',
-            reserveBaseRaw: 0n,
-            price: poolInfo.price,
-            feeBps: poolInfo.feeRate,
-            extra: {
-                tickSpacing: poolInfo.tickSpacing,
-                currentTick: poolInfo.currentTick,
-                liquidity: poolInfo.liquidity,
-            },
-        };
-    }
-    catch (err) {
-        if (debug)
-            console.log('[LP Inspect] Orca Whirlpool check failed:', err);
-        return null;
-    }
-}
-/**
- * 检测 Raydium 池子
- * 直接使用 Raydium 公开 API，更可靠
- */
-async function detectRaydiumPools(mint, connection, debug) {
-    const pools = [];
-    try {
-        // 直接调用 Raydium 公开 API
-        const apiUrl = `https://api-v3.raydium.io/pools/info/mint?mint1=${mint}&poolType=all&poolSortField=default&sortType=desc&pageSize=20&page=1`;
-        const response = await fetch(apiUrl);
-        if (!response.ok) {
-            if (debug)
-                console.log('[LP Inspect] Raydium API request failed:', response.status);
-            return pools;
-        }
-        const result = await response.json();
-        if (!result.success || !result.data?.data) {
-            if (debug)
-                console.log('[LP Inspect] Raydium API returned no data');
-            return pools;
-        }
-        const poolArray = result.data.data;
-        if (!Array.isArray(poolArray))
-            return pools;
-        if (debug)
-            console.log('[LP Inspect] Raydium found', poolArray.length, 'pools');
-        for (const pool of poolArray) {
-            // 判断池子类型
-            let platform = 'RAYDIUM_AMM';
-            if (pool.programId?.includes('CPMMoo')) {
-                platform = 'RAYDIUM_CPMM';
-            }
-            else if (pool.type === 'Concentrated') {
-                platform = 'RAYDIUM_CLMM';
-            }
-            // 判断哪个是 base token
-            const isBaseA = pool.mintA?.address === mint;
-            const quoteToken = isBaseA ? pool.mintB?.address : pool.mintA?.address;
-            const quoteSymbol = isBaseA ? pool.mintB?.symbol : pool.mintA?.symbol;
-            const quoteDecimals = isBaseA ? pool.mintB?.decimals : pool.mintA?.decimals;
-            const reserveQuoteNum = isBaseA ? pool.mintAmountB : pool.mintAmountA;
-            const reserveBaseNum = isBaseA ? pool.mintAmountA : pool.mintAmountB;
-            if (!quoteToken)
-                continue;
-            pools.push({
-                platform,
-                poolAddress: pool.id,
-                quoteToken: quoteToken || '',
-                quoteSymbol: quoteSymbol || 'UNKNOWN',
-                quoteDecimals: quoteDecimals || 9,
-                baseToken: mint,
-                reserveQuote: String(reserveQuoteNum || 0),
-                reserveQuoteRaw: BigInt(Math.floor((reserveQuoteNum || 0) * Math.pow(10, quoteDecimals || 9))),
-                reserveBase: String(reserveBaseNum || 0),
-                reserveBaseRaw: BigInt(Math.floor((reserveBaseNum || 0) * Math.pow(10, pool.mintB?.decimals || 6))),
-                price: pool.price,
-                feeBps: Math.floor((pool.feeRate || 0) * 10000),
-                extra: {
-                    type: pool.type,
-                    tvl: pool.tvl,
-                    lpMint: pool.lpMint?.address,
-                },
-            });
-        }
-    }
-    catch (err) {
-        if (debug)
-            console.log('[LP Inspect] Raydium pools check failed:', err);
-    }
-    return pools;
-}
-// ============================================================================
-// 主函数
-// ============================================================================
-/**
- * 检测 Solana 代币的 LP 所在平台
- *
- * @param mint 代币 Mint 地址
- * @param options 检测选项
- * @returns LP 信息
- *
- * @example
- * ```typescript
- * const lpInfo = await inspectSolanaTokenLP('TokenMintAddress...', {
- *   rpcUrl: 'https://api.mainnet-beta.solana.com',
- *   debug: true,
- * })
- *
- * if (lpInfo.platform === 'PUMP_BONDING_CURVE') {
- *   console.log('代币在 Pump.fun 内盘')
- *   console.log('毕业进度:', lpInfo.bondingCurve?.progress)
- * } else if (lpInfo.bestPool) {
- *   console.log('最佳池子:', lpInfo.bestPool.platform)
- *   console.log('流动性:', lpInfo.bestPool.reserveQuote)
- * }
- * ```
- */
-export async function inspectSolanaTokenLP(mint, options = {}) {
-    const startTime = Date.now();
-    if (!options.connection && !options.rpcUrl) {
-        throw new Error('Either connection or rpcUrl is required in options');
-    }
-    const connection = options.connection || createConnection(options.rpcUrl);
-    const debug = options.debug;
-    // 初始化结果
-    const result = {
-        mint,
-        platform: 'UNKNOWN',
-        pools: [],
-    };
-    // 获取代币信息
-    try {
-        const mintPubkey = new PublicKey(mint);
-        const mintInfo = await connection.getParsedAccountInfo(mintPubkey);
-        if (mintInfo.value?.data && 'parsed' in mintInfo.value.data) {
-            const parsed = mintInfo.value.data.parsed;
-            const decimals = parsed.info.decimals;
-            result.decimals = decimals;
-            result.totalSupplyRaw = BigInt(parsed.info.supply);
-            result.totalSupply = (Number(result.totalSupplyRaw) / Math.pow(10, decimals)).toString();
-        }
-    }
-    catch (err) {
-        if (debug)
-            console.log('[LP Inspect] Failed to get mint info:', err);
-    }
-    // ========================================
-    // 1. 内盘检测（并行）
-    // ========================================
-    if (!options.skipBondingCurve) {
-        const bondingCurveResults = await Promise.allSettled([
-            detectPumpBondingCurve(mint, connection, debug),
-            detectMeteoraDbc(mint, connection, debug),
-            detectOrcaWavebreak(mint, connection, debug),
-            detectRaydiumLaunchLab(mint, connection, debug),
-        ]);
-        // 查找第一个有效的内盘
-        for (const r of bondingCurveResults) {
-            if (r.status === 'fulfilled' && r.value && !r.value.complete) {
-                result.bondingCurve = r.value;
-                // 设置平台类型
-                switch (r.value.type) {
-                    case 'pump':
-                        result.platform = 'PUMP_BONDING_CURVE';
-                        break;
-                    case 'meteora_dbc':
-                        result.platform = 'METEORA_DBC';
-                        break;
-                    case 'orca_wavebreak':
-                        result.platform = 'ORCA_WAVEBREAK';
-                        break;
-                    case 'raydium_launchlab':
-                        result.platform = 'RAYDIUM_LAUNCHLAB';
-                        break;
-                }
-                result.elapsed = Date.now() - startTime;
-                return result;
-            }
-        }
-    }
-    // ========================================
-    // 2. 外盘检测（并行）
-    // ========================================
-    if (!options.skipPools) {
-        const poolResults = await Promise.allSettled([
-            detectPumpSwapPool(mint, connection, debug),
-            detectMeteoraDlmm(mint, connection, debug),
-            detectOrcaWhirlpool(mint, connection, debug),
-            detectRaydiumPools(mint, connection, debug),
-        ]);
-        // 收集所有有效的池子
-        for (const r of poolResults) {
-            if (r.status === 'fulfilled' && r.value) {
-                if (Array.isArray(r.value)) {
-                    result.pools.push(...r.value);
-                }
-                else {
-                    result.pools.push(r.value);
-                }
-            }
-        }
-        // 按流动性排序
-        result.pools.sort((a, b) => {
-            const liquidityA = Number(a.reserveQuoteRaw);
-            const liquidityB = Number(b.reserveQuoteRaw);
-            return liquidityB - liquidityA;
-        });
-        // 设置最佳池子
-        if (result.pools.length > 0) {
-            result.bestPool = result.pools[0];
-            // 设置平台类型
-            if (result.pools.length > 1) {
-                result.platform = 'MULTI_POOL';
-            }
-            else {
-                result.platform = result.bestPool.platform;
-            }
-        }
-    }
-    result.elapsed = Date.now() - startTime;
-    return result;
-}
-/**
- * 快速检测代币是否在内盘
- *
- * @param mint 代币 Mint 地址
- * @param options 检测选项
- * @returns 如果在内盘返回内盘信息，否则返回 null
- */
-export async function detectBondingCurve(mint, options = {}) {
-    if (!options.connection && !options.rpcUrl) {
-        throw new Error('Either connection or rpcUrl is required in options');
-    }
-    const connection = options.connection || createConnection(options.rpcUrl);
-    const debug = options.debug;
-    // 并行检测所有内盘
-    const results = await Promise.allSettled([
-        detectPumpBondingCurve(mint, connection, debug),
-        detectMeteoraDbc(mint, connection, debug),
-        detectOrcaWavebreak(mint, connection, debug),
-        detectRaydiumLaunchLab(mint, connection, debug),
-    ]);
-    // 返回第一个未毕业的内盘
-    for (const r of results) {
-        if (r.status === 'fulfilled' && r.value && !r.value.complete) {
-            return r.value;
-        }
-    }
-    return null;
-}
-/**
- * 判断代币是否已毕业（不在任何内盘）
- */
-export async function isTokenGraduated(mint, options = {}) {
-    const bondingCurve = await detectBondingCurve(mint, options);
-    return bondingCurve === null;
-}
-/**
- * 获取代币的最佳交易池
- */
-export async function getBestPool(mint, options = {}) {
-    const lpInfo = await inspectSolanaTokenLP(mint, {
-        ...options,
-        skipBondingCurve: true,
-    });
-    return lpInfo.bestPool || null;
-}

package/dist/sol/utils/transfer.d.ts

@@ -1,125 +0,0 @@
-/**
- * Solana SOL 转账功能
- * SDK 只负责构建和签名交易，提交到后端服务器广播
- * @module sol/utils/transfer
- */
-import { Connection, Keypair, PublicKey, TransactionInstruction } from '@solana/web3.js';
-/**
- * 转账项
- */
-export interface TransferItem {
-    to: string;
-    amount: bigint;
-}
-/**
- * 签名后的转账交易
- */
-export interface SignedTransferTransaction {
-    /** Base64 编码的交易数据 */
-    data: string;
-    /** 交易签名 */
-    signature: string;
-    /** 转账详情 */
-    transfers: TransferItem[];
-    /** blockhash */
-    recentBlockhash: string;
-    /** 最后有效区块高度 */
-    lastValidBlockHeight: number;
-}
-/**
- * 批量签名结果
- */
-export interface BatchSignedTransfers {
-    /** 签名后的交易列表 */
-    transactions: SignedTransferTransaction[];
-    /** 总转账数 */
-    totalTransfers: number;
-    /** 总交易数 */
-    totalTransactions: number;
-    /** 创建时间 */
-    createdAt: number;
-}
-/**
- * 构建转账指令
- * @param from 发送者公钥
- * @param to 接收者地址
- * @param amount lamports
- */
-export declare function buildTransferInstruction(from: PublicKey, to: string, amount: bigint): TransactionInstruction;
-/**
- * 构建批量转账指令
- * @param from 发送者公钥
- * @param transfers 转账列表
- */
-export declare function buildTransferInstructions(from: PublicKey, transfers: TransferItem[]): TransactionInstruction[];
-/**
- * 构建并签名单笔 SOL 转账
- * @param connection Solana 连接
- * @param from 发送者 Keypair
- * @param to 接收者地址
- * @param amount lamports
- */
-export declare function signTransferSOL(connection: Connection, from: Keypair, to: string, amount: bigint): Promise<SignedTransferTransaction>;
-/**
- * 构建并签名单笔 SOL 转账（使用 SOL 数量）
- */
-export declare function signTransferSOLAmount(connection: Connection, from: Keypair, to: string, solAmount: number): Promise<SignedTransferTransaction>;
-/**
- * 构建并签名批量转账（单笔交易，多个指令）
- * 单笔交易最多约 20-30 个转账
- * @param connection Solana 连接
- * @param from 发送者 Keypair
- * @param transfers 转账列表
- */
-export declare function signBatchTransferSOL(connection: Connection, from: Keypair, transfers: TransferItem[]): Promise<SignedTransferTransaction>;
-/**
- * 构建并签名批量转账（多笔交易）
- * 自动分批处理大量转账
- * @param connection Solana 连接
- * @param from 发送者 Keypair
- * @param transfers 转账列表
- * @param batchSize 每批大小（默认 20）
- */
-export declare function signBatchTransferSOLMultiple(connection: Connection, from: Keypair, transfers: TransferItem[], batchSize?: number): Promise<BatchSignedTransfers>;
-/**
- * 多钱包转账项
- */
-export interface MultiWalletTransferItem {
-    from: Keypair;
-    to: string;
-    amount: bigint;
-}
-/**
- * 签名多钱包转账（每个钱包一笔交易）
- * 用于归集或分发场景
- * @param connection Solana 连接
- * @param transfers 转账列表
- */
-export declare function signMultiWalletTransfers(connection: Connection, transfers: MultiWalletTransferItem[]): Promise<BatchSignedTransfers>;
-/**
- * 归集 SOL（多个钱包转到一个地址）
- * @param connection Solana 连接
- * @param wallets 钱包列表
- * @param toAddress 目标地址
- * @param amounts 每个钱包转账金额（lamports），如果为空则转全部（保留 5000 lamports 作为手续费）
- */
-export declare function signCollectSOL(connection: Connection, wallets: Keypair[], toAddress: string, amounts?: bigint[]): Promise<BatchSignedTransfers>;
-/**
- * 分发 SOL（一个钱包转到多个地址）
- * @param connection Solana 连接
- * @param from 发送者 Keypair
- * @param distributions 分发列表
- */
-export declare function signDistributeSOL(connection: Connection, from: Keypair, distributions: TransferItem[]): Promise<BatchSignedTransfers>;
-/**
- * 将签名结果转换为后端 API 格式
- */
-export declare function toBackendFormat(result: BatchSignedTransfers): {
-    transactions: Array<{
-        data: string;
-        signature: string;
-    }>;
-    totalTransfers: number;
-    totalTransactions: number;
-    timestamp: number;
-};