100x-sdk 1.0.2 → 1.0.4

package/src/modules/trading.js

@@ -1,11 +1,11 @@
 const { ComputeBudgetProgram, PublicKey, Transaction, SystemProgram, SYSVAR_RENT_PUBKEY } = require('@solana/web3.js');
 const { createAssociatedTokenAccountInstruction, getAssociatedTokenAddress, TOKEN_PROGRAM_ID, ASSOCIATED_TOKEN_PROGRAM_ID } = require('@solana/spl-token');
 const anchor = require('@coral-xyz/anchor');
-// 统一使用 buffer 包，所有平台一致
+// Use the buffer package uniformly, consistent across all platforms
 const { Buffer } = require('buffer');
 const { MAX_CANDIDATE_INDICES } = require('./simulator/utils');
 
-// 环境检测和条件加载
+// Environment detection and conditional loading
 const IS_NODE = typeof process !== 'undefined' && process.versions && process.versions.node;
 
 /**
@@ -293,11 +293,11 @@ class TradingModule {
    * Margin Long
    * @param {Object} params - Long parameters
    * @param {string|PublicKey} params.mintAccount - Token mint account address
-   * @param {anchor.BN} params.buyTokenAmount - Amount of tokens to buy (确定值)
-   * @param {anchor.BN} params.maxSolAmount - Maximum SOL to spend (实际有可能会少点)
-   * @param {anchor.BN} params.marginSol - Margin amount (保证金数量 SOL)
-   * @param {anchor.BN} params.closePrice - Close price (平仓价格/止损价格)
-   * @param {Array<number>} params.closeInsertIndices - Close insert indices array (平仓时插入订单簿的位置索引数组)
+   * @param {anchor.BN} params.buyTokenAmount - Amount of tokens to buy (fixed value)
+   * @param {anchor.BN} params.maxSolAmount - Maximum SOL to spend (the actual amount may be slightly less)
+   * @param {anchor.BN} params.marginSol - Margin amount (margin in SOL)
+   * @param {anchor.BN} params.closePrice - Close price (close price / stop loss price)
+   * @param {Array<number>} params.closeInsertIndices - Close insert indices array (position indices for inserting into the orderbook at close)
    * @param {PublicKey} params.payer - Payer public key
    * @param {Object} options - Optional parameters
    * @param {number} options.computeUnits - Compute units limit, default 1400000
@@ -310,14 +310,14 @@ class TradingModule {
    *   maxSolAmount: new anchor.BN("1100000000"),
    *   marginSol: new anchor.BN("2200000000"),
    *   closePrice: new anchor.BN("1000000000000000"),
-   *   closeInsertIndices: [0, 1, 2], // 插入位置索引数组
+   *   closeInsertIndices: [0, 1, 2], // insert position index array
    *   payer: wallet.publicKey
    * });
    */
   async long({ mintAccount, buyTokenAmount, maxSolAmount, marginSol, closePrice, closeInsertIndices, payer }, options = {}) {
     const { computeUnits = 1400000 } = options;
 
-    // 1. 参数验证和转换
+    // 1. Parameter validation and conversion
     const mint = typeof mintAccount === 'string' ? new PublicKey(mintAccount) : mintAccount;
 
     if (!anchor.BN.isBN(buyTokenAmount) || !anchor.BN.isBN(maxSolAmount) ||
@@ -402,18 +402,18 @@ class TradingModule {
   }
 
   /**
-   * 保证金做空 / Margin Short
-   * @param {Object} params - 做空参数 / Short parameters
-   * @param {string|PublicKey} params.mintAccount - 代币铸造账户地址 / Token mint account address
-   * @param {anchor.BN} params.borrowSellTokenAmount - 借出卖出的代币数量 (希望卖出的token数量) / Borrowed token amount to sell
-   * @param {anchor.BN} params.minSolOutput - 最小 SOL 输出 (卖出后最少得到的sol数量) / Minimum SOL output
-   * @param {anchor.BN} params.marginSol - 保证金数量 (SOL) / Margin amount
-   * @param {anchor.BN} params.closePrice - 平仓价格 (止损价格) / Close price
-   * @param {Array<number>} params.closeInsertIndices - Close insert indices array (平仓时插入订单簿的位置索引数组)
-   * @param {PublicKey} params.payer - 支付者公钥 / Payer public key
-   * @param {Object} options - 可选参数 / Optional parameters
-   * @param {number} options.computeUnits - 计算单元限制，默认 1400000 / Compute units limit, default 1400000
-   * @returns {Promise<Object>} 包含交易对象、签名者和账户信息的对象 / Object containing transaction, signers and account info
+   * Margin Short
+   * @param {Object} params - Short parameters
+   * @param {string|PublicKey} params.mintAccount - Token mint account address
+   * @param {anchor.BN} params.borrowSellTokenAmount - Borrowed token amount to sell (the amount of tokens you wish to sell)
+   * @param {anchor.BN} params.minSolOutput - Minimum SOL output (the minimum SOL received after selling)
+   * @param {anchor.BN} params.marginSol - Margin amount (SOL)
+   * @param {anchor.BN} params.closePrice - Close price (stop loss price)
+   * @param {Array<number>} params.closeInsertIndices - Close insert indices array (position indices for inserting into the orderbook at close)
+   * @param {PublicKey} params.payer - Payer public key
+   * @param {Object} options - Optional parameters
+   * @param {number} options.computeUnits - Compute units limit, default 1400000
+   * @returns {Promise<Object>} Object containing transaction, signers and account info
    *
    * @example
    * const result = await sdk.trading.short({
@@ -422,14 +422,14 @@ class TradingModule {
    *   minSolOutput: new anchor.BN("100"),
    *   marginSol: new anchor.BN("2200000000"),
    *   closePrice: new anchor.BN("1000000000000000"),
-   *   closeInsertIndices: [0, 1, 2], // 插入位置索引数组
+   *   closeInsertIndices: [0, 1, 2], // insert position index array
    *   payer: wallet.publicKey
    * });
    */
   async short({ mintAccount, borrowSellTokenAmount, minSolOutput, marginSol, closePrice, closeInsertIndices, payer }, options = {}) {
     const { computeUnits = 1400000 } = options;
 
-    // 1. 参数验证和转换 / Parameter validation and conversion
+    // 1. Parameter validation and conversion
     const mint = typeof mintAccount === 'string' ? new PublicKey(mintAccount) : mintAccount;
 
     if (!anchor.BN.isBN(borrowSellTokenAmount) || !anchor.BN.isBN(minSolOutput) ||
@@ -445,7 +445,7 @@ class TradingModule {
       throw new Error('closeInsertIndices array cannot exceed 20 elements');
     }
 
-    // 2. 计算 PDA 账户 / Calculate PDA accounts
+    // 2. Calculate PDA accounts
     const accounts = this._calculatePDAAccounts(mint);
 
     // 3. Calculate OrderBook PDA addresses
@@ -459,7 +459,7 @@ class TradingModule {
       this.sdk.programId
     );
 
-    // 4. 构建交易指令 / Build transaction instructions
+    // 4. Build transaction instructions
     const modifyComputeUnits = ComputeBudgetProgram.setComputeUnitLimit({
       units: computeUnits
     });
@@ -489,15 +489,15 @@ class TradingModule {
       })
       .instruction();
 
-    // 5. 创建交易并添加指令 / Create transaction and add instructions
+    // 5. Create transaction and add instructions
     const transaction = new Transaction();
     transaction.add(modifyComputeUnits);
     transaction.add(shortIx);
 
-    // 6. 返回交易对象和相关信息 / Return transaction object and related info
+    // 6. Return transaction object and related info
     return {
       transaction,
-      signers: [], // 做空交易不需要额外的签名者，只需要 payer 签名 / Short transaction doesn't need additional signers, only payer signature
+      signers: [], // Short transaction doesn't need additional signers, only payer signature
       accounts: {
         mint: mint,
         curveAccount: accounts.curveAccount,
@@ -514,26 +514,26 @@ class TradingModule {
   }
 
   /**
-   * 平仓做多 / Close Long Position
-   * @param {Object} params - 平仓参数 / Close position parameters
-   * @param {string|PublicKey} params.mintAccount - 代币铸造账户地址 / Token mint account address
-   * @param {anchor.BN} params.sellTokenAmount - 希望卖出的token数量 / Amount of tokens to sell
-   * @param {anchor.BN} params.minSolOutput - 卖出后最少得到的sol数量 / Minimum SOL output after selling
-   * @param {number|anchor.BN} params.closeOrderId - 订单的唯一编号 / Order unique ID
-   * @param {Array<number>} params.closeOrderIndices - 平仓时订单的位置索引数组 / Close order position indices array
-   * @param {PublicKey} params.payer - 支付者公钥 / Payer public key
-   * @param {PublicKey} params.userSolAccount - 开仓用户的SOL账户（接收资金）/ User SOL account to receive funds (must be order opener)
-   * @param {Object} options - 可选参数 / Optional parameters
-   * @param {number} options.computeUnits - 计算单元限制，默认1400000 / Compute units limit, default 1400000
-   * @returns {Promise<Object>} 包含交易对象、签名者和账户信息的对象 / Object containing transaction, signers and account info
+   * Close Long Position
+   * @param {Object} params - Close position parameters
+   * @param {string|PublicKey} params.mintAccount - Token mint account address
+   * @param {anchor.BN} params.sellTokenAmount - Amount of tokens to sell
+   * @param {anchor.BN} params.minSolOutput - Minimum SOL output after selling
+   * @param {number|anchor.BN} params.closeOrderId - Order unique ID
+   * @param {Array<number>} params.closeOrderIndices - Close order position indices array
+   * @param {PublicKey} params.payer - Payer public key
+   * @param {PublicKey} params.userSolAccount - User SOL account to receive funds (must be order opener)
+   * @param {Object} options - Optional parameters
+   * @param {number} options.computeUnits - Compute units limit, default 1400000
+   * @returns {Promise<Object>} Object containing transaction, signers and account info
    *
    * @example
    * const result = await sdk.trading.closeLong({
    *   mintAccount: "HZBos3RNhExDcAtzmdKXhTd4sVcQFBiT3FDBgmBBMk7",
    *   sellTokenAmount: new anchor.BN("1000000000"),
    *   minSolOutput: new anchor.BN("100000000"),
-   *   closeOrderId: 12345,  // 订单唯一编号
-   *   closeOrderIndices: [10, 11, 12],  // 候选索引数组
+   *   closeOrderId: 12345,  // order unique ID
+   *   closeOrderIndices: [10, 11, 12],  // candidate index array
    *   payer: wallet.publicKey,
    *   userSolAccount: orderOwnerPublicKey
    * });
@@ -541,17 +541,17 @@ class TradingModule {
   async closeLong({ mintAccount, sellTokenAmount, minSolOutput, closeOrderId, closeOrderIndices, payer, userSolAccount }, options = {}) {
     const { computeUnits = 1400000 } = options;
 
-    // 1. 参数验证和转换 / Parameter validation and conversion
+    // 1. Parameter validation and conversion
     const mint = typeof mintAccount === 'string' ? new PublicKey(mintAccount) : mintAccount;
 
     if (!anchor.BN.isBN(sellTokenAmount) || !anchor.BN.isBN(minSolOutput)) {
       throw new Error('sellTokenAmount and minSolOutput must be anchor.BN type');
     }
 
-    // 转换 closeOrderId 为 anchor.BN (u64)
+    // Convert closeOrderId to anchor.BN (u64)
     const closeOrderIdBN = anchor.BN.isBN(closeOrderId) ? closeOrderId : new anchor.BN(closeOrderId);
 
-    // 验证 closeOrderIndices 参数
+    // Validate the closeOrderIndices parameter
     if (!Array.isArray(closeOrderIndices) || closeOrderIndices.length === 0) {
       throw new Error('closeOrderIndices must be a non-empty array');
     }
@@ -560,7 +560,7 @@ class TradingModule {
       throw new Error(`closeOrderIndices array cannot exceed ${MAX_CANDIDATE_INDICES} elements`);
     }
 
-    // 验证和转换 userSolAccount - 支持字符串或 PublicKey 对象
+    // Validate and convert userSolAccount - supports string or PublicKey object
     let userSolAccountPubkey;
     if (!userSolAccount) {
       throw new Error('userSolAccount is required');
@@ -575,7 +575,7 @@ class TradingModule {
     } else if (userSolAccount instanceof PublicKey) {
       userSolAccountPubkey = userSolAccount;
     } else if (userSolAccount.constructor && userSolAccount.constructor.name === 'PublicKey') {
-      // 处理跨包 PublicKey 实例 - 提取字符串后重新创建
+      // Handle cross-package PublicKey instances - extract the string and recreate
       try {
         userSolAccountPubkey = new PublicKey(userSolAccount.toString());
       } catch (error) {
@@ -585,10 +585,10 @@ class TradingModule {
       throw new Error('userSolAccount must be a valid PublicKey or PublicKey string');
     }
 
-    // 2. 计算 PDA 账户 / Calculate PDA accounts
+    // 2. Calculate PDA accounts
     const accounts = this._calculatePDAAccounts(mint);
 
-    // 3. 计算 OrderBook PDA 地址 / Calculate OrderBook PDA addresses
+    // 3. Calculate OrderBook PDA addresses
     const [upOrderbook] = PublicKey.findProgramAddressSync(
       [Buffer.from('up_orderbook'), mint.toBuffer()],
       this.sdk.programId
@@ -599,22 +599,22 @@ class TradingModule {
       this.sdk.programId
     );
 
-    // 4. 从 curve account 获取手续费接收账户 / Get fee recipient accounts from curve account (skipBalances: only need addresses)
+    // 4. Get fee recipient accounts from curve account (skipBalances: only need addresses)
     const curveAccountInfo = await this.sdk.chain.getCurveAccount(mint, { skipBalances: true });
     const feeRecipientAccount = new PublicKey(curveAccountInfo.feeRecipient);
     const baseFeeRecipientAccount = new PublicKey(curveAccountInfo.baseFeeRecipient);
 
-    // 5. 构建交易指令 / Build transaction instructions
+    // 5. Build transaction instructions
     const modifyComputeUnits = ComputeBudgetProgram.setComputeUnitLimit({
       units: computeUnits
     });
 
     const closeLongIx = await this.sdk.program.methods
       .closeLong(
-        sellTokenAmount,       // sell_token_amount: 希望卖出的token数量 / Amount of tokens to sell
-        minSolOutput,          // min_sol_output: 卖出后最少得到的sol数量 / Minimum SOL output
-        closeOrderIdBN,        // close_order_id: 订单的唯一编号 / Order unique ID
-        closeOrderIndices      // close_order_indices: 平仓时订单的位置索引数组 / Close order indices array
+        sellTokenAmount,       // sell_token_amount: amount of tokens to sell
+        minSolOutput,          // min_sol_output: minimum SOL output
+        closeOrderIdBN,        // close_order_id: order unique ID
+        closeOrderIndices      // close_order_indices: close order indices array
       )
       .accounts({
         payer: payer,
@@ -623,7 +623,7 @@ class TradingModule {
         poolTokenAccount: accounts.poolTokenAccount,
         poolBorrowTokenAccount: accounts.poolBorrowTokenAccount,
         poolSolAccount: accounts.poolSolAccount,
-        userSolAccount: userSolAccountPubkey,  // 开仓用户的SOL账户 / User SOL account (must be order opener)
+        userSolAccount: userSolAccountPubkey,  // User SOL account (must be order opener)
         tokenProgram: TOKEN_PROGRAM_ID,
         systemProgram: SystemProgram.programId,
         rent: SYSVAR_RENT_PUBKEY,
@@ -634,15 +634,15 @@ class TradingModule {
       })
       .instruction();
 
-    // 6. 创建交易并添加指令 / Create transaction and add instructions
+    // 6. Create transaction and add instructions
     const transaction = new Transaction();
     transaction.add(modifyComputeUnits);
     transaction.add(closeLongIx);
 
-    // 7. 返回交易对象和相关信息 / Return transaction object and related info
+    // 7. Return transaction object and related info
     return {
       transaction,
-      signers: [], // 平仓做多交易不需要额外的签名者，只需要 payer 签名 / Close long transaction doesn't need additional signers, only payer signature
+      signers: [], // Close long transaction doesn't need additional signers, only payer signature
       accounts: {
         mint: mint,
         curveAccount: accounts.curveAccount,
@@ -664,26 +664,26 @@ class TradingModule {
 
 
   /**
-   * 平仓做空 / Close Short Position
-   * @param {Object} params - 平仓参数 / Close position parameters
-   * @param {string|PublicKey} params.mintAccount - 代币铸造账户地址 / Token mint account address
-   * @param {anchor.BN} params.buyTokenAmount - 希望买入的token数量 / Amount of tokens to buy
-   * @param {anchor.BN} params.maxSolAmount - 愿意给出的最大sol数量 / Maximum SOL amount to spend
-   * @param {number|anchor.BN} params.closeOrderId - 订单的唯一编号 / Order unique ID
-   * @param {Array<number>} params.closeOrderIndices - 平仓时订单的位置索引数组 / Close order position indices array
-   * @param {PublicKey} params.payer - 支付者公钥 / Payer public key
-   * @param {PublicKey} params.userSolAccount - 开仓用户的SOL账户（接收资金）/ User SOL account to receive funds (must be order opener)
-   * @param {Object} options - 可选参数 / Optional parameters
-   * @param {number} options.computeUnits - 计算单元限制，默认1400000 / Compute units limit, default 1400000
-   * @returns {Promise<Object>} 包含交易对象、签名者和账户信息的对象 / Object containing transaction, signers and account info
+   * Close Short Position
+   * @param {Object} params - Close position parameters
+   * @param {string|PublicKey} params.mintAccount - Token mint account address
+   * @param {anchor.BN} params.buyTokenAmount - Amount of tokens to buy
+   * @param {anchor.BN} params.maxSolAmount - Maximum SOL amount to spend
+   * @param {number|anchor.BN} params.closeOrderId - Order unique ID
+   * @param {Array<number>} params.closeOrderIndices - Close order position indices array
+   * @param {PublicKey} params.payer - Payer public key
+   * @param {PublicKey} params.userSolAccount - User SOL account to receive funds (must be order opener)
+   * @param {Object} options - Optional parameters
+   * @param {number} options.computeUnits - Compute units limit, default 1400000
+   * @returns {Promise<Object>} Object containing transaction, signers and account info
    *
    * @example
    * const result = await sdk.trading.closeShort({
    *   mintAccount: "HZBos3RNhExDcAtzmdKXhTd4sVcQFBiT3FDBgmBBMk7",
    *   buyTokenAmount: new anchor.BN("1000000000"),
    *   maxSolAmount: new anchor.BN("100000000"),
-   *   closeOrderId: 12345,  // 订单唯一编号
-   *   closeOrderIndices: [10, 11, 12],  // 候选索引数组
+   *   closeOrderId: 12345,  // order unique ID
+   *   closeOrderIndices: [10, 11, 12],  // candidate index array
    *   payer: wallet.publicKey,
    *   userSolAccount: orderOwnerPublicKey
    * });
@@ -691,17 +691,17 @@ class TradingModule {
   async closeShort({ mintAccount, buyTokenAmount, maxSolAmount, closeOrderId, closeOrderIndices, payer, userSolAccount }, options = {}) {
     const { computeUnits = 1400000 } = options;
 
-    // 1. 参数验证和转换 / Parameter validation and conversion
+    // 1. Parameter validation and conversion
     const mint = typeof mintAccount === 'string' ? new PublicKey(mintAccount) : mintAccount;
 
     if (!anchor.BN.isBN(buyTokenAmount) || !anchor.BN.isBN(maxSolAmount)) {
       throw new Error('buyTokenAmount and maxSolAmount must be anchor.BN type');
     }
 
-    // 转换 closeOrderId 为 anchor.BN (u64)
+    // Convert closeOrderId to anchor.BN (u64)
     const closeOrderIdBN = anchor.BN.isBN(closeOrderId) ? closeOrderId : new anchor.BN(closeOrderId);
 
-    // 验证 closeOrderIndices 参数
+    // Validate the closeOrderIndices parameter
     if (!Array.isArray(closeOrderIndices) || closeOrderIndices.length === 0) {
       throw new Error('closeOrderIndices must be a non-empty array');
     }
@@ -710,7 +710,7 @@ class TradingModule {
       throw new Error(`closeOrderIndices array cannot exceed ${MAX_CANDIDATE_INDICES} elements`);
     }
 
-    // 验证和转换 userSolAccount - 支持字符串或 PublicKey 对象
+    // Validate and convert userSolAccount - supports string or PublicKey object
     let userSolAccountPubkey;
     if (!userSolAccount) {
       throw new Error('userSolAccount is required');
@@ -725,7 +725,7 @@ class TradingModule {
     } else if (userSolAccount instanceof PublicKey) {
       userSolAccountPubkey = userSolAccount;
     } else if (userSolAccount.constructor && userSolAccount.constructor.name === 'PublicKey') {
-      // 处理跨包 PublicKey 实例 - 提取字符串后重新创建
+      // Handle cross-package PublicKey instances - extract the string and recreate
       try {
         userSolAccountPubkey = new PublicKey(userSolAccount.toString());
       } catch (error) {
@@ -735,10 +735,10 @@ class TradingModule {
       throw new Error('userSolAccount must be a valid PublicKey or PublicKey string');
     }
 
-    // 2. 计算 PDA 账户 / Calculate PDA accounts
+    // 2. Calculate PDA accounts
     const accounts = this._calculatePDAAccounts(mint);
 
-    // 3. 计算 OrderBook PDA 地址 / Calculate OrderBook PDA addresses
+    // 3. Calculate OrderBook PDA addresses
     const [upOrderbook] = PublicKey.findProgramAddressSync(
       [Buffer.from('up_orderbook'), mint.toBuffer()],
       this.sdk.programId
@@ -749,22 +749,22 @@ class TradingModule {
       this.sdk.programId
     );
 
-    // 4. 从 curve account 获取手续费接收账户 / Get fee recipient accounts from curve account (skipBalances: only need addresses)
+    // 4. Get fee recipient accounts from curve account (skipBalances: only need addresses)
     const curveAccountInfo = await this.sdk.chain.getCurveAccount(mint, { skipBalances: true });
     const feeRecipientAccount = new PublicKey(curveAccountInfo.feeRecipient);
     const baseFeeRecipientAccount = new PublicKey(curveAccountInfo.baseFeeRecipient);
 
-    // 5. 构建交易指令 / Build transaction instructions
+    // 5. Build transaction instructions
     const modifyComputeUnits = ComputeBudgetProgram.setComputeUnitLimit({
       units: computeUnits
     });
 
     const closeShortIx = await this.sdk.program.methods
       .closeShort(
-        buyTokenAmount,        // buy_token_amount: 希望买入的token数量 / Amount of tokens to buy
-        maxSolAmount,          // max_sol_amount: 愿意给出的最大sol数量 / Maximum SOL amount to spend
-        closeOrderIdBN,        // close_order_id: 订单的唯一编号 / Order unique ID
-        closeOrderIndices      // close_order_indices: 平仓时订单的位置索引数组 / Close order indices array
+        buyTokenAmount,        // buy_token_amount: amount of tokens to buy
+        maxSolAmount,          // max_sol_amount: maximum SOL amount to spend
+        closeOrderIdBN,        // close_order_id: order unique ID
+        closeOrderIndices      // close_order_indices: close order indices array
       )
       .accounts({
         payer: payer,
@@ -773,7 +773,7 @@ class TradingModule {
         poolTokenAccount: accounts.poolTokenAccount,
         poolBorrowTokenAccount: accounts.poolBorrowTokenAccount,
         poolSolAccount: accounts.poolSolAccount,
-        userSolAccount: userSolAccountPubkey,  // 开仓用户的SOL账户 / User SOL account (must be order opener)
+        userSolAccount: userSolAccountPubkey,  // User SOL account (must be order opener)
         tokenProgram: TOKEN_PROGRAM_ID,
         systemProgram: SystemProgram.programId,
         rent: SYSVAR_RENT_PUBKEY,
@@ -784,15 +784,15 @@ class TradingModule {
       })
       .instruction();
 
-    // 6. 创建交易并添加指令 / Create transaction and add instructions
+    // 6. Create transaction and add instructions
     const transaction = new Transaction();
     transaction.add(modifyComputeUnits);
     transaction.add(closeShortIx);
 
-    // 7. 返回交易对象和相关信息 / Return transaction object and related info
+    // 7. Return transaction object and related info
     return {
       transaction,
-      signers: [], // 平仓做空交易不需要额外的签名者，只需要 payer 签名 / Close short transaction doesn't need additional signers, only payer signature
+      signers: [], // Close short transaction doesn't need additional signers, only payer signature
       accounts: {
         mint: mint,
         curveAccount: accounts.curveAccount,
@@ -815,31 +815,31 @@ class TradingModule {
   // ========== PDA Calculation Methods ==========
 
   /**
-   * 计算 PDA 账户
+   * Calculate PDA accounts
    * @private
-   * @param {PublicKey} mintAccount - 代币铸造账户
-   * @returns {Object} PDA 账户对象
+   * @param {PublicKey} mintAccount - Token mint account
+   * @returns {Object} PDA accounts object
    */
   _calculatePDAAccounts(mintAccount) {
-    // 计算曲线账户 PDA
+    // Calculate the curve account PDA
     const [curveAccount] = PublicKey.findProgramAddressSync(
       [Buffer.from('borrowing_curve'), mintAccount.toBuffer()],
       this.sdk.programId
     );
 
-    // 计算池子代币账户 PDA
+    // Calculate the pool token account PDA
     const [poolTokenAccount] = PublicKey.findProgramAddressSync(
       [Buffer.from('pool_token'), mintAccount.toBuffer()],
       this.sdk.programId
     );
 
-    // 计算借贷池专用代币账户 PDA
+    // Calculate the borrow-pool-specific token account PDA
     const [poolBorrowTokenAccount] = PublicKey.findProgramAddressSync(
       [Buffer.from('pool_borrow_token'), mintAccount.toBuffer()],
       this.sdk.programId
     );
 
-    // 计算池子 SOL 账户 PDA
+    // Calculate the pool SOL account PDA
     const [poolSolAccount] = PublicKey.findProgramAddressSync(
       [Buffer.from('pool_sol'), mintAccount.toBuffer()],
       this.sdk.programId

package/src/sdk.js

@@ -1,12 +1,12 @@
 const anchor = require('@coral-xyz/anchor');
 const { PublicKey } = require('@solana/web3.js');
-// 统一使用 buffer 包，所有平台一致
+// Use the buffer package consistently across all platforms
 const { Buffer } = require('buffer');
 
-// 环境检测和条件加载
+// Environment detection and conditional loading
 const IS_NODE = typeof process !== 'undefined' && process.versions && process.versions.node;
 
-// 确保全局可用（兼容现有代码）
+// Ensure global availability (compatible with existing code)
 if (typeof global !== 'undefined' && !global.Buffer) {
   global.Buffer = Buffer;
 }
@@ -73,7 +73,7 @@ class Fun100xSdk {
     // Maximum number of orders to fetch during queries
     this.FIND_MAX_ORDERS_COUNT = 1000
 
-    // 在流动性不足时, 建议实际使用流动性的比例, 分每 (1000=100%)
+    // When liquidity is insufficient, the suggested ratio of liquidity to actually use, per-mille (1000=100%)
     this.SUGGEST_LIQ_RATIO = 975; // 97.5% (1000=100%)
 
     // Initialize Anchor program
@@ -92,20 +92,19 @@ class Fun100xSdk {
     this.curve = CurveAMM;
 
     /**
-     * 统一数据接口 - 根据 defaultDataSource 配置自动路由到 fast 或 chain 模块
      * Unified data interface - automatically routes to fast or chain module based on defaultDataSource config
      *
      * @example
-     * // 使用默认数据源获取订单
+     * // Fetch orders using the default data source
      * const ordersData = await sdk.data.orders(mint, { type: 'down_orders' });
      *
-     * // 临时指定数据源
+     * // Temporarily specify a data source
      * const ordersData = await sdk.data.orders(mint, {
      *   type: 'down_orders',
-     *   dataSource: 'chain'  // 临时使用链上数据源
+     *   dataSource: 'chain'  // Temporarily use the on-chain data source
      * });
      *
-     * // 获取用户订单
+     * // Fetch user orders
      * const userOrders = await sdk.data.user_orders(user, mint, {
      *   page: 1,
      *   limit: 200,
@@ -114,27 +113,27 @@ class Fun100xSdk {
      */
     this.data = {
       /**
-       * 获取代币订单数据
-       * @param {string} mint - 代币地址
-       * @param {Object} options - 查询参数，支持 dataSource 字段临时指定数据源
-       * @returns {Promise<Object>} 订单数据
+       * Get token orders data
+       * @param {string} mint - Token address
+       * @param {Object} options - Query parameters; supports the dataSource field to temporarily specify a data source
+       * @returns {Promise<Object>} Orders data
        */
       orders: (mint, options = {}) => this._getDataWithSource('orders', [mint, options]),
 
       /**
-       * 获取代币价格数据
-       * @param {string} mint - 代币地址
-       * @param {Object} options - 查询参数，支持 dataSource 字段临时指定数据源
-       * @returns {Promise<string>} 价格字符串
+       * Get token price data
+       * @param {string} mint - Token address
+       * @param {Object} options - Query parameters; supports the dataSource field to temporarily specify a data source
+       * @returns {Promise<string>} Price string
        */
       price: (mint, options = {}) => this._getDataWithSource('price', [mint, options]),
 
       /**
-       * 获取用户订单数据
-       * @param {string} user - 用户地址
-       * @param {string} mint - 代币地址
-       * @param {Object} options - 查询参数，支持 dataSource 字段临时指定数据源
-       * @returns {Promise<Object>} 用户订单数据
+       * Get user orders data
+       * @param {string} user - User address
+       * @param {string} mint - Token address
+       * @param {Object} options - Query parameters; supports the dataSource field to temporarily specify a data source
+       * @returns {Promise<Object>} User orders data
        */
       user_orders: (user, mint, options = {}) => this._getDataWithSource('user_orders', [user, mint, options])
     };
@@ -199,7 +198,7 @@ class Fun100xSdk {
 
 }
 
-// 将工具类作为静态属性添加到 Fun100xSdk 类
+// Add utility classes as static properties on the Fun100xSdk class
 Fun100xSdk.CurveAMM = CurveAMM;
 Fun100xSdk.OrderUtils = OrderUtils;