@lifi/perps-sdk-provider-hyperliquid 0.2.0-alpha.0

package/dist/esm/utils/mapOrder.d.ts

@@ -0,0 +1,49 @@
+import type { MarketDisplay, OpenOrder, Order, TriggerOrder } from '@lifi/perps-types';
+import { OrderStatus, OrderType } from '@lifi/perps-types';
+import type { HlFrontendOpenOrder, HlOrderDetail } from '../types/index.js';
+/**
+ * Map a Hyperliquid orderType string to the OrderType enum.
+ *
+ * @public
+ */
+export declare const mapOrderType: (orderType: string) => OrderType;
+/** @public */
+export declare const isTriggerType: (type: OrderType) => boolean;
+/**
+ * Decide whether a raw Hyperliquid order belongs in the cross-provider
+ * `triggerOrders` bucket. Single source of truth for both the REST
+ * `getOrders` path (`HlFrontendOpenOrder` payload) and the `orderUpdates`
+ * WS handler (`HlOrderDetail.order`, a strict subset).
+ *
+ * Authoritative signals, in order:
+ *   1. `isTrigger` — REST-only boolean Hyperliquid sets on
+ *      `frontendOpenOrders`. Definitive when present.
+ *   2. `isPositionTpsl` — REST-only flag for TP/SL legs attached to a
+ *      position.
+ *   3. `triggerCondition !== 'N/A'` — present on both REST and WS payloads.
+ *      Non-trigger orders carry the literal `'N/A'`.
+ *   4. `triggerPx` non-null and non-zero — present on both. The reliable
+ *      trigger signal on the WS wire when `orderType` lies (HL pushes
+ *      `'Limit'` for a freshly-placed TP/SL until REST refetch lands the
+ *      corrected type).
+ *   5. `orderType` — final fall-back via `isTriggerType`.
+ * @public
+ */
+export declare const isTriggerOrder: (o: HlFrontendOpenOrder | HlOrderDetail["order"]) => boolean;
+/** @public */
+export declare const mapOpenOrder: (o: HlFrontendOpenOrder, market: MarketDisplay) => OpenOrder;
+/** @public */
+export declare const mapTriggerOrder: (o: HlFrontendOpenOrder, market: MarketDisplay) => TriggerOrder;
+/** @public */
+export declare const mapOrderStatus: (status: string) => OrderStatus;
+/**
+ * Map a raw Hyperliquid order status to a short English sentence
+ * describing *why* the order ended in a terminal non-FILLED state. Bare
+ * `canceled`/`cancelled`/`rejected` carry no actionable detail and
+ * return `undefined`; so do non-terminal and unknown values.
+ * @public
+ */
+export declare const mapStatusReason: (status: string) => string | undefined;
+/** @public */
+export declare const mapOrder: (detail: HlOrderDetail, market: MarketDisplay) => Order;
+//# sourceMappingURL=mapOrder.d.ts.map

package/dist/esm/utils/mapOrder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapOrder.d.ts","sourceRoot":"","sources":["../../../src/utils/mapOrder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,SAAS,EACT,KAAK,EACL,YAAY,EACb,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAEL,WAAW,EACX,SAAS,EAEV,MAAM,mBAAmB,CAAA;AAC1B,OAAO,KAAK,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAE3E;;;;GAIG;AACH,eAAO,MAAM,YAAY,GAAI,WAAW,MAAM,KAAG,SAehD,CAAA;AAED,cAAc;AACd,eAAO,MAAM,aAAa,GAAI,MAAM,SAAS,KAAG,OAIjB,CAAA;AAE/B;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,cAAc,GACzB,GAAG,mBAAmB,GAAG,aAAa,CAAC,OAAO,CAAC,KAC9C,OAkBF,CAAA;AAED,cAAc;AACd,eAAO,MAAM,YAAY,GACvB,GAAG,mBAAmB,EACtB,QAAQ,aAAa,KACpB,SAaD,CAAA;AAEF,cAAc;AACd,eAAO,MAAM,eAAe,GAC1B,GAAG,mBAAmB,EACtB,QAAQ,aAAa,KACpB,YAcF,CAAA;AAED,cAAc;AACd,eAAO,MAAM,cAAc,GAAI,QAAQ,MAAM,KAAG,WAmB/C,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,GAAI,QAAQ,MAAM,KAAG,MAAM,GAAG,SAuBzD,CAAA;AAeD,cAAc;AACd,eAAO,MAAM,QAAQ,GACnB,QAAQ,aAAa,EACrB,QAAQ,aAAa,KACpB,KAsBF,CAAA"}

package/dist/esm/utils/mapOrder.js

