100x-sdk 1.0.5 → 1.0.6

package/dist/index.d.ts

@@ -187,6 +187,26 @@ export interface SimulationResult {
   suggestedSolAmount: string;
 }
 
+/** The leverage implied by the executable stop-loss price, not a maximum limit. */
+export interface StopLossSimulationResult {
+  executableStopLossPrice: bigint;
+  tradeAmount: bigint;
+  stopLossPercentage: number;
+  /** Existing four-decimal, downward-truncated value. */
+  leverage: number;
+  /** Rounded to two decimals from the original price ratio, with trailing zeros removed. Display only. */
+  leverageDisplay: string;
+  currentPrice: bigint;
+  iterations: number;
+  originalStopLossPrice: bigint;
+  close_insert_indices: number[];
+  estimatedMargin: bigint;
+  rawSellSol?: bigint;
+  buyTokenAmount?: bigint;
+  sellTokenAmount?: bigint;
+  adjustmentIterations?: number;
+}
+
 // ========================= Utility Related Types =========================
 
 export interface FindPrevNextResult {
@@ -238,8 +258,10 @@ export interface ParamModule {
 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>;
+  simulateLongStopLoss(mint: string, buyTokenAmount: bigint | string | number, stopLossPrice: bigint | string | number, lastPrice?: any, ordersData?: any, borrowFee?: number | null): Promise<StopLossSimulationResult>;
+  simulateShortStopLoss(mint: string, sellTokenAmount: bigint | string | number, stopLossPrice: bigint | string | number, lastPrice?: any, ordersData?: any, borrowFee?: number | null): Promise<StopLossSimulationResult>;
+  simulateLongSolStopLoss(mint: string, buySolAmount: bigint | string | number, stopLossPrice: bigint | string | number, lastPrice?: any, ordersData?: any, borrowFee?: number | null, initialVirtualSol?: string | number | null, initialVirtualToken?: string | number | null, curveAccount?: any): Promise<StopLossSimulationResult>;
+  simulateShortSolStopLoss(mint: string, sellSolAmount: bigint | string | number, stopLossPrice: bigint | string | number, lastPrice?: any, ordersData?: any, borrowFee?: number | null, initialVirtualSol?: string | number | null, initialVirtualToken?: string | number | null, curveAccount?: any): Promise<StopLossSimulationResult>;
 }
 
 // ========================= Data Interface Types =========================

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "100x-sdk",
-  "version": "1.0.5",
+  "version": "1.0.6",
   "description": "Solana 100x.fun SDK",
   "main": "dist/100x-sdk.cjs.js",
   "module": "dist/100x-sdk.esm.js",
@@ -21,7 +21,7 @@
     "build": "rollup -c",
     "build:dev": "rollup -c -w",
     "build:types": "cp src/types/index.d.ts dist/index.d.ts",
-    "test": "mocha tests/unit/**/*.test.js",
+    "test": "mocha \"{test,tests/unit}/**/*.test.js\"",
     "test:integration": "mocha tests/integration/**/*.test.js",
     "lint": "eslint src"
   },

package/src/modules/simulator/buy_sell_token.js

@@ -1,6 +1,7 @@
 
 
 const { calcLiqTokenBuy, calcLiqTokenSell } = require('./calcLiq');
