four-flap-meme-sdk 1.5.55 → 1.5.56

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,
+    };
+}

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

@@ -0,0 +1,118 @@
+/**
+ * Meteora DAMM v1 (Dynamic AMM) 集成
+ *
+ * 基于 https://github.com/MeteoraAg/dynamic-amm-sdk 源码分析
+ * DAMM v1 是 DBC 迁移后的目标池之一
+ */
+import { Connection, Keypair } from '@solana/web3.js';
+import BN from 'bn.js';
+import type { DammV1PoolInfo, DammV1SwapParams, MeteoraSignedResult } from './types.js';
+/**
+ * 获取 DAMM v1 池信息
+ * @param poolAddress 池地址
+ * @param connection 可选连接
+ */
+export declare function getDammV1PoolInfo(poolAddress: string, connection?: Connection): Promise<DammV1PoolInfo>;
+/**
+ * 签名 DAMM v1 Swap 交易
+ * @param params Swap 参数
+ * @param wallet 钱包
+ * @param connection 可选连接
+ */
+export declare function signDammV1Swap(params: DammV1SwapParams, wallet: Keypair, connection?: Connection): Promise<MeteoraSignedResult>;
+/**
+ * 签名 DAMM v1 添加流动性交易
+ */
+export declare function signDammV1Deposit(poolAddress: string, amountA: BN, amountB: BN, wallet: Keypair, connection?: Connection): Promise<MeteoraSignedResult>;
+/**
+ * 签名 DAMM v1 移除流动性交易
+ */
+export declare function signDammV1Withdraw(poolAddress: string, lpAmount: BN, wallet: Keypair, connection?: Connection): Promise<MeteoraSignedResult>;
+/**
+ * 签名锁定 LP 交易
+ */
+export declare function signDammV1LockLiquidity(poolAddress: string, lpAmount: BN, wallet: Keypair, connection?: Connection): Promise<MeteoraSignedResult>;
+/**
+ * 签名领取锁定 LP 费用交易
+ */
+export declare function signDammV1ClaimLockFee(poolAddress: string, wallet: Keypair, connection?: Connection): Promise<MeteoraSignedResult>;
+/**
+ * 获取 LP Token Mint 地址
+ */
+export declare function getDammV1LpMint(poolAddress: string, connection?: Connection): Promise<string>;
+/**
+ * 获取 LP 供应量
+ */
+export declare function getDammV1LpSupply(poolAddress: string, connection?: Connection): Promise<BN>;
+/**
+ * 获取锁定的 LP 数量
+ */
+export declare function getDammV1LockedLpAmount(poolAddress: string, connection?: Connection): Promise<BN>;
+/**
+ * 签名创建 DAMM v1 池交易
+ * @param tokenAMint Token A Mint
+ * @param tokenBMint Token B Mint
+ * @param tokenAAmount 初始 Token A 数量
+ * @param tokenBAmount 初始 Token B 数量
+ * @param wallet 钱包
+ * @param connection 可选连接
+ */
+export declare function signDammV1CreatePool(tokenAMint: string, tokenBMint: string, tokenAAmount: BN, tokenBAmount: BN, wallet: Keypair, connection?: Connection): Promise<MeteoraSignedResult>;
+/**
+ * 获取 DAMM v1 Swap 报价
+ * @param poolAddress 池地址
+ * @param inputMint 输入 Mint
+ * @param amountIn 输入数量
+ * @param slippageBps 滑点 (bps)
+ * @param connection 可选连接
+ */
+export declare function getDammV1SwapQuote(poolAddress: string, inputMint: string, amountIn: BN, slippageBps?: number, connection?: Connection): Promise<{
+    swapInAmount: string;
+    swapOutAmount: string;
+    minSwapOutAmount: string;
+    priceImpact: string;
+    fee: string;
+}>;
+/**
+ * 获取 DAMM v1 存款报价
+ * @param poolAddress 池地址
+ * @param tokenAAmount Token A 数量
+ * @param tokenBAmount Token B 数量
+ * @param slippageBps 滑点 (bps)
+ * @param connection 可选连接
+ */
+export declare function getDammV1DepositQuote(poolAddress: string, tokenAAmount: BN, tokenBAmount: BN, slippageBps?: number, connection?: Connection): Promise<{
+    tokenAInAmount: string;
+    tokenBInAmount: string;
+    poolTokenAmountOut: string;
+    minPoolTokenAmountOut: string;
+}>;
+/**
+ * 获取 DAMM v1 提款报价
+ * @param poolAddress 池地址
+ * @param lpAmount LP 数量
+ * @param slippageBps 滑点 (bps)
+ * @param connection 可选连接
+ */
+export declare function getDammV1WithdrawQuote(poolAddress: string, lpAmount: BN, slippageBps?: number, connection?: Connection): Promise<{
+    tokenAOutAmount: string;
+    tokenBOutAmount: string;
+    minTokenAOutAmount: string;
+    minTokenBOutAmount: string;
+}>;
+/**
+ * 获取用户的 LP 余额
+ * @param poolAddress 池地址
+ * @param userAddress 用户地址
+ * @param connection 可选连接
+ */
+export declare function getDammV1UserLpBalance(poolAddress: string, userAddress: string, connection?: Connection): Promise<{
+    balance: string;
+    lockedBalance: string;
+}>;
+/**
+ * 获取池的虚拟价格
+ * @param poolAddress 池地址
+ * @param connection 可选连接
+ */
+export declare function getDammV1VirtualPrice(poolAddress: string, connection?: Connection): Promise<number>;