four-flap-meme-sdk 1.4.59 → 1.4.62

package/dist/sol/constants.js

@@ -0,0 +1,145 @@
+/**
+ * Solana SDK 常量配置
+ * @module sol/constants
+ */
+// ==================== Jito Bundle 配置 ====================
+/**
+ * Jito 配置
+ *
+ * 注意：BLOCK_ENGINE_URL 需要由前端传入，不在 SDK 中写死
+ */
+export const JITO_CONFIG = {
+    /** Tip 账户列表（随机选择一个）- 这些是 Jito 官方账户，固定不变 */
+    TIP_ACCOUNTS: [
+        '96gYZGLnJYVFmbjzopPSU6QiEV5fGqZNyN9nmNhvrZU5',
+        'HFqU5x63VTqvQss8hp11i4bVmkzdNaVB6PYjYgNd4W5U',
+        'Cw8CFyM9FkoMi7K7Crf6HNQqf4uEMzpKw6QNghXLvLkY',
+        'ADaUMid9yfUytqMBgopwjb2DTLSokTSzL1zt6iGPaS49',
+        'DfXygSm4jCyNCybVYYK6DwvWqjKee8pbDmJGcLWNDXjh',
+        'ADuUkR4vqLUMWXxW9gh6D6L8pMSawimctcNZ5pGwDcEt',
+        'DttWaMuVvTiduZRnguLF7jNxTgiMBZ1hyAumKUiL2KRL',
+        '3AVi9Tg9Uo68tJfuvoKvqKNWKkC5wPdSSdeBnizKZ6jT',
+    ],
+    /** 最小 Tip（lamports） */
+    MIN_TIP_LAMPORTS: 1000,
+    /** 默认 Tip（lamports）- 0.00001 SOL */
+    DEFAULT_TIP_LAMPORTS: 10000,
+};
+// ==================== 程序地址 ====================
+/**
+ * Solana 系统程序地址
+ */
+export const SYSTEM_PROGRAMS = {
+    /** Token Program */
+    TOKEN_PROGRAM: 'TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA',
+    /** Token-2022 Program */
+    TOKEN_2022_PROGRAM: 'TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb',
+    /** Associated Token Account Program */
+    ATA_PROGRAM: 'ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL',
+    /** Metaplex Token Metadata Program */
+    METADATA_PROGRAM: 'metaqbxxUerdq28cj1RbAWkYQm3ybzjb6a8bt518x1s',
+    /** System Program */
+    SYSTEM_PROGRAM: '11111111111111111111111111111111',
+    /** Rent Sysvar */
+    RENT_SYSVAR: 'SysvarRent111111111111111111111111111111111',
+};
+/**
+ * Pump.fun 程序地址
+ */
+export const PUMP_PROGRAMS = {
+    /** Pump Program ID */
+    PUMP_PROGRAM: '6EF8rrecthR5Dkzon8Nwu78hRvfCKubJ14M5uBEwF6P',
+    /** Pump Swap Program ID */
+    PUMP_SWAP_PROGRAM: 'pAMMBay6oceH9fJKBRHGP5D4bD4sWpmSwMn52FMfXEA',
+    /** Global Config */
+    GLOBAL_CONFIG: '4wTV1YmiEkRvAtNtsSGPtUrqRYQMe5SKy2uB4Jjaxnjf',
+};
+/**
+ * Raydium 程序地址
+ */
+export const RAYDIUM_PROGRAMS = {
+    /** AMM Program ID */
+    AMM_PROGRAM: '675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8',
+    /** CLMM Program ID */
+    CLMM_PROGRAM: 'CAMMCzo5YL8w4VFF8KVHrK22GGUsp5VTaW7grrKgrWqK',
+    /** LaunchLab Program ID */
+    LAUNCHLAB_PROGRAM: 'LanMV9sAd7wArD4vJFi2qDdfnVhFxYSUg6eADduJ3uj',
+};
+/**
+ * Orca 程序地址
+ */
+export const ORCA_PROGRAMS = {
+    /** Whirlpool Program ID */
+    WHIRLPOOL_PROGRAM: 'whirLbMiicVdio4qvUfM5KAg6Ct8VwpYzGff3uctyCc',
+};
+/**
+ * Meteora 程序地址
+ */
+export const METEORA_PROGRAMS = {
+    /** DLMM Program ID */
+    DLMM_PROGRAM: 'LBUZKhRxPF3XUpBCjp4YzTKgLccjZhTSDM9YuVaPwxo',
+    /** DAMM v2 Program ID */
+    DAMM_V2_PROGRAM: 'cpamdpZCGKUy5JxQXB4dcpGPiikHawvSWAd6mEn1sGG',
+    /** DBC Program ID */
+    DBC_PROGRAM: 'dbcij3LWUppWqq96dh6gJWwBifmcGfLSB5D4DuSMaqN',
+};
+// ==================== 常用代币地址 ====================
+/**
+ * 常用代币地址
+ */
+export const TOKENS = {
+    /** Wrapped SOL */
+    SOL: 'So11111111111111111111111111111111111111112',
+    /** USDC */
+    USDC: 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v',
+    /** USDT */
+    USDT: 'Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB',
+};
+// ==================== 交易配置 ====================
+/**
+ * 交易默认配置
+ */
+export const TX_CONFIG = {
+    /** 默认滑点 1% */
+    DEFAULT_SLIPPAGE: 1,
+    /** 最大滑点 50% */
+    MAX_SLIPPAGE: 50,
+    /** 计算单元限制 */
+    COMPUTE_UNIT_LIMIT: 200000,
+    /** 计算单元价格（microlamports） */
+    COMPUTE_UNIT_PRICE: 50000,
+    /** 确认超时（毫秒） */
+    CONFIRMATION_TIMEOUT: 60000,
+    /** 默认 commitment */
+    DEFAULT_COMMITMENT: 'confirmed',
+};
+// ==================== 账户大小 ====================
+/**
+ * 账户大小（用于计算租金）
+ */
+export const ACCOUNT_SIZE = {
+    /** Mint 账户大小 */
+    MINT: 82,
+    /** Token 账户大小 */
+    TOKEN_ACCOUNT: 165,
+    /** Metadata 账户大小（近似值） */
+    METADATA: 679,
+};
+// ==================== 单位换算 ====================
+/**
+ * SOL 单位换算
+ */
+export const SOL_DECIMALS = 9;
+export const LAMPORTS_PER_SOL = 1000000000;
+/**
+ * 将 SOL 转换为 lamports
+ */
+export function solToLamports(sol) {
+    return BigInt(Math.floor(sol * LAMPORTS_PER_SOL));
+}
+/**
+ * 将 lamports 转换为 SOL
+ */
+export function lamportsToSol(lamports) {
+    return Number(lamports) / LAMPORTS_PER_SOL;
+}

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