@@ -0,0 +1,182 @@
+import { OrderSide, OrderStatus, OrderType, TimeInForce, } from '@lifi/perps-types';
+/**
+ * Map a Hyperliquid orderType string to the OrderType enum.
+ *
+ * @public
+ */
+export const mapOrderType = (orderType) => {
+    switch (orderType) {
+        case 'Take Profit Market':
+            return OrderType.TAKE_PROFIT_MARKET;
+        case 'Take Profit Limit':
+            return OrderType.TAKE_PROFIT_LIMIT;
+        case 'Stop Market':
+            return OrderType.STOP_MARKET;
+        case 'Stop Limit':
+            return OrderType.STOP_LIMIT;
+        case 'Market':
+            return OrderType.MARKET;
+        default:
+            return OrderType.LIMIT;
+    }
+};
+/** @public */
+export const isTriggerType = (type) => type === OrderType.TAKE_PROFIT_MARKET ||
+    type === OrderType.TAKE_PROFIT_LIMIT ||
+    type === OrderType.STOP_MARKET ||
+    type === OrderType.STOP_LIMIT;
+/**
+ * Decide whether a raw Hyperliquid order belongs in the cross-provider
+ * `triggerOrders` bucket. Single source of truth for both the REST
+ * `getOrders` path (`HlFrontendOpenOrder` payload) and the `orderUpdates`
+ * WS handler (`HlOrderDetail.order`, a strict subset).
+ *
+ * Authoritative signals, in order:
+ *   1. `isTrigger` — REST-only boolean Hyperliquid sets on
+ *      `frontendOpenOrders`. Definitive when present.
+ *   2. `isPositionTpsl` — REST-only flag for TP/SL legs attached to a
+ *      position.
+ *   3. `triggerCondition !== 'N/A'` — present on both REST and WS payloads.
+ *      Non-trigger orders carry the literal `'N/A'`.
+ *   4. `triggerPx` non-null and non-zero — present on both. The reliable
+ *      trigger signal on the WS wire when `orderType` lies (HL pushes
+ *      `'Limit'` for a freshly-placed TP/SL until REST refetch lands the
+ *      corrected type).
+ *   5. `orderType` — final fall-back via `isTriggerType`.
+ * @public
+ */
+export const isTriggerOrder = (o) => {
+    if ('isTrigger' in o && o.isTrigger === true) {
+        return true;
+    }
+    if ('isPositionTpsl' in o && o.isPositionTpsl === true) {
+        return true;
+    }
+    if (o.triggerCondition && o.triggerCondition !== 'N/A') {
+        return true;
+    }
+    if (o.triggerPx != null &&
+        o.triggerPx !== '' &&
+        parseFloat(o.triggerPx) > 0) {
+        return true;
+    }
+    return isTriggerType(mapOrderType(o.orderType));
+};
+/** @public */
+export const mapOpenOrder = (o, market) => ({
+    orderId: String(o.oid),
+    market,
+    side: o.side === 'B' ? OrderSide.BUY : OrderSide.SELL,
+    type: mapOrderType(o.orderType),
+    size: o.sz,
+    price: o.limitPx,
+    filledSize: o.origSz
+        ? (parseFloat(o.origSz) - parseFloat(o.sz)).toString()
+        : '0',
+    reduceOnly: o.reduceOnly ?? false,
+    label: o.isTrigger ? o.triggerCondition : undefined,
+    createdAt: new Date(o.timestamp).toISOString(),
+});
+/** @public */
+export const mapTriggerOrder = (o, market) => {
+    const type = mapOrderType(o.orderType);
+    const isLimit = type === OrderType.TAKE_PROFIT_LIMIT || type === OrderType.STOP_LIMIT;
+    return {
+        orderId: String(o.oid),
+        market,
+        type,
+        size: o.sz,
+        triggerPrice: o.triggerPx,
+        ...(isLimit ? { limitPrice: o.limitPx } : {}),
+        label: o.triggerCondition,
+        createdAt: new Date(o.timestamp).toISOString(),
+    };
+};
+/** @public */
+export const mapOrderStatus = (status) => {
+    switch (status) {
+        case 'open':
+        case 'resting':
+            return OrderStatus.OPEN;
+        case 'filled':
+            return OrderStatus.FILLED;
+        case 'canceled':
+        case 'cancelled':
+            return OrderStatus.CANCELLED;
+        case 'rejected':
+            return OrderStatus.REJECTED;
+        case 'triggered':
+            return OrderStatus.TRIGGERED;
+        case 'marginCanceled':
+            return OrderStatus.CANCELLED;
+        default:
+            return OrderStatus.PENDING;
+    }
+};
+/**
+ * Map a raw Hyperliquid order status to a short English sentence
+ * describing *why* the order ended in a terminal non-FILLED state. Bare
+ * `canceled`/`cancelled`/`rejected` carry no actionable detail and
+ * return `undefined`; so do non-terminal and unknown values.
+ * @public
+ */
+export const mapStatusReason = (status) => {
+    switch (status) {
+        case 'iocCanceled':
+            return 'Order cancelled: not enough liquidity to fill immediately.';
+        case 'reduceOnlyCanceled':
+            return 'Order cancelled: would not reduce your position.';
+        case 'marginCanceled':
+            return 'Order cancelled: insufficient margin.';
+        case 'liquidatedCanceled':
+            return 'Order cancelled: account was liquidated.';
+        case 'siblingFilledCanceled':
+            return 'Order cancelled: sibling OCO order filled first.';
+        case 'selfTradeCanceled':
+            return 'Order cancelled: would self-trade against your own resting order.';
+        case 'tickRejected':
+            return 'Order rejected: price did not match the tick size.';
+        case 'minTradeNtlRejected':
+            return 'Order rejected: notional value below the minimum trade size.';
+        case 'delistedRejected':
+            return 'Order rejected: market has been delisted.';
+        default:
+            return undefined;
+    }
+};
+const mapTimeInForce = (tif) => {
+    switch (tif) {
+        case 'Gtc':
+            return TimeInForce.GTC;
+        case 'Ioc':
+            return TimeInForce.IOC;
+        case 'Alo':
+            return TimeInForce.POST_ONLY;
+        default:
+            return undefined;
+    }
+};
+/** @public */
+export const mapOrder = (detail, market) => {
+    const o = detail.order;
+    const filled = parseFloat(o.origSz) - parseFloat(o.sz);
+    return {
+        orderId: String(o.oid),
+        market,
+        side: o.side === 'B' ? OrderSide.BUY : OrderSide.SELL,
+        type: mapOrderType(o.orderType),
+        price: o.limitPx,
+        originalSize: o.origSz,
+        remainingSize: o.sz,
+        filledSize: filled.toString(),
+        timeInForce: mapTimeInForce(o.tif ?? undefined),
+        reduceOnly: o.reduceOnly ?? undefined,
+        isTrigger: o.triggerCondition !== undefined && o.triggerCondition !== 'N/A',
+        triggerPrice: o.triggerPx ?? undefined,
+        status: mapOrderStatus(detail.status),
+        statusReason: mapStatusReason(detail.status),
+        createdAt: new Date(o.timestamp).toISOString(),
+        updatedAt: new Date(detail.statusTimestamp).toISOString(),
+    };
+};
+//# sourceMappingURL=mapOrder.js.map

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

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

