four-flap-meme-sdk 1.5.55 → 1.5.56

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

@@ -0,0 +1,110 @@
+/**
+ * Meteora 通用类型定义
+ */
+/**
+ * DBC 迁移费用选项
+ */
+export var DbcMigrationFeeOption;
+(function (DbcMigrationFeeOption) {
+    DbcMigrationFeeOption[DbcMigrationFeeOption["FixedBps25"] = 0] = "FixedBps25";
+    DbcMigrationFeeOption[DbcMigrationFeeOption["FixedBps30"] = 1] = "FixedBps30";
+    DbcMigrationFeeOption[DbcMigrationFeeOption["FixedBps100"] = 2] = "FixedBps100";
+    DbcMigrationFeeOption[DbcMigrationFeeOption["FixedBps200"] = 3] = "FixedBps200";
+    DbcMigrationFeeOption[DbcMigrationFeeOption["FixedBps400"] = 4] = "FixedBps400";
+    DbcMigrationFeeOption[DbcMigrationFeeOption["FixedBps600"] = 5] = "FixedBps600";
+    DbcMigrationFeeOption[DbcMigrationFeeOption["Customizable"] = 6] = "Customizable";
+})(DbcMigrationFeeOption || (DbcMigrationFeeOption = {}));
+/**
+ * DBC 激活类型
+ */
+export var DbcActivationType;
+(function (DbcActivationType) {
+    DbcActivationType[DbcActivationType["Slot"] = 0] = "Slot";
+    DbcActivationType[DbcActivationType["Timestamp"] = 1] = "Timestamp";
+})(DbcActivationType || (DbcActivationType = {}));
+/**
+ * DBC 代币类型
+ */
+export var DbcTokenType;
+(function (DbcTokenType) {
+    DbcTokenType[DbcTokenType["Token"] = 0] = "Token";
+    DbcTokenType[DbcTokenType["Token2022"] = 1] = "Token2022";
+})(DbcTokenType || (DbcTokenType = {}));
+/**
+ * DBC 迁移目标
+ */
+export var DbcMigrationOption;
+(function (DbcMigrationOption) {
+    DbcMigrationOption[DbcMigrationOption["DammV1"] = 0] = "DammV1";
+    DbcMigrationOption[DbcMigrationOption["DammV2"] = 1] = "DammV2";
+})(DbcMigrationOption || (DbcMigrationOption = {}));
+// ============================================================================
+// DBC 扩展类型
+// ============================================================================
+/**
+ * DBC 费用模式
+ */
+export var DbcBaseFeeMode;
+(function (DbcBaseFeeMode) {
+    DbcBaseFeeMode[DbcBaseFeeMode["FeeSchedulerLinear"] = 0] = "FeeSchedulerLinear";
+    DbcBaseFeeMode[DbcBaseFeeMode["FeeSchedulerExponential"] = 1] = "FeeSchedulerExponential";
+    DbcBaseFeeMode[DbcBaseFeeMode["RateLimiter"] = 2] = "RateLimiter";
+})(DbcBaseFeeMode || (DbcBaseFeeMode = {}));
+/**
+ * DBC 费用收取模式
+ */
+export var DbcCollectFeeMode;
+(function (DbcCollectFeeMode) {
+    DbcCollectFeeMode[DbcCollectFeeMode["QuoteToken"] = 0] = "QuoteToken";
+    DbcCollectFeeMode[DbcCollectFeeMode["OutputToken"] = 1] = "OutputToken";
+})(DbcCollectFeeMode || (DbcCollectFeeMode = {}));
+/**
+ * DBC 代币更新权限
+ */
+export var DbcTokenUpdateAuthority;
+(function (DbcTokenUpdateAuthority) {
+    DbcTokenUpdateAuthority[DbcTokenUpdateAuthority["CreatorUpdateAuthority"] = 0] = "CreatorUpdateAuthority";
+    DbcTokenUpdateAuthority[DbcTokenUpdateAuthority["Immutable"] = 1] = "Immutable";
+    DbcTokenUpdateAuthority[DbcTokenUpdateAuthority["PartnerUpdateAuthority"] = 2] = "PartnerUpdateAuthority";
+    DbcTokenUpdateAuthority[DbcTokenUpdateAuthority["CreatorUpdateAndMintAuthority"] = 3] = "CreatorUpdateAndMintAuthority";
+    DbcTokenUpdateAuthority[DbcTokenUpdateAuthority["PartnerUpdateAndMintAuthority"] = 4] = "PartnerUpdateAndMintAuthority";
+})(DbcTokenUpdateAuthority || (DbcTokenUpdateAuthority = {}));
+// ============================================================================
+// 常量
+// ============================================================================
+/**
+ * Meteora Program IDs
+ */
+export const METEORA_PROGRAM_IDS = {
+    /** DLMM Program */
+    DLMM: 'LBUZKhRxPF3XUpBCjp4YzTKgLccjZhTSDM9YuVaPwxo',
+    /** Dynamic Bonding Curve Program */
+    DBC: 'dbcij3LWUppWqq96dh6gJWwBifmcGfLSB5D4DuSMaqN',
+    /** DAMM v1 Program */
+    DAMM_V1: 'Eo7WjKq67rjJQSZxS6z3YkapzY3eMj6Xy8X5EQVn5UaB',
+    /** DAMM v2 (CP-AMM) Program */
+    DAMM_V2: 'cpamdpZCGKUy5JxQXB4dcpGPiikHawvSWAd6mEn1sGG',
+};
+/**
+ * DBC DAMM V1 迁移费用配置地址
+ */
+export const DBC_DAMM_V1_MIGRATION_FEE_ADDRESS = {
+    [DbcMigrationFeeOption.FixedBps25]: '8f848CEy8eY6PhJ3VcemtBDzPPSD4Vq7aJczLZ3o8MmX',
+    [DbcMigrationFeeOption.FixedBps30]: 'HBxB8Lf14Yj8pqeJ8C4qDb5ryHL7xwpuykz31BLNYr7S',
+    [DbcMigrationFeeOption.FixedBps100]: '7v5vBdUQHTNeqk1HnduiXcgbvCyVEZ612HLmYkQoAkik',
+    [DbcMigrationFeeOption.FixedBps200]: 'EkvP7d5yKxovj884d2DwmBQbrHUWRLGK6bympzrkXGja',
+    [DbcMigrationFeeOption.FixedBps400]: '9EZYAJrcqNWNQzP2trzZesP7XKMHA1jEomHzbRsdX8R2',
+    [DbcMigrationFeeOption.FixedBps600]: '8cdKo87jZU2R12KY1BUjjRPwyjgdNjLGqSGQyrDshhud',
+};
+/**
+ * DBC DAMM V2 迁移费用配置地址
+ */
+export const DBC_DAMM_V2_MIGRATION_FEE_ADDRESS = {
+    [DbcMigrationFeeOption.FixedBps25]: '7F6dnUcRuyM2TwR8myT1dYypFXpPSxqwKNSFNkxyNESd',
+    [DbcMigrationFeeOption.FixedBps30]: '2nHK1kju6XjphBLbNxpM5XRGFj7p9U8vvNzyZiha1z6k',
+    [DbcMigrationFeeOption.FixedBps100]: 'Hv8Lmzmnju6m7kcokVKvwqz7QPmdX9XfKjJsXz8RXcjp',
+    [DbcMigrationFeeOption.FixedBps200]: '2c4cYd4reUYVRAB9kUUkrq55VPyy2FNQ3FDL4o12JXmq',
+    [DbcMigrationFeeOption.FixedBps400]: 'AkmQWebAwFvWk55wBoCr5D62C6VVDTzi84NJuD9H7cFD',
+    [DbcMigrationFeeOption.FixedBps600]: 'DbCRBj8McvPYHJG1ukj8RE15h2dCNUdTAESG49XpQ44u',
+    [DbcMigrationFeeOption.Customizable]: 'A8gMrEPJkacWkcb3DGwtJwTe16HktSEfvwtuDh2MCtck',
+};

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

