@pear-protocol/hyperliquid-sdk 0.0.60-beta → 0.0.60-beta-usdh-1

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,16 +10,5 @@ interface TokenHistoricalPriceData {
     oldestTime: number | null;
     latestTime: number | null;
 }
-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 declare const useHistoricalPriceDataStore: any;
 export type { HistoricalRange, TokenHistoricalPriceData };

package/dist/store/hyperliquidDataStore.d.ts

@@ -1,25 +1 @@
-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;
-    perpMetaAssets: UniverseAsset[] | null;
-    hip3DisplayToFull: 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;
-    setPerpMetaAssets: (value: UniverseAsset[] | null) => void;
-    setHip3DisplayToFull: (value: Map<string, string>) => void;
-}
-export declare const useHyperliquidData: import("zustand").UseBoundStore<import("zustand").StoreApi<HyperliquidDataState>>;
-export {};
+export declare const useHyperliquidData: any;

package/dist/store/marketDataStore.d.ts

@@ -1,10 +1 @@
-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 {};
+export declare const useMarketData: any;

package/dist/store/tokenSelectionMetadataStore.d.ts

@@ -1,4 +1,4 @@
-import type { ActiveAssetData, TokenSelection, TokenMetadata, WsAllMidsData, ActiveAssetsResponse, UniverseAsset, WebData3AssetCtx } from "../types";
+import type { ActiveAssetData, TokenSelection, TokenMetadata, WsAllMidsData, ActiveAssetsResponse, UniverseAsset, WebData3AssetCtx } from '../types';
 export interface TokenSelectionMetadataState {
     isPriceDataReady: boolean;
     isLoading: boolean;
@@ -24,4 +24,4 @@ export interface TokenSelectionMetadataState {
         shortTokens: TokenSelection[];
     }) => void;
 }
-export declare const useTokenSelectionMetadataStore: import("zustand").UseBoundStore<import("zustand").StoreApi<TokenSelectionMetadataState>>;
+export declare const useTokenSelectionMetadataStore: any;

package/dist/store/userDataStore.d.ts

@@ -1,28 +1 @@
-import { PlatformAccountSummaryResponseDto, OpenLimitOrderDto, RawPositionDto, TradeHistoryDataDto, TwapMonitoringDto, NotificationDto, ExtraAgent } 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;
-    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;
-    clean: () => void;
-}
-export declare const useUserData: import("zustand").UseBoundStore<import("zustand").StoreApi<UserDataState>>;
-export {};
+export declare const useUserData: any;

package/dist/store/userSelection.d.ts

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

package/dist/types.d.ts

@@ -162,6 +162,8 @@ export interface TradeHistoryAssetDataDto {
     externalFeePaid: number;
     builderFeePaid: number;
     realizedPnl: number;
+    marketPrefix?: string | null;
+    collateralToken?: CollateralToken;
 }
 /**
  * Trade history data structure
@@ -210,6 +212,8 @@ export interface PositionAssetDetailDto {
     liquidationPrice: number;
     initialWeight: number;
     fundingPaid?: number;
+    marketPrefix?: string | null;
+    collateralToken?: CollateralToken;
 }
 export interface TpSlThreshold {
     type: 'PERCENTAGE' | 'DOLLAR' | 'POSITION_VALUE';
@@ -427,7 +431,7 @@ export interface AgentWalletState {
  * WebSocket message from HyperLiquid native API
  */
 export interface WebSocketMessage {
-    method: "subscribe" | "unsubscribe";
+    method: 'subscribe' | 'unsubscribe';
     subscription: {
         type: string;
         dex?: string;
@@ -501,6 +505,12 @@ export interface AssetCtx {
     impactPxs?: string[];
     oraclePx: string;
 }
+/**
+ * Collateral token type
+ * 0 = USDC
+ * 360 = USDH
+ */
+export type CollateralToken = 'USDC' | 'USDH';
 /**
  * Universe asset metadata
  */
@@ -510,6 +520,8 @@ export interface UniverseAsset {
     maxLeverage: number;
     onlyIsolated?: boolean;
     isDelisted?: boolean;
+    marketPrefix?: string;
+    collateralToken?: CollateralToken;
 }
 export interface PerpMetaAsset extends UniverseAsset {
     marginTableId: number;
@@ -645,6 +657,7 @@ export interface TokenMetadata {
     leverage?: LeverageInfo;
     maxTradeSzs?: [string, string];
     availableToTrade?: [string, string];
+    collateralToken?: CollateralToken;
 }
 /**
  * Enhanced token selection with weight and metadata for basket trading
@@ -665,9 +678,30 @@ 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[];
@@ -681,6 +715,7 @@ export interface ActiveAssetGroupItem {
     weightedRatio?: string;
     weightedPrevRatio?: string;
     weightedChange24h?: string;
+    collateralType: 'USDC' | 'USDH' | 'MIXED';
 }
 export interface ActiveAssetsResponse {
     active: ActiveAssetGroupItem[];
@@ -698,7 +733,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
  */
@@ -726,7 +761,7 @@ export interface CandleSnapshotRequest {
         endTime: number;
         interval: CandleInterval;
     };
-    type: "candleSnapshot";
+    type: 'candleSnapshot';
 }
 export interface TokenSelectorConfig {
     isLong: boolean;

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.60-beta",
+  "version": "0.0.60-beta-usdh-1",
   "description": "React SDK for Pear Protocol Hyperliquid API integration",
   "type": "module",
   "main": "dist/index.js",
@@ -24,8 +24,7 @@
     "clean": "rimraf dist"
   },
   "dependencies": {
-    "axios": "^1.6.0",
-    "zustand": "^5.0.8"
+    "axios": "^1.6.0"
   },
   "peerDependencies": {
     "react": "^18.0.0",