package/dist/esm/utils/mapPosition.d.ts

@@ -0,0 +1,12 @@
+import type { MarketDisplay, Position } from '@lifi/perps-types';
+import type { HlAssetPosition } from '../types/index.js';
+/**
+ * True when the assetPosition has non-zero size. Hyperliquid keeps zero-size
+ * rows in clearinghouse states after a close; both the REST and WS positions
+ * paths drop them so a close surfaces as absence from the open set.
+ * @public
+ */
+export declare const isOpenAssetPosition: (ap: HlAssetPosition) => boolean;
+/** @public */
+export declare const mapPosition: (ap: HlAssetPosition, market: MarketDisplay) => Position;
+//# sourceMappingURL=mapPosition.d.ts.map

package/dist/esm/utils/mapPosition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapPosition.d.ts","sourceRoot":"","sources":["../../../src/utils/mapPosition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAEhE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAExD;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAAI,IAAI,eAAe,KAAG,OAChB,CAAA;AAE1C,cAAc;AACd,eAAO,MAAM,WAAW,GACtB,IAAI,eAAe,EACnB,QAAQ,aAAa,KACpB,QAsBF,CAAA"}

package/dist/esm/utils/mapPosition.js

@@ -0,0 +1,30 @@
+import { MarginMode, PositionSide } from '@lifi/perps-types';
+/**
+ * True when the assetPosition has non-zero size. Hyperliquid keeps zero-size
+ * rows in clearinghouse states after a close; both the REST and WS positions
+ * paths drop them so a close surfaces as absence from the open set.
+ * @public
+ */
+export const isOpenAssetPosition = (ap) => Number.parseFloat(ap.position.szi) !== 0;
+/** @public */
+export const mapPosition = (ap, market) => {
+    const pos = ap.position;
+    const szi = parseFloat(pos.szi);
+    return {
+        market,
+        side: szi >= 0 ? PositionSide.LONG : PositionSide.SHORT,
+        size: Math.abs(szi).toString(),
+        entryPrice: pos.entryPx ?? '0',
+        markPrice: pos.positionValue && szi !== 0
+            ? (parseFloat(pos.positionValue) / Math.abs(szi)).toString()
+            : '0',
+        liquidationPrice: pos.liquidationPx ?? '0',
+        unrealizedPnl: pos.unrealizedPnl,
+        leverage: ap.position.leverage.value,
+        marginUsed: pos.marginUsed,
+        marginMode: ap.position.leverage.type === 'cross'
+            ? MarginMode.CROSS
+            : MarginMode.ISOLATED,
+    };
+};
+//# sourceMappingURL=mapPosition.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mapPosition.js","sourceRoot":"","sources":["../../../src/utils/mapPosition.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAG5D;;;;;GAKG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,EAAmB,EAAW,EAAE,CAClE,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;AAE1C,cAAc;AACd,MAAM,CAAC,MAAM,WAAW,GAAG,CACzB,EAAmB,EACnB,MAAqB,EACX,EAAE;IACZ,MAAM,GAAG,GAAG,EAAE,CAAC,QAAQ,CAAA;IACvB,MAAM,GAAG,GAAG,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IAE/B,OAAO;QACL,MAAM;QACN,IAAI,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK;QACvD,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;QAC9B,UAAU,EAAE,GAAG,CAAC,OAAO,IAAI,GAAG;QAC9B,SAAS,EACP,GAAG,CAAC,aAAa,IAAI,GAAG,KAAK,CAAC;YAC5B,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE;YAC5D,CAAC,CAAC,GAAG;QACT,gBAAgB,EAAE,GAAG,CAAC,aAAa,IAAI,GAAG;QAC1C,aAAa,EAAE,GAAG,CAAC,aAAa;QAChC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK;QACpC,UAAU,EAAE,GAAG,CAAC,UAAU;QAC1B,UAAU,EACR,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,KAAK,OAAO;YACnC,CAAC,CAAC,UAAU,CAAC,KAAK;YAClB,CAAC,CAAC,UAAU,CAAC,QAAQ;KAC1B,CAAA;AACH,CAAC,CAAA"}

