@pear-protocol/hyperliquid-sdk 0.0.5 → 0.0.7-2.2

package/dist/utils/account-summary-calculator.d.ts

@@ -0,0 +1,17 @@
+import type { AccountSummaryResponseDto, ClearinghouseState, ExtraAgent, PlatformAccountSummaryResponseDto } from "../types";
+/**
+ * Account summary calculation utility class
+ */
+export declare class AccountSummaryCalculator {
+    private clearinghouseState;
+    constructor(clearinghouseState: ClearinghouseState | null);
+    /**
+     * Calculate account summary from real-time clearinghouse state and platform orders
+     */
+    calculateAccountSummary(platformAccountSummary: PlatformAccountSummaryResponseDto | null, registeredAgentWallets: ExtraAgent[]): AccountSummaryResponseDto | null;
+    getClearinghouseState(): ClearinghouseState | null;
+    /**
+     * Check if real-time data is available
+     */
+    hasRealTimeData(): boolean;
+}

package/dist/utils/basket-calculator.d.ts

@@ -0,0 +1,24 @@
+import type { CandleData, TokenSelection } from '../types';
+/**
+ * Create efficient timestamp-based lookup maps for candle data
+ */
+export declare const createCandleLookups: (tokenCandles: Record<string, CandleData[]>) => Record<string, Map<number, CandleData>>;
+/**
+ * Calculate weighted ratio for a specific price type (open, high, low, close)
+ * Uses the formula: LONG_PRODUCT * SHORT_PRODUCT
+ * Where LONG_PRODUCT = ∏(PRICE^(WEIGHT/100)) for long tokens
+ * And SHORT_PRODUCT = ∏(PRICE^-(WEIGHT/100)) for short tokens
+ *
+ * Optimized version that uses Map lookups instead of Array.find()
+ */
+export declare const calculateWeightedRatio: (longTokens: TokenSelection[], shortTokens: TokenSelection[], candleLookups: Record<string, Map<number, CandleData>>, timestamp: number, priceType: "o" | "h" | "l" | "c") => number;
+/**
+ * Get all unique timestamps where ALL required symbols have data
+ * Optimized version that uses Map lookups
+ */
+export declare const getCompleteTimestamps: (candleLookups: Record<string, Map<number, CandleData>>, requiredSymbols: string[]) => number[];
+/**
+ * Compute basket candles from individual token candles using weighted ratios
+ * Optimized version that creates lookup maps once and reuses them
+ */
+export declare const computeBasketCandles: (longTokens: TokenSelection[], shortTokens: TokenSelection[], tokenCandles: Record<string, CandleData[]>) => CandleData[];

package/dist/utils/chart-interval-mappers.d.ts

@@ -0,0 +1,9 @@
+import type { CandleInterval } from '../types';
+/**
+ * Maps TradingView ResolutionString to CandleInterval
+ */
+export declare function mapTradingViewIntervalToCandleInterval(interval: string): CandleInterval;
+/**
+ * Maps CandleInterval to TradingView ResolutionString
+ */
+export declare function mapCandleIntervalToTradingViewInterval(interval: CandleInterval): string;

package/dist/utils/conflict-detector.d.ts

@@ -0,0 +1,14 @@
+import type { TokenSelection, TokenConflict, RawPositionDto } from '../types';
+/**
+ * Detects conflicts between selected tokens and existing positions
+ */
+export declare class ConflictDetector {
+    /**
+     * Detects conflicts between token selections and open positions
+     * @param longTokens - Selected long tokens
+     * @param shortTokens - Selected short tokens
+     * @param openPositions - Current open positions from API
+     * @returns Array of detected conflicts
+     */
+    static detectConflicts(longTokens: TokenSelection[], shortTokens: TokenSelection[], openPositions: RawPositionDto[] | null): TokenConflict[];
+}

package/dist/utils/http.d.ts

