four-flap-meme-sdk 1.3.82 → 1.3.84

package/dist/sol/dex/orca/orca.js

@@ -0,0 +1,426 @@
+/**
+ * Orca Whirlpool 核心功能
+ * 提供 Swap、LP 添加/移除等功能
+ *
+ * 基于 @orca-so/whirlpools-sdk (Legacy SDK)
+ * 文档: https://dev.orca.so/SDKs/Overview
+ */
+import { PublicKey, } from '@solana/web3.js';
+import { Wallet as AnchorWallet } from '@coral-xyz/anchor';
+import { WhirlpoolContext, buildWhirlpoolClient, ORCA_WHIRLPOOL_PROGRAM_ID, PDAUtil, TickUtil, PriceMath, PoolUtil, TokenExtensionUtil, } from '@orca-so/whirlpools-sdk';
+import { Percentage, AddressUtil, DecimalUtil } from '@orca-so/common-sdk';
+import { createConnection } from '../../utils/connection.js';
+import { ORCA_WHIRLPOOL_CONFIG } from './types.js';
+/**
+ * 创建 Orca Whirlpool Context
+ */
+export async function createOrcaContext(connection, wallet) {
+    const conn = connection || createConnection();
+    // 创建 Anchor Wallet 适配器
+    const anchorWallet = wallet
+        ? new AnchorWallet(wallet)
+        : {
+            publicKey: PublicKey.default,
+            signTransaction: async (tx) => tx,
+            signAllTransactions: async (txs) => txs,
+        };
+    // WhirlpoolContext.from 只需要 connection 和 wallet
+    const ctx = WhirlpoolContext.from(conn, anchorWallet);
+    return ctx;
+}
+/**
+ * 创建 Orca Whirlpool Client
+ */
+export async function createOrcaClient(connection, wallet) {
+    const ctx = await createOrcaContext(connection, wallet);
+    return buildWhirlpoolClient(ctx);
+}
+/**
+ * 获取 Orca Whirlpool 池信息
+ */
+export async function getOrcaPoolInfo(poolAddress, connection) {
+    const client = await createOrcaClient(connection);
+    const pool = await client.getPool(poolAddress);
+    const data = pool.getData();
+    const tokenInfoA = pool.getTokenAInfo();
+    const tokenInfoB = pool.getTokenBInfo();
+    const vaultInfoA = pool.getTokenVaultAInfo();
+    const vaultInfoB = pool.getTokenVaultBInfo();
+    const rewardInfos = pool.getRewardInfos();
+    // 计算当前价格
+    const price = PriceMath.sqrtPriceX64ToPrice(data.sqrtPrice, tokenInfoA.decimals, tokenInfoB.decimals);
+    return {
+        poolAddress,
+        tokenMintA: tokenInfoA.mint.toBase58(),
+        tokenMintB: tokenInfoB.mint.toBase58(),
+        tokenDecimalsA: tokenInfoA.decimals,
+        tokenDecimalsB: tokenInfoB.decimals,
+        tokenVaultA: vaultInfoA.address.toBase58(),
+        tokenVaultB: vaultInfoB.address.toBase58(),
+        price: price.toNumber(),
+        sqrtPrice: data.sqrtPrice.toString(),
+        currentTick: data.tickCurrentIndex,
+        tickSpacing: data.tickSpacing,
+        feeRate: data.feeRate,
+        protocolFeeRate: data.protocolFeeRate,
+        liquidity: data.liquidity.toString(),
+        feeGrowthGlobalA: data.feeGrowthGlobalA.toString(),
+        feeGrowthGlobalB: data.feeGrowthGlobalB.toString(),
+        rewardInfos: rewardInfos.map(info => ({
+            mint: info.mint.toBase58(),
+            vault: info.vault.toBase58(),
+            emissionsPerSecond: info.emissionsPerSecondX64.toString(),
+            growthGlobal: info.growthGlobalX64.toString(),
+        })),
+    };
+}
+/**
+ * 查找 Orca Whirlpool 池
+ */
+export async function findOrcaPool(tokenMintA, tokenMintB, tickSpacing = 64, connection) {
+    const conn = connection || createConnection();
+    // 确保代币顺序正确 (按地址排序)
+    const [mintAAddr, mintBAddr] = PoolUtil.orderMints(new PublicKey(tokenMintA), new PublicKey(tokenMintB));
+    // 转换为 PublicKey
+    const mintA = AddressUtil.toPubKey(mintAAddr);
+    const mintB = AddressUtil.toPubKey(mintBAddr);
+    // 计算池 PDA
+    const poolPda = PDAUtil.getWhirlpool(ORCA_WHIRLPOOL_PROGRAM_ID, new PublicKey(ORCA_WHIRLPOOL_CONFIG.MAINNET), mintA, mintB, tickSpacing);
+    // 检查池是否存在
+    const accountInfo = await conn.getAccountInfo(poolPda.publicKey);
+    return accountInfo ? poolPda.publicKey.toBase58() : null;
+}
+/**
+ * 签名 Orca Swap 交易
+ * 使用 Whirlpool 的高级 swap 接口
+ */
+export async function signOrcaSwap(params, payer, connection) {
+    const conn = connection || createConnection();
+    const client = await createOrcaClient(conn, payer);
+    const pool = await client.getPool(params.poolAddress);
+    const ctx = await createOrcaContext(conn, payer);
+    const inputMint = new PublicKey(params.inputMint);
+    const slippage = Percentage.fromFraction(params.slippageBps || 100, 10000);
+    // 获取 token extension context
+    const tokenInfoA = pool.getTokenAInfo();
+    const tokenInfoB = pool.getTokenBInfo();
+    const tokenExtensionCtx = await TokenExtensionUtil.buildTokenExtensionContextForPool(ctx.fetcher, tokenInfoA.mint, tokenInfoB.mint);
+    // 使用 SDK 的 swapQuoteByInputToken
+    const { swapQuoteByInputToken } = await import('@orca-so/whirlpools-sdk');
+    const quote = await swapQuoteByInputToken(pool, inputMint, params.amountIn, slippage, ORCA_WHIRLPOOL_PROGRAM_ID, ctx.fetcher);
+    // 构建 swap 交易
+    const txBuilder = await pool.swap(quote, payer.publicKey);
+    // 获取最新区块哈希
+    const { blockhash, lastValidBlockHeight } = await conn.getLatestBlockhash();
+    // 构建交易
+    const tx = await txBuilder.build();
+    // 如果是 Transaction 类型
+    if ('recentBlockhash' in tx.transaction) {
+        const transaction = tx.transaction;
+        transaction.recentBlockhash = blockhash;
+        transaction.lastValidBlockHeight = lastValidBlockHeight;
+        transaction.feePayer = payer.publicKey;
+        // 签名
+        transaction.sign(payer, ...tx.signers);
+        return {
+            signedTransaction: transaction,
+            type: 'swap',
+            poolAddress: params.poolAddress,
+            metadata: {
+                estimatedAmountOut: quote.estimatedAmountOut.toString(),
+            },
+        };
+    }
+    // VersionedTransaction 类型
+    const versionedTx = tx.transaction;
+    versionedTx.sign([payer, ...tx.signers]);
+    return {
+        signedTransaction: versionedTx,
+        type: 'swap',
+        poolAddress: params.poolAddress,
+        metadata: {
+            estimatedAmountOut: quote.estimatedAmountOut.toString(),
+        },
+    };
+}
+/**
+ * 签名 Orca 添加流动性交易
+ */
+export async function signOrcaAddLiquidity(params, payer, connection) {
+    const conn = connection || createConnection();
+    const client = await createOrcaClient(conn, payer);
+    const pool = await client.getPool(params.poolAddress);
+    const ctx = await createOrcaContext(conn, payer);
+    const tokenInfoA = pool.getTokenAInfo();
+    const tokenInfoB = pool.getTokenBInfo();
+    const slippage = Percentage.fromFraction(params.slippageBps || 100, 10000);
+    // 获取 token extension context
+    const tokenExtensionCtx = await TokenExtensionUtil.buildTokenExtensionContextForPool(ctx.fetcher, tokenInfoA.mint, tokenInfoB.mint);
+    // 计算流动性报价
+    const { increaseLiquidityQuoteByInputToken } = await import('@orca-so/whirlpools-sdk');
+    // 使用 DecimalUtil 创建 Decimal 值 (从 BN 转换，不带小数位移位)
+    const inputAmount = DecimalUtil.fromBN(params.tokenAmountA, 0);
+    const quote = increaseLiquidityQuoteByInputToken(tokenInfoA.mint, inputAmount, params.tickLower, params.tickUpper, slippage, pool, tokenExtensionCtx);
+    const { blockhash, lastValidBlockHeight } = await conn.getLatestBlockhash();
+    if (params.createNewPosition !== false) {
+        // 创建新的 position
+        const { positionMint, tx: txBuilder } = await pool.openPosition(params.tickLower, params.tickUpper, quote);
+        const tx = await txBuilder.build();
+        if ('recentBlockhash' in tx.transaction) {
+            const transaction = tx.transaction;
+            transaction.recentBlockhash = blockhash;
+            transaction.lastValidBlockHeight = lastValidBlockHeight;
+            transaction.feePayer = payer.publicKey;
+            transaction.sign(payer, ...tx.signers);
+            return {
+                signedTransaction: transaction,
+                type: 'addLiquidity',
+                poolAddress: params.poolAddress,
+                metadata: {
+                    positionMint: positionMint.toBase58(),
+                    liquidityAmount: quote.liquidityAmount.toString(),
+                },
+            };
+        }
+        const versionedTx = tx.transaction;
+        versionedTx.sign([payer, ...tx.signers]);
+        return {
+            signedTransaction: versionedTx,
+            type: 'addLiquidity',
+            poolAddress: params.poolAddress,
+            metadata: {
+                positionMint: positionMint.toBase58(),
+                liquidityAmount: quote.liquidityAmount.toString(),
+            },
+        };
+    }
+    else {
+        // 增加已有 position 的流动性
+        if (!params.positionAddress) {
+            throw new Error('positionAddress is required when createNewPosition is false');
+        }
+        const position = await client.getPosition(params.positionAddress);
+        const txBuilder = await position.increaseLiquidity(quote);
+        const tx = await txBuilder.build();
+        if ('recentBlockhash' in tx.transaction) {
+            const transaction = tx.transaction;
+            transaction.recentBlockhash = blockhash;
+            transaction.lastValidBlockHeight = lastValidBlockHeight;
+            transaction.feePayer = payer.publicKey;
+            transaction.sign(payer, ...tx.signers);
+            return {
+                signedTransaction: transaction,
+                type: 'addLiquidity',
+                poolAddress: params.poolAddress,
+                metadata: {
+                    positionAddress: params.positionAddress,
+                    liquidityAmount: quote.liquidityAmount.toString(),
+                },
+            };
+        }
+        const versionedTx = tx.transaction;
+        versionedTx.sign([payer, ...tx.signers]);
+        return {
+            signedTransaction: versionedTx,
+            type: 'addLiquidity',
+            poolAddress: params.poolAddress,
+            metadata: {
+                positionAddress: params.positionAddress,
+                liquidityAmount: quote.liquidityAmount.toString(),
+            },
+        };
+    }
+}
+/**
+ * 签名 Orca 移除流动性交易
+ */
+export async function signOrcaRemoveLiquidity(params, payer, connection) {
+    const conn = connection || createConnection();
+    const client = await createOrcaClient(conn, payer);
+    const ctx = await createOrcaContext(conn, payer);
+    const position = await client.getPosition(params.positionAddress);
+    const positionData = position.getData();
+    const whirlpoolData = position.getWhirlpoolData();
+    const pool = await client.getPool(positionData.whirlpool);
+    const tokenInfoA = pool.getTokenAInfo();
+    const tokenInfoB = pool.getTokenBInfo();
+    const slippage = Percentage.fromFraction(params.slippageBps || 100, 10000);
+    // 获取 token extension context
+    const tokenExtensionCtx = await TokenExtensionUtil.buildTokenExtensionContextForPool(ctx.fetcher, tokenInfoA.mint, tokenInfoB.mint);
+    // 确定要移除的流动性数量
+    const liquidityToRemove = params.liquidityAmount || positionData.liquidity;
+    // 计算移除流动性报价
+    const { decreaseLiquidityQuoteByLiquidity } = await import('@orca-so/whirlpools-sdk');
+    const quote = decreaseLiquidityQuoteByLiquidity(liquidityToRemove, slippage, position, pool, tokenExtensionCtx);
+    const { blockhash, lastValidBlockHeight } = await conn.getLatestBlockhash();
+    if (params.closePosition) {
+        // 关闭 position (移除全部流动性并关闭)
+        const txBuilders = await pool.closePosition(params.positionAddress, slippage);
+        const signedTxs = [];
+        for (const txBuilder of txBuilders) {
+            const tx = await txBuilder.build();
+            if ('recentBlockhash' in tx.transaction) {
+                const transaction = tx.transaction;
+                transaction.recentBlockhash = blockhash;
+                transaction.lastValidBlockHeight = lastValidBlockHeight;
+                transaction.feePayer = payer.publicKey;
+                transaction.sign(payer, ...tx.signers);
+                signedTxs.push(transaction);
+            }
+            else {
+                const versionedTx = tx.transaction;
+                versionedTx.sign([payer, ...tx.signers]);
+                signedTxs.push(versionedTx);
+            }
+        }
+        // 返回第一个交易 (通常只有一个)
+        return {
+            signedTransaction: signedTxs[0],
+            type: 'removeLiquidity',
+            poolAddress: positionData.whirlpool.toBase58(),
+            metadata: {
+                positionAddress: params.positionAddress,
+                liquidityAmount: liquidityToRemove.toString(),
+            },
+        };
+    }
+    else {
+        // 只移除部分流动性
+        const txBuilder = await position.decreaseLiquidity(quote);
+        const tx = await txBuilder.build();
+        if ('recentBlockhash' in tx.transaction) {
+            const transaction = tx.transaction;
+            transaction.recentBlockhash = blockhash;
+            transaction.lastValidBlockHeight = lastValidBlockHeight;
+            transaction.feePayer = payer.publicKey;
+            transaction.sign(payer, ...tx.signers);
+            return {
+                signedTransaction: transaction,
+                type: 'removeLiquidity',
+                poolAddress: positionData.whirlpool.toBase58(),
+                metadata: {
+                    positionAddress: params.positionAddress,
+                    liquidityAmount: liquidityToRemove.toString(),
+                },
+            };
+        }
+        const versionedTx = tx.transaction;
+        versionedTx.sign([payer, ...tx.signers]);
+        return {
+            signedTransaction: versionedTx,
+            type: 'removeLiquidity',
+            poolAddress: positionData.whirlpool.toBase58(),
+            metadata: {
+                positionAddress: params.positionAddress,
+                liquidityAmount: liquidityToRemove.toString(),
+            },
+        };
+    }
+}
+/**
+ * 签名创建 Orca Whirlpool 池交易
+ */
+export async function signOrcaCreatePool(params, payer, connection) {
+    const conn = connection || createConnection();
+    const client = await createOrcaClient(conn, payer);
+    const initialPrice = DecimalUtil.fromNumber(params.initialPrice);
+    // 创建 Splash Pool (简化的全范围流动性池)
+    const { poolKey, tx: txBuilder } = await client.createSplashPool(params.whirlpoolsConfig || ORCA_WHIRLPOOL_CONFIG.MAINNET, params.tokenMintA, params.tokenMintB, initialPrice, payer.publicKey.toBase58());
+    const { blockhash, lastValidBlockHeight } = await conn.getLatestBlockhash();
+    const tx = await txBuilder.build();
+    if ('recentBlockhash' in tx.transaction) {
+        const transaction = tx.transaction;
+        transaction.recentBlockhash = blockhash;
+        transaction.lastValidBlockHeight = lastValidBlockHeight;
+        transaction.feePayer = payer.publicKey;
+        transaction.sign(payer, ...tx.signers);
+        return {
+            signedTransaction: transaction,
+            type: 'createPool',
+            poolAddress: poolKey.toBase58(),
+        };
+    }
+    const versionedTx = tx.transaction;
+    versionedTx.sign([payer, ...tx.signers]);
+    return {
+        signedTransaction: versionedTx,
+        type: 'createPool',
+        poolAddress: poolKey.toBase58(),
+    };
+}
+/**
+ * 签名收集费用交易
+ */
+export async function signOrcaCollectFees(positionAddress, payer, connection) {
+    const conn = connection || createConnection();
+    const client = await createOrcaClient(conn, payer);
+    const position = await client.getPosition(positionAddress);
+    const positionData = position.getData();
+    const txBuilder = await position.collectFees();
+    const { blockhash, lastValidBlockHeight } = await conn.getLatestBlockhash();
+    const tx = await txBuilder.build();
+    if ('recentBlockhash' in tx.transaction) {
+        const transaction = tx.transaction;
+        transaction.recentBlockhash = blockhash;
+        transaction.lastValidBlockHeight = lastValidBlockHeight;
+        transaction.feePayer = payer.publicKey;
+        transaction.sign(payer, ...tx.signers);
+        return {
+            signedTransaction: transaction,
+            type: 'collectFees',
+            poolAddress: positionData.whirlpool.toBase58(),
+            metadata: {
+                positionAddress,
+            },
+        };
+    }
+    const versionedTx = tx.transaction;
+    versionedTx.sign([payer, ...tx.signers]);
+    return {
+        signedTransaction: versionedTx,
+        type: 'collectFees',
+        poolAddress: positionData.whirlpool.toBase58(),
+        metadata: {
+            positionAddress,
+        },
+    };
+}
+/**
+ * 获取 Position 信息
+ */
+export async function getOrcaPositionInfo(positionAddress, connection) {
+    const client = await createOrcaClient(connection);
+    const position = await client.getPosition(positionAddress);
+    const data = position.getData();
+    return {
+        positionAddress,
+        positionMint: data.positionMint.toBase58(),
+        poolAddress: data.whirlpool.toBase58(),
+        tickLower: data.tickLowerIndex,
+        tickUpper: data.tickUpperIndex,
+        liquidity: data.liquidity.toString(),
+        feeOwedA: data.feeOwedA.toString(),
+        feeOwedB: data.feeOwedB.toString(),
+        rewardOwed: data.rewardInfos.map(info => info.amountOwed.toString()),
+    };
+}
+/**
+ * 计算全范围流动性的 tick 范围
+ */
+export function getFullRangeTickIndices(tickSpacing) {
+    const [tickLower, tickUpper] = TickUtil.getFullRangeTickIndex(tickSpacing);
+    return { tickLower, tickUpper };
+}
+/**
+ * 根据价格范围计算 tick 范围
+ */
+export function getTickIndicesFromPriceRange(priceLower, priceUpper, decimalsA, decimalsB, tickSpacing) {
+    const sqrtPriceLower = PriceMath.priceToSqrtPriceX64(DecimalUtil.fromNumber(priceLower), decimalsA, decimalsB);
+    const sqrtPriceUpper = PriceMath.priceToSqrtPriceX64(DecimalUtil.fromNumber(priceUpper), decimalsA, decimalsB);
+    let tickLower = PriceMath.sqrtPriceX64ToTickIndex(sqrtPriceLower);
+    let tickUpper = PriceMath.sqrtPriceX64ToTickIndex(sqrtPriceUpper);
+    // 对齐到 tickSpacing
+    tickLower = TickUtil.getInitializableTickIndex(tickLower, tickSpacing);
+    tickUpper = TickUtil.getInitializableTickIndex(tickUpper, tickSpacing);
+    return { tickLower, tickUpper };
+}