@@ -0,0 +1,8 @@
+/**
+ * DEX 模块导出
+ * @module sol/dex
+ */
+export * from './pump/index.js';
+export * from './raydium/index.js';
+export * from './orca/index.js';
+export * from './meteora/index.js';

package/dist/sol/dex/index.js

@@ -0,0 +1,12 @@
+/**
+ * DEX 模块导出
+ * @module sol/dex
+ */
+// Pump.fun
+export * from './pump/index.js';
+// Raydium
+export * from './raydium/index.js';
+// Orca
+export * from './orca/index.js';
+// Meteora
+export * from './meteora/index.js';

package/dist/sol/dex/meteora/client.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Meteora SDK 客户端管理器
+ *
+ * 统一管理 RPC 连接和 SDK 实例，避免重复实例化
+ */
+import { Connection } from '@solana/web3.js';
+import { CpAmm } from '@meteora-ag/cp-amm-sdk';
+import { DynamicBondingCurveClient } from '@meteora-ag/dynamic-bonding-curve-sdk';
+/**
+ * 获取连接
+ * @param connection 可选的自定义连接
+ * @throws Error 如果没有传入连接且未设置默认连接
+ */
+export declare function getConnection(connection?: Connection): Connection;
+/**
+ * 设置默认连接
+ * @param connection 新的连接实例
+ */
+export declare function setDefaultConnection(connection: Connection): void;
+/**
+ * 重置默认连接
+ */
+export declare function resetDefaultConnection(): void;
+/**
+ * 获取或创建 DLMM 池实例
+ * @param poolAddress 池地址
+ * @param connection 可选连接
+ * @param forceRefresh 强制刷新缓存
+ */
+export declare function getDlmmPool(poolAddress: string, connection?: Connection, forceRefresh?: boolean): Promise<any>;
+/**
+ * 获取所有 DLMM 池列表
+ * @param connection 可选连接
+ */
+export declare function getAllDlmmPools(connection?: Connection): Promise<any[]>;
+/**
+ * 清除 DLMM 池缓存
+ * @param poolAddress 可选，指定池地址；不传则清除全部
+ */
+export declare function clearDlmmCache(poolAddress?: string): void;
+/**
+ * 获取或创建 DBC 客户端
+ * @param connection 可选连接
+ */
+export declare function getDbcClient(connection?: Connection): DynamicBondingCurveClient;
+/**
+ * 重置 DBC 客户端
+ */
+export declare function resetDbcClient(): void;
+/**
+ * 获取或创建 DAMM v1 池实例
+ * @param poolAddress 池地址
+ * @param connection 可选连接
+ * @param forceRefresh 强制刷新缓存
+ */
+export declare function getDammV1Pool(poolAddress: string, connection?: Connection, forceRefresh?: boolean): Promise<any>;
+/**
+ * 清除 DAMM v1 池缓存
+ * @param poolAddress 可选，指定池地址；不传则清除全部
+ */
+export declare function clearDammV1Cache(poolAddress?: string): void;
+/**
+ * 获取或创建 DAMM v2 (CpAmm) 客户端
+ * @param connection 可选连接
+ */
+export declare function getCpAmmClient(connection?: Connection): CpAmm;
+/**
+ * 重置 DAMM v2 客户端
+ */
+export declare function resetCpAmmClient(): void;
+/**
+ * 清除所有 Meteora 缓存
+ */
+export declare function clearAllMeteoraCache(): void;
+export declare function setCacheTtl(ttlMs: number): void;
+export declare function getCacheTtl(): number;