@@ -0,0 +1,10 @@
+/**
+ * Orca 模块导出
+ * 包含 Whirlpool (流动性池) 和 Wavebreak (代币发射平台)
+ */
+export * from './types.js';
+export { createOrcaContext, createOrcaClient, getOrcaPoolInfo, findOrcaPool, signOrcaSwap, signOrcaAddLiquidity, signOrcaRemoveLiquidity, signOrcaCreatePool, signOrcaCollectFees, getOrcaPositionInfo, getFullRangeTickIndices, getTickIndicesFromPriceRange, } from './orca.js';
+export { signOrcaBundleBuy, signOrcaBundleSell, signOrcaBundleSwap, toOrcaBundleApiRequest, batchGetOrcaPoolInfo, } from './orca-bundle.js';
+export * from './wavebreak-types.js';
+export { getWavebreakBondingCurveAddress, getWavebreakBondingCurveAddressSync, getWavebreakQuoteVaultAddressSync, getWavebreakLpEscrowAddressSync, getWavebreakBondingCurveInfo, getWavebreakBuyQuote, getWavebreakSellQuote, signWavebreakBuy, signWavebreakSell, signWavebreakCreateLaunch, buildWavebreakBuyInstruction, buildWavebreakSellInstruction, buildWavebreakCreateLaunchInstruction, toWavebreakApiRequest, } from './wavebreak.js';
+export { signWavebreakBundleBuy, signWavebreakBundleSell, signWavebreakBundleCreateAndBuy, toWavebreakBundleApiRequest, } from './wavebreak-bundle.js';

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

