@pear-protocol/hyperliquid-sdk 0.0.4 → 0.0.7

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

@@ -3,7 +3,7 @@
  */
 export declare const useTradeHistories: () => import("..").PaginatedTradeHistoryResponseDto | null;
 /**
- * Hook to access open positions
+ * Hook to access open positions with real-time calculations
  */
 export declare const useOpenPositions: () => import("..").OpenPositionDto[] | null;
 /**
@@ -11,6 +11,6 @@ export declare const useOpenPositions: () => import("..").OpenPositionDto[] | nu
  */
 export declare const useOpenOrders: () => import("..").OpenLimitOrderDto[] | null;
 /**
- * Hook to access account summary
+ * Hook to access account summary with real-time calculations
  */
 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,4 +1,5 @@
 import React, { ReactNode } from 'react';
+import { ReadyState } from 'react-use-websocket';
 
 /**
  * Raw value data for trade history positions
@@ -214,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
  */
@@ -222,14 +223,6 @@ interface WebSocketSubscribeMessage {
     action?: 'subscribe' | 'unsubscribe';
     address: string;
 }
-/**
- * WebSocket response message
- */
-interface WebSocketResponse {
-    success?: boolean;
-    message?: string;
-    error?: string;
-}
 /**
  * WebSocket data message
  */
@@ -395,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
@@ -534,7 +653,7 @@ declare const useAddress: () => {
  */
 declare const useTradeHistories: () => PaginatedTradeHistoryResponseDto | null;
 /**
- * Hook to access open positions
+ * Hook to access open positions with real-time calculations
  */
 declare const useOpenPositions: () => OpenPositionDto[] | null;
 /**
@@ -542,9 +661,166 @@ declare const useOpenPositions: () => OpenPositionDto[] | null;
  */
 declare const useOpenOrders: () => OpenLimitOrderDto[] | null;
 /**
- * Hook to access account summary
+ * Hook to access account summary with real-time calculations
  */
 declare const useAccountSummary: () => AccountSummaryResponseDto | null;
 
-export { PearHyperliquidClient, PearHyperliquidProvider, PearMigrationSDK, PearHyperliquidClient as default, useAccountSummary, useAddress, 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 };
+/**
+ * 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"
+}
+/**
+ * Position calculation utility class
+ */
+declare class PositionCalculator {
+    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
+     */
+    calculateOpenPositions(platformPositions: OpenPositionDto[]): OpenPositionDto[];
+    /**
+     * Sync a single position with HyperLiquid data
+     */
+    private syncPositionWithHyperliquid;
+    /**
+     * Group assets by their base currency
+     */
+    private groupAssetsByBaseCurrency;
+    /**
+     * Sync a group of assets (same base currency) with HyperLiquid position data
+     */
+    private syncAssetGroupWithHyperliquid;
+    /**
+     * Determine sync status based on asset sync results
+     */
+    private determineSyncStatus;
+    /**
+     * Build updated position with synced data
+     */
+    private buildUpdatedPosition;
+    /**
+     * Map sync result to PositionAssetDetailDto
+     */
+    private mapSyncResultToAssetDto;
+    /**
+     * Calculate entry ratio (weighted long entry value / weighted short entry value)
+     */
+    private calculateEntryRatio;
+    /**
+     * Calculate mark ratio (weighted long mark value / weighted short mark value)
+     */
+    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 { AccountSummaryCalculator, PearHyperliquidClient, PearHyperliquidProvider, PearMigrationSDK, PositionCalculator, 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 };