+const { formatRatio } = require('./precision');
 
 /**
  * Simulate token buy transaction - calculate if target token amount can be purchased
@@ -95,8 +96,7 @@ async function simulateTokenBuy(mint, buyTokenAmount, passOrder = null, lastPric
     if (freeTokenAmount >= buyTokenAmountBig) {
       completionPercentage = "100.0";
     } else {
-      const percentage = Math.floor((Number(freeTokenAmount) / Number(buyTokenAmountBig)) * 1000) / 10;
-      completionPercentage = percentage.toFixed(1);
+      completionPercentage = formatRatio(freeTokenAmount, buyTokenAmountBig, 1, 100n);
     }
 
     // 2. Calculate slippage percentage and get final SOL amount
@@ -107,8 +107,7 @@ async function simulateTokenBuy(mint, buyTokenAmount, passOrder = null, lastPric
     if (realSolAmount > 0n) {
       // Normal case: calculate slippage
       const diff = idealSolAmount > realSolAmount ? idealSolAmount - realSolAmount : realSolAmount - idealSolAmount;
-      const slippage = Math.floor((Number(diff) / Number(idealSolAmount)) * 1000) / 10;
-      slippagePercentage = slippage.toFixed(1);
+      slippagePercentage = formatRatio(diff, idealSolAmount, 1, 100n);
     } else {
       // Special case: real SOL amount is 0, need to recalculate with suggested liquidity
       const suggestedAmount = (freeTokenAmount * BigInt(this.sdk.SUGGEST_LIQ_RATIO)) / 1000n;
@@ -133,8 +132,7 @@ async function simulateTokenBuy(mint, buyTokenAmount, passOrder = null, lastPric
       finalRealSolAmount = recalcRealSol;
       
       const diff = recalcIdealSol > recalcRealSol ? recalcIdealSol - recalcRealSol : recalcRealSol - recalcIdealSol;
-      const slippage = Math.floor((Number(diff) / Number(recalcIdealSol)) * 1000) / 10;
-      slippagePercentage = slippage.toFixed(1);
+      slippagePercentage = formatRatio(diff, recalcIdealSol, 1, 100n);
     }
 
     // 3. Calculate suggested liquidity
@@ -253,8 +251,7 @@ async function simulateTokenSell(mint, sellTokenAmount, passOrder = null, lastPr
     if (freeTokenAmount >= sellTokenAmountBig) {
       completionPercentage = "100.0";
     } else {
-      const percentage = Math.floor((Number(freeTokenAmount) / Number(sellTokenAmountBig)) * 1000) / 10;
-      completionPercentage = percentage.toFixed(1);
+      completionPercentage = formatRatio(freeTokenAmount, sellTokenAmountBig, 1, 100n);
     }
 
     // 2. Calculate slippage percentage and get final SOL amount
@@ -265,8 +262,7 @@ async function simulateTokenSell(mint, sellTokenAmount, passOrder = null, lastPr
     if (realSolAmount > 0n) {
       // Normal case: calculate slippage
       const diff = idealSolAmount > realSolAmount ? idealSolAmount - realSolAmount : realSolAmount - idealSolAmount;
-      const slippage = Math.floor((Number(diff) / Number(idealSolAmount)) * 1000) / 10;
-      slippagePercentage = slippage.toFixed(1);
+      slippagePercentage = formatRatio(diff, idealSolAmount, 1, 100n);
     } else {
       // Special case: real SOL amount is 0, need to recalculate with suggested liquidity
       const suggestedAmount = (freeTokenAmount * BigInt(this.sdk.SUGGEST_LIQ_RATIO)) / 1000n;
@@ -291,8 +287,7 @@ async function simulateTokenSell(mint, sellTokenAmount, passOrder = null, lastPr
       finalRealSolAmount = recalcRealSol;
       
       const diff = recalcIdealSol > recalcRealSol ? recalcIdealSol - recalcRealSol : recalcRealSol - recalcIdealSol;
-      const slippage = Math.floor((Number(diff) / Number(recalcIdealSol)) * 1000) / 10;
-      slippagePercentage = slippage.toFixed(1);
+      slippagePercentage = formatRatio(diff, recalcIdealSol, 1, 100n);
     }
 
     // 3. Calculate suggested liquidity

package/src/modules/simulator/long_shrot_stop.js

@@ -4,6 +4,7 @@ const CurveAMM = require('../../utils/curve_amm');
 const {transformOrdersData , checkPriceRangeOverlap} = require('./stop_loss_utils')
 const { PRICE_ADJUSTMENT_PERCENTAGE, MIN_STOP_LOSS_PERCENT } = require('./utils');
 const JSONbig = require('json-bigint')({ storeAsString: false });
+const { formatRatio, ceilDiv } = require('./precision');
 
 /**
  * Simulate long position stop loss calculation
@@ -35,10 +36,11 @@ const JSONbig = require('json-bigint')({ storeAsString: false });
  *   - For example: 3.5 means the stop loss price is 3.5% lower than the current price
  *   - For a long position this value should be positive (stop loss price below current price)
  *
- * @returns {number} returns.leverage - Leverage ratio
+ * @returns {number} returns.leverage - Leverage ratio (existing four-decimal downward truncation)
  *   - Formula: currentPrice / (currentPrice - executableStopLossPrice)
  *   - For example: 28.57 means about 28.57x leverage
  *   - The higher the leverage, the higher the risk, but also the higher the potential return
+ * @returns {string} returns.leverageDisplay - Rounded display value derived from the executable stop-loss price; not a maximum leverage limit
  *
  * @returns {bigint} returns.currentPrice - Current price (u128 format)
  *   - The current token price used in the calculation
@@ -272,10 +274,17 @@ async function simulateLongStopLoss(mint, buyTokenAmount, stopLossPrice, lastPri
         // Calculate stop loss percentage
         let stopLossPercentage = 0;
         let leverage = 1;
+        let leverageDisplay = '1';
 
         if (currentPrice !== executableStopLossPrice) {
-            stopLossPercentage = Number((BigInt(10000) * (currentPrice - executableStopLossPrice)) / currentPrice) / 100;
-            leverage = Number((BigInt(10000) * currentPrice) / (currentPrice - executableStopLossPrice)) / 10000;
+            const priceDiff = currentPrice - executableStopLossPrice;
+            stopLossPercentage = priceDiff >= 0n
+                ? Number(formatRatio(priceDiff, currentPrice, 2, 100n))
+                : Number((10000n * priceDiff) / currentPrice) / 100;
+            leverage = Number((10000n * currentPrice) / priceDiff) / 10000;
+            leverageDisplay = priceDiff > 0n
+                ? formatRatio(currentPrice, priceDiff, 2, 1n, 'half-up', true)
+                : String(leverage);
         }
 
         // Calculate margin requirement
@@ -311,6 +320,7 @@ async function simulateLongStopLoss(mint, buyTokenAmount, stopLossPrice, lastPri
             tradeAmount: finalTradeAmount, // SOL output amount
             stopLossPercentage: stopLossPercentage, // Stop loss percentage relative to current price
             leverage: leverage, // Leverage ratio
+            leverageDisplay: leverageDisplay, // Rounded display value; leverage keeps its existing meaning
             currentPrice: currentPrice, // Current price
             iterations: iteration, // Number of adjustments
             originalStopLossPrice: BigInt(stopLossPrice), // Original stop loss price
@@ -355,10 +365,11 @@ async function simulateLongStopLoss(mint, buyTokenAmount, stopLossPrice, lastPri
  *   - For example: 3.5 means the stop loss price is 3.5% higher than the current price
  *   - For a short position this value should be positive (stop loss price above current price)
  *
- * @returns {number} returns.leverage - Leverage ratio
+ * @returns {number} returns.leverage - Leverage ratio (existing four-decimal downward truncation)
  *   - Formula: currentPrice / (executableStopLossPrice - currentPrice)
  *   - For example: 28.57 means about 28.57x leverage
  *   - The higher the leverage, the higher the risk, but also the higher the potential return
+ * @returns {string} returns.leverageDisplay - Rounded display value derived from the executable stop-loss price; not a maximum leverage limit
  *
  * @returns {bigint} returns.currentPrice - Current price (u128 format)
  *   - The current token price used in the calculation
@@ -584,11 +595,17 @@ async function simulateShortStopLoss(mint, sellTokenAmount, stopLossPrice, lastP
 
         // Calculate stop loss percentage
         // For short position, stop loss price is higher than current price, so it's a positive percentage
-        const stopLossPercentage = Number((BigInt(10000) * (executableStopLossPrice - currentPrice)) / currentPrice) / 100;
+        const priceDiff = executableStopLossPrice - currentPrice;
+        const stopLossPercentage = priceDiff >= 0n
+            ? Number(formatRatio(priceDiff, currentPrice, 2, 100n))
+            : Number((10000n * priceDiff) / currentPrice) / 100;
 
         // Calculate leverage ratio
         // For short position, leverage = current price / (stop loss price - current price)
-        const leverage = Number((BigInt(10000) * currentPrice) / (executableStopLossPrice - currentPrice)) / 10000;
+        const leverage = Number((10000n * currentPrice) / priceDiff) / 10000;
+        const leverageDisplay = priceDiff > 0n
+            ? formatRatio(currentPrice, priceDiff, 2, 1n, 'half-up', true)
+            : String(leverage);
 
         // Calculate margin requirement
         // Consistent with the contract formula (long_short.rs lines 890-894):
@@ -628,6 +645,7 @@ async function simulateShortStopLoss(mint, sellTokenAmount, stopLossPrice, lastP
             tradeAmount: finalTradeAmount, // SOL input amount (SOL needed to buy back tokens at close)
             stopLossPercentage: stopLossPercentage, // Stop loss percentage relative to current price
             leverage: leverage, // Leverage ratio
+            leverageDisplay: leverageDisplay, // Rounded display value; leverage keeps its existing meaning
             currentPrice: currentPrice, // Current price
             iterations: iteration, // Number of adjustments
             originalStopLossPrice: BigInt(stopLossPrice), // Original stop loss price
@@ -755,8 +773,9 @@ async function simulateLongSolStopLoss(mint, buySolAmount, stopLossPrice, lastPr
         // Calculate dynamic binary search upper bound based on leverage
         const stopLossPriceBigInt = BigInt(stopLossPrice);
         const priceDiff = currentPrice - stopLossPriceBigInt;
-        const estimatedLeverage = priceDiff > 0n ? Number(currentPrice * 10000n / priceDiff) / 10000 : 10;
-        const safeMultiplier = BigInt(Math.ceil(estimatedLeverage * 3)); // 3x safety factor
+        // Keep the original four-decimal leverage truncation used to size the search range.
+        const scaledLeverage = priceDiff > 0n ? currentPrice * 10000n / priceDiff : 100000n;
+        const safeMultiplier = ceilDiv(scaledLeverage * 3n, 10000n); // 3x safety factor
         const multiplier = safeMultiplier > 10n ? safeMultiplier : 10n; // minimum 10x
 
         // Use a binary search algorithm to find the maximum estimatedMargin that is less than buySolAmount
@@ -941,8 +960,9 @@ async function simulateShortSolStopLoss(mint, sellSolAmount, stopLossPrice, last
         // Calculate dynamic binary search upper bound based on leverage
         const stopLossPriceBigInt = BigInt(stopLossPrice);
         const priceDiff = stopLossPriceBigInt - currentPrice;
-        const estimatedLeverage = priceDiff > 0n ? Number(currentPrice * 10000n / priceDiff) / 10000 : 10;
-        const safeMultiplier = BigInt(Math.ceil(estimatedLeverage * 3)); // 3x safety factor
+        // Keep the original four-decimal leverage truncation used to size the search range.
+        const scaledLeverage = priceDiff > 0n ? currentPrice * 10000n / priceDiff : 100000n;
+        const safeMultiplier = ceilDiv(scaledLeverage * 3n, 10000n); // 3x safety factor
         const multiplier = safeMultiplier > 10n ? safeMultiplier : 10n; // minimum 10x
 
         // Use a binary search algorithm to find the maximum estimatedMargin that is less than sellSolAmount

package/src/modules/simulator/precision.js

@@ -0,0 +1,32 @@
+/** Format a non-negative integer ratio without converting its operands to Number. */
+function formatRatio(numerator, denominator, decimals, multiplier = 1n, rounding = 'down', trim = false) {
+  numerator = BigInt(numerator);
+  denominator = BigInt(denominator);
+  if (numerator < 0n || denominator <= 0n || !Number.isInteger(decimals) || decimals < 0) {
+    throw new RangeError('Invalid ratio');
+  }
+
+  const factor = 10n ** BigInt(decimals);
+  const scaledNumerator = numerator * multiplier * factor;
+  let quotient = scaledNumerator / denominator;
+  if (rounding === 'half-up') {
+    if ((scaledNumerator % denominator) * 2n >= denominator) quotient++;
+  } else if (rounding !== 'down') {
+    throw new RangeError('Invalid rounding mode');
+  }
+
+  if (decimals === 0) return quotient.toString();
+  const integer = quotient / factor;
+  const fraction = (quotient % factor).toString().padStart(decimals, '0');
+  const value = `${integer}.${fraction}`;
+  return trim ? value.replace(/\.?0+$/, '') : value;
+}
+
+function ceilDiv(numerator, denominator) {
+  numerator = BigInt(numerator);
+  denominator = BigInt(denominator);
+  if (numerator < 0n || denominator <= 0n) throw new RangeError('Invalid division');
+  return (numerator + denominator - 1n) / denominator;
+}
+
+module.exports = { formatRatio, ceilDiv };

