@pear-protocol/hyperliquid-sdk 0.0.4 → 0.0.5

package/dist/hooks/useTrading.d.ts

@@ -1,16 +1,29 @@
+import { OpenPositionDto, AccountSummaryResponseDto } from '../types';
 /**
  * Hook to access trade histories
  */
-export declare const useTradeHistories: () => import("..").PaginatedTradeHistoryResponseDto | null;
+export declare const useTradeHistories: () => import("../types").PaginatedTradeHistoryResponseDto | null;
 /**
- * Hook to access open positions
+ * Hook to access open positions with enhanced real-time synchronization
  */
-export declare const useOpenPositions: () => import("..").OpenPositionDto[] | null;
+export declare const useOpenPositions: () => {
+    positions: OpenPositionDto[];
+    isLoading: boolean;
+    lastSyncTime: Date | null;
+    rawWsPositions: OpenPositionDto[] | null;
+    resync: () => Promise<void>;
+};
 /**
  * Hook to access open orders
  */
-export declare const useOpenOrders: () => import("..").OpenLimitOrderDto[] | null;
+export declare const useOpenOrders: () => import("../types").OpenLimitOrderDto[] | null;
 /**
- * Hook to access account summary
+ * Hook to access account summary with enhanced real-time data from Hyperliquid
  */
-export declare const useAccountSummary: () => import("..").AccountSummaryResponseDto | null;
+export declare const useAccountSummary: () => {
+    summary: AccountSummaryResponseDto | null;
+    isLoading: boolean;
+    lastSyncTime: Date | null;
+    rawWsSummary: AccountSummaryResponseDto | null;
+    resync: () => Promise<void>;
+};

package/dist/hyperliquid-service.d.ts

@@ -0,0 +1,75 @@
+import * as hl from '@nktkas/hyperliquid';
+export interface AllAssetInformation {
+    universe: hl.PerpsUniverse;
+    assetsCtx: hl.PerpsAssetCtx;
+}
+/**
+ * Hyperliquid service client for direct API communication
+ */
+export declare class HyperliquidService {
+    private infoClient;
+    private subsClient?;
+    private wsTransport?;
+    private allMidsData;
+    private webData2;
+    private assetBySymbol;
+    private allAssetsCache;
+    constructor(wsUrl?: string, isTestnet?: boolean);
+    private initializeWebSocket;
+    /**
+     * Refresh asset cache when webData2 updates
+     */
+    private refreshAssetCache;
+    /**
+     * Get asset information by symbol - O(1) lookup
+     */
+    getAssetInfo(symbol: string): hl.PerpsUniverse | null;
+    /**
+     * Get asset context by symbol - O(1) lookup
+     */
+    getAssetCtx(symbol: string): hl.PerpsAssetCtx | null;
+    /**
+     * Get asset index by symbol - O(1) lookup
+     */
+    getAssetIndex(symbol: string): number | null;
+    /**
+     * Get all assets with caching
+     */
+    getAllAssets(): AllAssetInformation[];
+    /**
+     * Get current market price for an asset
+     */
+    getMarketPrice(symbol: string): number;
+    /**
+     * Get optimal decimal places for an asset
+     */
+    getOptimalDecimal(symbol: string): number;
+    /**
+     * Get user's open positions from Hyperliquid
+     */
+    getUserPositions(address: string): Promise<hl.AssetPosition[]>;
+    /**
+     * Get user's account summary from Hyperliquid
+     */
+    getAccountSummary(address: string): Promise<hl.PerpsClearinghouseState | null>;
+    /**
+     * Get user's open orders from Hyperliquid
+     */
+    getUserOrders(address: string): Promise<any[]>;
+    /**
+     * Update the user address for webData2 subscription
+     */
+    updateUserAddress(address: string | null): void;
+    /**
+     * Get the info client instance
+     */
+    getInfoClient(): hl.InfoClient;
+    /**
+     * Check if WebSocket is connected
+     */
+    isWebSocketConnected(): boolean;
+    /**
+     * Clean up resources
+     */
+    cleanup(): Promise<void>;
+}

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+import * as hl from '@nktkas/hyperliquid';
 import React, { ReactNode } from 'react';
 
 /**
@@ -497,6 +498,81 @@ declare class PearMigrationSDK {
     getBaseUrl(): string;
 }
 
+interface AllAssetInformation {
+    universe: hl.PerpsUniverse;
+    assetsCtx: hl.PerpsAssetCtx;
+}
+/**
+ * Hyperliquid service client for direct API communication
+ */
+declare class HyperliquidService {
+    private infoClient;
+    private subsClient?;
+    private wsTransport?;
+    private allMidsData;
+    private webData2;
+    private assetBySymbol;
+    private allAssetsCache;
+    constructor(wsUrl?: string, isTestnet?: boolean);
+    private initializeWebSocket;
+    /**
+     * Refresh asset cache when webData2 updates
+     */
+    private refreshAssetCache;
+    /**
+     * Get asset information by symbol - O(1) lookup
+     */
+    getAssetInfo(symbol: string): hl.PerpsUniverse | null;
+    /**
+     * Get asset context by symbol - O(1) lookup
+     */
+    getAssetCtx(symbol: string): hl.PerpsAssetCtx | null;
+    /**
+     * Get asset index by symbol - O(1) lookup
+     */
+    getAssetIndex(symbol: string): number | null;
+    /**
+     * Get all assets with caching
+     */
+    getAllAssets(): AllAssetInformation[];
+    /**
+     * Get current market price for an asset
+     */
+    getMarketPrice(symbol: string): number;
+    /**
+     * Get optimal decimal places for an asset
+     */
+    getOptimalDecimal(symbol: string): number;
+    /**
+     * Get user's open positions from Hyperliquid
+     */
+    getUserPositions(address: string): Promise<hl.AssetPosition[]>;
+    /**
+     * Get user's account summary from Hyperliquid
+     */
+    getAccountSummary(address: string): Promise<hl.PerpsClearinghouseState | null>;
+    /**
+     * Get user's open orders from Hyperliquid
+     */
+    getUserOrders(address: string): Promise<any[]>;
+    /**
+     * Update the user address for webData2 subscription
+     */
+    updateUserAddress(address: string | null): void;
+    /**
+     * Get the info client instance
+     */
+    getInfoClient(): hl.InfoClient;
+    /**
+     * Check if WebSocket is connected
+     */
+    isWebSocketConnected(): boolean;
+    /**
+     * Clean up resources
+     */
+    cleanup(): Promise<void>;
+}
+
 interface PearHyperliquidProviderProps {
     config: PearHyperliquidConfig;
     /**
@@ -504,6 +580,11 @@ interface PearHyperliquidProviderProps {
      * @default 'wss://hl-v2.pearprotocol.io/ws'
      */
     wsUrl?: string;
+    /**
+     * Hyperliquid WebSocket URL
+     * @default 'wss://api.hyperliquid.xyz/ws'
+     */
+    hyperliquidWsUrl?: string;
     children: ReactNode;
 }
 /**
@@ -518,6 +599,10 @@ declare const usePearHyperliquidClient: () => PearHyperliquidClient;
  * Hook to use migration SDK from context
  */
 declare const useMigrationSDK: () => PearMigrationSDK;
