four-flap-meme-sdk 1.3.93 → 1.3.94

package/dist/pancake/bundle-swap.js

@@ -99,10 +99,9 @@ async function buildSwapTransactions({ routeParams, sellAmountWei, buyAmountBNB,
     );
     return { sellUnsigned, buyUnsigned };
 }
-async function calculateBuyerBudget({ buyer, quotedBNBOut, reserveGasBNB, useNativeToken = true, quoteToken, quoteTokenDecimals = 18, provider }) {
+async function calculateBuyerBudget({ buyer, quotedBNBOut, reserveGasBNB, slippageTolerance, useNativeToken = true, quoteToken, quoteTokenDecimals = 18, provider }) {
     const reserveGas = ethers.parseEther((reserveGasBNB ?? 0.0005).toString());
-    // ✅ 已移除滑点保护：直接使用报价金额
-    const buyAmountBNB = quotedBNBOut;
+    const buyAmountBNB = applySlippage(quotedBNBOut, slippageTolerance);
     // ✅ 根据是否使用原生代币获取不同的余额
     let buyerBalance;
     if (useNativeToken) {
@@ -129,46 +128,31 @@ async function calculateBuyerBudget({ buyer, quotedBNBOut, reserveGasBNB, useNat
         return { buyerBalance, reserveGas, requiredBalance, buyAmountBNB, useNativeToken };
     }
 }
-/**
- * ✅ 规划 nonce
- * 交易顺序：贿赂 → 授权 → 卖出 → 买入 → 利润
- * 贿赂和利润由卖方发送
- */
-async function planNonces({ seller, buyer, sameAddress, approvalExists, profitNeeded, needBribeTx, nonceManager }) {
+function applySlippage(amount, tolerancePercent = 0.5) {
+    if (amount === 0n) {
+        return 0n;
+    }
+    const bps = BigInt(Math.round(Math.max(0, tolerancePercent) * 100));
+    return (amount * (10000n + bps)) / 10000n;
+}
+async function planNonces({ seller, buyer, sameAddress, approvalExists, profitNeeded, nonceManager }) {
     if (sameAddress) {
-        // 同一地址：贿赂(可选) + 授权(可选) + 卖出 + 买入 + 利润(可选)
-        const txCount = countTruthy([needBribeTx, approvalExists, true, true, profitNeeded]);
+        const txCount = countTruthy([approvalExists, true, true, profitNeeded]);
         const nonces = await nonceManager.getNextNonceBatch(buyer, txCount);
         let idx = 0;
-        const bribeNonce = needBribeTx ? nonces[idx++] : undefined;
         if (approvalExists)
             idx++;
-        const sellerNonce = nonces[idx++];
         const buyerNonce = nonces[idx++];
+        const sellerNonce = nonces[idx++];
         const profitNonce = profitNeeded ? nonces[idx] : undefined;
-        return { sellerNonce, buyerNonce, bribeNonce, profitNonce };
+        return { sellerNonce, buyerNonce, profitNonce };
     }
-    if (needBribeTx || approvalExists || profitNeeded) {
-        // 卖方需要多个 nonce：贿赂(可选) + 授权(可选) + 卖出 + 利润(可选)
-        const sellerTxCount = countTruthy([needBribeTx, approvalExists, true, profitNeeded]);
-        // ✅ 并行获取 seller 和 buyer 的 nonce
-        const [sellerNonces, buyerNonce] = await Promise.all([
-            nonceManager.getNextNonceBatch(seller, sellerTxCount),
-            nonceManager.getNextNonce(buyer)
-        ]);
-        let idx = 0;
-        const bribeNonce = needBribeTx ? sellerNonces[idx++] : undefined;
-        if (approvalExists)
-            idx++;
-        const sellerNonce = sellerNonces[idx++];
-        const profitNonce = profitNeeded ? sellerNonces[idx] : undefined;
-        return { sellerNonce, buyerNonce, bribeNonce, profitNonce };
+    const sellerNonce = await nonceManager.getNextNonce(seller);
+    if (profitNeeded) {
+        const [buyerNonce, profitNonce] = await nonceManager.getNextNonceBatch(buyer, 2);
+        return { sellerNonce, buyerNonce, profitNonce };
     }
-    // ✅ 并行获取 seller 和 buyer 的 nonce
-    const [sellerNonce, buyerNonce] = await Promise.all([
-        nonceManager.getNextNonce(seller),
-        nonceManager.getNextNonce(buyer)
-    ]);
+    const buyerNonce = await nonceManager.getNextNonce(buyer);
     return { sellerNonce, buyerNonce };
 }
 async function buildProfitTransaction({ wallet, profitAmount, profitNonce, gasPrice, chainId, txType }) {
@@ -240,9 +224,6 @@ import { ethers, Contract, Wallet } from 'ethers';
 import { calculateSellAmount } from '../utils/swap-helpers.js';
 import { NonceManager } from '../utils/bundle-helpers.js';
 import { ADDRESSES, PROFIT_CONFIG } from '../utils/constants.js';
-// ✅ BlockRazor Builder EOA 地址（用于贿赂）
-// 参考文档: https://blockrazor.gitbook.io/blockrazor/bsc/block-builder/send-bundle
-const BLOCKRAZOR_BUILDER_EOA = '0x1266C6bE60392A8Ff346E8d5ECCd3E69dD9c5F20';
 /**
  * 获取 Gas Limit
  */
@@ -304,7 +285,7 @@ const ERC20_BALANCE_OF_ABI = ['function balanceOf(address) view returns (uint256
  * ✅ 支持 quoteToken：传入 USDT 等地址时，卖出得到该代币，买入使用该代币
  */
 export async function pancakeBundleSwapMerkle(params) {
-    const { sellerPrivateKey, sellAmount, sellPercentage, buyerPrivateKey, tokenAddress, routeParams, config, quoteToken, quoteTokenDecimals = 18 } = params;
+    const { sellerPrivateKey, sellAmount, sellPercentage, buyerPrivateKey, tokenAddress, routeParams, slippageTolerance = 0.5, config, quoteToken, quoteTokenDecimals = 18 } = params;
     // ✅ 判断是否使用原生代币（BNB）或 ERC20 代币（如 USDT）
     const useNativeToken = !quoteToken || quoteToken === ZERO_ADDRESS;
     const context = createPancakeContext(config);
@@ -338,6 +319,7 @@ export async function pancakeBundleSwapMerkle(params) {
         buyer,
         quotedBNBOut: quoteResult.estimatedBNBOut,
         reserveGasBNB: config.reserveGasBNB,
+        slippageTolerance,
         useNativeToken,
         quoteToken,
         quoteTokenDecimals,
@@ -353,11 +335,6 @@ export async function pancakeBundleSwapMerkle(params) {
         useNativeToken
     });
     const profitAmount = calculateProfitAmount(quoteResult.estimatedBNBOut);
-    // ✅ 获取贿赂金额
-    const bribeAmount = config.bribeAmount && config.bribeAmount > 0
-        ? ethers.parseEther(String(config.bribeAmount))
-        : 0n;
-    const needBribeTx = bribeAmount > 0n;
     // ✅ 使用共享的 NonceManager 规划 nonce（授权已消耗一个 nonce）
     const noncePlan = await planNonces({
         seller,
@@ -365,22 +342,8 @@ export async function pancakeBundleSwapMerkle(params) {
         sameAddress,
         approvalExists: !!approvalTx,
         profitNeeded: profitAmount > 0n,
-        needBribeTx, // ✅ 新增
         nonceManager
     });
-    // ✅ 贿赂交易放在首位（由卖方发送，与利润交易同一钱包）
-    let bribeTx = null;
-    if (needBribeTx && noncePlan.bribeNonce !== undefined) {
-        bribeTx = await seller.signTransaction({
-            to: BLOCKRAZOR_BUILDER_EOA,
-            value: bribeAmount,
-            nonce: noncePlan.bribeNonce,
-            gasPrice,
-            gasLimit: 21000n,
-            chainId: context.chainId,
-            type: txType
-        });
-    }
     const signedSell = await seller.signTransaction({
         ...swapUnsigned.sellUnsigned,
         from: seller.address,
@@ -399,9 +362,8 @@ export async function pancakeBundleSwapMerkle(params) {
         chainId: context.chainId,
         type: txType
     });
-    // ✅ 利润交易放在末尾（由卖方发送，与贿赂交易同一钱包）
     const profitTx = await buildProfitTransaction({
-        wallet: seller, // ✅ 改为卖方发送（与贿赂交易一致）
+        wallet: buyer,
         profitAmount,
         profitNonce: noncePlan.profitNonce,
         gasPrice,
@@ -421,10 +383,7 @@ export async function pancakeBundleSwapMerkle(params) {
         provider: context.provider,
         buyerAddress: buyer.address
     });
-    // ✅ 组装顺序：贿赂 → 授权 → 卖出 → 买入 → 利润
     const signedTransactions = [];
-    if (bribeTx)
-        signedTransactions.push(bribeTx);
     if (approvalTx)
         signedTransactions.push(approvalTx);
     signedTransactions.push(signedSell, signedBuy);
@@ -453,7 +412,7 @@ export async function pancakeBundleSwapMerkle(params) {
  * 交易顺序：[授权(可选)] → [卖出] → [买入1, 买入2, ..., 买入N] → [利润]
  */
 export async function pancakeBatchSwapMerkle(params) {
-    const { sellerPrivateKey, sellAmount, sellPercentage, buyerPrivateKeys, buyerAmounts, tokenAddress, routeParams, config, quoteToken, quoteTokenDecimals = 18 } = params;
+    const { sellerPrivateKey, sellAmount, sellPercentage, buyerPrivateKeys, buyerAmounts, tokenAddress, routeParams, slippageTolerance = 0.5, config, quoteToken, quoteTokenDecimals = 18 } = params;
     // ✅ 校验买方数量（最多 24 个）
     const MAX_BUYERS = 24;
     if (buyerPrivateKeys.length === 0) {
@@ -492,9 +451,9 @@ export async function pancakeBatchSwapMerkle(params) {
         provider: context.provider
     });
     const estimatedBNBOut = quoteResult.estimatedBNBOut;
-    // ✅ 计算每个买方的买入金额（已移除滑点保护：直接使用报价金额）
+    // ✅ 计算每个买方的买入金额
     let buyAmountsWei;
-    const totalBuyAmount = estimatedBNBOut;
+    const totalBuyAmount = applySlippage(estimatedBNBOut, slippageTolerance);
     if (buyerAmounts && buyerAmounts.length === buyers.length) {
         // 方式1：使用指定的买入金额（USDT）
         buyAmountsWei = buyerAmounts.map(amt => useNativeToken
@@ -572,41 +531,19 @@ export async function pancakeBatchSwapMerkle(params) {
             return await proxyBuyer.swapV3MultiHop.populateTransaction(v3LpAddresses, exactTokenOut, buyAmount, 0n, buyer.address, { value: buyValue });
         }
     }));
-    // ✅ 获取贿赂金额
-    const bribeAmount = config.bribeAmount && config.bribeAmount > 0
-        ? ethers.parseEther(String(config.bribeAmount))
-        : 0n;
-    // ✅ 规划 Nonce（贿赂和利润都由卖方发送）
-    // 卖方: [贿赂(可选)] → [授权(可选)] → [卖出] → [利润(可选)]
-    let bribeNonce;
-    let sellNonceOffset = 0;
-    if (bribeAmount > 0n) {
-        bribeNonce = await nonceManager.getNextNonce(seller);
-        sellNonceOffset = 1; // 卖出交易 nonce 需要偏移
-    }
+    // ✅ 规划 Nonce（并行获取所有钱包的 nonce）
+    // 卖方: [授权(可选)] → [卖出]
     const sellNonce = await nonceManager.getNextNonce(seller);
     // ✅ 并行获取所有买方的 nonce
     const buyerNonces = await Promise.all(buyers.map(buyer => nonceManager.getNextNonce(buyer)));
-    // ✅ 贿赂交易放在首位（由卖方发送）
-    let bribeTx = null;
-    if (bribeAmount > 0n && bribeNonce !== undefined) {
-        bribeTx = await seller.signTransaction({
-            to: BLOCKRAZOR_BUILDER_EOA,
-            value: bribeAmount,
-            nonce: bribeNonce,
-            gasPrice,
-            gasLimit: 21000n,
-            chainId: context.chainId,
-            type: txType
-        });
-    }
-    // 利润交易放在末尾（由卖方发送，与贿赂交易一致）
+    // 利润交易：从第一个买方发送
     const profitAmount = calculateProfitAmount(estimatedBNBOut);
     let profitTx = null;
     if (profitAmount > 0n) {
-        // ✅ 利润由卖方发送（与贿赂交易同一钱包）
-        const profitNonce = await nonceManager.getNextNonce(seller);
-        profitTx = await seller.signTransaction({
+        // 选择第一个买方作为利润支付者
+        const profitPayer = buyers[0];
+        const profitNonce = await nonceManager.getNextNonce(profitPayer);
+        profitTx = await profitPayer.signTransaction({
             to: PROFIT_CONFIG.RECIPIENT,
             value: profitAmount,
             nonce: profitNonce,
@@ -643,16 +580,14 @@ export async function pancakeBatchSwapMerkle(params) {
         signedSellPromise,
         ...signedBuyPromises
     ]);
-    // 4. 按顺序组装交易数组：贿赂 → 授权 → 卖出 → 买入 → 利润
+    // 4. 按顺序组装交易数组
     const signedTransactions = [];
-    if (bribeTx)
-        signedTransactions.push(bribeTx); // 贿赂（首位）
     if (approvalTx)
         signedTransactions.push(approvalTx); // 授权（如果有）
     signedTransactions.push(signedSell); // 卖出
     signedTransactions.push(...signedBuys); // 多个买入
     if (profitTx)
-        signedTransactions.push(profitTx); // 利润（末尾）
+        signedTransactions.push(profitTx); // 利润（最后）
     return {
         signedTransactions,
         metadata: {

package/dist/sol/constants.d.ts

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

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;