four-flap-meme-sdk 1.3.89 → 1.3.91

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

@@ -0,0 +1,242 @@
+/**
+ * Meteora DAMM v2 (CP-AMM) Bundle 批量交易
+ *
+ * 支持 Jito Bundle 的批量买卖
+ */
+import { PublicKey, } from '@solana/web3.js';
+import { getTokenProgram } from '@meteora-ag/cp-amm-sdk';
+import { getConnection, getCpAmmClient } from './client.js';
+import { buildTipInstruction } from '../../jito/tip.js';
+// ============================================================================
+// Bundle 批量买入
+// ============================================================================
+/**
+ * 签名 DAMM v2 Bundle 批量买入交易
+ *
+ * @param params Bundle 参数
+ * @param connection 可选连接
+ */
+export async function signDammV2BundleBuy(params, connection) {
+    const conn = getConnection(connection);
+    const cpAmm = getCpAmmClient(connection);
+    const poolPubkey = new PublicKey(params.poolAddress);
+    const poolState = await cpAmm.fetchPoolState(poolPubkey);
+    // 获取当前 slot 和时间用于报价
+    const currentSlot = await conn.getSlot();
+    const blockTime = await conn.getBlockTime(currentSlot);
+    const signedTransactions = [];
+    const { blockhash, lastValidBlockHeight } = await conn.getLatestBlockhash();
+    const tokenADecimal = params.tokenADecimal ?? 9;
+    const tokenBDecimal = params.tokenBDecimal ?? 9;
+    const slippage = params.slippagePercent ?? 0.5;
+    for (let i = 0; i < params.trades.length; i++) {
+        const trade = params.trades[i];
+        let minAmountOut = trade.minAmountOut;
+        // 如果没有指定 minAmountOut，使用 getQuote 获取准确报价
+        if (!minAmountOut) {
+            const quote = await cpAmm.getQuote({
+                inAmount: trade.amountIn,
+                inputTokenMint: new PublicKey(params.inputMint),
+                slippage,
+                poolState,
+                currentTime: blockTime || Math.floor(Date.now() / 1000),
+                currentSlot,
+                tokenADecimal,
+                tokenBDecimal,
+                hasReferral: false,
+            });
+            minAmountOut = quote.minSwapOutAmount;
+        }
+        // swap 返回 TxBuilder，需要调用 .transaction() 获取 Transaction
+        const swapTxBuilder = await cpAmm.swap({
+            payer: trade.wallet.publicKey,
+            pool: poolPubkey,
+            inputTokenMint: new PublicKey(params.inputMint),
+            outputTokenMint: new PublicKey(params.outputMint),
+            amountIn: trade.amountIn,
+            minimumAmountOut: minAmountOut,
+            tokenAMint: poolState.tokenAMint,
+            tokenBMint: poolState.tokenBMint,
+            tokenAVault: poolState.tokenAVault,
+            tokenBVault: poolState.tokenBVault,
+            tokenAProgram: getTokenProgram(poolState.tokenAFlag),
+            tokenBProgram: getTokenProgram(poolState.tokenBFlag),
+            referralTokenAccount: null,
+        });
+        // 处理 TxBuilder 或 Transaction 返回类型
+        const swapTx = 'transaction' in swapTxBuilder
+            ? await swapTxBuilder.transaction()
+            : swapTxBuilder;
+        // 如果是最后一笔交易，添加 Jito tip
+        if (i === params.trades.length - 1 && params.jitoTipLamports) {
+            const tipIx = buildTipInstruction(trade.wallet.publicKey, BigInt(params.jitoTipLamports));
+            swapTx.add(tipIx);
+        }
+        swapTx.recentBlockhash = blockhash;
+        swapTx.lastValidBlockHeight = lastValidBlockHeight;
+        swapTx.feePayer = trade.wallet.publicKey;
+        swapTx.sign(trade.wallet);
+        signedTransactions.push(swapTx);
+    }
+    return {
+        signedTransactions,
+        type: 'damm_v2_bundle_buy',
+        poolAddress: params.poolAddress,
+        tradeCount: params.trades.length,
+        jitoTipLamports: params.jitoTipLamports || 0,
+    };
+}
+// ============================================================================
+// Bundle 批量卖出
+// ============================================================================
+/**
+ * 签名 DAMM v2 Bundle 批量卖出交易
+ *
+ * @param params Bundle 参数
+ * @param connection 可选连接
+ */
+export async function signDammV2BundleSell(params, connection) {
+    const conn = getConnection(connection);
+    const cpAmm = getCpAmmClient(connection);
+    const poolPubkey = new PublicKey(params.poolAddress);
+    const poolState = await cpAmm.fetchPoolState(poolPubkey);
+    // 获取当前 slot 和时间用于报价
+    const currentSlot = await conn.getSlot();
+    const blockTime = await conn.getBlockTime(currentSlot);
+    const signedTransactions = [];
+    const { blockhash, lastValidBlockHeight } = await conn.getLatestBlockhash();
+    const tokenADecimal = params.tokenADecimal ?? 9;
+    const tokenBDecimal = params.tokenBDecimal ?? 9;
+    const slippage = params.slippagePercent ?? 0.5;
+    for (let i = 0; i < params.trades.length; i++) {
+        const trade = params.trades[i];
+        let minAmountOut = trade.minAmountOut;
+        // 如果没有指定 minAmountOut，使用 getQuote 获取准确报价
+        if (!minAmountOut) {
+            const quote = await cpAmm.getQuote({
+                inAmount: trade.amountIn,
+                inputTokenMint: new PublicKey(params.inputMint),
+                slippage,
+                poolState,
+                currentTime: blockTime || Math.floor(Date.now() / 1000),
+                currentSlot,
+                tokenADecimal,
+                tokenBDecimal,
+                hasReferral: false,
+            });
+            minAmountOut = quote.minSwapOutAmount;
+        }
+        // swap 返回 TxBuilder，需要调用 .transaction() 获取 Transaction
+        const swapTxBuilder = await cpAmm.swap({
+            payer: trade.wallet.publicKey,
+            pool: poolPubkey,
+            inputTokenMint: new PublicKey(params.inputMint),
+            outputTokenMint: new PublicKey(params.outputMint),
+            amountIn: trade.amountIn,
+            minimumAmountOut: minAmountOut,
+            tokenAMint: poolState.tokenAMint,
+            tokenBMint: poolState.tokenBMint,
+            tokenAVault: poolState.tokenAVault,
+            tokenBVault: poolState.tokenBVault,
+            tokenAProgram: getTokenProgram(poolState.tokenAFlag),
+            tokenBProgram: getTokenProgram(poolState.tokenBFlag),
+            referralTokenAccount: null,
+        });
+        // 处理 TxBuilder 或 Transaction 返回类型
+        const swapTx = 'transaction' in swapTxBuilder
+            ? await swapTxBuilder.transaction()
+            : swapTxBuilder;
+        // 如果是最后一笔交易，添加 Jito tip
+        if (i === params.trades.length - 1 && params.jitoTipLamports) {
+            const tipIx = buildTipInstruction(trade.wallet.publicKey, BigInt(params.jitoTipLamports));
+            swapTx.add(tipIx);
+        }
+        swapTx.recentBlockhash = blockhash;
+        swapTx.lastValidBlockHeight = lastValidBlockHeight;
+        swapTx.feePayer = trade.wallet.publicKey;
+        swapTx.sign(trade.wallet);
+        signedTransactions.push(swapTx);
+    }
+    return {
+        signedTransactions,
+        type: 'damm_v2_bundle_sell',
+        poolAddress: params.poolAddress,
+        tradeCount: params.trades.length,
+        jitoTipLamports: params.jitoTipLamports || 0,
+    };
+}
+// ============================================================================
+// Bundle 通用 Swap
+// ============================================================================
+/**
+ * 签名 DAMM v2 Bundle 通用 Swap 交易
+ *
+ * @param params Bundle 参数
+ * @param isBuy 是否买入 (true = 买入, false = 卖出)
+ * @param connection 可选连接
+ */
+export async function signDammV2BundleSwap(params, isBuy, connection) {
+    if (isBuy) {
+        return signDammV2BundleBuy(params, connection);
+    }
+    else {
+        return signDammV2BundleSell(params, connection);
+    }
+}
+/**
+ * 将 Bundle 结果转换为后端 API 请求格式
+ */
+export function toDammV2BundleApiRequest(result) {
+    return {
+        transactions: result.signedTransactions.map((tx) => tx.serialize().toString('base64')),
+        type: result.type,
+        poolAddress: result.poolAddress,
+        tradeCount: result.tradeCount,
+        jitoTipLamports: result.jitoTipLamports,
+    };
+}
+// ============================================================================
+// 辅助函数：批量获取报价
+// ============================================================================
+/**
+ * 批量获取 DAMM v2 Swap 报价
+ *
+ * @param poolAddress 池地址
+ * @param inputMint 输入代币地址
+ * @param amounts 输入金额列表
+ * @param tokenADecimal Token A 精度
+ * @param tokenBDecimal Token B 精度
+ * @param slippagePercent 滑点百分比
+ * @param connection 可选连接
+ */
+export async function getDammV2BundleQuotes(poolAddress, inputMint, amounts, tokenADecimal = 9, tokenBDecimal = 9, slippagePercent = 0.5, connection) {
+    const conn = getConnection(connection);
+    const cpAmm = getCpAmmClient(connection);
+    const poolPubkey = new PublicKey(poolAddress);
+    const poolState = await cpAmm.fetchPoolState(poolPubkey);
+    const currentSlot = await conn.getSlot();
+    const blockTime = await conn.getBlockTime(currentSlot);
+    const quotes = [];
+    for (const amountIn of amounts) {
+        const quote = await cpAmm.getQuote({
+            inAmount: amountIn,
+            inputTokenMint: new PublicKey(inputMint),
+            slippage: slippagePercent,
+            poolState,
+            currentTime: blockTime || Math.floor(Date.now() / 1000),
+            currentSlot,
+            tokenADecimal,
+            tokenBDecimal,
+            hasReferral: false,
+        });
+        quotes.push({
+            swapOutAmount: quote.swapOutAmount.toString(),
+            minSwapOutAmount: quote.minSwapOutAmount.toString(),
+            totalFee: quote.totalFee.toString(),
+            priceImpact: typeof quote.priceImpact === 'number'
+                ? quote.priceImpact
+                : Number(quote.priceImpact),
+        });
+    }
+    return quotes;
+}

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

