100x-sdk 1.0.2 → 1.0.4

package/src/modules/param.js

@@ -1,6 +1,6 @@
 const { PublicKey, Transaction, SystemProgram } = require('@solana/web3.js');
 const anchor = require('@coral-xyz/anchor');
-// 统一使用 buffer 包，所有平台一致
+// Use the buffer package consistently across all platforms
 const { Buffer } = require('buffer');
 
 /**
@@ -73,7 +73,7 @@ class ParamModule {
    * @returns {Promise<Object>} Parameters account data
    */
   async getParams(partner) {
-    // 计算合作伙伴参数账户地址
+    // Calculate partner parameters account address
     const [paramsAccount] = PublicKey.findProgramAddressSync(
       [Buffer.from("params"), partner.toBuffer()],
       this.sdk.programId
@@ -117,13 +117,13 @@ class ParamModule {
     );
 
     try {
-      // 检查账户是否存在
+      // Check if account exists
       const accountInfo = await this.sdk.connection.getAccountInfo(adminAccount);
       if (!accountInfo) {
         throw new Error('Admin account does not exist');
       }
-      
-      // 尝试使用 Anchor 解析数据
+
+      // Try to parse data using Anchor
       if (this.sdk.program.account.admin) {
         const adminData = await this.sdk.program.account.admin.fetch(adminAccount);
         return {
@@ -131,7 +131,7 @@ class ParamModule {
           data: adminData
         };
       } else {
-        // 如果 Anchor 不可用，返回基本信息
+        // If Anchor is not available, return basic info
         return {
           address: adminAccount,
           accountInfo: accountInfo

package/src/modules/simulator/buy_sell_token.js

@@ -4,10 +4,9 @@ const { calcLiqTokenBuy, calcLiqTokenSell } = require('./calcLiq');
 
 /**
  * Simulate token buy transaction - calculate if target token amount can be purchased
- * 模拟以 Token 数量为目标的买入交易 - 计算是否能买到指定数量的 Token
- * @param {string} mint - Token address 代币地址
- * @param {bigint|string|number} buyTokenAmount - Target token amount to buy 目标购买的 Token 数量
- * @param {string} passOrder - Optional order address to skip (won't be liquidated) 可选的跳过订单地址
+ * @param {string} mint - Token address
+ * @param {bigint|string|number} buyTokenAmount - Target token amount to buy
+ * @param {string} passOrder - Optional order address to skip (won't be liquidated)
  * @param {Object|null} lastPrice - Token price info, default null
  * @param {Object|null} ordersData - Orders response object, default null
  * @returns {Promise<Object>} Token buy simulation result with the following structure:
@@ -27,7 +26,7 @@ const { calcLiqTokenBuy, calcLiqTokenSell } = require('./calcLiq');
  *   - suggestedSolAmount: {string} Required SOL amount for suggested token purchase
  */
 async function simulateTokenBuy(mint, buyTokenAmount, passOrder = null, lastPrice = null, ordersData = null, curveData = null) {
-  // 获取价格和订单数据
+  // Get price and orders data
 
   //console.log('simulateTokenBuy', mint, buyTokenAmount, passOrder, lastPrice, ordersData);
 
@@ -42,14 +41,14 @@ async function simulateTokenBuy(mint, buyTokenAmount, passOrder = null, lastPric
       type: 'up_orders',
       limit: this.sdk.MAX_ORDERS_COUNT + 1
     });
-    // 提取实际的订单数组
+    // Extract the actual orders array
     orders = ordersResponse.data.orders;
   } else {
-    // 如果传入了 ordersData，从响应对象中提取订单数组并限制长度
+    // If ordersData is provided, extract the orders array from the response object and limit its length
     orders = ordersData.data.orders.slice(0, this.sdk.MAX_ORDERS_COUNT + 1);
   }
 
-  // 获取动态流动池参数（支持外部传入，避免重复请求）
+  // Get dynamic liquidity pool parameters (supports external input to avoid duplicate requests)
   if (!curveData) {
     try {
       curveData = await this.sdk.chain.getCurveAccount(mint, { skipBalances: true });
@@ -58,7 +57,7 @@ async function simulateTokenBuy(mint, buyTokenAmount, passOrder = null, lastPric
     }
   }
 
-  // 调用 calcLiqTokenBuy 进行流动性计算（传入动态流动池参数）
+  // Call calcLiqTokenBuy to perform liquidity calculation (passing dynamic liquidity pool parameters)
   try {
     const liqResult = calcLiqTokenBuy(
       price,
@@ -73,16 +72,16 @@ async function simulateTokenBuy(mint, buyTokenAmount, passOrder = null, lastPric
     // console.log("liqResult:",liqResult);
 
 
-    // console.log('\n=== calcLiqTokenBuy 返回结果 ===');
-    // console.log('自由流动性 SOL 总量:', liqResult.free_lp_sol_amount_sum.toString());
-    // console.log('自由流动性 Token 总量:', liqResult.free_lp_token_amount_sum.toString());
-    // console.log('锁定流动性 SOL 总量:', liqResult.lock_lp_sol_amount_sum.toString());
-    // console.log('锁定流动性 Token 总量:', liqResult.lock_lp_token_amount_sum.toString());
-    // console.log('是否包含无限流动性:', liqResult.has_infinite_lp);
-    // console.log('跳过的订单索引:', liqResult.pass_order_id);
-    // console.log('需要强平的订单数量:', liqResult.force_close_num);
-    // console.log('理想 SOL 使用量:', liqResult.ideal_lp_sol_amount.toString());
-    // console.log('实际 SOL 使用量:', liqResult.real_lp_sol_amount.toString());
+    // console.log('\n=== calcLiqTokenBuy return result ===');
+    // console.log('Free liquidity SOL total:', liqResult.free_lp_sol_amount_sum.toString());
+    // console.log('Free liquidity Token total:', liqResult.free_lp_token_amount_sum.toString());
+    // console.log('Locked liquidity SOL total:', liqResult.lock_lp_sol_amount_sum.toString());
+    // console.log('Locked liquidity Token total:', liqResult.lock_lp_token_amount_sum.toString());
+    // console.log('Whether includes infinite liquidity:', liqResult.has_infinite_lp);
+    // console.log('Skipped order index:', liqResult.pass_order_id);
+    // console.log('Number of orders needing force close:', liqResult.force_close_num);
+    // console.log('Ideal SOL usage:', liqResult.ideal_lp_sol_amount.toString());
+    // console.log('Actual SOL usage:', liqResult.real_lp_sol_amount.toString());
     // console.log('===============================\n');
 
     // Convert to BigInt for calculations
@@ -164,7 +163,7 @@ async function simulateTokenBuy(mint, buyTokenAmount, passOrder = null, lastPric
  * Simulate token sell transaction analysis
  * @param {string} mint - Token address
  * @param {bigint|string|number} sellTokenAmount - Token amount to sell (u64 format, precision 10^9)
- * @param {string} passOrder - Optional order address to skip (won't be liquidated) 可选的跳过订单地址
+ * @param {string} passOrder - Optional order address to skip (won't be liquidated)
  * @param {Object|null} lastPrice - Token price info, default null
  * @param {Object|null} ordersData - Orders response object, default null
  * @returns {Promise<Object>} Token sell simulation result with the following structure:
@@ -184,7 +183,7 @@ async function simulateTokenBuy(mint, buyTokenAmount, passOrder = null, lastPric
  *   - suggestedSolAmount: {string} Expected SOL amount from suggested token sale
  */
 async function simulateTokenSell(mint, sellTokenAmount, passOrder = null, lastPrice = null, ordersData = null, curveData = null) {
-  // 获取价格和订单数据
+  // Get price and orders data
   let price = lastPrice;
   if (!price) {
     price = await this.sdk.data.price(mint);
@@ -198,14 +197,14 @@ async function simulateTokenSell(mint, sellTokenAmount, passOrder = null, lastPr
       type: 'down_orders',
       limit: this.sdk.MAX_ORDERS_COUNT + 1
     });
-    // 提取实际的订单数组
+    // Extract the actual orders array
     orders = ordersResponse.data.orders;
   } else {
-    // 如果传入了 ordersData，从响应对象中提取订单数组并限制长度
+    // If ordersData is provided, extract the orders array from the response object and limit its length
     orders = ordersData.data.orders.slice(0, this.sdk.MAX_ORDERS_COUNT + 1);
   }
 
-  // 获取动态流动池参数（支持外部传入，避免重复请求）
+  // Get dynamic liquidity pool parameters (supports external input to avoid duplicate requests)
   if (!curveData) {
     try {
       curveData = await this.sdk.chain.getCurveAccount(mint, { skipBalances: true });
@@ -214,12 +213,12 @@ async function simulateTokenSell(mint, sellTokenAmount, passOrder = null, lastPr
     }
   }
 
-  // console.log('simulateTokenSell 获取的数据:');
-  // console.log('价格:', price);
-  // console.log('订单数量:', orders.length);
-  // orders.forEach((order, i) => console.log(`订单${i}: start=${order.lock_lp_start_price}, end=${order.lock_lp_end_price}, sol=${order.lock_lp_sol_amount}, token=${order.lock_lp_token_amount}`));
+  // console.log('Data obtained by simulateTokenSell:');
+  // console.log('Price:', price);
+  // console.log('Number of orders:', orders.length);
+  // orders.forEach((order, i) => console.log(`Order ${i}: start=${order.lock_lp_start_price}, end=${order.lock_lp_end_price}, sol=${order.lock_lp_sol_amount}, token=${order.lock_lp_token_amount}`));
 
-  // 调用 calcLiqTokenSell 进行流动性计算（传入动态流动池参数）
+  // Call calcLiqTokenSell to perform liquidity calculation (passing dynamic liquidity pool parameters)
   try {
     const liqResult = calcLiqTokenSell(
       price,
@@ -231,16 +230,16 @@ async function simulateTokenSell(mint, sellTokenAmount, passOrder = null, lastPr
       curveData.initialVirtualToken
     );
 
-    // console.log('\n=== calcLiqTokenSell 返回结果 ===');
-    // console.log('自由流动性 SOL 总量:', liqResult.free_lp_sol_amount_sum.toString());
-    // console.log('自由流动性 Token 总量:', liqResult.free_lp_token_amount_sum.toString());
-    // console.log('锁定流动性 SOL 总量:', liqResult.lock_lp_sol_amount_sum.toString());
-    // console.log('锁定流动性 Token 总量:', liqResult.lock_lp_token_amount_sum.toString());
-    // console.log('是否包含无限流动性:', liqResult.has_infinite_lp);
-    // console.log('跳过的订单索引:', liqResult.pass_order_id);
-    // console.log('需要强平的订单数量:', liqResult.force_close_num);
-    // console.log('理想 SOL 获得量:', liqResult.ideal_lp_sol_amount.toString());
-    // console.log('实际 SOL 获得量:', liqResult.real_lp_sol_amount.toString());
+    // console.log('\n=== calcLiqTokenSell return result ===');
+    // console.log('Free liquidity SOL total:', liqResult.free_lp_sol_amount_sum.toString());
+    // console.log('Free liquidity Token total:', liqResult.free_lp_token_amount_sum.toString());
+    // console.log('Locked liquidity SOL total:', liqResult.lock_lp_sol_amount_sum.toString());
+    // console.log('Locked liquidity Token total:', liqResult.lock_lp_token_amount_sum.toString());
+    // console.log('Whether includes infinite liquidity:', liqResult.has_infinite_lp);
+    // console.log('Skipped order index:', liqResult.pass_order_id);
+    // console.log('Number of orders needing force close:', liqResult.force_close_num);
+    // console.log('Ideal SOL obtained:', liqResult.ideal_lp_sol_amount.toString());
+    // console.log('Actual SOL obtained:', liqResult.real_lp_sol_amount.toString());
     // console.log('===============================\n');
 
     // Convert to BigInt for calculations