package/dist/esm/utils/marketDisplay.d.ts

@@ -0,0 +1,17 @@
+import type { Asset, Market } from '@lifi/perps-types';
+/**
+ * Synthesise the {@link Asset} for a Hyperliquid wire coin. `id` and `logoURI`
+ * keep the raw coin — the logo CDN is keyed by it, HIP-3 `dex:` prefix
+ * included. `displaySymbol` drops the prefix: the category is carried by
+ * `categoryId`, never by the display string.
+ * @public
+ */
+export declare const coinAsset: (coin: string) => Asset;
+/**
+ * Distinct wire `dex` names to fan `clearinghouseState` / `frontendOpenOrders`
+ * reads across, derived from the backend market list. Spot is excluded (it has
+ * no clearinghouseState); the main perp dex maps to the empty string.
+ * @public
+ */
+export declare const perpsDexNames: (markets: readonly Market[]) => string[];
+//# sourceMappingURL=marketDisplay.d.ts.map

package/dist/esm/utils/marketDisplay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"marketDisplay.d.ts","sourceRoot":"","sources":["../../../src/utils/marketDisplay.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAQtD;;;;;;GAMG;AACH,eAAO,MAAM,SAAS,GAAI,MAAM,MAAM,KAAG,KAKvC,CAAA;AAEF;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GAAI,SAAS,SAAS,MAAM,EAAE,KAAG,MAAM,EAShE,CAAA"}

package/dist/esm/utils/marketDisplay.js

@@ -0,0 +1,31 @@
+import { MAIN_DEX_NAME, MAIN_MARKET_ID, PROVIDER_KEY, SPOT_MARKET_ID, } from '../constants.js';
+/**
+ * Synthesise the {@link Asset} for a Hyperliquid wire coin. `id` and `logoURI`
+ * keep the raw coin — the logo CDN is keyed by it, HIP-3 `dex:` prefix
+ * included. `displaySymbol` drops the prefix: the category is carried by
+ * `categoryId`, never by the display string.
+ * @public
+ */
+export const coinAsset = (coin) => ({
+    providerId: PROVIDER_KEY,
+    id: coin,
+    displaySymbol: coin.includes(':') ? coin.slice(coin.indexOf(':') + 1) : coin,
+    logoURI: `https://app.hyperliquid.xyz/coins/${coin}.svg`,
+});
+/**
+ * Distinct wire `dex` names to fan `clearinghouseState` / `frontendOpenOrders`
+ * reads across, derived from the backend market list. Spot is excluded (it has
+ * no clearinghouseState); the main perp dex maps to the empty string.
+ * @public
+ */
+export const perpsDexNames = (markets) => {
+    const names = new Set();
+    for (const m of markets) {
+        if (m.categoryId === SPOT_MARKET_ID) {
+            continue;
+        }
+        names.add(m.categoryId === MAIN_MARKET_ID ? MAIN_DEX_NAME : m.categoryId);
+    }
+    return [...names];
+};
+//# sourceMappingURL=marketDisplay.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"marketDisplay.js","sourceRoot":"","sources":["../../../src/utils/marketDisplay.ts"],"names":[],"mappings":"AACA,OAAO,EACL,aAAa,EACb,cAAc,EACd,YAAY,EACZ,cAAc,GACf,MAAM,iBAAiB,CAAA;AAExB;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,IAAY,EAAS,EAAE,CAAC,CAAC;IACjD,UAAU,EAAE,YAAY;IACxB,EAAE,EAAE,IAAI;IACR,aAAa,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI;IAC5E,OAAO,EAAE,qCAAqC,IAAI,MAAM;CACzD,CAAC,CAAA;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,OAA0B,EAAY,EAAE;IACpE,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAA;IAC/B,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,IAAI,CAAC,CAAC,UAAU,KAAK,cAAc,EAAE,CAAC;YACpC,SAAQ;QACV,CAAC;QACD,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,KAAK,cAAc,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAA;IAC3E,CAAC;IACD,OAAO,CAAC,GAAG,KAAK,CAAC,CAAA;AACnB,CAAC,CAAA"}

