@pear-protocol/hyperliquid-sdk 0.0.79 → 0.1.2

package/dist/store/hyperliquidDataStore.d.ts

@@ -1,4 +1,5 @@
-import { ActiveAssetData, CandleChartData, CandleData, ClearinghouseState, UniverseAsset, WebData3AssetCtx, WsAllMidsData } from '../types';
+import { ActiveAssetData, CandleChartData, CandleData, ClearinghouseState, UniverseAsset, WebData3AssetCtx, WsAllMidsData, PerpDexsResponse } from '../types';
+import { TokenMetadataBySymbol } from '../utils/token-metadata-extractor';
 interface HyperliquidDataState {
     allMids: WsAllMidsData | null;
     activeAssetData: Record<string, ActiveAssetData> | null;
@@ -8,9 +9,10 @@ interface HyperliquidDataState {
     aggregatedClearingHouseState: ClearinghouseState | null;
     rawClearinghouseStates: [string, ClearinghouseState][] | null;
     perpMetaAssets: UniverseAsset[] | null;
-    allPerpMetaAssets: UniverseAsset[] | null;
-    hip3Assets: Map<string, string[]>;
-    hip3MarketPrefixes: Map<string, string>;
+    tokenMetadata: TokenMetadataBySymbol;
+    perpDexs: PerpDexsResponse | null;
+    perpMetasByDex: Map<string, UniverseAsset[]> | null;
+    assetContextsByDex: Map<string, WebData3AssetCtx[]> | null;
     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;
@@ -23,9 +25,9 @@ interface HyperliquidDataState {
     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;
+    setPerpDexs: (value: PerpDexsResponse | null) => void;
+    setPerpMetasByDex: (value: Map<string, UniverseAsset[]> | null) => void;
+    setAssetContextsByDex: (value: Map<string, WebData3AssetCtx[]> | null) => void;
 }
 export declare const useHyperliquidData: import("zustand").UseBoundStore<import("zustand").StoreApi<HyperliquidDataState>>;
 export {};

package/dist/store/marketDataStore.d.ts

@@ -1,9 +1,7 @@
-import type { ActiveAssetsAllResponse, ActiveAssetsResponse } from '../types';
+import type { 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>>;

package/dist/store/tokenSelectionMetadataStore.d.ts

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

package/dist/types.d.ts

@@ -207,8 +207,7 @@ export interface TradeHistoryAssetDataDto {
     externalFeePaid: number;
     builderFeePaid: number;
     realizedPnl: number;
-    marketPrefix?: string | null;
-    collateralToken?: CollateralToken;
+    metadata?: TokenMetadata | null;
 }
 /**
  * Trade history data structure
@@ -257,8 +256,7 @@ export interface PositionAssetDetailDto {
     liquidationPrice: number;
     initialWeight: number;
     fundingPaid?: number;
-    marketPrefix?: string | null;
-    collateralToken?: CollateralToken;
+    metadata?: TokenMetadata | null;
 }
 export interface TpSlThreshold {
     type: 'PERCENTAGE' | 'DOLLAR' | 'POSITION_VALUE' | 'PRICE' | 'PRICE_RATIO' | 'WEIGHTED_RATIO';
@@ -295,8 +293,7 @@ export interface OpenPositionDto {
 export interface OrderAssetDto {
     asset: string;
     weight: number;
-    marketPrefix?: string | null;
-    collateralToken?: CollateralToken;
+    metadata?: TokenMetadata | null;
 }
 /**
  * Order status
@@ -631,8 +628,10 @@ export interface AssetCtx {
  * Collateral token type
  * 0 = USDC
  * 360 = USDH
+ * 235 = USDE
+ * 268 = USDT
  */
-export type CollateralToken = 'USDC' | 'USDH';
+export type CollateralToken = 'USDC' | 'USDH' | 'USDE' | 'USDT';
 /**
  * Universe asset metadata
  */
@@ -642,8 +641,7 @@ export interface UniverseAsset {
     maxLeverage: number;
     onlyIsolated?: boolean;
     isDelisted?: boolean;
-    marketPrefix?: string;
-    collateralToken?: CollateralToken;
+    collateralToken: CollateralToken;
 }
 export interface PerpMetaAsset extends UniverseAsset {
     marginTableId: number;
@@ -732,8 +730,6 @@ export interface RawAssetDto {
     size: number;
     side: string;
     fundingPaid?: number;
-    marketPrefix?: string | null;
-    collateralToken?: CollateralToken;
     leverage: number;
 }
 /**
@@ -769,6 +765,10 @@ export interface ActiveAssetData {
     markPx: string;
 }
 export interface TokenMetadata {
+    assetName: string;
+    symbolName: string;
+    marketName: string;
+    isAtOiCaps: boolean;
     currentPrice: number;
     prevDayPrice: number;
     priceChange24h: number;
@@ -803,30 +803,9 @@ 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[];
@@ -903,3 +882,20 @@ export interface SpotState {
     user: string;
     balances: SpotBalance[];
 }
+export interface TokenEntry {
+    symbol: string;
+    data: AssetMarketData;
+}
+export interface PerpDex {
+    name: string;
+    fullName: string;
+    deployer: string;
+    oracleUpdater: string | null;
+    feeRecipient: string | null;
+    deployerFeeScale: string;
+    assetToStreamingOiCap: [string, string][];
+    assetToFundingMultiplier: [string, string][];
+    subDeployers: [string, string[]][];
+    lastDeployerFeeScaleChangeTime: string;
+}
+export type PerpDexsResponse = (PerpDex | null)[];

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

@@ -0,0 +1,5 @@
+export type MarketInfo = {
+    symbolName: string;
+    marketName: string;
+};
+export declare const getMarketInfoFromSymbol: (symbol: string) => MarketInfo;

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

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

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

@@ -3,30 +3,6 @@ import type { WsAllMidsData, TokenMetadata, ActiveAssetData, UniverseAsset, WebD
  * Extracts token metadata from aggregated WebData3 contexts and AllMids data
  */
 export declare class TokenMetadataExtractor {
-    /**
-     * Extracts comprehensive token metadata
-     * @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, marketPrefix?: string | null): TokenMetadata | null;
-    /**
-     * Extracts metadata for multiple tokens
-     * @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 unique key to TokenMetadata. Key is "{prefix}:{symbol}" for HIP3 assets, or just "{symbol}" otherwise
-     */
-    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
@@ -34,4 +10,39 @@ export declare class TokenMetadataExtractor {
      * @returns boolean indicating if token exists in universe
      */
     static isTokenAvailable(symbol: string, perpMetaAssets: UniverseAsset[] | null): boolean;
+    /**
+     * Extracts token metadata using DEX-aware lookup (correctly matches perpMetas to assetContexts)
+     * @param symbol - Token symbol (e.g., "BTC", "TSLA")
+     * @param perpMetasByDex - Map of DEX name to UniverseAsset[]
+     * @param assetContextsByDex - Map of DEX name to WebData3AssetCtx[]
+     * @param allMids - AllMids data containing current prices
+     * @param activeAssetData - Optional active asset data containing leverage information
+     * @param finalAtOICaps - Optional array of symbols at OI caps
+     * @returns TokenMetadata or null if token not found
+     */
+    static extractTokenMetadataByDex(symbol: string, perpMetasByDex: Map<string, UniverseAsset[]>, assetContextsByDex: Map<string, WebData3AssetCtx[]>, allMids: WsAllMidsData, activeAssetData?: Record<string, ActiveAssetData> | null, finalAtOICaps?: string[] | null): TokenMetadata | null;
 }
+export type TokenMetadataBySymbol = Record<string, TokenMetadata | null>;
+export type TokenMetadataInputs = {
+    perpMetaAssets: UniverseAsset[] | null;
+    finalAssetContexts: WebData3AssetCtx[] | null;
+    allMids: WsAllMidsData | null;
+    activeAssetData: Record<string, ActiveAssetData> | null;
+    finalAtOICaps: string[] | null;
+    perpMetasByDex?: Map<string, UniverseAsset[]> | null;
+    assetContextsByDex?: Map<string, WebData3AssetCtx[]> | null;
+};
+export type RefreshTokenMetadataOptions = {
+    symbols?: string[];
+    oiCapsOnly?: boolean;
+};
+export declare const refreshTokenMetadata: (state: {
+    perpMetaAssets: UniverseAsset[] | null;
+    finalAssetContexts: WebData3AssetCtx[] | null;
+    allMids: WsAllMidsData | null;
+    activeAssetData: Record<string, ActiveAssetData> | null;
+    finalAtOICaps: string[] | null;
+    tokenMetadata: TokenMetadataBySymbol;
+    perpMetasByDex?: Map<string, UniverseAsset[]> | null;
+    assetContextsByDex?: Map<string, WebData3AssetCtx[]> | null;
+}, overrides: Partial<TokenMetadataInputs>, options?: RefreshTokenMetadataOptions) => TokenMetadataBySymbol;

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

@@ -0,0 +1,4 @@
+import type { TokenMetadata } from '../types';
+export type TokenMetadataBySymbol = Record<string, TokenMetadata | null>;
+export declare const selectTokenMetadataBySymbols: (tokenMetadata: TokenMetadataBySymbol, symbols: string[]) => TokenMetadataBySymbol;
+export declare const getAssetByName: (tokenMetadata: TokenMetadataBySymbol, symbol: string) => TokenMetadata | null;

package/package.json

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

package/dist/hooks/useWebData.d.ts

@@ -1,30 +0,0 @@
-import type { ClearinghouseState, MarketDataBySymbol } from '../types';
-/**
- * Hook to access webData and native WebSocket state
- */
-export declare const useWebData: () => {
-    clearinghouseState: ClearinghouseState | null;
-    perpsAtOpenInterestCap: string[] | null;
-    /**
-     * Market data keyed by symbol, with nested market variants.
-     * Each symbol maps to its market variants (keyed by prefix).
-     * For non-HIP3 assets, use "default" as the key.
-     *
-     * @example
-     * ```ts
-     * // HIP-3 asset with multiple markets
-     * marketDataBySymbol["TSLA"]["xyz"]  // { asset, universe: { collateralToken: "USDC" } }
-     * marketDataBySymbol["TSLA"]["flx"]  // { asset, universe: { collateralToken: "USDH" } }
-     *
-     * // Regular asset
-     * marketDataBySymbol["BTC"]["default"]  // { asset, universe }
-     * ```
-     */
-    marketDataBySymbol: MarketDataBySymbol;
-    /** Map of display name -> all full market names (e.g., "TSLA" -> ["xyz:TSLA", "flx:TSLA"]) */
-    hip3Assets: Map<string, string[]>;
-    /** Map of full market name -> prefix (e.g., "xyz:TSLA" -> "xyz") */
-    hip3MarketPrefixes: Map<string, string>;
-    isConnected: boolean;
-    error: string | null;
-};

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

@@ -1,40 +0,0 @@
-/**
- * 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.
- * 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, 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;