@@ -0,0 +1,16 @@
+/**
+ * Orca 模块导出
+ * 包含 Whirlpool (流动性池) 和 Wavebreak (代币发射平台)
+ */
+// ===== Whirlpool 类型 =====
+export * from './types.js';
+// ===== Whirlpool 核心功能 =====
+export { createOrcaContext, createOrcaClient, getOrcaPoolInfo, findOrcaPool, signOrcaSwap, signOrcaAddLiquidity, signOrcaRemoveLiquidity, signOrcaCreatePool, signOrcaCollectFees, getOrcaPositionInfo, getFullRangeTickIndices, getTickIndicesFromPriceRange, } from './orca.js';
+// ===== Whirlpool Bundle 批量交易 =====
+export { signOrcaBundleBuy, signOrcaBundleSell, signOrcaBundleSwap, toOrcaBundleApiRequest, batchGetOrcaPoolInfo, } from './orca-bundle.js';
+// ===== Wavebreak 类型 =====
+export * from './wavebreak-types.js';
+// ===== Wavebreak 核心功能 =====
+export { getWavebreakBondingCurveAddress, getWavebreakBondingCurveAddressSync, getWavebreakQuoteVaultAddressSync, getWavebreakLpEscrowAddressSync, getWavebreakBondingCurveInfo, getWavebreakBuyQuote, getWavebreakSellQuote, signWavebreakBuy, signWavebreakSell, signWavebreakCreateLaunch, buildWavebreakBuyInstruction, buildWavebreakSellInstruction, buildWavebreakCreateLaunchInstruction, toWavebreakApiRequest, } from './wavebreak.js';
+// ===== Wavebreak Bundle 批量交易 =====
+export { signWavebreakBundleBuy, signWavebreakBundleSell, signWavebreakBundleCreateAndBuy, toWavebreakBundleApiRequest, } from './wavebreak-bundle.js';

