@lifi/perps-sdk 20.1.1 → 21.0.0

package/dist/types/utils/parse.d.ts

@@ -1,28 +0,0 @@
-/**
- * Parse a string to a float, stripping common formatting artefacts.
- *
- * Handles:
- * - Currency prefixes/suffixes ($, USD, etc.)
- * - Explicit sign prefixes (+/-)
- * - Thousands separators (commas)
- * - Percentage suffixes (%)
- * - Whitespace
- *
- * @returns Parsed number; `0` for empty/blank input, `NaN` when a non-empty
- *   string contains no parseable number
- * @example
- * ```ts
- * stringToFloat('$1,234.50') // 1234.5
- * stringToFloat('') // 0
- * ```
- * @public
- */
-export declare function stringToFloat(value: string): number;
-/**
- * Parse an optional decimal field, with the same formatting tolerance as {@link stringToFloat}.
- * Gives back `undefined` for a missing, malformed or non-finite value, and `0` for an empty string.
- *
- * @public
- */
-export declare function parseDecimal(value: string | null | undefined): number | undefined;
-//# sourceMappingURL=parse.d.ts.map

package/dist/types/utils/parse.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../../src/utils/parse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CASnD;AAKD;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC/B,MAAM,GAAG,SAAS,CAYpB"}

package/dist/types/utils/positionMath.d.ts

@@ -1,120 +0,0 @@
-/**
- * Pure-function helpers for predicting how a perp position changes after a
- * fill.
- *
- * Sign convention: long = +1, short = -1. Sizes passed to these helpers are
- * always non-negative magnitudes; direction is carried by `isLong`.
- */
-/**
- * Direction sign for a position.
- *
- * @param isLong - True for long positions, false for short.
- * @returns +1 for long, -1 for short.
- * @public
- */
-export declare function directionSign(isLong: boolean): 1 | -1;
-/**
- * Estimated liquidation price for an isolated-margin position, parameterised
- * by the venue's maintenance margin rate.
- *
- * Standard isolated-margin model (new position, no existing exposure):
- *   margin_per_unit      = entryPrice / leverage
- *   maintenance_per_unit = entryPrice * mmr
- *   margin_available     = margin_per_unit - maintenance_per_unit
- *   liq_price            = entryPrice - side * margin_available / (1 - mmr * side)
- *
- * For existing positions, prefer `Position.liquidationPrice` from the venue.
- *
- * @param maintenanceMarginRate - Venue maintenance margin rate as a fraction
- *   (e.g. 0.01 = 1%).
- * @returns Estimated liquidation price, or undefined if the inputs cannot
- *   produce one (zero leverage, degenerate denominator).
- * @public
- */
-export declare function estimateIsolatedLiquidationPrice(params: {
-    entryPrice: number;
-    leverage: number;
-    isLong: boolean;
-    maintenanceMarginRate: number;
-}): number | undefined;
-/**
- * Whether an isolated position with this liquidation price is already past
- * liquidation at `currentPrice`: a long liquidates when the price falls to its
- * liquidation level, a short when it rises to it. A non-positive price on
- * either side counts as unknown, so the result is `false`.
- *
- * @public
- */
-export declare function wouldImmediatelyLiquidate(params: {
-    liquidationPrice: number;
-    currentPrice: number;
-    isLong: boolean;
-}): boolean;
-/**
- * Predicted average entry price after adding to an existing position.
- *
- * Weighted average of the current entry and the new fill price, weighted by
- * the size of each leg in coin units. Both legs assumed in the same direction
- * (this helper is for adding to, not flipping, a position).
- *
- * @param currentSize - Existing position size in coin units (>= 0).
- * @param currentEntry - Existing position's average entry price.
- * @param addSize - Size being added in coin units (>= 0).
- * @param fillPrice - Price the new size is expected to fill at (mid for
- *   market, limitPrice for limit orders).
- * @returns The new weighted-average entry price, or undefined if the inputs
- *   cannot produce a valid average (zero combined size, non-finite values).
- * @public
- */
-export declare function predictAverageEntryPrice(params: {
-    currentSize: number;
-    currentEntry: number;
-    addSize: number;
-    fillPrice: number;
-}): number | undefined;
-/**
- * Predicted effective leverage after adding margin and notional.
- *
- * leverage = totalNotional / totalMargin. The caller computes notional from
- * size and price (`calculateNotionalValue`) and supplies the additional
- * margin the user is about to put up.
- *
- * @returns The new effective leverage, or undefined if total margin is
- *   non-positive.
- * @public
- */
-export declare function predictNewLeverage(params: {
-    currentNotional: number;
-    currentMargin: number;
-    addNotional: number;
-    addMargin: number;
-}): number | undefined;
-/**
- * Predicted unrealised PnL at the current mark price.
- *
- * `pnl = (markPrice - entryPrice) * size * directionSign(isLong)`
- *
- * @param size - Position size as a non-negative magnitude.
- * @public
- */
-export declare function predictUnrealizedPnl(params: {
-    entryPrice: number;
-    markPrice: number;
-    size: number;
-    isLong: boolean;
-}): number;
-/**
- * Realised PnL on the portion of a position being closed.
- *
- * `rPnl = (closePrice - entryPrice) * closeSize * directionSign(isLong)`
- *
- * @param closeSize - Size being closed as a non-negative magnitude.
- * @public
- */
-export declare function realizedPnlOnClose(params: {
-    entryPrice: number;
-    closePrice: number;
-    closeSize: number;
-    isLong: boolean;
-}): number;
-//# sourceMappingURL=positionMath.d.ts.map