package/src/modules/simulator.js

@@ -339,9 +339,9 @@ class SimulatorModule {
             const tokenSellResult = await this.simulateTokenSell(mint, tokenAmountBigInt, null, priceResult, ordersResult);
 
             // Estimate ideal SOL amount
-            const priceDecimal = CurveAMM.u128ToDecimal(currentPrice);
-            const tokenInDecimal = Number(tokenAmountBigInt) / 1e9; // Convert token lamports to tokens (9-digit precision)
-            const estimatedSolAmount = BigInt(Math.floor((tokenInDecimal * priceDecimal) * 1e9)); // Convert to SOL lamports
+            // Token and SOL both use 9 decimals, so their unit conversions cancel out.
+            const priceScale = BigInt(CurveAMM.PRICE_PRECISION_FACTOR_DECIMAL.toFixed(0));
+            const estimatedSolAmount = tokenAmountBigInt * currentPrice / priceScale;
 
             // Transform result to match simulateSell format
             return {

package/src/types/index.d.ts

@@ -187,6 +187,26 @@ export interface SimulationResult {
   suggestedSolAmount: string;
 }
 
+/** The leverage implied by the executable stop-loss price, not a maximum limit. */
+export interface StopLossSimulationResult {
+  executableStopLossPrice: bigint;
+  tradeAmount: bigint;
+  stopLossPercentage: number;
+  /** Existing four-decimal, downward-truncated value. */
+  leverage: number;
+  /** Rounded to two decimals from the original price ratio, with trailing zeros removed. Display only. */
+  leverageDisplay: string;
+  currentPrice: bigint;
+  iterations: number;
+  originalStopLossPrice: bigint;
+  close_insert_indices: number[];
+  estimatedMargin: bigint;
+  rawSellSol?: bigint;
+  buyTokenAmount?: bigint;
+  sellTokenAmount?: bigint;
+  adjustmentIterations?: number;
+}
+
 // ========================= Utility Related Types =========================
 
 export interface FindPrevNextResult {
@@ -238,8 +258,10 @@ export interface ParamModule {
 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>;
+  simulateLongStopLoss(mint: string, buyTokenAmount: bigint | string | number, stopLossPrice: bigint | string | number, lastPrice?: any, ordersData?: any, borrowFee?: number | null): Promise<StopLossSimulationResult>;
+  simulateShortStopLoss(mint: string, sellTokenAmount: bigint | string | number, stopLossPrice: bigint | string | number, lastPrice?: any, ordersData?: any, borrowFee?: number | null): Promise<StopLossSimulationResult>;
+  simulateLongSolStopLoss(mint: string, buySolAmount: bigint | string | number, stopLossPrice: bigint | string | number, lastPrice?: any, ordersData?: any, borrowFee?: number | null, initialVirtualSol?: string | number | null, initialVirtualToken?: string | number | null, curveAccount?: any): Promise<StopLossSimulationResult>;
+  simulateShortSolStopLoss(mint: string, sellSolAmount: bigint | string | number, stopLossPrice: bigint | string | number, lastPrice?: any, ordersData?: any, borrowFee?: number | null, initialVirtualSol?: string | number | null, initialVirtualToken?: string | number | null, curveAccount?: any): Promise<StopLossSimulationResult>;
 }
 
 // ========================= Data Interface Types =========================

package/src/utils/constants.js

@@ -9,8 +9,8 @@ const DEFAULT_NETWORKS = {
     network: 'mainnet',
     programId: 'sGecRTjTZmnqJBmLK4ZMNCzsaMrgkFfNqEcYk1GhRde',
     defaultDataSource: 'fast',
-    solanaEndpoint: 'https://solana-rpc.pinpet.fun',
-    fastApiUrl: 'https://api.pinpet.fun/',
+    solanaEndpoint: 'https://solana-rpc.100x.fun',
+    fastApiUrl: 'https://api.100x.fun/',
     feeRecipient: 'CmDe8JRAPJ7QpZNCb4ArVEyzyxYoCNL7WZw5qXLePULn',
     baseFeeRecipient: '2xhAfEfnH8wg7ZGujSijJi4Zt4ge1ZuwMypo7etntgXA',
     paramsAccount: 'CJSn3n4MVCg4qWQ7qb2nxzosYwfcRyBvmwhtM77ugu1V'
@@ -21,7 +21,7 @@ const DEFAULT_NETWORKS = {
     programId: 'sGecRTjTZmnqJBmLK4ZMNCzsaMrgkFfNqEcYk1GhRde',
     defaultDataSource: 'fast',
     solanaEndpoint: 'https://lu-ura5lv-fast-devnet.helius-rpc.com',
-    fastApiUrl: 'https://devtestapi.pinpet.fun',
+    fastApiUrl: 'https://devtestapi.100x.fun',
     feeRecipient: 'GesAj2dTn2wdNcxj4x8qsqS9aNRVPBPkE76aaqg7skxu',
     baseFeeRecipient: '5YHi1HsxobLiTD6NQfHJQpoPoRjMuNyXp4RroTvR6dKi',
     paramsAccount: 'Ckz5CmbpyKtKmwgw7NDLzFnVACxekWqrX8i6vhCyLkqY'
@@ -33,8 +33,6 @@ const DEFAULT_NETWORKS = {
     defaultDataSource: 'fast', // 'fast' or 'chain'
     solanaEndpoint: 'http://127.0.0.1:8899',
     fastApiUrl: 'http://127.0.0.1:3000',
-    // solanaEndpoint: 'http://216.158.231.58:8899',
-    // fastApiUrl: 'http://216.158.231.58:3000',
     feeRecipient: 'GesAj2dTn2wdNcxj4x8qsqS9aNRVPBPkE76aaqg7skxu',
     baseFeeRecipient: '5YHi1HsxobLiTD6NQfHJQpoPoRjMuNyXp4RroTvR6dKi',
     paramsAccount: 'HPuvtLLcgSMPSyRmULPiFe9oAvm1o8mR4weqXZrUhzRM'