@lifi/perps-sdk 0.1.1-alpha.9 → 1.0.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"explorer.d.ts","sourceRoot":"","sources":["../../../src/utils/explorer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;GAIG;AACH,eAAO,MAAM,eAAe;;;;;CAKlB,CAAA;AAEV;;;;GAIG;AACH,MAAM,MAAM,eAAe,GACzB,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,OAAO,eAAe,CAAC,CAAA;AASxD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,eAAe,EACxB,MAAM,EAAE,MAAM,GAAG,SAAS,GACzB,MAAM,GAAG,SAAS,CAKpB"}

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

@@ -0,0 +1,13 @@
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,66 @@
+/**
+ * Options shared by the human-facing display formatters.
+ *
+ * @public
+ */
+export interface FormatOptions {
+    /** Fixed number of decimal places. Defaults are per-formatter. */
+    decimals?: number;
+    /** Rendered when the value is null/undefined/NaN/non-finite. Defaults to `'—'`. */
+    placeholder?: string;
+    /** BCP 47 locale controlling digit grouping and separators (e.g. `'en-US'`). */
+    locale?: string;
+}
+type FormatInput = number | string | null | undefined;
+/**
+ * Format a USD value, unsigned: `$1,234.50`, `-$1,500.00`, `$0.00`.
+ *
+ * Two decimal places with locale digit grouping. Negatives place the `-`
+ * before the `$`. Null/undefined/non-finite input renders the placeholder.
+ *
+ * @public
+ */
+export declare function formatUsd(value: FormatInput, options?: FormatOptions): string;
+/**
+ * Format a USD value with an explicit sign: `+$1.43`, `-$1.43`, `$0.00`.
+ *
+ * The sign is derived after rounding, so sub-cent magnitudes render `$0.00`
+ * (no spurious `+`/`-`). Null/undefined/non-finite input renders the
+ * placeholder.
+ *
+ * @public
+ */
+export declare function formatSignedUsd(value: FormatInput, options?: FormatOptions): string;
+/**
+ * Format a percentage with an explicit sign and no grouping: `+1.43%`,
+ * `-1.43%`, `0.00%`.
+ *
+ * The sign is derived after rounding, so sub-threshold magnitudes render
+ * `0.00%`. Null/undefined/non-finite input renders the placeholder.
+ *
+ * @public
+ */
+export declare function formatSignedPercent(value: FormatInput, options?: FormatOptions): string;
+/**
+ * Format a price, unsigned, with decimals auto-detected from magnitude:
+ * `$1,234.50`, `$0.1234`, `-$1,500.00`.
+ *
+ * Decimals follow {@link autoDecimals} unless `options.decimals` is given.
+ * Grouping applies once the absolute value reaches 1000. Negatives place the
+ * `-` before the `$`. Null/undefined/non-finite input renders the placeholder.
+ *
+ * @public
+ */
+export declare function formatPrice(value: FormatInput, options?: FormatOptions): string;
+/**
+ * Format a USD value compactly with a `B`/`M`/`K` suffix: `$1.23B`, `$45.6M`,
+ * `$789.0K`, `$12.34`.
+ *
+ * Negatives place the `-` before the `$`. Null/undefined/non-finite input
+ * renders the placeholder.
+ *
+ * @public
+ */
+export declare function formatCompactUsd(value: FormatInput, options?: FormatOptions): string;
+export {};
+//# sourceMappingURL=format.d.ts.map

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

@@ -0,0 +1 @@
+{"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;CAChB;AAID,KAAK,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;AA+DrD;;;;;;;GAOG;AACH,wBAAgB,SAAS,CACvB,KAAK,EAAE,WAAW,EAClB,OAAO,GAAE,aAAkB,GAC1B,MAAM,CAQR;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,WAAW,EAClB,OAAO,GAAE,aAAkB,GAC1B,MAAM,CAcR;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,WAAW,EAClB,OAAO,GAAE,aAAkB,GAC1B,MAAM,CAcR;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,WAAW,EAClB,OAAO,GAAE,aAAkB,GAC1B,MAAM,CAUR;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,WAAW,EAClB,OAAO,GAAE,aAAkB,GAC1B,MAAM,CAkBR"}

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

