four-flap-meme-sdk 1.4.20 → 1.4.21

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

@@ -1,78 +0,0 @@
-/**
- * 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

@@ -1,168 +0,0 @@
-/**
- * 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

@@ -1,9 +0,0 @@
-/**
- * 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

@@ -1,9 +0,0 @@
-/**
- * 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

@@ -1,129 +0,0 @@
-/**
- * Solana LP 检测工具
- * 自动判断代币在哪个平台（内盘/外盘）
- * @module sol/utils/lp-inspect
- */
-import { Connection } from '@solana/web3.js';
-/** Solana LP 平台类型 */
-export type SolanaLPPlatform = 'PUMP_BONDING_CURVE' | 'METEORA_DBC' | 'ORCA_WAVEBREAK' | 'RAYDIUM_LAUNCHLAB' | 'PUMP_SWAP' | 'METEORA_DLMM' | 'METEORA_DAMM_V1' | 'METEORA_DAMM_V2' | 'ORCA_WHIRLPOOL' | 'RAYDIUM_AMM' | 'RAYDIUM_CPMM' | 'RAYDIUM_CLMM' | 'MULTI_POOL' | 'UNKNOWN';
-/** 内盘（Bonding Curve）信息 */
-export interface SolanaBondingCurveInfo {
-    /** 平台类型 */
-    type: 'pump' | 'meteora_dbc' | 'orca_wavebreak' | 'raydium_launchlab';
-    /** Bonding Curve 地址 */
-    address: string;
-    /** 是否已毕业/迁移 */
-    complete: boolean;
-    /** Quote Token 储备（SOL 或其他） */
-    reserveQuote: string;
-    reserveQuoteRaw: bigint;
-    /** Base Token 储备 */
-    reserveToken: string;
-    reserveTokenRaw: bigint;
-    /** 当前价格 */
-    price?: number;
-    /** 毕业进度百分比 */
-    progress?: number;
-    /** 创建者 */
-    creator?: string;
-}
-/** 外盘池子信息 */
-export interface SolanaPoolInfo {
-    /** 平台类型 */
-    platform: SolanaLPPlatform;
-    /** 池子地址 */
-    poolAddress: string;
-    /** Quote Token（SOL/USDC 等）*/
-    quoteToken: string;
-    quoteSymbol: string;
-    quoteDecimals: number;
-    /** Base Token */
-    baseToken: string;
-    /** Quote 储备 */
-    reserveQuote: string;
-    reserveQuoteRaw: bigint;
-    /** Base 储备 */
-    reserveBase: string;
-    reserveBaseRaw: bigint;
-    /** 当前价格 */
-    price?: number;
-    /** 费率 (bps) */
-    feeBps?: number;
-    /** 额外信息（如 tick spacing、bin step 等）*/
-    extra?: Record<string, any>;
-}
-/** Solana LP 检测结果 */
-export interface SolanaLPInfo {
-    /** 代币 Mint 地址 */
-    mint: string;
-    /** 主平台类型 */
-    platform: SolanaLPPlatform;
-    /** 代币精度 */
-    decimals?: number;
-    /** 代币总供应量 */
-    totalSupply?: string;
-    totalSupplyRaw?: bigint;
-    /** 内盘信息（如果在内盘） */
-    bondingCurve?: SolanaBondingCurveInfo;
-    /** 所有发现的外盘池子 */
-    pools: SolanaPoolInfo[];
-    /** 最佳池子推荐（按流动性排序） */
-    bestPool?: SolanaPoolInfo;
-    /** 检测耗时 (ms) */
-    elapsed?: number;
-}
-/** 检测选项 */
-export interface SolanaInspectOptions {
-    /** 自定义 RPC URL */
-    rpcUrl?: string;
-    /** 自定义连接 */
-    connection?: Connection;
-    /** 是否跳过内盘检测 */
-    skipBondingCurve?: boolean;
-    /** 是否跳过外盘检测 */
-    skipPools?: boolean;
-    /** 调试模式 */
-    debug?: boolean;
-    /** 超时时间 (ms) */
-    timeout?: number;
-}
-/**
- * 检测 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 declare function inspectSolanaTokenLP(mint: string, options?: SolanaInspectOptions): Promise<SolanaLPInfo>;
-/**
- * 快速检测代币是否在内盘
- *
- * @param mint 代币 Mint 地址
- * @param options 检测选项
- * @returns 如果在内盘返回内盘信息，否则返回 null
- */
-export declare function detectBondingCurve(mint: string, options?: SolanaInspectOptions): Promise<SolanaBondingCurveInfo | null>;
-/**
- * 判断代币是否已毕业（不在任何内盘）
- */
-export declare function isTokenGraduated(mint: string, options?: SolanaInspectOptions): Promise<boolean>;
-/**
- * 获取代币的最佳交易池
- */
-export declare function getBestPool(mint: string, options?: SolanaInspectOptions): Promise<SolanaPoolInfo | null>;