@lifi/perps-sdk 20.1.0 → 21.0.0

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

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

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

@@ -1 +0,0 @@
-{"version":3,"file":"decimal.d.ts","sourceRoot":"","sources":["../../../src/utils/decimal.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,QAAQ,CAAA;AAExB;;;GAGG;AACH,eAAO,MAAM,MAAM,oBAAQ,CAAA;AAG3B;;;GAGG;AACH,eAAO,MAAM,QAAQ,oBAAQ,CAAA;AAI7B,qFAAqF;AACrF,wBAAgB,SAAS,CAAC,GAAG,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAEtD"}

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

@@ -1,13 +0,0 @@
-import { FillClassification } from '@lifi/perps-types';
-/**
- * Classify a perpetual fill into the Open/Close/Increase/Reduce/Switch
- * taxonomy from `FillClassification`.
- *
- * @param startPosition Signed position held BEFORE this fill (`> 0` long,
- *   `< 0` short, `0` flat).
- * @param side Hyperliquid-style: `'B'` for buy, anything else for sell.
- * @param sz Unsigned fill size, parsed with `parseFloat`.
- * @public
- */
-export declare function classifyFillFromPosition(startPosition: string, side: string, sz: string): FillClassification;
-//# sourceMappingURL=fillClassification.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"fillClassification.d.ts","sourceRoot":"","sources":["../../../src/utils/fillClassification.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAEtD;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CACtC,aAAa,EAAE,MAAM,EACrB,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,GACT,kBAAkB,CAkCpB"}

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

@@ -1 +0,0 @@
-{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../src/utils/format.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,mFAAmF;IACnF,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,gFAAgF;IAChF,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,YAAY,CAAA;CACxB;AAED;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,OAAO,CAAA;AAI7C,KAAK,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;AAyFrD;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,WAAW,EAClB,OAAO,GAAE,aAAkB,GAC1B,MAAM,CAaR;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CACvB,KAAK,EAAE,WAAW,EAClB,OAAO,GAAE,aAAkB,GAC1B,MAAM,CAaR;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,WAAW,EAClB,OAAO,GAAE,aAAkB,GAC1B,MAAM,CAaR;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,WAAW,EAClB,OAAO,GAAE,aAAkB,GAC1B,MAAM,CAaR;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,WAAW,EAClB,OAAO,GAAE,aAAkB,GAC1B,MAAM,CAqBR;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,WAAW,EAClB,OAAO,GAAE,aAAkB,GAC1B,MAAM,CAkBR"}

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

@@ -1,6 +0,0 @@
-import type Big from 'big.js';
-/** The larger of two Big values, as `Math.max` for numbers. */
-export declare const maxOf: (a: Big, b: Big) => Big;
-/** The smaller of two Big values, as `Math.min` for numbers. */
-export declare const minOf: (a: Big, b: Big) => Big;
-//# sourceMappingURL=math.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"math.d.ts","sourceRoot":"","sources":["../../../src/utils/math.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,QAAQ,CAAA;AAE7B,+DAA+D;AAC/D,eAAO,MAAM,KAAK,GAAI,GAAG,GAAG,EAAE,GAAG,GAAG,KAAG,GAAwB,CAAA;AAE/D,gEAAgE;AAChE,eAAO,MAAM,KAAK,GAAI,GAAG,GAAG,EAAE,GAAG,GAAG,KAAG,GAAwB,CAAA"}

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

@@ -1,26 +0,0 @@
-import type Big from 'big.js';
-/**
- * Base size the given margin buys at `leverage`: size = margin × leverage ÷ price.
- * Truncates, so `size × price` never exceeds `margin × leverage`.
- * @public
- */
-export declare function sizeFromMargin(margin: Big, leverage: number, price: Big): Big;
-/**
- * Margin that holds the given base size at `leverage`: margin = size × price ÷ leverage.
- * Truncates, so `margin × leverage` never exceeds `size × price`.
- * @public
- */
-export declare function marginFromSize(size: Big, leverage: number, price: Big): Big;
-/**
- * Base size for a notional: size = notional ÷ price.
- * Truncates, so `size × price` never exceeds the notional.
- * @public
- */
-export declare function sizeFromNotional(notionalUsd: Big, price: Big): Big;
-/**
- * Margin for a notional at `leverage`: margin = notional ÷ leverage.
- * Truncates, so `margin × leverage` never exceeds the notional.
- * @public
- */
-export declare function marginFromNotional(notionalUsd: Big, leverage: number): Big;
-//# sourceMappingURL=orderEntry.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"orderEntry.d.ts","sourceRoot":"","sources":["../../../src/utils/orderEntry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,QAAQ,CAAA;AAG7B;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,GAAG,CAE7E;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,GAAG,CAE3E;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,GAAG,GAAG,CAElE;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,GAAG,GAAG,CAE1E"}

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

@@ -1,37 +0,0 @@
-import { type Position, type RegularOrder, type TriggerOrder } from '@lifi/perps-types';
-/**
- * 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 declare function findMatchingPosition(marketId: string, positions: readonly Position[]): Position | undefined;
-/**
- * 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 declare function resolveCloseSize(orderSize: number, positionSize: number): number;
-/**
- * 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 declare function expectedRealizedPnlForOpenOrder(order: RegularOrder, position: Position | undefined): number | null;
-/** Project the unfilled closing quantity of an active trigger at its trigger price. */
-export declare function expectedRealizedPnlForTriggerOrder(order: TriggerOrder, position: Position | undefined): number | null;
-//# sourceMappingURL=orderMath.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"orderMath.d.ts","sourceRoot":"","sources":["../../../src/utils/orderMath.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,QAAQ,EAEb,KAAK,YAAY,EACjB,KAAK,YAAY,EAClB,MAAM,mBAAmB,CAAA;AAI1B;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,SAAS,QAAQ,EAAE,GAC7B,QAAQ,GAAG,SAAS,CAEtB;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,GACnB,MAAM,CAKR;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,YAAY,EACnB,QAAQ,EAAE,QAAQ,GAAG,SAAS,GAC7B,MAAM,GAAG,IAAI,CAyCf;AAED,uFAAuF;AACvF,wBAAgB,kCAAkC,CAChD,KAAK,EAAE,YAAY,EACnB,QAAQ,EAAE,QAAQ,GAAG,SAAS,GAC7B,MAAM,GAAG,IAAI,CA2Cf"}

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