@pear-protocol/hyperliquid-sdk 0.0.72 → 0.0.73-beta-2

package/dist/provider.d.ts

@@ -1,4 +1,4 @@
-import React, { ReactNode } from "react";
+import React, { ReactNode } from 'react';
 export interface PearHyperliquidContextType {
     clientId: string;
     apiBaseUrl: string;

package/dist/store/historicalPriceDataStore.d.ts

@@ -10,5 +10,16 @@ interface TokenHistoricalPriceData {
     oldestTime: number | null;
     latestTime: number | null;
 }
-export declare const useHistoricalPriceDataStore: any;
+interface HistoricalPriceDataState {
+    historicalPriceData: Record<string, TokenHistoricalPriceData>;
+    loadingTokens: Set<string>;
+    addHistoricalPriceData: (symbol: string, interval: CandleInterval, candles: CandleData[], range: HistoricalRange) => void;
+    hasHistoricalPriceData: (symbol: string, interval: CandleInterval, startTime: number, endTime: number) => boolean;
+    getHistoricalPriceData: (symbol: string, interval: CandleInterval, startTime: number, endTime: number) => CandleData[];
+    setTokenLoading: (symbol: string, loading: boolean) => void;
+    isTokenLoading: (symbol: string) => boolean;
+    removeTokenPriceData: (symbol: string, interval: CandleInterval) => void;
+    clearData: () => void;
+}
+export declare const useHistoricalPriceDataStore: import("zustand").UseBoundStore<import("zustand").StoreApi<HistoricalPriceDataState>>;
 export type { HistoricalRange, TokenHistoricalPriceData };

package/dist/store/hyperliquidDataStore.d.ts

@@ -1 +1,31 @@
-export declare const useHyperliquidData: any;
+import { ActiveAssetData, CandleChartData, CandleData, ClearinghouseState, UniverseAsset, WebData3AssetCtx, WsAllMidsData } from '../types';
+interface HyperliquidDataState {
+    allMids: WsAllMidsData | null;
+    activeAssetData: Record<string, ActiveAssetData> | null;
+    candleData: CandleChartData | null;
+    finalAssetContexts: WebData3AssetCtx[] | null;
+    finalAtOICaps: string[] | null;
+    aggregatedClearingHouseState: ClearinghouseState | null;
+    rawClearinghouseStates: [string, ClearinghouseState][] | null;
+    perpMetaAssets: UniverseAsset[] | null;
+    allPerpMetaAssets: UniverseAsset[] | null;
+    hip3Assets: Map<string, string[]>;
+    hip3MarketPrefixes: Map<string, string>;
+    setAllMids: (value: WsAllMidsData | null) => void;
+    setActiveAssetData: (value: Record<string, ActiveAssetData> | null | ((prev: Record<string, ActiveAssetData> | null) => Record<string, ActiveAssetData> | null)) => void;
+    deleteActiveAssetData: (key: string) => void;
+    addCandleData: (symbol: string, candle: CandleData) => void;
+    deleteCandleSymbol: (symbol: string) => void;
+    setCandleData: (value: CandleChartData | null) => void;
+    upsertActiveAssetData: (key: string, value: ActiveAssetData) => void;
+    setFinalAssetContexts: (value: WebData3AssetCtx[] | null) => void;
+    setFinalAtOICaps: (value: string[] | null) => void;
+    setAggregatedClearingHouseState: (value: ClearinghouseState | null) => void;
+    setRawClearinghouseStates: (value: [string, ClearinghouseState][] | null) => void;
+    setPerpMetaAssets: (value: UniverseAsset[] | null) => void;
+    setAllPerpMetaAssets: (value: UniverseAsset[] | null) => void;
+    setHip3Assets: (value: Map<string, string[]>) => void;
+    setHip3MarketPrefixes: (value: Map<string, string>) => void;
+}
+export declare const useHyperliquidData: import("zustand").UseBoundStore<import("zustand").StoreApi<HyperliquidDataState>>;
+export {};

package/dist/store/marketDataStore.d.ts

@@ -1 +1,10 @@
-export declare const useMarketData: any;
+import type { ActiveAssetsAllResponse, ActiveAssetsResponse } from '../types';
+interface MarketDataState {
+    marketData: ActiveAssetsResponse | null;
+    marketDataAll: ActiveAssetsAllResponse | null;
+    setMarketData: (value: ActiveAssetsResponse | null) => void;
+    setMarketDataAll: (value: ActiveAssetsAllResponse | null) => void;
+    clean: () => void;
+}
+export declare const useMarketData: import("zustand").UseBoundStore<import("zustand").StoreApi<MarketDataState>>;
+export {};

package/dist/store/tokenSelectionMetadataStore.d.ts

@@ -24,4 +24,4 @@ export interface TokenSelectionMetadataState {
         shortTokens: TokenSelection[];
     }) => void;
 }
