pinpet-sdk 0.1.1

package/src/sdk.js

@@ -0,0 +1,370 @@
+const anchor = require('@coral-xyz/anchor');
+const { PublicKey } = require('@solana/web3.js');
+// 统一使用 buffer 包，所有平台一致
+const { Buffer } = require('buffer');
+
+// 环境检测和条件加载
+const IS_NODE = typeof process !== 'undefined' && process.versions && process.versions.node;
+
+// 确保全局可用（兼容现有代码）
+if (typeof global !== 'undefined' && !global.Buffer) {
+  global.Buffer = Buffer;
+}
+
+let fs, path;
+if (IS_NODE) {
+  try {
+    fs = require('fs');
+    path = require('path'); 
+  } catch (e) {
+    console.warn('File system modules not available');
+  }
+}
+const TradingModule = require('./modules/trading');
+const TokenModule = require('./modules/token');
+const ParamModule = require('./modules/param');
+const FastModule = require('./modules/fast');
+const SimulatorModule = require('./modules/simulator');
+const ChainModule = require('./modules/chain');
+const OrderUtils = require('./utils/orderUtils');
+const CurveAMM = require('./utils/curve_amm');
+const spinpetIdl = require('./idl/pinpet.json');
+
+/**
+ * SpinPet SDK Main Class
+ * Provides modular interfaces for interacting with SpinPet protocol
+ */
+class PinPetSdk {
+  /**
+   * Constructor
+   * @param {Connection} connection - Solana connection instance
+   * @param {Wallet|Keypair} wallet - Wallet instance
+   * @param {PublicKey|string} programId - Program ID
+   * @param {Object} options - Configuration options (optional)
+   */
+  constructor(connection, programId, options = {}) {
+    //console.log("PinPetSdk options=",options)
+    // Save configuration options
+    this.options = options;
+    
+    // Validate defaultDataSource configuration
+    if (options.defaultDataSource && !['fast', 'chain'].includes(options.defaultDataSource)) {
+      throw new Error('defaultDataSource must be "fast" or "chain"');
+    }
+
+   //console.log("options.defaultDataSource",options.defaultDataSource)
+    this.defaultDataSource = options.defaultDataSource || 'fast';
+    console.log('Data source method:', this.defaultDataSource);
+    
+    // Basic configuration
+    this.connection = connection;
+    //this.wallet = wallet instanceof anchor.Wallet ? wallet : new anchor.Wallet(wallet);
+    this.programId = typeof programId === 'string' ? new PublicKey(programId) : programId;
+    
+    // Initialize account configuration with options
+    this.feeRecipient = this._parsePublicKey(this.options.fee_recipient);
+    this.baseFeeRecipient = this._parsePublicKey(this.options.base_fee_recipient);
+    this.paramsAccount = this._parsePublicKey(this.options.params_account);
+    this.spinFastApiUrl = this.options.spin_fast_api_url;
+
+    // Maximum number of orders that can be processed at once in the contract
+    this.MAX_ORDERS_COUNT = 9
+    // Maximum number of orders to fetch during queries
+    this.FIND_MAX_ORDERS_COUNT = 1000
+
+    // 在流动性不足时, 建议实际使用流动性的比例, 分每 (1000=100%)
+    this.SUGGEST_LIQ_RATIO = 975; // 97.5% (1000=100%)
+
+    // 只在 Node.js 环境中启用调试日志
+    this.debugLogPath = IS_NODE && fs ? (this.options.debug_log_path || this.options.debugLogPath || null) : null;
+    
+    // 初始化调试文件
+    this._initDebugFiles();
+
+
+    // Initialize Anchor program
+    this.program = this._initProgram(this.options);
+    
+    // Initialize functional modules
+    this.trading = new TradingModule(this);
+    this.token = new TokenModule(this);
+    this.param = new ParamModule(this);
+    this.fast = new FastModule(this);
+    this.simulator = new SimulatorModule(this);
+    this.chain = new ChainModule(this);
+    
+    // Initialize curve AMM utility
+    this.curve = CurveAMM;
+    
+    /**
+     * 统一数据接口 - 根据 defaultDataSource 配置自动路由到 fast 或 chain 模块
+     * Unified data interface - automatically routes to fast or chain module based on defaultDataSource config
+     * 
+     * @example
+     * // 使用默认数据源获取订单
+     * const ordersData = await sdk.data.orders(mint, { type: 'down_orders' });
+     * 
+     * // 临时指定数据源
+     * const ordersData = await sdk.data.orders(mint, { 
+     *   type: 'down_orders',
+     *   dataSource: 'chain'  // 临时使用链上数据源
+     * });
+     * 
+     * // 获取用户订单
+     * const userOrders = await sdk.data.user_orders(user, mint, {
+     *   page: 1,
+     *   limit: 200,
+     *   order_by: 'start_time_desc'
+     * });
+     */
+    this.data = {
+      /**
+       * 获取代币订单数据
+       * @param {string} mint - 代币地址
+       * @param {Object} options - 查询参数，支持 dataSource 字段临时指定数据源
+       * @returns {Promise<Object>} 订单数据
+       */
+      orders: (mint, options = {}) => this._getDataWithSource('orders', [mint, options]),
+      
+      /**
+       * 获取代币价格数据
+       * @param {string} mint - 代币地址
+       * @param {Object} options - 查询参数，支持 dataSource 字段临时指定数据源
+       * @returns {Promise<string>} 价格字符串
+       */
+      price: (mint, options = {}) => this._getDataWithSource('price', [mint, options]),
+      
+      /**
+       * 获取用户订单数据
+       * @param {string} user - 用户地址
+       * @param {string} mint - 代币地址
+       * @param {Object} options - 查询参数，支持 dataSource 字段临时指定数据源
+       * @returns {Promise<Object>} 用户订单数据
+       */
+      user_orders: (user, mint, options = {}) => this._getDataWithSource('user_orders', [user, mint, options])
+    };
+  }
+
+  /**
+   * Parse PublicKey
+   * @private
+   * @param {PublicKey|string|null} key - Key to parse
+   * @returns {PublicKey|null}
+   */
+  _parsePublicKey(key) {
+    if (!key) return null;
+    return typeof key === 'string' ? new PublicKey(key) : key;
+  }
+
+  /**
+   * Initialize Anchor program instance
+   * @private
+   */
+  _initProgram(options = {}) {
+    const provider = new anchor.AnchorProvider(
+      this.connection,
+      {
+        commitment: options.commitment,
+        preflightCommitment: options.preflightCommitment,
+        skipPreflight: options.skipPreflight || false,
+        maxRetries: options.maxRetries,
+        ...options
+      }
+    );
+    
+    anchor.setProvider(provider);
+    
+    // Create program instance using imported IDL
+    return new anchor.Program(spinpetIdl, this.programId);
+  }
+
+  // ========== Order Processing Utility Methods ==========
+
+  /**
+   * Build LP Pairs Array (for trading)
+   * 
+   * @param {Array} orders - Order array
+   * @param {string} direction - Direction: 'up_orders' (short orders) or 'down_orders' (long orders)
+   * @param {bigint|string|number} price - Current price (u128 format)
+   * @returns {Array} LP pairs array, format: [{ solAmount: BN, tokenAmount: BN }, ...]
+   * 
+   * @example
+   * const ordersData = await sdk.fast.orders(mint, { type: 'down_orders' });
+   * const currentPrice = await sdk.fast.price(mint);
+   * const lpPairs = sdk.buildLpPairs(ordersData.data.orders, 'down_orders', currentPrice);
+   * // Returns: [
+   * //   { solAmount: new anchor.BN("63947874"), tokenAmount: new anchor.BN("65982364399") },
+   * //   { solAmount: new anchor.BN("1341732020"), tokenAmount: new anchor.BN("1399566720549") },
+   * //   ...
+   * // ]
+   */
+  buildLpPairs(orders, direction, price) {
+    return OrderUtils.buildLpPairs(orders, direction, price, this.MAX_ORDERS_COUNT);
+  }
+
+  /**
+   * Build Order Accounts Array (for trading)
+   * 
+   * @param {Array} orders - Order array
+   * @returns {Array} Order account address array, format: [string, string, ..., null, null]
+   * 
+   * @example
+   * const ordersData = await sdk.fast.orders(mint, { type: 'down_orders' });
+   * const orderAccounts = sdk.buildOrderAccounts(ordersData.data.orders);
+   * // Returns: [
+   * //   "4fvsPDNoRRacSzE3PkEuNQeTNWMaeFqGwUxCnEbR1Dzb",
+   * //   "G4nHBYX8EbrP8r35pk5TfpvJZfGNyLnd4qsfT7ru5vLd",
+   * //   ...
+   * //   null, null
+   * // ]
+   */
+  buildOrderAccounts(orders) {
+    return OrderUtils.buildOrderAccounts(orders, this.MAX_ORDERS_COUNT);
+  }
+
+  /**
+   * Find Previous and Next Order
+   * 
+   * @param {Array} orders - Order array
+   * @param {string} findOrderPda - Target order PDA address
+   * @returns {Object} Returns { prevOrder: Object|null, nextOrder: Object|null }
+   * 
+   * @example
+   * const ordersData = await sdk.fast.orders(mint, { type: 'down_orders' });
+   * const result = sdk.findPrevNext(ordersData.data.orders, 'E2T72D4wZdxHRjELN5VnRdcCvS4FPcYBBT3UBEoaC5cA');
+   * // Returns:
+   * // {
+   * //   prevOrder: { order_pda: "...", user: "...", ... } | null,
+   * //   nextOrder: { order_pda: "...", user: "...", ... } | null
+   * // }
+   */
+  findPrevNext(orders, findOrderPda) {
+    return OrderUtils.findPrevNext(orders, findOrderPda);
+  }
+
+  /**
+   * Get PDA Address Position in Orders Array
+   * 
+   * 获取指定 PDA 地址在订单数组中的索引位置，主要用于 closeLong 和 closeShort 方法中
+   * Gets the index position of specified PDA address in orders array, mainly used in closeLong and closeShort methods
+   * 
+   * @param {Array} orders - 订单数组 Order array  
+   * @param {string|PublicKey} targetOrderPda - 目标订单PDA地址 Target order PDA address
+   * @returns {number} PDA地址在数组中的索引位置，如果没有找到返回200
+   *                   Index position of PDA address in array, returns 200 if not found
+   * 
+   * @example
+   * // 在 closeLong 或 closeShort 中使用 Usage in closeLong or closeShort:
+   * const ordersData = await sdk.data.orders(mint.toString(), {
+   *   type: 'down_orders',
+   *   limit: sdk.MAX_ORDERS_COUNT + 1
+   * });
+   * 
+   * const closeOrderPubkey = new PublicKey("E2T72D4wZdxHRjELN5VnRdcCvS4FPcYBBT3UBEoaC5cA");
+   * const orderIndex = sdk.findOrderIndex(ordersData.data.orders, closeOrderPubkey);
+   * 
+   * if (orderIndex !== 200) {
+   *   console.log(`订单在数组中的位置：${orderIndex} Order position in array: ${orderIndex}`);
+   * } else {
+   *   console.log('订单未找到 Order not found');
+   * }
+   * 
+   * // 也支持字符串格式的PDA地址 Also supports string format PDA address:
+   * const orderIndex2 = sdk.findOrderIndex(ordersData.data.orders, "E2T72D4wZdxHRjELN5VnRdcCvS4FPcYBBT3UBEoaC5cA");
+   * 
+   * // 实际业务场景使用示例 Real business scenario usage example:
+   * async function processCloseOrder(mintAccount, closeOrderPubkey) {
+   *   // 获取订单数据
+   *   const ordersData = await sdk.data.orders(mintAccount.toString(), {
+   *     type: 'down_orders',
+   *     limit: sdk.MAX_ORDERS_COUNT + 1
+   *   });
+   *   
+   *   // 查找订单位置用于后续处理逻辑
+   *   const orderIndex = sdk.findOrderIndex(ordersData.data.orders, closeOrderPubkey);
+   *   
+   *   if (orderIndex !== 200) {
+   *     console.log(`找到目标订单，位置: ${orderIndex}`);
+   *     // 继续处理订单相关逻辑...
+   *   } else {
+   *     throw new Error('目标订单不存在于当前订单列表中');
+   *   }
+   * }
+   */
+  findOrderIndex(orders, targetOrderPda) {
+    return OrderUtils.findOrderIndex(orders, targetOrderPda);
+  }
+
+  // ========== Debug File Management Methods ==========
+
+  /**
+   * 初始化调试文件，删除旧文件
+   * Initialize debug files, delete old files
+   * @private
+   */
+  _initDebugFiles() {
+    if (!this.debugLogPath || !IS_NODE || !fs || !path) {
+      return; // 浏览器环境或文件系统不可用
+    }
+
+    try {
+      const files = ['orderPda.txt', 'orderOpen.txt'];
+      files.forEach(file => {
+        const filePath = path.join(this.debugLogPath, file);
+        if (fs.existsSync(filePath)) {
+          fs.unlinkSync(filePath);
+        }
+      });
+    } catch (error) {
+      console.warn('Warning: Failed to initialize debug files:', error.message);
+    }
+  }
+
+  /**
+   * 安全地写入调试日志
+   * Safely write debug log
+   * @private
+   * @param {string} fileName - 文件名
+   * @param {string} content - 内容
+   */
+  _writeDebugLog(fileName, content) {
+    if (!this.debugLogPath || !IS_NODE || !fs || !path) {
+      return; // 静默失败，不报错
+    }
+
+    try {
+      const filePath = path.join(this.debugLogPath, fileName);
+      fs.appendFileSync(filePath, content);
+    } catch (error) {
+      console.warn(`Warning: Failed to write debug log to ${fileName}:`, error.message);
+    }
+  }
+
+  // ========== Unified Data Interface Routing Method ==========
+
+  /**
+   * Route data requests based on configuration
+   * 
+   * @private
+   * @param {string} method - Method name
+   * @param {Array} args - Arguments array
+   * @returns {Promise} Returns result from corresponding module method
+   */
+  _getDataWithSource(method, args) {
+    // Extract dataSource configuration from last parameter
+    const lastArg = args[args.length - 1] || {};
+    const dataSource = lastArg.dataSource || this.defaultDataSource;
+    
+    // Route to corresponding module based on data source
+    const module = dataSource === 'chain' ? this.chain : this.fast;
+    
+    if (!module[method]) {
+      throw new Error(`Method ${method} does not exist in ${dataSource} module`);
+    }
+    
+    return module[method](...args);
+  }
+
+}
+
+module.exports = PinPetSdk;

