@pear-protocol/hyperliquid-sdk 0.0.5 → 0.0.8

package/dist/provider.d.ts

@@ -3,8 +3,7 @@ import { ReadyState } from 'react-use-websocket';
 import { PearHyperliquidClient } from './client';
 import { PearHyperliquidConfig } from './types';
 import { PearMigrationSDK } from './migration-sdk';
-import { HyperliquidService } from './hyperliquid-service';
-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;
@@ -14,13 +13,17 @@ interface WebSocketData {
 export interface PearHyperliquidContextType {
     client: PearHyperliquidClient;
     migrationSDK: PearMigrationSDK;
-    hyperliquidService: HyperliquidService;
     address: string | null;
     setAddress: (address: string | null) => void;
     connectionStatus: ReadyState;
     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 {
@@ -30,11 +33,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;
 }
 /**
@@ -49,8 +47,4 @@ export declare const usePearHyperliquidClient: () => PearHyperliquidClient;
  * Hook to use migration SDK from context
  */
 export declare const useMigrationSDK: () => PearMigrationSDK;
-/**
- * Hook to use Hyperliquid service from context
- */
-export declare const useHyperliquidService: () => HyperliquidService;
 export {};

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/aggregate-position-calculator.d.ts

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

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.5",
+  "version": "0.0.8",
   "description": "React SDK for Pear Protocol Hyperliquid API integration",
   "main": "dist/index.js",
   "module": "dist/index.esm.js",
@@ -15,7 +15,6 @@
     "clean": "rimraf dist"
   },
   "dependencies": {
-    "@nktkas/hyperliquid": "^0.22.1",
     "axios": "^1.6.0",
     "react-use-websocket": "^4.8.1"
   },
@@ -34,14 +33,7 @@
     "tslib": "^2.6.0",
     "typescript": "^5.0.0"
   },
-  "keywords": [
-    "pear",
-    "hyperliquid",
-    "sdk",
-    "react",
-    "trading",
-    "api"
-  ],
+  "keywords": ["pear", "hyperliquid", "sdk", "react", "trading", "api"],
   "author": "Pear Protocol",
   "license": "MIT",
   "repository": {
@@ -54,4 +46,4 @@
     "access": "public"
   },
   "private": false
-}
+}

package/dist/hyperliquid-service.d.ts

@@ -1,75 +0,0 @@
-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>;
-}