@@ -0,0 +1,172 @@
+/**
+ * Meteora DAMM v2 (CP-AMM) 集成
+ *
+ * 基于 https://github.com/MeteoraAg/cp-amm-sdk 源码分析
+ * DAMM v2 是 DBC 迁移后的目标池之一，使用 NFT 代表仓位
+ */
+import { Connection, Keypair } from '@solana/web3.js';
+import BN from 'bn.js';
+import type { DammV2PoolInfo, DammV2SwapParams, DammV2AddLiquidityParams, DammV2RemoveLiquidityParams, MeteoraSignedResult } from './types.js';
+/**
+ * 获取 DAMM v2 池信息
+ * @param poolAddress 池地址
+ * @param connection 可选连接
+ */
+export declare function getDammV2PoolInfo(poolAddress: string, connection?: Connection): Promise<DammV2PoolInfo>;
+/**
+ * 签名 DAMM v2 Swap 交易
+ * @param params Swap 参数
+ * @param wallet 钱包
+ * @param connection 可选连接
+ */
+export declare function signDammV2Swap(params: DammV2SwapParams, wallet: Keypair, connection?: Connection): Promise<MeteoraSignedResult>;
+/**
+ * 签名 DAMM v2 添加流动性交易（创建新仓位）
+ */
+export declare function signDammV2AddLiquidity(params: DammV2AddLiquidityParams, wallet: Keypair, positionNftKeypair?: Keypair, connection?: Connection): Promise<MeteoraSignedResult>;
+/**
+ * 签名 DAMM v2 移除流动性交易
+ */
+export declare function signDammV2RemoveLiquidity(params: DammV2RemoveLiquidityParams, positionAddress: string, positionNftAccount: string, wallet: Keypair, connection?: Connection): Promise<MeteoraSignedResult>;
+/**
+ * 签名领取 Position 费用交易
+ */
+export declare function signDammV2ClaimPositionFee(poolAddress: string, positionAddress: string, positionNftAccount: string, wallet: Keypair, connection?: Connection): Promise<MeteoraSignedResult>;
+/**
+ * 签名永久锁定 Position 交易
+ */
+export declare function signDammV2PermanentLockPosition(poolAddress: string, positionAddress: string, positionNftAccount: string, unlockedLiquidity: BN, wallet: Keypair, connection?: Connection): Promise<MeteoraSignedResult>;
+/**
+ * 获取用户在池中的所有 Position
+ */
+export declare function getDammV2UserPositions(poolAddress: string, userAddress: string, connection?: Connection): Promise<any[]>;
+/**
+ * 派生池地址
+ */
+export declare function deriveDammV2PoolAddress(config: string, tokenAMint: string, tokenBMint: string): string;
+/**
+ * 派生 Position 地址
+ */
+export declare function deriveDammV2PositionAddress(positionNft: string): string;
+/**
+ * 签名创建 DAMM v2 池交易
+ * @param params 创建池参数
+ * @param positionNftKeypair Position NFT Keypair
+ * @param wallet 钱包
+ * @param connection 可选连接
+ */
+export declare function signDammV2CreatePool(params: {
+    configAddress: string;
+    tokenAMint: string;
+    tokenBMint: string;
+    tokenAAmount: BN;
+    tokenBAmount: BN;
+    initSqrtPrice: BN;
+    liquidityDelta: BN;
+    activationPoint?: BN | null;
+}, positionNftKeypair: Keypair, wallet: Keypair, connection?: Connection): Promise<MeteoraSignedResult>;
+/**
+ * 签名创建 Position（空仓位）交易
+ * @param poolAddress 池地址
+ * @param positionNftKeypair Position NFT Keypair
+ * @param wallet 钱包
+ * @param connection 可选连接
+ */
+export declare function signDammV2CreatePosition(poolAddress: string, positionNftKeypair: Keypair, wallet: Keypair, connection?: Connection): Promise<MeteoraSignedResult>;
+/**
+ * 获取 DAMM v2 Swap 报价
+ * @param poolAddress 池地址
+ * @param inputMint 输入 Mint
+ * @param amountIn 输入数量
+ * @param slippage 滑点百分比 (例如 0.5 表示 0.5%)
+ * @param tokenADecimal Token A 精度
+ * @param tokenBDecimal Token B 精度
+ * @param connection 可选连接
+ */
+export declare function getDammV2SwapQuote(poolAddress: string, inputMint: string, amountIn: BN, slippage?: number, tokenADecimal?: number, tokenBDecimal?: number, connection?: Connection): Promise<{
+    swapInAmount: string;
+    consumedInAmount: string;
+    swapOutAmount: string;
+    minSwapOutAmount: string;
+    totalFee: string;
+    priceImpact: number;
+}>;
+/**
+ * 计算流动性增量
+ * @param poolAddress 池地址
+ * @param maxAmountA 最大 Token A 数量
+ * @param maxAmountB 最大 Token B 数量
+ * @param connection 可选连接
+ */
+export declare function getDammV2LiquidityDelta(poolAddress: string, maxAmountA: BN, maxAmountB: BN, connection?: Connection): Promise<{
+    liquidityDelta: string;
+    tokenAAmount: string;
+    tokenBAmount: string;
+}>;
+/**
+ * 签名关闭 Position 交易（需要先移除所有流动性）
+ * @param poolAddress 池地址
+ * @param positionAddress Position 地址
+ * @param positionNftMint Position NFT Mint
+ * @param positionNftAccount Position NFT 账户
+ * @param wallet 钱包
+ * @param connection 可选连接
+ */
+export declare function signDammV2ClosePosition(poolAddress: string, positionAddress: string, positionNftMint: string, positionNftAccount: string, wallet: Keypair, connection?: Connection): Promise<MeteoraSignedResult>;
+/**
+ * 签名移除所有流动性交易
+ * @param poolAddress 池地址
+ * @param positionAddress Position 地址
+ * @param positionNftAccount Position NFT 账户
+ * @param liquidity 要移除的流动性数量
+ * @param wallet 钱包
+ * @param connection 可选连接
+ */
+export declare function signDammV2RemoveAllLiquidity(poolAddress: string, positionAddress: string, positionNftAccount: string, liquidity: BN, wallet: Keypair, connection?: Connection): Promise<MeteoraSignedResult>;
+/**
+ * 签名锁定 Position 交易（带 vesting）
+ * @param poolAddress 池地址
+ * @param positionAddress Position 地址
+ * @param positionNftAccount Position NFT 账户
+ * @param vestingParams Vesting 参数
+ * @param vestingAccountKeypair Vesting 账户 Keypair
+ * @param wallet 钱包
+ * @param connection 可选连接
+ */
+export declare function signDammV2LockPosition(poolAddress: string, positionAddress: string, positionNftAccount: string, vestingParams: {
+    cliffPoint: BN | null;
+    periodFrequency: BN;
+    cliffUnlockLiquidity: BN;
+    liquidityPerPeriod: BN;
+    numberOfPeriod: number;
+}, vestingAccountKeypair: Keypair, wallet: Keypair, connection?: Connection): Promise<MeteoraSignedResult>;
+/**
+ * 签名领取奖励交易
+ * @param poolAddress 池地址
+ * @param positionAddress Position 地址
+ * @param positionNftAccount Position NFT 账户
+ * @param rewardIndex 奖励索引
+ * @param wallet 钱包
+ * @param connection 可选连接
+ */
+export declare function signDammV2ClaimReward(poolAddress: string, positionAddress: string, positionNftAccount: string, rewardIndex: number, wallet: Keypair, connection?: Connection): Promise<MeteoraSignedResult>;
+/**
+ * 获取 Position 详细信息
+ * @param positionAddress Position 地址
+ * @param connection 可选连接
+ */
+export declare function getDammV2PositionInfo(positionAddress: string, connection?: Connection): Promise<{
+    unlockedLiquidity: string;
+    vestedLiquidity: string;
+    permanentLockedLiquidity: string;
+    pool: string;
+    nftMint: string;
+    feeAPending: string;
+    feeBPending: string;
+}>;
+/**
+ * 获取池配置信息
+ * @param configAddress 配置地址
+ * @param connection 可选连接
+ */
+export declare function getDammV2ConfigInfo(configAddress: string, connection?: Connection): Promise<any>;