four-flap-meme-sdk 1.3.89 → 1.3.90

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

@@ -0,0 +1,521 @@
+/**
+ * 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 池子
+ */
+async function detectRaydiumPools(mint, connection, debug) {
+    const pools = [];
+    try {
+        const sdk = await loadRaydiumSdk();
+        if (!sdk)
+            return pools;
+        const { initRaydium } = sdk;
+        const raydium = await initRaydium(connection);
+        // 通过 API 查找所有包含该代币的池子
+        const poolList = await raydium.api.fetchPoolByMints({
+            mint1: mint,
+            mint2: WSOL,
+        });
+        // poolList 可能是对象而不是数组，需要处理
+        const poolArray = poolList?.data || [];
+        if (!Array.isArray(poolArray))
+            return 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';
+            }
+            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) * 1e9)),
+                reserveBase: String(reserveBaseNum || 0),
+                reserveBaseRaw: BigInt(Math.floor((reserveBaseNum || 0) * 1e9)),
+                price: pool.price,
+                feeBps: Math.floor((pool.feeRate || 0) * 10000),
+                extra: {
+                    type: pool.type,
+                    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

@@ -0,0 +1,125 @@
+/**
+ * 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;
+};