@@ -0,0 +1,47 @@
+/**
+ * Order classification utilities.
+ *
+ * Type guards and classifiers that operate on SDK types to determine
+ * order categories (TP/SL, open/close). These use the OrderType enum
+ * for classification — no string matching.
+ */
+import type { OpenOrder } from '@lifi/perps-types';
+import { FillClassification, OrderSide, OrderStatus } from '@lifi/perps-types';
+export { FillClassification };
+/**
+ * Check if an open order is a Take Profit trigger order.
+ * @public
+ */
+export declare function isTakeProfitOrder(order: Pick<OpenOrder, 'type'>): boolean;
+/**
+ * Check if an open order is a Stop Loss trigger order.
+ * @public
+ */
+export declare function isStopLossOrder(order: Pick<OpenOrder, 'type'>): boolean;
+/**
+ * Check if an open order is a TP or SL trigger order.
+ * @public
+ */
+export declare function isTpSlOrder(order: Pick<OpenOrder, 'type'>): boolean;
+/**
+ * Order statuses representing an order still resting on the book (visible
+ * in `openOrders` / `triggerOrders`). Anything not in this set is terminal —
+ * filled, cancelled, rejected, expired — and should be evicted from the
+ * cached orders list when seen in a WS update.
+ * @public
+ */
+export declare const ACTIVE_ORDER_STATUSES: ReadonlySet<OrderStatus>;
+/**
+ * Whether `status` is one of {@link ACTIVE_ORDER_STATUSES}.
+ *
+ * @public
+ */
+export declare function isActiveOrderStatus(status: OrderStatus): boolean;
+/**
+ * Classify a fill as open or close based on realizedPnl.
+ * @deprecated Use `Fill.classification` instead — it uses startPosition
+ * for accurate open/increase/reduce/close/reverse classification.
+ * @public
+ */
+export declare function classifyFill(side: OrderSide, realizedPnl: string | null | undefined): FillClassification;
+//# sourceMappingURL=orderClassification.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"orderClassification.d.ts","sourceRoot":"","sources":["../../../src/utils/orderClassification.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAClD,OAAO,EACL,kBAAkB,EAClB,SAAS,EACT,WAAW,EAEZ,MAAM,mBAAmB,CAAA;AAG1B,OAAO,EAAE,kBAAkB,EAAE,CAAA;AAY7B;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,GAAG,OAAO,CAEzE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,GAAG,OAAO,CAEvE;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,GAAG,OAAO,CAEnE;AAED;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,EAAE,WAAW,CAAC,WAAW,CAKzD,CAAA;AAEF;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAEhE;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,SAAS,EACf,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACrC,kBAAkB,CAUpB"}

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

