@pear-protocol/hyperliquid-sdk 0.0.9 → 0.0.10

package/dist/hooks/useTrading.d.ts

@@ -1,16 +1,28 @@
 /**
- * Hook to access trade histories
+ * Hook to access trade histories with loading state
  */
-export declare const useTradeHistories: () => import("..").PaginatedTradeHistoryResponseDto | null;
+export declare const useTradeHistories: () => {
+    data: import("..").TradeHistoryDataDto[] | null;
+    isLoading: boolean;
+};
 /**
- * Hook to access open positions with real-time calculations
+ * Hook to access open positions with real-time calculations and loading state
  */
-export declare const useOpenPositions: () => import("..").OpenPositionDto[] | null;
+export declare const useOpenPositions: () => {
+    data: import("..").OpenPositionDto[] | null;
+    isLoading: boolean;
+};
 /**
- * Hook to access open orders
+ * Hook to access open orders with loading state
  */
-export declare const useOpenOrders: () => import("..").OpenLimitOrderDto[] | null;
+export declare const useOpenOrders: () => {
+    data: import("..").OpenLimitOrderDto[] | null;
+    isLoading: boolean;
+};
 /**
- * Hook to access account summary with real-time calculations
+ * Hook to access account summary with real-time calculations and loading state
  */
-export declare const useAccountSummary: () => import("..").AccountSummaryResponseDto | null;
+export declare const useAccountSummary: () => {
+    data: import("..").AccountSummaryResponseDto | null;
+    isLoading: boolean;
+};

package/dist/index.d.ts

@@ -260,15 +260,6 @@ interface TradeHistoryDataDto {
     shortAssets: TradeHistoryAssetDataDto[];
     createdAt: string;
 }
-/**
- * Paginated trade history response
- */
-interface PaginatedTradeHistoryResponseDto {
-    data: TradeHistoryDataDto[];
-    hasMore: boolean;
-    nextCursor?: string;
-    count: number;
-}
 /**
  * Cumulative funding information
  */
