four-flap-meme-sdk 1.3.87 → 1.3.88

package/dist/sol/constants.d.ts

@@ -3,22 +3,12 @@
  * @module sol/constants
  */
 /**
- * RPC 节点配置
- * 使用 Helius 主网（开发和生产都用主网）
- */
-export declare const SOLANA_RPC: {
-    /** Helius 主网 RPC（需要替换 API Key） */
-    readonly MAINNET: "https://mainnet.helius-rpc.com/?api-key=YOUR_HELIUS_KEY";
-    /** 公共主网 RPC（备用，有限速） */
-    readonly MAINNET_PUBLIC: "https://api.mainnet-beta.solana.com";
-};
-/**
- * Jito Block Engine 配置
+ * Jito 配置
+ *
+ * 注意：BLOCK_ENGINE_URL 需要由前端传入，不在 SDK 中写死
  */
 export declare const JITO_CONFIG: {
-    /** Block Engine URL */
-    readonly BLOCK_ENGINE_URL: "https://mainnet.block-engine.jito.wtf";
-    /** Tip 账户列表（随机选择一个） */
+    /** Tip 账户列表（随机选择一个）- 这些是 Jito 官方账户，固定不变 */
     readonly TIP_ACCOUNTS: readonly ["96gYZGLnJYVFmbjzopPSU6QiEV5fGqZNyN9nmNhvrZU5", "HFqU5x63VTqvQss8hp11i4bVmkzdNaVB6PYjYgNd4W5U", "Cw8CFyM9FkoMi7K7Crf6HNQqf4uEMzpKw6QNghXLvLkY", "ADaUMid9yfUytqMBgopwjb2DTLSokTSzL1zt6iGPaS49", "DfXygSm4jCyNCybVYYK6DwvWqjKee8pbDmJGcLWNDXjh", "ADuUkR4vqLUMWXxW9gh6D6L8pMSawimctcNZ5pGwDcEt", "DttWaMuVvTiduZRnguLF7jNxTgiMBZ1hyAumKUiL2KRL", "3AVi9Tg9Uo68tJfuvoKvqKNWKkC5wPdSSdeBnizKZ6jT"];
     /** 最小 Tip（lamports） */
     readonly MIN_TIP_LAMPORTS: 1000;

package/dist/sol/constants.js

@@ -2,25 +2,14 @@
  * Solana SDK 常量配置
  * @module sol/constants
  */
-// ==================== RPC 配置 ====================
-/**
- * RPC 节点配置
- * 使用 Helius 主网（开发和生产都用主网）
- */
-export const SOLANA_RPC = {
-    /** Helius 主网 RPC（需要替换 API Key） */
-    MAINNET: 'https://mainnet.helius-rpc.com/?api-key=YOUR_HELIUS_KEY',
-    /** 公共主网 RPC（备用，有限速） */
-    MAINNET_PUBLIC: 'https://api.mainnet-beta.solana.com',
-};
 // ==================== Jito Bundle 配置 ====================
 /**
- * Jito Block Engine 配置
+ * Jito 配置
+ *
+ * 注意：BLOCK_ENGINE_URL 需要由前端传入，不在 SDK 中写死
  */
 export const JITO_CONFIG = {
-    /** Block Engine URL */
-    BLOCK_ENGINE_URL: 'https://mainnet.block-engine.jito.wtf',
-    /** Tip 账户列表（随机选择一个） */
+    /** Tip 账户列表（随机选择一个）- 这些是 Jito 官方账户，固定不变 */
     TIP_ACCOUNTS: [
         '96gYZGLnJYVFmbjzopPSU6QiEV5fGqZNyN9nmNhvrZU5',
         'HFqU5x63VTqvQss8hp11i4bVmkzdNaVB6PYjYgNd4W5U',

package/dist/sol/dex/meteora/client.d.ts

@@ -7,8 +7,9 @@ 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;
 /**

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

@@ -4,7 +4,7 @@
  * 统一管理 RPC 连接和 SDK 实例，避免重复实例化
  */
 import { PublicKey } from '@solana/web3.js';
-import { createConnection } from '../../utils/connection.js';
+// 不再导入 createConnection，强制使用者传入连接
 // SDK 导入 - 使用类型断言绕过 TypeScript 类型检查
 import DLMMModule from '@meteora-ag/dlmm';
 import AmmImplModule from '@meteora-ag/dynamic-amm-sdk';
@@ -15,18 +15,19 @@ const AmmImpl = AmmImplModule;
 // ============================================================================
 // 连接管理
 // ============================================================================
-/** 默认连接实例 */
+/** 默认连接实例（必须通过 setDefaultConnection 设置） */
 let defaultConnection = null;
 /**
- * 获取或创建默认连接
+ * 获取连接
  * @param connection 可选的自定义连接
+ * @throws Error 如果没有传入连接且未设置默认连接
  */
 export function getConnection(connection) {
     if (connection) {
         return connection;
     }
     if (!defaultConnection) {
-        defaultConnection = createConnection();
+        throw new Error('Connection is required. Either pass a connection parameter or call setDefaultConnection() first with user-configured RPC.');
     }
     return defaultConnection;
 }

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

@@ -33,7 +33,7 @@ function createWalletFromKeypair(keypair) {
         },
     };
 }
-import { createConnection } from '../../utils/connection.js';
+// 不再导入 createConnection，强制使用者传入连接
 import { buildTipInstruction, getRandomTipAccount } from '../../jito/tip.js';
 /**
  * 默认 Jito 小费 (0.001 SOL)
@@ -58,7 +58,10 @@ export async function signOrcaBundleSell(params, connection) {
  * 支持买入和卖出
  */
 export async function signOrcaBundleSwap(params, connection) {
-    const conn = connection || createConnection();
+    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;
@@ -144,7 +147,10 @@ export function toOrcaBundleApiRequest(result) {
  * 批量获取多个池的信息
  */
 export async function batchGetOrcaPoolInfo(poolAddresses, connection) {
-    const conn = connection || createConnection();
+    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();

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

@@ -8,7 +8,6 @@
 import { PublicKey, Transaction, } from '@solana/web3.js';
 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';
 /**
  * 从 Keypair 创建 Wallet 适配器（兼容浏览器环境）
@@ -43,7 +42,10 @@ function createWalletFromKeypair(keypair) {
  * 创建 Orca Whirlpool Context
  */
 export async function createOrcaContext(connection, wallet) {
-    const conn = connection || createConnection();
+    if (!connection) {
+        throw new Error('Connection is required. Please pass a connection created with user-configured RPC.');
+    }
+    const conn = connection;
     // 创建 Wallet 适配器（不依赖 @coral-xyz/anchor 的 Wallet 类）
     const anchorWallet = wallet
         ? createWalletFromKeypair(wallet)
@@ -106,7 +108,10 @@ export async function getOrcaPoolInfo(poolAddress, connection) {
  * 查找 Orca Whirlpool 池
  */
 export async function findOrcaPool(tokenMintA, tokenMintB, tickSpacing = 64, connection) {
-    const conn = connection || createConnection();
+    if (!connection) {
+        throw new Error('Connection is required. Please pass a connection created with user-configured RPC.');
+    }
+    const conn = connection;
     // 确保代币顺序正确 (按地址排序)
     const [mintAAddr, mintBAddr] = PoolUtil.orderMints(new PublicKey(tokenMintA), new PublicKey(tokenMintB));
     // 转换为 PublicKey
@@ -123,7 +128,10 @@ export async function findOrcaPool(tokenMintA, tokenMintB, tickSpacing = 64, con
  * 使用 Whirlpool 的高级 swap 接口
  */
 export async function signOrcaSwap(params, payer, connection) {
-    const conn = connection || createConnection();
+    if (!connection) {
+        throw new Error('Connection is required. Please pass a connection created with user-configured RPC.');
+    }
+    const conn = connection;
     const client = await createOrcaClient(conn, payer);
     const pool = await client.getPool(params.poolAddress);
     const ctx = await createOrcaContext(conn, payer);
@@ -175,7 +183,10 @@ export async function signOrcaSwap(params, payer, connection) {
  * 签名 Orca 添加流动性交易
  */
 export async function signOrcaAddLiquidity(params, payer, connection) {
-    const conn = connection || createConnection();
+    if (!connection) {
+        throw new Error('Connection is required. Please pass a connection created with user-configured RPC.');
+    }
+    const conn = connection;
     const client = await createOrcaClient(conn, payer);
     const pool = await client.getPool(params.poolAddress);
     const ctx = await createOrcaContext(conn, payer);
@@ -263,7 +274,10 @@ export async function signOrcaAddLiquidity(params, payer, connection) {
  * 签名 Orca 移除流动性交易
  */
 export async function signOrcaRemoveLiquidity(params, payer, connection) {
-    const conn = connection || createConnection();
+    if (!connection) {
+        throw new Error('Connection is required. Please pass a connection created with user-configured RPC.');
+    }
+    const conn = connection;
     const client = await createOrcaClient(conn, payer);
     const ctx = await createOrcaContext(conn, payer);
     const position = await client.getPosition(params.positionAddress);
@@ -349,7 +363,10 @@ export async function signOrcaRemoveLiquidity(params, payer, connection) {
  * 签名创建 Orca Whirlpool 池交易
  */
 export async function signOrcaCreatePool(params, payer, connection) {
-    const conn = connection || createConnection();
+    if (!connection) {
+        throw new Error('Connection is required. Please pass a connection created with user-configured RPC.');
+    }
+    const conn = connection;
     const client = await createOrcaClient(conn, payer);
     const initialPrice = DecimalUtil.fromNumber(params.initialPrice);
     // 创建 Splash Pool (简化的全范围流动性池)
@@ -380,7 +397,10 @@ export async function signOrcaCreatePool(params, payer, connection) {
  * 签名收集费用交易
  */
 export async function signOrcaCollectFees(positionAddress, payer, connection) {
-    const conn = connection || createConnection();
+    if (!connection) {
+        throw new Error('Connection is required. Please pass a connection created with user-configured RPC.');
+    }
+    const conn = connection;
     const client = await createOrcaClient(conn, payer);
     const position = await client.getPosition(positionAddress);
     const positionData = position.getData();

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

@@ -3,7 +3,7 @@
  * 支持批量买卖的原子性交易
  */
 import { PublicKey, Keypair, Transaction, ComputeBudgetProgram, } from '@solana/web3.js';
-import { createConnection } from '../../utils/connection.js';
+// 不再导入 createConnection，强制使用者传入连接
 import { buildTipInstruction, getRandomTipAccount } from '../../jito/tip.js';
 import { buildWavebreakBuyInstruction, buildWavebreakSellInstruction, buildWavebreakCreateLaunchInstruction, getWavebreakBondingCurveInfo, } from './wavebreak.js';
 import { WAVEBREAK_CONSTANTS } from './wavebreak-types.js';
@@ -15,7 +15,10 @@ const DEFAULT_JITO_TIP_LAMPORTS = 1000000;
  * 签名 Wavebreak Bundle 批量买入交易
  */
 export async function signWavebreakBundleBuy(params, connection) {
-    const conn = connection || createConnection();
+    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();
     // 获取 Bonding Curve 信息
     const info = await getWavebreakBondingCurveInfo(params.bondingCurveOrMint, conn);
@@ -66,7 +69,10 @@ export async function signWavebreakBundleBuy(params, connection) {
  * 签名 Wavebreak Bundle 批量卖出交易
  */
 export async function signWavebreakBundleSell(params, connection) {
-    const conn = connection || createConnection();
+    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 info = await getWavebreakBondingCurveInfo(params.bondingCurveOrMint, conn);
     if (!info) {
@@ -112,7 +118,10 @@ export async function signWavebreakBundleSell(params, connection) {
  * 第一笔交易创建代币，后续交易批量买入
  */
 export async function signWavebreakBundleCreateAndBuy(params, connection) {
-    const conn = connection || createConnection();
+    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;

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

@@ -7,7 +7,6 @@
  */
 import { PublicKey, Keypair, Transaction, TransactionInstruction, SystemProgram, ComputeBudgetProgram, } from '@solana/web3.js';
 import { TOKEN_2022_PROGRAM_ID, TOKEN_PROGRAM_ID, getAssociatedTokenAddressSync, ASSOCIATED_TOKEN_PROGRAM_ID, } from '@solana/spl-token';
-import { createConnection } from '../../utils/connection.js';
 import { WAVEBREAK_CONSTANTS } from './wavebreak-types.js';
 // ============================================================================
 // Wavebreak SDK 导入（动态导入以避免类型冲突）
@@ -62,7 +61,10 @@ export function getWavebreakLpEscrowAddressSync(bondingCurve) {
  * 获取 Wavebreak Bonding Curve 信息
  */
 export async function getWavebreakBondingCurveInfo(bondingCurveOrMint, connection) {
-    const conn = connection || createConnection();
+    if (!connection) {
+        throw new Error('Connection is required. Please pass a connection created with user-configured RPC.');
+    }
+    const conn = connection;
     const sdk = await loadWavebreakSdk();
     // 判断是 Bonding Curve 地址还是 Mint 地址
     let bondingCurveAddress;
@@ -199,7 +201,10 @@ export async function getWavebreakSellQuote(bondingCurveOrMint, amountIn, connec
  * 使用 SDK 的编码器生成正确的指令数据
  */
 export async function buildWavebreakBuyInstruction(params, buyer, connection) {
-    const conn = connection || createConnection();
+    if (!connection) {
+        throw new Error('Connection is required. Please pass a connection created with user-configured RPC.');
+    }
+    const conn = connection;
     const sdk = await loadWavebreakSdk();
     const info = await getWavebreakBondingCurveInfo(params.bondingCurveOrMint, conn);
     if (!info) {
@@ -255,7 +260,10 @@ export async function buildWavebreakBuyInstruction(params, buyer, connection) {
  * 构建 Wavebreak 卖出交易指令
  */
 export async function buildWavebreakSellInstruction(params, seller, connection) {
-    const conn = connection || createConnection();
+    if (!connection) {
+        throw new Error('Connection is required. Please pass a connection created with user-configured RPC.');
+    }
+    const conn = connection;
     const sdk = await loadWavebreakSdk();
     const info = await getWavebreakBondingCurveInfo(params.bondingCurveOrMint, conn);
     if (!info) {
@@ -366,7 +374,10 @@ export async function buildWavebreakCreateLaunchInstruction(params, creator, bas
  * 签名 Wavebreak 买入交易
  */
 export async function signWavebreakBuy(params, payer, connection) {
-    const conn = connection || createConnection();
+    if (!connection) {
+        throw new Error('Connection is required. Please pass a connection created with user-configured RPC.');
+    }
+    const conn = connection;
     const info = await getWavebreakBondingCurveInfo(params.bondingCurveOrMint, conn);
     if (!info) {
         throw new Error('Bonding Curve 不存在');
@@ -396,7 +407,10 @@ export async function signWavebreakBuy(params, payer, connection) {
  * 签名 Wavebreak 卖出交易
  */
 export async function signWavebreakSell(params, payer, connection) {
-    const conn = connection || createConnection();
+    if (!connection) {
+        throw new Error('Connection is required. Please pass a connection created with user-configured RPC.');
+    }
+    const conn = connection;
     const info = await getWavebreakBondingCurveInfo(params.bondingCurveOrMint, conn);
     if (!info) {
         throw new Error('Bonding Curve 不存在');
@@ -426,7 +440,10 @@ export async function signWavebreakSell(params, payer, connection) {
  * 签名 Wavebreak 创建代币发射交易
  */
 export async function signWavebreakCreateLaunch(params, creator, connection) {
-    const conn = connection || createConnection();
+    if (!connection) {
+        throw new Error('Connection is required. Please pass a connection created with user-configured RPC.');
+    }
+    const conn = connection;
     const baseMintKeypair = Keypair.generate();
     const bondingCurve = getWavebreakBondingCurveAddressSync(baseMintKeypair.publicKey);
     const tx = new Transaction();

package/dist/sol/utils/connection.d.ts

@@ -5,10 +5,19 @@
 import { Connection, Commitment } from '@solana/web3.js';
 /**
  * 创建 Solana 连接
- * @param rpcUrl RPC URL（可选，默认使用 Helius 主网）
+ *
+ * 重要：必须传入用户选择的 RPC URL，SDK 不提供默认 RPC
+ * 前端应从 RPC 设置中获取用户配置的节点
+ *
+ * @param rpcUrl RPC URL（必填）
  * @param commitment Commitment 级别（可选，默认 confirmed）
+ *
+ * @example
+ * const connection = createConnection('https://user-selected-rpc.com')
+ *
+ * @throws Error 如果没有传入 rpcUrl
  */
-export declare function createConnection(rpcUrl?: string, commitment?: Commitment): Connection;
+export declare function createConnection(rpcUrl: string, commitment?: Commitment): Connection;
 /**
  * 获取账户 SOL 余额
  * @param connection Solana 连接

package/dist/sol/utils/connection.js

@@ -3,13 +3,25 @@
  * @module sol/utils/connection
  */
 import { Connection, PublicKey } from '@solana/web3.js';
-import { SOLANA_RPC, TX_CONFIG, lamportsToSol } from '../constants.js';
+import { TX_CONFIG, lamportsToSol } from '../constants.js';
 /**
  * 创建 Solana 连接
- * @param rpcUrl RPC URL（可选，默认使用 Helius 主网）
+ *
+ * 重要：必须传入用户选择的 RPC URL，SDK 不提供默认 RPC
+ * 前端应从 RPC 设置中获取用户配置的节点
+ *
+ * @param rpcUrl RPC URL（必填）
  * @param commitment Commitment 级别（可选，默认 confirmed）
+ *
+ * @example
+ * const connection = createConnection('https://user-selected-rpc.com')
+ *
+ * @throws Error 如果没有传入 rpcUrl
  */
-export function createConnection(rpcUrl = SOLANA_RPC.MAINNET, commitment = TX_CONFIG.DEFAULT_COMMITMENT) {
+export function createConnection(rpcUrl, commitment = TX_CONFIG.DEFAULT_COMMITMENT) {
+    if (!rpcUrl) {
+        throw new Error('RPC URL is required. Please pass the user-configured RPC URL from frontend settings.');
+    }
     return new Connection(rpcUrl, {
         commitment,
         confirmTransactionInitialTimeout: TX_CONFIG.CONFIRMATION_TIMEOUT,

package/dist/sol/utils/lp-inspect.js

@@ -371,6 +371,9 @@ async function detectRaydiumPools(mint, connection, debug) {
  */
 export async function inspectSolanaTokenLP(mint, options = {}) {
     const startTime = Date.now();
+    if (!options.connection && !options.rpcUrl) {
+        throw new Error('Either connection or rpcUrl is required in options');
+    }
     const connection = options.connection || createConnection(options.rpcUrl);
     const debug = options.debug;
     // 初始化结果
@@ -479,6 +482,9 @@ export async function inspectSolanaTokenLP(mint, options = {}) {
  * @returns 如果在内盘返回内盘信息，否则返回 null
  */
 export async function detectBondingCurve(mint, options = {}) {
+    if (!options.connection && !options.rpcUrl) {
+        throw new Error('Either connection or rpcUrl is required in options');
+    }
     const connection = options.connection || createConnection(options.rpcUrl);
     const debug = options.debug;
     // 并行检测所有内盘

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "four-flap-meme-sdk",
-  "version": "1.3.87",
+  "version": "1.3.88",
   "description": "SDK for Flap bonding curve, four.meme TokenManager, and Solana DEX",
   "type": "module",
   "main": "dist/index.js",