package/dist/sol/dex/meteora/client.js

@@ -0,0 +1,219 @@
+/**
+ * Meteora SDK 客户端管理器
+ *
+ * 统一管理 RPC 连接和 SDK 实例，避免重复实例化
+ */
+import { PublicKey } from '@solana/web3.js';
+// 不再导入 createConnection，强制使用者传入连接
+// SDK 导入 - 使用类型断言绕过 TypeScript 类型检查
+import DLMMModule from '@meteora-ag/dlmm';
+import AmmImplModule from '@meteora-ag/dynamic-amm-sdk';
+import { CpAmm } from '@meteora-ag/cp-amm-sdk';
+import { DynamicBondingCurveClient } from '@meteora-ag/dynamic-bonding-curve-sdk';
+const DLMM = DLMMModule;
+const AmmImpl = AmmImplModule;
+// ============================================================================
+// 连接管理
+// ============================================================================
+/** 默认连接实例（必须通过 setDefaultConnection 设置） */
+let defaultConnection = null;
+/**
+ * 获取连接
+ * @param connection 可选的自定义连接
+ * @throws Error 如果没有传入连接且未设置默认连接
+ */
+export function getConnection(connection) {
+    if (connection) {
+        return connection;
+    }
+    if (!defaultConnection) {
+        throw new Error('Connection is required. Either pass a connection parameter or call setDefaultConnection() first with user-configured RPC.');
+    }
+    return defaultConnection;
+}
+/**
+ * 设置默认连接
+ * @param connection 新的连接实例
+ */
+export function setDefaultConnection(connection) {
+    defaultConnection = connection;
+}
+/**
+ * 重置默认连接
+ */
+export function resetDefaultConnection() {
+    defaultConnection = null;
+}
+// ============================================================================
+// DLMM 实例缓存
+// ============================================================================
+/** DLMM 池实例缓存 */
+const dlmmPoolCache = new Map();
+/** 缓存过期时间 (毫秒) - 默认 30 秒 */
+const CACHE_TTL = 30 * 1000;
+/**
+ * 获取或创建 DLMM 池实例
+ * @param poolAddress 池地址
+ * @param connection 可选连接
+ * @param forceRefresh 强制刷新缓存
+ */
+export async function getDlmmPool(poolAddress, connection, forceRefresh = false) {
+    const conn = getConnection(connection);
+    const cacheKey = poolAddress;
+    // 检查缓存
+    if (!forceRefresh) {
+        const cached = dlmmPoolCache.get(cacheKey);
+        if (cached && Date.now() - cached.timestamp < CACHE_TTL) {
+            return cached.instance;
+        }
+    }
+    // 创建新实例
+    const instance = await DLMM.create(conn, new PublicKey(poolAddress));
+    // 存入缓存
+    dlmmPoolCache.set(cacheKey, {
+        instance,
+        timestamp: Date.now(),
+    });
+    return instance;
+}
+/**
+ * 获取所有 DLMM 池列表
+ * @param connection 可选连接
+ */
+export async function getAllDlmmPools(connection) {
+    const conn = getConnection(connection);
+    return DLMM.getLbPairs(conn);
+}
+/**
+ * 清除 DLMM 池缓存
+ * @param poolAddress 可选，指定池地址；不传则清除全部
+ */
+export function clearDlmmCache(poolAddress) {
+    if (poolAddress) {
+        dlmmPoolCache.delete(poolAddress);
+    }
+    else {
+        dlmmPoolCache.clear();
+    }
+}
+// ============================================================================
+// DBC 客户端管理
+// ============================================================================
+/** DBC 客户端实例缓存 */
+let dbcClient = null;
+let dbcClientConnection = null;
+/**
+ * 获取或创建 DBC 客户端
+ * @param connection 可选连接
+ */
+export function getDbcClient(connection) {
+    const conn = getConnection(connection);
+    // 如果连接相同，复用现有客户端
+    if (dbcClient && dbcClientConnection === conn) {
+        return dbcClient;
+    }
+    // 创建新客户端
+    dbcClient = DynamicBondingCurveClient.create(conn, 'confirmed');
+    dbcClientConnection = conn;
+    return dbcClient;
+}
+/**
+ * 重置 DBC 客户端
+ */
+export function resetDbcClient() {
+    dbcClient = null;
+    dbcClientConnection = null;
+}
+// ============================================================================
+// DAMM v1 实例缓存
+// ============================================================================
+/** DAMM v1 池实例缓存 */
+const dammV1PoolCache = new Map();
+/**
+ * 获取或创建 DAMM v1 池实例
+ * @param poolAddress 池地址
+ * @param connection 可选连接
+ * @param forceRefresh 强制刷新缓存
+ */
+export async function getDammV1Pool(poolAddress, connection, forceRefresh = false) {
+    const conn = getConnection(connection);
+    const cacheKey = poolAddress;
+    // 检查缓存
+    if (!forceRefresh) {
+        const cached = dammV1PoolCache.get(cacheKey);
+        if (cached && Date.now() - cached.timestamp < CACHE_TTL) {
+            return cached.instance;
+        }
+    }
+    // 创建新实例
+    const instance = await AmmImpl.create(conn, new PublicKey(poolAddress));
+    // 存入缓存
+    dammV1PoolCache.set(cacheKey, {
+        instance,
+        timestamp: Date.now(),
+    });
+    return instance;
+}
+/**
+ * 清除 DAMM v1 池缓存
+ * @param poolAddress 可选，指定池地址；不传则清除全部
+ */
+export function clearDammV1Cache(poolAddress) {
+    if (poolAddress) {
+        dammV1PoolCache.delete(poolAddress);
+    }
+    else {
+        dammV1PoolCache.clear();
+    }
+}
+// ============================================================================
+// DAMM v2 客户端管理
+// ============================================================================
+/** DAMM v2 客户端实例缓存 */
+let cpAmmClient = null;
+let cpAmmClientConnection = null;
+/**
+ * 获取或创建 DAMM v2 (CpAmm) 客户端
+ * @param connection 可选连接
+ */
+export function getCpAmmClient(connection) {
+    const conn = getConnection(connection);
+    // 如果连接相同，复用现有客户端
+    if (cpAmmClient && cpAmmClientConnection === conn) {
+        return cpAmmClient;
+    }
+    // 创建新客户端
+    cpAmmClient = new CpAmm(conn);
+    cpAmmClientConnection = conn;
+    return cpAmmClient;
+}
+/**
+ * 重置 DAMM v2 客户端
+ */
+export function resetCpAmmClient() {
+    cpAmmClient = null;
+    cpAmmClientConnection = null;
+}
+// ============================================================================
+// 全局缓存管理
+// ============================================================================
+/**
+ * 清除所有 Meteora 缓存
+ */
+export function clearAllMeteoraCache() {
+    clearDlmmCache();
+    clearDammV1Cache();
+    resetDbcClient();
+    resetCpAmmClient();
+}
+/**
+ * 设置缓存 TTL (毫秒)
+ * 注意: 这会影响新创建的缓存项，不会影响已存在的
+ */
+let cacheTtl = CACHE_TTL;
+export function setCacheTtl(ttlMs) {
+    cacheTtl = ttlMs;
+}
+export function getCacheTtl() {
+    return cacheTtl;
+}

