@pear-protocol/hyperliquid-sdk 0.0.4 → 0.0.7

package/dist/provider.d.ts

@@ -3,7 +3,7 @@ import { ReadyState } from 'react-use-websocket';
 import { PearHyperliquidClient } from './client';
 import { PearHyperliquidConfig } from './types';
 import { PearMigrationSDK } from './migration-sdk';
-import type { PaginatedTradeHistoryResponseDto, OpenPositionDto, OpenLimitOrderDto, AccountSummaryResponseDto } from './types';
+import type { PaginatedTradeHistoryResponseDto, OpenPositionDto, OpenLimitOrderDto, AccountSummaryResponseDto, WebData2Response, WsAllMidsData } from './types';
 interface WebSocketData {
     tradeHistories: PaginatedTradeHistoryResponseDto | null;
     openPositions: OpenPositionDto[] | null;
@@ -19,6 +19,11 @@ export interface PearHyperliquidContextType {
     isConnected: boolean;
     data: WebSocketData;
     lastError: string | null;
+    nativeConnectionStatus: ReadyState;
+    nativeIsConnected: boolean;
+    nativeLastError: string | null;
+    webData2: WebData2Response | null;
+    allMids: WsAllMidsData | null;
 }
 export declare const PearHyperliquidContext: React.Context<PearHyperliquidContextType | undefined>;
 interface PearHyperliquidProviderProps {

package/dist/types.d.ts

@@ -212,7 +212,7 @@ export type WebSocketConnectionState = 'connecting' | 'connected' | 'disconnecte
 /**
  * WebSocket channels
  */
-export type WebSocketChannel = 'trade-histories' | 'open-positions' | 'open-orders' | 'account-summary';
+export type WebSocketChannel = 'trade-histories' | 'open-positions' | 'open-orders' | 'account-summary' | 'webData2' | 'allMids';
 /**
  * WebSocket subscription message
  */
@@ -402,3 +402,121 @@ export interface AddressState {
     autoConnect: boolean;
     previousAddresses: string[];
 }
+/**
+ * WebSocket message from HyperLiquid native API
+ */
+export interface WebSocketMessage {
+    method: "subscribe" | "unsubscribe";
+    subscription: {
+        type: string;
+        coin?: string;
+        interval?: string;
+        user?: string;
+        aggregateByTime?: boolean;
+    };
+}
+/**
+ * WebSocket response from HyperLiquid native API
+ */
+export interface WebSocketResponse {
+    channel: string;
+    data: any;
+}
+/**
+ * All mids data structure
+ */
+export interface WsAllMidsData {
+    mids: Record<string, string>;
+}
+/**
+ * Asset context data
+ */
+export interface AssetCtx {
+    funding: string;
+    openInterest: string;
+    prevDayPx: string;
+    dayNtlVlm: string;
+    markPx: string;
+    midPx?: string;
+    impactPxs?: string[];
+    oraclePx: string;
+}
+/**
+ * Universe asset metadata
+ */
+export interface UniverseAsset {
+    name: string;
+    szDecimals: number;
+    maxLeverage: number;
+    onlyIsolated: boolean;
+}
+/**
+ * WebData2 response structure
+ */
+export 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
+ */
+export 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
+ */
+export interface AssetInformationDetail {
+    name: string;
+    funding: string;
+    openInterest: string;
+    prevDayPx: string;
+    dayNtlVlm: string;
+    oraclePx: string;
+    markPx: string;
+    midPx?: string;
+    dayBaseVlm: string;
+    priceChange: number;
+    assetIndex: number;
+}

package/dist/utils/account-summary-calculator.d.ts

@@ -0,0 +1,41 @@
+import type { AccountSummaryResponseDto, WebData2Response, OpenLimitOrderDto } from '../types';
+/**
+ * Account summary calculation utility class
+ */
+export 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: import("../types").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;
+}

package/dist/utils/position-calculator.d.ts

@@ -0,0 +1,76 @@
+import type { OpenPositionDto, AssetPosition, WebData2Response, WsAllMidsData } from '../types';
+/**
+ * Position side enum for calculations
+ */
+export declare enum PositionSide {
+    LONG = "LONG",
+    SHORT = "SHORT"
+}
+/**
+ * Position calculation utility class
+ */
+export 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;
+}

package/dist/websocket.d.ts

@@ -0,0 +1,20 @@
+import { ReadyState } from 'react-use-websocket';
+import type { PaginatedTradeHistoryResponseDto, OpenPositionDto, OpenLimitOrderDto, AccountSummaryResponseDto } from './types';
+interface WebSocketData {
+    tradeHistories: PaginatedTradeHistoryResponseDto | null;
+    openPositions: OpenPositionDto[] | null;
+    openOrders: OpenLimitOrderDto[] | null;
+    accountSummary: AccountSummaryResponseDto | null;
+}
+export interface UseHyperliquidWebSocketProps {
+    wsUrl: string;
+    address: string | null;
+}
+export interface UseHyperliquidWebSocketReturn {
+    data: WebSocketData;
+    connectionStatus: ReadyState;
+    isConnected: boolean;
+    lastError: string | null;
+}
+export declare const useHyperliquidWebSocket: ({ wsUrl, address }: UseHyperliquidWebSocketProps) => UseHyperliquidWebSocketReturn;
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pear-protocol/hyperliquid-sdk",
-  "version": "0.0.4",
+  "version": "0.0.7",
   "description": "React SDK for Pear Protocol Hyperliquid API integration",
   "main": "dist/index.js",
   "module": "dist/index.esm.js",