@@ -0,0 +1,44 @@
+import { type OpenOrder, type Position, 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`.
+ *
+ * @returns Realised PnL if the order would reduce the position, otherwise
+ *   `null`.
+ * @public
+ */
+export declare function expectedRealizedPnlForOpenOrder(order: OpenOrder, position: Position | undefined): number | null;
+/**
+ * Expected rPnL for a TP/SL trigger order against a matching position.
+ *
+ * A trigger order is by construction a closing leg — its direction is the
+ * opposite of the position's. With no matching position there is nothing to
+ * close, so rPnL is `null`. The trigger price (always present on the SDK
+ * `TriggerOrder` shape) is used as the rPnL price; the optional `limitPrice`
+ * for STOP_LIMIT / TAKE_PROFIT_LIMIT is the post-trigger limit, not the rPnL
+ * price.
+ * @public
+ */
+export declare function expectedRealizedPnlForTriggerOrder(order: TriggerOrder, position: Position | undefined): number | null;
+//# sourceMappingURL=orderMath.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"orderMath.d.ts","sourceRoot":"","sources":["../../../src/utils/orderMath.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,SAAS,EAEd,KAAK,QAAQ,EAEb,KAAK,YAAY,EAClB,MAAM,mBAAmB,CAAA;AAG1B;;;;;;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;;;;;;;;;GASG;AACH,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,SAAS,EAChB,QAAQ,EAAE,QAAQ,GAAG,SAAS,GAC7B,MAAM,GAAG,IAAI,CAkCf;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kCAAkC,CAChD,KAAK,EAAE,YAAY,EACnB,QAAQ,EAAE,QAAQ,GAAG,SAAS,GAC7B,MAAM,GAAG,IAAI,CA2Bf"}

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

@@ -0,0 +1,21 @@
+/**
+ * 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;
+//# sourceMappingURL=parse.d.ts.map

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

@@ -0,0 +1 @@
+{"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"}

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

@@ -0,0 +1,107 @@
+/**
+ * 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;
+/**
+ * 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

@@ -0,0 +1 @@
+{"version":3,"file":"positionMath.d.ts","sourceRoot":"","sources":["../../../src/utils/positionMath.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;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,CAYrB;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,CAUrB;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,CAOrB;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,CAGT;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,CAGT"}

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

@@ -1,15 +1,18 @@
-import type { Hex, PerpsTypedData } from '@lifi/perps-types';
+import type { PerpsTypedData } from '@lifi/perps-types';
+import type { Account, Hex, WalletClient } from 'viem';
 /**
- * Sign EIP-712 typed data with a private key.
+ * Sign EIP-712 typed data with a raw private key (agent keypair).
  *
- * @param privateKey - The private key to sign with
- * @param typedData - The typed data to sign
- * @returns The signature as a hex string
- *
- * @example
- * ```ts
- * const signature = await signTypedData(agentPrivateKey, typedData)
- * ```
+ * @public
  */
 export declare function signTypedData(privateKey: Hex, typedData: PerpsTypedData): Promise<Hex>;
+/**
+ * Sign EIP-712 typed data with an externally-provided WalletClient. Works
+ * with browser wallets (wagmi), private keys, mnemonics — any viem
+ * WalletClient. Used by provider plugins to sign the EIP712 USER arm with the
+ * end-user's wallet.
+ *
+ * @public
+ */
+export declare function signTypedDataWithSigner(userWallet: WalletClient<any, any, Account>, typedData: PerpsTypedData): Promise<Hex>;
 //# sourceMappingURL=signTypedData.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"signTypedData.d.ts","sourceRoot":"","sources":["../../../src/utils/signTypedData.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAG5D;;;;;;;;;;;GAWG;AACH,wBAAsB,aAAa,CACjC,UAAU,EAAE,GAAG,EACf,SAAS,EAAE,cAAc,GACxB,OAAO,CAAC,GAAG,CAAC,CAYd"}
+{"version":3,"file":"signTypedData.d.ts","sourceRoot":"","sources":["../../../src/utils/signTypedData.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AACvD,OAAO,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,YAAY,EAAE,MAAM,MAAM,CAAA;AAGtD;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,UAAU,EAAE,GAAG,EACf,SAAS,EAAE,cAAc,GACxB,OAAO,CAAC,GAAG,CAAC,CAOd;AAED;;;;;;;GAOG;AACH,wBAAsB,uBAAuB,CAC3C,UAAU,EAAE,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,CAAC,EAC3C,SAAS,EAAE,cAAc,GACxB,OAAO,CAAC,GAAG,CAAC,CAQd"}

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

@@ -1,2 +1,7 @@
+/**
+ * Resolve after `ms` milliseconds.
+ *
+ * @internal
+ */
 export declare const sleep: (ms: number) => Promise<void>;
 //# sourceMappingURL=sleep.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"sleep.d.ts","sourceRoot":"","sources":["../../../src/utils/sleep.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,KAAK,GAAI,IAAI,MAAM,KAAG,OAAO,CAAC,IAAI,CACI,CAAA"}
+{"version":3,"file":"sleep.d.ts","sourceRoot":"","sources":["../../../src/utils/sleep.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,KAAK,GAAI,IAAI,MAAM,KAAG,OAAO,CAAC,IAAI,CACI,CAAA"}

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

@@ -0,0 +1,27 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,18 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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/types/version.d.ts

@@ -1,3 +1,3 @@
 export declare const name = "@lifi/perps-sdk";
-export declare const version = "0.1.1-alpha.9";
+export declare const version = "1.0.0";
 //# sourceMappingURL=version.d.ts.map

package/dist/types/version.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,IAAI,oBAAoB,CAAA;AACrC,eAAO,MAAM,OAAO,kBAAkB,CAAA"}
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,IAAI,oBAAoB,CAAA;AACrC,eAAO,MAAM,OAAO,UAAU,CAAA"}

package/dist/types/websocket/PerpsWsClient.d.ts

@@ -0,0 +1,100 @@
+import { type Subscription } from '@lifi/perps-types';
+import type { GetQuoteParams } from '../services/getQuote.js';
+import type { PerpsSDKClient, QuoteListener } from '../types/provider.js';
+import type { EventForSubscription, WsProvider, WsStatusListener } from './types.js';
+/**
+ * Factory for a per-provider WS plugin. Invoked once per provider key the
+ * first time `subscribe(...)` is called against it.
+ *
+ * @public
+ */
+export type WsProviderFactory = (params: {
+    /** Provider key (e.g. `'lighter'`, `'hyperliquid'`). */
+    provider: string;
+    /** WS URL discovered from `/providers`. */
+    wsUrl: string;
+    /**
+     * Markets visible to this provider via `/providers`, optionally filtered
+     * by the consumer's `createPerpsClient({ providers: { [key]: { markets } } })`
+     * config. Each provider interprets these its own way — Hyperliquid uses
+     * them to decide which sub-DEXes to subscribe to; Lighter ignores them.
+     */
+    markets: string[];
+    /**
+     * The SDK client. WS providers use it to call core services (e.g.
+     * `getAssets` to source the wire-id ↔ display-symbol map) without
+     * duplicating backend orchestration in the WS layer.
+     */
+    client: PerpsSDKClient;
+}) => WsProvider;
+/**
+ * Options for {@link PerpsWsClient}.
+ *
+ * @public
+ */
+export interface PerpsWsClientOptions {
+    /**
+     * Per-provider WS factory map. Each key (e.g. `'hyperliquid'`,
+     * `'lighter'`) maps to a factory that returns a `WsProvider`. Concrete
+     * implementations ship with the provider packages — e.g.
+     * `@lifi/perps-sdk-provider-hyperliquid` exports `HyperliquidWsProvider`,
+     * `@lifi/perps-sdk-provider-lighter` exports `LighterWsProvider`.
+     * Subscribing to a provider key without a registered factory throws.
+     */
+    wsProviders?: Record<string, WsProviderFactory>;
+}
+/**
+ * Realtime client: lazily instantiates a per-provider {@link WsProvider} on
+ * first subscription and fans subscriptions out to it.
+ *
+ * @public
+ */
+export declare class PerpsWsClient {
+    private readonly client;
+    private readonly options;
+    private providers;
+    private initPromises;
+    constructor(client: PerpsSDKClient, options?: PerpsWsClientOptions);
+    /**
+     * Subscribe to a realtime channel, lazily creating the provider's WS
+     * connection. Returns an unsubscribe function.
+     *
+     * @param onStatus - Optional listener for the underlying connection's
+     *   health. Fires `reconnecting` on a transient drop and the terminal
+     *   `disconnected` once auto-reconnect is abandoned, so consumers can
+     *   surface a reconnecting/disconnected state instead of silently showing
+     *   stale data.
+     * @throws {PerpsError} When no WS provider factory is registered for the
+     *   subscription's `dex`.
+     * @public
+     */
+    subscribe<S extends Subscription>(sub: S, listener: (event: EventForSubscription<S>) => void, onStatus?: WsStatusListener): Promise<() => void>;
+    /**
+     * Stream live fill quotes for `params.symbol` on `params.provider`, lazily
+     * creating the provider's WS connection. The provider's WS plugin layers the
+     * quote on its orderbook channel, so a concurrent orderbook subscription on
+     * the same market shares one wire subscription. Returns an unsubscribe
+     * function.
+     *
+     * @throws {PerpsError} When no WS provider factory is registered for
+     *   `params.provider`, or no market matches the symbol+type.
+     * @public
+     */
+    subscribeQuote(params: GetQuoteParams, onQuote: QuoteListener): Promise<() => void>;
+    /**
+     * Close every open provider WS connection and drop all cached providers.
+     *
+     * @public
+     */
+    close(): void;
+    /**
+     * Reconnect an already-created provider when its socket reached terminal
+     * `disconnected`. Safe no-op when the provider is unknown or not terminal.
+     *
+     * @public
+     */
+    reconnect(provider: string): void;
+    private getOrCreateProvider;
+    private initProvider;
+}
+//# sourceMappingURL=PerpsWsClient.d.ts.map

package/dist/types/websocket/PerpsWsClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PerpsWsClient.d.ts","sourceRoot":"","sources":["../../../src/websocket/PerpsWsClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAGrE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAEzE,OAAO,KAAK,EACV,oBAAoB,EAEpB,UAAU,EACV,gBAAgB,EACjB,MAAM,YAAY,CAAA;AAEnB;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,MAAM,EAAE;IACvC,wDAAwD;IACxD,QAAQ,EAAE,MAAM,CAAA;IAChB,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAA;IACb;;;;;OAKG;IACH,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB;;;;OAIG;IACH,MAAM,EAAE,cAAc,CAAA;CACvB,KAAK,UAAU,CAAA;AAEhB;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;;;;OAOG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAA;CAChD;AAED;;;;;GAKG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsB;IAC9C,OAAO,CAAC,SAAS,CAAgC;IACjD,OAAO,CAAC,YAAY,CAAyC;gBAEjD,MAAM,EAAE,cAAc,EAAE,OAAO,GAAE,oBAAyB;IAKtE;;;;;;;;;;;;OAYG;IACG,SAAS,CAAC,CAAC,SAAS,YAAY,EACpC,GAAG,EAAE,CAAC,EACN,QAAQ,EAAE,CAAC,KAAK,EAAE,oBAAoB,CAAC,CAAC,CAAC,KAAK,IAAI,EAClD,QAAQ,CAAC,EAAE,gBAAgB,GAC1B,OAAO,CAAC,MAAM,IAAI,CAAC;IAOtB;;;;;;;;;;OAUG;IACG,cAAc,CAClB,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,MAAM,IAAI,CAAC;IAatB;;;;OAIG;IACH,KAAK;IAQL;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;YAInB,mBAAmB;YAmBnB,YAAY;CAqC3B"}