+/**
+ * Hook to use Hyperliquid service from context
+ */
+declare const useHyperliquidService: () => HyperliquidService;
 
 /**
  * Hook to manage address (login/logout functionality)
@@ -534,17 +619,29 @@ declare const useAddress: () => {
  */
 declare const useTradeHistories: () => PaginatedTradeHistoryResponseDto | null;
 /**
- * Hook to access open positions
+ * Hook to access open positions with enhanced real-time synchronization
  */
-declare const useOpenPositions: () => OpenPositionDto[] | null;
+declare const useOpenPositions: () => {
+    positions: OpenPositionDto[];
+    isLoading: boolean;
+    lastSyncTime: Date | null;
+    rawWsPositions: OpenPositionDto[] | null;
+    resync: () => Promise<void>;
+};
 /**
  * Hook to access open orders
  */
 declare const useOpenOrders: () => OpenLimitOrderDto[] | null;
 /**
- * Hook to access account summary
+ * Hook to access account summary with enhanced real-time data from Hyperliquid
  */
-declare const useAccountSummary: () => AccountSummaryResponseDto | null;
+declare const useAccountSummary: () => {
+    summary: AccountSummaryResponseDto | null;
+    isLoading: boolean;
+    lastSyncTime: Date | null;
+    rawWsSummary: AccountSummaryResponseDto | null;
+    resync: () => Promise<void>;
+};
 
-export { PearHyperliquidClient, PearHyperliquidProvider, PearMigrationSDK, PearHyperliquidClient as default, useAccountSummary, useAddress, useMigrationSDK, useOpenOrders, useOpenPositions, usePearHyperliquidClient, useTradeHistories };
+export { HyperliquidService, PearHyperliquidClient, PearHyperliquidProvider, PearMigrationSDK, PearHyperliquidClient as default, useAccountSummary, useAddress, useHyperliquidService, useMigrationSDK, useOpenOrders, useOpenPositions, usePearHyperliquidClient, useTradeHistories };
 export type { AccountSummaryResponseDto, AgentWalletDto, ApiErrorResponse, ApiResponse, 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, WebSocketChannel, WebSocketConnectionState, WebSocketDataMessage, WebSocketResponse, WebSocketSubscribeMessage };