@lifi/perps-types 0.1.1-alpha.1 → 0.1.1-alpha.2

package/src/_types/market.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"market.d.ts","sourceRoot":"","sources":["../market.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAA;IACrC,QAAQ,EAAE,OAAO,CAAA;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,kBAAkB,EAAE,CAAA;CAC9B;AAED,MAAM,WAAW,GAAG;IAClB,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,cAAc,EAAE,aAAa,EAAE,CAAA;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACpC;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,GAAG,EAAE,CAAA;CACb;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,eAAe,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,MAAM;IACrB,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,GAAG,EAAE,MAAM,CAAA;IACX,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,OAAO,CAAA;IACrB,OAAO,EAAE,WAAW,CAAA;IACpB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,EAAE,CAAA;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC/B;AAED,MAAM,WAAW,MAAM;IACrB,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;CACV;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,EAAE,CAAA;CAClB;AAED,MAAM,MAAM,aAAa,GACrB,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,KAAK,GACL,KAAK,GACL,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,KAAK,GACL,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,CAAA;AAER,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,cAAc,EAAE,CAAA;IACtB,IAAI,EAAE,cAAc,EAAE,CAAA;IACtB,SAAS,EAAE,MAAM,CAAA;CAClB"}
+{"version":3,"file":"market.d.ts","sourceRoot":"","sources":["../market.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAA;IACrC,QAAQ,EAAE,OAAO,CAAA;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,kBAAkB,EAAE,CAAA;CAC9B;AAED,MAAM,WAAW,GAAG;IAClB,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,cAAc,EAAE,aAAa,EAAE,CAAA;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACnC,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,GAAG,EAAE,CAAA;CACb;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,eAAe,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,MAAM;IACrB,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,GAAG,EAAE,MAAM,CAAA;IACX,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,OAAO,CAAA;IACrB,OAAO,EAAE,WAAW,CAAA;IACpB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,EAAE,CAAA;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC/B;AAED,MAAM,WAAW,MAAM;IACrB,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;CACV;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,EAAE,CAAA;CAClB;AAED,MAAM,MAAM,aAAa,GACrB,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,KAAK,GACL,KAAK,GACL,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,KAAK,GACL,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,CAAA;AAER,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,cAAc,EAAE,CAAA;IACtB,IAAI,EAAE,cAAc,EAAE,CAAA;IACtB,SAAS,EAAE,MAAM,CAAA;CAClB"}

package/src/_types/providers/hyperliquid/assetId.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Calculate the asset ID for a given DEX index and asset index.
+ *
+ * Main DEX (dex = ''): assetId = indexInDex
+ * HIP-3 DEXes (dex = 'xyz'): assetId = 100_000 + perpDexIndex * 10_000 + indexInDex
+ */
+export declare const calculateAssetId: (dexIndex: number, indexInDex: number) => number;
+/**
+ * Get the DEX index from the given list of dex names.
+ */
+export declare const getDexIndex: (dex: string, dexNames: string[]) => number;
+//# sourceMappingURL=assetId.d.ts.map

package/src/_types/providers/hyperliquid/assetId.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assetId.d.ts","sourceRoot":"","sources":["../../../providers/hyperliquid/assetId.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAC3B,UAAU,MAAM,EAChB,YAAY,MAAM,KACjB,MAKF,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,WAAW,GAAI,KAAK,MAAM,EAAE,UAAU,MAAM,EAAE,KAAG,MAM7D,CAAA"}

package/src/_types/providers/hyperliquid/index.d.ts

@@ -0,0 +1,4 @@
+export * from './types.js';
+export * from './assetId.js';
+export * from './mappers/index.js';
+//# sourceMappingURL=index.d.ts.map

package/src/_types/providers/hyperliquid/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../providers/hyperliquid/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,oBAAoB,CAAA"}

package/src/_types/providers/hyperliquid/mappers/history.d.ts

@@ -0,0 +1,4 @@
+import type { HistoryItem } from '../../../account.js';
+import type { HlUserFill } from '../types.js';
+export declare const mapHistoryItem: (fill: HlUserFill, dexKey: string, assetIdLookup: Map<string, number>) => HistoryItem;
+//# sourceMappingURL=history.d.ts.map

package/src/_types/providers/hyperliquid/mappers/history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../../../../providers/hyperliquid/mappers/history.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAI7C,eAAO,MAAM,cAAc,GACzB,MAAM,UAAU,EAChB,QAAQ,MAAM,EACd,eAAe,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,KACjC,WAcD,CAAA"}

package/src/_types/providers/hyperliquid/mappers/index.d.ts

@@ -0,0 +1,6 @@
+export { resolveAssetIdFromLookup } from './shared.js';
+export { mapMarket } from './market.js';
+export { mapOpenOrder, mapOrder } from './order.js';
+export { mapPosition } from './position.js';
+export { mapHistoryItem } from './history.js';
+//# sourceMappingURL=index.d.ts.map

package/src/_types/providers/hyperliquid/mappers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../providers/hyperliquid/mappers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAA;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvC,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA"}

package/src/_types/providers/hyperliquid/mappers/market.d.ts

@@ -0,0 +1,4 @@
+import type { Market } from '../../../market.js';
+import type { HlAssetCtx, HlUniverseItem } from '../types.js';
+export declare const mapMarket: (universe: HlUniverseItem, assetCtx: HlAssetCtx, dexIndex: number, indexInDex: number, dexKey: string) => Market;
+//# sourceMappingURL=market.d.ts.map

package/src/_types/providers/hyperliquid/mappers/market.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"market.d.ts","sourceRoot":"","sources":["../../../../providers/hyperliquid/mappers/market.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAEhD,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAI7D,eAAO,MAAM,SAAS,GACpB,UAAU,cAAc,EACxB,UAAU,UAAU,EACpB,UAAU,MAAM,EAChB,YAAY,MAAM,EAClB,QAAQ,MAAM,KACb,MAsBF,CAAA"}

package/src/_types/providers/hyperliquid/mappers/order.d.ts

@@ -0,0 +1,6 @@
+import type { OpenOrder } from '../../../account.js';
+import type { Order } from '../../../trading.js';
+import type { HlFrontendOpenOrder, HlOrderDetail } from '../types.js';
+export declare const mapOpenOrder: (o: HlFrontendOpenOrder, dexKey: string, assetIdLookup: Map<string, number>) => OpenOrder;
+export declare const mapOrder: (detail: HlOrderDetail) => Order;
+//# sourceMappingURL=order.d.ts.map

package/src/_types/providers/hyperliquid/mappers/order.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"order.d.ts","sourceRoot":"","sources":["../../../../providers/hyperliquid/mappers/order.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAA;AAChD,OAAO,KAAK,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAIrE,eAAO,MAAM,YAAY,GACvB,GAAG,mBAAmB,EACtB,QAAQ,MAAM,EACd,eAAe,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,KACjC,SAcD,CAAA;AAoCF,eAAO,MAAM,QAAQ,GAAI,QAAQ,aAAa,KAAG,KAsBhD,CAAA"}

package/src/_types/providers/hyperliquid/mappers/position.d.ts

@@ -0,0 +1,4 @@
+import type { Position } from '../../../account.js';
+import type { HlAssetPosition } from '../types.js';
+export declare const mapPosition: (ap: HlAssetPosition, dexKey: string, assetIdLookup: Map<string, number>) => Position;
+//# sourceMappingURL=position.d.ts.map

package/src/_types/providers/hyperliquid/mappers/position.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"position.d.ts","sourceRoot":"","sources":["../../../../providers/hyperliquid/mappers/position.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AACnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAIlD,eAAO,MAAM,WAAW,GACtB,IAAI,eAAe,EACnB,QAAQ,MAAM,EACd,eAAe,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,KACjC,QAwBF,CAAA"}

package/src/_types/providers/hyperliquid/mappers/shared.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Look up an asset ID by symbol, throwing if the symbol is unknown.
+ * Asset ID 0 is a valid Hyperliquid asset (BTC-PERP), so a fallback
+ * to 0 would silently corrupt data.
+ */
+export declare const resolveAssetIdFromLookup: (lookup: Map<string, number>, symbol: string) => number;
+//# sourceMappingURL=shared.d.ts.map

package/src/_types/providers/hyperliquid/mappers/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../../providers/hyperliquid/mappers/shared.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,GACnC,QAAQ,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAC3B,QAAQ,MAAM,KACb,MAMF,CAAA"}

package/src/_types/providers/hyperliquid/types.d.ts

@@ -0,0 +1,177 @@
+export type HlUniverseItem = {
+    name: string;
+    szDecimals: number;
+    maxLeverage: number;
+    onlyIsolated: boolean;
+    isDelisted: boolean;
+};
+export type HlMeta = {
+    universe: HlUniverseItem[];
+};
+export type HlAssetCtx = {
+    funding: string;
+    openInterest: string;
+    dayNtlVlm: string;
+    markPx: string;
+};
+export type HlMetaAndAssetCtxs = [HlMeta, HlAssetCtx[]];
+export type HlUniverse = HlMeta['universe'];
+export type HlAllMids = Record<string, string>;
+export type HlCandle = {
+    t: number;
+    o: string;
+    h: string;
+    l: string;
+    c: string;
+    v: string;
+};
+export type HlCandleSnapshot = HlCandle[];
+export type HlLevel = {
+    px: string;
+    sz: string;
+    n: number;
+};
+export type HlL2Book = {
+    levels: [HlLevel[], HlLevel[]];
+    time: number;
+};
+export type HlPosition = {
+    coin: string;
+    szi: string;
+    entryPx: string;
+    positionValue: string;
+    liquidationPx: string;
+    unrealizedPnl: string;
+    marginUsed: string;
+    leverage: {
+        type: string;
+        value: number;
+    };
+};
+export type HlAssetPosition = {
+    position: HlPosition;
+};
+export type HlClearinghouseState = {
+    assetPositions: HlAssetPosition[];
+    marginSummary: {
+        accountValue: string;
+        totalMarginUsed: string;
+    };
+    crossMarginSummary: {
+        accountValue: string;
+        totalMarginUsed: string;
+    };
+};
+export type HlSpotBalance = {
+    coin: string;
+    token: number;
+    total: string;
+    hold: string;
+    entryNtl: string;
+};
+export type HlSpotClearinghouseState = {
+    balances: HlSpotBalance[];
+};
+export type HlUserFees = {
+    userAddRate: string;
+    userCrossRate: string;
+    activeReferralDiscount: string;
+};
+export type HlFrontendOpenOrder = {
+    oid: number;
+    coin: string;
+    side: string;
+    sz: string;
+    limitPx: string;
+    orderType: string;
+    origSz: string;
+    reduceOnly: boolean;
+    timestamp: number;
+};
+export type HlFrontendOpenOrders = HlFrontendOpenOrder[];
+export type HlExtraAgents = Array<Record<string, unknown>>;
+export type HlUserFill = {
+    tid: number;
+    coin: string;
+    side: string;
+    sz: string;
+    px: string;
+    dir: string;
+    fee: string;
+    closedPnl: string;
+    time: number;
+};
+export type HlUserFills = HlUserFill[];
+export type HlUserFillsByTime = HlUserFill[];
+export type HlOrderStatusFound = {
+    status: 'order';
+    order: HlOrderDetail;
+};
+export type HlOrderDetail = {
+    order: {
+        oid: number;
+        coin: string;
+        side: string;
+        sz: string;
+        limitPx: string;
+        orderType: string;
+        origSz: string;
+        reduceOnly: boolean;
+        timestamp: number;
+        tif: string | null;
+        cloid: string | null;
+        triggerCondition: string;
+        triggerPx: string | null;
+    };
+    status: string;
+    statusTimestamp: number;
+};
+export type HlOrderStatusResponse = HlOrderStatusFound | {
+    status: 'unknownOid';
+};
+export type HlPerpDexs = Array<null | {
+    name: string;
+}>;
+export type HlExchangeRequest = {
+    action: Record<string, unknown>;
+    signature: {
+        r: string;
+        s: string;
+        v: number;
+    };
+    nonce: number;
+    vaultAddress?: string | null;
+};
+export type HlExchangeResponse = {
+    status: string;
+    response?: string | {
+        type: string;
+        data?: {
+            statuses?: Array<string | {
+                filled: {
+                    totalSz: string;
+                    avgPx: string;
+                    oid: number;
+                };
+            } | {
+                resting: {
+                    oid: number;
+                };
+            } | {
+                waitingForFill: {
+                    oid: number;
+                };
+            } | {
+                waitingForTrigger: {
+                    oid: number;
+                };
+            } | {
+                success: true;
+            } | {
+                error: string;
+            }>;
+            status?: unknown;
+        };
+    };
+};
+//# sourceMappingURL=types.d.ts.map

package/src/_types/providers/hyperliquid/types.d.ts.map

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

package/src/_types/subscriptions.d.ts

@@ -0,0 +1,70 @@
+import type { Address } from './typedData.js';
+import type { Candle, OhlcvInterval, OrderbookResponse, PricesResponse } from './market.js';
+import type { HistoryItem, Position } from './account.js';
+import type { Order } from './trading.js';
+export type PricesSubscription = {
+    channel: 'prices';
+    dex: string;
+};
+export type OrderbookSubscription = {
+    channel: 'orderbook';
+    dex: string;
+    symbol: string;
+};
+export type TradesSubscription = {
+    channel: 'trades';
+    dex: string;
+    symbol: string;
+};
+export type CandleSubscription = {
+    channel: 'candle';
+    dex: string;
+    symbol: string;
+    interval: OhlcvInterval;
+};
+export type OrderUpdatesSubscription = {
+    channel: 'orderUpdates';
+    dex: string;
+    address: Address;
+};
+export type FillsSubscription = {
+    channel: 'fills';
+    dex: string;
+    address: Address;
+};
+export type PositionsSubscription = {
+    channel: 'positions';
+    dex: string;
+    address: Address;
+};
+export type Subscription = PricesSubscription | OrderbookSubscription | TradesSubscription | CandleSubscription | OrderUpdatesSubscription | FillsSubscription | PositionsSubscription;
+export type PricesEvent = {
+    channel: 'prices';
+    data: PricesResponse;
+};
+export type OrderbookEvent = {
+    channel: 'orderbook';
+    data: OrderbookResponse;
+};
+export type TradesEvent = {
+    channel: 'trades';
+    data: HistoryItem[];
+};
+export type CandleEvent = {
+    channel: 'candle';
+    data: Candle;
+};
+export type OrderUpdatesEvent = {
+    channel: 'orderUpdates';
+    data: Order[];
+};
+export type FillsEvent = {
+    channel: 'fills';
+    data: HistoryItem[];
+};
+export type PositionsEvent = {
+    channel: 'positions';
+    data: Position[];
+};
+export type SubscriptionEvent = PricesEvent | OrderbookEvent | TradesEvent | CandleEvent | OrderUpdatesEvent | FillsEvent | PositionsEvent;
+//# sourceMappingURL=subscriptions.d.ts.map

package/src/_types/subscriptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscriptions.d.ts","sourceRoot":"","sources":["../subscriptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,KAAK,EACV,MAAM,EACN,aAAa,EACb,iBAAiB,EACjB,cAAc,EACf,MAAM,aAAa,CAAA;AACpB,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AACzD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAA;AAIzC,MAAM,MAAM,kBAAkB,GAAG;IAAE,OAAO,EAAE,QAAQ,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAA;AACnE,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,EAAE,WAAW,CAAA;IACpB,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AACD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,EAAE,QAAQ,CAAA;IACjB,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AACD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,EAAE,QAAQ,CAAA;IACjB,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,aAAa,CAAA;CACxB,CAAA;AACD,MAAM,MAAM,wBAAwB,GAAG;IACrC,OAAO,EAAE,cAAc,CAAA;IACvB,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,EAAE,OAAO,CAAA;CACjB,CAAA;AACD,MAAM,MAAM,iBAAiB,GAAG;IAC9B,OAAO,EAAE,OAAO,CAAA;IAChB,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,EAAE,OAAO,CAAA;CACjB,CAAA;AACD,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,EAAE,WAAW,CAAA;IACpB,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,EAAE,OAAO,CAAA;CACjB,CAAA;AAED,MAAM,MAAM,YAAY,GACpB,kBAAkB,GAClB,qBAAqB,GACrB,kBAAkB,GAClB,kBAAkB,GAClB,wBAAwB,GACxB,iBAAiB,GACjB,qBAAqB,CAAA;AAIzB,MAAM,MAAM,WAAW,GAAG;IAAE,OAAO,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,cAAc,CAAA;CAAE,CAAA;AACrE,MAAM,MAAM,cAAc,GAAG;IAAE,OAAO,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,iBAAiB,CAAA;CAAE,CAAA;AAC9E,MAAM,MAAM,WAAW,GAAG;IAAE,OAAO,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,WAAW,EAAE,CAAA;CAAE,CAAA;AACpE,MAAM,MAAM,WAAW,GAAG;IAAE,OAAO,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAC7D,MAAM,MAAM,iBAAiB,GAAG;IAAE,OAAO,EAAE,cAAc,CAAC;IAAC,IAAI,EAAE,KAAK,EAAE,CAAA;CAAE,CAAA;AAC1E,MAAM,MAAM,UAAU,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,WAAW,EAAE,CAAA;CAAE,CAAA;AAClE,MAAM,MAAM,cAAc,GAAG;IAAE,OAAO,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,QAAQ,EAAE,CAAA;CAAE,CAAA;AAEvE,MAAM,MAAM,iBAAiB,GACzB,WAAW,GACX,cAAc,GACd,WAAW,GACX,WAAW,GACX,iBAAiB,GACjB,UAAU,GACV,cAAc,CAAA"}

package/src/index.ts

@@ -6,3 +6,4 @@ export * from './account.js'
 export * from './trading.js'
 export * from './withdrawal.js'
 export * from './errors.js'
+export * from './subscriptions.js'

package/src/market.ts

@@ -16,6 +16,7 @@ export interface Dex {
   logoURI: string
   authorizations: Authorization[]
   extraData?: Record<string, unknown>
+  wsUrl?: string
 }
 
 export interface DexesResponse {

package/src/providers/hyperliquid/assetId.ts

@@ -0,0 +1,26 @@
+/**
+ * Calculate the asset ID for a given DEX index and asset index.
+ *
+ * Main DEX (dex = ''): assetId = indexInDex
+ * HIP-3 DEXes (dex = 'xyz'): assetId = 100_000 + perpDexIndex * 10_000 + indexInDex
+ */
+export const calculateAssetId = (
+  dexIndex: number,
+  indexInDex: number
+): number => {
+  if (dexIndex === 0) {
+    return indexInDex
+  }
+  return 100_000 + dexIndex * 10_000 + indexInDex
+}
+
+/**
+ * Get the DEX index from the given list of dex names.
+ */
+export const getDexIndex = (dex: string, dexNames: string[]): number => {
+  const index = dexNames.indexOf(dex)
+  if (index === -1) {
+    throw new Error(`Unknown sub-dex: ${dex}`)
+  }
+  return index
+}

package/src/providers/hyperliquid/index.ts

@@ -0,0 +1,3 @@
+export * from './types.js'
+export * from './assetId.js'
+export * from './mappers/index.js'

package/src/providers/hyperliquid/mappers/history.ts

@@ -0,0 +1,25 @@
+import { HistoryItemStatus, OrderSide, OrderType } from '../../../enums.js'
+import type { HistoryItem } from '../../../account.js'
+import type { HlUserFill } from '../types.js'
+
+import { resolveAssetIdFromLookup } from './shared.js'
+
+export const mapHistoryItem = (
+  fill: HlUserFill,
+  dexKey: string,
+  assetIdLookup: Map<string, number>
+): HistoryItem => ({
+  id: String(fill.tid),
+  symbol: fill.coin,
+  assetId: resolveAssetIdFromLookup(assetIdLookup, fill.coin),
+  dex: dexKey,
+  side: fill.side === 'B' ? OrderSide.BUY : OrderSide.SELL,
+  type: fill.dir?.includes('Limit') ? OrderType.LIMIT : OrderType.MARKET,
+  size: fill.sz,
+  price: fill.px,
+  status: HistoryItemStatus.FILLED,
+  filledSize: fill.sz,
+  fee: fill.fee,
+  realizedPnl: fill.closedPnl === '0' ? null : fill.closedPnl,
+  createdAt: new Date(fill.time).toISOString(),
+})

package/src/providers/hyperliquid/mappers/index.ts

@@ -0,0 +1,5 @@
+export { resolveAssetIdFromLookup } from './shared.js'
+export { mapMarket } from './market.js'
+export { mapOpenOrder, mapOrder } from './order.js'
+export { mapPosition } from './position.js'
+export { mapHistoryItem } from './history.js'

package/src/providers/hyperliquid/mappers/market.ts

@@ -0,0 +1,35 @@
+import type { Market } from '../../../market.js'
+import { calculateAssetId } from '../assetId.js'
+import type { HlAssetCtx, HlUniverseItem } from '../types.js'
+
+const NEXT_FUNDING_INTERVAL_MS = 60 * 60 * 1000 // 1 hour
+
+export const mapMarket = (
+  universe: HlUniverseItem,
+  assetCtx: HlAssetCtx,
+  dexIndex: number,
+  indexInDex: number,
+  dexKey: string
+): Market => {
+  const now = Date.now()
+  const nextFundingTime =
+    Math.ceil(now / NEXT_FUNDING_INTERVAL_MS) * NEXT_FUNDING_INTERVAL_MS
+
+  return {
+    symbol: universe.name,
+    name: universe.name,
+    logoURI: `https://app.hyperliquid.xyz/coins/${universe.name}.svg`,
+    assetId: calculateAssetId(dexIndex, indexInDex),
+    dex: dexKey,
+    szDecimals: universe.szDecimals,
+    maxLeverage: universe.maxLeverage,
+    onlyIsolated: universe.onlyIsolated === true,
+    funding: {
+      rate: assetCtx.funding,
+      nextFundingTime,
+    },
+    openInterest: assetCtx.openInterest,
+    volume24h: assetCtx.dayNtlVlm,
+    markPrice: assetCtx.markPx,
+  }
+}

package/src/providers/hyperliquid/mappers/order.ts

@@ -0,0 +1,89 @@
+import {
+  OrderSide,
+  OrderStatus,
+  OrderType,
+  TimeInForce,
+} from '../../../enums.js'
+import type { OpenOrder } from '../../../account.js'
+import type { Order } from '../../../trading.js'
+import type { HlFrontendOpenOrder, HlOrderDetail } from '../types.js'
+
+import { resolveAssetIdFromLookup } from './shared.js'
+
+export const mapOpenOrder = (
+  o: HlFrontendOpenOrder,
+  dexKey: string,
+  assetIdLookup: Map<string, number>
+): OpenOrder => ({
+  id: String(o.oid),
+  symbol: o.coin,
+  assetId: resolveAssetIdFromLookup(assetIdLookup, o.coin),
+  dex: dexKey,
+  side: o.side === 'B' ? OrderSide.BUY : OrderSide.SELL,
+  type: o.orderType === 'Limit' ? OrderType.LIMIT : OrderType.MARKET,
+  size: o.sz,
+  price: o.limitPx,
+  filledSize: o.origSz
+    ? (parseFloat(o.origSz) - parseFloat(o.sz)).toString()
+    : '0',
+  reduceOnly: o.reduceOnly ?? false,
+  createdAt: new Date(o.timestamp).toISOString(),
+})
+
+const mapOrderStatus = (status: string): OrderStatus => {
+  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
+  }
+}
+
+const mapTimeInForce = (tif: string | undefined): TimeInForce | undefined => {
+  switch (tif) {
+    case 'Gtc':
+      return TimeInForce.GTC
+    case 'Ioc':
+      return TimeInForce.IOC
+    case 'Alo':
+      return TimeInForce.POST_ONLY
+    default:
+      return undefined
+  }
+}
+
+export const mapOrder = (detail: HlOrderDetail): Order => {
+  const o = detail.order
+  const filled = parseFloat(o.origSz) - parseFloat(o.sz)
+
+  return {
+    orderId: String(o.oid),
+    clientOrderId: o.cloid ?? undefined,
+    symbol: o.coin,
+    side: o.side === 'B' ? OrderSide.BUY : OrderSide.SELL,
+    type: o.orderType === 'Limit' ? OrderType.LIMIT : OrderType.MARKET,
+    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),
+    createdAt: new Date(o.timestamp).toISOString(),
+    updatedAt: new Date(detail.statusTimestamp).toISOString(),
+  }
+}

