@pear-protocol/hyperliquid-sdk 0.0.49 → 0.0.51

package/dist/provider.d.ts

@@ -1,7 +1,6 @@
 import React, { ReactNode } from 'react';
 import type { UserProfile } from './types';
 import { AuthStatus } from './types';
-import type { AgentWalletState } from './types';
 export interface PearHyperliquidContextType {
     apiBaseUrl: string;
     wsUrl: string;
@@ -21,13 +20,6 @@ export interface PearHyperliquidContextType {
     loginWithPrivyToken: (address: string, appId: string, accessToken: string) => Promise<void>;
     refreshTokens: () => Promise<any>;
     logout: () => Promise<void>;
-    agentWallet: AgentWalletState;
-    isAgentWalletReady: boolean;
-    agentWalletError: string | null;
-    agentWalletLoading: boolean;
-    refreshAgentWalletStatus: () => Promise<any>;
-    createAgentWallet: () => Promise<any>;
-    notifyAgentWalletApproved: () => Promise<any>;
 }
 export declare const PearHyperliquidContext: React.Context<PearHyperliquidContextType | undefined>;
 interface PearHyperliquidProviderProps {
@@ -60,16 +52,4 @@ export declare function usePearAuth(): {
     readonly refreshTokens: () => Promise<any>;
     readonly logout: () => Promise<void>;
 };
-/**
- * Provider-aware Agent Wallet hook. Uses agent wallet state/actions provided by PearHyperliquidProvider.
- */
-export declare function usePearAgentWallet(): {
-    readonly agentWallet: AgentWalletState;
-    readonly isReady: boolean;
-    readonly loading: boolean;
-    readonly error: string | null;
-    readonly refreshAgentWalletStatus: () => Promise<any>;
-    readonly createAgentWallet: () => Promise<any>;
-    readonly notifyAgentWalletApproved: () => Promise<any>;
-};
 export {};

package/dist/store/tokenSelectionMetadataStore.d.ts

@@ -1,4 +1,4 @@
-import type { ActiveAssetData, TokenSelection, TokenMetadata, WebData2Response, WsAllMidsData, ActiveAssetsResponse } from "../types";
+import type { ActiveAssetData, TokenSelection, TokenMetadata, WsAllMidsData, ActiveAssetsResponse, UniverseAsset, WebData3AssetCtx } from "../types";
 export interface TokenSelectionMetadataState {
     isPriceDataReady: boolean;
     isLoading: boolean;
@@ -15,7 +15,8 @@ export interface TokenSelectionMetadataState {
     minMargin: number;
     leverageMatched: boolean;
     recompute: (args: {
-        webData2: WebData2Response | null;
+        perpMetaAssets: UniverseAsset[] | null;
+        finalAssetContexts: WebData3AssetCtx[] | null;
         allMids: WsAllMidsData | null;
         activeAssetData: Record<string, ActiveAssetData> | null;
         marketData: ActiveAssetsResponse | null;

package/dist/types.d.ts

@@ -57,7 +57,7 @@ export declare enum ReadyState {
 /**
  * WebSocket channels
  */
-export type WebSocketChannel = 'trade-histories' | 'open-positions' | 'open-orders' | 'account-summary' | 'twap-details' | 'notifications' | 'market-data' | 'market-data-all' | 'webData2' | 'allMids' | 'activeAssetData';
+export type WebSocketChannel = 'trade-histories' | 'open-positions' | 'open-orders' | 'account-summary' | 'twap-details' | 'notifications' | 'market-data' | 'market-data-all' | 'webData3' | 'allMids' | 'activeAssetData';
 /**
  * WebSocket subscription message
  */
@@ -152,6 +152,7 @@ export interface TradeHistoryAssetDataDto {
     entryWeight: number;
     entryPrice: number;
     limitPrice: number;
+    leverage: number;
     size: number;
     externalFeePaid: number;
     builderFeePaid: number;
@@ -167,6 +168,7 @@ export interface TradeHistoryDataDto {
     externalFeePaid: number;
     builderFeePaid: number;
     realizedPnl: number;
+    realizedPnlPercentage: number;
     totalEntryValue: number;
     totalValue: number;
     entryRatio: number;
@@ -221,6 +223,7 @@ export interface OpenPositionDto {
     positionValue: number;
     marginUsed: number;
     unrealizedPnl: number;
+    unrealizedPnlPercentage: number;
     longAssets: PositionAssetDetailDto[];
     shortAssets: PositionAssetDetailDto[];
     createdAt: string;
@@ -301,15 +304,22 @@ export interface BalanceSummaryDto {
  * Agent wallet information
  */
 export interface AgentWalletDto {
-    address: string;
+    address?: string;
     status: string;
 }
+export interface PlatformAccountSummaryResponseDto {
+    agentWalletAddress: string | null;
+    totalClosedTrades: number;
+    totalLimitOrderUsdValue?: number;
+    totalTwapChunkUsdValue?: number;
+    lastSyncedAt?: number;
+}
 /**
  * Account balance response (renamed to AccountSummaryResponseDto for consistency)
  */
 export interface AccountSummaryResponseDto {
     balanceSummary: BalanceSummaryDto;
-    agentWallet: AgentWalletDto;
+    agentWallet?: AgentWalletDto;
 }
 /**
  * Address management state
@@ -400,8 +410,10 @@ export interface CreateAgentWalletResponseDto {
     agentWalletAddress: string;
     message: string;
 }
-export interface UseAgentWalletOptions {
-    baseUrl: string;
+export interface ExtraAgent {
+    name: string;
+    address: string;
+    validUntil: number;
 }
 export interface AgentWalletState {
     address: string | null;
@@ -416,6 +428,7 @@ export interface WebSocketMessage {
     method: "subscribe" | "unsubscribe";
     subscription: {
         type: string;
+        dex?: string;
         coin?: string;
         interval?: string;
         user?: string;
@@ -425,13 +438,44 @@ export interface WebSocketMessage {
 /**
  * WebSocket response from HyperLiquid native API
  */
-export type HLChannel = 'webData2' | 'allMids' | 'activeAssetData' | 'candle';
+export type HLChannel = 'webData3' | 'allMids' | 'activeAssetData' | 'candle';
 export interface HLChannelDataMap {
-    webData2: WebData2Response;
+    webData3: WebData3Response;
     allMids: WsAllMidsData;
     activeAssetData: ActiveAssetData;
     candle: CandleData;
 }
+export interface WebData3UserState {
+    agentAddress?: string;
+    agentValidUntil?: number;
+    cumLedger: string;
+    serverTime: number;
+    isVault: boolean;
+    user: string;
+    dexAbstractionEnabled?: boolean;
+}
+export interface WebData3AssetCtx {
+    funding: string;
+    openInterest: string;
+    prevDayPx: string;
+    dayNtlVlm: string;
+    premium: string | null;
+    oraclePx: string;
+    markPx: string;
+    midPx: string | null;
+    impactPxs: string[] | null;
+    dayBaseVlm: string;
+}
+export interface WebData3PerpDexState {
+    clearinghouseState: ClearinghouseState;
+    totalVaultEquity: string;
+    assetCtxs: WebData3AssetCtx[];
+    perpsAtOpenInterestCap: string[];
+}
+export interface WebData3Response {
+    userState: WebData3UserState;
+    perpDexStates: WebData3PerpDexState[];
+}
 export interface HLWebSocketResponse<T extends HLChannel = HLChannel> {
     channel: T;
     data: HLChannelDataMap[T];
@@ -465,17 +509,24 @@ export interface UniverseAsset {
     onlyIsolated?: boolean;
     isDelisted?: boolean;
 }
-/**
- * WebData2 response structure
- */
-export interface WebData2Response {
-    assetCtxs: AssetCtx[];
-    meta: {
-        universe: UniverseAsset[];
-    };
-    clearinghouseState: ClearinghouseState;
-    perpsAtOpenInterestCap?: string[];
+export interface PerpMetaAsset extends UniverseAsset {
+    marginTableId: number;
+}
+export interface MarginTier {
+    lowerBound: string;
+    maxLeverage: number;
+}
+export interface MarginTableDef {
+    description: string;
+    marginTiers: MarginTier[];
 }
+export type MarginTablesEntry = [number, MarginTableDef];
+export interface AllPerpMetasItem {
+    universe: PerpMetaAsset[];
+    marginTables: MarginTablesEntry[];
+    collateralToken: number;
+}
+export type AllPerpMetasResponse = AllPerpMetasItem[];
 export interface ClearinghouseState {
     assetPositions: AssetPosition[];
     crossMaintenanceMarginUsed: string;
@@ -577,9 +628,6 @@ export interface ActiveAssetData {
     availableToTrade: [string, string];
     markPx: string;
 }
-/**
- * Token metadata from WebData2 and AllMids
- */
 export interface TokenMetadata {
     currentPrice: number;
     prevDayPrice: number;
@@ -611,7 +659,7 @@ export interface TokenConflict {
     conflictMessage: string;
 }
 export interface AssetMarketData {
-    asset: AssetCtx;
+    asset: WebData3AssetCtx | AssetCtx;
     universe: UniverseAsset;
 }
 export interface PairAssetDto {

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

@@ -1,22 +1,15 @@
-import type { AccountSummaryResponseDto, WebData2Response, OpenLimitOrderDto } from '../types';
+import type { AccountSummaryResponseDto, ClearinghouseState, ExtraAgent, PlatformAccountSummaryResponseDto } from '../types';
 /**
  * Account summary calculation utility class
  */
 export declare class AccountSummaryCalculator {
-    private webData2;
-    constructor(webData2: WebData2Response | null);
+    private clearinghouseState;
+    constructor(clearinghouseState: ClearinghouseState | null);
     /**
-     * Calculate account summary from webData2 and platform orders
+     * Calculate account summary from real-time clearinghouse state 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(): import("../types").ClearinghouseState | null;
+    calculateAccountSummary(platformAccountSummary: PlatformAccountSummaryResponseDto | null, registeredAgentWallets: ExtraAgent[]): AccountSummaryResponseDto | null;
+    getClearinghouseState(): ClearinghouseState | null;
     /**
      * Check if real-time data is available
      */

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

@@ -1,2 +1,2 @@
-import { OpenPositionDto, RawPositionDto, WebData2Response, WsAllMidsData } from "../types";
-export declare const buildPositionValue: (rawPositions: RawPositionDto[], webData2: WebData2Response, allMids: WsAllMidsData) => OpenPositionDto[];
+import { OpenPositionDto, RawPositionDto, ClearinghouseState, WsAllMidsData } from "../types";
+export declare const buildPositionValue: (rawPositions: RawPositionDto[], clearinghouseState: ClearinghouseState, allMids: WsAllMidsData) => OpenPositionDto[];

package/dist/utils/symbol-translator.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Convert a full/prefixed symbol (e.g., "xyz:XYZ100") to a display symbol (e.g., "XYZ100").
+ */
+export declare function toDisplaySymbol(symbol: string): string;
+/**
+ * Convert a display symbol back to backend form using a provided map.
+ * If mapping is missing, returns the original symbol.
+ * @param displaySymbol e.g., "XYZ100"
+ * @param displayToFull map of display -> full (e.g., "XYZ100" -> "xyz:XYZ100")
+ */
+export declare function toBackendSymbol(displaySymbol: string, displayToFull: Map<string, string>): string;

package/dist/utils/token-metadata-extractor.d.ts

@@ -1,31 +1,33 @@
-import type { WebData2Response, WsAllMidsData, TokenMetadata, ActiveAssetData } from '../types';
+import type { WsAllMidsData, TokenMetadata, ActiveAssetData, UniverseAsset, WebData3AssetCtx } from '../types';
 /**
- * Extracts token metadata from WebData2 and AllMids data
+ * Extracts token metadata from aggregated WebData3 contexts and AllMids data
  */
 export declare class TokenMetadataExtractor {
     /**
      * Extracts comprehensive token metadata
      * @param symbol - Token symbol
-     * @param webData2 - WebData2 response containing asset context and universe data
+     * @param perpMetaAssets - Aggregated universe assets (flattened across dexes)
+     * @param finalAssetContexts - Aggregated asset contexts (flattened across dexes)
      * @param allMids - AllMids data containing current prices
      * @param activeAssetData - Optional active asset data containing leverage information
      * @returns TokenMetadata or null if token not found
      */
-    static extractTokenMetadata(symbol: string, webData2: WebData2Response | null, allMids: WsAllMidsData | null, activeAssetData?: Record<string, ActiveAssetData> | null): TokenMetadata | null;
+    static extractTokenMetadata(symbol: string, perpMetaAssets: UniverseAsset[] | null, finalAssetContexts: WebData3AssetCtx[] | null, allMids: WsAllMidsData | null, activeAssetData?: Record<string, ActiveAssetData> | null): TokenMetadata | null;
     /**
      * Extracts metadata for multiple tokens
      * @param symbols - Array of token symbols
-     * @param webData2 - WebData2 response
+     * @param perpMetaAssets - Aggregated universe assets
+     * @param finalAssetContexts - Aggregated asset contexts
      * @param allMids - AllMids data
      * @param activeAssetData - Optional active asset data containing leverage information
      * @returns Record of symbol to TokenMetadata
      */
-    static extractMultipleTokensMetadata(symbols: string[], webData2: WebData2Response | null, allMids: WsAllMidsData | null, activeAssetData?: Record<string, ActiveAssetData> | null): Record<string, TokenMetadata | null>;
+    static extractMultipleTokensMetadata(symbols: string[], perpMetaAssets: UniverseAsset[] | null, finalAssetContexts: WebData3AssetCtx[] | null, allMids: WsAllMidsData | null, activeAssetData?: Record<string, ActiveAssetData> | null): Record<string, TokenMetadata | null>;
     /**
-     * Checks if token data is available in WebData2
+     * Checks if token data is available in aggregated universe assets
      * @param symbol - Token symbol
-     * @param webData2 - WebData2 response
+     * @param perpMetaAssets - Aggregated universe assets
      * @returns boolean indicating if token exists in universe
      */
-    static isTokenAvailable(symbol: string, webData2: WebData2Response | null): boolean;
+    static isTokenAvailable(symbol: string, perpMetaAssets: UniverseAsset[] | null): boolean;
 }

package/dist/websocket.d.ts

@@ -1,8 +1,9 @@
 export interface UseHyperliquidWebSocketProps {
     wsUrl: string;
     address: string | null;
+    enabled?: boolean;
 }
-export declare const useHyperliquidWebSocket: ({ wsUrl, address }: UseHyperliquidWebSocketProps) => {
+export declare const useHyperliquidWebSocket: ({ wsUrl, address, enabled, }: UseHyperliquidWebSocketProps) => {
     isConnected: boolean;
     lastError: string | null;
 };

package/package.json

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