@lifi/perps-sdk 20.1.0 → 21.0.0

package/dist/esm/utils/orderMath.js

@@ -1,113 +0,0 @@
-import { OrderSide, OrderStatus, PositionSide, } 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, positions) {
-    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, positionSize) {
-    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, position) {
-    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, position) {
-    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,
-    });
-}
-//# sourceMappingURL=orderMath.js.map

package/dist/esm/utils/orderMath.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"orderMath.js","sourceRoot":"","sources":["../../../src/utils/orderMath.ts"],"names":[],"mappings":"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"}

package/dist/esm/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/esm/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/esm/utils/parse.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"parse.js","sourceRoot":"","sources":["../../../src/utils/parse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,CAAC,CAAA;IACV,CAAC;IACD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;IAC1E,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,CAAC,CAAA;IACV,CAAC;IACD,OAAO,UAAU,CAAC,OAAO,CAAC,CAAA;AAC5B,CAAC;AAED,MAAM,gBAAgB,GACpB,2GAA2G,CAAA;AAE7G;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAC1B,KAAgC;IAEhC,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;QAClB,OAAO,SAAS,CAAA;IAClB,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACxB,OAAO,aAAa,CAAC,KAAK,CAAC,CAAA;IAC7B,CAAC;IACD,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;QACzC,OAAO,SAAS,CAAA;IAClB,CAAC;IACD,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,CAAC,CAAA;IACnC,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAA;AACrD,CAAC"}

package/dist/esm/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/esm/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/esm/utils/positionMath.js