package/dist/types/utils/positionMath.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"positionMath.d.ts","sourceRoot":"","sources":["../../../src/utils/positionMath.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,CAErD;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,gCAAgC,CAAC,MAAM,EAAE;IACvD,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,OAAO,CAAA;IACf,qBAAqB,EAAE,MAAM,CAAA;CAC9B,GAAG,MAAM,GAAG,SAAS,CAqBrB;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE;IAChD,gBAAgB,EAAE,MAAM,CAAA;IACxB,YAAY,EAAE,MAAM,CAAA;IACpB,MAAM,EAAE,OAAO,CAAA;CAChB,GAAG,OAAO,CAQV;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE;IAC/C,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,MAAM,CAAA;IACpB,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;CAClB,GAAG,MAAM,GAAG,SAAS,CAiBrB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE;IACzC,eAAe,EAAE,MAAM,CAAA;IACvB,aAAa,EAAE,MAAM,CAAA;IACrB,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;CAClB,GAAG,MAAM,GAAG,SAAS,CAarB;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE;IAC3C,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,OAAO,CAAA;CAChB,GAAG,MAAM,CAUT;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE;IACzC,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,OAAO,CAAA;CAChB,GAAG,MAAM,CAUT"}

package/dist/types/utils/scaleToInteger.d.ts