@@ -0,0 +1,26 @@
+import type { AxiosInstance } from 'axios';
+import { ApiErrorResponse } from '../types';
+export declare function toApiError(error: unknown): ApiErrorResponse;
+export declare function joinUrl(baseUrl: string, path: string): string;
+/**
+ * Shared Axios instance with interceptors.
+ * - Request: inject Authorization headers from buildAuthHeaders when absent
+ * - Response: on 401, clear tokens and emit a logout event
+ */
+export declare const apiClient: AxiosInstance;
+/**
+ * Attach auth-aware Axios interceptors to `apiClient`.
+ * - Request: adds `Authorization: Bearer <accessToken>` for requests to `apiBaseUrl`.
+ * - Response: if a request returns 401, attempts token refresh and retries the request.
+ *   If the 401 came from the refresh endpoint (or refresh fails/returns 401), calls `logout()`.
+ *
+ */
+export declare function addAuthInterceptors(params: {
+    apiBaseUrl: string;
+    getAccessToken: () => string | null;
+    refreshTokens: () => Promise<{
+        accessToken: string;
+        refreshToken: string;
+    } | any>;
+    logout: () => Promise<void> | void;
+}): () => void;

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

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

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

@@ -0,0 +1,61 @@
+import type { PairAssetInput } from "../clients/positions";
+/**
+ * Minimum USD value required per asset when creating a position
+ */
+export declare const MINIMUM_ASSET_USD_VALUE = 11;
+/**
+ * Maximum number of assets allowed per leg (long or short) in a position
+ */
+export declare const MAX_ASSETS_PER_LEG = 15;
+/**
+ * Validation error for minimum position size
+ */
+export declare class MinimumPositionSizeError extends Error {
+    assetName: string;
+    assetValue: number;
+    minimumRequired: number;
+    constructor(assetName: string, assetValue: number, minimumRequired: number);
+}
+/**
+ * Validation error for exceeding maximum assets per leg
+ */
+export declare class MaxAssetsPerLegError extends Error {
+    leg: "long" | "short";
+    assetCount: number;
+    maxAllowed: number;
+    constructor(leg: "long" | "short", assetCount: number, maxAllowed: number);
+}
+/**
+ * Validates that each leg doesn't exceed the maximum number of assets
+ * @param longAssets Array of long assets
+ * @param shortAssets Array of short assets
+ * @throws MaxAssetsPerLegError if any leg exceeds the maximum allowed assets
+ */
+export declare function validateMaxAssetsPerLeg(longAssets?: PairAssetInput[], shortAssets?: PairAssetInput[]): void;
+/**
+ * Validates that each asset in a position has at least the minimum USD value
+ * @param usdValue Total USD value for the position
+ * @param longAssets Array of long assets with weights
+ * @param shortAssets Array of short assets with weights
+ * @throws MinimumPositionSizeError if any asset has less than the minimum USD value
+ */
+export declare function validateMinimumAssetSize(usdValue: number, longAssets?: PairAssetInput[], shortAssets?: PairAssetInput[]): void;
+/**
+ * Calculates the minimum USD value required for a position based on the number of assets
+ * @param longAssets Array of long assets
+ * @param shortAssets Array of short assets
+ * @returns The minimum total USD value required
+ */
+export declare function calculateMinimumPositionValue(longAssets?: PairAssetInput[], shortAssets?: PairAssetInput[]): number;
+/**
+ * Validates and provides a user-friendly error message with suggestions
+ * @param usdValue Total USD value for the position
+ * @param longAssets Array of long assets with weights
+ * @param shortAssets Array of short assets with weights
+ * @returns Validation result with success flag and optional error message
+ */
+export declare function validatePositionSize(usdValue: number, longAssets?: PairAssetInput[], shortAssets?: PairAssetInput[]): {
+    valid: boolean;
+    error?: string;
+    minimumRequired?: number;
+};

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

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

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

@@ -0,0 +1,37 @@
+import type { WsAllMidsData, TokenMetadata, ActiveAssetData, UniverseAsset, WebData3AssetCtx } from '../types';
+/**
+ * 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
+     * @param perpMetaAssets - Aggregated universe assets
+     * @returns boolean indicating if token exists in universe
+     */
+    static isTokenAvailable(symbol: string, perpMetaAssets: UniverseAsset[] | null): boolean;
+}

package/dist/websocket.d.ts

@@ -0,0 +1,9 @@
+export interface UseHyperliquidWebSocketProps {
+    wsUrl: string;
+    address: string | null;
+    enabled?: boolean;
+}
+export declare const useHyperliquidWebSocket: ({ wsUrl, address, enabled, }: UseHyperliquidWebSocketProps) => {
+    isConnected: boolean;
+    lastError: string | null;
+};

package/package.json

