@pear-protocol/hyperliquid-sdk 0.0.16 → 0.0.17

package/dist/client.d.ts

@@ -1,4 +1,4 @@
-import { PearHyperliquidConfig, ApiResponse, SyncTradeHistoryDto, SyncTradeHistoryResponseDto, SyncOpenPositionDto, SyncOpenPositionResponseDto, SyncOpenOrderDto, SyncOpenOrderResponseDto, CandleData } from './types';
+import { PearHyperliquidConfig, ApiResponse, SyncTradeHistoryDto, SyncTradeHistoryResponseDto, SyncOpenPositionDto, SyncOpenPositionResponseDto, SyncOpenOrderDto, SyncOpenOrderResponseDto, CandleData, CandleInterval } from './types';
 /**
  * Main SDK client for Pear Protocol Hyperliquid API integration
  */
@@ -48,5 +48,5 @@ export declare class PearHyperliquidClient {
      * @param interval - Candle interval
      * @returns Promise with historical candle data
      */
-    fetchHistoricalCandles(coin: string, startTime: number, endTime: number, interval: string): Promise<ApiResponse<CandleData[]>>;
+    fetchHistoricalCandles(coin: string, startTime: number, endTime: number, interval: CandleInterval): Promise<ApiResponse<CandleData[]>>;
 }

package/dist/hooks/useTrading.d.ts

@@ -1,5 +1,8 @@
+import type { AccountSummaryResponseDto, OpenLimitOrderDto } from '../types';
+import type { TradeHistoryDataDto } from '../types';
+import type { OpenPositionDto } from '../types';
 export declare const useTradeHistories: () => {
-    data: any;
+    data: TradeHistoryDataDto[] | null;
     isLoading: boolean;
 };
 /**
@@ -9,20 +12,20 @@ export declare const useOpenPositions: () => {
     data: null;
     isLoading: boolean;
 } | {
-    data: import("..").OpenPositionDto[];
+    data: OpenPositionDto[];
     isLoading: boolean;
 };
 /**
  * Hook to access open orders with loading state
  */
 export declare const useOpenOrders: () => {
-    data: any;
+    data: OpenLimitOrderDto[] | null;
     isLoading: boolean;
 };
 /**
  * Hook to access account summary with real-time calculations and loading state
  */
 export declare const useAccountSummary: () => {
-    data: import("..").AccountSummaryResponseDto | null;
+    data: AccountSummaryResponseDto | null;
     isLoading: boolean;
 };

package/dist/hooks/useUserSelection.d.ts

@@ -1,2 +1,2 @@
-export declare const useUserSelection: any;
+export { useUserSelection } from "../store/userSelection";
 export type { UserSelectionState } from "../store/userSelection";

package/dist/hooks/useWebData.d.ts

@@ -1,10 +1,10 @@
-import type { AssetMarketData } from '../types';
+import type { AssetMarketData, ClearinghouseState } from '../types';
 /**
  * Hook to access webData and native WebSocket state
  */
 export declare const useWebData: () => {
-    clearinghouseState: any;
-    perpsAtOpenInterestCap: any;
+    clearinghouseState: ClearinghouseState | undefined;
+    perpsAtOpenInterestCap: string[] | undefined;
     marketDataBySymbol: Record<string, AssetMarketData>;
     isConnected: boolean;
     connectionStatus: import("react-use-websocket").ReadyState;

package/dist/index.d.ts

@@ -224,6 +224,14 @@ interface WebSocketSubscribeMessage {
     action?: 'subscribe' | 'unsubscribe';
     address: string;
 }
+/**
+ * WebSocket response message
+ */
+interface WebSocketAckResponse {
+    success?: boolean;
+    message?: string;
+    error?: string;
+}
 /**
  * WebSocket data message
  */
@@ -406,20 +414,19 @@ interface WebSocketMessage {
         aggregateByTime?: boolean;
     };
 }
-/**
- * WebSocket response message
- */
-interface WebSocketResponse {
-    success?: boolean;
-    message?: string;
-    error?: string;
-}
 /**
  * WebSocket response from HyperLiquid native API
  */
