four-flap-meme-sdk 1.5.55 → 1.5.56

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

@@ -0,0 +1,78 @@
+/**
+ * Solana RPC 连接管理
+ * @module sol/utils/connection
+ */
+import { Connection, Commitment } from '@solana/web3.js';
+/**
+ * 创建 Solana 连接
+ *
+ * 重要：必须传入用户选择的 RPC URL，SDK 不提供默认 RPC
+ * 前端应从 RPC 设置中获取用户配置的节点
+ *
+ * @param rpcUrl RPC URL（必填）
+ * @param commitment Commitment 级别（可选，默认 confirmed）
+ *
+ * @example
+ * const connection = createConnection('https://user-selected-rpc.com')
+ *
+ * @throws Error 如果没有传入 rpcUrl
+ */
+export declare function createConnection(rpcUrl: string, commitment?: Commitment): Connection;
+/**
+ * 获取账户 SOL 余额
+ * @param connection Solana 连接
+ * @param address 账户地址
+ * @returns 余额（lamports）
+ */
+export declare function getBalance(connection: Connection, address: string): Promise<bigint>;
+/**
+ * 获取账户 SOL 余额（格式化）
+ * @param connection Solana 连接
+ * @param address 账户地址
+ * @returns 余额（SOL）
+ */
+export declare function getBalanceInSol(connection: Connection, address: string): Promise<number>;
+/**
+ * 获取最新 blockhash
+ * @param connection Solana 连接
+ */
+export declare function getLatestBlockhash(connection: Connection): Promise<{
+    blockhash: string;
+    lastValidBlockHeight: number;
+}>;
+/**
+ * 获取当前 slot
+ * @param connection Solana 连接
+ */
+export declare function getCurrentSlot(connection: Connection): Promise<number>;
+/**
+ * 检查账户是否存在
+ * @param connection Solana 连接
+ * @param address 账户地址
+ */
+export declare function accountExists(connection: Connection, address: string): Promise<boolean>;
+/**
+ * 获取账户信息
+ * @param connection Solana 连接
+ * @param address 账户地址
+ */
+export declare function getAccountInfo(connection: Connection, address: string): Promise<import("@solana/web3.js").AccountInfo<Buffer<ArrayBufferLike>> | null>;
+/**
+ * 获取最小租金豁免余额
+ * @param connection Solana 连接
+ * @param dataSize 账户数据大小
+ */
+export declare function getMinimumBalanceForRentExemption(connection: Connection, dataSize: number): Promise<bigint>;
+/**
+ * 等待交易确认
+ * @param connection Solana 连接
+ * @param signature 交易签名
+ * @param timeout 超时时间（毫秒）
+ */
+export declare function waitForConfirmation(connection: Connection, signature: string, timeout?: number): Promise<boolean>;
+/**
+ * 获取交易状态
+ * @param connection Solana 连接
+ * @param signature 交易签名
+ */
+export declare function getTransactionStatus(connection: Connection, signature: string): Promise<'pending' | 'confirmed' | 'failed'>;

package/dist/sol/utils/connection.js

