@lifi/perps-sdk 19.0.0 → 20.0.0

package/dist/types/types/withdrawal.d.ts

@@ -1,14 +1,6 @@
-import type { ActionType, Asset } from '@lifi/perps-types';
+import type { ActionType, Asset, WithdrawalRoute } from '@lifi/perps-types';
 import type { Address } from 'viem';
-/**
- * Which of a venue's two balance routes a withdrawal is drawn from. Lighter's
- * own vocabulary, carried in the signed tx as `AssetRouteType` (`perps` = 0,
- * `spot` = 1); an account's mode changes what the two balances mean, never
- * which route the tx names.
- *
- * @public
- */
-export type WithdrawalRoute = 'perps' | 'spot';
+export type { WithdrawalRoute };
 /**
  * One withdrawable `(asset, route)` selection as the provider reports it, keyed
  * by provider-native asset id and awaiting the core asset-metadata join.
@@ -23,10 +15,16 @@ export interface ProviderWithdrawableBalance {
     available: string;
     /**
      * Flat venue fee on a withdrawal from this row, in the asset's own units.
-     * Absent when the venue publishes no fee for the asset. The client rejects a
-     * value that is not a non-negative decimal.
+     * Absent when the venue publishes no fee for the asset. The client rejects
+     * a value that is not a non-negative decimal.
      */
     withdrawalFee?: string;
+    /**
+     * `true` when the venue takes `withdrawalFee` out of the requested amount,
+     * `false` when it charges the fee in addition. Set together with
+     * `withdrawalFee`; the client drops it from a row without a fee.
+     */
+    isFeeDeducted?: boolean;
 }
 /**
  * One withdrawable `(asset, route)` selection a caller can act on: the amount
@@ -41,11 +39,22 @@ export interface WithdrawableBalance {
     /** Withdrawable amount in the asset's own units. */
     available: string;
     /**
-     * Flat venue fee on a withdrawal from this row, in the asset's own units. An
-     * amount at or below it delivers nothing. Absent when the venue publishes no
-     * fee for the asset.
+     * Flat venue fee on a withdrawal from this row, in the asset's own units.
+     * Absent when the venue publishes no fee for the asset. With
+     * `isFeeDeducted` `true`, the venue takes the fee out of the requested
+     * amount, and an amount at or below the fee delivers nothing. With `false`,
+     * the venue charges the fee in addition to the requested amount, so the
+     * largest amount the row can fund is `available` minus the fee. That result
+     * is zero or negative when the fee is at or above `available`, and the row
+     * then funds no withdrawal.
      */
     withdrawalFee?: string;
+    /**
+     * Present only together with `withdrawalFee`. Absent on a row from a
+     * provider plugin that does not report it; absence means unknown, not
+     * `true`.
+     */
+    isFeeDeducted?: boolean;
 }
 /**
  * The venue accepts a withdrawal to `destination` now.

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

@@ -1 +1 @@
-{"version":3,"file":"withdrawal.d.ts","sourceRoot":"","sources":["../../../src/types/withdrawal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AAC1D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAEnC;;;;;;;GAOG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,MAAM,CAAA;AAE9C;;;;;GAKG;AACH,MAAM,WAAW,2BAA2B;IAC1C,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,eAAe,CAAA;IACtB,8EAA8E;IAC9E,SAAS,EAAE,MAAM,CAAA;IACjB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,KAAK,CAAA;IACZ,KAAK,EAAE,eAAe,CAAA;IACtB,oDAAoD;IACpD,SAAS,EAAE,MAAM,CAAA;IACjB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,OAAO,CAAA;IACb,WAAW,EAAE,OAAO,CAAA;CACrB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,eAAe,CAAA;IACrB,qEAAqE;IACrE,KAAK,EAAE,UAAU,EAAE,CAAA;CACpB;AAED;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,iBAAiB,GAAG,yBAAyB,CAAA"}
+{"version":3,"file":"withdrawal.d.ts","sourceRoot":"","sources":["../../../src/types/withdrawal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAC3E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAEnC,YAAY,EAAE,eAAe,EAAE,CAAA;AAE/B;;;;;GAKG;AACH,MAAM,WAAW,2BAA2B;IAC1C,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,eAAe,CAAA;IACtB,8EAA8E;IAC9E,SAAS,EAAE,MAAM,CAAA;IACjB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAA;CACxB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,KAAK,CAAA;IACZ,KAAK,EAAE,eAAe,CAAA;IACtB,oDAAoD;IACpD,SAAS,EAAE,MAAM,CAAA;IACjB;;;;;;;;;OASG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAA;CACxB;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,OAAO,CAAA;IACb,WAAW,EAAE,OAAO,CAAA;CACrB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,eAAe,CAAA;IACrB,qEAAqE;IACrE,KAAK,EAAE,UAAU,EAAE,CAAA;CACpB;AAED;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,iBAAiB,GAAG,yBAAyB,CAAA"}

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

@@ -164,7 +164,7 @@ interface BookWalk {
     filledNotional: number;
     /** Volume-weighted average fill price, or 0 when the book is empty. */
     vwap: number;