package/src/types/index.d.ts

@@ -0,0 +1,342 @@
+import { Connection, PublicKey, Transaction, Keypair } from '@solana/web3.js';
+import { BN, Wallet, Program } from '@coral-xyz/anchor';
+
+// ========================= 基础类型定义 =========================
+
+export type DataSourceType = 'fast' | 'chain';
+
+export interface NetworkConfig {
+  name: string;
+  defaultDataSource: DataSourceType;
+  solanaEndpoint: string;
+  spin_fast_api_url: string;
+  fee_recipient: string;
+  base_fee_recipient: string;
+  params_account: string;
+}
+
+export interface PinPetSdkOptions {
+  defaultDataSource?: DataSourceType;
+  solanaEndpoint?: string;
+  spin_fast_api_url?: string;
+  fee_recipient?: string;
+  base_fee_recipient?: string;
+  params_account?: string;
+  debug_log_path?: string;
+  debugLogPath?: string;
+}
+
+// ========================= 订单和交易相关类型 =========================
+
+export interface OrderData {
+  order_pda: string;
+  user: string;
+  mint: string;
+  order_type: string;
+  lock_lp_sol_amount: string;
+  lock_lp_token_amount: string;
+  lock_lp_start_price: string;
+  lock_lp_end_price: string;
+  margin_sol_amount: string;
+  borrow_amount: string;
+  position_asset_amount: string;
+  created_at?: string;
+  updated_at?: string;
+}
+
+export interface LpPair {
+  solAmount: BN;
+  tokenAmount: BN;
+}
+
+export interface TransactionResult {
+  transaction: Transaction;
+  signers: Keypair[];
+  accounts: Record<string, PublicKey>;
+  orderData?: {
+    ordersUsed: number;
+    lpPairsCount: number;
+    lpPairs: LpPair[];
+    orderAccounts: (string | null)[];
+    [key: string]: any;
+  };
+}
+
+export interface OrdersResponse {
+  data: {
+    orders: OrderData[];
+    total?: number;
+    page?: number;
+    limit?: number;
+  };
+}
+
+export interface PriceResponse {
+  price: string;
+  price_u128: string;
+  [key: string]: any;
+}
+
+export interface MintInfo {
+  mint: string;
+  name?: string;
+  symbol?: string;
+  decimals: number;
+  total_supply?: string;
+  [key: string]: any;
+}
+
+// ========================= 交易参数类型 =========================
+
+export interface BuyParams {
+  mintAccount: string | PublicKey;
+  buyTokenAmount: BN;
+  maxSolAmount: BN;
+  payer: PublicKey;
+}
+
+export interface SellParams {
+  mintAccount: string | PublicKey;
+  sellTokenAmount: BN;
+  minSolOutput: BN;
+  payer: PublicKey;
+}
+
+export interface LongParams {
+  mintAccount: string | PublicKey;
+  buyTokenAmount: BN;
+  maxSolAmount: BN;
+  marginSol: BN;
+  closePrice: BN;
+  prevOrder?: PublicKey | null;
+  nextOrder?: PublicKey | null;
+  payer: PublicKey;
+}
+
+export interface ShortParams {
+  mintAccount: string | PublicKey;
+  borrowSellTokenAmount: BN;
+  minSolOutput: BN;
+  marginSol: BN;
+  closePrice: BN;
+  prevOrder?: PublicKey | null;
+  nextOrder?: PublicKey | null;
+  payer: PublicKey;
+}
+
+export interface CloseLongParams {
+  mintAccount: string | PublicKey;
+  closeOrder: string | PublicKey;
+  sellTokenAmount: BN;
+  minSolOutput: BN;
+  payer: PublicKey;
+}
+
+export interface CloseShortParams {
+  mintAccount: string | PublicKey;
+  closeOrder: string | PublicKey;
+  buyTokenAmount: BN;
+  maxSolAmount: BN;
+  payer: PublicKey;
+}
+
+export interface TransactionOptions {
+  computeUnits?: number;
+}
+
+// ========================= 查询参数类型 =========================
+
+export interface OrdersQueryOptions {
+  type?: 'up_orders' | 'down_orders';
+  limit?: number;
+  page?: number;
+  dataSource?: DataSourceType;
+}
+
+export interface PriceQueryOptions {
+  dataSource?: DataSourceType;
+}
+
+export interface UserOrdersQueryOptions {
+  type?: 'up_orders' | 'down_orders';
+  limit?: number;
+  page?: number;
+  dataSource?: DataSourceType;
+}
+
+// ========================= 模拟器相关类型 =========================
+
+export interface SimulationResult {
+  liqResult: {
+    free_lp_sol_amount_sum: bigint;
+    free_lp_token_amount_sum: bigint;
+    lock_lp_sol_amount_sum: bigint;
+    lock_lp_token_amount_sum: bigint;
+    has_infinite_lp: boolean;
+    pass_order_id: number;
+    force_close_num: number;
+    ideal_lp_sol_amount: bigint;
+    real_lp_sol_amount: bigint;
+  };
+  completion: string;
+  slippage: string;
+  suggestedTokenAmount: string;
+  suggestedSolAmount: string;
+}
+
+// ========================= 工具类相关类型 =========================
+
+export interface FindPrevNextResult {
+  prevOrder: OrderData | null;
+  nextOrder: OrderData | null;
+}
+
+export interface ValidationResult {
+  valid: boolean;
+  errors: string[];
+  warnings: string[];
+}
+
+// ========================= 模块接口定义 =========================
+
+export interface TradingModule {
+  buy(params: BuyParams, options?: TransactionOptions): Promise<TransactionResult>;
+  sell(params: SellParams, options?: TransactionOptions): Promise<TransactionResult>;
+  long(params: LongParams, options?: TransactionOptions): Promise<TransactionResult>;
+  short(params: ShortParams, options?: TransactionOptions): Promise<TransactionResult>;
+  closeLong(params: CloseLongParams, options?: TransactionOptions): Promise<TransactionResult>;
+  closeShort(params: CloseShortParams, options?: TransactionOptions): Promise<TransactionResult>;
+}
+
+export interface FastModule {
+  mints(options?: any): Promise<any>;
+  mint_info(mint: string): Promise<MintInfo>;
+  orders(mint: string, options?: OrdersQueryOptions): Promise<OrdersResponse>;
+  price(mint: string, options?: PriceQueryOptions): Promise<PriceResponse>;
+  user_orders(user: string, mint: string, options?: UserOrdersQueryOptions): Promise<OrdersResponse>;
+}
+
+export interface ChainModule {
+  getCurveAccount(mint: string): Promise<any>;
+  orders(mint: string, options?: OrdersQueryOptions): Promise<OrdersResponse>;
+  price(mint: string, options?: PriceQueryOptions): Promise<PriceResponse>;
+}
+
+export interface TokenModule {
+  create(params: any): Promise<TransactionResult>;
+}
+
+export interface ParamModule {
+  createParams(params: any): Promise<TransactionResult>;
+  getParams(partner: string): Promise<any>;
+  getAdmin(): Promise<any>;
+}
+
+export interface SimulatorModule {
+  simulateTokenBuy(mint: string, buyTokenAmount: bigint | string | number, passOrder?: string | null): Promise<SimulationResult>;
+  simulateTokenSell(mint: string, sellTokenAmount: bigint | string | number, passOrder?: string | null): Promise<SimulationResult>;
+  simulateLongStopLoss(mint: string, buyTokenAmount: bigint | string | number, stopLossPrice: bigint | string | number, lastPrice?: any, ordersData?: any): Promise<any>;
+  simulateSellStopLoss(mint: string, sellTokenAmount: bigint | string | number, stopLossPrice: bigint | string | number, lastPrice?: any, ordersData?: any): Promise<any>;
+}
+
+// ========================= 数据接口类型 =========================
+
+export interface DataInterface {
+  orders(mint: string, options?: OrdersQueryOptions): Promise<OrdersResponse>;
+  price(mint: string, options?: PriceQueryOptions): Promise<PriceResponse>;
+}
+
+// ========================= 主 SDK 类型定义 =========================
+
+export declare class PinPetSdk {
+  connection: Connection;
+  programId: PublicKey;
+  program: Program;
+  options: PinPetSdkOptions;
+  defaultDataSource: DataSourceType;
+  feeRecipient: PublicKey;
+  baseFeeRecipient: PublicKey;
+  paramsAccount: PublicKey;
+  spinFastApiUrl: string;
+  debugLogPath: string | null;
+  
+  // 常量
+  readonly MAX_ORDERS_COUNT: number;
+  readonly FIND_MAX_ORDERS_COUNT: number;
+  readonly SUGGEST_LIQ_RATIO: number;
+  
+  // 模块
+  trading: TradingModule;
+  fast: FastModule;
+  chain: ChainModule;
+  token: TokenModule;
+  param: ParamModule;
+  simulator: SimulatorModule;
+  data: DataInterface;
+
+  constructor(
+    connection: Connection,
+    programId: string | PublicKey,
+    options?: PinPetSdkOptions
+  );
+
+  // OrderUtils 快捷方法
+  buildLpPairs(orders: OrderData[], direction: string, price: any, maxCount?: number): LpPair[];
+  buildOrderAccounts(orders: OrderData[], maxCount?: number): (string | null)[];
+  findPrevNext(orders: OrderData[], findOrderPda: string): FindPrevNextResult;
+  findOrderIndex(orders: OrderData[], targetOrderPda: string | PublicKey | null): number;
+}
+
+// ========================= 工具类导出 =========================
+
+export declare class OrderUtils {
+  static buildLpPairs(orders: OrderData[], direction: string, price: any, maxCount?: number): LpPair[];
+  static buildOrderAccounts(orders: OrderData[], maxCount?: number): (string | null)[];
+  static findPrevNext(orders: OrderData[], findOrderPda: string): FindPrevNextResult;
+  static findOrderIndex(orders: OrderData[], targetOrderPda: string | PublicKey | null): number;
+  static validateOrdersFormat(orders: OrderData[], throwOnError?: boolean): boolean | ValidationResult;
+}
+
+export declare class CurveAMM {
+  static readonly INITIAL_SOL_RESERVE_DECIMAL: any;
+  static readonly INITIAL_TOKEN_RESERVE_DECIMAL: any;
+  static readonly INITIAL_K_DECIMAL: any;
+  static readonly INITIAL_MIN_PRICE_DECIMAL: any;
+  static readonly PRICE_PRECISION_FACTOR_DECIMAL: any;
+  static readonly TOKEN_PRECISION_FACTOR_DECIMAL: any;
+  static readonly SOL_PRECISION_FACTOR_DECIMAL: any;
+  static readonly MAX_U128_PRICE: bigint;
+  static readonly MIN_U128_PRICE: bigint;
+
+  static u128ToDecimal(price: bigint | string | number): any;
+  static decimalToU128(price: any): bigint | null;
+  static decimalToU128Ceil(price: any): bigint | null;
+  static buyFromPriceToPrice(startLowPrice: bigint | string | number, endHighPrice: bigint | string | number): [bigint, bigint] | null;
+  static sellFromPriceToPrice(startHighPrice: bigint | string | number, endLowPrice: bigint | string | number): [bigint, bigint] | null;
+  static buyFromPriceWithSolInput(startLowPrice: bigint | string | number, solInputAmount: bigint | string | number): [bigint, bigint] | null;
+  static sellFromPriceWithTokenInput(startHighPrice: bigint | string | number, tokenInputAmount: bigint | string | number): [bigint, bigint] | null;
+  static buyFromPriceWithTokenOutput(startLowPrice: bigint | string | number, tokenOutputAmount: bigint | string | number): [bigint, bigint] | null;
+  static sellFromPriceWithSolOutput(startHighPrice: bigint | string | number, solOutputAmount: bigint | string | number): [bigint, bigint] | null;
+  static calculateAmountAfterFee(amount: bigint | string | number, fee: number): bigint | null;
+  static formatPriceForDisplay(price: bigint | string | number, decimalPlaces?: number): string;
+  static createPriceDisplayString(price: bigint | string | number, decimalPlaces?: number): string;
+  static calculatePoolPrice(lpTokenReserve: bigint | string | number | BN, lpSolReserve: bigint | string | number | BN): string | null;
+}
+
+// ========================= 常量和函数导出 =========================
+
+export declare const SPINPET_PROGRAM_ID: string;
+
+export declare function getDefaultOptions(networkName?: 'MAINNET' | 'DEVNET' | 'LOCALNET'): NetworkConfig;
+
+// ========================= 模块类导出 =========================
+
+export declare class TradingModule implements TradingModule {}
+export declare class FastModule implements FastModule {}
+export declare class ChainModule implements ChainModule {}
+export declare class TokenModule implements TokenModule {}
+export declare class ParamModule implements ParamModule {}
+export declare class SimulatorModule implements SimulatorModule {}
+
+// 默认导出
+export default PinPetSdk;