@@ -1,36 +1,48 @@
 {
   "name": "@pear-protocol/hyperliquid-sdk",
-  "version": "0.0.5",
+  "version": "0.0.72.2",
   "description": "React SDK for Pear Protocol Hyperliquid API integration",
+  "type": "module",
   "main": "dist/index.js",
-  "module": "dist/index.esm.js",
+  "module": "dist/index.js",
   "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
   "files": [
     "dist"
   ],
   "scripts": {
     "build": "rollup -c",
     "dev": "rollup -c -w",
+    "copy-watch": "nodemon --watch dist --exec \"npm run copy-to-node-modules\"",
+    "copy-to-node-modules": "cp -r dist/* ../node_modules/@pear-protocol/hyperliquid-sdk/dist/",
     "type-check": "tsc --noEmit",
     "clean": "rimraf dist"
   },
   "dependencies": {
-    "@nktkas/hyperliquid": "^0.22.1",
     "axios": "^1.6.0",
-    "react-use-websocket": "^4.8.1"
+    "zustand": "^5.0.9"
   },
   "peerDependencies": {
-    "react": ">=16.8.0"
+    "react": "^18.0.0",
+    "react-dom": "^18.0.0"
   },
   "devDependencies": {
     "@rollup/plugin-commonjs": "^25.0.0",
     "@rollup/plugin-node-resolve": "^15.0.0",
+    "@rollup/plugin-terser": "^0.4.4",
     "@rollup/plugin-typescript": "^11.0.0",
     "@types/react": "^18.0.0",
-    "react": "^18.0.0",
+    "concurrently": "^9.2.1",
+    "esbuild": "^0.25.9",
     "rimraf": "^5.0.0",
     "rollup": "^3.0.0",
     "rollup-plugin-dts": "^6.0.0",
+    "rollup-plugin-esbuild": "^6.2.1",
     "tslib": "^2.6.0",
     "typescript": "^5.0.0"
   },
@@ -53,5 +65,6 @@
     "registry": "https://registry.npmjs.org",
     "access": "public"
   },
+  "sideEffects": false,
   "private": false
 }

package/README.md