@@ -1,22 +0,0 @@
-/**
- * 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 declare const scaleToInteger: (value: string, decimals: number, policy: ScaleToIntegerPolicy) => number;
-//# sourceMappingURL=scaleToInteger.d.ts.map

package/dist/types/utils/scaleToInteger.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"scaleToInteger.d.ts","sourceRoot":"","sources":["../../../src/utils/scaleToInteger.ts"],"names":[],"mappings":"AAIA;;;;;;;GAOG;AACH,MAAM,MAAM,oBAAoB,GAAG,UAAU,GAAG,OAAO,CAAA;AAEvD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,cAAc,GACzB,OAAO,MAAM,EACb,UAAU,MAAM,EAChB,QAAQ,oBAAoB,KAC3B,MA0BF,CAAA"}

package/dist/types/utils/units.d.ts

@@ -1,27 +0,0 @@
-/**
- * Token unit conversion utilities.
- */
-/**
- * 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 declare function fromBaseUnits(amount: string, decimals: number): string;
-/**
- * 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 declare function fromBaseUnitsNumber(amount: string, decimals: number): number;
-//# sourceMappingURL=units.d.ts.map

package/dist/types/utils/units.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"units.d.ts","sourceRoot":"","sources":["../../../src/utils/units.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMtE;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAG5E"}

package/dist/types/utils/validation.d.ts

@@ -1,18 +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 declare function validateMargin(margin: number, _leverage: number, availableBalance: number | null, _feeRate: number | null, minMarginUsd: number): string;
-//# sourceMappingURL=validation.d.ts.map

package/dist/types/utils/validation.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/utils/validation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,MAAM,GAAG,IAAI,EAC/B,QAAQ,EAAE,MAAM,GAAG,IAAI,EACvB,YAAY,EAAE,MAAM,GACnB,MAAM,CAcR"}

package/src/utils/math.ts

@@ -1,7 +0,0 @@
-import type Big from 'big.js'
-
-/** The larger of two Big values, as `Math.max` for numbers. */
-export const maxOf = (a: Big, b: Big): Big => (a.gt(b) ? a : b)
-
-/** The smaller of two Big values, as `Math.min` for numbers. */
-export const minOf = (a: Big, b: Big): Big => (a.lt(b) ? a : b)

package/src/utils/orderEntry.ts

@@ -1,38 +0,0 @@
-import type Big from 'big.js'
-import { TruncBig } from './decimal.js'
-
-/**
- * Base size the given margin buys at `leverage`: size = margin × leverage ÷ price.
- * Truncates, so `size × price` never exceeds `margin × leverage`.
- * @public
- */
-export function sizeFromMargin(margin: Big, leverage: number, price: Big): Big {
-  return new TruncBig(margin).times(leverage).div(price)
-}
-
-/**
- * Margin that holds the given base size at `leverage`: margin = size × price ÷ leverage.
- * Truncates, so `margin × leverage` never exceeds `size × price`.
- * @public
- */
-export function marginFromSize(size: Big, leverage: number, price: Big): Big {
-  return new TruncBig(size).times(price).div(leverage)
-}
-
-/**
- * Base size for a notional: size = notional ÷ price.
- * Truncates, so `size × price` never exceeds the notional.
- * @public
- */
-export function sizeFromNotional(notionalUsd: Big, price: Big): Big {
-  return new TruncBig(notionalUsd).div(price)
-}
-
-/**
- * Margin for a notional at `leverage`: margin = notional ÷ leverage.
- * Truncates, so `margin × leverage` never exceeds the notional.
- * @public
- */
-export function marginFromNotional(notionalUsd: Big, leverage: number): Big {
-  return new TruncBig(notionalUsd).div(leverage)
-}

package/src/utils/orderMath.ts