package/dist/sol/dex/orca/orca-bundle.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Orca Whirlpool Jito Bundle 批量交易
+ * 支持批量买卖的原子性交易
+ */
+import { Connection } from '@solana/web3.js';
+import type { OrcaBundleSwapParams, OrcaBundleSignedResult } from './types.js';
+/**
+ * 签名 Orca Bundle 批量买入交易
+ * 多个钱包同时买入同一个代币
+ */
+export declare function signOrcaBundleBuy(params: OrcaBundleSwapParams, connection?: Connection): Promise<OrcaBundleSignedResult>;
+/**
+ * 签名 Orca Bundle 批量卖出交易
+ * 多个钱包同时卖出同一个代币
+ */
+export declare function signOrcaBundleSell(params: OrcaBundleSwapParams, connection?: Connection): Promise<OrcaBundleSignedResult>;
+/**
+ * 签名 Orca Bundle 批量 Swap 交易 (通用)
+ * 支持买入和卖出
+ */
+export declare function signOrcaBundleSwap(params: OrcaBundleSwapParams, connection?: Connection): Promise<OrcaBundleSignedResult>;
+/**
+ * 将 Orca Bundle 结果转换为后端 API 请求格式
+ */
+export declare function toOrcaBundleApiRequest(result: OrcaBundleSignedResult): {
+    transactions: string[];
+    metadata: {
+        type: string;
+        poolAddress: string;
+        tradeCount: number;
+        jitoTipLamports: number;
+    };
+};
+/**
+ * 批量获取多个池的信息
+ */
+export declare function batchGetOrcaPoolInfo(poolAddresses: string[], connection?: Connection): Promise<Map<string, {
+    tokenMintA: string;
+    tokenMintB: string;
+    tickSpacing: number;
+}>>;

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