@@ -1,230 +0,0 @@
-# @pear-protocol/hyperliquid-sdk
-
-> React SDK for Pear Protocol Hyperliquid API integration
-
-[![npm version](https://badge.fury.io/js/%40pear-protocol%2Fhyperliquid-sdk.svg)](https://badge.fury.io/js/%40pear-protocol%2Fhyperliquid-sdk)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-
-A comprehensive React SDK for integrating with Pear Protocol's Hyperliquid trading platform. This SDK provides React hooks, TypeScript support, real-time WebSocket connections, and migration utilities for seamless integration.
-
-## Features
-
-- 🚀 **React Hooks**: Easy-to-use hooks for trading data and account management
-- 🔌 **Real-time WebSocket**: Live updates for positions, orders, and trade history
-- 📝 **TypeScript**: Full TypeScript support with comprehensive type definitions
-- 🔄 **Migration Tools**: Built-in SDK for migrating trading data
-- 📱 **Responsive**: Works with React 16.8+ and modern React patterns
-
-## Installation
-
-```bash
-npm install @pear-protocol/hyperliquid-sdk
-```
-
-or
-
-```bash
-yarn add @pear-protocol/hyperliquid-sdk
-```
-
-## Quick Start
-
-### 1. Setup the Provider
-
-Wrap your application with the `PearHyperliquidProvider`:
-
-```tsx
-import { PearHyperliquidProvider } from '@pear-protocol/hyperliquid-sdk';
-
-function App() {
-  return (
-    <PearHyperliquidProvider
-      config={{
-        baseUrl: 'https://hl-v2.pearprotocol.io',
-        timeout: 30000, // Optional: Request timeout in ms
-      }}
-      wsUrl="wss://hl-v2.pearprotocol.io/ws" // Optional: Custom WebSocket URL
-    >
-      <YourApp />
-    </PearHyperliquidProvider>
-  );
-}
-```
-
-### 2. Use the Hooks
-
-#### Address Management
-
-```tsx
-import { useAddress } from '@pear-protocol/hyperliquid-sdk';
-
-function LoginComponent() {
-  const { address, setAddress, clearAddress, isLoggedIn } = useAddress();
-
-  return (
-    <div>
-      {isLoggedIn ? (
-        <div>
-          <p>Logged in as: {address}</p>
-          <button onClick={clearAddress}>Logout</button>
-        </div>
-      ) : (
-        <button onClick={() => setAddress('0x1234...')}>
-          Login
-        </button>
-      )}
-    </div>
-  );
-}
-```
-
-#### Trading Data
-
-```tsx
-import { 
-  useTradeHistories, 
-  useOpenPositions, 
-  useOpenOrders, 
-  useAccountSummary 
-} from '@pear-protocol/hyperliquid-sdk';
-
-function TradingDashboard() {
-  const tradeHistories = useTradeHistories();
-  const openPositions = useOpenPositions();
-  const openOrders = useOpenOrders();
-  const accountSummary = useAccountSummary();
-
-  return (
-    <div>
-      <h2>Account Summary</h2>
-      {accountSummary && (
-        <div>
-          <p>Balance: {accountSummary.balance}</p>
-          <p>Margin Used: {accountSummary.marginUsed}</p>
-        </div>
-      )}
-
-      <h2>Open Positions</h2>
-      {openPositions?.map(position => (
-        <div key={position.coin}>
-          <p>{position.coin}: {position.szi} @ {position.entryPx}</p>
-        </div>
-      ))}
-
-      <h2>Open Orders</h2>
-      {openOrders?.map(order => (
-        <div key={order.oid}>
-          <p>{order.coin}: {order.sz} @ {order.limitPx}</p>
-        </div>
-      ))}
-    </div>
-  );
-}
-```
-
-## API Reference
-
-### Configuration
-
-```typescript
-interface PearHyperliquidConfig {
-  baseUrl: string;
-  timeout?: number;
-  headers?: Record<string, string>;
-}
-```
-
-### Hooks
-
-#### `useAddress()`
-Manages user address and login state.
-
-**Returns:**
-- `address: string | null` - Current user address
-- `setAddress: (address: string | null) => void` - Set user address
-- `clearAddress: () => void` - Clear current address
-- `isLoggedIn: boolean` - Whether user is logged in
-
-#### `useTradeHistories()`
-Returns paginated trade history data from WebSocket.
-
-#### `useOpenPositions()`
-Returns array of current open positions from WebSocket.
-
-#### `useOpenOrders()`
-Returns array of current open orders from WebSocket.
-
-#### `useAccountSummary()`
-Returns account summary including balance and margin information.
-
-### Client Methods
-
-The `PearHyperliquidClient` provides methods for:
-- `syncTradeHistories(data: SyncTradeHistoryDto)` - Sync trade history
-- `syncOpenPositions(data: SyncOpenPositionDto)` - Sync open positions  
-- `syncOpenOrders(data: SyncOpenOrderDto)` - Sync open orders
-
-### WebSocket Channels
-
-The SDK automatically subscribes to these channels when an address is set:
-- `trade-histories` - Real-time trade history updates
-- `open-positions` - Real-time position updates
-- `open-orders` - Real-time order updates
-- `account-summary` - Real-time account summary updates
-
-## TypeScript Support
-
-The SDK includes comprehensive TypeScript definitions for all data structures:
-
-```typescript
-import type {
-  PearHyperliquidConfig,
-  TradeHistoryV1Dto,
-  OpenPositionDto,
-  OpenLimitOrderDto,
-  AccountSummaryResponseDto,
-  // ... and many more
-} from '@pear-protocol/hyperliquid-sdk';
-```
-
-## Error Handling
-
-The SDK provides structured error handling:
-
-```typescript
-try {
-  await client.syncTradeHistories(data);
-} catch (error) {
-  // Error is typed as ApiErrorResponse
-  console.error(`API Error ${error.statusCode}: ${error.message}`);
-}
-```
-
-## Requirements
-
-- React >= 16.8.0
-- Node.js >= 16.0.0
-
-## Development
-
-```bash
-# Install dependencies
-npm install
-
-# Build the package
-npm run build
-
-# Run in development mode (watch)
-npm run dev
-
-# Type check
-npm run type-check
-```
-
-## License
-
-MIT License - see [LICENSE](LICENSE) file for details.
-
-## Support
-
-For questions and support, please contact the Pear Protocol team.

package/dist/client.d.ts

@@ -1,43 +0,0 @@
-import { PearHyperliquidConfig, ApiResponse, SyncTradeHistoryDto, SyncTradeHistoryResponseDto, SyncOpenPositionDto, SyncOpenPositionResponseDto, SyncOpenOrderDto, SyncOpenOrderResponseDto } from './types';
-/**
- * Main SDK client for Pear Protocol Hyperliquid API integration
- */
-export declare class PearHyperliquidClient {
-    private httpClient;
-    private baseUrl;
-    constructor(config: PearHyperliquidConfig);
-    /**
-     * Get the configured base URL
-     */
-    getBaseUrl(): string;
-    /**
-     * Update request headers
-     */
-    setHeaders(headers: Record<string, string>): void;
-    /**
-     * Set authorization header
-     */
-    setAuthToken(token: string): void;
-    /**
-     * Make a generic HTTP request
-     */
-    private makeRequest;
-    /**
-     * Sync trade history data from old database structure to new database format
-     * @param payload - Trade history data with user address
-     * @returns Promise with sync result
-     */
-    syncTradeHistory(payload: SyncTradeHistoryDto): Promise<ApiResponse<SyncTradeHistoryResponseDto>>;
-    /**
-     * Sync open positions data from old database structure to new database format
-     * @param payload - Open positions data with user address
-     * @returns Promise with sync result
-     */
-    syncOpenPositions(payload: SyncOpenPositionDto): Promise<ApiResponse<SyncOpenPositionResponseDto>>;
-    /**
-     * Sync open orders data from old database structure to new database format
-     * @param payload - Open orders data with user address
-     * @returns Promise with sync result
-     */
-    syncOpenOrders(payload: SyncOpenOrderDto): Promise<ApiResponse<SyncOpenOrderResponseDto>>;
-}

package/dist/hooks/useAddress.d.ts

@@ -1,9 +0,0 @@
-/**
- * Hook to manage address (login/logout functionality)
- */
-export declare const useAddress: () => {
-    address: string | null;
-    setAddress: (address: string | null) => void;
-    clearAddress: () => void;
-    isLoggedIn: boolean;
-};

package/dist/hyperliquid-service.d.ts

@@ -1,75 +0,0 @@
-import * as hl from '@nktkas/hyperliquid';
-export interface AllAssetInformation {
-    universe: hl.PerpsUniverse;
-    assetsCtx: hl.PerpsAssetCtx;
-}
-/**
- * Hyperliquid service client for direct API communication
- */
-export declare class HyperliquidService {
-    private infoClient;
-    private subsClient?;
-    private wsTransport?;
-    private allMidsData;
-    private webData2;
-    private assetBySymbol;
-    private allAssetsCache;
-    constructor(wsUrl?: string, isTestnet?: boolean);
-    private initializeWebSocket;
-    /**
-     * Refresh asset cache when webData2 updates
-     */
-    private refreshAssetCache;
-    /**
-     * Get asset information by symbol - O(1) lookup
-     */
-    getAssetInfo(symbol: string): hl.PerpsUniverse | null;
-    /**
-     * Get asset context by symbol - O(1) lookup
-     */
-    getAssetCtx(symbol: string): hl.PerpsAssetCtx | null;
-    /**
-     * Get asset index by symbol - O(1) lookup
-     */
-    getAssetIndex(symbol: string): number | null;
-    /**
-     * Get all assets with caching
-     */
-    getAllAssets(): AllAssetInformation[];
-    /**
-     * Get current market price for an asset
-     */
-    getMarketPrice(symbol: string): number;
-    /**
-     * Get optimal decimal places for an asset
-     */
-    getOptimalDecimal(symbol: string): number;
-    /**
-     * Get user's open positions from Hyperliquid
-     */
-    getUserPositions(address: string): Promise<hl.AssetPosition[]>;
-    /**
-     * Get user's account summary from Hyperliquid
-     */
-    getAccountSummary(address: string): Promise<hl.PerpsClearinghouseState | null>;
-    /**
-     * Get user's open orders from Hyperliquid
-     */
-    getUserOrders(address: string): Promise<any[]>;
-    /**
-     * Update the user address for webData2 subscription
-     */
-    updateUserAddress(address: string | null): void;
-    /**
-     * Get the info client instance
-     */
-    getInfoClient(): hl.InfoClient;
-    /**
-     * Check if WebSocket is connected
-     */
-    isWebSocketConnected(): boolean;
-    /**
-     * Clean up resources
-     */
-    cleanup(): Promise<void>;
-}