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

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;

package/dist/types.d.ts

@@ -210,6 +210,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 +429,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 +503,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 +518,8 @@ export interface UniverseAsset {
     maxLeverage: number;
     onlyIsolated?: boolean;
     isDelisted?: boolean;
+    marketPrefix?: string;
+    collateralToken?: CollateralToken;
 }
 export interface PerpMetaAsset extends UniverseAsset {
     marginTableId: number;
@@ -645,6 +655,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 +676,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 +713,7 @@ export interface ActiveAssetGroupItem {
     weightedRatio?: string;
     weightedPrevRatio?: string;
     weightedChange24h?: string;
+    collateralType: 'USDC' | 'USDH' | 'MIXED';
 }
 export interface ActiveAssetsResponse {
     active: ActiveAssetGroupItem[];
@@ -698,7 +731,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 +759,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.59",
+  "version": "0.0.60-beta-usdh",
   "description": "React SDK for Pear Protocol Hyperliquid API integration",
   "type": "module",
   "main": "dist/index.js",