-    /** True when the levels could not absorb the requested notional. */
+    /** True when the levels could not absorb the requested notional, and for a non-finite notional. */
     insufficientLiquidity: boolean;
 }
 /**
@@ -173,7 +173,8 @@ interface BookWalk {
  * in array order — the caller passes asks for a buy and bids for a sell, each
  * already ordered best-price-first. When the book cannot absorb the full
  * notional, the walk stops at the last level and flags `insufficientLiquidity`,
- * returning the best obtainable fill.
+ * returning the best obtainable fill. A non-finite `sizeUsd` gives NaN fill
+ * fields with `insufficientLiquidity` set.
  *
  * @throws {PerpsError} `ValidationError` when a level's `price` or `size`
  *   does not parse to a finite number.

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

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

@@ -0,0 +1,9 @@
+import Big from 'big.js';
+/**
+ * Scoped big.js constructor with 40 decimal places for division, so the
+ * shared global `Big.DP` and `Big.RM` stay untouched.
+ */
+export declare const DivBig: Big.BigConstructor;
+/** True when every value is a finite number, so `new DivBig(value)` cannot throw. */
+export declare function areFinite(...values: number[]): boolean;
+//# sourceMappingURL=decimal.d.ts.map

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

@@ -0,0 +1 @@
+{"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,qFAAqF;AACrF,wBAAgB,SAAS,CAAC,GAAG,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAEtD"}

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

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

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

@@ -18,4 +18,11 @@
  * @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 +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"}