-export declare const useTokenSelectionMetadataStore: any;
+export declare const useTokenSelectionMetadataStore: import("zustand").UseBoundStore<import("zustand").StoreApi<TokenSelectionMetadataState>>;

package/dist/store/userDataStore.d.ts

@@ -1 +1,30 @@
-export declare const useUserData: any;
+import { PlatformAccountSummaryResponseDto, OpenLimitOrderDto, RawPositionDto, TradeHistoryDataDto, TwapMonitoringDto, NotificationDto, ExtraAgent, SpotState } from "../types";
+interface UserDataState {
+    accessToken: string | null;
+    refreshToken: string | null;
+    isAuthenticated: boolean;
+    address: string | null;
+    tradeHistories: TradeHistoryDataDto[] | null;
+    rawOpenPositions: RawPositionDto[] | null;
+    openOrders: OpenLimitOrderDto[] | null;
+    accountSummary: PlatformAccountSummaryResponseDto | null;
+    twapDetails: TwapMonitoringDto[] | null;
+    notifications: NotificationDto[] | null;
+    userExtraAgents: ExtraAgent[] | null;
+    spotState: SpotState | null;
+    setAccessToken: (token: string | null) => void;
+    setRefreshToken: (token: string | null) => void;
+    setIsAuthenticated: (value: boolean) => void;
+    setAddress: (address: string | null) => void;
+    setTradeHistories: (value: TradeHistoryDataDto[] | null) => void;
+    setRawOpenPositions: (value: RawPositionDto[] | null) => void;
+    setOpenOrders: (value: OpenLimitOrderDto[] | null) => void;
+    setAccountSummary: (value: PlatformAccountSummaryResponseDto | null) => void;
+    setUserExtraAgents: (value: ExtraAgent[] | null) => void;
+    setTwapDetails: (value: TwapMonitoringDto[] | null) => void;
+    setNotifications: (value: NotificationDto[] | null) => void;
+    setSpotState: (value: SpotState | null) => void;
+    clean: () => void;
+}
+export declare const useUserData: import("zustand").UseBoundStore<import("zustand").StoreApi<UserDataState>>;
+export {};

package/dist/store/userSelection.d.ts

@@ -23,5 +23,5 @@ interface UserSelectionState {
     setTokenSelections: (longTokens: TokenSelection[], shortTokens: TokenSelection[]) => void;
     resetToDefaults: () => void;
 }
-export declare const useUserSelection: any;
+export declare const useUserSelection: import("zustand").UseBoundStore<import("zustand").StoreApi<UserSelectionState>>;
 export type { UserSelectionState };

package/dist/types.d.ts