package/dist/sol/dex/orca/types.d.ts

@@ -0,0 +1,263 @@
+/**
+ * Orca Whirlpool 类型定义
+ */
+import type { Keypair, Transaction, VersionedTransaction } from '@solana/web3.js';
+import type BN from 'bn.js';
+/**
+ * Orca Whirlpool 池信息
+ */
+export interface OrcaPoolInfo {
+    /** 池地址 */
+    poolAddress: string;
+    /** Token A 地址 */
+    tokenMintA: string;
+    /** Token B 地址 */
+    tokenMintB: string;
+    /** Token A 符号 */
+    tokenSymbolA?: string;
+    /** Token B 符号 */
+    tokenSymbolB?: string;
+    /** Token A 小数位数 */
+    tokenDecimalsA: number;
+    /** Token B 小数位数 */
+    tokenDecimalsB: number;
+    /** Token A 金库地址 */
+    tokenVaultA: string;
+    /** Token B 金库地址 */
+    tokenVaultB: string;
+    /** 当前价格 (Token B / Token A) */
+    price: number;
+    /** 当前 sqrt 价格 */
+    sqrtPrice: string;
+    /** 当前 tick */
+    currentTick: number;
+    /** Tick 间距 */
+    tickSpacing: number;
+    /** 费率 (bps) */
+    feeRate: number;
+    /** 协议费率 (bps) */
+    protocolFeeRate: number;
+    /** 流动性 */
+    liquidity: string;
+    /** 费用增长 A */
+    feeGrowthGlobalA: string;
+    /** 费用增长 B */
+    feeGrowthGlobalB: string;
+    /** 奖励信息 */
+    rewardInfos: OrcaRewardInfo[];
+}
+/**
+ * Orca 奖励信息
+ */
+export interface OrcaRewardInfo {
+    /** 奖励代币地址 */
+    mint: string;
+    /** 奖励金库地址 */
+    vault: string;
+    /** 每秒排放量 */
+    emissionsPerSecond: string;
+    /** 增长全局 */
+    growthGlobal: string;
+}
+/**
+ * Orca Swap 参数
+ */
+export interface OrcaSwapParams {
+    /** 池地址 */
+    poolAddress: string;
+    /** 输入代币地址 */
+    inputMint: string;
+    /** 输出代币地址 */
+    outputMint: string;
+    /** 输入金额 (lamports) */
+    amountIn: BN;
+    /** 最小输出金额 (lamports) */
+    minAmountOut: BN;
+    /** 滑点 (bps, 如 100 = 1%) */
+    slippageBps?: number;
+    /** 是否精确输入 */
+    exactInput?: boolean;
+}
+/**
+ * Orca Swap 报价
+ */
+export interface OrcaSwapQuote {
+    /** 输入金额 */
+    amountIn: BN;
+    /** 预估输出金额 */
+    estimatedAmountOut: BN;
+    /** 最小输出金额 (考虑滑点) */
+    minAmountOut: BN;
+    /** 费用金额 */
+    feeAmount: BN;
+    /** 价格影响 (百分比) */
+    priceImpact: number;
+}
+/**
+ * Orca 添加流动性参数
+ */
+export interface OrcaAddLiquidityParams {
+    /** 池地址 */
+    poolAddress: string;
+    /** 下限 tick */
+    tickLower: number;
+    /** 上限 tick */
+    tickUpper: number;
+    /** Token A 金额 */
+    tokenAmountA: BN;
+    /** Token B 金额 */
+    tokenAmountB: BN;
+    /** 滑点 (bps) */
+    slippageBps?: number;
+    /** 是否创建新 position */
+    createNewPosition?: boolean;
+    /** 已有 position 地址 (如果不创建新的) */
+    positionAddress?: string;
+}
+/**
+ * Orca 移除流动性参数
+ */
+export interface OrcaRemoveLiquidityParams {
+    /** Position 地址 */
+    positionAddress: string;
+    /** 流动性金额 (如果不指定，移除全部) */
+    liquidityAmount?: BN;
+    /** 最小 Token A 输出 */
+    minTokenAmountA?: BN;
+    /** 最小 Token B 输出 */
+    minTokenAmountB?: BN;
+    /** 滑点 (bps) */
+    slippageBps?: number;
+    /** 是否关闭 position */
+    closePosition?: boolean;
+}
+/**
+ * Orca Position 信息
+ */
+export interface OrcaPositionInfo {
+    /** Position 地址 */
+    positionAddress: string;
+    /** Position Mint 地址 */
+    positionMint: string;
+    /** 池地址 */
+    poolAddress: string;
+    /** 下限 tick */
+    tickLower: number;
+    /** 上限 tick */
+    tickUpper: number;
+    /** 流动性 */
+    liquidity: string;
+    /** 费用 A 应收 */
+    feeOwedA: string;
+    /** 费用 B 应收 */
+    feeOwedB: string;
+    /** 奖励应收 */
+    rewardOwed: string[];
+}
+/**
+ * Orca 创建池参数
+ */
+export interface OrcaCreatePoolParams {
+    /** Whirlpools Config 地址 */
+    whirlpoolsConfig: string;
+    /** Token A 地址 */
+    tokenMintA: string;
+    /** Token B 地址 */
+    tokenMintB: string;
+    /** 初始价格 (Token B / Token A) */
+    initialPrice: number;
+    /** Tick 间距 (决定费率) */
+    tickSpacing?: number;
+    /** 资金提供者 (默认为签名者) */
+    funder?: string;
+}
+/**
+ * Orca Bundle Swap 参数 (批量交易)
+ */
+export interface OrcaBundleSwapParams {
+    /** 池地址 */
+    poolAddress: string;
+    /** 输入代币地址 */
+    inputMint: string;
+    /** 输出代币地址 */
+    outputMint: string;
+    /** 交易列表 */
+    trades: {
+        /** 钱包 */
+        wallet: Keypair;
+        /** 输入金额 */
+        amountIn: BN;
+        /** 最小输出金额 */
+        minAmountOut: BN;
+    }[];
+    /** Jito 小费 (lamports) */
+    jitoTipLamports?: number;
+}
+/**
+ * Orca 签名结果
+ */
+export interface OrcaSignedResult {
+    /** 签名后的交易 */
+    signedTransaction: Transaction | VersionedTransaction;
+    /** 交易类型 */
+    type: 'swap' | 'addLiquidity' | 'removeLiquidity' | 'createPool' | 'collectFees';
+    /** 池地址 */
+    poolAddress: string;
+    /** 额外信息 */
+    metadata?: {
+        positionMint?: string;
+        positionAddress?: string;
+        estimatedAmountOut?: string;
+        liquidityAmount?: string;
+    };
+}
+/**
+ * Orca Bundle 签名结果
+ */
+export interface OrcaBundleSignedResult {
+    /** 签名后的交易列表 */
+    signedTransactions: (Transaction | VersionedTransaction)[];
+    /** Bundle 类型 */
+    type: 'bundleSwap';
+    /** 池地址 */
+    poolAddress: string;
+    /** 交易数量 */
+    tradeCount: number;
+    /** Jito 小费 */
+    jitoTipLamports: number;
+}
+/**
+ * Whirlpool 费率等级
+ * tickSpacing 决定费率
+ */
+export declare const WHIRLPOOL_TICK_SPACING: {
+    /** 0.01% 费率 */
+    readonly TICK_SPACING_1: 1;
+    /** 0.02% 费率 */
+    readonly TICK_SPACING_2: 2;
+    /** 0.04% 费率 */
+    readonly TICK_SPACING_4: 4;
+    /** 0.08% 费率 */
+    readonly TICK_SPACING_8: 8;
+    /** 0.16% 费率 */
+    readonly TICK_SPACING_16: 16;
+    /** 0.30% 费率 */
+    readonly TICK_SPACING_64: 64;
+    /** 1.00% 费率 */
+    readonly TICK_SPACING_128: 128;
+    /** 2.00% 费率 */
+    readonly TICK_SPACING_256: 256;
+};
+/**
+ * Orca Whirlpools Config 地址
+ */
+export declare const ORCA_WHIRLPOOL_CONFIG: {
+    /** Mainnet Whirlpools Config */
+    readonly MAINNET: "FcrweFY1G9HJAHG5inkGB6pKg1HZ6x9UC2WioAfWrGkR";
+    /** Devnet Whirlpools Config */
+    readonly DEVNET: "FcrweFY1G9HJAHG5inkGB6pKg1HZ6x9UC2WioAfWrGkR";
+};
+/**
+ * Orca Whirlpool Program ID
+ */
+export declare const ORCA_WHIRLPOOL_PROGRAM_ID = "whirLbMiicVdio4qvUfM5KAg6Ct8VwpYzGff3uctyCc";