-interface WebSocketResponse {
-    channel: string;
-    data: any;
+type HLChannel = 'webData2' | 'allMids' | 'activeAssetData' | 'candle';
+interface HLChannelDataMap {
+    webData2: WebData2Response;
+    allMids: WsAllMidsData;
+    activeAssetData: ActiveAssetData;
+    candle: CandleData;
+}
+interface HLWebSocketResponse<T extends HLChannel = HLChannel> {
+    channel: T;
+    data: HLChannelDataMap[T];
 }
 /**
  * All mids data structure
@@ -458,26 +465,27 @@ interface WebData2Response {
     meta: {
         universe: UniverseAsset[];
     };
-    clearinghouseState: {
-        assetPositions: AssetPosition[];
-        crossMaintenanceMarginUsed: string;
-        crossMarginSummary: {
-            accountValue: string;
-            totalMarginUsed: string;
-            totalNtlPos: string;
-            totalRawUsd: string;
-        };
-        marginSummary: {
-            accountValue: string;
-            totalMarginUsed: string;
-            totalNtlPos: string;
-            totalRawUsd: string;
-        };
-        time: number;
-        withdrawable: string;
-    };
+    clearinghouseState: ClearinghouseState;
     perpsAtOpenInterestCap?: string[];
 }
+interface ClearinghouseState {
+    assetPositions: AssetPosition[];
+    crossMaintenanceMarginUsed: string;
+    crossMarginSummary: {
+        accountValue: string;
+        totalMarginUsed: string;
+        totalNtlPos: string;
+        totalRawUsd: string;
+    };
+    marginSummary: {
+        accountValue: string;
+        totalMarginUsed: string;
+        totalNtlPos: string;
+        totalRawUsd: string;
+    };
+    time: number;
+    withdrawable: string;
+}
 /**
  * Asset position data
  */
@@ -520,6 +528,30 @@ interface AssetInformationDetail {
     priceChange: number;
     assetIndex: number;
 }
+/**
+ * Raw asset data from open-positions channel
+ */
+interface RawAssetDto {
+    coin: string;
+    entryPrice: number;
+    size: number;
+    side: string;
+}
+/**
+ * Raw position data from open-positions channel
+ */
+interface RawPositionDto {
+    positionId: string;
+    address: string;
+    leverage: number;
+    stopLoss: number | null;
+    takeProfit: number | null;
+    status: string;
+    createdAt: string;
+    updatedAt: string;
+    longAssets: RawAssetDto[];
+    shortAssets: RawAssetDto[];
+}
 /**
  * Leverage information from activeAssetData
  */
@@ -674,7 +706,7 @@ declare class PearHyperliquidClient {
      * @param interval - Candle interval
      * @returns Promise with historical candle data
      */
-    fetchHistoricalCandles(coin: string, startTime: number, endTime: number, interval: string): Promise<ApiResponse<CandleData[]>>;
+    fetchHistoricalCandles(coin: string, startTime: number, endTime: number, interval: CandleInterval): Promise<ApiResponse<CandleData[]>>;
 }
 
 /**
@@ -772,7 +804,7 @@ declare const useAddress: () => {
 };
 
 declare const useTradeHistories: () => {
-    data: any;
+    data: TradeHistoryDataDto[] | null;
     isLoading: boolean;
 };
 /**
@@ -789,7 +821,7 @@ declare const useOpenPositions: () => {
  * Hook to access open orders with loading state
  */
 declare const useOpenOrders: () => {
-    data: any;
+    data: OpenLimitOrderDto[] | null;
     isLoading: boolean;
 };
 /**
@@ -821,15 +853,14 @@ interface UserSelectionState {
     handleTokenSelect: (selectedToken: string) => void;
     resetToDefaults: () => void;
 }
-
 declare const useUserSelection: any;
 
 /**
  * Hook to access webData and native WebSocket state
  */
 declare const useWebData: () => {
-    clearinghouseState: any;
-    perpsAtOpenInterestCap: any;
+    clearinghouseState: ClearinghouseState | undefined;
+    perpsAtOpenInterestCap: string[] | undefined;
     marketDataBySymbol: Record<string, AssetMarketData>;
     isConnected: boolean;
     connectionStatus: react_use_websocket.ReadyState;
@@ -910,24 +941,7 @@ declare class AccountSummaryCalculator {
     /**
      * Get real-time clearinghouse state from webData2
      */
-    getClearinghouseState(): {
-        assetPositions: AssetPosition[];
-        crossMaintenanceMarginUsed: string;
-        crossMarginSummary: {
-            accountValue: string;
-            totalMarginUsed: string;
-            totalNtlPos: string;
-            totalRawUsd: string;
-        };
-        marginSummary: {
-            accountValue: string;
-            totalMarginUsed: string;
-            totalNtlPos: string;
-            totalRawUsd: string;
-        };
-        time: number;
-        withdrawable: string;
-    } | null;
+    getClearinghouseState(): ClearinghouseState | null;
     /**
      * Check if real-time data is available
      */
@@ -945,7 +959,7 @@ declare class ConflictDetector {
      * @param openPositions - Current open positions from API
      * @returns Array of detected conflicts
      */
-    static detectConflicts(longTokens: TokenSelection[], shortTokens: TokenSelection[], openPositions: any[] | null): TokenConflict[];
+    static detectConflicts(longTokens: TokenSelection[], shortTokens: TokenSelection[], openPositions: RawPositionDto[] | null): TokenConflict[];
 }
 
 /**
@@ -1017,4 +1031,4 @@ interface TokenHistoricalPriceData {
 declare const useHistoricalPriceDataStore: any;
 
 export { AccountSummaryCalculator, ConflictDetector, PearHyperliquidClient, PearHyperliquidProvider, PearMigrationSDK, TokenMetadataExtractor, calculateWeightedRatio, computeBasketCandles, createCandleLookups, PearHyperliquidClient as default, getCompleteTimestamps, useAccountSummary, useAddress, useBasketCandles, useHistoricalPriceData, useHistoricalPriceDataStore, useHyperliquidNativeWebSocket, useHyperliquidWebSocket, useMigrationSDK, useOpenOrders, useOpenPositions, usePearHyperliquidClient, useTokenSelectionMetadata, useTradeHistories, useUserSelection, useWebData };
-export type { AccountSummaryResponseDto, AgentWalletDto, ApiErrorResponse, ApiResponse, AssetCtx, AssetInformationDetail, AssetPosition, BalanceSummaryDto, CandleChartData, CandleData, CandleInterval, CandleSnapshotRequest, CrossMarginSummaryDto, CumFundingDto, HistoricalRange, MarginSummaryDto, MigrationHookState, MigrationHooks, OpenLimitOrderDto, OpenOrderV1Dto, OpenPositionDto, OpenPositionV1Dto, OrderAssetDto, OrderStatus, PearHyperliquidConfig, PnlDto, PositionAssetDetailDto, PositionSideDto, PositionSyncStatus, RawValueDto, SyncOpenOrderDto, SyncOpenOrderResponseDto, SyncOpenPositionDto, SyncOpenPositionResponseDto, SyncTradeHistoryDto, SyncTradeHistoryResponseDto, TokenConflict, TokenHistoricalPriceData, TokenMetadata, TokenSelection, TpSlDto, TradeHistoryAssetDataDto, TradeHistoryDataDto, TradeHistoryV1Dto, UniverseAsset, UseBasketCandlesReturn, UseHistoricalPriceDataReturn, UseTokenSelectionMetadataReturn, UserSelectionState, WebData2Response, WebSocketChannel, WebSocketConnectionState, WebSocketDataMessage, WebSocketMessage, WebSocketResponse, WebSocketSubscribeMessage, WeightedCandleData, WsAllMidsData };
+export type { AccountSummaryResponseDto, AgentWalletDto, ApiErrorResponse, ApiResponse, AssetCtx, AssetInformationDetail, AssetPosition, BalanceSummaryDto, CandleChartData, CandleData, CandleInterval, CandleSnapshotRequest, ClearinghouseState, CrossMarginSummaryDto, CumFundingDto, HLWebSocketResponse, HistoricalRange, MarginSummaryDto, MigrationHookState, MigrationHooks, OpenLimitOrderDto, OpenOrderV1Dto, OpenPositionDto, OpenPositionV1Dto, OrderAssetDto, OrderStatus, PearHyperliquidConfig, PnlDto, PositionAssetDetailDto, PositionSideDto, PositionSyncStatus, RawValueDto, SyncOpenOrderDto, SyncOpenOrderResponseDto, SyncOpenPositionDto, SyncOpenPositionResponseDto, SyncTradeHistoryDto, SyncTradeHistoryResponseDto, TokenConflict, TokenHistoricalPriceData, TokenMetadata, TokenSelection, TpSlDto, TradeHistoryAssetDataDto, TradeHistoryDataDto, TradeHistoryV1Dto, UniverseAsset, UseBasketCandlesReturn, UseHistoricalPriceDataReturn, UseTokenSelectionMetadataReturn, UserSelectionState, WebData2Response, WebSocketAckResponse, WebSocketChannel, WebSocketConnectionState, WebSocketDataMessage, WebSocketMessage, WebSocketSubscribeMessage, WeightedCandleData, WsAllMidsData };