package/dist/sol/dex/meteora/damm-v1-bundle.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Meteora DAMM v1 Bundle 批量交易
+ *
+ * 支持 Jito Bundle 的批量买卖
+ */
+import { Connection, Keypair } from '@solana/web3.js';
+import BN from 'bn.js';
+import type { MeteoraBundleSignedResult } from './types.js';
+/**
+ * DAMM v1 Bundle Swap 参数
+ */
+export interface DammV1BundleSwapParams {
+    /** 池地址 */
+    poolAddress: string;
+    /** 输入代币地址 */
+    inputMint: string;
+    /** 输出代币地址 */
+    outputMint: string;
+    /** 交易列表 */
+    trades: {
+        wallet: Keypair;
+        amountIn: BN;
+        minAmountOut?: BN;
+    }[];
+    /** 滑点 (bps) */
+    slippageBps?: number;
+    /** Jito 小费 */
+    jitoTipLamports?: number;
+}
+/**
+ * 签名 DAMM v1 Bundle 批量买入交易
+ *
+ * @param params Bundle 参数
+ * @param connection 可选连接
+ */
+export declare function signDammV1BundleBuy(params: DammV1BundleSwapParams, connection?: Connection): Promise<MeteoraBundleSignedResult>;
+/**
+ * 签名 DAMM v1 Bundle 批量卖出交易
+ *
+ * @param params Bundle 参数
+ * @param connection 可选连接
+ */
+export declare function signDammV1BundleSell(params: DammV1BundleSwapParams, connection?: Connection): Promise<MeteoraBundleSignedResult>;
+/**
+ * 签名 DAMM v1 Bundle 通用 Swap 交易
+ *
+ * @param params Bundle 参数
+ * @param isBuy 是否买入 (true = 买入, false = 卖出)
+ * @param connection 可选连接
+ */
+export declare function signDammV1BundleSwap(params: DammV1BundleSwapParams, isBuy: boolean, connection?: Connection): Promise<MeteoraBundleSignedResult>;
+/**
+ * 将 Bundle 结果转换为后端 API 请求格式
+ */
+export declare function toDammV1BundleApiRequest(result: MeteoraBundleSignedResult): {
+    transactions: string[];
+    type: string;
+    poolAddress: string;
+    tradeCount: number;
+    jitoTipLamports: number;
+};

