@pear-protocol/hyperliquid-sdk 0.0.31 → 0.0.33

package/dist/clients/hyperliquid.d.ts

@@ -6,4 +6,4 @@ export declare const fetchHistoricalCandles: (coin: string, startTime: number, e
 /**
  * Retrieve recent user fills from HyperLiquid and map to ExternalFillDto[]
  */
-export declare const fetchUserFillsFromHyperliquid: (user: string, aggregateByTime?: boolean) => Promise<ApiResponse<ExternalFillDto[]>>;
+export declare const fetchUserFillsFromHyperliquid: (user: string, startTime: number, aggregateByTime?: boolean) => Promise<ApiResponse<ExternalFillDto[]>>;

package/dist/hooks/index.d.ts

@@ -12,3 +12,4 @@ export * from './useAutoSyncFills';
 export * from './usePosition';
 export * from './useOrders';
 export * from './useTwap';
+export * from './useNotifications';

package/dist/hooks/useNotifications.d.ts

@@ -0,0 +1,10 @@
+import type { NotificationDto } from '../types';
+export interface UseNotificationsResult {
+    notifications: NotificationDto[] | null;
+    unreadCount: number;
+}
+/**
+ * Provides notifications and fills checkpoint data sourced from the SDK WebSocket.
+ * Data is persisted in the SDK's Zustand store.
+ */
+export declare function useNotifications(): UseNotificationsResult;

package/dist/index.d.ts

@@ -30,7 +30,7 @@ type WebSocketConnectionState = 'connecting' | 'connected' | 'disconnected' | 'e
 /**
  * WebSocket channels
  */
-type WebSocketChannel = 'trade-histories' | 'open-positions' | 'open-orders' | 'account-summary' | 'twap-details' | 'webData2' | 'allMids' | 'activeAssetData';
+type WebSocketChannel = 'trade-histories' | 'open-positions' | 'open-orders' | 'account-summary' | 'twap-details' | 'notifications' | 'webData2' | 'allMids' | 'activeAssetData';
 /**
  * WebSocket subscription message
  */
@@ -53,6 +53,16 @@ interface WebSocketDataMessage<T = unknown> {
     channel: WebSocketChannel;
     data: T;
 }
+type NotificationCategory = 'TRADE_OPENED_OUTSIDE_PEAR' | 'POSITION_LIQUIDATED' | 'LIMIT_ORDER_FILLED' | 'LIMIT_ORDER_FAILED' | 'TP_ORDER_FILLED' | 'TP_ORDER_FAILED' | 'SL_ORDER_FILLED' | 'SL_ORDER_FAILED';
+interface NotificationDto {
+    id: string;
+    address: string;
+    category: NotificationCategory;
+    parameters: Record<string, any>;
+    is_read: boolean;
+    created_at: string;
+    updated_at: string;
+}
 interface ChunkFillDto {
     fillId: string;
     assetName: string;
@@ -120,7 +130,6 @@ interface TradeHistoryDataDto {
     totalValue: number;
     entryRatio: number;
     exitRatio: number;
-    leverage: number;
     longAssets: TradeHistoryAssetDataDto[];
     shortAssets: TradeHistoryAssetDataDto[];
     createdAt: string;
@@ -433,7 +442,6 @@ interface RawAssetDto {
 interface RawPositionDto {
     positionId: string;
     address: string;
-    leverage: number;
     stopLoss: number | null;
     takeProfit: number | null;
     status: string;
@@ -937,6 +945,16 @@ declare function useTwap(): {
     readonly cancelTwap: (orderId: string) => Promise<ApiResponse<CancelTwapResponseDto>>;
 };
 
+interface UseNotificationsResult {
+    notifications: NotificationDto[] | null;
+    unreadCount: number;
+}
+/**
+ * Provides notifications and fills checkpoint data sourced from the SDK WebSocket.
+ * Data is persisted in the SDK's Zustand store.
+ */
+declare function useNotifications(): UseNotificationsResult;
+
 interface UseHyperliquidWebSocketProps {
     wsUrl: string;
     address: string | null;
@@ -1060,5 +1078,5 @@ declare function mapTradingViewIntervalToCandleInterval(interval: string): Candl
  */
 declare function mapCandleIntervalToTradingViewInterval(interval: CandleInterval): string;
 
-export { AccountSummaryCalculator, AuthStatus, ConflictDetector, PearHyperliquidProvider, TokenMetadataExtractor, adjustOrder, adjustPosition, calculateWeightedRatio, cancelOrder, cancelTwap, cancelTwapOrder, closePosition, computeBasketCandles, createCandleLookups, createPosition, getCompleteTimestamps, mapCandleIntervalToTradingViewInterval, mapTradingViewIntervalToCandleInterval, updateRiskParameters, useAccountSummary, useAddress, useAgentWallet, useAuth, useAutoSyncFills, useBasketCandles, useHistoricalPriceData, useHistoricalPriceDataStore, useHyperliquidNativeWebSocket, useHyperliquidWebSocket, useOpenOrders, useOrders, usePearAgentWallet, usePearAuth, usePearHyperliquid, usePerformanceOverlays, usePosition, useTokenSelectionMetadata, useTradeHistories, useTwap, useUserSelection, useWebData };
-export type { AccountSummaryResponseDto, AdjustExecutionType, AdjustOrderRequestInput, AdjustOrderResponseDto, AdjustPositionRequestInput, AdjustPositionResponseDto, AgentWalletDto, AgentWalletState, ApiErrorResponse, ApiResponse, AssetCtx, AssetInformationDetail, AssetMarketData, AssetPosition, AutoSyncFillsOptions, AutoSyncFillsState, BalanceSummaryDto, CancelOrderResponseDto, CancelTwapResponseDto, CandleChartData, CandleData, CandleInterval, CandleSnapshotRequest, ClearinghouseState, CloseExecutionType, ClosePositionRequestInput, ClosePositionResponseDto, CreatePositionRequestInput, CreatePositionResponseDto, CrossMarginSummaryDto, CumFundingDto, ExecutionType, HLWebSocketResponse, HistoricalRange, LadderConfigInput, MarginSummaryDto, OpenLimitOrderDto, OpenPositionDto, OrderAssetDto, OrderStatus, PairAssetInput, PerformanceOverlay, PositionAdjustmentType, PositionAssetDetailDto, PositionAssetSummaryDto, PositionResponseStatus, RealtimeBar, RealtimeBarsCallback, TokenConflict, TokenHistoricalPriceData, TokenMetadata, TokenSelection, TpSlThresholdInput, TpSlThresholdType, TradeHistoryAssetDataDto, TradeHistoryDataDto, TwapChunkStatusDto, TwapMonitoringDto, UniverseAsset, UpdateRiskParametersRequestInput, UpdateRiskParametersResponseDto, UseAgentWalletOptions, UseAuthOptions, UseBasketCandlesReturn, UseHistoricalPriceDataReturn, UsePerformanceOverlaysReturn, UseTokenSelectionMetadataReturn, UserProfile, UserSelectionState, WebData2Response, WebSocketAckResponse, WebSocketChannel, WebSocketConnectionState, WebSocketDataMessage, WebSocketMessage, WebSocketSubscribeMessage, WsAllMidsData };
+export { AccountSummaryCalculator, AuthStatus, ConflictDetector, PearHyperliquidProvider, TokenMetadataExtractor, adjustOrder, adjustPosition, calculateWeightedRatio, cancelOrder, cancelTwap, cancelTwapOrder, closePosition, computeBasketCandles, createCandleLookups, createPosition, getCompleteTimestamps, mapCandleIntervalToTradingViewInterval, mapTradingViewIntervalToCandleInterval, updateRiskParameters, useAccountSummary, useAddress, useAgentWallet, useAuth, useAutoSyncFills, useBasketCandles, useHistoricalPriceData, useHistoricalPriceDataStore, useHyperliquidNativeWebSocket, useHyperliquidWebSocket, useNotifications, useOpenOrders, useOrders, usePearAgentWallet, usePearAuth, usePearHyperliquid, usePerformanceOverlays, usePosition, useTokenSelectionMetadata, useTradeHistories, useTwap, useUserSelection, useWebData };
+export type { AccountSummaryResponseDto, AdjustExecutionType, AdjustOrderRequestInput, AdjustOrderResponseDto, AdjustPositionRequestInput, AdjustPositionResponseDto, AgentWalletDto, AgentWalletState, ApiErrorResponse, ApiResponse, AssetCtx, AssetInformationDetail, AssetMarketData, AssetPosition, AutoSyncFillsOptions, AutoSyncFillsState, BalanceSummaryDto, CancelOrderResponseDto, CancelTwapResponseDto, CandleChartData, CandleData, CandleInterval, CandleSnapshotRequest, ClearinghouseState, CloseExecutionType, ClosePositionRequestInput, ClosePositionResponseDto, CreatePositionRequestInput, CreatePositionResponseDto, CrossMarginSummaryDto, CumFundingDto, ExecutionType, HLWebSocketResponse, HistoricalRange, LadderConfigInput, MarginSummaryDto, NotificationCategory, NotificationDto, OpenLimitOrderDto, OpenPositionDto, OrderAssetDto, OrderStatus, PairAssetInput, PerformanceOverlay, PositionAdjustmentType, PositionAssetDetailDto, PositionAssetSummaryDto, PositionResponseStatus, RealtimeBar, RealtimeBarsCallback, TokenConflict, TokenHistoricalPriceData, TokenMetadata, TokenSelection, TpSlThresholdInput, TpSlThresholdType, TradeHistoryAssetDataDto, TradeHistoryDataDto, TwapChunkStatusDto, TwapMonitoringDto, UniverseAsset, UpdateRiskParametersRequestInput, UpdateRiskParametersResponseDto, UseAgentWalletOptions, UseAuthOptions, UseBasketCandlesReturn, UseHistoricalPriceDataReturn, UseNotificationsResult, UsePerformanceOverlaysReturn, UseTokenSelectionMetadataReturn, UserProfile, UserSelectionState, WebData2Response, WebSocketAckResponse, WebSocketChannel, WebSocketConnectionState, WebSocketDataMessage, WebSocketMessage, WebSocketSubscribeMessage, WsAllMidsData };

package/dist/index.js

@@ -2434,22 +2434,25 @@ const useUserData = create((set) => ({
     openOrders: null,
     accountSummary: null,
     twapDetails: null,
+    notifications: null,
     setTradeHistories: (value) => set({ tradeHistories: value }),
     setRawOpenPositions: (value) => set({ rawOpenPositions: value }),
     setOpenOrders: (value) => set({ openOrders: value }),
     setAccountSummary: (value) => set({ accountSummary: value }),
     setTwapDetails: (value) => set({ twapDetails: value }),
+    setNotifications: (value) => set({ notifications: value }),
     clean: () => set({
         tradeHistories: null,
         rawOpenPositions: null,
         openOrders: null,
         accountSummary: null,
         twapDetails: null,
+        notifications: null,
     }),
 }));
 
 const useHyperliquidWebSocket = ({ wsUrl, address }) => {
-    const { setTradeHistories, setRawOpenPositions, setOpenOrders, setAccountSummary, setTwapDetails, clean } = useUserData();
+    const { setTradeHistories, setRawOpenPositions, setOpenOrders, setAccountSummary, setTwapDetails, setNotifications, clean, } = useUserData();
     const [lastError, setLastError] = useState(null);
     const [lastSubscribedAddress, setLastSubscribedAddress] = useState(null);
     // WebSocket connection
@@ -2493,6 +2496,10 @@ const useHyperliquidWebSocket = ({ wsUrl, address }) => {
                         case 'twap-details':
                             setTwapDetails(dataMessage.data);
                             break;
+                        case 'notifications':
+                            setNotifications(dataMessage.data);
+                            break;
+                        // 'fills-checkpoint' is intentionally ignored here
                     }
                 }
             }
@@ -7561,8 +7568,8 @@ const fetchHistoricalCandles = async (coin, startTime, endTime, interval) => {
 /**
  * Retrieve recent user fills from HyperLiquid and map to ExternalFillDto[]
  */
-const fetchUserFillsFromHyperliquid = async (user, aggregateByTime = true) => {
-    const request = { type: 'userFills', user, aggregateByTime };
+const fetchUserFillsFromHyperliquid = async (user, startTime, aggregateByTime = true) => {
+    const request = { type: 'userFillsByTime', user, startTime, aggregateByTime };
     try {
         const response = await axios$1.post('https://api.hyperliquid.xyz/info', request, {
             headers: { 'Content-Type': 'application/json' },
@@ -8181,8 +8188,29 @@ const syncFills = async (baseUrl, accessToken, payload) => {
  * Convenience: fetch user fills from HyperLiquid, then sync them to Pear backend
  */
 const syncUserFillsFromHyperliquid = async (baseUrl, accessToken, user, aggregateByTime = true) => {
-    const { data: fills } = await fetchUserFillsFromHyperliquid(user, aggregateByTime);
-    return syncFills(baseUrl, accessToken, { user, fills });
+    const firstStartTime = 1735660800000; // 1 January 2025
+    const allFills = [];
+    const seenTids = new Set();
+    let startTime = firstStartTime;
+    let batchSize = 0;
+    do {
+        const { data: batch } = await fetchUserFillsFromHyperliquid(user, startTime, aggregateByTime);
+        batchSize = batch.length;
+        for (const fill of batch) {
+            const tid = fill.tid;
+            if (tid === undefined)
+                continue;
+            if (!seenTids.has(tid)) {
+                seenTids.add(tid);
+                allFills.push(fill);
+            }
+        }
+        if (batchSize === 2000) {
+            const last = batch[batch.length - 1];
+            startTime = last.time;
+        }
+    } while (batchSize === 2000);
+    return syncFills(baseUrl, accessToken, { user, fills: allFills });
 };
 
 /**
@@ -8335,10 +8363,11 @@ const calculatePositionAsset = (asset, currentPrice, totalInitialPositionSize, l
 };
 const buildPositionValue = (rawPositions, webData2, allMids) => {
     return rawPositions.map((position) => {
+        const webData2Position = webData2.clearinghouseState.assetPositions.find(ap => ap.position.coin === position.longAssets[0].coin || ap.position.coin === position.shortAssets[0].coin);
         let mappedPosition = {
             positionId: position.positionId,
             address: position.address,
-            leverage: position.leverage,
+            leverage: webData2Position === null || webData2Position === void 0 ? void 0 : webData2Position.position.leverage.value, // TODO: consider if user manually change leverage from the HL UI
             entryRatio: 1,
             marginUsed: 0,
             markRatio: 1,
@@ -8535,6 +8564,23 @@ function useTwap() {
     return { orders, cancelTwap: cancelTwap$1 };
 }
 
+/**
+ * Provides notifications and fills checkpoint data sourced from the SDK WebSocket.
+ * Data is persisted in the SDK's Zustand store.
+ */
+function useNotifications() {
+    const notifications = useUserData((state) => state.notifications);
+    const unreadCount = useMemo(() => {
+        if (!notifications)
+            return 0;
+        return notifications.reduce((acc, n) => acc + (n.is_read ? 0 : 1), 0);
+    }, [notifications]);
+    return {
+        notifications,
+        unreadCount,
+    };
+}
+
 const PearHyperliquidContext = createContext(undefined);
 /**
  * React Provider for PearHyperliquidClient
@@ -8653,7 +8699,7 @@ const PearHyperliquidProvider = ({ children, apiBaseUrl = 'https://hl-v2.pearpro
         address,
         intervalMs: 60000,
         aggregateByTime: true,
-        enabled: false, // Boolean(isAuthenticated && address && accessToken),
+        enabled: Boolean(isAuthenticated && address && accessToken),
     });
     const contextValue = useMemo(() => ({
         // Config
@@ -8833,4 +8879,4 @@ function mapCandleIntervalToTradingViewInterval(interval) {
     }
 }
 
-export { AccountSummaryCalculator, AuthStatus, ConflictDetector, PearHyperliquidProvider, TokenMetadataExtractor, adjustOrder, adjustPosition, calculateWeightedRatio, cancelOrder, cancelTwap, cancelTwapOrder, closePosition, computeBasketCandles, createCandleLookups, createPosition, getCompleteTimestamps, mapCandleIntervalToTradingViewInterval, mapTradingViewIntervalToCandleInterval, updateRiskParameters, useAccountSummary, useAddress, useAgentWallet, useAuth, useAutoSyncFills, useBasketCandles, useHistoricalPriceData, useHistoricalPriceDataStore, useHyperliquidNativeWebSocket, useHyperliquidWebSocket, useOpenOrders, useOrders, usePearAgentWallet, usePearAuth, usePearHyperliquid, usePerformanceOverlays, usePosition, useTokenSelectionMetadata, useTradeHistories, useTwap, useUserSelection, useWebData };
+export { AccountSummaryCalculator, AuthStatus, ConflictDetector, PearHyperliquidProvider, TokenMetadataExtractor, adjustOrder, adjustPosition, calculateWeightedRatio, cancelOrder, cancelTwap, cancelTwapOrder, closePosition, computeBasketCandles, createCandleLookups, createPosition, getCompleteTimestamps, mapCandleIntervalToTradingViewInterval, mapTradingViewIntervalToCandleInterval, updateRiskParameters, useAccountSummary, useAddress, useAgentWallet, useAuth, useAutoSyncFills, useBasketCandles, useHistoricalPriceData, useHistoricalPriceDataStore, useHyperliquidNativeWebSocket, useHyperliquidWebSocket, useNotifications, useOpenOrders, useOrders, usePearAgentWallet, usePearAuth, usePearHyperliquid, usePerformanceOverlays, usePosition, useTokenSelectionMetadata, useTradeHistories, useTwap, useUserSelection, useWebData };

package/dist/types.d.ts

@@ -51,7 +51,7 @@ export type WebSocketConnectionState = 'connecting' | 'connected' | 'disconnecte
 /**
  * WebSocket channels
  */
-export type WebSocketChannel = 'trade-histories' | 'open-positions' | 'open-orders' | 'account-summary' | 'twap-details' | 'webData2' | 'allMids' | 'activeAssetData';
+export type WebSocketChannel = 'trade-histories' | 'open-positions' | 'open-orders' | 'account-summary' | 'twap-details' | 'notifications' | 'webData2' | 'allMids' | 'activeAssetData';
 /**
  * WebSocket subscription message
  */
@@ -74,6 +74,16 @@ export interface WebSocketDataMessage<T = unknown> {
     channel: WebSocketChannel;
     data: T;
 }
+export type NotificationCategory = 'TRADE_OPENED_OUTSIDE_PEAR' | 'POSITION_LIQUIDATED' | 'LIMIT_ORDER_FILLED' | 'LIMIT_ORDER_FAILED' | 'TP_ORDER_FILLED' | 'TP_ORDER_FAILED' | 'SL_ORDER_FILLED' | 'SL_ORDER_FAILED';
+export interface NotificationDto {
+    id: string;
+    address: string;
+    category: NotificationCategory;
+    parameters: Record<string, any>;
+    is_read: boolean;
+    created_at: string;
+    updated_at: string;
+}
 export interface ChunkFillDto {
     fillId: string;
     assetName: string;
@@ -141,7 +151,6 @@ export interface TradeHistoryDataDto {
     totalValue: number;
     entryRatio: number;
     exitRatio: number;
-    leverage: number;
     longAssets: TradeHistoryAssetDataDto[];
     shortAssets: TradeHistoryAssetDataDto[];
     createdAt: string;
@@ -518,7 +527,6 @@ export interface RawAssetDto {
 export interface RawPositionDto {
     positionId: string;
     address: string;
-    leverage: number;
     stopLoss: number | null;
     takeProfit: number | null;
     status: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pear-protocol/hyperliquid-sdk",
-  "version": "0.0.31",
+  "version": "0.0.33",
   "description": "React SDK for Pear Protocol Hyperliquid API integration",
   "type": "module",
   "main": "dist/index.js",