@@ -0,0 +1,168 @@
+/**
+ * Solana RPC 连接管理
+ * @module sol/utils/connection
+ */
+import { Connection, PublicKey } from '@solana/web3.js';
+import { TX_CONFIG, lamportsToSol } from '../constants.js';
+/**
+ * 创建 Solana 连接
+ *
+ * 重要：必须传入用户选择的 RPC URL，SDK 不提供默认 RPC
+ * 前端应从 RPC 设置中获取用户配置的节点
+ *
+ * @param rpcUrl RPC URL（必填）
+ * @param commitment Commitment 级别（可选，默认 confirmed）
+ *
+ * @example
+ * const connection = createConnection('https://user-selected-rpc.com')
+ *
+ * @throws Error 如果没有传入 rpcUrl
+ */
+export function createConnection(rpcUrl, commitment = TX_CONFIG.DEFAULT_COMMITMENT) {
+    if (!rpcUrl) {
+        throw new Error('RPC URL is required. Please pass the user-configured RPC URL from frontend settings.');
+    }
+    return new Connection(rpcUrl, {
+        commitment,
+        confirmTransactionInitialTimeout: TX_CONFIG.CONFIRMATION_TIMEOUT,
+    });
+}
+/**
+ * 获取账户 SOL 余额
+ * @param connection Solana 连接
+ * @param address 账户地址
+ * @returns 余额（lamports）
+ */
+export async function getBalance(connection, address) {
+    try {
+        const publicKey = new PublicKey(address);
+        const balance = await connection.getBalance(publicKey);
+        return BigInt(balance);
+    }
+    catch (error) {
+        throw new Error(`Failed to get balance: ${error.message}`);
+    }
+}
+/**
+ * 获取账户 SOL 余额（格式化）
+ * @param connection Solana 连接
+ * @param address 账户地址
+ * @returns 余额（SOL）
+ */
+export async function getBalanceInSol(connection, address) {
+    const lamports = await getBalance(connection, address);
+    return lamportsToSol(lamports);
+}
+/**
+ * 获取最新 blockhash
+ * @param connection Solana 连接
+ */
+export async function getLatestBlockhash(connection) {
+    try {
+        const result = await connection.getLatestBlockhash('finalized');
+        return {
+            blockhash: result.blockhash,
+            lastValidBlockHeight: result.lastValidBlockHeight,
+        };
+    }
+    catch (error) {
+        throw new Error(`Failed to get blockhash: ${error.message}`);
+    }
+}
+/**
+ * 获取当前 slot
+ * @param connection Solana 连接
+ */
+export async function getCurrentSlot(connection) {
+    try {
+        return await connection.getSlot();
+    }
+    catch (error) {
+        throw new Error(`Failed to get slot: ${error.message}`);
+    }
+}
+/**
+ * 检查账户是否存在
+ * @param connection Solana 连接
+ * @param address 账户地址
+ */
+export async function accountExists(connection, address) {
+    try {
+        const publicKey = new PublicKey(address);
+        const accountInfo = await connection.getAccountInfo(publicKey);
+        return accountInfo !== null;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 获取账户信息
+ * @param connection Solana 连接
+ * @param address 账户地址
+ */
+export async function getAccountInfo(connection, address) {
+    try {
+        const publicKey = new PublicKey(address);
+        return await connection.getAccountInfo(publicKey);
+    }
+    catch (error) {
+        throw new Error(`Failed to get account info: ${error.message}`);
+    }
+}
+/**
+ * 获取最小租金豁免余额
+ * @param connection Solana 连接
+ * @param dataSize 账户数据大小
+ */
+export async function getMinimumBalanceForRentExemption(connection, dataSize) {
+    try {
+        const lamports = await connection.getMinimumBalanceForRentExemption(dataSize);
+        return BigInt(lamports);
+    }
+    catch (error) {
+        throw new Error(`Failed to get rent exemption: ${error.message}`);
+    }
+}
+/**
+ * 等待交易确认
+ * @param connection Solana 连接
+ * @param signature 交易签名
+ * @param timeout 超时时间（毫秒）
+ */
+export async function waitForConfirmation(connection, signature, timeout = TX_CONFIG.CONFIRMATION_TIMEOUT) {
+    try {
+        const result = await connection.confirmTransaction({
+            signature,
+            blockhash: (await getLatestBlockhash(connection)).blockhash,
+            lastValidBlockHeight: (await getLatestBlockhash(connection)).lastValidBlockHeight,
+        }, 'confirmed');
+        return !result.value.err;
+    }
+    catch (error) {
+        console.error(`Transaction confirmation failed: ${error.message}`);
+        return false;
+    }
+}
+/**
+ * 获取交易状态
+ * @param connection Solana 连接
+ * @param signature 交易签名
+ */
+export async function getTransactionStatus(connection, signature) {
+    try {
+        const status = await connection.getSignatureStatus(signature);
+        if (!status.value)
+            return 'pending';
+        if (status.value.err)
+            return 'failed';
+        if (status.value.confirmationStatus === 'confirmed' ||
+            status.value.confirmationStatus === 'finalized') {
+            return 'confirmed';
+        }
+        return 'pending';
+    }
+    catch {
+        return 'pending';
+    }
+}

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

@@ -0,0 +1,9 @@
+/**
+ * Solana 工具函数导出
+ * @module sol/utils
+ */
+export * from './connection.js';
+export * from './wallet.js';
+export * from './transfer.js';
+export * from './balance.js';
+export * from './lp-inspect.js';

package/dist/sol/utils/index.js

@@ -0,0 +1,9 @@
+/**
+ * Solana 工具函数导出
+ * @module sol/utils
+ */
+export * from './connection.js';
+export * from './wallet.js';
+export * from './transfer.js';
+export * from './balance.js';
+export * from './lp-inspect.js';

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

@@ -0,0 +1,75 @@
+/**
+ * Solana LP 检测工具
+ * 自动判断代币在哪个平台（内盘/外盘）
+ * @module sol/utils/lp-inspect
+ */
+import { Connection } from '@solana/web3.js';
+/** Solana LP 平台类型 */
+export type SolanaLPPlatform = 'PUMP_BONDING_CURVE' | 'METEORA_DBC' | 'RAYDIUM_LAUNCHLAB' | 'JUPITER_AGGREGATED' | 'PUMP_SWAP' | 'MULTI_POOL' | 'UNKNOWN';
+/** 内盘（Bonding Curve）信息 */
+export interface SolanaBondingCurveInfo {
+    type: 'pump' | 'meteora_dbc' | 'raydium_launchlab';
+    address: string;
+    complete: boolean;
+    reserveQuote: string;
+    reserveQuoteRaw: bigint;
+    reserveToken: string;
+    reserveTokenRaw: bigint;
+    price?: number;
+    progress?: number;
+    creator?: string;
+}
+/** 外盘池子信息 (整合 Jupiter 数据) */
+export interface SolanaPoolInfo {
+    platform: SolanaLPPlatform;
+    poolAddress: string;
+    quoteToken: string;
+    quoteSymbol: string;
+    quoteDecimals: number;
+    baseToken: string;
+    reserveQuote: string;
+    reserveQuoteRaw: bigint;
+    price?: number;
+    mcap?: number;
+    liquidity?: number;
+    fdv?: number;
+    isVerified?: boolean;
+    extra?: Record<string, any>;
+}
+/** Solana LP 检测结果 */
+export interface SolanaLPInfo {
+    mint: string;
+    platform: SolanaLPPlatform;
+    decimals?: number;
+    totalSupply?: string;
+    totalSupplyRaw?: bigint;
+    bondingCurve?: SolanaBondingCurveInfo;
+    bestPool?: SolanaPoolInfo;
+    pools: SolanaPoolInfo[];
+    elapsed?: number;
+}
+/** 检测选项 */
+export interface SolanaInspectOptions {
+    rpcUrl?: string;
+    connection?: Connection;
+    skipBondingCurve?: boolean;
+    skipPools?: boolean;
+    debug?: boolean;
+    timeout?: number;
+}
+/**
+ * 检测 Solana 代币的 LP 信息
+ */
+export declare function inspectSolanaTokenLP(mint: string, options?: SolanaInspectOptions): Promise<SolanaLPInfo>;
+/**
+ * 快速检测代币是否在内盘
+ */
+export declare function detectBondingCurve(mint: string, options?: SolanaInspectOptions): Promise<SolanaBondingCurveInfo | null>;
+/**
+ * 获取代币流动性 (USD)
+ */
+export declare function getTokenLiquidity(mint: string, options?: SolanaInspectOptions): Promise<number>;
+/**
+ * 判断代币是否已毕业
+ */
+export declare function isTokenGraduated(mint: string, options?: SolanaInspectOptions): Promise<boolean>;

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

@@ -0,0 +1,235 @@
+/**
+ * Solana LP 检测工具
+ * 自动判断代币在哪个平台（内盘/外盘）
+ * @module sol/utils/lp-inspect
+ */
+import { PublicKey } from '@solana/web3.js';
+import { createConnection } from './connection.js';
+import { getTokenInfoV2 } from '../dex/jup/tokens.js';
+// ============================================================================
+// 常量
+// ============================================================================
+const WSOL = 'So11111111111111111111111111111111111111112';
+// ============================================================================
+// 内盘检测
+// ============================================================================
+/**
+ * 检测 Pump.fun Bonding Curve
+ */
+async function detectPumpBondingCurve(mint, connection, debug) {
+    try {
+        const { getBondingCurveInfo } = await import('../dex/pump/pump.js');
+        const info = await getBondingCurveInfo(connection, mint);
+        if (!info)
+            return null;
+        const price = Number(info.virtualSolReserves) / Number(info.virtualTokenReserves);
+        const GRADUATION_THRESHOLD = 85000000000n;
+        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 import('../dex/meteora/dbc.js');
+        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;
+    }
+}
+/**
+ * 检测 Raydium LaunchLab
+ */
+async function detectRaydiumLaunchLab(mint, connection, debug) {
+    try {
+        const { LaunchpadPool, LaunchpadConfig, getPdaLaunchpadPoolId, LAUNCHPAD_PROGRAM, Curve, } = await import('@raydium-io/raydium-sdk-v2');
+        const { NATIVE_MINT } = await import('@solana/spl-token');
+        const poolId = getPdaLaunchpadPoolId(LAUNCHPAD_PROGRAM, new PublicKey(mint), NATIVE_MINT).publicKey;
+        const poolAccountInfo = await connection.getAccountInfo(poolId);
+        if (!poolAccountInfo)
+            return null;
+        const poolInfo = LaunchpadPool.decode(poolAccountInfo.data);
+        const configAccountInfo = await connection.getAccountInfo(poolInfo.configId);
+        if (!configAccountInfo)
+            return null;
+        const configInfo = LaunchpadConfig.decode(configAccountInfo.data);
+        const currentPrice = Curve.getPrice({
+            poolInfo,
+            curveType: configInfo.curveType,
+            decimalA: poolInfo.mintDecimalsA,
+            decimalB: poolInfo.mintDecimalsB,
+        }).toNumber();
+        const isMigrated = poolInfo.status !== undefined && poolInfo.status >= 2;
+        return {
+            type: 'raydium_launchlab',
+            address: poolId.toBase58(),
+            complete: isMigrated,
+            reserveQuote: (Number(poolInfo.totalFundRaisingB || 0) / 1e9).toFixed(4),
+            reserveQuoteRaw: BigInt(poolInfo.totalFundRaisingB?.toString() || '0'),
+            reserveToken: "0", // Simplified
+            reserveTokenRaw: 0n,
+            price: currentPrice,
+            creator: poolInfo.creator?.toBase58(),
+        };
+    }
+    catch (err) {
+        if (debug)
+            console.log('[LP Inspect] Raydium LaunchLab check failed:', err);
+        return null;
+    }
+}
+// ============================================================================
+// 外盘检测 (Jupiter API)
+// ============================================================================
+/**
+ * 使用 Jupiter API 检测外盘信息
+ */
+async function detectWithJupiter(mint, debug) {
+    try {
+        const info = await getTokenInfoV2(mint);
+        if (!info || !info.liquidity || info.liquidity < 100) {
+            return null;
+        }
+        return {
+            platform: 'JUPITER_AGGREGATED',
+            poolAddress: info.graduatedPool || '',
+            quoteToken: WSOL,
+            quoteSymbol: 'SOL',
+            quoteDecimals: 9,
+            baseToken: mint,
+            reserveQuote: info.liquidity.toFixed(2),
+            reserveQuoteRaw: BigInt(Math.floor(info.liquidity)),
+            price: info.usdPrice ?? undefined,
+            mcap: info.mcap ?? undefined,
+            liquidity: info.liquidity,
+            fdv: info.fdv ?? undefined,
+            isVerified: info.isVerified ?? false,
+            extra: {
+                launchpad: info.launchpad,
+                organicScore: info.organicScore,
+                stats24h: info.stats24h,
+            }
+        };
+    }
+    catch (err) {
+        if (debug)
+            console.log('[LP Inspect] Jupiter check failed:', err);
+        return null;
+    }
+}
+// ============================================================================
+// 主函数
+// ============================================================================
+/**
+ * 检测 Solana 代币的 LP 信息
+ */
+export async function inspectSolanaTokenLP(mint, options = {}) {
+    const startTime = Date.now();
+    const connection = options.connection || createConnection(options.rpcUrl);
+    const debug = options.debug;
+    const result = {
+        mint,
+        platform: 'UNKNOWN',
+        pools: [],
+    };
+    // 0. 获取代币基本信息
+    try {
+        const mintInfo = await connection.getParsedAccountInfo(new PublicKey(mint));
+        if (mintInfo.value?.data && 'parsed' in mintInfo.value.data) {
+            const parsed = mintInfo.value.data.parsed;
+            result.decimals = parsed.info.decimals;
+            result.totalSupplyRaw = BigInt(parsed.info.supply);
+            result.totalSupply = (Number(result.totalSupplyRaw) / Math.pow(10, result.decimals)).toString();
+        }
+    }
+    catch { }
+    // 1. 内盘检测
+    if (!options.skipBondingCurve) {
+        const [pump, meteora, raydium] = await Promise.all([
+            detectPumpBondingCurve(mint, connection, debug),
+            detectMeteoraDbc(mint, connection, debug),
+            detectRaydiumLaunchLab(mint, connection, debug),
+        ]);
+        const bc = pump || meteora || raydium;
+        if (bc && !bc.complete) {
+            result.bondingCurve = bc;
+            result.platform = bc.type === 'pump' ? 'PUMP_BONDING_CURVE' :
+                bc.type === 'meteora_dbc' ? 'METEORA_DBC' : 'RAYDIUM_LAUNCHLAB';
+            result.elapsed = Date.now() - startTime;
+            return result;
+        }
+    }
+    // 2. 外盘检测 (Jupiter)
+    if (!options.skipPools) {
+        const jupPool = await detectWithJupiter(mint, debug);
+        if (jupPool) {
+            result.bestPool = jupPool;
+            result.pools = [jupPool];
+            result.platform = jupPool.platform;
+        }
+    }
+    result.elapsed = Date.now() - startTime;
+    return result;
+}
+/**
+ * 快速检测代币是否在内盘
+ */
+export async function detectBondingCurve(mint, options = {}) {
+    const connection = options.connection || createConnection(options.rpcUrl);
+    const results = await Promise.all([
+        detectPumpBondingCurve(mint, connection, options.debug),
+        detectMeteoraDbc(mint, connection, options.debug),
+        detectRaydiumLaunchLab(mint, connection, options.debug),
+    ]);
+    return results.find(r => r && !r.complete) || null;
+}
+/**
+ * 获取代币流动性 (USD)
+ */
+export async function getTokenLiquidity(mint, options = {}) {
+    const info = await inspectSolanaTokenLP(mint, options);
+    return info.bestPool?.liquidity || 0;
+}
+/**
+ * 判断代币是否已毕业
+ */
+export async function isTokenGraduated(mint, options = {}) {
+    const bc = await detectBondingCurve(mint, options);
+    return bc === null;
+}