@@ -0,0 +1,173 @@
+/**
+ * Orca Whirlpool Jito Bundle 批量交易
+ * 支持批量买卖的原子性交易
+ */
+import { PublicKey, Keypair, Transaction, ComputeBudgetProgram, } from '@solana/web3.js';
+import { WhirlpoolContext, buildWhirlpoolClient, ORCA_WHIRLPOOL_PROGRAM_ID, swapQuoteByInputToken, TokenExtensionUtil, } from '@orca-so/whirlpools-sdk';
+import { Percentage } from '@orca-so/common-sdk';
+/**
+ * 从 Keypair 创建 Wallet 适配器（兼容浏览器环境）
+ */
+function createWalletFromKeypair(keypair) {
+    return {
+        publicKey: keypair.publicKey,
+        signTransaction: async (tx) => {
+            if (tx instanceof Transaction) {
+                tx.partialSign(keypair);
+            }
+            else {
+                tx.sign([keypair]);
+            }
+            return tx;
+        },
+        signAllTransactions: async (txs) => {
+            for (const tx of txs) {
+                if (tx instanceof Transaction) {
+                    tx.partialSign(keypair);
+                }
+                else {
+                    tx.sign([keypair]);
+                }
+            }
+            return txs;
+        },
+    };
+}
+// 不再导入 createConnection，强制使用者传入连接
+import { buildTipInstruction, getRandomTipAccount } from '../../jito/tip.js';
+/**
+ * 默认 Jito 小费 (0.001 SOL)
+ */
+const DEFAULT_JITO_TIP_LAMPORTS = 1000000;
+/**
+ * 签名 Orca Bundle 批量买入交易
+ * 多个钱包同时买入同一个代币
+ */
+export async function signOrcaBundleBuy(params, connection) {
+    return signOrcaBundleSwap(params, connection);
+}
+/**
+ * 签名 Orca Bundle 批量卖出交易
+ * 多个钱包同时卖出同一个代币
+ */
+export async function signOrcaBundleSell(params, connection) {
+    return signOrcaBundleSwap(params, connection);
+}
+/**
+ * 签名 Orca Bundle 批量 Swap 交易 (通用)
+ * 支持买入和卖出
+ */
+export async function signOrcaBundleSwap(params, connection) {
+    if (!connection) {
+        throw new Error('Connection is required. Please pass a connection created with user-configured RPC.');
+    }
+    const conn = connection;
+    const { blockhash, lastValidBlockHeight } = await conn.getLatestBlockhash();
+    const signedTransactions = [];
+    const jitoTipLamports = params.jitoTipLamports || DEFAULT_JITO_TIP_LAMPORTS;
+    // 预加载池信息 (只加载一次)
+    const firstWallet = params.trades[0].wallet;
+    const ctx = WhirlpoolContext.from(conn, createWalletFromKeypair(firstWallet));
+    const client = buildWhirlpoolClient(ctx);
+    const pool = await client.getPool(params.poolAddress);
+    const tokenInfoA = pool.getTokenAInfo();
+    const tokenInfoB = pool.getTokenBInfo();
+    // 获取 token extension context
+    const tokenExtensionCtx = await TokenExtensionUtil.buildTokenExtensionContextForPool(ctx.fetcher, tokenInfoA.mint, tokenInfoB.mint);
+    // 为每个交易创建签名
+    for (let i = 0; i < params.trades.length; i++) {
+        const trade = params.trades[i];
+        const isLastTrade = i === params.trades.length - 1;
+        // 创建该钱包的 context
+        const walletCtx = WhirlpoolContext.from(conn, createWalletFromKeypair(trade.wallet));
+        const walletClient = buildWhirlpoolClient(walletCtx);
+        const walletPool = await walletClient.getPool(params.poolAddress);
+        // 获取报价
+        const slippage = Percentage.fromFraction(100, 10000); // 1% 滑点
+        const quote = await swapQuoteByInputToken(walletPool, new PublicKey(params.inputMint), trade.amountIn, slippage, ORCA_WHIRLPOOL_PROGRAM_ID, walletCtx.fetcher);
+        // 构建交易
+        const tx = new Transaction();
+        // 添加计算预算指令
+        tx.add(ComputeBudgetProgram.setComputeUnitLimit({ units: 400000 }), ComputeBudgetProgram.setComputeUnitPrice({ microLamports: 100000 }));
+        // 获取 swap 交易
+        const swapTxBuilder = await walletPool.swap(quote, trade.wallet.publicKey);
+        const swapTx = await swapTxBuilder.build();
+        // 提取指令
+        if ('instructions' in swapTx.transaction) {
+            const swapTransaction = swapTx.transaction;
+            tx.add(...swapTransaction.instructions);
+        }
+        else {
+            throw new Error('VersionedTransaction not supported in bundle mode');
+        }
+        // 最后一笔交易添加 Jito 小费
+        if (isLastTrade) {
+            const tipAccount = getRandomTipAccount();
+            const tipIx = buildTipInstruction(trade.wallet.publicKey, BigInt(jitoTipLamports), tipAccount);
+            tx.add(tipIx);
+        }
+        // 设置交易参数
+        tx.recentBlockhash = blockhash;
+        tx.lastValidBlockHeight = lastValidBlockHeight;
+        tx.feePayer = trade.wallet.publicKey;
+        // 签名
+        tx.sign(trade.wallet, ...swapTx.signers);
+        signedTransactions.push(tx);
+    }
+    return {
+        signedTransactions,
+        type: 'bundleSwap',
+        poolAddress: params.poolAddress,
+        tradeCount: params.trades.length,
+        jitoTipLamports,
+    };
+}
+/**
+ * 将 Orca Bundle 结果转换为后端 API 请求格式
+ */
+export function toOrcaBundleApiRequest(result) {
+    const transactions = result.signedTransactions.map(tx => {
+        if (tx instanceof Transaction) {
+            return Buffer.from(tx.serialize()).toString('base64');
+        }
+        // VersionedTransaction
+        return Buffer.from(tx.serialize()).toString('base64');
+    });
+    return {
+        transactions,
+        metadata: {
+            type: result.type,
+            poolAddress: result.poolAddress,
+            tradeCount: result.tradeCount,
+            jitoTipLamports: result.jitoTipLamports,
+        },
+    };
+}
+/**
+ * 批量获取多个池的信息
+ */
+export async function batchGetOrcaPoolInfo(poolAddresses, connection) {
+    if (!connection) {
+        throw new Error('Connection is required. Please pass a connection created with user-configured RPC.');
+    }
+    const conn = connection;
+    const result = new Map();
+    // 创建一个临时钱包用于查询
+    const tempWallet = Keypair.generate();
+    const ctx = WhirlpoolContext.from(conn, createWalletFromKeypair(tempWallet));
+    const client = buildWhirlpoolClient(ctx);
+    // 批量获取池信息
+    const pools = await client.getPools(poolAddresses);
+    for (const pool of pools) {
+        const address = pool.getAddress().toBase58();
+        const tokenInfoA = pool.getTokenAInfo();
+        const tokenInfoB = pool.getTokenBInfo();
+        const data = pool.getData();
+        result.set(address, {
+            tokenMintA: tokenInfoA.mint.toBase58(),
+            tokenMintB: tokenInfoB.mint.toBase58(),
+            tickSpacing: data.tickSpacing,
+        });
+    }
+    return result;
+}

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

