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

package/dist/cjs/websocket/HyperliquidWsProvider.js

@@ -1,18 +1,14 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.HyperliquidWsProvider = exports.hyperliquidWsProvider = void 0;
 const perps_sdk_1 = require("@lifi/perps-sdk");
 const perps_types_1 = require("@lifi/perps-types");
-const big_js_1 = __importDefault(require("big.js"));
 const viem_1 = require("viem");
 const constants_js_1 = require("../constants.js");
 const getAccountExists_js_1 = require("../services/getAccountExists.js");
 const index_js_1 = require("../types/index.js");
-const decimal_js_1 = require("../utils/decimal.js");
 const index_js_2 = require("../utils/index.js");
+const mapOrder_js_1 = require("../utils/mapOrder.js");
 const HL_L2_BOOK_MAX_LEVELS_PER_SIDE = 20;
 const normalizeHlAddress = (address) => (0, viem_1.isAddress)(address, { strict: false }) ? address.toLowerCase() : address;
 const availableAfterMaintenance = (spotState, quoteAssetId) => spotState.tokenToAvailableAfterMaintenance?.find(([token]) => String(token) === quoteAssetId)?.[1];
@@ -333,7 +329,14 @@ class HyperliquidWsProvider extends perps_sdk_1.WsProviderBase {
         if (priceStep === undefined) {
             return {};
         }
-        return (0, index_js_2.priceStepToAggregation)(priceStep, this.orderbookReferencePrice(marketId));
+        const referencePrice = this.orderbookReferencePrice(marketId);
+        const referencePriceNumber = referencePrice === undefined
+            ? undefined
+            : (0, perps_sdk_1.safeDecimalStringToNumber)(referencePrice);
+        if (referencePriceNumber === undefined) {
+            return {};
+        }
+        return (0, index_js_2.priceStepToAggregation)(priceStep, referencePriceNumber);
     }
     orderbookAggregationKey(marketId, priceStep) {
         const aggregation = this.orderbookAggregation(marketId, priceStep);
@@ -623,23 +626,22 @@ class HyperliquidWsProvider extends perps_sdk_1.WsProviderBase {
     }
     mergedMids() {
         const map = new Map();
+        const setMid = (id, mid) => {
+            const decimal = mid == null ? undefined : wsFigureToDecimalString(mid);
+            if ((0, perps_sdk_1.isDecimalString)(decimal)) {
+                map.set(id, decimal);
+            }
+        };
         for (const byMarketId of this.perpCtxBySubDex.values()) {
             for (const [id, ctx] of Object.entries(byMarketId)) {
-                const mid = ctx.midPx ?? ctx.markPx;
-                map.set(id, Number(mid));
+                setMid(id, ctx.midPx ?? ctx.markPx);
             }
         }
         for (const [id, ctx] of Object.entries(this.spotCtxByMarketId)) {
-            const mid = ctx.midPx ?? ctx.markPx;
-            if (mid != null) {
-                map.set(id, Number(mid));
-            }
+            setMid(id, ctx.midPx ?? ctx.markPx);
         }
         for (const [id, fast] of Object.entries(this.fastCtxByMarketId)) {
-            const mid = fast.midPx ?? fast.markPx;
-            if (mid != null) {
-                map.set(id, Number(mid));
-            }
+            setMid(id, fast.midPx ?? fast.markPx);
         }
         return map;
     }
@@ -651,21 +653,22 @@ class HyperliquidWsProvider extends perps_sdk_1.WsProviderBase {
         const book = this.latestOrderbookByMarketId.get(marketId);
         const bid = book?.bids[0]?.price;
         const ask = book?.asks[0]?.price;
-        if (bid !== undefined && ask !== undefined) {
-            return (Number(bid) + Number(ask)) / 2;
+        if (bid === undefined || ask === undefined) {
+            return undefined;
         }
-        return Number.NaN;
+        const sum = (0, perps_sdk_1.safeAddDecimalString)(bid, ask);
+        return sum === undefined ? undefined : (0, perps_sdk_1.safeDivideDecimalString)(sum, '2');
     }
     handleL2Book(data) {
         const book = {
             provider: this.providerKey,
             marketId: data.coin,
             bids: data.levels[0]
-                .slice(0, HL_L2_BOOK_MAX_LEVELS_PER_SIDE)
-                .map((l) => ({ price: l.px, size: l.sz })),
+                .flatMap((l) => toOrderbookLevel(data.coin, l.px, l.sz))
+                .slice(0, HL_L2_BOOK_MAX_LEVELS_PER_SIDE),
             asks: data.levels[1]
-                .slice(0, HL_L2_BOOK_MAX_LEVELS_PER_SIDE)
-                .map((l) => ({ price: l.px, size: l.sz })),
+                .flatMap((l) => toOrderbookLevel(data.coin, l.px, l.sz))
+                .slice(0, HL_L2_BOOK_MAX_LEVELS_PER_SIDE),
             timestamp: data.time,
         };
         this.latestOrderbookByMarketId.set(data.coin, book);
@@ -697,8 +700,8 @@ class HyperliquidWsProvider extends perps_sdk_1.WsProviderBase {
         const book = {
             provider: this.providerKey,
             marketId: delta.c,
-            bids: applyCompressedL2Side(previous.bids, delta.l[0], delta.r?.[0] ?? [], 'bid'),
-            asks: applyCompressedL2Side(previous.asks, delta.l[1], delta.r?.[1] ?? [], 'ask'),
+            bids: applyCompressedL2Side(delta.c, previous.bids, delta.l[0], delta.r?.[0] ?? [], 'bid'),
+            asks: applyCompressedL2Side(delta.c, previous.asks, delta.l[1], delta.r?.[1] ?? [], 'ask'),
             timestamp: delta.t,
         };
         this.latestOrderbookByMarketId.set(delta.c, book);
@@ -761,39 +764,25 @@ class HyperliquidWsProvider extends perps_sdk_1.WsProviderBase {
             if (epoch !== this.orderUpdatesEpoch || key !== this.orderUpdatesKey) {
                 return;
             }
+            const user = key.slice('orderUpdates:'.length);
             const mapped = await Promise.all(data.map(async (update) => {
                 const basic = update.order;
-                if ((0, index_js_2.assetIsOutcome)(basic.coin)) {
+                if ((0, index_js_2.assetIsOutcome)(basic.coin) ||
+                    this.registry?.get(basic.coin) === undefined) {
                     return undefined;
                 }
-                const market = this.registry?.get(basic.coin);
-                if (market === undefined) {
-                    return undefined;
+                let detail;
+                try {
+                    detail = await this.readOrderDetail(user, client, update);
                 }
-                const response = await (0, index_js_2.infoRequest)(this.orderApiUrl, {
-                    type: 'orderStatus',
-                    user: key.slice('orderUpdates:'.length),
-                    oid: basic.oid,
-                }, (0, index_js_2.hlInfoOptions)(client));
-                if (response.status !== 'order') {
-                    throw new perps_sdk_1.PerpsError(perps_types_1.PerpsErrorCode.OrderNotFound, `Hyperliquid order metadata not found: ${basic.oid}`);
+                catch (error) {
+                    if (!(error instanceof perps_sdk_1.PerpsError)) {
+                        throw error;
+                    }
+                    perps_sdk_1.wsLog.droppedRow(this.providerKey, 'order', `${basic.oid}: ${error.message}`);
+                    return undefined;
                 }
-                const detail = {
-                    status: update.status,
-                    statusTimestamp: update.statusTimestamp,
-                    order: {
-                        ...response.order.order,
-                        coin: basic.coin,
-                        side: basic.side,
-                        limitPx: basic.limitPx,
-                        sz: basic.sz,
-                        oid: basic.oid,
-                        timestamp: basic.timestamp,
-                        origSz: basic.origSz,
-                        cloid: basic.cloid ?? response.order.order.cloid,
-                    },
-                };
-                return (0, index_js_2.mapOrder)(detail, market);
+                return (0, mapOrder_js_1.mapOrderRow)(basic.coin, this.registry, (resolved) => (0, index_js_2.mapOrder)(detail, resolved));
             }));
             if (epoch !== this.orderUpdatesEpoch || key !== this.orderUpdatesKey) {
                 return;
@@ -812,6 +801,28 @@ class HyperliquidWsProvider extends perps_sdk_1.WsProviderBase {
             this.emit(key, { channel: 'orderUpdates', data: { orders, terminated } });
         });
     }
+    async readOrderDetail(user, client, update) {
+        const basic = update.order;
+        const response = await (0, index_js_2.infoRequest)(this.orderApiUrl, { type: 'orderStatus', user, oid: basic.oid }, (0, index_js_2.hlInfoOptions)(client));
+        if (response.status !== 'order') {
+            throw new perps_sdk_1.PerpsError(perps_types_1.PerpsErrorCode.OrderNotFound, `Hyperliquid order metadata not found: ${basic.oid}`);
+        }
+        return {
+            status: update.status,
+            statusTimestamp: update.statusTimestamp,
+            order: {
+                ...response.order.order,
+                coin: basic.coin,
+                side: basic.side,
+                limitPx: basic.limitPx,
+                sz: basic.sz,
+                oid: basic.oid,
+                timestamp: basic.timestamp,
+                origSz: basic.origSz,
+                cloid: basic.cloid ?? response.order.order.cloid,
+            },
+        };
+    }
     handleUserFills(data) {
         const items = data.isSnapshot
             ? []
@@ -820,7 +831,8 @@ class HyperliquidWsProvider extends perps_sdk_1.WsProviderBase {
                     return [];
                 }
                 const market = this.registry?.get(f.coin);
-                return market ? [(0, index_js_2.mapFill)(f, market)] : [];
+                const mapped = market && (0, index_js_2.mapFill)(f, market);
+                return mapped ? [mapped] : [];
             });
         this.emit(`userFills:${data.user.toLowerCase()}`, {
             channel: 'fills',
@@ -834,9 +846,10 @@ class HyperliquidWsProvider extends perps_sdk_1.WsProviderBase {
                 return [];
             }
             const market = this.registry?.get(ap.position.coin);
-            return market
-                ? [(0, index_js_2.mapPosition)(ap, (0, perps_sdk_1.toPerpsMarketDisplay)(market))]
-                : [];
+            const position = market === undefined
+                ? undefined
+                : (0, index_js_2.mapPosition)(ap, (0, perps_sdk_1.toPerpsMarketDisplay)(market));
+            return position === undefined ? [] : [position];
         }));
         this.emit(`positions:${data.user.toLowerCase()}`, {
             channel: 'positions',
@@ -844,16 +857,13 @@ class HyperliquidWsProvider extends perps_sdk_1.WsProviderBase {
         });
         const { accountValue, marginUsed } = (0, index_js_2.perpsTotals)(data.clearinghouseStates.map(([, state]) => state));
         const key = data.user.toLowerCase();
-        this.latestPerpsByUser.set(key, {
-            positions,
-            marginUsed: marginUsed.toFixed(),
-        });
+        this.latestPerpsByUser.set(key, { positions, marginUsed });
         this.emitUnifiedSummary(key);
         this.emitSummaryIfModeAllows(data.user, {
-            portfolioValue: accountValue.toFixed(),
-            availableMargin: accountValue.minus(marginUsed).toFixed(),
-            marginUsed: marginUsed.toFixed(),
-            unrealizedPnl: (0, index_js_2.sumUnrealizedPnl)(positions).toFixed(),
+            portfolioValue: accountValue,
+            availableMargin: (0, perps_sdk_1.subtractDecimalString)(accountValue, marginUsed),
+            marginUsed,
+            unrealizedPnl: (0, index_js_2.sumUnrealizedPnl)(positions),
         });
     }
     static summaryComputableFor(mode) {
@@ -937,14 +947,14 @@ class HyperliquidWsProvider extends perps_sdk_1.WsProviderBase {
         const portfolioValue = [
             ...pipeline.spot.collateralBalances,
             ...pipeline.spot.balances,
-        ].reduce((sum, balance) => sum.plus((0, decimal_js_1.toWireBig)(balance.valueUsd, 'spotBalance.valueUsd')), new big_js_1.default(0));
+        ].reduce((sum, balance) => (0, perps_sdk_1.addDecimalString)(sum, (0, perps_sdk_1.unknownToDecimalString)(balance.valueUsd, 'spotBalance.valueUsd', this.providerKey)), '0');
         this.emit(`accountSummary:${key}`, {
             channel: 'accountSummary',
             data: {
-                portfolioValue: portfolioValue.toFixed(),
+                portfolioValue,
                 availableMargin: pipeline.availableMargin,
                 marginUsed: perps.marginUsed,
-                unrealizedPnl: (0, index_js_2.sumUnrealizedPnl)(perps.positions).toFixed(),
+                unrealizedPnl: (0, index_js_2.sumUnrealizedPnl)(perps.positions),
             },
         });
     }
@@ -1056,23 +1066,26 @@ class HyperliquidWsProvider extends perps_sdk_1.WsProviderBase {
         }
         const markets = this.registry?.activeMarkets ?? [];
         const priceById = (0, index_js_2.spotPriceById)(markets, this.mergedMids());
-        const balances = data.spotState.balances.filter((balance) => !(0, index_js_2.assetIsOutcome)(balance.coin) &&
-            (0, decimal_js_1.toWireBig)(balance.total, 'spotState.balances.total').gt(0));
+        const balances = data.spotState.balances
+            .filter((balance) => !(0, index_js_2.assetIsOutcome)(balance.coin))
+            .filter((balance) => (0, perps_sdk_1.safeIsDecimalStringGreaterThan)(balance.total, '0') === true)
+            .map((balance) => ({ balance, total: balance.total }));
         const pipeline = this.unifiedSummaryByUser.get(user);
-        if (balances.some((balance) => priceById.get(String(balance.token)) === 0)) {
+        if (balances.some(({ balance }) => {
+            const price = priceById.get(String(balance.token));
+            return price !== undefined && (0, perps_sdk_1.isDecimalStringZero)(price);
+        })) {
             if (pipeline !== undefined) {
                 pipeline.spot = undefined;
             }
             return;
         }
-        const rows = balances.map((balance) => {
-            const total = (0, decimal_js_1.toWireBig)(balance.total, 'spotState.balances.total');
+        const rows = balances.map(({ balance, total }) => {
+            const free = (0, perps_sdk_1.safeSubtractDecimalString)(total, balance.hold);
             return {
-                ...(0, index_js_2.spotBalance)((0, index_js_2.spotAssetFromToken)(balance), balance.total, priceById),
+                ...(0, index_js_2.spotBalance)((0, index_js_2.spotAssetFromToken)(balance), total, priceById),
                 locked: balance.hold,
-                transferable: (0, perps_sdk_1.calculateTransferable)(total
-                    .minus((0, decimal_js_1.toWireBig)(balance.hold, 'spotState.balances.hold'))
-                    .toFixed(), total.toFixed()),
+                transferable: free === undefined ? '0' : (0, perps_sdk_1.calculateTransferable)(free, total),
             };
         });
         this.emit(`spotState:${user}`, {
@@ -1112,29 +1125,20 @@ class HyperliquidWsProvider extends perps_sdk_1.WsProviderBase {
 }
 exports.HyperliquidWsProvider = HyperliquidWsProvider;
 const isObject = (v) => typeof v === 'object' && v !== null;
-const toMarketContextString = (value) => {
-    if (typeof value === 'number') {
-        return (0, perps_sdk_1.numberToDecimalString)(value);
-    }
-    return typeof value === 'string' ? value : undefined;
-};
+function wsFigureToDecimalString(value) {
+    return typeof value === 'number' ? (0, perps_sdk_1.safeNumberToDecimalString)(value) : value;
+}
+function optionalWsFigureToDecimalString(value) {
+    return value == null ? undefined : wsFigureToDecimalString(value);
+}
 const toMarketCapString = (price, circulatingSupply) => {
-    const priceString = toMarketContextString(price);
-    const supplyString = toMarketContextString(circulatingSupply);
-    if (priceString === undefined || supplyString === undefined) {
-        return undefined;
-    }
-    try {
-        const parsedPrice = new big_js_1.default(priceString);
-        const parsedSupply = new big_js_1.default(supplyString);
-        if (parsedPrice.lte(0) || parsedSupply.lte(0)) {
-            return undefined;
-        }
-        return parsedPrice.times(parsedSupply).toFixed();
-    }
-    catch {
+    const supply = optionalWsFigureToDecimalString(circulatingSupply);
+    if (supply === undefined ||
+        (0, perps_sdk_1.safeIsDecimalStringGreaterThan)(price, '0') !== true ||
+        (0, perps_sdk_1.safeIsDecimalStringGreaterThan)(supply, '0') !== true) {
         return undefined;
     }
+    return (0, perps_sdk_1.safeMultiplyDecimalString)(price, supply);
 };
 function mergePerpAssetCtx(previous, marketId, update) {
     const funding = update.funding ?? previous?.funding;
@@ -1168,15 +1172,13 @@ function allDexsAssetCtxEntries(data) {
     return data.assetCtxs ?? data.ctxs ?? [];
 }
 function activePerpAssetCtx(marketId, ctx) {
-    const funding = toMarketContextString(ctx.funding);
-    const openInterest = toMarketContextString(ctx.openInterest);
-    const dayNtlVlm = toMarketContextString(ctx.dayNtlVlm);
-    const prevDayPx = toMarketContextString(ctx.prevDayPx);
-    const markPx = toMarketContextString(ctx.markPx);
-    const midPx = ctx.midPx === undefined || ctx.midPx === null
-        ? null
-        : (toMarketContextString(ctx.midPx) ?? null);
-    const oraclePx = toMarketContextString(ctx.oraclePx);
+    const funding = optionalWsFigureToDecimalString(ctx.funding);
+    const openInterest = optionalWsFigureToDecimalString(ctx.openInterest);
+    const dayNtlVlm = optionalWsFigureToDecimalString(ctx.dayNtlVlm);
+    const prevDayPx = optionalWsFigureToDecimalString(ctx.prevDayPx);
+    const markPx = optionalWsFigureToDecimalString(ctx.markPx);
+    const midPx = optionalWsFigureToDecimalString(ctx.midPx) ?? null;
+    const oraclePx = optionalWsFigureToDecimalString(ctx.oraclePx);
     if (funding === undefined ||
         openInterest === undefined ||
         dayNtlVlm === undefined ||
@@ -1197,8 +1199,8 @@ function activePerpAssetCtx(marketId, ctx) {
     };
 }
 function mapSpotMarketContext(marketId, ctx, fast) {
-    const midPrice = toMarketContextString(ctx.midPx ?? ctx.markPx);
-    const markPrice = toMarketContextString(ctx.markPx);
+    const midPrice = optionalWsFigureToDecimalString(ctx.midPx ?? ctx.markPx);
+    const markPrice = optionalWsFigureToDecimalString(ctx.markPx);
     if (midPrice === undefined || markPrice === undefined) {
         return undefined;
     }
@@ -1207,18 +1209,40 @@ function mapSpotMarketContext(marketId, ctx, fast) {
         marketId,
         midPrice: fast?.midPx != null ? fast.midPx : midPrice,
         markPrice: emittedMarkPrice,
-        prevDayPrice: toMarketContextString(ctx.prevDayPx),
-        volume24h: toMarketContextString(ctx.dayNtlVlm),
+        prevDayPrice: optionalWsFigureToDecimalString(ctx.prevDayPx),
+        volume24h: optionalWsFigureToDecimalString(ctx.dayNtlVlm),
         marketCap: toMarketCapString(emittedMarkPrice, ctx.circulatingSupply),
     };
 }
+const BOOK_LEVEL_ROW = 'order book level';
+function bookLevelPrice(marketId, price) {
+    if (!(0, perps_sdk_1.isDecimalString)(price)) {
+        perps_sdk_1.wsLog.skippedRow(constants_js_1.PROVIDER_KEY, BOOK_LEVEL_ROW, 'price', price, marketId);
+        return undefined;
+    }
+    return price;
+}
+function bookLevelSize(marketId, size) {
+    if (!(0, perps_sdk_1.isDecimalString)(size)) {
+        perps_sdk_1.wsLog.skippedRow(constants_js_1.PROVIDER_KEY, BOOK_LEVEL_ROW, 'size', size, marketId);
+        return undefined;
+    }
+    return size;
+}
+function toOrderbookLevel(marketId, price, size) {
+    const levelPrice = bookLevelPrice(marketId, price);
+    const levelSize = levelPrice === undefined ? undefined : bookLevelSize(marketId, size);
+    return levelPrice === undefined || levelSize === undefined
+        ? []
+        : [{ price: levelPrice, size: levelSize }];
+}
 function compactRemovalPrice(levels, value) {
     if (typeof value === 'number') {
         return levels[value]?.price;
     }
     return typeof value === 'string' ? value : value.p;
 }
-function applyCompressedL2Side(previous, updates, removals, side) {
+function applyCompressedL2Side(marketId, previous, updates, removals, side) {
     const byPrice = new Map(previous.map((level) => [level.price, level.size]));
     for (const removal of removals) {
         const price = compactRemovalPrice(previous, removal);
@@ -1227,18 +1251,23 @@ function applyCompressedL2Side(previous, updates, removals, side) {
         }
     }
     for (const update of updates) {
-        if (Number(update.s) === 0) {
-            byPrice.delete(update.p);
+        const price = bookLevelPrice(marketId, update.p);
+        if (price === undefined) {
+            continue;
+        }
+        const size = bookLevelSize(marketId, update.s);
+        if (size === undefined || (0, perps_sdk_1.safeIsDecimalStringZero)(size) !== false) {
+            byPrice.delete(price);
         }
         else {
-            byPrice.set(update.p, update.s);
+            byPrice.set(price, size);
         }
     }
     return [...byPrice.entries()]
         .map(([price, size]) => ({ price, size }))
         .sort((a, b) => side === 'bid'
-        ? Number(b.price) - Number(a.price)
-        : Number(a.price) - Number(b.price))
+        ? (0, perps_sdk_1.compareDecimalStrings)(b.price, a.price)
+        : (0, perps_sdk_1.compareDecimalStrings)(a.price, b.price))
         .slice(0, HL_L2_BOOK_MAX_LEVELS_PER_SIDE);
 }
 function isValidHlFrame(channel, data) {