package/dist/sol/dex/meteora/damm-v1-bundle.js

@@ -0,0 +1,112 @@
+/**
+ * Meteora DAMM v1 Bundle 批量交易
+ *
+ * 支持 Jito Bundle 的批量买卖
+ */
+import { PublicKey, } from '@solana/web3.js';
+import { getConnection, getDammV1Pool } from './client.js';
+import { buildTipInstruction } from '../../jito/tip.js';
+// ============================================================================
+// Bundle 批量买入
+// ============================================================================
+/**
+ * 签名 DAMM v1 Bundle 批量买入交易
+ *
+ * @param params Bundle 参数
+ * @param connection 可选连接
+ */
+export async function signDammV1BundleBuy(params, connection) {
+    const conn = getConnection(connection);
+    const pool = await getDammV1Pool(params.poolAddress, connection);
+    const signedTransactions = [];
+    for (let i = 0; i < params.trades.length; i++) {
+        const trade = params.trades[i];
+        const swapQuote = pool.getSwapQuote(new PublicKey(params.inputMint), trade.amountIn, params.slippageBps || 100);
+        const minAmountOut = trade.minAmountOut || swapQuote.minSwapOutAmount;
+        const swapTx = await pool.swap(trade.wallet.publicKey, new PublicKey(params.inputMint), trade.amountIn, minAmountOut);
+        if (i === params.trades.length - 1 && params.jitoTipLamports) {
+            const tipIx = buildTipInstruction(trade.wallet.publicKey, BigInt(params.jitoTipLamports));
+            swapTx.add(tipIx);
+        }
+        const { blockhash, lastValidBlockHeight } = await conn.getLatestBlockhash();
+        swapTx.recentBlockhash = blockhash;
+        swapTx.lastValidBlockHeight = lastValidBlockHeight;
+        swapTx.feePayer = trade.wallet.publicKey;
+        swapTx.sign(trade.wallet);
+        signedTransactions.push(swapTx);
+    }
+    return {
+        signedTransactions,
+        type: 'damm_v1_bundle_buy',
+        poolAddress: params.poolAddress,
+        tradeCount: params.trades.length,
+        jitoTipLamports: params.jitoTipLamports || 0,
+    };
+}
+// ============================================================================
+// Bundle 批量卖出
+// ============================================================================
+/**
+ * 签名 DAMM v1 Bundle 批量卖出交易
+ *
+ * @param params Bundle 参数
+ * @param connection 可选连接
+ */
+export async function signDammV1BundleSell(params, connection) {
+    const conn = getConnection(connection);
+    const pool = await getDammV1Pool(params.poolAddress, connection);
+    const signedTransactions = [];
+    for (let i = 0; i < params.trades.length; i++) {
+        const trade = params.trades[i];
+        const swapQuote = pool.getSwapQuote(new PublicKey(params.inputMint), trade.amountIn, params.slippageBps || 100);
+        const minAmountOut = trade.minAmountOut || swapQuote.minSwapOutAmount;
+        const swapTx = await pool.swap(trade.wallet.publicKey, new PublicKey(params.inputMint), trade.amountIn, minAmountOut);
+        if (i === params.trades.length - 1 && params.jitoTipLamports) {
+            const tipIx = buildTipInstruction(trade.wallet.publicKey, BigInt(params.jitoTipLamports));
+            swapTx.add(tipIx);
+        }
+        const { blockhash, lastValidBlockHeight } = await conn.getLatestBlockhash();
+        swapTx.recentBlockhash = blockhash;
+        swapTx.lastValidBlockHeight = lastValidBlockHeight;
+        swapTx.feePayer = trade.wallet.publicKey;
+        swapTx.sign(trade.wallet);
+        signedTransactions.push(swapTx);
+    }
+    return {
+        signedTransactions,
+        type: 'damm_v1_bundle_sell',
+        poolAddress: params.poolAddress,
+        tradeCount: params.trades.length,
+        jitoTipLamports: params.jitoTipLamports || 0,
+    };
+}
+// ============================================================================
+// Bundle 通用 Swap
+// ============================================================================
+/**
+ * 签名 DAMM v1 Bundle 通用 Swap 交易
+ *
+ * @param params Bundle 参数
+ * @param isBuy 是否买入 (true = 买入, false = 卖出)
+ * @param connection 可选连接
+ */
+export async function signDammV1BundleSwap(params, isBuy, connection) {
+    if (isBuy) {
+        return signDammV1BundleBuy(params, connection);
+    }
+    else {
+        return signDammV1BundleSell(params, connection);
+    }
+}
+/**
+ * 将 Bundle 结果转换为后端 API 请求格式
+ */
+export function toDammV1BundleApiRequest(result) {
+    return {
+        transactions: result.signedTransactions.map((tx) => tx.serialize().toString('base64')),
+        type: result.type,
+        poolAddress: result.poolAddress,
+        tradeCount: result.tradeCount,
+        jitoTipLamports: result.jitoTipLamports,
+    };
+}