@pear-protocol/hyperliquid-sdk 0.0.10 → 0.0.12

package/dist/hooks/index.d.ts

@@ -2,3 +2,5 @@ export { useAddress } from './useAddress';
 export { useTradeHistories, useOpenPositions, useOpenOrders, useAccountSummary } from './useTrading';
 export { useCalculatedOpenPositions } from './useCalculatedPositions';
 export { useCalculatedAccountSummary } from './useCalculatedAccountSummary';
+export { useTokenSelection } from './useTokenSelection';
+export type { TokenSelectorConfig, UseTokenSelectionReturn } from './useTokenSelection';

package/dist/hooks/useTokenSelection.d.ts

@@ -0,0 +1,33 @@
+import type { TokenSelection, TokenConflict } from '../types';
+import { TokenSelectorConfig } from '../provider';
+export type { TokenSelectorConfig };
+export interface UseTokenSelectionReturn {
+    longTokens: TokenSelection[];
+    shortTokens: TokenSelection[];
+    openTokenSelector: boolean;
+    selectorConfig: TokenSelectorConfig | null;
+    openConflictModal: boolean;
+    conflicts: TokenConflict[];
+    isLoading: boolean;
+    isPriceDataReady: boolean;
+    weightedRatio: number;
+    weightedRatio24h: number;
+    sumNetFunding: number;
+    maxLeverage: number;
+    minMargin: number;
+    setLongTokens: (tokens: TokenSelection[]) => void;
+    setShortTokens: (tokens: TokenSelection[]) => void;
+    updateTokenWeight: (isLong: boolean, index: number, newWeight: number) => void;
+    addToken: (isLong: boolean) => void;
+    removeToken: (isLong: boolean, index: number) => void;
+    handleTokenSelect: (selectedToken: string) => void;
+    setOpenTokenSelector: (open: boolean) => void;
+    setSelectorConfig: (config: TokenSelectorConfig | null) => void;
+    setOpenConflictModal: (open: boolean) => void;
+    setConflicts: (conflicts: TokenConflict[]) => void;
+    resetToDefaults: () => void;
+}
+/**
+ * Hook to access token selection state using provider's WebSocket data
+ */
+export declare const useTokenSelection: () => UseTokenSelectionReturn;

package/dist/index.d.ts

@@ -542,6 +542,37 @@ interface RawPositionDto {
     longAssets: RawAssetDto[];
     shortAssets: RawAssetDto[];
 }
+/**
+ * Token metadata from WebData2 and AllMids
+ */
+interface TokenMetadata {
+    currentPrice: number;
+    prevDayPrice: number;
+    priceChange24h: number;
+    priceChange24hPercent: number;
+    netFunding: number;
+    maxLeverage: number;
+    markPrice: number;
+    oraclePrice: number;
+    openInterest: string;
+    dayVolume: string;
+}
+/**
+ * Enhanced token selection with weight and metadata for basket trading
+ */
+interface TokenSelection {
+    symbol: string;
+    weight: number;
+    metadata?: TokenMetadata;
+}
+/**
+ * Token conflict information for position conflicts
+ */
+interface TokenConflict {
+    symbol: string;
+    conflictType: 'long' | 'short';
+    conflictMessage: string;
+}
 
 /**
  * Main SDK client for Pear Protocol Hyperliquid API integration
@@ -644,6 +675,10 @@ declare class PearMigrationSDK {
     getBaseUrl(): string;
 }
 
+interface TokenSelectorConfig {
+    isLong: boolean;
+    index: number;
+}
 interface PearHyperliquidProviderProps {
     config: PearHyperliquidConfig;
     /**
@@ -715,6 +750,37 @@ declare const useCalculatedOpenPositions: (platformPositions: RawPositionDto[] |
  */
 declare const useCalculatedAccountSummary: (platformAccountSummary: AccountSummaryResponseDto | null, platformOpenOrders: OpenLimitOrderDto[] | null, webData2: WebData2Response | null, agentWalletAddress?: string, agentWalletStatus?: string) => AccountSummaryResponseDto | null;
 