@@ -0,0 +1,65 @@
+/**
+ * Orca Whirlpool 核心功能
+ * 提供 Swap、LP 添加/移除等功能
+ *
+ * 基于 @orca-so/whirlpools-sdk (Legacy SDK)
+ * 文档: https://dev.orca.so/SDKs/Overview
+ */
+import { Connection, Keypair } from '@solana/web3.js';
+import { WhirlpoolContext, type WhirlpoolClient } from '@orca-so/whirlpools-sdk';
+import type { OrcaPoolInfo, OrcaSwapParams, OrcaAddLiquidityParams, OrcaRemoveLiquidityParams, OrcaPositionInfo, OrcaCreatePoolParams, OrcaSignedResult } from './types.js';
+/**
+ * 创建 Orca Whirlpool Context
+ */
+export declare function createOrcaContext(connection?: Connection, wallet?: Keypair): Promise<WhirlpoolContext>;
+/**
+ * 创建 Orca Whirlpool Client
+ */
+export declare function createOrcaClient(connection?: Connection, wallet?: Keypair): Promise<WhirlpoolClient>;
+/**
+ * 获取 Orca Whirlpool 池信息
+ */
+export declare function getOrcaPoolInfo(poolAddress: string, connection?: Connection): Promise<OrcaPoolInfo>;
+/**
+ * 查找 Orca Whirlpool 池
+ */
+export declare function findOrcaPool(tokenMintA: string, tokenMintB: string, tickSpacing?: number, connection?: Connection): Promise<string | null>;
+/**
+ * 签名 Orca Swap 交易
+ * 使用 Whirlpool 的高级 swap 接口
+ */
+export declare function signOrcaSwap(params: OrcaSwapParams, payer: Keypair, connection?: Connection): Promise<OrcaSignedResult>;
+/**
+ * 签名 Orca 添加流动性交易
+ */
+export declare function signOrcaAddLiquidity(params: OrcaAddLiquidityParams, payer: Keypair, connection?: Connection): Promise<OrcaSignedResult>;
+/**
+ * 签名 Orca 移除流动性交易
+ */
+export declare function signOrcaRemoveLiquidity(params: OrcaRemoveLiquidityParams, payer: Keypair, connection?: Connection): Promise<OrcaSignedResult>;
+/**
+ * 签名创建 Orca Whirlpool 池交易
+ */
+export declare function signOrcaCreatePool(params: OrcaCreatePoolParams, payer: Keypair, connection?: Connection): Promise<OrcaSignedResult>;
+/**
+ * 签名收集费用交易
+ */
+export declare function signOrcaCollectFees(positionAddress: string, payer: Keypair, connection?: Connection): Promise<OrcaSignedResult>;
+/**
+ * 获取 Position 信息
+ */
+export declare function getOrcaPositionInfo(positionAddress: string, connection?: Connection): Promise<OrcaPositionInfo>;
+/**
+ * 计算全范围流动性的 tick 范围
+ */
+export declare function getFullRangeTickIndices(tickSpacing: number): {
+    tickLower: number;
+    tickUpper: number;
+};
+/**
+ * 根据价格范围计算 tick 范围
+ */
+export declare function getTickIndicesFromPriceRange(priceLower: number, priceUpper: number, decimalsA: number, decimalsB: number, tickSpacing: number): {
+    tickLower: number;
+    tickUpper: number;
+};