+{"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

@@ -37,6 +37,19 @@ export declare function estimateIsolatedLiquidationPrice(params: {
     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.
  *

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

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

@@ -9,5 +9,5 @@ export declare const name = "@lifi/perps-sdk";
  *
  * @public
  */
-export declare const version = "19.0.0";
+export declare const version = "20.0.0";
 //# sourceMappingURL=version.d.ts.map

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

@@ -11,13 +11,6 @@ export interface WsProviderFactoryParams {
     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

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

@@ -1 +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;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC,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;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,CAAC,MAAM,EAAE,uBAAuB,GAAG,UAAU,CAAA;IAC7C,gEAAgE;IAChE,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAA;IAChC,0EAA0E;IAC1E,QAAQ,CAAC,uBAAuB,EAAE,OAAO,CAAA;CAC1C;AAED;;;;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;IAC7D,OAAO,CAAC,MAAM,CAAQ;gBAEV,MAAM,EAAE,cAAc,EAAE,OAAO,GAAE,oBAAyB;IAKtE;;;;;;;OAOG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIzC;;;;;;OAMG;IACH,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAMlD;;;;;;;;;;;;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;;;;;;;OAOG;IACH,KAAK;IASL;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAIjC,OAAO,CAAC,UAAU;YASJ,mBAAmB;YAqBnB,YAAY;CAsC3B"}
+{"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;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAA;IAChB,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAA;IACb;;;;OAIG;IACH,MAAM,EAAE,cAAc,CAAA;CACvB;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,CAAC,MAAM,EAAE,uBAAuB,GAAG,UAAU,CAAA;IAC7C,gEAAgE;IAChE,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAA;IAChC,0EAA0E;IAC1E,QAAQ,CAAC,uBAAuB,EAAE,OAAO,CAAA;CAC1C;AAED;;;;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;IAC7D,OAAO,CAAC,MAAM,CAAQ;gBAEV,MAAM,EAAE,cAAc,EAAE,OAAO,GAAE,oBAAyB;IAKtE;;;;;;;OAOG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIzC;;;;;;OAMG;IACH,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAMlD;;;;;;;;;;;;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;;;;;;;OAOG;IACH,KAAK;IASL;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAIjC,OAAO,CAAC,UAAU;YASJ,mBAAmB;YAqBnB,YAAY;CA0B3B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lifi/perps-sdk",
-  "version": "19.0.0",
+  "version": "20.0.0",
   "description": "LI.FI Perps SDK for perpetuals trading",
   "homepage": "https://github.com/lifinance/perps-sdk",
   "bugs": {
@@ -46,7 +46,7 @@
     "big.js": "^7.0.1",
     "partysocket": "^1.1.19",
     "viem": "^2.55.18",
-    "@lifi/perps-types": "^17.0.0"
+    "@lifi/perps-types": "^18.0.0"
   },
   "publishConfig": {
     "access": "public"

package/src/client/PerpsClient.ts

@@ -647,21 +647,22 @@ export class PerpsClient {
   }
 
   /**
-   * The user's current venue-side settings for a market — the margin mode
-   * and leverage the next order on it will use. Resolves `undefined` when
-   * the venue exposes no readable setting for the market (or the provider
-   * has no such read at all).
+   * The user's current venue-side settings for a perps market — the margin
+   * mode and leverage the next order on it will use. Resolves the venue value
+   * or throws.
    *
-   * @throws {PerpsError} When the provider plugin is not registered.
+   * @throws {PerpsError} When the provider plugin is not registered,
+   *   `ValidationError` for a spot market, or any other `PerpsError` when the
+   *   venue read fails or carries no usable value.
    * @public
    */
   async getMarketSettings(params: {
     provider: string
     address: Address
     market: MarketRef
-  }): Promise<MarketSettings | undefined> {
+  }): Promise<MarketSettings> {
     const plugin = this.requireProvider(params.provider)
-    return plugin.getMarketSettings?.({
+    return plugin.getMarketSettings({
       address: params.address,
       market: params.market,
     })
@@ -810,7 +811,7 @@ export class PerpsClient {
    * @returns `undefined` when the registered plugin declares no withdrawable
    *   read.
    * @throws {PerpsError} When the provider plugin is not registered, when
-   *   either the plugin read or the asset sync fails, or when a row's
+   *   either the plugin read or the asset sync fails, when a row's
    *   `withdrawalFee` is not a non-negative decimal.
    * @public
    */
@@ -862,6 +863,9 @@ export class PerpsClient {
           route: row.route,
           available: row.available,
           withdrawalFee: row.withdrawalFee,
+          ...(row.isFeeDeducted === undefined
+            ? {}
+            : { isFeeDeducted: row.isFeeDeducted }),
         },
       ]
     })

package/src/client/createPerpsClient.ts

@@ -1,10 +1,6 @@
 import type { PerpsConfig } from '../types/api.js'
-import type { PerpsBaseConfig, ProviderConfigs } from '../types/config.js'
-import type {
-  PerpsProvider,
-  PerpsProviderPlugin,
-  PerpsSDKClient,
-} from '../types/provider.js'
+import type { PerpsBaseConfig } from '../types/config.js'
+import type { PerpsProvider, PerpsSDKClient } from '../types/provider.js'
 import { bindProvider } from './bindProvider.js'
 
 /**
@@ -30,15 +26,12 @@ export const DEFAULT_API_URL = 'https://li.quest/v1/perps'
  */
 export function createPerpsClient(options: PerpsConfig): PerpsSDKClient {
   const apiUrl = options.apiUrl ?? DEFAULT_API_URL
-  const { providerPlugins, providerConfigs } = splitProviders(options.providers)
 
   const config: PerpsBaseConfig = {
     integrator: options.integrator?.trim() || undefined,
     apiKey: options.apiKey?.trim() ?? '',
     apiUrl,
-    disableVersionCheck: options.disableVersionCheck,
     requestInterceptor: options.requestInterceptor,
-    providers: providerConfigs,
     retry: options.retry,
     fetch: options.fetch,
   }
@@ -58,30 +51,9 @@ export function createPerpsClient(options: PerpsConfig): PerpsSDKClient {
     },
   }
 
-  const boundProviders: PerpsProvider[] = providerPlugins.map((plugin) =>
-    bindProvider(plugin, client)
+  const boundProviders: PerpsProvider[] = (options.providers ?? []).map(
+    (plugin) => bindProvider(plugin, client)
   )
 
   return client
 }
-
-/**
- * Split the overloaded `providers` option into its two shapes — the
- * plugin array used by {@link PerpsSDKClient.getProvider}, and the
- * keyed `ProviderConfigs` consumed internally by `PerpsWsClient` for
- * markets filtering.
- */
-export function splitProviders(
-  input: PerpsProviderPlugin[] | ProviderConfigs | undefined
-): {
-  providerPlugins: PerpsProviderPlugin[]
-  providerConfigs?: ProviderConfigs
-} {
-  if (input === undefined) {
-    return { providerPlugins: [] }
-  }
-  if (Array.isArray(input)) {
-    return { providerPlugins: input }
-  }
-  return { providerPlugins: [], providerConfigs: input }
-}

package/src/client/requireProvider.ts

@@ -9,7 +9,7 @@ import type { PerpsProvider, PerpsSDKClient } from '../types/provider.js'
  * `createPerpsClient({ providers: [...] })`) rather than a runtime-recoverable
  * state.
  *
- * @internal
+ * @public
  */
 export function requireProvider(
   client: PerpsSDKClient,

package/src/index.ts

@@ -16,6 +16,7 @@ export {
   DEFAULT_API_URL,
 } from './client/createPerpsClient.js'
 export { PerpsClient } from './client/PerpsClient.js'
+export { requireProvider } from './client/requireProvider.js'
 export { PerpsErrorMessage } from './errors/constants.js'
 export { PerpsError } from './errors/PerpsError.js'
 // Registries
@@ -132,11 +133,8 @@ export type {
   WithdrawParams,
 } from './types/api.js'
 export type {
-  HyperliquidConfig,
   PerpsBaseConfig,
   PerpsClientSigner,
-  ProviderConfig,
-  ProviderConfigs,
   RequestInterceptor,
   SDKRequestOptions,
   SwitchChainHook,
@@ -222,6 +220,7 @@ export {
   formatSignedUsd,
   formatUsd,
 } from './utils/format.js'
+export { maxOf, minOf } from './utils/math.js'
 export {
   ACTIVE_ORDER_STATUSES,
   classifyFill,
@@ -241,7 +240,7 @@ export {
   findMatchingPosition,
   resolveCloseSize,
 } from './utils/orderMath.js'
-export { stringToFloat } from './utils/parse.js'
+export { parseDecimal, stringToFloat } from './utils/parse.js'
 export {
   directionSign,
   estimateIsolatedLiquidationPrice,
@@ -249,6 +248,7 @@ export {
   predictNewLeverage,
   predictUnrealizedPnl,
   realizedPnlOnClose,
+  wouldImmediatelyLiquidate,
 } from './utils/positionMath.js'
 export type { ScaleToIntegerPolicy } from './utils/scaleToInteger.js'
 export { scaleToInteger } from './utils/scaleToInteger.js'

package/src/services/getOhlcv.ts

@@ -12,6 +12,7 @@ export interface GetOhlcvParams {
   provider: string
   /** Opaque provider `Market.id`, not a display symbol. */
   marketId: string
+  /** Pick from the provider's `Provider.supportedIntervals`; support varies per provider. */
   interval: OhlcvInterval
   /** Unix timestamp in milliseconds for the start bound. */
   startTime?: number

package/src/types/api.ts

@@ -24,11 +24,7 @@ import type {
 } from '@lifi/perps-types'
 import type { Account, Address, WalletClient } from 'viem'
 import type { RetryConfig } from '../transport/retryPolicy.js'
-import type {
-  ProviderConfigs,
-  RequestInterceptor,
-  SwitchChainHook,
-} from './config.js'
+import type { RequestInterceptor, SwitchChainHook } from './config.js'
 import type { PerpsProviderPlugin } from './provider.js'
 
 /**
@@ -52,25 +48,15 @@ export interface PerpsConfig {
   apiKey?: string
   /** Perps API base URL; defaults to {@link DEFAULT_API_URL}. */
   apiUrl?: string
-  /** Skip the SDK-version compatibility check when set. */
-  disableVersionCheck?: boolean
   /** Hook that can rewrite URL/request options before transport. */
   requestInterceptor?: RequestInterceptor
   /**
-   * Provider plugins or per-provider config. Two shapes are accepted:
-   *
-   * - `PerpsProviderPlugin[]` — plugin objects implementing the read surface
-   *   for one DEX each. Bound to the client at construction and looked up at
-   *   runtime as bound {@link PerpsProvider}s via `client.getProvider(key)`.
-   *   Modelled on `@lifi/sdk`'s `providers: SDKProvider[]`.
-   * - `ProviderConfigs` — keyed config object (e.g.
-   *   `{ hyperliquid: { markets: [...] } }`). Used internally by
-   *   `PerpsWsClient` to filter which markets are subscribed to.
-   *
-   * Both may be supplied during the migration to provider packages;
-   * the array form is preferred for new code.
+   * Provider plugins, one per DEX. Bound to the client at construction and
+   * looked up at runtime as bound {@link PerpsProvider}s via
+   * `client.getProvider(key)`. Modelled on `@lifi/sdk`'s
+   * `providers: SDKProvider[]`.
    */
-  providers?: PerpsProviderPlugin[] | ProviderConfigs
+  providers?: PerpsProviderPlugin[]
   /**
    * The end-user's wallet, used whenever an action's descriptor names
    * `PerpsSigner.USER` as its `signer`. Accepts any viem-compatible WalletClient:
@@ -117,12 +103,8 @@ export interface PerpsClientOptions {
   apiKey?: string
   /** Perps API base URL; defaults to {@link DEFAULT_API_URL}. */
   apiUrl?: string
-  /**
-   * Provider plugins or per-provider config. Accepts the same two shapes as
-   * {@link PerpsConfig.providers}: an array of `PerpsProviderPlugin` plugins or
-   * a keyed `ProviderConfigs` map.
-   */
-  providers?: PerpsProviderPlugin[] | ProviderConfigs
+  /** Provider plugins; see {@link PerpsConfig.providers}. */
+  providers?: PerpsProviderPlugin[]
   /**
    * Hook invoked before a USER-signed EIP-712 action is signed, to switch the
    * user's wallet to the action's target chain. Also settable at runtime via

package/src/types/config.ts

@@ -23,32 +23,6 @@ export type SwitchChainHook = (
   chainId: number
 ) => Promise<PerpsClientSigner | undefined>
 
-/**
- * Per-provider config — restricts which `markets` the WS client subscribes
- * to. Indexed by provider key.
- *
- * @public
- */
-export interface ProviderConfig {
-  /** Optional provider category/market ids used to filter WS subscriptions. */
-  markets?: string[]
-}
-
-/**
- * @deprecated Use {@link ProviderConfig}.
- * @public
- */
-export type HyperliquidConfig = ProviderConfig
-
-/**
- * Map of per-provider {@link ProviderConfig}, keyed by provider key.
- *
- * @public
- */
-export interface ProviderConfigs {
-  [provider: string]: ProviderConfig | undefined
-}
-
 /**
  * Hook to rewrite each outgoing request's URL/`RequestInit` before it is sent.
  *
@@ -101,12 +75,8 @@ export interface PerpsBaseConfig {
   apiKey: string
   /** Resolved perps API base URL. */
   apiUrl: string
-  /** Whether SDK version compatibility checks are disabled. */
-  disableVersionCheck?: boolean
   /** Optional outgoing-request URL/options interceptor. */
   requestInterceptor?: RequestInterceptor
-  /** Optional per-provider WS market filters. */
-  providers?: ProviderConfigs
   /** Optional global or per-provider retry configuration. */
   retry?: RetryConfig
   /** Fetch implementation used by core HTTP transport. */

package/src/types/provider.ts

@@ -453,16 +453,17 @@ export interface PerpsProviderPlugin {
   ): Promise<PositionsResponse>
 
   /**
-   * The user's current venue-side settings for one market — the margin mode
-   * and leverage the next order on it will use. Optional because venues
-   * expose this unevenly: Hyperliquid reads it directly (`activeAssetData`),
-   * Lighter only reports it on an account's position row. `undefined` means
-   * the venue has nothing to read for this market.
+   * The user's current venue-side settings for one perps market — the margin
+   * mode and leverage the next order on it will use. Resolves the venue value
+   * or throws.
+   *
+   * @throws {PerpsError} `ValidationError` for a spot market; any other
+   *   `PerpsError` when the venue read fails or carries no usable value.
    */
-  getMarketSettings?(
+  getMarketSettings(
     params: ProviderGetMarketSettingsParams,
     options?: SDKRequestOptions
-  ): Promise<MarketSettings | undefined>
+  ): Promise<MarketSettings>
 
   /**
    * The amounts the account can still buy and sell on one market, in that

package/src/types/withdrawal.ts

@@ -1,15 +1,7 @@
-import type { ActionType, Asset } from '@lifi/perps-types'
+import type { ActionType, Asset, WithdrawalRoute } from '@lifi/perps-types'
 import type { Address } from 'viem'
 
-/**
- * Which of a venue's two balance routes a withdrawal is drawn from. Lighter's
- * own vocabulary, carried in the signed tx as `AssetRouteType` (`perps` = 0,
- * `spot` = 1); an account's mode changes what the two balances mean, never
- * which route the tx names.
- *
- * @public
- */
-export type WithdrawalRoute = 'perps' | 'spot'
+export type { WithdrawalRoute }
 
 /**
  * One withdrawable `(asset, route)` selection as the provider reports it, keyed
@@ -25,10 +17,16 @@ export interface ProviderWithdrawableBalance {
   available: string
   /**
    * Flat venue fee on a withdrawal from this row, in the asset's own units.
-   * Absent when the venue publishes no fee for the asset. The client rejects a
-   * value that is not a non-negative decimal.
+   * Absent when the venue publishes no fee for the asset. The client rejects
+   * a value that is not a non-negative decimal.
    */
   withdrawalFee?: string
+  /**
+   * `true` when the venue takes `withdrawalFee` out of the requested amount,
+   * `false` when it charges the fee in addition. Set together with
+   * `withdrawalFee`; the client drops it from a row without a fee.
+   */
+  isFeeDeducted?: boolean
 }
 
 /**
@@ -44,11 +42,22 @@ export interface WithdrawableBalance {
   /** Withdrawable amount in the asset's own units. */
   available: string
   /**
-   * Flat venue fee on a withdrawal from this row, in the asset's own units. An
-   * amount at or below it delivers nothing. Absent when the venue publishes no
-   * fee for the asset.
+   * Flat venue fee on a withdrawal from this row, in the asset's own units.
+   * Absent when the venue publishes no fee for the asset. With
+   * `isFeeDeducted` `true`, the venue takes the fee out of the requested
+   * amount, and an amount at or below the fee delivers nothing. With `false`,
+   * the venue charges the fee in addition to the requested amount, so the
+   * largest amount the row can fund is `available` minus the fee. That result
+   * is zero or negative when the fee is at or above `available`, and the row
+   * then funds no withdrawal.
    */
   withdrawalFee?: string
+  /**
+   * Present only together with `withdrawalFee`. Absent on a row from a
+   * provider plugin that does not report it; absence means unknown, not
+   * `true`.
+   */
+  isFeeDeducted?: boolean
 }
 
 /**