@pear-protocol/hyperliquid-sdk 0.0.5 → 0.0.8

package/dist/hooks/index.d.ts

@@ -1,2 +1,4 @@
 export { useAddress } from './useAddress';
 export { useTradeHistories, useOpenPositions, useOpenOrders, useAccountSummary } from './useTrading';
+export { useCalculatedOpenPositions } from './useCalculatedPositions';
+export { useCalculatedAccountSummary } from './useCalculatedAccountSummary';

package/dist/hooks/useCalculatedAccountSummary.d.ts

@@ -0,0 +1,5 @@
+import type { AccountSummaryResponseDto, WebData2Response, OpenLimitOrderDto } from '../types';
+/**
+ * Hook that calculates account summary by syncing platform data with HyperLiquid real-time data
+ */
+export declare const useCalculatedAccountSummary: (platformAccountSummary: AccountSummaryResponseDto | null, platformOpenOrders: OpenLimitOrderDto[] | null, webData2: WebData2Response | null, agentWalletAddress?: string, agentWalletStatus?: string) => AccountSummaryResponseDto | null;

package/dist/hooks/useCalculatedPositions.d.ts

@@ -0,0 +1,5 @@
+import type { OpenPositionDto, WebData2Response, WsAllMidsData } from '../types';
+/**
+ * Hook that calculates open positions by syncing platform positions with HyperLiquid real-time data
+ */
+export declare const useCalculatedOpenPositions: (platformPositions: OpenPositionDto[] | null, webData2: WebData2Response | null, allMids: WsAllMidsData | null) => OpenPositionDto[] | null;

package/dist/hooks/useTrading.d.ts

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

package/dist/hyperliquid-websocket.d.ts

@@ -0,0 +1,13 @@
+import { ReadyState } from 'react-use-websocket';
+import type { WebData2Response, WsAllMidsData } from './types';
+export interface UseHyperliquidNativeWebSocketProps {
+    address: string | null;
+}
+export interface UseHyperliquidNativeWebSocketReturn {
+    webData2: WebData2Response | null;
+    allMids: WsAllMidsData | null;
+    connectionStatus: ReadyState;
+    isConnected: boolean;
+    lastError: string | null;
+}
+export declare const useHyperliquidNativeWebSocket: ({ address }: UseHyperliquidNativeWebSocketProps) => UseHyperliquidNativeWebSocketReturn;

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import * as hl from '@nktkas/hyperliquid';
 import React, { ReactNode } from 'react';
+import { ReadyState } from 'react-use-websocket';
 
 /**
  * Raw value data for trade history positions
@@ -215,7 +215,7 @@ type WebSocketConnectionState = 'connecting' | 'connected' | 'disconnected' | 'e
 /**
  * WebSocket channels
  */
-type WebSocketChannel = 'trade-histories' | 'open-positions' | 'open-orders' | 'account-summary';
+type WebSocketChannel = 'trade-histories' | 'open-positions' | 'open-orders' | 'account-summary' | 'webData2' | 'allMids';
 /**
  * WebSocket subscription message
  */
@@ -223,14 +223,6 @@ interface WebSocketSubscribeMessage {
     action?: 'subscribe' | 'unsubscribe';
     address: string;
 }
-/**
- * WebSocket response message
- */
-interface WebSocketResponse {
-    success?: boolean;
-    message?: string;
-    error?: string;
-}
 /**
  * WebSocket data message
  */
@@ -396,6 +388,132 @@ interface AccountSummaryResponseDto {
     balanceSummary: BalanceSummaryDto;
     agentWallet: AgentWalletDto;
 }