@@ -1,173 +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`.
- */
-import { areFinite, DivBig } from './decimal.js';
-/**
- * Direction sign for a position.
- *
- * @param isLong - True for long positions, false for short.
- * @returns +1 for long, -1 for short.
- * @public
- */
-export function directionSign(isLong) {
-    return isLong ? 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 function estimateIsolatedLiquidationPrice(params) {
-    const { entryPrice, leverage, isLong, maintenanceMarginRate } = params;
-    if (leverage === 0) {
-        return undefined;
-    }
-    const side = directionSign(isLong);
-    const denominator = 1 - maintenanceMarginRate * side;
-    if (denominator === 0) {
-        return undefined;
-    }
-    if (!areFinite(entryPrice, leverage, maintenanceMarginRate)) {
-        return Number.NaN;
-    }
-    const mmr = new DivBig(maintenanceMarginRate);
-    const marginAvailable = new DivBig(1)
-        .div(leverage)
-        .minus(mmr)
-        .times(entryPrice);
-    return new DivBig(entryPrice)
-        .minus(marginAvailable.times(side).div(mmr.times(-side).plus(1)))
-        .toNumber();
-}
-/**
- * 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 function wouldImmediatelyLiquidate(params) {
-    const { liquidationPrice, currentPrice, isLong } = params;
-    if (currentPrice <= 0 || liquidationPrice <= 0) {
-        return false;
-    }
-    return isLong
-        ? liquidationPrice >= currentPrice
-        : liquidationPrice <= currentPrice;
-}
-/**
- * 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 function predictAverageEntryPrice(params) {
-    const { currentSize, currentEntry, addSize, fillPrice } = params;
-    const totalSize = currentSize + addSize;
-    if (totalSize <= 0) {
-        return undefined;
-    }
-    if (!Number.isFinite(currentEntry) || !Number.isFinite(fillPrice)) {
-        return undefined;
-    }
-    if (!areFinite(currentSize, addSize)) {
-        return Number.NaN;
-    }
-    return new DivBig(currentSize)
-        .times(currentEntry)
-        .plus(new DivBig(addSize).times(fillPrice))
-        .div(new DivBig(currentSize).plus(addSize))
-        .toNumber();
-}
-/**
- * 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 function predictNewLeverage(params) {
-    const { currentNotional, currentMargin, addNotional, addMargin } = params;
-    const totalMargin = currentMargin + addMargin;
-    if (totalMargin <= 0) {
-        return undefined;
-    }
-    if (!areFinite(currentNotional, currentMargin, addNotional, addMargin)) {
-        return Number.NaN;
-    }
-    return new DivBig(currentNotional)
-        .plus(addNotional)
-        .div(new DivBig(currentMargin).plus(addMargin))
-        .toNumber();
-}
-/**
- * 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 function predictUnrealizedPnl(params) {
-    const { entryPrice, markPrice, size, isLong } = params;
-    if (!areFinite(entryPrice, markPrice, size)) {
-        return Number.NaN;
-    }
-    return new DivBig(markPrice)
-        .minus(entryPrice)
-        .times(size)
-        .times(directionSign(isLong))
-        .toNumber();
-}
-/**
- * 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 function realizedPnlOnClose(params) {
-    const { entryPrice, closePrice, closeSize, isLong } = params;
-    if (!areFinite(entryPrice, closePrice, closeSize)) {
-        return Number.NaN;
-    }
-    return new DivBig(closePrice)
-        .minus(entryPrice)
-        .times(closeSize)
-        .times(directionSign(isLong))
-        .toNumber();
-}
-//# sourceMappingURL=positionMath.js.map

package/dist/esm/utils/positionMath.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"positionMath.js","sourceRoot":"","sources":["../../../src/utils/positionMath.ts"],"names":[],"mappings":"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"}

package/dist/esm/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/esm/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/esm/utils/scaleToInteger.js

@@ -1,34 +0,0 @@
-import { PerpsErrorCode } from '@lifi/perps-types';
-import Big from 'big.js';
-import { PerpsError } from '../errors/PerpsError.js';
-/**
- * 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, decimals, policy) => {
-    if (!Number.isInteger(decimals) || decimals < 0) {
-        throw new PerpsError(PerpsErrorCode.ValidationError, `Invalid decimals for integer scaling: ${decimals}`);
-    }
-    let parsed;
-    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();
-};
-//# sourceMappingURL=scaleToInteger.js.map

package/dist/esm/utils/scaleToInteger.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"scaleToInteger.js","sourceRoot":"","sources":["../../../src/utils/scaleToInteger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAClD,OAAO,GAAG,MAAM,QAAQ,CAAA;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AAYpD;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,KAAa,EACb,QAAgB,EAChB,MAA4B,EACpB,EAAE;IACV,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;QAChD,MAAM,IAAI,UAAU,CAClB,cAAc,CAAC,eAAe,EAC9B,yCAAyC,QAAQ,EAAE,CACpD,CAAA;IACH,CAAC;IACD,IAAI,MAAW,CAAA;IACf,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAA;IACzB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,UAAU,CAClB,cAAc,CAAC,eAAe,EAC9B,gDAAgD,KAAK,GAAG,CACzD,CAAA;IACH,CAAC;IACD,MAAM,MAAM,GAAG,MAAM;SAClB,KAAK,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;SAChC,KAAK,CAAC,CAAC,EAAE,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,CAAA;IACpE,IAAI,MAAM,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,gBAAgB,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,UAAU,CAClB,cAAc,CAAC,eAAe,EAC9B,gBAAgB,MAAM,CAAC,OAAO,EAAE,iEAAiE,CAClG,CAAA;IACH,CAAC;IACD,OAAO,MAAM,CAAC,QAAQ,EAAE,CAAA;AAC1B,CAAC,CAAA"}

package/dist/esm/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/esm/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/esm/utils/units.js

@@ -1,38 +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, decimals) {
-    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, decimals) {
-    const value = Number(fromBaseUnits(amount, decimals));
-    return Number.isFinite(value) ? value : 0;
-}
-//# sourceMappingURL=units.js.map

package/dist/esm/utils/units.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"units.js","sourceRoot":"","sources":["../../../src/utils/units.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,MAAM,CAAA;AAElC;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,aAAa,CAAC,MAAc,EAAE,QAAgB;IAC5D,IAAI,CAAC;QACH,OAAO,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,CAAA;IAC9C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,GAAG,CAAA;IACZ,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAc,EAAE,QAAgB;IAClE,MAAM,KAAK,GAAG,MAAM,CAAC,aAAa,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAA;IACrD,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;AAC3C,CAAC"}

package/dist/esm/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/esm/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/dist/esm/utils/validation.js

@@ -1,29 +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, _leverage, availableBalance, _feeRate, minMarginUsd) {
-    if (margin <= 0) {
-        return '';
-    }
-    if (availableBalance !== null && margin > availableBalance) {
-        return 'insufficient';
-    }
-    if (margin < minMarginUsd) {
-        return 'below-minimum';
-    }
-    return '';
-}
-//# sourceMappingURL=validation.js.map

package/dist/esm/utils/validation.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../../src/utils/validation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,cAAc,CAC5B,MAAc,EACd,SAAiB,EACjB,gBAA+B,EAC/B,QAAuB,EACvB,YAAoB;IAEpB,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;QAChB,OAAO,EAAE,CAAA;IACX,CAAC;IAED,IAAI,gBAAgB,KAAK,IAAI,IAAI,MAAM,GAAG,gBAAgB,EAAE,CAAC;QAC3D,OAAO,cAAc,CAAA;IACvB,CAAC;IAED,IAAI,MAAM,GAAG,YAAY,EAAE,CAAC;QAC1B,OAAO,eAAe,CAAA;IACxB,CAAC;IAED,OAAO,EAAE,CAAA;AACX,CAAC"}