package/dist/esm/utils/orderFormatting.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Hyperliquid order size and price formatting for exchange submission.
+ *
+ * These encode Hyperliquid-specific order submission rules. Getting size/price
+ * formatting wrong causes rejected orders.
+ *
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/tick-and-lot-size
+ */
+/**
+ * Derive the maximum number of price decimal places for a given asset.
+ *
+ * @param szDecimals - The asset's szDecimals (from market meta)
+ * @param market - Optional market type (e.g. 'spot'). Defaults to perps rules.
+ * @returns Maximum allowed price decimals
+ * @public
+ */
+export declare function getMaxPriceDecimals(szDecimals: number, market?: string): number;
+/**
+ * Format a size value for order submission.
+ *
+ * Per Hyperliquid docs (tick-and-lot-size):
+ * - Size must be rounded to the asset's szDecimals
+ * - Trailing zeroes must be removed for signing
+ *
+ * @param size - The size value to format
+ * @param szDecimals - Number of decimal places allowed for this asset (from meta)
+ * @returns Size as a string with correct precision, no trailing zeros
+ * @public
+ */
+export declare function formatOrderSize(size: number, szDecimals: number): string;
+/**
+ * Format a price value for order submission.
+ *
+ * Per Hyperliquid docs (tick-and-lot-size):
+ * - Maximum 5 significant figures
+ * - Max decimals = MAX_DECIMALS - szDecimals (6 for perps, 8 for spot)
+ * - Integer prices always allowed regardless of significant figures
+ * - Trailing zeroes must be removed for signing
+ *
+ * Rounding is half-up (away from zero at exact halfway) on the true decimal
+ * value, not on the binary float — (1.005).toFixed(2) would give '1.00'.
+ *
+ * @param price - The price value to format
+ * @param szDecimals - The asset's szDecimals (affects max price decimals)
+ * @param market - Optional market type (e.g. 'spot'). Defaults to perps rules.
+ * @returns Price as a string with correct precision, no trailing zeros
+ * @public
+ */
+export declare function formatOrderPrice(price: number, szDecimals: number, market?: string): string;
+//# sourceMappingURL=orderFormatting.d.ts.map

package/dist/esm/utils/orderFormatting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orderFormatting.d.ts","sourceRoot":"","sources":["../../../src/utils/orderFormatting.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAeH;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,MAAM,GACd,MAAM,CAER;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAOxE;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,MAAM,GACd,MAAM,CAYR"}

package/dist/esm/utils/orderFormatting.js