@@ -1,152 +0,0 @@
-import {
-  OrderSide,
-  OrderStatus,
-  type Position,
-  PositionSide,
-  type RegularOrder,
-  type TriggerOrder,
-} from '@lifi/perps-types'
-import { isActiveOrderStatus } from './orderClassification.js'
-import { realizedPnlOnClose } from './positionMath.js'
-
-/**
- * Pick the matching open position for an order's market, if any.
- *
- * @param marketId - The order's `market.id`.
- * @param positions - Open positions list (any market).
- * @public
- */
-export function findMatchingPosition(
-  marketId: string,
-  positions: readonly Position[]
-): Position | undefined {
-  return positions.find((p) => p.market.id === marketId)
-}
-
-/**
- * Resolve the close-size against a position, applying the spec's cap rules:
- *  - `orderSize === 0` is the Hyperliquid convention for "close entire
- *    position" → close the full position size.
- *  - Otherwise cap at the absolute position size; an order larger than the
- *    position can only close what's open.
- *
- * Inputs are non-negative magnitudes.
- * @public
- */
-export function resolveCloseSize(
-  orderSize: number,
-  positionSize: number
-): number {
-  if (orderSize === 0) {
-    return positionSize
-  }
-  return Math.min(orderSize, positionSize)
-}
-
-/**
- * Expected rPnL for a resting limit order against a matching position.
- *
- * Reducing requires opposite sides (long position + SELL, short position +
- * BUY). Same-side orders add to the position and have no rPnL → `null`.
- * Projects `remainingSize`, because an already-filled quantity has realised
- * its PnL at the fill price rather than at this order's limit price. A
- * `remainingSize` of zero leaves nothing to project.
- *
- * @returns Realised PnL if the order would reduce the position, otherwise
- *   `null`.
- * @public
- */
-export function expectedRealizedPnlForOpenOrder(
-  order: RegularOrder,
-  position: Position | undefined
-): number | null {
-  if (!position || !isActiveOrderStatus(order.status)) {
-    return null
-  }
-
-  const isLong = position.side === PositionSide.LONG
-  const reducesPosition =
-    (isLong && order.side === OrderSide.SELL) ||
-    (!isLong && order.side === OrderSide.BUY)
-  if (!reducesPosition) {
-    return null
-  }
-
-  const limitPrice = Number.parseFloat(order.price ?? '')
-  const entryPrice = Number.parseFloat(position.entryPrice)
-  const orderSize = Math.abs(Number.parseFloat(order.remainingSize))
-  const positionSize = Math.abs(Number.parseFloat(position.size))
-  if (
-    !Number.isFinite(limitPrice) ||
-    !Number.isFinite(entryPrice) ||
-    !Number.isFinite(orderSize) ||
-    !Number.isFinite(positionSize) ||
-    positionSize <= 0
-  ) {
-    return null
-  }
-
-  // `resolveCloseSize` reads a zero size as "close the whole position", a
-  // convention that belongs to an order's submitted size. `remainingSize` is
-  // the unfilled quantity, so zero means nothing is left to fill.
-  if (orderSize === 0) {
-    return null
-  }
-
-  const closeSize = resolveCloseSize(orderSize, positionSize)
-  return realizedPnlOnClose({
-    entryPrice,
-    closePrice: limitPrice,
-    closeSize,
-    isLong,
-  })
-}
-
-/** Project the unfilled closing quantity of an active trigger at its trigger price. */
-export function expectedRealizedPnlForTriggerOrder(
-  order: TriggerOrder,
-  position: Position | undefined
-): number | null {
-  if (
-    !position ||
-    !isActiveOrderStatus(order.status) ||
-    order.status === OrderStatus.PENDING
-  ) {
-    return null
-  }
-
-  const isLong = position.side === PositionSide.LONG
-  if (
-    (isLong && order.side !== OrderSide.SELL) ||
-    (!isLong && order.side !== OrderSide.BUY)
-  ) {
-    return null
-  }
-  const triggerPrice = Number.parseFloat(order.triggerPrice)
-  const entryPrice = Number.parseFloat(position.entryPrice)
-  const orderSize = Math.abs(Number.parseFloat(order.remainingSize))
-  const positionSize = Math.abs(Number.parseFloat(position.size))
-  if (
-    !Number.isFinite(triggerPrice) ||
-    !Number.isFinite(entryPrice) ||
-    !Number.isFinite(orderSize) ||
-    !Number.isFinite(positionSize) ||
-    positionSize <= 0
-  ) {
-    return null
-  }
-  if (
-    orderSize === 0 &&
-    (Number.parseFloat(order.originalSize) !== 0 || !order.reduceOnly)
-  ) {
-    return null
-  }
-
-  const closeSize = resolveCloseSize(orderSize, positionSize)
-  return realizedPnlOnClose({
-    entryPrice,
-    closePrice: triggerPrice,
-    closeSize,
-    isLong,
-  })
-}

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 ''
-}