package/src/providers/hyperliquid/mappers/position.ts

@@ -0,0 +1,35 @@
+import { MarginMode, PositionSide } from '../../../enums.js'
+import type { Position } from '../../../account.js'
+import type { HlAssetPosition } from '../types.js'
+
+import { resolveAssetIdFromLookup } from './shared.js'
+
+export const mapPosition = (
+  ap: HlAssetPosition,
+  dexKey: string,
+  assetIdLookup: Map<string, number>
+): Position => {
+  const pos = ap.position
+  const szi = parseFloat(pos.szi)
+
+  return {
+    symbol: pos.coin,
+    assetId: resolveAssetIdFromLookup(assetIdLookup, pos.coin),
+    dex: dexKey,
+    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,
+  }
+}

package/src/providers/hyperliquid/mappers/shared.ts

@@ -0,0 +1,15 @@
+/**
+ * Look up an asset ID by symbol, throwing if the symbol is unknown.
+ * Asset ID 0 is a valid Hyperliquid asset (BTC-PERP), so a fallback
+ * to 0 would silently corrupt data.
+ */
+export const resolveAssetIdFromLookup = (
+  lookup: Map<string, number>,
+  symbol: string
+): number => {
+  const id = lookup.get(symbol)
+  if (id === undefined) {
+    throw new Error(`Unknown asset symbol: ${symbol}`)
+  }
+  return id
+}