+/**
+ * WebSocket message from HyperLiquid native API
+ */
+interface WebSocketMessage {
+    method: "subscribe" | "unsubscribe";
+    subscription: {
+        type: string;
+        coin?: string;
+        interval?: string;
+        user?: string;
+        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;
+}
+/**
+ * All mids data structure
+ */
+interface WsAllMidsData {
+    mids: Record<string, string>;
+}
+/**
+ * Asset context data
+ */
+interface AssetCtx {
+    funding: string;
+    openInterest: string;
+    prevDayPx: string;
+    dayNtlVlm: string;
+    markPx: string;
+    midPx?: string;
+    impactPxs?: string[];
+    oraclePx: string;
+}
+/**
+ * Universe asset metadata
+ */
+interface UniverseAsset {
+    name: string;
+    szDecimals: number;
+    maxLeverage: number;
+    onlyIsolated: boolean;
+}
+/**
+ * WebData2 response structure
+ */
+interface WebData2Response {
+    assetCtxs: AssetCtx[];
+    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;
+    };
+    perpsAtOpenInterestCap?: string[];
+}
+/**
+ * Asset position data
+ */
+interface AssetPosition {
+    position: {
+        coin: string;
+        entryPx?: string;
+        leverage: {
+            type: string;
+            value: number;
+        };
+        liquidationPx?: string;
+        marginUsed: string;
+        maxLeverage: number;
+        positionValue: string;
+        returnOnEquity: string;
+        szi: string;
+        unrealizedPnl: string;
+    };
+    type: string;
+    cumFunding: {
+        allTime: string;
+        sinceChange: string;
+        sinceOpen: string;
+    };
+}
+/**
+ * Asset information detail
+ */
+interface AssetInformationDetail {
+    name: string;
+    funding: string;
+    openInterest: string;
+    prevDayPx: string;
+    dayNtlVlm: string;
+    oraclePx: string;
+    markPx: string;
+    midPx?: string;
+    dayBaseVlm: string;
+    priceChange: number;
+    assetIndex: number;
+}
 
 /**
  * Main SDK client for Pear Protocol Hyperliquid API integration
@@ -498,81 +616,6 @@ 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;
     /**
@@ -580,11 +623,6 @@ interface PearHyperliquidProviderProps {
      * @default 'wss://hl-v2.pearprotocol.io/ws'
      */
     wsUrl?: string;
-    /**
-     * Hyperliquid WebSocket URL
-     * @default 'wss://api.hyperliquid.xyz/ws'
-     */
-    hyperliquidWsUrl?: string;
     children: ReactNode;
 }
 /**
@@ -599,10 +637,6 @@ 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)
@@ -619,29 +653,179 @@ declare const useAddress: () => {
  */
 declare const useTradeHistories: () => PaginatedTradeHistoryResponseDto | null;
 /**
- * Hook to access open positions with enhanced real-time synchronization
+ * Hook to access open positions with real-time calculations
  */
-declare const useOpenPositions: () => {
-    positions: OpenPositionDto[];
-    isLoading: boolean;
-    lastSyncTime: Date | null;
-    rawWsPositions: OpenPositionDto[] | null;
-    resync: () => Promise<void>;
-};
+declare const useOpenPositions: () => OpenPositionDto[] | null;
 /**
  * Hook to access open orders
  */
 declare const useOpenOrders: () => OpenLimitOrderDto[] | null;
 /**
- * Hook to access account summary with enhanced real-time data from Hyperliquid
+ * Hook to access account summary with real-time calculations
  */