@@ -0,0 +1,78 @@
+/**
+ * Hyperliquid order size and price formatting for exchange submission.
+ *
+ * These encode Hyperliquid-specific order submission rules. Getting size/price
+ * formatting wrong causes rejected orders.
+ *
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/tick-and-lot-size
+ */
+import Big from 'big.js';
+/**
+ * Max combined decimals (size + price) enforced by Hyperliquid.
+ * Perps: 6, Spot: 8
+ */
+const MAX_DECIMALS_PERPS = 6;
+const MAX_DECIMALS_SPOT = 8;
+function getMaxDecimals(market) {
+    return market === 'spot' ? MAX_DECIMALS_SPOT : MAX_DECIMALS_PERPS;
+}
+/**
+ * Derive the maximum number of price decimal places for a given asset.
+ *
+ * @param szDecimals - The asset's szDecimals (from market meta)
+ * @param market - Optional market type (e.g. 'spot'). Defaults to perps rules.
+ * @returns Maximum allowed price decimals
+ * @public
+ */
+export function getMaxPriceDecimals(szDecimals, market) {
+    return Math.max(0, getMaxDecimals(market) - szDecimals);
+}
+/**
+ * Format a size value for order submission.
+ *
+ * Per Hyperliquid docs (tick-and-lot-size):
+ * - Size must be rounded to the asset's szDecimals
+ * - Trailing zeroes must be removed for signing
+ *
+ * @param size - The size value to format
+ * @param szDecimals - Number of decimal places allowed for this asset (from meta)
+ * @returns Size as a string with correct precision, no trailing zeros
+ * @public
+ */
+export function formatOrderSize(size, szDecimals) {
+    // Big.roundDown truncates toward zero — never round a size up, it could
+    // exceed available balance. Exact decimal arithmetic: flooring the float
+    // product dropped a lot step (0.29 * 100 === 28.999999999999996).
+    const truncated = new Big(size).round(szDecimals, Big.roundDown);
+    // toFixed() with no dp always emits plain notation; eq(0) guards '-0'
+    return truncated.eq(0) ? '0' : truncated.toFixed();
+}
+/**
+ * Format a price value for order submission.
+ *
+ * Per Hyperliquid docs (tick-and-lot-size):
+ * - Maximum 5 significant figures
+ * - Max decimals = MAX_DECIMALS - szDecimals (6 for perps, 8 for spot)
+ * - Integer prices always allowed regardless of significant figures
+ * - Trailing zeroes must be removed for signing
+ *
+ * Rounding is half-up (away from zero at exact halfway) on the true decimal
+ * value, not on the binary float — (1.005).toFixed(2) would give '1.00'.
+ *
+ * @param price - The price value to format
+ * @param szDecimals - The asset's szDecimals (affects max price decimals)
+ * @param market - Optional market type (e.g. 'spot'). Defaults to perps rules.
+ * @returns Price as a string with correct precision, no trailing zeros
+ * @public
+ */
+export function formatOrderPrice(price, szDecimals, market) {
+    const maxPriceDecimals = getMaxPriceDecimals(szDecimals, market);
+    let rounded = new Big(price).round(maxPriceDecimals, Big.roundHalfUp);
+    // Integer prices bypass the 5 sig-fig rule; prec() is a no-op below 6 sig figs
+    if (!rounded.mod(1).eq(0)) {
+        rounded = rounded.prec(5, Big.roundHalfUp);
+    }
+    // toFixed() with no dp always emits plain notation; eq(0) guards '-0'
+    return rounded.eq(0) ? '0' : rounded.toFixed();
+}
+//# sourceMappingURL=orderFormatting.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"orderFormatting.js","sourceRoot":"","sources":["../../../src/utils/orderFormatting.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,GAAG,MAAM,QAAQ,CAAA;AAExB;;;GAGG;AACH,MAAM,kBAAkB,GAAG,CAAC,CAAA;AAC5B,MAAM,iBAAiB,GAAG,CAAC,CAAA;AAE3B,SAAS,cAAc,CAAC,MAAe;IACrC,OAAO,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,kBAAkB,CAAA;AACnE,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CACjC,UAAkB,EAClB,MAAe;IAEf,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,cAAc,CAAC,MAAM,CAAC,GAAG,UAAU,CAAC,CAAA;AACzD,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,UAAkB;IAC9D,wEAAwE;IACxE,yEAAyE;IACzE,kEAAkE;IAClE,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,UAAU,EAAE,GAAG,CAAC,SAAS,CAAC,CAAA;IAChE,sEAAsE;IACtE,OAAO,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,EAAE,CAAA;AACpD,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,gBAAgB,CAC9B,KAAa,EACb,UAAkB,EAClB,MAAe;IAEf,MAAM,gBAAgB,GAAG,mBAAmB,CAAC,UAAU,EAAE,MAAM,CAAC,CAAA;IAEhE,IAAI,OAAO,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,gBAAgB,EAAE,GAAG,CAAC,WAAW,CAAC,CAAA;IAErE,+EAA+E;IAC/E,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1B,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,GAAG,CAAC,WAAW,CAAC,CAAA;IAC5C,CAAC;IAED,sEAAsE;IACtE,OAAO,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,CAAA;AAChD,CAAC"}

package/dist/esm/utils/priceStepToAggregation.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Map a desired price `step` to Hyperliquid's server-side aggregation hint
+ * `(nSigFigs, mantissa)` against the order of magnitude of `referencePrice`
+ * (the market's mark price gives the digit count). HL buckets the book to
+ * `nSigFigs` significant figures, so the figures resolving a price to `step`
+ * granularity are `floor(log10(referencePrice)) - floor(log10(step)) + 1`.
+ *
+ * Returns `{}` (full precision) when the step is finer than HL's 5-sig-fig
+ * grid or the inputs are unusable; clamps to {@link HL_MIN_SIG_FIGS} when the
+ * step is coarser than HL's lowest granularity. `mantissa` is emitted only for
+ * a non-power-of-ten step that lands on the 5-sig-fig grid, since HL ignores
+ * it below `nSigFigs === 5`.
+ *
+ * @public
+ */
+export declare function priceStepToAggregation(step: number, referencePrice: number): {
+    nSigFigs?: number;
+    mantissa?: number;
+};
+//# sourceMappingURL=priceStepToAggregation.d.ts.map

package/dist/esm/utils/priceStepToAggregation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"priceStepToAggregation.d.ts","sourceRoot":"","sources":["../../../src/utils/priceStepToAggregation.ts"],"names":[],"mappings":"AAiBA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,EACZ,cAAc,EAAE,MAAM,GACrB;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAsB1C"}