+interface UseTokenSelectionReturn {
+    longTokens: TokenSelection[];
+    shortTokens: TokenSelection[];
+    openTokenSelector: boolean;
+    selectorConfig: TokenSelectorConfig | null;
+    openConflictModal: boolean;
+    conflicts: TokenConflict[];
+    isLoading: boolean;
+    isPriceDataReady: boolean;
+    weightedRatio: number;
+    weightedRatio24h: number;
+    sumNetFunding: number;
+    maxLeverage: number;
+    minMargin: number;
+    setLongTokens: (tokens: TokenSelection[]) => void;
+    setShortTokens: (tokens: TokenSelection[]) => void;
+    updateTokenWeight: (isLong: boolean, index: number, newWeight: number) => void;
+    addToken: (isLong: boolean) => void;
+    removeToken: (isLong: boolean, index: number) => void;
+    handleTokenSelect: (selectedToken: string) => void;
+    setOpenTokenSelector: (open: boolean) => void;
+    setSelectorConfig: (config: TokenSelectorConfig | null) => void;
+    setOpenConflictModal: (open: boolean) => void;
+    setConflicts: (conflicts: TokenConflict[]) => void;
+    resetToDefaults: () => void;
+}
+/**
+ * Hook to access token selection state using provider's WebSocket data
+ */
+declare const useTokenSelection: () => UseTokenSelectionReturn;
+
 interface WebSocketData {
     tradeHistories: TradeHistoryDataDto[] | null;
     openPositions: RawPositionDto[] | null;
@@ -786,5 +852,48 @@ declare class AccountSummaryCalculator {
     hasRealTimeData(): boolean;
 }
 
-export { AccountSummaryCalculator, PearHyperliquidClient, PearHyperliquidProvider, PearMigrationSDK, PearHyperliquidClient as default, useAccountSummary, useAddress, useCalculatedAccountSummary, useCalculatedOpenPositions, useHyperliquidNativeWebSocket, useHyperliquidWebSocket, useMigrationSDK, useOpenOrders, useOpenPositions, usePearHyperliquidClient, useTradeHistories };
-export type { AccountSummaryResponseDto, AgentWalletDto, ApiErrorResponse, ApiResponse, AssetCtx, AssetInformationDetail, AssetPosition, BalanceSummaryDto, CrossMarginSummaryDto, CumFundingDto, MarginSummaryDto, MigrationHookState, MigrationHooks, OpenLimitOrderDto, OpenOrderV1Dto, OpenPositionDto, OpenPositionV1Dto, OrderAssetDto, OrderStatus, PearHyperliquidConfig, PnlDto, PositionAssetDetailDto, PositionSideDto, PositionSyncStatus, RawValueDto, SyncOpenOrderDto, SyncOpenOrderResponseDto, SyncOpenPositionDto, SyncOpenPositionResponseDto, SyncTradeHistoryDto, SyncTradeHistoryResponseDto, TpSlDto, TradeHistoryAssetDataDto, TradeHistoryDataDto, TradeHistoryV1Dto, UniverseAsset, WebData2Response, WebSocketChannel, WebSocketConnectionState, WebSocketDataMessage, WebSocketMessage, WebSocketResponse, WebSocketSubscribeMessage, WsAllMidsData };
+/**
+ * Detects conflicts between selected tokens and existing positions
+ */
+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: any[] | null): TokenConflict[];
+}
+
+/**
+ * Extracts token metadata from WebData2 and AllMids data
+ */
+declare class TokenMetadataExtractor {
+    /**
+     * Extracts comprehensive token metadata
+     * @param symbol - Token symbol
+     * @param webData2 - WebData2 response containing asset context and universe data
+     * @param allMids - AllMids data containing current prices
+     * @returns TokenMetadata or null if token not found
+     */
+    static extractTokenMetadata(symbol: string, webData2: WebData2Response | null, allMids: WsAllMidsData | null): TokenMetadata | null;
+    /**
+     * Extracts metadata for multiple tokens
+     * @param symbols - Array of token symbols
+     * @param webData2 - WebData2 response
+     * @param allMids - AllMids data
+     * @returns Record of symbol to TokenMetadata
+     */
+    static extractMultipleTokensMetadata(symbols: string[], webData2: WebData2Response | null, allMids: WsAllMidsData | null): Record<string, TokenMetadata | null>;
+    /**
+     * Checks if token data is available in WebData2
+     * @param symbol - Token symbol
+     * @param webData2 - WebData2 response
+     * @returns boolean indicating if token exists in universe
+     */
+    static isTokenAvailable(symbol: string, webData2: WebData2Response | null): boolean;
+}
+
+export { AccountSummaryCalculator, ConflictDetector, PearHyperliquidClient, PearHyperliquidProvider, PearMigrationSDK, TokenMetadataExtractor, PearHyperliquidClient as default, useAccountSummary, useAddress, useCalculatedAccountSummary, useCalculatedOpenPositions, useHyperliquidNativeWebSocket, useHyperliquidWebSocket, useMigrationSDK, useOpenOrders, useOpenPositions, usePearHyperliquidClient, useTokenSelection, useTradeHistories };
+export type { AccountSummaryResponseDto, AgentWalletDto, ApiErrorResponse, ApiResponse, AssetCtx, AssetInformationDetail, AssetPosition, BalanceSummaryDto, CrossMarginSummaryDto, CumFundingDto, MarginSummaryDto, MigrationHookState, MigrationHooks, OpenLimitOrderDto, OpenOrderV1Dto, OpenPositionDto, OpenPositionV1Dto, OrderAssetDto, OrderStatus, PearHyperliquidConfig, PnlDto, PositionAssetDetailDto, PositionSideDto, PositionSyncStatus, RawValueDto, SyncOpenOrderDto, SyncOpenOrderResponseDto, SyncOpenPositionDto, SyncOpenPositionResponseDto, SyncTradeHistoryDto, SyncTradeHistoryResponseDto, TokenConflict, TokenMetadata, TokenSelection, TokenSelectorConfig, TpSlDto, TradeHistoryAssetDataDto, TradeHistoryDataDto, TradeHistoryV1Dto, UniverseAsset, UseTokenSelectionReturn, WebData2Response, WebSocketChannel, WebSocketConnectionState, WebSocketDataMessage, WebSocketMessage, WebSocketResponse, WebSocketSubscribeMessage, WsAllMidsData };