@pear-protocol/hyperliquid-sdk 0.0.49-hip3-alpha → 0.0.50

package/dist/clients/hyperliquid.d.ts

@@ -1,8 +1,8 @@
-import type { ApiResponse, CandleInterval, CandleData, ExternalFillDto, AllPerpMetasResponse } from '../types';
+import type { ApiResponse, CandleInterval, CandleData, ExternalFillDto, AllPerpMetasResponse, ExtraAgent } from '../types';
 /**
  * Fetch historical candle data from HyperLiquid API
  */
-export declare const fetchHistoricalCandles: (coin: string, startTime: number, endTime: number, interval: CandleInterval) => Promise<ApiResponse<CandleData[]>>;
+export declare const fetchHistoricalCandles: (coin: string, startTime: number, endTime: number, interval: CandleInterval, displayToFull: Map<string, string>) => Promise<ApiResponse<CandleData[]>>;
 /**
  * Retrieve recent user fills from HyperLiquid and map to ExternalFillDto[]
  */
@@ -13,3 +13,9 @@ export declare const fetchUserFillsFromHyperliquid: (user: string, startTime: nu
  * Payload: { "type": "allPerpMetas" }
  */
 export declare const fetchAllPerpMetas: () => Promise<ApiResponse<AllPerpMetasResponse>>;
+/**
+ * Fetch extra agent approvals for a given user from HyperLiquid API
+ * Endpoint: https://api.hyperliquid.xyz/info
+ * Payload: { "type": "extraAgents", "user": "0x..." }
+ */
+export declare const fetchExtraAgents: (user: string) => Promise<ApiResponse<ExtraAgent[]>>;

package/dist/clients/positions.d.ts

@@ -56,7 +56,7 @@ export interface CreatePositionResponseDto {
  * Caller should supply an accessToken from localStorage.getItem('accessToken')
  * @throws MinimumPositionSizeError if any asset has less than $11 USD value
  */
-export declare function createPosition(baseUrl: string, accessToken: string, payload: CreatePositionRequestInput): Promise<ApiResponse<CreatePositionResponseDto>>;
+export declare function createPosition(baseUrl: string, accessToken: string, payload: CreatePositionRequestInput, displayToFull: Map<string, string>): Promise<ApiResponse<CreatePositionResponseDto>>;
 export interface UpdateRiskParametersRequestInput {
     stopLoss?: TpSlThresholdInput | null;
     takeProfit?: TpSlThresholdInput | null;

package/dist/clients/sync.d.ts

@@ -6,4 +6,4 @@ export declare const syncFills: (baseUrl: string, accessToken: string, payload:
 /**
  * Convenience: fetch user fills from HyperLiquid, then sync them to Pear backend
  */
-export declare const syncUserFillsFromHyperliquid: (baseUrl: string, accessToken: string, user: string, aggregateByTime?: boolean) => Promise<ApiResponse<SyncFillsResponseDto>>;
+export declare const syncUserFillsFromHyperliquid: (baseUrl: string, accessToken: string, user: string, aggregateByTime?: boolean, lastSyncAt?: number | null) => Promise<ApiResponse<SyncFillsResponseDto>>;

package/dist/clients/watchlist.d.ts

@@ -1,2 +1,2 @@
 import type { ApiResponse, ToggleWatchlistResponseDto, WatchlistAssetDto } from '../types';
-export declare function toggleWatchlist(baseUrl: string, accessToken: string, longAssets: WatchlistAssetDto[], shortAssets: WatchlistAssetDto[]): Promise<ApiResponse<ToggleWatchlistResponseDto>>;
+export declare function toggleWatchlist(baseUrl: string, accessToken: string, longAssets: WatchlistAssetDto[], shortAssets: WatchlistAssetDto[], displayToFull: Map<string, string>): Promise<ApiResponse<ToggleWatchlistResponseDto>>;

package/dist/hooks/index.d.ts

@@ -1,4 +1,4 @@
-export * from './useAddress';
+export * from './useAccountSummary';
 export * from './useTrading';
 export * from './useUserSelection';
 export * from './useWebData';

package/dist/hooks/useAccountSummary.d.ts

@@ -0,0 +1,5 @@
+import { AccountSummaryResponseDto } from "../types";
+export declare const useAccountSummary: () => {
+    data: AccountSummaryResponseDto | null;
+    isLoading: boolean;
+};

package/dist/hooks/useAgentWallet.d.ts

@@ -1,10 +1,5 @@
-import type { GetAgentWalletResponseDto, CreateAgentWalletResponseDto, UseAgentWalletOptions, AgentWalletState } from '../types';
-export declare function useAgentWallet({ baseUrl }: UseAgentWalletOptions): {
-    readonly agentWallet: AgentWalletState;
-    readonly isReady: boolean;
-    readonly loading: false;
-    readonly error: null;
-    readonly refreshAgentWalletStatus: () => Promise<GetAgentWalletResponseDto>;
-    readonly createAgentWallet: () => Promise<CreateAgentWalletResponseDto>;
-    readonly notifyAgentWalletApproved: () => Promise<GetAgentWalletResponseDto>;
+export declare function useAgentWallet(): {
+    readonly refreshAgentWalletStatus: () => Promise<void>;
+    readonly createAgentWallet: () => Promise<import("../types").CreateAgentWalletResponseDto>;
+    readonly notifyAgentWalletApproved: () => Promise<void>;
 };

package/dist/hooks/usePortfolio.d.ts

@@ -8,6 +8,6 @@ export interface UsePortfolioResult {
 /**
  * Hook to fetch and manage portfolio data
  * Returns bucketed volume, open interest snapshot, win/loss trade counts,
- * and overall metrics filtered to PEAR fills (cloid LIKE 0x50454152%)
+ * and overall metrics
  */
 export declare function usePortfolio(): UsePortfolioResult;

package/dist/hooks/useTrading.d.ts

@@ -1,4 +1,4 @@
-import type { AccountSummaryResponseDto, OpenLimitOrderDto } from '../types';
+import type { OpenLimitOrderDto } from '../types';
 import type { TradeHistoryDataDto } from '../types';
 export declare const useTradeHistories: () => {
     data: TradeHistoryDataDto[] | null;
@@ -11,10 +11,3 @@ export declare const useOpenOrders: () => {
     data: OpenLimitOrderDto[] | null;
     isLoading: boolean;
 };
-/**
- * Hook to access account summary with real-time calculations and loading state
- */
-export declare const useAccountSummary: () => {
-    data: AccountSummaryResponseDto | null;
-    isLoading: boolean;
-};

package/dist/hooks/useWebData.d.ts

@@ -3,9 +3,10 @@ import type { AssetMarketData, ClearinghouseState } from '../types';
  * Hook to access webData and native WebSocket state
  */
 export declare const useWebData: () => {
-    clearinghouseState: ClearinghouseState | undefined;
-    perpsAtOpenInterestCap: string[] | undefined;
+    clearinghouseState: ClearinghouseState | null;
+    perpsAtOpenInterestCap: string[] | null;
     marketDataBySymbol: Record<string, AssetMarketData>;
+    hip3Assets: Map<string, string>;
     isConnected: boolean;
     error: string | null;
 };

package/dist/hyperliquid-websocket.d.ts

@@ -1,9 +1,10 @@
 export interface UseHyperliquidNativeWebSocketProps {
     address: string | null;
     tokens?: string[];
+    enabled?: boolean;
 }
 export interface UseHyperliquidNativeWebSocketReturn {
     isConnected: boolean;
     lastError: string | null;
 }
-export declare const useHyperliquidNativeWebSocket: ({ address, }: UseHyperliquidNativeWebSocketProps) => UseHyperliquidNativeWebSocketReturn;
+export declare const useHyperliquidNativeWebSocket: ({ address, enabled, }: UseHyperliquidNativeWebSocketProps) => UseHyperliquidNativeWebSocketReturn;

package/dist/index.d.ts

@@ -272,15 +272,22 @@ interface BalanceSummaryDto {
  * Agent wallet information
  */
 interface AgentWalletDto {
-    address: string;
+    address?: string;
     status: string;
 }
+interface PlatformAccountSummaryResponseDto {
+    agentWalletAddress: string | null;
+    totalClosedTrades: number;
+    totalLimitOrderUsdValue?: number;
+    totalTwapChunkUsdValue?: number;
+    lastSyncedAt?: number;
+}
 /**
  * Account balance response (renamed to AccountSummaryResponseDto for consistency)
  */
 interface AccountSummaryResponseDto {
     balanceSummary: BalanceSummaryDto;
-    agentWallet: AgentWalletDto;
+    agentWallet?: AgentWalletDto;
 }
 declare enum AuthStatus {
     Idle = "idle",
@@ -298,17 +305,14 @@ interface UserProfile {
     appId: string;
 }
 type AgentWalletStatus = 'ACTIVE' | 'EXPIRED' | 'NOT_FOUND';
-interface GetAgentWalletResponseDto {
-    agentWalletAddress?: string;
-    agentName: string;
-    status: AgentWalletStatus;
-}
 interface CreateAgentWalletResponseDto {
     agentWalletAddress: string;
     message: string;
 }
-interface UseAgentWalletOptions {
-    baseUrl: string;
+interface ExtraAgent {
+    name: string;
+    address: string;
+    validUntil: number;
 }
 interface AgentWalletState {
     address: string | null;
@@ -626,13 +630,6 @@ 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>;
 }
 interface PearHyperliquidProviderProps {
     children: ReactNode;
@@ -664,27 +661,10 @@ declare function usePearAuth(): {
     readonly refreshTokens: () => Promise<any>;
     readonly logout: () => Promise<void>;
 };
-/**
- * Provider-aware Agent Wallet hook. Uses agent wallet state/actions provided by PearHyperliquidProvider.
- */
-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>;
-};
 
-/**
- * Hook to manage address (login/logout functionality)
- */
-declare const useAddress: () => {
-    address: string | null;
-    setAddress: (address: string | null) => void;
-    clearAddress: () => void;
-    isLoggedIn: boolean;
+declare const useAccountSummary: () => {
+    data: AccountSummaryResponseDto | null;
+    isLoading: boolean;
 };
 
 declare const useTradeHistories: () => {
@@ -698,13 +678,6 @@ declare const useOpenOrders: () => {
     data: OpenLimitOrderDto[] | null;
     isLoading: boolean;
 };
-/**
- * Hook to access account summary with real-time calculations and loading state
- */
-declare const useAccountSummary: () => {
-    data: AccountSummaryResponseDto | null;
-    isLoading: boolean;
-};
 
 interface UserSelectionState {
     longTokens: TokenSelection[];
@@ -736,9 +709,10 @@ declare const useUserSelection: () => UserSelectionState;
  * Hook to access webData and native WebSocket state
  */
 declare const useWebData: () => {
-    clearinghouseState: ClearinghouseState | undefined;
-    perpsAtOpenInterestCap: string[] | undefined;
+    clearinghouseState: ClearinghouseState | null;
+    perpsAtOpenInterestCap: string[] | null;
     marketDataBySymbol: Record<string, AssetMarketData>;
+    hip3Assets: Map<string, string>;
     isConnected: boolean;
     error: string | null;
 };
@@ -824,14 +798,10 @@ interface UsePerformanceOverlaysReturn {
 }
 declare const usePerformanceOverlays: () => UsePerformanceOverlaysReturn;
 
-declare function useAgentWallet({ baseUrl }: UseAgentWalletOptions): {
-    readonly agentWallet: AgentWalletState;
-    readonly isReady: boolean;
-    readonly loading: false;
-    readonly error: null;
-    readonly refreshAgentWalletStatus: () => Promise<GetAgentWalletResponseDto>;
+declare function useAgentWallet(): {
+    readonly refreshAgentWalletStatus: () => Promise<void>;
     readonly createAgentWallet: () => Promise<CreateAgentWalletResponseDto>;
-    readonly notifyAgentWalletApproved: () => Promise<GetAgentWalletResponseDto>;
+    readonly notifyAgentWalletApproved: () => Promise<void>;
 };
 
 interface AutoSyncFillsOptions {
@@ -935,7 +905,7 @@ interface CreatePositionResponseDto {
  * Caller should supply an accessToken from localStorage.getItem('accessToken')
  * @throws MinimumPositionSizeError if any asset has less than $11 USD value
  */
-declare function createPosition(baseUrl: string, accessToken: string, payload: CreatePositionRequestInput): Promise<ApiResponse<CreatePositionResponseDto>>;
+declare function createPosition(baseUrl: string, accessToken: string, payload: CreatePositionRequestInput, displayToFull: Map<string, string>): Promise<ApiResponse<CreatePositionResponseDto>>;
 interface UpdateRiskParametersRequestInput {
     stopLoss?: TpSlThresholdInput | null;
     takeProfit?: TpSlThresholdInput | null;
@@ -1094,15 +1064,16 @@ interface UsePortfolioResult {
 /**
  * Hook to fetch and manage portfolio data
  * Returns bucketed volume, open interest snapshot, win/loss trade counts,
- * and overall metrics filtered to PEAR fills (cloid LIKE 0x50454152%)
+ * and overall metrics
  */
 declare function usePortfolio(): UsePortfolioResult;
 
 interface UseHyperliquidWebSocketProps {
     wsUrl: string;
     address: string | null;
+    enabled?: boolean;
 }
-declare const useHyperliquidWebSocket: ({ wsUrl, address }: UseHyperliquidWebSocketProps) => {
+declare const useHyperliquidWebSocket: ({ wsUrl, address, enabled, }: UseHyperliquidWebSocketProps) => {
     isConnected: boolean;
     lastError: string | null;
 };
@@ -1110,12 +1081,13 @@ declare const useHyperliquidWebSocket: ({ wsUrl, address }: UseHyperliquidWebSoc
 interface UseHyperliquidNativeWebSocketProps {
     address: string | null;
     tokens?: string[];
+    enabled?: boolean;
 }
 interface UseHyperliquidNativeWebSocketReturn {
     isConnected: boolean;
     lastError: string | null;
 }
-declare const useHyperliquidNativeWebSocket: ({ address, }: UseHyperliquidNativeWebSocketProps) => UseHyperliquidNativeWebSocketReturn;
+declare const useHyperliquidNativeWebSocket: ({ address, enabled, }: UseHyperliquidNativeWebSocketProps) => UseHyperliquidNativeWebSocketReturn;
 
 /**
  * Mark notifications as read up to a given timestamp (ms)
@@ -1130,7 +1102,7 @@ declare function markNotificationReadById(baseUrl: string, accessToken: string,
     updated: number;
 }>>;
 
-declare function toggleWatchlist(baseUrl: string, accessToken: string, longAssets: WatchlistAssetDto[], shortAssets: WatchlistAssetDto[]): Promise<ApiResponse<ToggleWatchlistResponseDto>>;
+declare function toggleWatchlist(baseUrl: string, accessToken: string, longAssets: WatchlistAssetDto[], shortAssets: WatchlistAssetDto[], displayToFull: Map<string, string>): Promise<ApiResponse<ToggleWatchlistResponseDto>>;
 
 /**
  * Account summary calculation utility class
@@ -1141,11 +1113,7 @@ declare class AccountSummaryCalculator {
     /**
      * 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;
+    calculateAccountSummary(platformAccountSummary: PlatformAccountSummaryResponseDto | null, registeredAgentWallets: ExtraAgent[]): AccountSummaryResponseDto | null;
     getClearinghouseState(): ClearinghouseState | null;
     /**
      * Check if real-time data is available
@@ -1276,5 +1244,5 @@ declare function validatePositionSize(usdValue: number, longAssets?: PairAssetIn
 
 declare const useMarketData: any;
 
-export { AccountSummaryCalculator, AuthStatus, ConflictDetector, MINIMUM_ASSET_USD_VALUE, MinimumPositionSizeError, PearHyperliquidProvider, TokenMetadataExtractor, adjustOrder, adjustPosition, calculateMinimumPositionValue, calculateWeightedRatio, cancelOrder, cancelTwap, cancelTwapOrder, closeAllPositions, closePosition, computeBasketCandles, createCandleLookups, createPosition, getCompleteTimestamps, getPortfolio, mapCandleIntervalToTradingViewInterval, mapTradingViewIntervalToCandleInterval, markNotificationReadById, markNotificationsRead, toggleWatchlist, updateRiskParameters, useAccountSummary, useActiveBaskets, useAddress, useAgentWallet, useAllBaskets, useAutoSyncFills, useBasketCandles, useFindBasket, useHighlightedBaskets, useHistoricalPriceData, useHistoricalPriceDataStore, useHyperliquidNativeWebSocket, useHyperliquidWebSocket, useMarketData, useMarketDataAllPayload, useMarketDataPayload, useNotifications, useOpenOrders, useOrders, usePearAgentWallet, usePearAuth, usePearHyperliquid, usePerformanceOverlays, usePortfolio, usePosition, useTokenSelectionMetadata, useTopGainers, useTopLosers, useTradeHistories, useTwap, useUserSelection, useWatchlist, useWatchlistBaskets, useWebData, validateMinimumAssetSize, validatePositionSize };
-export type { AccountSummaryResponseDto, ActiveAssetGroupItem, ActiveAssetsResponse, AdjustExecutionType, AdjustOrderRequestInput, AdjustOrderResponseDto, AdjustPositionRequestInput, AdjustPositionResponseDto, AgentWalletDto, AgentWalletState, ApiErrorResponse, ApiResponse, AssetCtx, AssetInformationDetail, AssetMarketData, AssetPosition, AutoSyncFillsOptions, AutoSyncFillsState, BalanceSummaryDto, CancelOrderResponseDto, CancelTwapResponseDto, CandleChartData, CandleData, CandleInterval, CandleSnapshotRequest, ClearinghouseState, CloseAllPositionsResponseDto, CloseAllPositionsResultDto, CloseExecutionType, ClosePositionRequestInput, ClosePositionResponseDto, CreatePositionRequestInput, CreatePositionResponseDto, CrossMarginSummaryDto, CumFundingDto, ExecutionType, HLWebSocketResponse, HistoricalRange, LadderConfigInput, MarginSummaryDto, NotificationCategory, NotificationDto, OpenLimitOrderDto, OpenPositionDto, OrderAssetDto, OrderStatus, PairAssetDto, PairAssetInput, PerformanceOverlay, PortfolioBucketDto, PortfolioInterval, PortfolioIntervalsDto, PortfolioOverallDto, PortfolioResponseDto, PositionAdjustmentType, PositionAssetDetailDto, PositionAssetSummaryDto, PositionResponseStatus, RealtimeBar, RealtimeBarsCallback, ToggleWatchlistResponseDto, TokenConflict, TokenHistoricalPriceData, TokenMetadata, TokenSelection, TpSlThresholdInput, TpSlThresholdType, TradeHistoryAssetDataDto, TradeHistoryDataDto, TwapChunkStatusDto, TwapMonitoringDto, UniverseAsset, UpdateRiskParametersRequestInput, UpdateRiskParametersResponseDto, UseAgentWalletOptions, UseAuthOptions, UseBasketCandlesReturn, UseHistoricalPriceDataReturn, UseNotificationsResult, UsePerformanceOverlaysReturn, UsePortfolioResult, UseTokenSelectionMetadataReturn, UserProfile, UserSelectionState, WatchlistItemDto, WebSocketAckResponse, WebSocketChannel, WebSocketConnectionState, WebSocketDataMessage, WebSocketMessage, WebSocketSubscribeMessage, WsAllMidsData };
+export { AccountSummaryCalculator, AuthStatus, ConflictDetector, MINIMUM_ASSET_USD_VALUE, MinimumPositionSizeError, PearHyperliquidProvider, TokenMetadataExtractor, adjustOrder, adjustPosition, calculateMinimumPositionValue, calculateWeightedRatio, cancelOrder, cancelTwap, cancelTwapOrder, closeAllPositions, closePosition, computeBasketCandles, createCandleLookups, createPosition, getCompleteTimestamps, getPortfolio, mapCandleIntervalToTradingViewInterval, mapTradingViewIntervalToCandleInterval, markNotificationReadById, markNotificationsRead, toggleWatchlist, updateRiskParameters, useAccountSummary, useActiveBaskets, useAgentWallet, useAllBaskets, useAutoSyncFills, useBasketCandles, useFindBasket, useHighlightedBaskets, useHistoricalPriceData, useHistoricalPriceDataStore, useHyperliquidNativeWebSocket, useHyperliquidWebSocket, useMarketData, useMarketDataAllPayload, useMarketDataPayload, useNotifications, useOpenOrders, useOrders, usePearAuth, usePearHyperliquid, usePerformanceOverlays, usePortfolio, usePosition, useTokenSelectionMetadata, useTopGainers, useTopLosers, useTradeHistories, useTwap, useUserSelection, useWatchlist, useWatchlistBaskets, useWebData, validateMinimumAssetSize, validatePositionSize };
+export type { AccountSummaryResponseDto, ActiveAssetGroupItem, ActiveAssetsResponse, AdjustExecutionType, AdjustOrderRequestInput, AdjustOrderResponseDto, AdjustPositionRequestInput, AdjustPositionResponseDto, AgentWalletDto, AgentWalletState, ApiErrorResponse, ApiResponse, AssetCtx, AssetInformationDetail, AssetMarketData, AssetPosition, AutoSyncFillsOptions, AutoSyncFillsState, BalanceSummaryDto, CancelOrderResponseDto, CancelTwapResponseDto, CandleChartData, CandleData, CandleInterval, CandleSnapshotRequest, ClearinghouseState, CloseAllPositionsResponseDto, CloseAllPositionsResultDto, CloseExecutionType, ClosePositionRequestInput, ClosePositionResponseDto, CreatePositionRequestInput, CreatePositionResponseDto, CrossMarginSummaryDto, CumFundingDto, ExecutionType, ExtraAgent, HLWebSocketResponse, HistoricalRange, LadderConfigInput, MarginSummaryDto, NotificationCategory, NotificationDto, OpenLimitOrderDto, OpenPositionDto, OrderAssetDto, OrderStatus, PairAssetDto, PairAssetInput, PerformanceOverlay, PlatformAccountSummaryResponseDto, PortfolioBucketDto, PortfolioInterval, PortfolioIntervalsDto, PortfolioOverallDto, PortfolioResponseDto, PositionAdjustmentType, PositionAssetDetailDto, PositionAssetSummaryDto, PositionResponseStatus, RealtimeBar, RealtimeBarsCallback, ToggleWatchlistResponseDto, TokenConflict, TokenHistoricalPriceData, TokenMetadata, TokenSelection, TpSlThresholdInput, TpSlThresholdType, TradeHistoryAssetDataDto, TradeHistoryDataDto, TwapChunkStatusDto, TwapMonitoringDto, UniverseAsset, UpdateRiskParametersRequestInput, UpdateRiskParametersResponseDto, UseAuthOptions, UseBasketCandlesReturn, UseHistoricalPriceDataReturn, UseNotificationsResult, UsePerformanceOverlaysReturn, UsePortfolioResult, UseTokenSelectionMetadataReturn, UserProfile, UserSelectionState, WatchlistItemDto, WebSocketAckResponse, WebSocketChannel, WebSocketConnectionState, WebSocketDataMessage, WebSocketMessage, WebSocketSubscribeMessage, WsAllMidsData };