@pear-protocol/hyperliquid-sdk 0.0.66-usdh-1 → 0.0.67

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/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

@@ -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,8 +162,6 @@ export interface TradeHistoryAssetDataDto {
     externalFeePaid: number;
     builderFeePaid: number;
     realizedPnl: number;
-    marketPrefix?: string | null;
-    collateralToken?: CollateralToken;
 }
 /**
  * Trade history data structure
@@ -212,11 +210,9 @@ 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";
     value: number;
 }
 /**
@@ -247,22 +243,20 @@ 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" | "PARTIALLY_FILLED" | "PROCESSING";
 /**
  * Order type
  */
-export type OrderType = 'TP' | 'SL' | 'LIMIT' | 'MARKET' | 'LIMIT_BTCDOM' | 'TWAP';
+export type OrderType = "TP" | "SL" | "LIMIT" | "MARKET" | "LIMIT_BTCDOM" | "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";
+export type OrderDirection = "MORE_THAN" | "LESS_THAN" | null;
 /**
  * Open limit order data structure
  */
@@ -376,7 +370,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: {
@@ -409,7 +403,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;
@@ -427,14 +421,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;
@@ -447,16 +441,12 @@ export interface WebSocketMessage {
 /**
  * WebSocket response from HyperLiquid native API
  */
-export type HLChannel = 'webData3' | 'allMids' | 'activeAssetData' | 'candle' | 'spotState' | 'allDexsClearinghouseState' | 'allDexsAssetCtxs';
+export type HLChannel = "webData3" | "allMids" | "activeAssetData" | "candle" | "allDexsClearinghouseState" | "allDexsAssetCtxs";
 export interface HLChannelDataMap {
     webData3: WebData3Response;
     allMids: WsAllMidsData;
     activeAssetData: ActiveAssetData;
     candle: CandleData;
-    spotState: {
-        user: string;
-        spotState: SpotState;
-    };
     allDexsClearinghouseState: AllDexsClearinghouseStateData;
     allDexsAssetCtxs: AllDexsAssetCtxsData;
 }
@@ -521,12 +511,6 @@ export interface AssetCtx {
     impactPxs?: string[];
     oraclePx: string;
 }
-/**
- * Collateral token type
- * 0 = USDC
- * 360 = USDH
- */
-export type CollateralToken = 'USDC' | 'USDH';
 /**
  * Universe asset metadata
  */
@@ -536,8 +520,6 @@ export interface UniverseAsset {
     maxLeverage: number;
     onlyIsolated?: boolean;
     isDelisted?: boolean;
-    marketPrefix?: string;
-    collateralToken?: CollateralToken;
 }
 export interface PerpMetaAsset extends UniverseAsset {
     marginTableId: number;
@@ -626,8 +608,7 @@ export interface RawAssetDto {
     size: number;
     side: string;
     fundingPaid?: number;
-    marketPrefix?: string | null;
-    collateralToken?: CollateralToken;
+    leverage: number;
 }
 /**
  * Raw position data from open-positions channel
@@ -675,7 +656,6 @@ export interface TokenMetadata {
     leverage?: LeverageInfo;
     maxTradeSzs?: [string, string];
     availableToTrade?: [string, string];
-    collateralToken?: CollateralToken;
 }
 /**
  * Enhanced token selection with weight and metadata for basket trading
@@ -689,37 +669,16 @@ 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[];
@@ -733,7 +692,6 @@ export interface ActiveAssetGroupItem {
     weightedRatio?: string;
     weightedPrevRatio?: string;
     weightedChange24h?: string;
-    collateralType: 'USDC' | 'USDH' | 'MIXED';
 }
 export interface ActiveAssetsResponse {
     active: ActiveAssetGroupItem[];
@@ -751,7 +709,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
  */
@@ -779,20 +737,9 @@ 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[];
-}

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

@@ -5,36 +5,7 @@ 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"])
+ * @param displaySymbol e.g., "XYZ100"
+ * @param displayToFull map of display -> full (e.g., "XYZ100" -> "xyz:XYZ100")
  */
-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;
+export declare function toBackendSymbol(displaySymbol: string, displayToFull: Map<string, string>): string;

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

@@ -5,28 +5,24 @@ import type { WsAllMidsData, TokenMetadata, ActiveAssetData, UniverseAsset, WebD
 export declare class TokenMetadataExtractor {
     /**
      * Extracts comprehensive token metadata
-     * @param symbol - Token symbol (base symbol without prefix, e.g., "TSLA")
+     * @param symbol - Token symbol
      * @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;
+    static extractTokenMetadata(symbol: string, perpMetaAssets: UniverseAsset[] | null, finalAssetContexts: WebData3AssetCtx[] | null, allMids: WsAllMidsData | null, activeAssetData?: Record<string, ActiveAssetData> | null): TokenMetadata | null;
     /**
      * Extracts metadata for multiple tokens
-     * @param tokens - Array of token objects with symbol and optional marketPrefix
+     * @param symbols - Array of token symbols
      * @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
+     * @returns Record of symbol to TokenMetadata
      */
-    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>;
+    static extractMultipleTokensMetadata(symbols: string[], 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.66-usdh-1",
+  "version": "0.0.67",
   "description": "React SDK for Pear Protocol Hyperliquid API integration",
   "type": "module",
   "main": "dist/index.js",

package/dist/hooks/useSpotBalances.d.ts

@@ -1,7 +0,0 @@
-interface SpotBalances {
-    usdhBalance: number | undefined;
-    spotUsdcBalance: number | undefined;
-    isLoading: boolean;
-}
-export declare const useSpotBalances: () => SpotBalances;
-export {};

package/dist/hooks/useSpotOrder.d.ts

@@ -1,13 +0,0 @@
-import type { ApiResponse, ApiErrorResponse } from '../types';
-import { type SpotOrderRequestInput, type SpotOrderResponseDto } from '../clients/orders';
-export interface UseSpotOrderResult {
-    executeSpotOrder: (payload: SpotOrderRequestInput) => Promise<ApiResponse<SpotOrderResponseDto>>;
-    isLoading: boolean;
-    error: ApiErrorResponse | null;
-    resetError: () => void;
-}
-/**
- * Hook for executing spot orders (swaps) on Hyperliquid
- * Use this to swap between USDC and USDH or other spot assets
- */
-export declare function useSpotOrder(): UseSpotOrderResult;