@@ -20,7 +20,7 @@ export interface ExternalFillDto {
     coin: string;
     px: string;
     sz: string;
-    side: "B" | "A";
+    side: 'B' | 'A';
     time: number;
     dir: string;
     fee: string;
@@ -52,7 +52,7 @@ export interface TwapSliceFillResponseItem {
 /**
  * WebSocket connection states
  */
-export type WebSocketConnectionState = "connecting" | "connected" | "disconnected" | "error";
+export type WebSocketConnectionState = 'connecting' | 'connected' | 'disconnected' | 'error';
 export declare enum ReadyState {
     CONNECTING = 0,
     OPEN = 1,
@@ -62,12 +62,12 @@ 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" | "webData3" | "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
  */
 export interface WebSocketSubscribeMessage {
-    action?: "subscribe" | "unsubscribe";
+    action?: 'subscribe' | 'unsubscribe';
     address: string;
 }
 /**
@@ -97,7 +97,7 @@ export interface WatchlistItemDto {
 export interface ToggleWatchlistResponseDto {
     items: WatchlistItemDto[];
 }
-export type NotificationCategory = "TRADE_OPENED_OUTSIDE_PEAR" | "TRADE_CLOSED_OUTSIDE_PEAR" | "POSITION_LIQUIDATED" | "LIMIT_ORDER_FILLED" | "LIMIT_ORDER_FAILED" | "TP_ORDER_FILLED" | "TP_ORDER_FAILED" | "SL_ORDER_FILLED" | "SL_ORDER_FAILED";
+export type NotificationCategory = 'TRADE_OPENED_OUTSIDE_PEAR' | 'TRADE_CLOSED_OUTSIDE_PEAR' | 'POSITION_LIQUIDATED' | 'LIMIT_ORDER_FILLED' | 'LIMIT_ORDER_FAILED' | 'TP_ORDER_FILLED' | 'TP_ORDER_FAILED' | 'SL_ORDER_FILLED' | 'SL_ORDER_FAILED';
 export interface NotificationDto {
     id: string;
     address: string;
@@ -114,7 +114,7 @@ export interface ChunkFillDto {
     size: number;
     executedAt: string;
 }
-export type TwapChunkStatus = "PENDING" | "SCHEDULED" | "EXECUTING" | "COMPLETED" | "FAILED" | "CANCELLED";
+export type TwapChunkStatus = 'PENDING' | 'SCHEDULED' | 'EXECUTING' | 'COMPLETED' | 'FAILED' | 'CANCELLED';
 export interface TwapChunkStatusDto {
     chunkId: string;
     chunkIndex: number;
@@ -125,7 +125,7 @@ export interface TwapChunkStatusDto {
     fills: ChunkFillDto[];
     errorMessage?: string;
 }
-export type TwapOrderOverallStatus = "OPEN" | "EXECUTING" | "COMPLETED" | "PARTIALLY_COMPLETED" | "FAILED" | "CANCELLED";
+export type TwapOrderOverallStatus = 'OPEN' | 'EXECUTING' | 'COMPLETED' | 'PARTIALLY_COMPLETED' | 'FAILED' | 'CANCELLED';
 export interface TwapMonitoringDto {
     orderId: string;
     positionId?: string;
@@ -162,6 +162,8 @@ export interface TradeHistoryAssetDataDto {
     externalFeePaid: number;
     builderFeePaid: number;
     realizedPnl: number;
+    marketPrefix?: string | null;
+    collateralToken?: CollateralToken;
 }
 /**
  * Trade history data structure
@@ -210,10 +212,15 @@ export interface PositionAssetDetailDto {
     liquidationPrice: number;
     initialWeight: number;
     fundingPaid?: number;
+    marketPrefix?: string | null;
+    collateralToken?: CollateralToken;
 }
 export interface TpSlThreshold {
-    type: "PERCENTAGE" | "DOLLAR" | "POSITION_VALUE";
+    type: 'PERCENTAGE' | 'DOLLAR' | 'POSITION_VALUE' | 'PRICE' | 'PRICE_RATIO' | 'WEIGHTED_RATIO';
     value: number;
+    isTrailing?: boolean;
+    trailingDeltaValue?: number;
+    trailingActivationValue?: number;
 }
 /**
  * Open position data structure
@@ -243,38 +250,96 @@ export interface OpenPositionDto {
 export interface OrderAssetDto {
     asset: string;
     weight: number;
+    marketPrefix?: string | null;
+    collateralToken?: CollateralToken;
 }
 /**
  * Order status
  */
-export type OrderStatus = "OPEN" | "PARTIALLY_FILLED" | "PROCESSING";
+export type OrderStatus = 'OPEN' | 'PROCESSING' | 'EXECUTED' | 'CANCELLED' | 'FAILED' | 'PARTIALLY_FILLED';
 /**
  * Order type
  */
-export type OrderType = "TP" | "SL" | "LIMIT" | "MARKET" | "LIMIT_BTCDOM" | "TWAP";
+export type OrderType = 'SYNC' | 'MARKET' | 'TRIGGER' | 'TWAP' | 'LADDER' | 'TP' | 'SL' | 'SPOT_MARKET' | 'SPOT_LIMIT' | 'SPOT_TWAP';
 /**
  * TP/SL trigger type
  */
-export type TpSlTriggerType = "PERCENTAGE" | "DOLLAR" | "POSITION_VALUE";
-export type OrderDirection = "MORE_THAN" | "LESS_THAN" | null;
+export type TpSlTriggerType = 'PERCENTAGE' | 'DOLLAR' | 'POSITION_VALUE' | 'PRICE' | 'PRICE_RATIO' | 'WEIGHTED_RATIO';
+/**
+ * Trigger type for trigger orders
+ */
+export type TriggerType = 'PRICE' | 'PRICE_RATIO' | 'WEIGHTED_RATIO' | 'BTC_DOM' | 'CROSS_ASSET_PRICE' | 'PREDICTION_MARKET_OUTCOME';
+export type OrderDirection = 'MORE_THAN' | 'LESS_THAN';
+/**
+ * Market order parameters
+ */
+export interface MarketOrderParameters {
+    leverage?: number;
+    usdValue: number;
+    reduceOnly?: boolean;
+}
+/**
+ * Trigger order parameters
+ */
+export interface TriggerOrderParameters {
+    leverage: number;
+    usdValue: number;
+    triggerType: TriggerType;
+    triggerValue: number;
+    direction: OrderDirection;
+    reduceOnly?: boolean;
+    assetName?: string;
+    marketCode?: string;
+}
+/**
+ * TWAP order parameters
+ */
+export interface TwapOrderParameters {
+    leverage: number;
+    usdValue: number;
+    duration: string;
+    intervalSeconds?: number;
+    chunkUsdValue: number;
+    randomizeExecution?: boolean;
+    reduceOnly?: boolean;
+}
+/**
+ * TP/SL order parameters
+ */
+export interface TpSlOrderParameters {
+    triggerType: TpSlTriggerType;
+    triggerValue: number;
+    isTrailing?: boolean;
+    trailingDeltaValue?: number;
+    trailingActivationValue?: number;
+    reduceOnly?: boolean;
+}
+/**
+ * Ladder order parameters
+ */
+export interface LadderOrderParameters {
+    leverage: number;
+    usdValue: number;
+    ratioStart: number;
+    ratioEnd: number;
+    numberOfLevels: number;
+    reduceOnly?: boolean;
+}
+/**
+ * Union type for all order parameters
+ */
+export type OrderParameters = MarketOrderParameters | TriggerOrderParameters | TwapOrderParameters | TpSlOrderParameters | LadderOrderParameters;
 /**
  * Open limit order data structure
  */
 export interface OpenLimitOrderDto {
     orderId: string;
     address: string;
-    clientId: string | null;
+    clientId?: string | null;
     positionId?: string | null;
-    leverage: number;
-    usdValue: number;
-    triggerValue?: number | null;
-    twapDuration?: string | null;
-    tpSlTriggerType?: TpSlTriggerType | null;
-    randomizeFlag: boolean;
-    reduceOnlyFlag: boolean;
-    status: OrderStatus;
+    parameters: OrderParameters;
     orderType: OrderType;
-    direction?: OrderDirection | null;
+    status: OrderStatus;
     longAssets: OrderAssetDto[];
     shortAssets: OrderAssetDto[];
     createdAt: string;
@@ -370,7 +435,7 @@ export interface PrivyAuthDetails {
     accessToken: string;
 }
 export interface AuthenticateRequest {
-    method: "eip712" | "api_key" | "privy_access_token";
+    method: 'eip712' | 'api_key' | 'privy_access_token';
     address: string;
     clientId: string;
     details: {
@@ -403,7 +468,7 @@ export interface LogoutRequest {
 export interface LogoutResponse {
     message: string;
 }
-export type AgentWalletStatus = "ACTIVE" | "EXPIRED" | "NOT_FOUND";
+export type AgentWalletStatus = 'ACTIVE' | 'EXPIRED' | 'NOT_FOUND';
 export interface GetAgentWalletResponseDto {
     agentWalletAddress?: string;
     agentName: string;
@@ -421,14 +486,14 @@ export interface ExtraAgent {
 export interface AgentWalletState {
     address: string | null;
     name: string | null;
-    status: AgentWalletStatus | "PENDING" | null;
+    status: AgentWalletStatus | 'PENDING' | null;
     isActive: boolean;
 }
 /**
  * WebSocket message from HyperLiquid native API
  */
 export interface WebSocketMessage {
-    method: "subscribe" | "unsubscribe";
+    method: 'subscribe' | 'unsubscribe';
     subscription: {
         type: string;
         dex?: string;
@@ -441,14 +506,19 @@ export interface WebSocketMessage {
 /**
  * WebSocket response from HyperLiquid native API
  */
-export type HLChannel = "webData3" | "allMids" | "activeAssetData" | "candle" | "allDexsClearinghouseState" | "allDexsAssetCtxs";
+export type HLChannel = 'webData3' | 'allMids' | 'activeAssetData' | 'candle' | 'spotState' | 'allDexsClearinghouseState' | 'allDexsAssetCtxs' | 'userFills';
 export interface HLChannelDataMap {
     webData3: WebData3Response;
     allMids: WsAllMidsData;
     activeAssetData: ActiveAssetData;
     candle: CandleData;
+    spotState: {
+        user: string;
+        spotState: SpotState;
+    };
     allDexsClearinghouseState: AllDexsClearinghouseStateData;
     allDexsAssetCtxs: AllDexsAssetCtxsData;
+    userFills: any;
 }
 export interface WebData3UserState {
     agentAddress?: string;
@@ -511,6 +581,12 @@ export interface AssetCtx {
     impactPxs?: string[];
     oraclePx: string;
 }
+/**
+ * Collateral token type
+ * 0 = USDC
+ * 360 = USDH
+ */
+export type CollateralToken = 'USDC' | 'USDH';
 /**
  * Universe asset metadata
  */
@@ -520,6 +596,8 @@ export interface UniverseAsset {
     maxLeverage: number;
     onlyIsolated?: boolean;
     isDelisted?: boolean;
+    marketPrefix?: string;
+    collateralToken?: CollateralToken;
 }
 export interface PerpMetaAsset extends UniverseAsset {
     marginTableId: number;
@@ -608,6 +686,8 @@ export interface RawAssetDto {
     size: number;
     side: string;
     fundingPaid?: number;
+    marketPrefix?: string | null;
+    collateralToken?: CollateralToken;
     leverage: number;
 }
 /**
@@ -656,6 +736,7 @@ export interface TokenMetadata {
     leverage?: LeverageInfo;
     maxTradeSzs?: [string, string];
     availableToTrade?: [string, string];
+    collateralToken?: CollateralToken;
 }
 /**
  * Enhanced token selection with weight and metadata for basket trading
@@ -669,16 +750,37 @@ export interface TokenSelection {
  */
 export interface TokenConflict {
     symbol: string;
-    conflictType: "long" | "short";
+    conflictType: 'long' | 'short';
     conflictMessage: string;
 }
 export interface AssetMarketData {
     asset: WebData3AssetCtx | AssetCtx;
     universe: UniverseAsset;
 }
+/**
+ * Nested market data structure for multi-market assets.
+ * Each symbol maps to its market variants (keyed by prefix).
+ * For non-HIP3 assets, use "default" as the key.
+ *
+ * @example
+ * ```ts
+ * {
+ *   "TSLA": {
+ *     "xyz": { asset: {...}, universe: { collateralToken: "USDC", ... } },
+ *     "flx": { asset: {...}, universe: { collateralToken: "USDH", ... } }
+ *   },
+ *   "BTC": {
+ *     "default": { asset: {...}, universe: {...} }
+ *   }
+ * }
+ * ```
+ */
+export type MarketDataBySymbol = Record<string, Record<string, AssetMarketData>>;
 export interface PairAssetDto {
     asset: string;
     weight: number;
+    collateralToken: CollateralToken;
+    marketPrefix: string | null;
 }
 export interface ActiveAssetGroupItem {
     longAssets: PairAssetDto[];
@@ -692,6 +794,7 @@ export interface ActiveAssetGroupItem {
     weightedRatio?: string;
     weightedPrevRatio?: string;
     weightedChange24h?: string;
+    collateralType: 'USDC' | 'USDH' | 'MIXED';
 }
 export interface ActiveAssetsResponse {
     active: ActiveAssetGroupItem[];
@@ -709,7 +812,7 @@ export interface ActiveAssetsAllResponse {
 /**
  * Candle interval options
  */
-export type CandleInterval = "1m" | "3m" | "5m" | "15m" | "30m" | "1h" | "2h" | "4h" | "8h" | "12h" | "1d" | "3d" | "1w" | "1M";
+export type CandleInterval = '1m' | '3m' | '5m' | '15m' | '30m' | '1h' | '2h' | '4h' | '8h' | '12h' | '1d' | '3d' | '1w' | '1M';
 /**
  * Candle data structure from WebSocket
  */
@@ -737,9 +840,23 @@ export interface CandleSnapshotRequest {
         endTime: number;
         interval: CandleInterval;
     };
-    type: "candleSnapshot";
+    type: 'candleSnapshot';
 }
 export interface TokenSelectorConfig {
     isLong: boolean;
     index: number;
 }
+export interface SpotBalance {
+    coin: string;
+    token: number;
+    total: string;
+    hold: string;
+    entryNtl: string;
+}
+export interface SpotState {
+    user: string;
+    balances: SpotBalance[];
+}
+export interface EnrichedOpenLimitOrderDto extends OpenLimitOrderDto {
+    marketTitle?: string;
+}

package/dist/utils/order-helpers.d.ts

@@ -0,0 +1,57 @@
+import type { OpenLimitOrderDto, TpSlTriggerType, TriggerType, OrderDirection } from '../types';
+/**
+ * Helper functions to safely extract values from order parameters
+ * based on the order type and parameter structure.
+ */
+/**
+ * Get leverage from order parameters (available for Market, Trigger, Twap, Ladder orders)
+ */
+export declare function getOrderLeverage(order: OpenLimitOrderDto): number | undefined;
+/**
+ * Get USD value from order parameters (available for Market, Trigger, Twap, Ladder orders)
+ */
+export declare function getOrderUsdValue(order: OpenLimitOrderDto): number | undefined;
+/**
+ * Get trigger value from order parameters (available for TP/SL and Trigger orders)
+ */
+export declare function getOrderTriggerValue(order: OpenLimitOrderDto): number | undefined;
+/**
+ * Get TP/SL trigger type from order parameters (only for TP/SL orders)
+ */
+export declare function getOrderTpSlTriggerType(order: OpenLimitOrderDto): TpSlTriggerType | undefined;
+/**
+ * Get trigger type from order parameters (for Trigger orders)
+ */
+export declare function getOrderTriggerType(order: OpenLimitOrderDto): TriggerType | undefined;
+/**
+ * Get order direction from order parameters (for Trigger orders)
+ */
+export declare function getOrderDirection(order: OpenLimitOrderDto): OrderDirection | undefined;
+/**
+ * Get reduce only flag from order parameters (available for all order types)
+ */
+export declare function getOrderReduceOnly(order: OpenLimitOrderDto): boolean;
+/**
+ * Get TWAP duration from order parameters (only for TWAP orders)
+ */
+export declare function getOrderTwapDuration(order: OpenLimitOrderDto): string | undefined;
+/**
+ * Get ladder config from order parameters (only for Ladder orders)
+ */
+export declare function getOrderLadderConfig(order: OpenLimitOrderDto): {
+    ratioStart: number;
+    ratioEnd: number;
+    numberOfLevels: number;
+} | undefined;
+/**
+ * Check if the order is a BTC Dominance trigger order
+ */
+export declare function isBtcDomOrder(order: OpenLimitOrderDto): boolean;
+/**
+ * Get trailing info from TP/SL order parameters
+ */
+export declare function getOrderTrailingInfo(order: OpenLimitOrderDto): {
+    isTrailing: boolean;
+    trailingDeltaValue?: number;
+    trailingActivationValue?: number;
+} | undefined;

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

@@ -5,7 +5,36 @@ 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")
+ * For multi-market assets, returns the first available market.
+ * @param displaySymbol e.g., "TSLA"
+ * @param hip3Assets map of display -> all full market names (e.g., "TSLA" -> ["xyz:TSLA", "flx:TSLA"])
  */
-export declare function toBackendSymbol(displaySymbol: string, displayToFull: Map<string, string>): string;
+export declare function toBackendSymbol(displaySymbol: string, hip3Assets: Map<string, string[]>): string;
+/**
+ * Convert a display symbol to backend form for a specific market prefix.
+ * This is useful when an asset is available on multiple markets (e.g., xyz:TSLA and flx:TSLA).
+ * @param displaySymbol e.g., "TSLA"
+ * @param marketPrefix e.g., "xyz" or "flx"
+ * @param hip3Assets map of display -> all full market names
+ * @returns Full market name if found, null if prefix not specified for multi-market asset, otherwise displaySymbol with prefix
+ */
+export declare function toBackendSymbolWithMarket(displaySymbol: string, marketPrefix: string | undefined, hip3Assets: Map<string, string[]>): string | null;
+/**
+ * Get all available markets for a display symbol.
+ * @param displaySymbol e.g., "TSLA"
+ * @param hip3Assets map of display -> all full market names
+ * @returns Array of full market names, e.g., ["xyz:TSLA", "flx:TSLA"]
+ */
+export declare function getAvailableMarkets(displaySymbol: string, hip3Assets: Map<string, string[]>): string[];
+/**
+ * Extract the market prefix from a full market name.
+ * @param fullSymbol e.g., "xyz:TSLA"
+ * @returns The prefix (e.g., "xyz") or undefined if no prefix
+ */
+export declare function getMarketPrefix(fullSymbol: string): string | undefined;
+/**
+ * Check if a symbol is a HIP-3 market (has a prefix).
+ * @param symbol e.g., "xyz:TSLA" or "TSLA"
+ * @returns true if the symbol has a market prefix
+ */
+export declare function isHip3Market(symbol: string): boolean;

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

@@ -5,24 +5,28 @@ import type { WsAllMidsData, TokenMetadata, ActiveAssetData, UniverseAsset, WebD
 export declare class TokenMetadataExtractor {
     /**
      * Extracts comprehensive token metadata
-     * @param symbol - Token symbol
+     * @param symbol - Token symbol (base symbol without prefix, e.g., "TSLA")
      * @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
+     * @param marketPrefix - Optional market prefix (e.g., "xyz", "flx") for HIP3 multi-market assets
      * @returns TokenMetadata or null if token not found
      */
-    static extractTokenMetadata(symbol: string, perpMetaAssets: UniverseAsset[] | null, finalAssetContexts: WebData3AssetCtx[] | 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, marketPrefix?: string | null): TokenMetadata | null;
     /**
      * Extracts metadata for multiple tokens
-     * @param symbols - Array of token symbols
+     * @param tokens - Array of token objects with symbol and optional marketPrefix
      * @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
+     * @returns Record of unique key to TokenMetadata. Key is "{prefix}:{symbol}" for HIP3 assets, or just "{symbol}" otherwise
      */
-    static extractMultipleTokensMetadata(symbols: string[], perpMetaAssets: UniverseAsset[] | null, finalAssetContexts: WebData3AssetCtx[] | null, allMids: WsAllMidsData | null, activeAssetData?: Record<string, ActiveAssetData> | null): Record<string, TokenMetadata | null>;
+    static extractMultipleTokensMetadata(tokens: Array<{
+        symbol: string;
+        marketPrefix?: string | null;
+    }>, 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 aggregated universe assets
      * @param symbol - Token symbol

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pear-protocol/hyperliquid-sdk",
-  "version": "0.0.72",
+  "version": "0.0.73-beta-2",
   "description": "React SDK for Pear Protocol Hyperliquid API integration",
   "type": "module",
   "main": "dist/index.js",
@@ -24,7 +24,8 @@
     "clean": "rimraf dist"
   },
   "dependencies": {
-    "axios": "^1.6.0"
+    "axios": "^1.6.0",
+    "zustand": "^5.0.9"
   },
   "peerDependencies": {
     "react": "^18.0.0",

package/dist/hooks/useAutoSyncFills.d.ts

@@ -1,19 +0,0 @@
-import type { SyncFillsResponseDto } from '../types';
-export interface AutoSyncFillsOptions {
-    baseUrl: string;
-    address: string | null;
-    intervalMs?: number;
-    aggregateByTime?: boolean;
-}
-export interface AutoSyncFillsState {
-    lastRunAt: number | null;
-    lastResult: SyncFillsResponseDto | null;
-    error: string | null;
-    isSyncing: boolean;
-    triggerSync: () => Promise<void>;
-}
-/**
- * Listens to address changes and periodically syncs user fills
- * Defaults: aggregate=true, interval=60s
- */
-export declare function useAutoSyncFills(options: AutoSyncFillsOptions): AutoSyncFillsState;