@@ -329,18 +320,31 @@ interface OrderAssetDto {
  * Order status
  */
 type OrderStatus = 'OPEN' | 'PARTIALLY_FILLED' | 'PROCESSING';
+/**
+ * Order type
+ */
+type OrderType = 'TP' | 'SL' | 'LIMIT' | 'MARKET';
+/**
+ * TP/SL trigger type
+ */
+type TpSlTriggerType = 'RATIO' | 'PERCENTAGE' | 'PNL';
 /**
  * Open limit order data structure
  */
 interface OpenLimitOrderDto {
     orderId: string;
     address: string;
+    clientId: string | null;
+    positionId: string;
     leverage: number;
     usdValue: number;
-    limitRatio: number;
-    stopLoss: number | null;
-    takeProfit: number | null;
+    triggerValue: number;
+    twapDuration: number | null;
+    tpSlTriggerType: TpSlTriggerType;
+    randomizeFlag: boolean;
+    reduceOnlyFlag: boolean;
     status: OrderStatus;
+    orderType: OrderType;
     longAssets: OrderAssetDto[];
     shortAssets: OrderAssetDto[];
     createdAt: string;
@@ -673,21 +677,33 @@ declare const useAddress: () => {
 };
 
 /**
- * Hook to access trade histories
+ * Hook to access trade histories with loading state
  */
-declare const useTradeHistories: () => PaginatedTradeHistoryResponseDto | null;
+declare const useTradeHistories: () => {
+    data: TradeHistoryDataDto[] | null;
+    isLoading: boolean;
+};
 /**
- * Hook to access open positions with real-time calculations
+ * Hook to access open positions with real-time calculations and loading state
  */
-declare const useOpenPositions: () => OpenPositionDto[] | null;
+declare const useOpenPositions: () => {
+    data: OpenPositionDto[] | null;
+    isLoading: boolean;
+};
 /**
- * Hook to access open orders
+ * Hook to access open orders with loading state
  */
-declare const useOpenOrders: () => OpenLimitOrderDto[] | null;
+declare const useOpenOrders: () => {
+    data: OpenLimitOrderDto[] | null;
+    isLoading: boolean;
+};
 /**
- * Hook to access account summary with real-time calculations
+ * Hook to access account summary with real-time calculations and loading state
  */
-declare const useAccountSummary: () => AccountSummaryResponseDto | null;
+declare const useAccountSummary: () => {
+    data: AccountSummaryResponseDto | null;
+    isLoading: boolean;
+};
 
 /**
  * Hook that calculates open positions by syncing platform positions with HyperLiquid real-time data
@@ -700,7 +716,7 @@ declare const useCalculatedOpenPositions: (platformPositions: RawPositionDto[] |
 declare const useCalculatedAccountSummary: (platformAccountSummary: AccountSummaryResponseDto | null, platformOpenOrders: OpenLimitOrderDto[] | null, webData2: WebData2Response | null, agentWalletAddress?: string, agentWalletStatus?: string) => AccountSummaryResponseDto | null;
 
 interface WebSocketData {
-    tradeHistories: PaginatedTradeHistoryResponseDto | null;
+    tradeHistories: TradeHistoryDataDto[] | null;
     openPositions: RawPositionDto[] | null;
     openOrders: OpenLimitOrderDto[] | null;
     accountSummary: AccountSummaryResponseDto | null;
@@ -771,4 +787,4 @@ declare class AccountSummaryCalculator {
 }
 
 export { AccountSummaryCalculator, PearHyperliquidClient, PearHyperliquidProvider, PearMigrationSDK, PearHyperliquidClient as default, useAccountSummary, useAddress, useCalculatedAccountSummary, useCalculatedOpenPositions, useHyperliquidNativeWebSocket, useHyperliquidWebSocket, useMigrationSDK, useOpenOrders, useOpenPositions, usePearHyperliquidClient, useTradeHistories };
-export type { AccountSummaryResponseDto, AgentWalletDto, ApiErrorResponse, ApiResponse, AssetCtx, AssetInformationDetail, AssetPosition, BalanceSummaryDto, CrossMarginSummaryDto, CumFundingDto, MarginSummaryDto, MigrationHookState, MigrationHooks, OpenLimitOrderDto, OpenOrderV1Dto, OpenPositionDto, OpenPositionV1Dto, OrderAssetDto, OrderStatus, PaginatedTradeHistoryResponseDto, PearHyperliquidConfig, PnlDto, PositionAssetDetailDto, PositionSideDto, PositionSyncStatus, RawValueDto, SyncOpenOrderDto, SyncOpenOrderResponseDto, SyncOpenPositionDto, SyncOpenPositionResponseDto, SyncTradeHistoryDto, SyncTradeHistoryResponseDto, TpSlDto, TradeHistoryAssetDataDto, TradeHistoryDataDto, TradeHistoryV1Dto, UniverseAsset, WebData2Response, WebSocketChannel, WebSocketConnectionState, WebSocketDataMessage, WebSocketMessage, WebSocketResponse, WebSocketSubscribeMessage, WsAllMidsData };
+export type { AccountSummaryResponseDto, AgentWalletDto, ApiErrorResponse, ApiResponse, AssetCtx, AssetInformationDetail, AssetPosition, BalanceSummaryDto, CrossMarginSummaryDto, CumFundingDto, MarginSummaryDto, MigrationHookState, MigrationHooks, OpenLimitOrderDto, OpenOrderV1Dto, OpenPositionDto, OpenPositionV1Dto, OrderAssetDto, OrderStatus, PearHyperliquidConfig, PnlDto, PositionAssetDetailDto, PositionSideDto, PositionSyncStatus, RawValueDto, SyncOpenOrderDto, SyncOpenOrderResponseDto, SyncOpenPositionDto, SyncOpenPositionResponseDto, SyncTradeHistoryDto, SyncTradeHistoryResponseDto, TpSlDto, TradeHistoryAssetDataDto, TradeHistoryDataDto, TradeHistoryV1Dto, UniverseAsset, WebData2Response, WebSocketChannel, WebSocketConnectionState, WebSocketDataMessage, WebSocketMessage, WebSocketResponse, WebSocketSubscribeMessage, WsAllMidsData };

package/dist/index.esm.js

@@ -2638,21 +2638,17 @@ const useHyperliquidWebSocket = ({ wsUrl, address }) => {
         accountSummary: null,
     });
     const [lastError, setLastError] = useState(null);
+    const [lastSubscribedAddress, setLastSubscribedAddress] = useState(null);
     // WebSocket connection
-    const { lastMessage, readyState, sendMessage } = useWebSocket(address ? wsUrl : null, // Only connect when address is set
-    {
+    const { readyState, sendMessage } = useWebSocket(wsUrl, {
         shouldReconnect: () => true,
         reconnectAttempts: 5,
         reconnectInterval: 3000,
-    });
-    const isConnected = readyState === dist.ReadyState.OPEN;
-    // Handle incoming WebSocket messages
-    useEffect(() => {
-        if (lastMessage !== null) {
+        onMessage: (event) => {
             try {
-                const message = JSON.parse(lastMessage.data);
-                // Handle subscription responses
-                if ('success' in message || 'error' in message) {
+                const message = JSON.parse(event.data);
+                // Handle subscription responses (only if they don't have channel data)
+                if (('success' in message || 'error' in message) && !('channel' in message)) {
                     if (message.error) {
                         setLastError(message.error);
                     }
@@ -2664,30 +2660,42 @@ const useHyperliquidWebSocket = ({ wsUrl, address }) => {
                 // Handle channel data messages
                 if ('channel' in message && 'data' in message) {
                     const dataMessage = message;
+                    // Validate data exists and is not null/undefined
+                    if (dataMessage.data === null || dataMessage.data === undefined) {
+                        return;
+                    }
                     switch (dataMessage.channel) {
                         case 'trade-histories':
-                            setData(prev => ({
-                                ...prev,
-                                tradeHistories: dataMessage.data
-                            }));
+                            if (Array.isArray(dataMessage.data)) {
+                                setData(prev => ({
+                                    ...prev,
+                                    tradeHistories: dataMessage.data
+                                }));
+                            }
                             break;
                         case 'open-positions':
-                            setData(prev => ({
-                                ...prev,
-                                openPositions: dataMessage.data
-                            }));
+                            if (Array.isArray(dataMessage.data)) {
+                                setData(prev => ({
+                                    ...prev,
+                                    openPositions: dataMessage.data
+                                }));
+                            }
                             break;
                         case 'open-orders':
-                            setData(prev => ({
-                                ...prev,
-                                openOrders: dataMessage.data
-                            }));
+                            if (Array.isArray(dataMessage.data)) {
+                                setData(prev => ({
+                                    ...prev,
+                                    openOrders: dataMessage.data
+                                }));
+                            }
                             break;
                         case 'account-summary':
-                            setData(prev => ({
-                                ...prev,
-                                accountSummary: dataMessage.data
-                            }));
+                            if (typeof dataMessage.data === 'object' && dataMessage.data !== null) {
+                                setData(prev => ({
+                                    ...prev,
+                                    accountSummary: dataMessage.data
+                                }));
+                            }
                             break;
                     }
                 }
@@ -2696,34 +2704,47 @@ const useHyperliquidWebSocket = ({ wsUrl, address }) => {
                 setLastError(`Failed to parse message: ${error instanceof Error ? error.message : String(error)}`);
             }
         }
-    }, [lastMessage]);
-    // Handle address changes - subscribe/unsubscribe
+    });
+    const isConnected = readyState === dist.ReadyState.OPEN;
+    // Handle subscription management
     useEffect(() => {
-        if (isConnected && address) {
+        if (isConnected && address && address !== lastSubscribedAddress) {
+            // Unsubscribe from previous address if exists
+            if (lastSubscribedAddress) {
+                sendMessage(JSON.stringify({
+                    action: 'unsubscribe',
+                    address: lastSubscribedAddress
+                }));
+            }
             // Subscribe to new address
             sendMessage(JSON.stringify({
                 action: 'subscribe',
                 address: address
             }));
-            // Clear previous data
-            setData({
-                tradeHistories: null,
-                openPositions: null,
-                openOrders: null,
-                accountSummary: null,
-            });
+            setLastSubscribedAddress(address);
             setLastError(null);
         }
-        else if (isConnected && !address) {
-            // Clear data when address is removed
+        else if (isConnected && !address && lastSubscribedAddress) {
+            // Send unsubscribe action when address is removed
+            sendMessage(JSON.stringify({
+                action: 'unsubscribe',
+                address: lastSubscribedAddress
+            }));
+            setLastSubscribedAddress(null);
+        }
+    }, [isConnected, address, lastSubscribedAddress, sendMessage]);
+    // Clear data when address changes
+    useEffect(() => {
+        if (address !== lastSubscribedAddress) {
             setData({
                 tradeHistories: null,
                 openPositions: null,
                 openOrders: null,
                 accountSummary: null,
             });
+            setLastError(null);
         }
-    }, [isConnected, address, sendMessage]);
+    }, [address, lastSubscribedAddress]);
     return {
         data,
         connectionStatus: readyState,
@@ -2739,7 +2760,7 @@ const useHyperliquidNativeWebSocket = ({ address }) => {
     const [subscribedAddress, setSubscribedAddress] = useState(null);
     const pingIntervalRef = useRef(null);
     // WebSocket connection to HyperLiquid native API
-    const { lastMessage, readyState, sendJsonMessage } = useWebSocket('wss://api.hyperliquid.xyz/ws', {
+    const { readyState, sendJsonMessage } = useWebSocket('wss://api.hyperliquid.xyz/ws', {
         shouldReconnect: () => true,
         reconnectAttempts: 5,
         reconnectInterval: 3000,
@@ -2747,6 +2768,41 @@ const useHyperliquidNativeWebSocket = ({ address }) => {
         onClose: () => { },
         onError: (event) => console.error('[HyperLiquid WS] Connection error:', event),
         onReconnectStop: () => console.error('[HyperLiquid WS] Reconnection stopped after 5 attempts'),
+        onMessage: (event) => {
+            try {
+                const message = JSON.parse(event.data);
+                // Handle subscription responses
+                if ('success' in message || 'error' in message) {
+                    if (message.error) {
+                        console.error('[HyperLiquid WS] Subscription error:', message.error);
+                        setLastError(message.error);
+                    }
+                    else {
+                        setLastError(null);
+                    }
+                    return;
+                }
+                // Handle channel data messages
+                if ('channel' in message && 'data' in message) {
+                    const response = message;
+                    switch (response.channel) {
+                        case 'webData2':
+                            setWebData2(response.data);
+                            break;
+                        case 'allMids':
+                            setAllMids(response.data);
+                            break;
+                        default:
+                            console.warn(`[HyperLiquid WS] Unknown channel: ${response.channel}`);
+                    }
+                }
+            }
+            catch (error) {
+                const errorMessage = `Failed to parse message: ${error instanceof Error ? error.message : String(error)}`;
+                console.error('[HyperLiquid WS] Parse error:', errorMessage, 'Raw message:', event.data);
+                setLastError(errorMessage);
+            }
+        }
     });
     const isConnected = readyState === dist.ReadyState.OPEN;
     // Setup ping mechanism
@@ -2812,44 +2868,6 @@ const useHyperliquidNativeWebSocket = ({ address }) => {
             setWebData2(null);
         }
     }, [isConnected, address, subscribedAddress, sendJsonMessage]);
-    // Handle incoming WebSocket messages
-    useEffect(() => {
-        if (!lastMessage)
-            return;
-        try {
-            const message = JSON.parse(lastMessage.data);
-            // Handle subscription responses
-            if ('success' in message || 'error' in message) {
-                if (message.error) {
-                    console.error('[HyperLiquid WS] Subscription error:', message.error);
-                    setLastError(message.error);
-                }
-                else {
-                    setLastError(null);
-                }
-                return;
-            }
-            // Handle channel data messages
-            if ('channel' in message && 'data' in message) {
-                const response = message;
-                switch (response.channel) {
-                    case 'webData2':
-                        setWebData2(response.data);
-                        break;
-                    case 'allMids':
-                        setAllMids(response.data);
-                        break;
-                    default:
-                        console.warn(`[HyperLiquid WS] Unknown channel: ${response.channel}`);
-                }
-            }
-        }
-        catch (error) {
-            const errorMessage = `Failed to parse message: ${error instanceof Error ? error.message : String(error)}`;
-            console.error('[HyperLiquid WS] Parse error:', errorMessage, 'Raw message:', lastMessage.data);
-            setLastError(errorMessage);
-        }
-    }, [lastMessage]);
     return {
         webData2,
         allMids,
@@ -3180,32 +3198,24 @@ class PositionProcessor {
         };
     }
     calculateEntryRatio(syncResults) {
+        var _a, _b;
         const longResults = syncResults.filter(result => result.asset.side === PositionSide.LONG);
         const shortResults = syncResults.filter(result => result.asset.side === PositionSide.SHORT);
         if (longResults.length === 0 || shortResults.length === 0)
             return 0;
-        const longValue = longResults.reduce((sum, result) => {
-            return sum + (Number(result.asset.size || 0) * Number(result.asset.entryPrice || 0));
-        }, 0);
-        const shortValue = shortResults.reduce((sum, result) => {
-            return sum + (Number(result.asset.size || 0) * Number(result.asset.entryPrice || 0));
-        }, 0);
-        return shortValue > 0 ? longValue / shortValue : 0;
+        const longEntryPrice = ((_a = longResults[0]) === null || _a === void 0 ? void 0 : _a.asset.entryPrice) ? Number(longResults[0].asset.entryPrice) : 0;
+        const shortEntryPrice = ((_b = shortResults[0]) === null || _b === void 0 ? void 0 : _b.asset.entryPrice) ? Number(shortResults[0].asset.entryPrice) : 0;
+        return shortEntryPrice > 0 ? longEntryPrice / shortEntryPrice : 0;
     }
     calculateMarkRatio(syncResults) {
+        var _a, _b;
         const longResults = syncResults.filter(result => result.asset.side === PositionSide.LONG);
         const shortResults = syncResults.filter(result => result.asset.side === PositionSide.SHORT);
         if (longResults.length === 0 || shortResults.length === 0)
             return 0;
-        const longValue = longResults.reduce((sum, result) => {
-            const currentPrice = this.getMarketPrice(result.asset.coin);
-            return sum + (result.actualSize * currentPrice);
-        }, 0);
-        const shortValue = shortResults.reduce((sum, result) => {
-            const currentPrice = this.getMarketPrice(result.asset.coin);
-            return sum + (result.actualSize * currentPrice);
-        }, 0);
-        return shortValue > 0 ? longValue / shortValue : 0;
+        const longMarkPrice = ((_a = longResults[0]) === null || _a === void 0 ? void 0 : _a.asset.coin) ? this.getMarketPrice(longResults[0].asset.coin) : 0;
+        const shortMarkPrice = ((_b = shortResults[0]) === null || _b === void 0 ? void 0 : _b.asset.coin) ? this.getMarketPrice(shortResults[0].asset.coin) : 0;
+        return shortMarkPrice > 0 ? longMarkPrice / shortMarkPrice : 0;
     }
     calculateNetFundingFromSyncResults(syncResults) {
         const netFunding = syncResults.reduce((sum, result) => {
@@ -3348,17 +3358,24 @@ const useCalculatedAccountSummary = (platformAccountSummary, platformOpenOrders,
 };
 
 /**
- * Hook to access trade histories
+ * Hook to access trade histories with loading state
  */
 const useTradeHistories = () => {
     const context = useContext(PearHyperliquidContext);
     if (!context) {
         throw new Error('useTradeHistories must be used within a PearHyperliquidProvider');
     }
-    return context.data.tradeHistories;
+    const isLoading = useMemo(() => {
+        // Loading is true initially and becomes false once we get the first data
+        return context.data.tradeHistories === null && context.isConnected;
+    }, [context.data.tradeHistories, context.isConnected]);
+    return {
+        data: context.data.tradeHistories,
+        isLoading
+    };
 };
 /**
- * Hook to access open positions with real-time calculations
+ * Hook to access open positions with real-time calculations and loading state
  */
 const useOpenPositions = () => {
     const context = useContext(PearHyperliquidContext);
@@ -3367,20 +3384,38 @@ const useOpenPositions = () => {
     }
     // Use calculated positions that sync platform data with HyperLiquid real-time data
     const calculatedPositions = useCalculatedOpenPositions(context.data.openPositions, context.webData2, context.allMids);
-    return calculatedPositions;
+    const isLoading = useMemo(() => {
+        // Loading is true initially and becomes false only when:
+        // 1. WebSocket has open-positions data
+        // 2. webData2 and allMids are ready (required for calculations)
+        // 3. Connection is established
+        return (context.isConnected &&
+            (context.data.openPositions === null || !context.webData2 || !context.allMids));
+    }, [context.data.openPositions, context.webData2, context.allMids, context.isConnected]);
+    return {
+        data: calculatedPositions,
+        isLoading
+    };
 };
 /**
- * Hook to access open orders
+ * Hook to access open orders with loading state
  */
 const useOpenOrders = () => {
     const context = useContext(PearHyperliquidContext);
     if (!context) {
         throw new Error('useOpenOrders must be used within a PearHyperliquidProvider');
     }
-    return context.data.openOrders;
+    const isLoading = useMemo(() => {
+        // Loading is true initially and becomes false once we get the first data
+        return context.data.openOrders === null && context.isConnected;
+    }, [context.data.openOrders, context.isConnected]);
+    return {
+        data: context.data.openOrders,
+        isLoading
+    };
 };
 /**
- * Hook to access account summary with real-time calculations
+ * Hook to access account summary with real-time calculations and loading state
  */
 const useAccountSummary = () => {
     var _a, _b, _c, _d;
@@ -3390,7 +3425,14 @@ const useAccountSummary = () => {
     }
     // Use calculated account summary that syncs platform data with HyperLiquid real-time data
     const calculatedAccountSummary = useCalculatedAccountSummary(context.data.accountSummary, context.data.openOrders, context.webData2, (_b = (_a = context.data.accountSummary) === null || _a === void 0 ? void 0 : _a.agentWallet) === null || _b === void 0 ? void 0 : _b.address, (_d = (_c = context.data.accountSummary) === null || _c === void 0 ? void 0 : _c.agentWallet) === null || _d === void 0 ? void 0 : _d.status);
-    return calculatedAccountSummary;
+    const isLoading = useMemo(() => {
+        // Loading is true initially and becomes false once we get the first data
+        return context.data.accountSummary === null && context.isConnected;
+    }, [context.data.accountSummary, context.isConnected]);
+    return {
+        data: calculatedAccountSummary,
+        isLoading
+    };
 };
 
 export { AccountSummaryCalculator, PearHyperliquidClient, PearHyperliquidProvider, PearMigrationSDK, PearHyperliquidClient as default, useAccountSummary, useAddress, useCalculatedAccountSummary, useCalculatedOpenPositions, useHyperliquidNativeWebSocket, useHyperliquidWebSocket, useMigrationSDK, useOpenOrders, useOpenPositions, usePearHyperliquidClient, useTradeHistories };