@lifi/perps-sdk-provider-hyperliquid 25.0.0 → 27.0.0

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

@@ -1 +1 @@
-{"version":3,"file":"spotBalance.d.ts","sourceRoot":"","sources":["../../../src/utils/spotBalance.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAE/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAItD;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GACxB,SAAS,SAAS,MAAM,EAAE,EAC1B,iBAAiB,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,KAC3C,GAAG,CAAC,MAAM,EAAE,MAAM,CAapB,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,GAAI,GAAG,aAAa,KAAG,KAIpD,CAAA;AAEF,qIAAqI;AACrI,eAAO,MAAM,WAAW,GACtB,OAAO,KAAK,EACZ,OAAO,MAAM,EACb,WAAW,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,KAC7B,OAYF,CAAA"}
+{"version":3,"file":"spotBalance.d.ts","sourceRoot":"","sources":["../../../src/utils/spotBalance.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAE9E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAItD;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GACxB,SAAS,SAAS,MAAM,EAAE,EAC1B,iBAAiB,WAAW,CAAC,MAAM,EAAE,aAAa,CAAC,KAClD,GAAG,CAAC,MAAM,EAAE,aAAa,CAc3B,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,GAAI,GAAG,aAAa,KAAG,KAIpD,CAAA;AAEF,qIAAqI;AACrI,eAAO,MAAM,WAAW,GACtB,OAAO,KAAK,EACZ,OAAO,aAAa,EACpB,WAAW,WAAW,CAAC,MAAM,EAAE,aAAa,CAAC,KAC5C,OAUF,CAAA"}

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

@@ -1 +1 @@
-{"version":3,"file":"spotCollateral.d.ts","sourceRoot":"","sources":["../../../src/utils/spotCollateral.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAGhD;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,kBAAkB,EAAE,OAAO,EAAE,CAAA;IAC7B,QAAQ,EAAE,OAAO,EAAE,CAAA;CACpB;AAED;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GAChC,cAAc,SAAS,OAAO,EAAE,EAChC,eAAe,WAAW,CAAC,MAAM,CAAC,KACjC,aAcF,CAAA"}
+{"version":3,"file":"spotCollateral.d.ts","sourceRoot":"","sources":["../../../src/utils/spotCollateral.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAGhD;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,kBAAkB,EAAE,OAAO,EAAE,CAAA;IAC7B,QAAQ,EAAE,OAAO,EAAE,CAAA;CACpB;AAED;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GAChC,cAAc,SAAS,OAAO,EAAE,EAChC,eAAe,WAAW,CAAC,MAAM,CAAC,KACjC,aAuBF,CAAA"}

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

@@ -10,7 +10,8 @@ import { type DecimalString, type Position } from '@lifi/perps-types';
  *   margin adjustment; `'0'` for add-only strict-isolated markets and when
  *   nothing is removable.
  * @throws {PerpsError} `ValidationError` when a required `Position` decimal
- *   is malformed, or when a size, price or requirement is not positive.
+ *   is absent or malformed, or when a size, price or requirement is not
+ *   positive.
  * @see https://hyperliquid.gitbook.io/hyperliquid-docs/trading/margining
  * @public
  */

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

@@ -1 +1 @@
-{"version":3,"file":"transferMargin.d.ts","sourceRoot":"","sources":["../../../src/utils/transferMargin.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,KAAK,aAAa,EAElB,KAAK,QAAQ,EACd,MAAM,mBAAmB,CAAA;AAqB1B;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,QAAQ,GACjB,aAAa,GAAG,SAAS,CAwB3B"}
+{"version":3,"file":"transferMargin.d.ts","sourceRoot":"","sources":["../../../src/utils/transferMargin.ts"],"names":[],"mappings":"AAUA,OAAO,EACL,KAAK,aAAa,EAElB,KAAK,QAAQ,EACd,MAAM,mBAAmB,CAAA;AAkC1B;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,QAAQ,GACjB,aAAa,GAAG,SAAS,CA4B3B"}

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

@@ -1,5 +1,4 @@
-import type { HyperliquidMarginSummary, Position } from '@lifi/perps-types';
-import Big from 'big.js';
+import type { DecimalString, HyperliquidMarginSummary, Position } from '@lifi/perps-types';
 /**
  * One perps sub-dex entry {@link perpsTotals} reads. The REST response always
  * carries `marginSummary`; a WebSocket frame may omit it.
@@ -12,15 +11,17 @@ export interface DexMarginSummary {
  * Sum the venue `marginSummary` totals over every perps sub-dex of an
  * account. `accountValue` is total equity, so it already carries locked
  * margin and unrealized PnL. An entry without a `marginSummary` adds nothing.
+ * @throws {PerpsError} `SDKError` when a venue figure is not a decimal.
  * @public
  */
 export declare const perpsTotals: (dexStates: readonly DexMarginSummary[]) => {
-    accountValue: Big;
-    marginUsed: Big;
+    accountValue: DecimalString;
+    marginUsed: DecimalString;
 };
 /**
- * Sum the unrealized PnL of every position, in quote-asset units.
+ * Sum the unrealized PnL of every position, in quote-asset units. A term that
+ * does not match the decimal pattern adds nothing and warns once.
  * @public
  */
-export declare const sumUnrealizedPnl: (positions: readonly Position[]) => Big;
+export declare const sumUnrealizedPnl: (positions: readonly Position[]) => DecimalString;
 //# sourceMappingURL=venueTotals.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"venueTotals.d.ts","sourceRoot":"","sources":["../../../src/utils/venueTotals.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAC3E,OAAO,GAAG,MAAM,QAAQ,CAAA;AAGxB;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,aAAa,CAAC,EAAE,wBAAwB,CAAA;CACzC;AAED;;;;;GAKG;AACH,eAAO,MAAM,WAAW,GACtB,WAAW,SAAS,gBAAgB,EAAE,KACrC;IAAE,YAAY,EAAE,GAAG,CAAC;IAAC,UAAU,EAAE,GAAG,CAAA;CAetC,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB,GAAI,WAAW,SAAS,QAAQ,EAAE,KAAG,GAK/D,CAAA"}
+{"version":3,"file":"venueTotals.d.ts","sourceRoot":"","sources":["../../../src/utils/venueTotals.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,aAAa,EACb,wBAAwB,EACxB,QAAQ,EACT,MAAM,mBAAmB,CAAA;AAG1B;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,aAAa,CAAC,EAAE,wBAAwB,CAAA;CACzC;AAED;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,GACtB,WAAW,SAAS,gBAAgB,EAAE,KACrC;IAAE,YAAY,EAAE,aAAa,CAAC;IAAC,UAAU,EAAE,aAAa,CAAA;CAyB1D,CAAA;AAID;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAC3B,WAAW,SAAS,QAAQ,EAAE,KAC7B,aAaF,CAAA"}

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

@@ -1,16 +1,18 @@
 import { type ProviderWithdrawableBalance } from '@lifi/perps-sdk';
 import type { HlAbstractionMode, HlClearinghouseState, HlSpotClearinghouseState } from '../types/index.js';
 /**
- * Split a Hyperliquid account's venue figures into the routes a withdrawal
- * draws on. A unified or portfolio-margin account holds its collateral in spot,
+ * Split a Hyperliquid account's venue figures into the categories a
+ * withdrawal draws on. A unified or portfolio-margin account holds its collateral in spot,
  * so each spot token adds the part of `total` that no order or margin holds. A
- * route with nothing left to draw carries no row, and the caller applies the
+ * category with nothing left to draw carries no row, and the caller applies the
  * per-asset venue minimum.
  *
- * @param quoteAssetId - `Asset.id` the perps-route row is keyed by.
+ * @param quoteAssetId - `Asset.id` the perps-category row is keyed by.
  * @param withdrawalFee - Flat venue fee in quote-asset units, set on every
  *   quote-asset row. Hyperliquid deducts it from the requested amount. Absent
  *   leaves every row without a fee.
+ * @throws {PerpsError} `SDKError` when the fee or a venue figure does not match the
+ * decimal pattern.
  * @public
  */
 export declare const hyperliquidWithdrawableBalances: (abstraction: HlAbstractionMode | null, state: HlClearinghouseState, spotState: HlSpotClearinghouseState, quoteAssetId: string, withdrawalFee?: string) => ProviderWithdrawableBalance[];

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

@@ -1 +1 @@
-{"version":3,"file":"withdrawableBalances.d.ts","sourceRoot":"","sources":["../../../src/utils/withdrawableBalances.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,2BAA2B,EACjC,MAAM,iBAAiB,CAAA;AACxB,OAAO,KAAK,EACV,iBAAiB,EACjB,oBAAoB,EACpB,wBAAwB,EACzB,MAAM,mBAAmB,CAAA;AAK1B;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,+BAA+B,GAC1C,aAAa,iBAAiB,GAAG,IAAI,EACrC,OAAO,oBAAoB,EAC3B,WAAW,wBAAwB,EACnC,cAAc,MAAM,EACpB,gBAAgB,MAAM,KACrB,2BAA2B,EA8C7B,CAAA"}
+{"version":3,"file":"withdrawableBalances.d.ts","sourceRoot":"","sources":["../../../src/utils/withdrawableBalances.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,2BAA2B,EAGjC,MAAM,iBAAiB,CAAA;AAExB,OAAO,KAAK,EACV,iBAAiB,EACjB,oBAAoB,EACpB,wBAAwB,EACzB,MAAM,mBAAmB,CAAA;AAI1B;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,+BAA+B,GAC1C,aAAa,iBAAiB,GAAG,IAAI,EACrC,OAAO,oBAAoB,EAC3B,WAAW,wBAAwB,EACnC,cAAc,MAAM,EACpB,gBAAgB,MAAM,KACrB,2BAA2B,EA2D7B,CAAA"}

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

@@ -114,6 +114,8 @@ export declare class HyperliquidWsProvider extends WsProviderBase<object> {
     private handleActiveAssetCtx;
     private handleActiveSpotAssetCtx;
     /** Latest mid per `Market.id` across asset-context and fast feeds. */
+    /** Latest mid per `Market.id` across asset-context and fast feeds; a mid
+     * that does not match the decimal pattern is left out. */
     private mergedMids;
     private orderbookReferencePrice;
     private handleL2Book;
@@ -123,6 +125,7 @@ export declare class HyperliquidWsProvider extends WsProviderBase<object> {
     private handleCandle;
     private handleTrades;
     private handleOrderUpdates;
+    private readOrderDetail;
     private handleUserFills;
     private handleAllDexsClearinghouseState;
     /** Whether the mode's collateral lives per-dex, making the perps-only

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

@@ -1 +1 @@
-{"version":3,"file":"HyperliquidWsProvider.d.ts","sourceRoot":"","sources":["../../../src/websocket/HyperliquidWsProvider.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"HyperliquidWsProvider.d.ts","sourceRoot":"","sources":["../../../src/websocket/HyperliquidWsProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAYL,KAAK,cAAc,EACnB,KAAK,sBAAsB,EAC3B,KAAK,aAAa,EAGlB,KAAK,oBAAoB,EAazB,cAAc,EACd,KAAK,iBAAiB,EAEtB,KAAK,gBAAgB,EAEtB,MAAM,iBAAiB,CAAA;AACxB,OAAO,KAAK,EAQV,YAAY,EACb,MAAM,mBAAmB,CAAA;AA0E1B;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB,QAAO,iBAKtC,CAAA;AAEH;;;;;;;;;;;;;GAaG;AACH,qBAAa,qBAAsB,SAAQ,cAAc,CAAC,MAAM,CAAC;IAC/D,OAAO,CAAC,eAAe,CAAoB;IAC3C,OAAO,CAAC,iBAAiB,CAAI;IAC7B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAQ;IACpC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA4B;IAC9D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4B;IACnD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA4B;IACrD,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAmC;IAEvE,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAG/B;IACH,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAoB;IACjD,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAA4B;IACnE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA4B;IACrD,OAAO,CAAC,aAAa,CAAI;IACzB,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAuC;IACxE,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAInC;IAID,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAQlC;IAGH,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAG/B;IACH,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAQ/B;IACH,OAAO,CAAC,eAAe,CAAsD;IAC7E,OAAO,CAAC,iBAAiB,CAAuC;IAChE,OAAO,CAAC,wBAAwB,CAAoC;IACpE,OAAO,CAAC,uBAAuB,CAAiC;IAChE,OAAO,CAAC,yBAAyB,CAAuC;IAKxE,OAAO,CAAC,iBAAiB,CAAuC;IAChE,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CACW;IAM/C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAG/B;IACD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAG9B;IACD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAG9B;IACD,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAGpC;IACD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAGhC;gBAEW,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,cAAc;IAYvE,OAAO,CAAC,mBAAmB;IAoBZ,SAAS,CACtB,GAAG,EAAE,YAAY,EACjB,QAAQ,EAAE,oBAAoB,EAC9B,QAAQ,CAAC,EAAE,gBAAgB,GAC1B,OAAO,CAAC,MAAM,IAAI,CAAC;IAuBhB,cAAc,CAClB,MAAM,EAAE,sBAAsB,EAC9B,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,MAAM,IAAI,CAAC;cAkBN,WAAW,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC;IAqJnE;;;;;OAKG;IACH,OAAO,CAAC,oBAAoB;IAoB5B,OAAO,CAAC,iBAAiB;IAmBzB;;;;OAIG;IACH,OAAO,CAAC,2BAA2B;IAWnC,OAAO,CAAC,iBAAiB;IAUzB,OAAO,CAAC,gBAAgB;cAcL,OAAO,IAAI,IAAI;IA0BlC,SAAS,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAM9C,SAAS,CAAC,KAAK,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM;IA8B1C,OAAO,CAAC,oBAAoB;IAkB5B,OAAO,CAAC,uBAAuB;IAa/B,OAAO,CAAC,WAAW;IAuDnB,SAAS,CAAC,aAAa,CAAC,GAAG,EAAE,MAAM;IAiFnC,OAAO,CAAC,sBAAsB;IAM9B,OAAO,CAAC,SAAS;IAUjB,oFAAoF;IACpF,OAAO,CAAC,wBAAwB;IAyBhC,OAAO,CAAC,SAAS;IAuBjB,OAAO,CAAC,oBAAoB;IAe5B;;;;;;OAMG;IACH,OAAO,CAAC,mBAAmB;IAmB3B;;;;;OAKG;IACH,OAAO,CAAC,kBAAkB;IAgB1B;;;;;;OAMG;IACH,OAAO,CAAC,oBAAoB;IA8B5B,OAAO,CAAC,oBAAoB;IAe5B,OAAO,CAAC,wBAAwB;IAchC,sEAAsE;IACtE;8DAC0D;IAC1D,OAAO,CAAC,UAAU;IAsBlB,OAAO,CAAC,uBAAuB;IAgB/B,OAAO,CAAC,YAAY;IAgBpB,OAAO,CAAC,QAAQ;IAkBhB,OAAO,CAAC,oBAAoB;IAqC5B,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,YAAY;IAiBpB,OAAO,CAAC,YAAY;IAsBpB,OAAO,CAAC,kBAAkB;YA2DZ,eAAe;IAkC7B,OAAO,CAAC,eAAe;IAsBvB,OAAO,CAAC,+BAA+B;IA4CvC;0EACsE;IACtE,OAAO,CAAC,MAAM,CAAC,oBAAoB;YAOrB,eAAe;IA8C7B,8EAA8E;IAC9E,OAAO,CAAC,mBAAmB;IA8B3B,OAAO,CAAC,kBAAkB;IAsC1B;2EACuE;IACvE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAS;IAEnD;;+BAE2B;IAC3B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAM;IAEjD,OAAO,CAAC,uBAAuB;IA4C/B,OAAO,CAAC,oBAAoB;IAsD5B,OAAO,CAAC,qBAAqB;IAqB7B,OAAO,CAAC,eAAe;IAsBvB,OAAO,CAAC,gBAAgB;IAgDxB,0EAA0E;IAC1E,OAAO,CAAC,8BAA8B;CAsCvC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lifi/perps-sdk-provider-hyperliquid",
-  "version": "25.0.0",
+  "version": "27.0.0",
   "description": "Hyperliquid provider plugin for @lifi/perps-sdk",
   "homepage": "https://github.com/lifinance/perps-sdk",
   "bugs": {
@@ -49,10 +49,10 @@
   "dependencies": {
     "big.js": "^7.0.1",
     "viem": "^2.55.18",
-    "@lifi/perps-types": "^20.2.0"
+    "@lifi/perps-types": "^22.0.0"
   },
   "peerDependencies": {
-    "@lifi/perps-sdk": "^23.1.0"
+    "@lifi/perps-sdk": "^25.0.0"
   },
   "publishConfig": {
     "access": "public"

package/src/HyperliquidProvider.ts

@@ -479,7 +479,7 @@ export function hyperliquidProvider(
     estimateLiquidationPrice: (
       market: PerpsMarket,
       params: LiquidationEstimateParams
-    ): number | undefined =>
+    ): string | undefined =>
       calculateLiquidationPrice(
         params.entryPrice,
         params.leverage,

package/src/accountSummary.ts

@@ -1,21 +1,34 @@
-import { PerpsError } from '@lifi/perps-sdk'
+import {
+  addDecimalString,
+  PerpsError,
+  subtractDecimalString,
+  unknownToDecimalString,
+} from '@lifi/perps-sdk'
 import type {
   AccountResponse,
   AccountSummary,
   Balance,
+  DecimalString,
   HyperliquidAccountConfig,
   Position,
 } from '@lifi/perps-types'
 import { PerpsErrorCode } from '@lifi/perps-types'
-import Big from 'big.js'
+import { PROVIDER_KEY } from './constants.js'
 import { isUnifiedAbstraction } from './utils/abstractionMode.js'
-import { toWireBig } from './utils/decimal.js'
 import { perpsTotals, sumUnrealizedPnl } from './utils/venueTotals.js'
 
-const sumValueUsd = (balances: readonly Balance[]): Big =>
+const sumValueUsd = (balances: readonly Balance[]): DecimalString =>
   balances.reduce(
-    (sum, balance) => sum.plus(toWireBig(balance.valueUsd, 'balance.valueUsd')),
-    new Big(0)
+    (sum, balance) =>
+      addDecimalString(
+        sum,
+        unknownToDecimalString(
+          balance.valueUsd,
+          'balance.valueUsd',
+          PROVIDER_KEY
+        )
+      ),
+    '0'
   )
 
 const hyperliquidConfig = (
@@ -32,11 +45,11 @@ const hyperliquidConfig = (
 
 const getAvailableMargin = (
   config: HyperliquidAccountConfig,
-  accountValue: Big,
-  marginUsed: Big
-): Big => {
+  accountValue: DecimalString,
+  marginUsed: DecimalString
+): DecimalString => {
   if (!isUnifiedAbstraction(config.abstractionMode)) {
-    return accountValue.minus(marginUsed)
+    return subtractDecimalString(accountValue, marginUsed)
   }
   if (config.availableAfterMaintenance === undefined) {
     throw new PerpsError(
@@ -44,9 +57,10 @@ const getAvailableMargin = (
       `Hyperliquid '${config.abstractionMode}' account carries no quote-asset entry in \`tokenToAvailableAfterMaintenance\``
     )
   }
-  return toWireBig(
+  return unknownToDecimalString(
     config.availableAfterMaintenance,
-    'tokenToAvailableAfterMaintenance'
+    'tokenToAvailableAfterMaintenance',
+    PROVIDER_KEY
   )
 }
 
@@ -55,7 +69,8 @@ const getAvailableMargin = (
  * {@link AccountSummary}, from the venue figures the response carries.
  *
  * @throws {PerpsError} `SDKError` when the account is not a Hyperliquid one,
- * or when a unified/portfolio-margin account carries no venue buying power.
+ * when a unified/portfolio-margin account carries no venue buying power, or
+ * when a summed venue figure is not a decimal.
  * @public
  */
 export function getAccountSummary(
@@ -66,15 +81,12 @@ export function getAccountSummary(
   const { accountValue, marginUsed } = perpsTotals(config.dexStates)
 
   return {
-    portfolioValue: sumValueUsd(account.collateralBalances)
-      .plus(sumValueUsd(account.balances))
-      .toFixed(),
-    availableMargin: getAvailableMargin(
-      config,
-      accountValue,
-      marginUsed
-    ).toFixed(),
-    marginUsed: marginUsed.toFixed(),
-    unrealizedPnl: sumUnrealizedPnl(positions).toFixed(),
+    portfolioValue: addDecimalString(
+      sumValueUsd(account.collateralBalances),
+      sumValueUsd(account.balances)
+    ),
+    availableMargin: getAvailableMargin(config, accountValue, marginUsed),
+    marginUsed,
+    unrealizedPnl: sumUnrealizedPnl(positions),
   }
 }

package/src/services/getAccount.ts

@@ -2,20 +2,23 @@ import {
   calculateTransferable,
   getMarketRegistry,
   getMarketsContext,
+  isDecimalStringGreaterThan,
   type ProviderGetAccountParams,
-  parseDecimal,
   type SDKRequestOptions,
+  safeAddDecimalStrings,
+  subtractDecimalString,
   toPerpsMarketDisplay,
+  unknownToDecimalString,
 } from '@lifi/perps-sdk'
 import type {
   AccountResponse,
   Asset,
   Balance,
+  DecimalString,
   HyperliquidAccountConfig,
   HyperliquidDexAccountState,
   Position,
 } from '@lifi/perps-types'
-import type Big from 'big.js'
 import { PROVIDER_KEY } from '../constants.js'
 import type { HyperliquidContext } from '../context.js'
 import type {
@@ -26,16 +29,13 @@ import type {
   HlUserFees,
 } from '../types/index.js'
 import { isUnifiedAbstraction } from '../utils/abstractionMode.js'
-import { toWireBig } from '../utils/decimal.js'
 import {
   assetIsOutcome,
   partitionSpotBalances,
   perpsDexNames,
-  perpsTotals,
   spotAssetFromToken,
   spotBalance,
   spotPriceById,
-  sumUnrealizedPnl,
 } from '../utils/index.js'
 import { hlInfoOptions, infoRequest } from '../utils/infoClient.js'
 import { isOpenAssetPosition, mapPosition } from '../utils/mapPosition.js'
@@ -48,12 +48,6 @@ import { requireAccountExists } from './getAccountExists.js'
  */
 export type GetAccountParams = ProviderGetAccountParams
 
-// `marginSummary` covers the whole account (cross AND isolated positions);
-// `crossMarginSummary` is the cross-only subset and would drop isolated
-// equity/margin.
-const getAccountValue = (state: HlClearinghouseState): Big =>
-  toWireBig(state.marginSummary.accountValue, 'marginSummary.accountValue')
-
 /** Venue buying power for the quote asset the perps dex settles in. */
 const getAvailableAfterMaintenance = (
   spotState: HlSpotClearinghouseState,
@@ -73,21 +67,28 @@ const buildBalances = (
   spotState: HlSpotClearinghouseState,
   stateByDex: Map<string, HlClearinghouseState>,
   quoteAssetIds: ReadonlySet<string>,
-  priceById: Map<string, number>,
+  priceById: ReadonlyMap<string, DecimalString>,
   quoteAssetByCategory: Map<string, Asset>
 ): BalancePartition => {
   const { balances, collateralBalances } = partitionSpotBalances(
     spotState.balances
       .filter((b) => !assetIsOutcome(b.coin))
       .map((b) => {
-        const total = toWireBig(b.total, 'spotClearinghouseState.total')
+        const total = unknownToDecimalString(
+          b.total,
+          'spotClearinghouseState.total',
+          PROVIDER_KEY
+        )
+        const hold = unknownToDecimalString(
+          b.hold,
+          'spotClearinghouseState.hold',
+          PROVIDER_KEY
+        )
         return {
-          ...spotBalance(spotAssetFromToken(b), b.total, priceById),
+          ...spotBalance(spotAssetFromToken(b), total, priceById),
           transferable: calculateTransferable(
+            subtractDecimalString(total, hold),
             total
-              .minus(toWireBig(b.hold, 'spotClearinghouseState.hold'))
-              .toFixed(),
-            total.toFixed()
           ),
         }
       }),
@@ -101,8 +102,15 @@ const buildBalances = (
   if (!isUnifiedAbstraction(abstraction)) {
     for (const [dex, state] of stateByDex) {
       const categoryId = dex || PROVIDER_KEY
-      const value = getAccountValue(state)
-      if (!value.gt(0)) {
+      // `marginSummary` covers the whole account (cross AND isolated positions);
+      // `crossMarginSummary` is the cross-only subset and would drop isolated
+      // equity/margin.
+      const value = unknownToDecimalString(
+        state.marginSummary.accountValue,
+        'marginSummary.accountValue',
+        PROVIDER_KEY
+      )
+      if (!isDecimalStringGreaterThan(value, '0')) {
         continue
       }
       collateralBalances.push({
@@ -110,15 +118,16 @@ const buildBalances = (
         // Always present: every dex in `stateByDex` derives from `markets`,
         // which is what populates `quoteAssetByCategory`.
         asset: quoteAssetByCategory.get(categoryId)!,
-        units: value.toFixed(),
-        valueUsd: value.toFixed(),
+        units: value,
+        valueUsd: value,
         price: '1',
         transferable: calculateTransferable(
-          toWireBig(
+          unknownToDecimalString(
             state.withdrawable,
-            'clearinghouseState.withdrawable'
-          ).toFixed(),
-          value.toFixed()
+            'clearinghouseState.withdrawable',
+            PROVIDER_KEY
+          ),
+          value
         ),
       })
     }
@@ -209,9 +218,7 @@ export const getAccount = async (
 
   const priceById = spotPriceById(
     markets,
-    new Map(
-      prices.map((p) => [p.marketId, parseDecimal(p.markPrice) ?? Number.NaN])
-    )
+    new Map(prices.map((p) => [p.marketId, p.markPrice]))
   )
 
   const positions: Position[] = stateResults.flatMap((state) =>
@@ -219,12 +226,13 @@ export const getAccount = async (
       .filter(
         (ap) => !assetIsOutcome(ap.position.coin) && isOpenAssetPosition(ap)
       )
-      .map((ap) =>
-        mapPosition(
+      .flatMap((ap) => {
+        const position = mapPosition(
           ap,
           toPerpsMarketDisplay(registry.require(ap.position.coin))
         )
-      )
+        return position === undefined ? [] : [position]
+      })
   )
 
   const stateByDex = new Map<string, HlClearinghouseState>()
@@ -266,14 +274,23 @@ export const getAccount = async (
     quoteAssetByCategory
   )
 
+  const marginUsed = safeAddDecimalStrings(
+    dexStates.flatMap(({ marginSummary }) =>
+      marginSummary === undefined ? [] : [marginSummary.totalMarginUsed]
+    )
+  )
+  const unrealizedPnl = safeAddDecimalStrings(
+    positions.map((position) => position.unrealizedPnl)
+  )
+
   return {
     provider: PROVIDER_KEY,
     address: params.address,
     balances,
     collateralBalances,
     positions,
-    marginUsed: perpsTotals(dexStates).marginUsed.toFixed(),
-    unrealizedPnl: sumUnrealizedPnl(positions).toFixed(),
+    ...(marginUsed === undefined ? {} : { marginUsed }),
+    ...(unrealizedPnl === undefined ? {} : { unrealizedPnl }),
     feeTier: {
       maker: feesResult.userAddRate ?? '0',
       taker: feesResult.userCrossRate ?? '0',

package/src/services/getFills.ts

@@ -67,7 +67,8 @@ export const getFills = async (
           return []
         }
         const market = registry.get(fill.coin)
-        return market === undefined ? [] : [mapFill(fill, market)]
+        const mapped = market && mapFill(fill, market)
+        return mapped ? [mapped] : []
       })
       return { items, saturated: false }
     },

package/src/services/getMarketSettings.ts

@@ -1,4 +1,8 @@
-import { PerpsError, type SDKRequestOptions } from '@lifi/perps-sdk'
+import {
+  numberToDecimalString,
+  PerpsError,
+  type SDKRequestOptions,
+} from '@lifi/perps-sdk'
 import {
   MarginMode,
   type MarketRef,
@@ -66,6 +70,6 @@ export const getMarketSettings = async (
   return {
     marginMode:
       leverage.type === 'isolated' ? MarginMode.ISOLATED : MarginMode.CROSS,
-    leverage: leverage.value,
+    leverage: numberToDecimalString(leverage.value),
   }
 }

package/src/services/getOrder.ts

@@ -24,6 +24,15 @@ import { requireAccountExists } from './getAccountExists.js'
  */
 export type GetOrderParams = ProviderGetOrderParams
 
+const orderNotFound = (id: string): PerpsError => {
+  const err = new PerpsError(
+    PerpsErrorCode.OrderNotFound,
+    `Order not found: ${id}`
+  )
+  err.tool = PROVIDER_KEY
+  return err
+}
+
 /**
  * Read getOrder direct from the Hyperliquid REST API.
  *
@@ -70,17 +79,16 @@ export const getOrder = async (
     if (twap !== undefined) {
       const registry = getMarketRegistry(client, PROVIDER_KEY)
       await registry.sync()
-      return mapOrder(twap, registry.require(twap.state.coin))
+      const order = mapOrder(twap, registry.require(twap.state.coin))
+      if (order === undefined) {
+        throw orderNotFound(params.id)
+      }
+      return order
     }
   }
 
   if (status.status !== 'order' || assetIsOutcome(status.order.order.coin)) {
-    const err = new PerpsError(
-      PerpsErrorCode.OrderNotFound,
-      `Order not found: ${params.id}`
-    )
-    err.tool = PROVIDER_KEY
-    throw err
+    throw orderNotFound(params.id)
   }
 
   const registry = getMarketRegistry(client, PROVIDER_KEY)
@@ -89,6 +97,9 @@ export const getOrder = async (
     status.order,
     registry.require(status.order.order.coin)
   )
+  if (order === undefined) {
+    throw orderNotFound(params.id)
+  }
   const [linked] = await withExplorerLinks([order], params.address, infoOpts)
   return linked
 }

package/src/services/getOrders.ts

@@ -1,14 +1,11 @@
 import {
   ACTIVE_ORDER_STATUSES,
-  createWarnOnce,
   getMarketRegistry,
   isActiveOrderStatus,
-  type MarketRegistry,
-  PerpsError,
   type ProviderGetOrdersParams,
   type SDKRequestOptions,
 } from '@lifi/perps-sdk'
-import type { MarketDisplay, Order, OrdersResponse } from '@lifi/perps-types'
+import type { Order, OrdersResponse } from '@lifi/perps-types'
 import { PROVIDER_KEY } from '../constants.js'
 import type { HyperliquidContext } from '../context.js'
 import type {
@@ -17,48 +14,14 @@ import type {
   HlTwapHistoryEntry,
 } from '../types/index.js'
 import { withExplorerLinks } from '../utils/explorer.js'
-import { assetIsOutcome, mapOrder, perpsDexNames } from '../utils/index.js'
+import { mapOrder, perpsDexNames } from '../utils/index.js'
 import { hlInfoOptions, infoRequest } from '../utils/infoClient.js'
+import { mapOrderRow } from '../utils/mapOrder.js'
 import { requireAccountExists } from './getAccountExists.js'
 
 /** Parameters for a lifecycle-filtered Hyperliquid order read. */
 export type GetOrdersParams = ProviderGetOrdersParams
 
-const warn = createWarnOnce()
-
-const warnOnce = (key: string): void => {
-  warn(key, `[${PROVIDER_KEY}] ${key}`)
-}
-
-/**
- * Map one venue row, or drop it. An outcome market identity, a coin the backend
- * market list does not hold, and a row the mapper rejects each drop only their
- * own row instead of rejecting the whole page; each distinct mapper message
- * warns once.
- */
-const mapRow = (
-  coin: string,
-  registry: MarketRegistry,
-  map: (market: MarketDisplay) => Order
-): Order | undefined => {
-  if (assetIsOutcome(coin)) {
-    return undefined
-  }
-  const market = registry.get(coin)
-  if (market === undefined) {
-    return undefined
-  }
-  try {
-    return map(market)
-  } catch (error) {
-    if (!(error instanceof PerpsError)) {
-      throw error
-    }
-    warnOnce(`dropped order row: ${error.message}`)
-    return undefined
-  }
-}
-
 /** Read regular, trigger, and TWAP orders from the requested lifecycle feeds. */
 export const getOrders = async (
   { client, apiUrl }: HyperliquidContext,
@@ -114,17 +77,22 @@ export const getOrders = async (
       rows.set(key, order)
     }
   }
+  const seenHistorical = new Set<string>()
   for (const detail of historical) {
     const key = String(detail.order.oid)
     // The feed carries one row per lifecycle transition, newest first, and a
     // terminal row shares its timestamp with the `open` row beneath it, so
-    // only the first row of an id states that order's current status.
-    if (rows.has(key)) {
+    // only the first row of an id states that order's current status, even
+    // when the mapper skips that row.
+    if (seenHistorical.has(key)) {
       continue
     }
+    seenHistorical.add(key)
     keep(
       key,
-      mapRow(detail.order.coin, registry, (market) => mapOrder(detail, market))
+      mapOrderRow(detail.order.coin, registry, (market) =>
+        mapOrder(detail, market)
+      )
     )
   }
   const raw = open.flat()
@@ -135,13 +103,13 @@ export const getOrders = async (
     if (!childIds.has(order.oid)) {
       keep(
         String(order.oid),
-        mapRow(order.coin, registry, (market) => mapOrder(order, market))
+        mapOrderRow(order.coin, registry, (market) => mapOrder(order, market))
       )
     }
     for (const child of order.children ?? []) {
       keep(
         String(child.oid),
-        mapRow(child.coin, registry, (market) =>
+        mapOrderRow(child.coin, registry, (market) =>
           mapOrder(child, market, String(order.oid))
         )
       )
@@ -151,7 +119,7 @@ export const getOrders = async (
   for (const twap of twaps) {
     keep(
       `twap:${twap.twapId}`,
-      mapRow(twap.state.coin, registry, (market) => mapOrder(twap, market))
+      mapOrderRow(twap.state.coin, registry, (market) => mapOrder(twap, market))
     )
   }
   const matching = [...rows.values()].filter(