100x-sdk 1.0.3 → 1.0.4

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { Connection, PublicKey, Transaction, Keypair } from '@solana/web3.js';
 import { BN, Wallet, Program } from '@coral-xyz/anchor';
 
-// ========================= 基础类型定义 =========================
+// ========================= Basic Type Definitions =========================
 
 export type DataSourceType = 'fast' | 'chain';
 
@@ -29,7 +29,7 @@ export interface Fun100xSdkOptions {
   paramsAccount?: string;
 }
 
-// ========================= 订单和交易相关类型 =========================
+// ========================= Order and Trading Related Types =========================
 
 export interface OrderData {
   order_pda: string;
@@ -89,7 +89,7 @@ export interface MintInfo {
   [key: string]: any;
 }
 
-// ========================= 交易参数类型 =========================
+// ========================= Trading Parameter Types =========================
 
 export interface BuyParams {
   mintAccount: string | PublicKey;
@@ -147,7 +147,7 @@ export interface TransactionOptions {
   computeUnits?: number;
 }
 
-// ========================= 查询参数类型 =========================
+// ========================= Query Parameter Types =========================
 
 export interface OrdersQueryOptions {
   type?: 'up_orders' | 'down_orders';
@@ -167,7 +167,7 @@ export interface UserOrdersQueryOptions {
   dataSource?: DataSourceType;
 }
 
-// ========================= 模拟器相关类型 =========================
+// ========================= Simulator Related Types =========================
 
 export interface SimulationResult {
   liqResult: {
@@ -187,7 +187,7 @@ export interface SimulationResult {
   suggestedSolAmount: string;
 }
 
-// ========================= 工具类相关类型 =========================
+// ========================= Utility Related Types =========================
 
 export interface FindPrevNextResult {
   prevOrder: OrderData | null;
@@ -200,7 +200,7 @@ export interface ValidationResult {
   warnings: string[];
 }
 
-// ========================= 模块接口定义 =========================
+// ========================= Module Interface Definitions =========================
 
 export interface TradingModule {
   buy(params: BuyParams, options?: TransactionOptions): Promise<TransactionResult>;
@@ -242,14 +242,14 @@ export interface SimulatorModule {
   simulateSellStopLoss(mint: string, sellTokenAmount: bigint | string | number, stopLossPrice: bigint | string | number, lastPrice?: any, ordersData?: any): Promise<any>;
 }
 
-// ========================= 数据接口类型 =========================
+// ========================= Data Interface Types =========================
 
 export interface DataInterface {
   orders(mint: string, options?: OrdersQueryOptions): Promise<OrdersResponse>;
   price(mint: string, options?: PriceQueryOptions): Promise<PriceResponse>;
 }
 
-// ========================= 主 SDK 类型定义 =========================
+// ========================= Main SDK Type Definition =========================
 
 export declare class Fun100xSdk {
   connection: Connection;
@@ -262,12 +262,12 @@ export declare class Fun100xSdk {
   paramsAccount: PublicKey;
   fastApiUrl: string;
 
-  // 常量
+  // Constants
   readonly MAX_ORDERS_COUNT: number;
   readonly FIND_MAX_ORDERS_COUNT: number;
   readonly SUGGEST_LIQ_RATIO: number;
 
-  // 模块
+  // Modules
   trading: TradingModule;
   fast: FastModule;
   chain: ChainModule;
@@ -276,7 +276,7 @@ export declare class Fun100xSdk {
   simulator: SimulatorModule;
   data: DataInterface;
 
-  // 静态工具类引用
+  // Static utility class references
   static CurveAMM: typeof CurveAMM;
   static OrderUtils: typeof OrderUtils;
 
@@ -286,14 +286,14 @@ export declare class Fun100xSdk {
     options?: Fun100xSdkOptions
   );
 
-  // OrderUtils 快捷方法
+  // OrderUtils shortcut methods
   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;
 }
 
-// ========================= 工具类导出 =========================
+// ========================= Utility Class Exports =========================
 
 export declare class OrderUtils {
   static buildLpPairs(orders: OrderData[], direction: string, price: any, maxCount?: number): LpPair[];
@@ -336,7 +336,7 @@ export declare class CurveAMM {
   static calculateInitialK(): any;
   static getInitialPrice(): bigint | null;
 
-  // Custom pool parameters calculation (动态流动池)
+  // Custom pool parameters calculation (dynamic liquidity pool)
   static calculateK(initialVirtualSol: any, initialVirtualToken: any): any;
   static getInitialPriceWithParams(initialVirtualSol: any, initialVirtualToken: any): bigint | null;
 
@@ -349,7 +349,7 @@ export declare class CurveAMM {
   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;
 
-  // AMM calculation methods with custom pool parameters (动态流动池)
+  // AMM calculation methods with custom pool parameters (dynamic liquidity pool)
   static priceToReservesWithParams(price: any, initialVirtualSol: any, initialVirtualToken: any): [any, any] | null;
   static buyFromPriceToPriceWithParams(startLowPrice: bigint | string | number, endHighPrice: bigint | string | number, initialVirtualSol: any, initialVirtualToken: any): [bigint, bigint] | null;
   static sellFromPriceToPriceWithParams(startHighPrice: bigint | string | number, endLowPrice: bigint | string | number, initialVirtualSol: any, initialVirtualToken: any): [bigint, bigint] | null;
@@ -365,7 +365,7 @@ export declare class CurveAMM {
   static calculatePoolPrice(lpTokenReserve: bigint | string | number | BN, lpSolReserve: bigint | string | number | BN): string | null;
 }
 
-// ========================= 常量和函数导出 =========================
+// ========================= Constant and Function Exports =========================
 
 export declare const FUN100X_PROGRAM_ID: PublicKey;
 
@@ -373,7 +373,7 @@ export declare function getProgramId(network?: NetworkType): PublicKey;
 
 export declare function getDefaultOptions(networkName?: 'MAINNET' | 'DEVNET' | 'LOCALNET'): NetworkConfig;
 
-// ========================= 模块类导出 =========================
+// ========================= Module Class Exports =========================
 
 export declare class TradingModule implements TradingModule {}
 export declare class FastModule implements FastModule {}
@@ -382,5 +382,5 @@ export declare class TokenModule implements TokenModule {}
 export declare class ParamModule implements ParamModule {}
 export declare class SimulatorModule implements SimulatorModule {}
 
-// 默认导出
+// Default export
 export default Fun100xSdk;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "100x-sdk",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "description": "Solana 100x.fun SDK",
   "main": "dist/100x-sdk.cjs.js",
   "module": "dist/100x-sdk.esm.js",

package/src/modules/chain.js

@@ -2,7 +2,7 @@
 const { PublicKey } = require('@solana/web3.js');
 const anchor = require('@coral-xyz/anchor');
 const CurveAMM = require('../utils/curve_amm');
-// 统一使用 buffer 包，所有平台一致
+// Use the buffer package uniformly, consistent across all platforms
 const { Buffer } = require('buffer');
 
 /**
@@ -14,14 +14,14 @@ const { Buffer } = require('buffer');
 class ChainModule {
   constructor(sdk) {
     this.sdk = sdk;
-    // getCurveAccount 缓存：key = mint string, value = { data, timestamp }
+    // getCurveAccount cache: key = mint string, value = { data, timestamp }
     this._curveAccountCache = new Map();
-    this._CACHE_TTL = 10000; // 10 秒 TTL
+    this._CACHE_TTL = 10000; // 10 second TTL
   }
 
   /**
-   * 清除指定 mint 的 curveAccount 缓存（交易后调用）
-   * @param {string} [mint] - 指定 mint 地址，不传则清除全部
+   * Clear the curveAccount cache for a specified mint (called after a transaction)
+   * @param {string} [mint] - Specified mint address; clears all if not provided
    */
   invalidateCurveCache(mint) {
     if (mint) {
@@ -178,12 +178,12 @@ class ChainModule {
       const mintPubkey = typeof mint === 'string' ? new PublicKey(mint) : mint;
       const mintKey = mintPubkey.toString();
 
-      // 检查缓存
+      // Check cache
       const cached = this._curveAccountCache.get(mintKey);
       if (cached && (Date.now() - cached.timestamp < this._CACHE_TTL)) {
-        // 缓存命中：如果请求包含余额但缓存没有，需要重新获取余额部分
+        // Cache hit: if the request includes balances but the cache doesn't, re-fetch the balance part
         if (!skipBalances && cached.skipBalances) {
-          // 缓存是 skipBalances 的，但现在需要余额，需要补充查询
+          // The cache is from skipBalances, but balances are now needed, so a supplementary query is required
         } else {
           return cached.data;
         }
@@ -237,7 +237,7 @@ class ChainModule {
         this.sdk.programId
       );
 
-      // 借贷池专用 token 账户 PDA（合约新增，seed = "pool_borrow_token"）
+      // Dedicated token account PDA for the borrow pool (added in the contract, seed = "pool_borrow_token")
       const [poolBorrowTokenAccountPDA] = PublicKey.findProgramAddressSync(
         [
           Buffer.from("pool_borrow_token"),
@@ -309,22 +309,22 @@ class ChainModule {
         // Creator address
         creator: decodedData.creator.toString(),
 
-        // === 第一阶段新增字段：动态流动池参数 ===
+        // === Phase 1 new fields: dynamic liquidity pool parameters ===
         initialVirtualSol: BigInt(decodedData.initialVirtualSol.toString()),        // u64, lamports
-        initialVirtualToken: BigInt(decodedData.initialVirtualToken.toString()),    // u64, 最小单位
+        initialVirtualToken: BigInt(decodedData.initialVirtualToken.toString()),    // u64, smallest unit
 
-        // 借贷池初始资金（合约新增），创建后永不变
-        // 已借出量 = initialBorrowTokenReserve - borrowTokenReserve
-        initialBorrowTokenReserve: BigInt(decodedData.initialBorrowTokenReserve.toString()), // u64, 最小单位
+        // Borrow pool initial funding (added in the contract), never changes after creation
+        // Borrowed out amount = initialBorrowTokenReserve - borrowTokenReserve
+        initialBorrowTokenReserve: BigInt(decodedData.initialBorrowTokenReserve.toString()), // u64, smallest unit
 
-        // === 第二阶段新增字段：高级版池子参数 ===
-        poolType: decodedData.poolType,                           // u8, 0=普通版, 1=高级版
-        borrowPoolRatio: decodedData.borrowPoolRatio,            // u8, 5-30表示5%-30%
+        // === Phase 2 new fields: advanced version pool parameters ===
+        poolType: decodedData.poolType,                           // u8, 0=basic version, 1=advanced version
+        borrowPoolRatio: decodedData.borrowPoolRatio,            // u8, 5-30 means 5%-30%
 
-        // Token Supply 信息
+        // Token Supply information
         totalSupply: BigInt(tokenSupply.value.amount),
         decimals: tokenSupply.value.decimals,
-        // 借贷池初始总量，直接取链上字段（旧公式 totalSupply - initialVirtualToken 已废弃）
+        // Borrow pool initial total, taken directly from the on-chain field (old formula totalSupply - initialVirtualToken is deprecated)
         initialBorrowPool: BigInt(decodedData.initialBorrowTokenReserve.toString()),
         circulatingSupply: BigInt(decodedData.initialVirtualToken.toString())
           + (BigInt(tokenSupply.value.amount) - BigInt(decodedData.initialVirtualToken.toString()) - BigInt(decodedData.borrowTokenReserve.toString())),
@@ -335,10 +335,10 @@ class ChainModule {
 
         // Pool account information
         poolTokenAccount: poolTokenAccountPDA.toString(),                 // Pool token account address
-        poolBorrowTokenAccount: poolBorrowTokenAccountPDA.toString(),     // Pool borrow token account address (新增)
+        poolBorrowTokenAccount: poolBorrowTokenAccountPDA.toString(),     // Pool borrow token account address (added)
         poolSolAccount: poolSolAccountPDA.toString(),                     // Pool SOL account address
         poolTokenBalance: BigInt(poolTokenBalance.value.amount),          // Pool token balance
-        poolBorrowTokenBalance: BigInt(poolBorrowTokenBalance.value.amount), // Pool borrow token balance (= borrowTokenReserve, 新增)
+        poolBorrowTokenBalance: BigInt(poolBorrowTokenBalance.value.amount), // Pool borrow token balance (= borrowTokenReserve, added)
         poolSolBalance: poolSolBalance,                                   // Pool SOL balance (lamports)
 
         // Additional metadata
@@ -348,7 +348,7 @@ class ChainModule {
         }
       };
 
-      // 写入缓存
+      // Write to cache
       this._curveAccountCache.set(mintKey, {
         data: convertedData,
         timestamp: Date.now(),
@@ -411,7 +411,7 @@ class ChainModule {
     }
 
     try {
-      // 复用 getCurveAccount 缓存，避免重复 fetch 同一个账户
+      // Reuse the getCurveAccount cache to avoid re-fetching the same account
       const curveData = await this.getCurveAccount(mint, { skipBalances: true });
       const price = curveData.price;
 
@@ -515,7 +515,7 @@ class ChainModule {
       // "down_orders" = long orders = downOrderbook (orderType=1)
       const seed = orderType === 'up_orders' ? 'up_orderbook' : 'down_orderbook';
 
-      // 本地计算 orderbook PDA，避免调用 getCurveAccount（省 5 个 RPC）
+      // Compute the orderbook PDA locally to avoid calling getCurveAccount (saves 5 RPCs)
       const mintPubkey = new PublicKey(mint);
       const [orderbookPubkey] = PublicKey.findProgramAddressSync(
         [Buffer.from(seed), mintPubkey.toBuffer()],
@@ -973,7 +973,7 @@ class ChainModule {
         throw new Error('debug_orders: order type must be "up_orders" or "down_orders"');
       }
 
-      // 本地计算 orderbook PDA，避免调用 getCurveAccount（省 5 个 RPC）
+      // Compute the orderbook PDA locally to avoid calling getCurveAccount (saves 5 RPCs)
       const seed = orderType === 'up_orders' ? 'up_orderbook' : 'down_orderbook';
       const mintPubkey = new PublicKey(mint);
       const [orderbookPubkey] = PublicKey.findProgramAddressSync(
@@ -1184,7 +1184,7 @@ class ChainModule {
       const page = 1; // Always return page 1
       const orderBy = options.order_by || 'start_time_desc';
 
-      // 本地计算 orderbook PDA，避免调用 getCurveAccount（省 5 个 RPC）
+      // Compute the orderbook PDA locally to avoid calling getCurveAccount (saves 5 RPCs)
       const mintPubkey = new PublicKey(mint);
       const [upOrderbookPubkey] = PublicKey.findProgramAddressSync(
         [Buffer.from('up_orderbook'), mintPubkey.toBuffer()],

package/src/modules/fast.js

@@ -39,10 +39,10 @@ class FastModule {
   }
 
   /**
-   * Get token list (获取代币列表)
+   * Get token list
    * @param {Object} options - Query parameters
-   * @param {number} options.limit - Items per page, default 10 (每页数量，默认 10)
-   * @param {number} options.before_timestamp - Cursor for pagination (分页游标，Unix 时间戳)
+   * @param {number} options.limit - Items per page, default 10
+   * @param {number} options.before_timestamp - Cursor for pagination (Unix timestamp)
    * @returns {Promise<Object>} Token list data
    *
    * @example
@@ -88,8 +88,8 @@ class FastModule {
    * const page2 = await sdk.fast.mints({ limit: 5, before_timestamp: page1.data.next_cursor });
    *
    * // Access token data:
-   * const tokens = result.data.tokens; // 完整代币对象数组
-   * const mintAddresses = tokens.map(t => t.mint_account); // 提取代币地址
+   * const tokens = result.data.tokens; // Full array of token objects
+   * const mintAddresses = tokens.map(t => t.mint_account); // Extract token addresses
    */
   async mints(options = {}) {
     const params = {
@@ -108,8 +108,8 @@ class FastModule {
   }
 
   /**
-   * Get token details (获取代币详情信息)
-   * @param {string} mint - Token mint address (代币地址)
+   * Get token details
+   * @param {string} mint - Token mint address
    * @returns {Promise<Object>} Token details data
    *
    * @example
@@ -163,11 +163,11 @@ class FastModule {
   }
 
   /**
-   * 直接API调用方法
+   * Direct API call method
    * @private
-   * @param {Object} config - 数据配置
-   * @param {Object} params - 请求参数
-   * @returns {Promise<Object>} API响应数据
+   * @param {Object} config - Data configuration
+   * @param {Object} params - Request parameters
+   * @returns {Promise<Object>} API response data
    */
   async _directApiCall(config, params = {}) {
     // Ensure FastModule is properly configured before making API calls
@@ -188,33 +188,33 @@ class FastModule {
         url: url
       };
 
-      // 根据请求方法设置参数
+      // Set parameters based on request method
       if (config.method === 'POST') {
-        requestConfig.data = queryParams; // POST 请求使用 data
+        requestConfig.data = queryParams; // POST request uses data
       } else {
-        requestConfig.params = queryParams; // GET 请求使用 params
+        requestConfig.params = queryParams; // GET request uses params
       }
 
       const response = await this.httpClient.request(requestConfig);
 
-      // 检查新旧API响应格式
-      // 新格式: { code: 200, msg: "success", data: {...} }
-      // 旧格式: { success: true, data: {...}, message: "..." }
+      // Check new and old API response formats
+      // New format: { code: 200, msg: "success", data: {...} }
+      // Old format: { success: true, data: {...}, message: "..." }
       const isNewFormat = response.data && typeof response.data.code === 'number';
       const isOldFormat = response.data && typeof response.data.success === 'boolean';
 
       if (isNewFormat) {
-        // 新 API 格式
+        // New API format
         if (response.data.code !== 200) {
           throw new Error(`API请求失败: ${response.data.msg || '未知错误'}`);
         }
       } else if (isOldFormat) {
-        // 旧 API 格式（向后兼容）
+        // Old API format (backward compatible)
         if (!response.data.success) {
           throw new Error(`API请求失败: ${response.data.message || '未知错误'}`);
         }
       } else {
-        // 未知格式
+        // Unknown format
         throw new Error('API返回格式无法识别');
       }
 
@@ -222,14 +222,14 @@ class FastModule {
 
     } catch (error) {
       if (error.response) {
-        // API返回错误
+        // API returned error
         const errorMsg = error.response.data?.msg || error.response.data?.message || error.message;
         throw new Error(`API请求失败 [${error.response.status}]: ${errorMsg}`);
       } else if (error.request) {
-        // 网络错误
+        // Network error
         throw new Error(`网络请求失败: 无法连接到 ${this.baseUrl}`);
       } else {
-        // 其他错误
+        // Other errors
         throw new Error(`请求处理失败: ${error.message}`);
       }
     }
@@ -238,71 +238,71 @@ class FastModule {
 
 
   /**
-   * 获取订单数据 Get Orders Data (查询活跃订单 Active Orders)
-   * @param {string} mint - 代币地址 Token mint address
-   * @param {Object} options - 查询参数 Query parameters
-   * @param {string} options.type - 订单类型 Order type: "up_orders" (做空/short) 或 "down_orders" (做多/long)
-   * @param {number} options.page - 页码，默认1 Page number, default 1
-   * @param {number} options.limit - 每页数量，默认500 Items per page, default 500
-   * @returns {Promise<Object>} 订单数据，包含订单列表及分页信息 Order data with order list and pagination info
+   * Get Orders Data (Active Orders)
+   * @param {string} mint - Token mint address
+   * @param {Object} options - Query parameters
+   * @param {string} options.type - Order type: "up_orders" (short) or "down_orders" (long)
+   * @param {number} options.page - Page number, default 1
+   * @param {number} options.limit - Items per page, default 500
+   * @returns {Promise<Object>} Order data with order list and pagination info
    *
    * @example
-   * // 获取做多订单 Get long orders
+   * // Get long orders
    * const ordersData = await sdk.fast.orders('T3NFPvYvpULCTgrhHb4b4Sj5J1qtSNvyKZfE8hCvuKM', { type: 'down_orders' });
    *
-   * // 返回值示例 Return value example (compatible with chain.js format):
+   * // Return value example (compatible with chain.js format):
    * // {
    * //   "success": true,
    * //   "data": {
    * //     "orders": [
    * //       {
-   * //         "index": 0,                                            // 订单在 OrderBook 中的索引位置
-   * //         "user": "7621yjkZJ1jxBHw3oCPoazFfMx82NWBSARk2AGV7EBig",   // 用户地址
-   * //         "lock_lp_start_price": "2656104380242311276",          // LP 开始价格（字符串）
-   * //         "lock_lp_end_price": "2325402748045870207",            // LP 结束价格（字符串）
-   * //         "open_price": "2795899347623485554",                   // 开仓价格（字符串）
-   * //         "order_id": "0",                                       // 订单 ID（字符串）
-   * //         "lock_lp_sol_amount": 1880793407,                      // LP 锁定 SOL 数量（lamports）
-   * //         "lock_lp_token_amount": 75677963031921,                // LP 锁定代币数量（最小单位）
-   * //         "next_lp_sol_amount": 0,                               // Next LP SOL 数量
-   * //         "next_lp_token_amount": 0,                             // Next LP Token 数量
-   * //         "margin_init_sol_amount": 418211213,                   // 初始保证金
-   * //         "margin_sol_amount": 418211213,                        // 保证金 SOL 数量（lamports）
-   * //         "borrow_amount": 2276435100,                           // 借款数量（lamports）
-   * //         "position_asset_amount": 75677963031921,               // 持仓资产数量（最小单位）
-   * //         "realized_sol_amount": 0,                              // 已实现收益
-   * //         "version": 2,                                          // 版本号
-   * //         "start_time": 1764047379,                              // 开始时间（Unix 时间戳）
-   * //         "end_time": 1764652179,                                // 结束时间（Unix 时间戳）
-   * //         "next_order": 1,                                       // 链表中下一个订单索引 (65535=none)
-   * //         "prev_order": 65535,                                   // 链表中上一个订单索引 (65535=none)
-   * //         "borrow_fee": 1200,                                    // 借款费用（基点，1200 = 12%）
-   * //         "order_type": "down_orders"                            // 订单类型（字符串）
+   * //         "index": 0,                                            // Order index position in the OrderBook
+   * //         "user": "7621yjkZJ1jxBHw3oCPoazFfMx82NWBSARk2AGV7EBig",   // User address
+   * //         "lock_lp_start_price": "2656104380242311276",          // LP start price (string)
+   * //         "lock_lp_end_price": "2325402748045870207",            // LP end price (string)
+   * //         "open_price": "2795899347623485554",                   // Open price (string)
+   * //         "order_id": "0",                                       // Order ID (string)
+   * //         "lock_lp_sol_amount": 1880793407,                      // LP locked SOL amount (lamports)
+   * //         "lock_lp_token_amount": 75677963031921,                // LP locked token amount (min unit)
+   * //         "next_lp_sol_amount": 0,                               // Next LP SOL amount
+   * //         "next_lp_token_amount": 0,                             // Next LP Token amount
+   * //         "margin_init_sol_amount": 418211213,                   // Initial margin
+   * //         "margin_sol_amount": 418211213,                        // Margin SOL amount (lamports)
+   * //         "borrow_amount": 2276435100,                           // Borrow amount (lamports)
+   * //         "position_asset_amount": 75677963031921,               // Position asset amount (min unit)
+   * //         "realized_sol_amount": 0,                              // Realized profit
+   * //         "version": 2,                                          // Version number
+   * //         "start_time": 1764047379,                              // Start time (Unix timestamp)
+   * //         "end_time": 1764652179,                                // End time (Unix timestamp)
+   * //         "next_order": 1,                                       // Next order index in linked list (65535=none)
+   * //         "prev_order": 65535,                                   // Previous order index in linked list (65535=none)
+   * //         "borrow_fee": 1200,                                    // Borrow fee (basis points, 1200 = 12%)
+   * //         "order_type": "down_orders"                            // Order type (string)
    * //       }
    * //     ],
-   * //     "total": 10,                                               // 总订单数量 (total_count)
-   * //     "order_type": "down_orders",                               // 订单类型（字符串）
-   * //     "mint_account": "T3NFPvYvpULCTgrhHb4b4Sj5J1qtSNvyKZfE8hCvuKM", // 查询的代币地址
-   * //     "page": 1,                                                 // 当前页码
-   * //     "limit": 3,                                                // 每页限制
-   * //     "has_next": true,                                          // 是否有下一页
-   * //     "has_prev": false                                          // 是否有上一页
+   * //     "total": 10,                                               // Total order count (total_count)
+   * //     "order_type": "down_orders",                               // Order type (string)
+   * //     "mint_account": "T3NFPvYvpULCTgrhHb4b4Sj5J1qtSNvyKZfE8hCvuKM", // Queried token address
+   * //     "page": 1,                                                 // Current page number
+   * //     "limit": 3,                                                // Items per page
+   * //     "has_next": true,                                          // Whether there is a next page
+   * //     "has_prev": false                                          // Whether there is a previous page
    * //   },
-   * //   "message": "Operation successful"                            // 操作结果消息
+   * //   "message": "Operation successful"                            // Operation result message
    * // }
    *
-   * // 访问订单数据 Access order data:
-   * const orders = ordersData.data.orders;                        // 订单数组
-   * const totalOrders = ordersData.data.total;                    // 总订单数量
-   * const firstOrder = orders[0];                                 // 第一个订单
-   * const userAddress = firstOrder.user;                          // 用户地址
-   * const marginAmount = firstOrder.margin_sol_amount;            // 保证金数量（lamports）
-   * const borrowFee = firstOrder.borrow_fee;                      // 借款费用（基点）
+   * // Access order data:
+   * const orders = ordersData.data.orders;                        // Order array
+   * const totalOrders = ordersData.data.total;                    // Total order count
+   * const firstOrder = orders[0];                                 // First order
+   * const userAddress = firstOrder.user;                          // User address
+   * const marginAmount = firstOrder.margin_sol_amount;            // Margin amount (lamports)
+   * const borrowFee = firstOrder.borrow_fee;                      // Borrow fee (basis points)
    *
-   * // 获取做空订单 Get short orders:
+   * // Get short orders:
    * const shortOrders = await sdk.fast.orders(mint, { type: 'up_orders' });
    *
-   * // 分页获取订单 Get paginated orders:
+   * // Get paginated orders:
    * const pageTwo = await sdk.fast.orders(mint, { type: 'down_orders', page: 2, limit: 100 });
    */
   async orders(mint, options = {}) {
@@ -416,17 +416,17 @@ class FastModule {
       }));
 
       // Sort orders by lock_lp_start_price
-      // down_orders (做多): descending order (从大到小)
-      // up_orders (做空): ascending order (从小到大)
+      // down_orders (long): descending order
+      // up_orders (short): ascending order
       processedOrders.sort((a, b) => {
         const priceA = BigInt(a.lock_lp_start_price);
         const priceB = BigInt(b.lock_lp_start_price);
 
         if (type === 'down_orders') {
-          // 做多订单：从大到小排列
+          // Long orders: sort in descending order
           return priceB > priceA ? 1 : (priceB < priceA ? -1 : 0);
         } else {
-          // 做空订单：从小到大排列
+          // Short orders: sort in ascending order
           return priceA > priceB ? 1 : (priceA < priceB ? -1 : 0);
         }
       });
@@ -463,9 +463,9 @@ class FastModule {
   }
 
   /**
-   * Get token price (获取代币价格)
-   * @param {string} mint - Token mint address (代币地址)
-   * @returns {Promise<string>} Latest price string (最新价格字符串)
+   * Get token price
+   * @param {string} mint - Token mint address
+   * @returns {Promise<string>} Latest price string
    *
    * @example
    * // Get token latest price
@@ -481,12 +481,12 @@ class FastModule {
     // Call mint_info API
     const result = await this.mint_info(mint);
 
-    // Check return data (新格式: { code: 200, msg: "success", data: {...} })
+    // Check return data (new format: { code: 200, msg: "success", data: {...} })
     if (!result || !result.data) {
       throw new Error('price: 无法获取代币信息 Unable to fetch token information');
     }
 
-    // Extract latest price (新格式直接返回对象，不是数组)
+    // Extract latest price (new format returns object directly, not array)
     let latestPrice = result.data.latest_price;
 
     if (!latestPrice) {
@@ -502,16 +502,16 @@ class FastModule {
   }
 
   /**
-   * Get User Active Orders (获取用户活跃订单)
+   * Get User Active Orders
    * Compatible with chain.js user_orders() method
    *
-   * @param {string} user - User wallet address (用户钱包地址)
-   * @param {string} mint - Token mint address (optional, null/undefined for all tokens) (代币地址，可选)
-   * @param {Object} options - Query parameters (查询参数)
-   * @param {string} options.direction - Order direction (optional: 'up'=short, 'dn'=long, omit=all) (订单方向)
-   * @param {number} options.page - Page number, default 1 (页码，默认1)
-   * @param {number} options.limit - Items per page, default 20 (每页数量，默认20)
-   * @param {string} options.order_by - Sort order: 'start_time_desc' or 'start_time_asc', default 'start_time_desc' (排序方式)
+   * @param {string} user - User wallet address
+   * @param {string} mint - Token mint address (optional, null/undefined for all tokens)
+   * @param {Object} options - Query parameters
+   * @param {string} options.direction - Order direction (optional: 'up'=short, 'dn'=long, omit=all)
+   * @param {number} options.page - Page number, default 1
+   * @param {number} options.limit - Items per page, default 20
+   * @param {string} options.order_by - Sort order: 'start_time_desc' or 'start_time_asc', default 'start_time_desc'
    * @returns {Promise<Object>} User orders data compatible with chain.js format
    *
    * @example