@lifi/perps-sdk 20.1.1 → 21.1.0

package/src/utils/scaleToInteger.ts

@@ -1,56 +0,0 @@
-import { PerpsErrorCode } from '@lifi/perps-types'
-import Big from 'big.js'
-import { PerpsError } from '../errors/PerpsError.js'
-
-/**
- * Off-grid resolution for {@link scaleToInteger}:
- * - `truncate` — toward zero, for sizes and collateral amounts. The wire
- *   value never exceeds the caller's intent.
- * - `round` — half away from zero, for prices, which snap to the nearest
- *   tick.
- * @public
- */
-export type ScaleToIntegerPolicy = 'truncate' | 'round'
-
-/**
- * Scale a human-readable decimal string to a scaled integer in exact decimal
- * arithmetic — an on-grid input maps to its exact scaled integer with no
- * binary float artifacts (`'0.29'` at 2 decimals is 29, never 28).
- * Off-grid input resolves per `policy`; there is no silent default.
- *
- * @throws {PerpsError} `ValidationError` when `value` is not a decimal
- *   numeric string, `decimals` is not a non-negative integer, or the scaled
- *   result's magnitude exceeds `Number.MAX_SAFE_INTEGER`.
- * @public
- */
-export const scaleToInteger = (
-  value: string,
-  decimals: number,
-  policy: ScaleToIntegerPolicy
-): number => {
-  if (!Number.isInteger(decimals) || decimals < 0) {
-    throw new PerpsError(
-      PerpsErrorCode.ValidationError,
-      `Invalid decimals for integer scaling: ${decimals}`
-    )
-  }
-  let parsed: Big
-  try {
-    parsed = new Big(value)
-  } catch {
-    throw new PerpsError(
-      PerpsErrorCode.ValidationError,
-      `Invalid decimal string for integer scaling: '${value}'`
-    )
-  }
-  const scaled = parsed
-    .times(new Big(10).pow(decimals))
-    .round(0, policy === 'truncate' ? Big.roundDown : Big.roundHalfUp)
-  if (scaled.abs().gt(Number.MAX_SAFE_INTEGER)) {
-    throw new PerpsError(
-      PerpsErrorCode.ValidationError,
-      `Scaled value ${scaled.toFixed()} exceeds Number.MAX_SAFE_INTEGER and cannot be encoded exactly.`
-    )
-  }
-  return scaled.toNumber()
-}

package/src/utils/units.ts

@@ -1,39 +0,0 @@
-/**
- * Token unit conversion utilities.
- */
-
-import { formatUnits } from 'viem'
-
-/**
- * Convert a base-unit amount (bigint string) to a human-readable decimal string.
- *
- * @param amount - Amount in base units (e.g. "1000000" for 1 USDC)
- * @param decimals - Token decimals (e.g. 6 for USDC)
- * @returns Decimal string (e.g. "1.0"); `"0"` when `amount` is not a valid
- *   bigint
- * @example
- * ```ts
- * fromBaseUnits('1000000', 6) // '1'
- * ```
- * @public
- */
-export function fromBaseUnits(amount: string, decimals: number): string {
-  try {
-    return formatUnits(BigInt(amount), decimals)
-  } catch {
-    return '0'
-  }
-}
-
-/**
- * Convert a base-unit amount to a number.
- *
- * @param amount - Amount in base units
- * @param decimals - Token decimals
- * @returns Numeric value, or 0 if parsing fails
- * @public
- */
-export function fromBaseUnitsNumber(amount: string, decimals: number): number {
-  const value = Number(fromBaseUnits(amount, decimals))
-  return Number.isFinite(value) ? value : 0
-}

package/src/utils/validation.ts

@@ -1,38 +0,0 @@
-/**
- * Order validation utilities.
- */
-
-/**
- * Validate margin input against available balance and exchange minimums.
- *
- * @param margin - Margin amount in USD
- * @param _leverage - Position leverage (reserved for future use)
- * @param availableBalance - Available balance, or null if unknown
- * @param _feeRate - Fee rate as decimal, or null if unknown (reserved for future use)
- * @param minMarginUsd - Minimum margin requirement in USD (exchange-specific).
- *   Source this from the selected provider's `minOrderValueUsd` metadata
- *   (see `@lifi/perps-types` `Provider`) rather than a client-side constant.
- * @returns Error code: 'insufficient' | 'below-minimum' | '' (valid)
- * @public
- */
-export function validateMargin(
-  margin: number,
-  _leverage: number,
-  availableBalance: number | null,
-  _feeRate: number | null,
-  minMarginUsd: number
-): string {
-  if (margin <= 0) {
-    return ''
-  }
-
-  if (availableBalance !== null && margin > availableBalance) {
-    return 'insufficient'
-  }
-
-  if (margin < minMarginUsd) {
-    return 'below-minimum'
-  }
-
-  return ''
-}