package/dist/esm/utils/priceStepToAggregation.js

@@ -0,0 +1,51 @@
+/** Significant-figure bounds Hyperliquid's `l2Book` accepts; `undefined` is full precision. */
+const HL_MIN_SIG_FIGS = 2;
+const HL_MAX_SIG_FIGS = 5;
+/** Mantissa sub-steps HL honours, but only when `nSigFigs === 5`. */
+const HL_MANTISSA_VALUES = [1, 2, 5];
+/** Snap a leading-digit ratio to the nearest mantissa HL accepts (1, 2 or 5). */
+function snapToMantissa(ratio) {
+    let closest = HL_MANTISSA_VALUES[0];
+    for (const m of HL_MANTISSA_VALUES) {
+        if (Math.abs(ratio - m) < Math.abs(ratio - closest)) {
+            closest = m;
+        }
+    }
+    return closest;
+}
+/**
+ * Map a desired price `step` to Hyperliquid's server-side aggregation hint
+ * `(nSigFigs, mantissa)` against the order of magnitude of `referencePrice`
+ * (the market's mark price gives the digit count). HL buckets the book to
+ * `nSigFigs` significant figures, so the figures resolving a price to `step`
+ * granularity are `floor(log10(referencePrice)) - floor(log10(step)) + 1`.
+ *
+ * Returns `{}` (full precision) when the step is finer than HL's 5-sig-fig
+ * grid or the inputs are unusable; clamps to {@link HL_MIN_SIG_FIGS} when the
+ * step is coarser than HL's lowest granularity. `mantissa` is emitted only for
+ * a non-power-of-ten step that lands on the 5-sig-fig grid, since HL ignores
+ * it below `nSigFigs === 5`.
+ *
+ * @public
+ */
+export function priceStepToAggregation(step, referencePrice) {
+    if (!Number.isFinite(step) || step <= 0) {
+        return {};
+    }
+    if (!Number.isFinite(referencePrice) || referencePrice <= 0) {
+        return {};
+    }
+    const stepExp = Math.floor(Math.log10(step));
+    const priceExp = Math.floor(Math.log10(referencePrice));
+    const nSigFigs = priceExp - stepExp + 1;
+    if (nSigFigs > HL_MAX_SIG_FIGS) {
+        return {};
+    }
+    const clamped = Math.max(HL_MIN_SIG_FIGS, nSigFigs);
+    const mantissa = snapToMantissa(step / 10 ** stepExp);
+    if (clamped === HL_MAX_SIG_FIGS && mantissa !== 1) {
+        return { nSigFigs: clamped, mantissa };
+    }
+    return { nSigFigs: clamped };
+}
+//# sourceMappingURL=priceStepToAggregation.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"priceStepToAggregation.js","sourceRoot":"","sources":["../../../src/utils/priceStepToAggregation.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAC/F,MAAM,eAAe,GAAG,CAAC,CAAA;AACzB,MAAM,eAAe,GAAG,CAAC,CAAA;AACzB,qEAAqE;AACrE,MAAM,kBAAkB,GAAmC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;AAEpE,iFAAiF;AACjF,SAAS,cAAc,CAAC,KAAa;IACnC,IAAI,OAAO,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAAA;IACnC,KAAK,MAAM,CAAC,IAAI,kBAAkB,EAAE,CAAC;QACnC,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,OAAO,CAAC,EAAE,CAAC;YACpD,OAAO,GAAG,CAAC,CAAA;QACb,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,sBAAsB,CACpC,IAAY,EACZ,cAAsB;IAEtB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,EAAE,CAAC;QACxC,OAAO,EAAE,CAAA;IACX,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,cAAc,IAAI,CAAC,EAAE,CAAC;QAC5D,OAAO,EAAE,CAAA;IACX,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAA;IAC5C,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,CAAA;IACvD,MAAM,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,CAAC,CAAA;IAEvC,IAAI,QAAQ,GAAG,eAAe,EAAE,CAAC;QAC/B,OAAO,EAAE,CAAA;IACX,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAA;IACnD,MAAM,QAAQ,GAAG,cAAc,CAAC,IAAI,GAAG,EAAE,IAAI,OAAO,CAAC,CAAA;IACrD,IAAI,OAAO,KAAK,eAAe,IAAI,QAAQ,KAAK,CAAC,EAAE,CAAC;QAClD,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAA;IACxC,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAA;AAC9B,CAAC"}

