@hyperix/hooks 0.2.4 → 0.2.6

package/README.md

@@ -46,7 +46,10 @@ When you need imperative websocket access outside React hooks, reuse the
 package singleton instead of creating a second socket connection.
 
 ```ts
-import { wsClient, wsTransport } from "@hyperix/hooks";
+import { infoClient, wsClient, wsTransport } from "@hyperix/hooks";
+
+const meta = await infoClient.meta();
+console.log(meta.universe.length);
 
 const subscription = await wsClient.allMids((event) => {
   console.log(event);

package/dist/use-trade-history.d.ts

@@ -1,3 +1,4 @@
+import { type UseInfiniteQueryOptions, type UseInfiniteQueryResult } from "@tanstack/react-query";
 import { type UseUserFillsOptions, type UserFill } from "./use-user-fills.js";
 export type TradeHistory = UserFill & {
     displayCoin: string;
@@ -12,9 +13,35 @@ export type TradeHistoryData = {
     user: `0x${string}`;
     fills: TradeHistory[];
 };
+export type TradeHistoryPage = TradeHistoryData & {
+    startTime: number;
+    endTime: number;
+};
+export type InfiniteTradeHistoryData = {
+    user: `0x${string}`;
+    fills: TradeHistory[];
+    pages: TradeHistoryPage[];
+};
+export type InfiniteTradeHistoryPageParam = {
+    startTime: number;
+    endTime: number;
+};
+export type UseInfiniteTradeHistoryOptions = Omit<UseInfiniteQueryOptions<TradeHistoryPage, Error, InfiniteTradeHistoryData, [
+    "infinite-trade-history",
+    `0x${string}`,
+    boolean,
+    number,
+    number | undefined
+], InfiniteTradeHistoryPageParam>, "queryKey" | "queryFn" | "initialPageParam" | "getNextPageParam" | "select"> & {
+    aggregateByTime?: boolean;
+    endTime?: number;
+    pageDurationMs?: number;
+    realtime?: boolean;
+};
 export declare function useTradeHistory(user: `0x${string}`, options?: UseUserFillsOptions): {
     data: TradeHistoryData | undefined;
     ready: boolean;
     loading: boolean;
     error?: string;
 };
+export declare function useInfiniteTradeHistory(user: `0x${string}`, options?: UseInfiniteTradeHistoryOptions): UseInfiniteQueryResult<InfiniteTradeHistoryData, Error>;

package/dist/use-trade-history.js

@@ -1,7 +1,13 @@
+import { useInfiniteQuery, } from "@tanstack/react-query";
 import Decimal from "decimal.js";
 import { useMemo } from "react";
+import { infoClient } from "./config/hl.js";
 import { useSymbolConverter } from "./use-symbol-converter.js";
 import { useUserFills, } from "./use-user-fills.js";
+const DEFAULT_TRADE_HISTORY_PAGE_DURATION_MS = 7 * 24 * 60 * 60 * 1000;
+function getFillKey(fill) {
+    return `${fill.hash}-${fill.tid}-${fill.time}`;
+}
 function formatTradeHistoryFill(fill, spotPair) {
     const price = new Decimal(fill.px);
     if (!spotPair) {
@@ -37,6 +43,26 @@ function formatTradeHistoryFill(fill, spotPair) {
         pnlCurrency: quoteCoin,
     };
 }
+function sortTradeHistory(fills) {
+    return [...fills].sort((a, b) => {
+        if (a.time !== b.time) {
+            return b.time - a.time;
+        }
+        return b.tid - a.tid;
+    });
+}
+function mergeTradeHistoryFills(pages, realtimeFills) {
+    const fillsByKey = new Map();
+    for (const page of pages) {
+        for (const fill of page.fills) {
+            fillsByKey.set(getFillKey(fill), fill);
+        }
+    }
+    for (const fill of realtimeFills) {
+        fillsByKey.set(getFillKey(fill), fill);
+    }
+    return sortTradeHistory([...fillsByKey.values()]);
+}
 export function useTradeHistory(user, options = {}) {
     const userFillsState = useUserFills(user, options);
     const symbolConverter = useSymbolConverter();
@@ -48,7 +74,7 @@ export function useTradeHistory(user, options = {}) {
             ...userFillsState.data,
             fills: userFillsState.data.fills
                 .map((fill) => formatTradeHistoryFill(fill, symbolConverter?.getSpotByPairId(fill.coin)))
-                .reverse(),
+                .sort((a, b) => b.time - a.time),
         };
     }, [symbolConverter, userFillsState.data]);
     return {
@@ -56,3 +82,63 @@ export function useTradeHistory(user, options = {}) {
         data,
     };
 }
+export function useInfiniteTradeHistory(user, options = {}) {
+    const { aggregateByTime = true, enabled: enabledOverride, endTime, pageDurationMs = DEFAULT_TRADE_HISTORY_PAGE_DURATION_MS, realtime = true, ...queryOptions } = options;
+    const enabled = enabledOverride ?? Boolean(user);
+    const symbolConverter = useSymbolConverter();
+    const realtimeState = useTradeHistory(user, {
+        aggregateByTime,
+        enabled: enabled && realtime,
+    });
+    return useInfiniteQuery({
+        queryKey: [
+            "infinite-trade-history",
+            user,
+            aggregateByTime,
+            pageDurationMs,
+            endTime,
+        ],
+        queryFn: async ({ pageParam }) => {
+            const fills = await infoClient.userFillsByTime({
+                user,
+                startTime: pageParam.startTime,
+                endTime: pageParam.endTime,
+                aggregateByTime,
+            });
+            return {
+                user,
+                startTime: pageParam.startTime,
+                endTime: pageParam.endTime,
+                fills: sortTradeHistory(fills.map((fill) => formatTradeHistoryFill(fill, symbolConverter?.getSpotByPairId(fill.coin)))),
+            };
+        },
+        initialPageParam: {
+            startTime: Math.max(0, (endTime ?? Date.now()) - pageDurationMs),
+            endTime: endTime ?? Date.now(),
+        },
+        getNextPageParam: (lastPage) => {
+            if (lastPage.startTime <= 0) {
+                return undefined;
+            }
+            const oldestFillTime = lastPage.fills.at(-1)?.time;
+            const nextEndTime = oldestFillTime !== undefined
+                ? oldestFillTime - 1
+                : lastPage.startTime - 1;
+            return {
+                startTime: Math.max(0, nextEndTime - pageDurationMs),
+                endTime: nextEndTime,
+            };
+        },
+        select: (data) => {
+            const realtimeFills = realtimeState.data?.fills ?? [];
+            return {
+                pages: data.pages,
+                pageParams: data.pageParams,
+                user,
+                fills: mergeTradeHistoryFills(data.pages, realtimeFills),
+            };
+        },
+        ...queryOptions,
+        enabled,
+    });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperix/hooks",
-  "version": "0.2.4",
+  "version": "0.2.6",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -14,9 +14,9 @@
     "typecheck": "tsc -p tsconfig.json --noEmit"
   },
   "dependencies": {
-    "@tanstack/react-query": "^5.90.2",
     "@nktkas/hyperliquid": "^0.32.1",
-    "@outofgas/react-stream": "^0.1.4",
+    "@outofgas/react-stream": "^0.1.5",
+    "@tanstack/react-query": "^5.90.2",
     "decimal.js": "^10.6.0",
     "react": "^19.1.1"
   },