-declare const useAccountSummary: () => {
-    summary: AccountSummaryResponseDto | null;
-    isLoading: boolean;
-    lastSyncTime: Date | null;
-    rawWsSummary: AccountSummaryResponseDto | null;
-    resync: () => Promise<void>;
-};
+declare const useAccountSummary: () => AccountSummaryResponseDto | null;
+
+/**
+ * Hook that calculates open positions by syncing platform positions with HyperLiquid real-time data
+ */
+declare const useCalculatedOpenPositions: (platformPositions: OpenPositionDto[] | null, webData2: WebData2Response | null, allMids: WsAllMidsData | null) => OpenPositionDto[] | null;
+
+/**
+ * Hook that calculates account summary by syncing platform data with HyperLiquid real-time data
+ */
+declare const useCalculatedAccountSummary: (platformAccountSummary: AccountSummaryResponseDto | null, platformOpenOrders: OpenLimitOrderDto[] | null, webData2: WebData2Response | null, agentWalletAddress?: string, agentWalletStatus?: string) => AccountSummaryResponseDto | null;
+
+interface WebSocketData {
+    tradeHistories: PaginatedTradeHistoryResponseDto | null;
+    openPositions: OpenPositionDto[] | null;
+    openOrders: OpenLimitOrderDto[] | null;
+    accountSummary: AccountSummaryResponseDto | null;
+}
+interface UseHyperliquidWebSocketProps {
+    wsUrl: string;
+    address: string | null;
+}
+interface UseHyperliquidWebSocketReturn {
+    data: WebSocketData;
+    connectionStatus: ReadyState;
+    isConnected: boolean;
+    lastError: string | null;
+}
+declare const useHyperliquidWebSocket: ({ wsUrl, address }: UseHyperliquidWebSocketProps) => UseHyperliquidWebSocketReturn;
+
+interface UseHyperliquidNativeWebSocketProps {
+    address: string | null;
+}
+interface UseHyperliquidNativeWebSocketReturn {
+    webData2: WebData2Response | null;
+    allMids: WsAllMidsData | null;
+    connectionStatus: ReadyState;
+    isConnected: boolean;
+    lastError: string | null;
+}
+declare const useHyperliquidNativeWebSocket: ({ address }: UseHyperliquidNativeWebSocketProps) => UseHyperliquidNativeWebSocketReturn;
+
+/**
+ * Position side enum for calculations
+ */
+declare enum PositionSide {
+    LONG = "LONG",
+    SHORT = "SHORT"
+}
+/**
+ * Aggregate position calculation utility class that handles cross-position asset syncing
+ */
+declare class AggregatePositionCalculator {
+    private webData2;
+    private allMids;
+    constructor(webData2: WebData2Response | null, allMids: WsAllMidsData | null);
+    /**
+     * Get market price for a coin from allMids data
+     */
+    getMarketPrice(coin: string): number;
+    /**
+     * Get user positions from webData2
+     */
+    getUserPositions(): AssetPosition[];
+    /**
+     * Calculate updated open positions by syncing platform positions with HyperLiquid data
+     * Uses aggregate totals across all positions for accurate cross-position sync
+     */
+    calculateOpenPositions(platformPositions: OpenPositionDto[]): OpenPositionDto[];
+    /**
+     * Calculate total platform sizes per asset across all positions
+     */
+    private calculatePlatformTotalsByAsset;
+    /**
+     * Extract base currency from asset name (handles "LINK/USD" -> "LINK")
+     */
+    private extractBaseCurrency;
+    /**
+     * Sync a single position with HyperLiquid data using aggregate totals
+     */
+    private syncPositionWithAggregateData;
+    /**
+     * Sync individual asset with aggregate data awareness
+     */
+    private syncAssetWithAggregateData;
+    /**
+     * Determine sync status with sophisticated side-aware logic
+     */
+    private determineSyncStatus;
+    /**
+     * Build updated position with synced data
+     */
+    private buildUpdatedPosition;
+    /**
+     * Map sync result to PositionAssetDetailDto
+     */
+    private mapSyncResultToAssetDto;
+    /**
+     * Calculate entry ratio using actual sizes from sync results
+     */
+    private calculateEntryRatio;
+    /**
+     * Calculate mark ratio using actual sizes and current prices
+     */
+    private calculateMarkRatio;
+    /**
+     * Calculate net funding from sync results
+     */
+    private calculateNetFundingFromSyncResults;
+    /**
+     * Calculate total unrealized PnL from sync results
+     */
+    private calculateTotalUnrealizedPnlFromSyncResults;
+    /**
+     * Calculate current total position value using market prices
+     */
+    private calculateCurrentTotalPositionValue;
+    /**
+     * Calculate entry total position value using entry prices
+     */
+    private calculateEntryTotalPositionValue;
+}
+
+/**
+ * Account summary calculation utility class
+ */
+declare class AccountSummaryCalculator {
+    private webData2;
+    constructor(webData2: WebData2Response | null);
+    /**
+     * Calculate account summary from webData2 and platform orders
+     */
+    calculateAccountSummary(platformAccountSummary: AccountSummaryResponseDto | null, platformOpenOrders: OpenLimitOrderDto[] | null, agentWalletAddress?: string, agentWalletStatus?: string): AccountSummaryResponseDto | null;
+    /**
+     * Calculate total USD value of open limit orders
+     */
+    private calculateTotalLimitOrderValue;
+    /**
+     * 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;
+    /**
+     * Check if real-time data is available
+     */
+    hasRealTimeData(): boolean;
+}
 
-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 };
+export { AccountSummaryCalculator, AggregatePositionCalculator, PearHyperliquidClient, PearHyperliquidProvider, PearMigrationSDK, PositionSide, 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 };