package/dist/esm/utils/spotBalance.d.ts

@@ -0,0 +1,18 @@
+import type { Asset, Balance, Market } from '@lifi/perps-types';
+import type { HlSpotBalance } from '../types/index.js';
+/**
+ * USD price keyed by spot token index: each spot market's live USD price
+ * (from `priceByMarketId`, keyed by `Market.id`) under its base-asset id, and
+ * every market's quote-asset id at $1. A spot market absent from
+ * `priceByMarketId` values its token at 0.
+ */
+export declare const spotPriceById: (markets: readonly Market[], priceByMarketId: ReadonlyMap<string, number>) => Map<string, number>;
+/**
+ * The held spot {@link Asset} for an HL balance: the venue token index
+ * (`b.token`) as `Asset.id` — equal to that token's spot `Market.baseAsset.id`
+ * — with display fields derived from the coin.
+ */
+export declare const spotAssetFromToken: (b: HlSpotBalance) => Asset;
+/** Assemble a typed spot {@link Balance} from its resolved asset and raw size. */
+export declare const spotBalance: (asset: Asset, total: string, priceById: Map<string, number>) => Balance;
+//# sourceMappingURL=spotBalance.d.ts.map

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

@@ -0,0 +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;AAGtD;;;;;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;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAAI,GAAG,aAAa,KAAG,KAGpD,CAAA;AAEF,kFAAkF;AAClF,eAAO,MAAM,WAAW,GACtB,OAAO,KAAK,EACZ,OAAO,MAAM,EACb,WAAW,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,KAC7B,OAKD,CAAA"}

package/dist/esm/utils/spotBalance.js

@@ -0,0 +1,40 @@
+import { stringToFloat } from '@lifi/perps-sdk';
+import { SPOT_MARKET_ID } from '../constants.js';
+import { coinAsset } from './marketDisplay.js';
+/**
+ * USD price keyed by spot token index: each spot market's live USD price
+ * (from `priceByMarketId`, keyed by `Market.id`) under its base-asset id, and
+ * every market's quote-asset id at $1. A spot market absent from
+ * `priceByMarketId` values its token at 0.
+ */
+export const spotPriceById = (markets, priceByMarketId) => {
+    const map = new Map();
+    for (const m of markets) {
+        if (m.categoryId === SPOT_MARKET_ID) {
+            map.set(m.baseAsset.id, priceByMarketId.get(m.id) ?? 0);
+        }
+    }
+    for (const m of markets) {
+        if (!map.has(m.quoteAsset.id)) {
+            map.set(m.quoteAsset.id, 1);
+        }
+    }
+    return map;
+};
+/**
+ * The held spot {@link Asset} for an HL balance: the venue token index
+ * (`b.token`) as `Asset.id` — equal to that token's spot `Market.baseAsset.id`
+ * — with display fields derived from the coin.
+ */
+export const spotAssetFromToken = (b) => ({
+    ...coinAsset(b.coin),
+    id: String(b.token),
+});
+/** Assemble a typed spot {@link Balance} from its resolved asset and raw size. */
+export const spotBalance = (asset, total, priceById) => ({
+    categoryId: SPOT_MARKET_ID,
+    asset,
+    units: total,
+    valueUsd: (stringToFloat(total) * (priceById.get(asset.id) ?? 0)).toString(),
+});
+//# sourceMappingURL=spotBalance.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"spotBalance.js","sourceRoot":"","sources":["../../../src/utils/spotBalance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAE/C,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAEhD,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAE9C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAC3B,OAA0B,EAC1B,eAA4C,EACvB,EAAE;IACvB,MAAM,GAAG,GAAG,IAAI,GAAG,EAAkB,CAAA;IACrC,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,IAAI,CAAC,CAAC,UAAU,KAAK,cAAc,EAAE,CAAC;YACpC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,EAAE,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAA;QACzD,CAAC;IACH,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,EAAE,CAAC,EAAE,CAAC;YAC9B,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,EAAE,EAAE,CAAC,CAAC,CAAA;QAC7B,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC,CAAA;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAgB,EAAS,EAAE,CAAC,CAAC;IAC9D,GAAG,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC;IACpB,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC;CACpB,CAAC,CAAA;AAEF,kFAAkF;AAClF,MAAM,CAAC,MAAM,WAAW,GAAG,CACzB,KAAY,EACZ,KAAa,EACb,SAA8B,EACrB,EAAE,CAAC,CAAC;IACb,UAAU,EAAE,cAAc;IAC1B,KAAK;IACL,KAAK,EAAE,KAAK;IACZ,QAAQ,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CAC7E,CAAC,CAAA"}