@pear-protocol/hyperliquid-sdk 0.0.66-usdh-2 → 0.0.66-usdh-4

package/dist/hooks/index.d.ts

@@ -17,4 +17,4 @@ export * from './useMarketData';
 export * from './useWatchlist';
 export * from './usePortfolio';
 export * from './useAuth';
-export * from './useSpotBalances';
+export * from './useAllUserBalances';

package/dist/hooks/useAllUserBalances.d.ts

@@ -0,0 +1,9 @@
+interface AllUserBalances {
+    spotUsdcBalance: number | undefined;
+    availableToTradeUsdc: number | undefined;
+    spotUsdhBalance: number | undefined;
+    availableToTradeUsdh: number | undefined;
+    isLoading: boolean;
+}
+export declare const useAllUserBalances: () => AllUserBalances;
+export {};

package/dist/index.d.ts

@@ -1252,12 +1252,14 @@ declare function useAuth(): {
     readonly logout: () => Promise<void>;
 };
 
-interface SpotBalances {
-    usdhBalance: number | undefined;
+interface AllUserBalances {
     spotUsdcBalance: number | undefined;
+    availableToTradeUsdc: number | undefined;
+    spotUsdhBalance: number | undefined;
+    availableToTradeUsdh: number | undefined;
     isLoading: boolean;
 }
-declare const useSpotBalances: () => SpotBalances;
+declare const useAllUserBalances: () => AllUserBalances;
 
 interface UseHyperliquidWebSocketProps {
     wsUrl: string;
@@ -1500,5 +1502,5 @@ declare function isHip3Market(symbol: string): boolean;
 
 declare const useMarketData: any;
 
-export { AccountSummaryCalculator, ConflictDetector, MAX_ASSETS_PER_LEG, MINIMUM_ASSET_USD_VALUE, MaxAssetsPerLegError, MinimumPositionSizeError, PearHyperliquidProvider, TokenMetadataExtractor, adjustAdvancePosition, adjustOrder, adjustPosition, calculateMinimumPositionValue, calculateWeightedRatio, cancelOrder, cancelTwap, cancelTwapOrder, closeAllPositions, closePosition, computeBasketCandles, createCandleLookups, createPosition, executeSpotOrder, getAvailableMarkets, getCompleteTimestamps, getMarketPrefix, getPortfolio, isHip3Market, mapCandleIntervalToTradingViewInterval, mapTradingViewIntervalToCandleInterval, markNotificationReadById, markNotificationsRead, toBackendSymbol, toBackendSymbolWithMarket, toDisplaySymbol, toggleWatchlist, updateRiskParameters, useAccountSummary, useActiveBaskets, useAgentWallet, useAllBaskets, useAuth, useAutoSyncFills, useBasketCandles, useFindBasket, useHighlightedBaskets, useHistoricalPriceData, useHistoricalPriceDataStore, useHyperliquidNativeWebSocket, useHyperliquidWebSocket, useMarketData, useMarketDataAllPayload, useMarketDataPayload, useNotifications, useOpenOrders, useOrders, usePearHyperliquid, usePerformanceOverlays, usePerpMetaAssets, usePortfolio, usePosition, useSpotBalances, useSpotOrder, useTokenSelectionMetadata, useTopGainers, useTopLosers, useTradeHistories, useTwap, useUserSelection, useWatchlist, useWatchlistBaskets, useWebData, validateMaxAssetsPerLeg, validateMinimumAssetSize, validatePositionSize };
+export { AccountSummaryCalculator, ConflictDetector, MAX_ASSETS_PER_LEG, MINIMUM_ASSET_USD_VALUE, MaxAssetsPerLegError, MinimumPositionSizeError, PearHyperliquidProvider, TokenMetadataExtractor, adjustAdvancePosition, adjustOrder, adjustPosition, calculateMinimumPositionValue, calculateWeightedRatio, cancelOrder, cancelTwap, cancelTwapOrder, closeAllPositions, closePosition, computeBasketCandles, createCandleLookups, createPosition, executeSpotOrder, getAvailableMarkets, getCompleteTimestamps, getMarketPrefix, getPortfolio, isHip3Market, mapCandleIntervalToTradingViewInterval, mapTradingViewIntervalToCandleInterval, markNotificationReadById, markNotificationsRead, toBackendSymbol, toBackendSymbolWithMarket, toDisplaySymbol, toggleWatchlist, updateRiskParameters, useAccountSummary, useActiveBaskets, useAgentWallet, useAllBaskets, useAllUserBalances, useAuth, useAutoSyncFills, useBasketCandles, useFindBasket, useHighlightedBaskets, useHistoricalPriceData, useHistoricalPriceDataStore, useHyperliquidNativeWebSocket, useHyperliquidWebSocket, useMarketData, useMarketDataAllPayload, useMarketDataPayload, useNotifications, useOpenOrders, useOrders, usePearHyperliquid, usePerformanceOverlays, usePerpMetaAssets, usePortfolio, usePosition, useSpotOrder, useTokenSelectionMetadata, useTopGainers, useTopLosers, useTradeHistories, useTwap, useUserSelection, useWatchlist, useWatchlistBaskets, useWebData, validateMaxAssetsPerLeg, validateMinimumAssetSize, validatePositionSize };
 export type { AccountSummaryResponseDto, ActiveAssetGroupItem, ActiveAssetsResponse, AdjustAdvanceAssetInput, AdjustAdvanceItemInput, AdjustAdvanceResponseDto, AdjustExecutionType, AdjustOrderRequestInput, AdjustOrderResponseDto, AdjustPositionRequestInput, AdjustPositionResponseDto, AgentWalletDto, AgentWalletState, ApiErrorResponse, ApiResponse, AssetCtx, AssetInformationDetail, AssetMarketData, AssetPosition, AutoSyncFillsOptions, AutoSyncFillsState, BalanceSummaryDto, CancelOrderResponseDto, CancelTwapResponseDto, CandleChartData, CandleData, CandleInterval, CandleSnapshotRequest, ClearinghouseState, CloseAllPositionsResponseDto, CloseAllPositionsResultDto, CloseExecutionType, ClosePositionRequestInput, ClosePositionResponseDto, CollateralFilter, CollateralToken, CreatePositionRequestInput, CreatePositionResponseDto, CrossMarginSummaryDto, CumFundingDto, ExecutionType, ExtraAgent, HLWebSocketResponse, HistoricalRange, LadderConfigInput, MarginSummaryDto, MarketDataBySymbol, NotificationCategory, NotificationDto, OpenLimitOrderDto, OpenPositionDto, OrderAssetDto, OrderStatus, PairAssetDto, PairAssetInput, PerformanceOverlay, PlatformAccountSummaryResponseDto, PortfolioBucketDto, PortfolioInterval, PortfolioIntervalsDto, PortfolioOverallDto, PortfolioResponseDto, PositionAdjustmentType, PositionAssetDetailDto, PositionAssetSummaryDto, PositionResponseStatus, RealtimeBar, RealtimeBarsCallback, SpotBalance, SpotOrderFilledStatus, SpotOrderHyperliquidData, SpotOrderHyperliquidResult, SpotOrderRequestInput, SpotOrderResponseDto, SpotState, ToggleWatchlistResponseDto, TokenConflict, TokenHistoricalPriceData, TokenMetadata, TokenSelection, TpSlThresholdInput, TpSlThresholdType, TradeHistoryAssetDataDto, TradeHistoryDataDto, TwapChunkStatusDto, TwapMonitoringDto, TwapSliceFillResponseItem, UniverseAsset, UpdateRiskParametersRequestInput, UpdateRiskParametersResponseDto, UseAuthOptions, UseBasketCandlesReturn, UseHistoricalPriceDataReturn, UseNotificationsResult, UsePerformanceOverlaysReturn, UsePortfolioResult, UseSpotOrderResult, UseTokenSelectionMetadataReturn, UserProfile, UserSelectionState, WatchlistItemDto, WebSocketAckResponse, WebSocketChannel, WebSocketConnectionState, WebSocketDataMessage, WebSocketMessage, WebSocketSubscribeMessage, WsAllMidsData };

package/dist/index.js

@@ -422,6 +422,7 @@ const useHyperliquidData = create((set, get) => ({
     finalAssetContexts: null,
     finalAtOICaps: null,
     aggregatedClearingHouseState: null,
+    rawClearinghouseStates: null,
     perpMetaAssets: null,
     allPerpMetaAssets: null,
     hip3Assets: new Map(),
@@ -468,6 +469,7 @@ const useHyperliquidData = create((set, get) => ({
     setFinalAssetContexts: (value) => set({ finalAssetContexts: value }),
     setFinalAtOICaps: (value) => set({ finalAtOICaps: value }),
     setAggregatedClearingHouseState: (value) => set({ aggregatedClearingHouseState: value }),
+    setRawClearinghouseStates: (value) => set({ rawClearinghouseStates: value }),
     setPerpMetaAssets: (value) => set({ perpMetaAssets: value }),
     setAllPerpMetaAssets: (value) => set({ allPerpMetaAssets: value }),
     setHip3Assets: (value) => set({ hip3Assets: value }),
@@ -734,7 +736,7 @@ const useUserSelection$1 = create((set, get) => ({
 }));
 
 const useHyperliquidNativeWebSocket = ({ address, enabled = true, }) => {
-    const { setAllMids, setActiveAssetData, upsertActiveAssetData, setCandleData, deleteCandleSymbol, deleteActiveAssetData, addCandleData, setFinalAssetContexts, setFinalAtOICaps, setAggregatedClearingHouseState, } = useHyperliquidData();
+    const { setAllMids, setActiveAssetData, upsertActiveAssetData, setCandleData, deleteCandleSymbol, deleteActiveAssetData, addCandleData, setFinalAssetContexts, setFinalAtOICaps, setAggregatedClearingHouseState, setRawClearinghouseStates, } = useHyperliquidData();
     const { setSpotState } = useUserData();
     const { candleInterval } = useUserSelection$1();
     const longTokens = useUserSelection$1((s) => s.longTokens);
@@ -777,8 +779,8 @@ const useHyperliquidNativeWebSocket = ({ address, enabled = true, }) => {
                     case 'allDexsAssetCtxs':
                         {
                             const data = response.data;
-                            // Filter out vntl and hyna to match perpMetaAssets filtering
-                            const FILTERED_DEX_PREFIXES = ['vntl', 'hyna'];
+                            // Filter out hyna to match perpMetaAssets filtering
+                            const FILTERED_DEX_PREFIXES = ['hyna'];
                             const filtered = (data.ctxs || [])
                                 .filter(([prefix]) => !FILTERED_DEX_PREFIXES.includes((prefix || '').toLowerCase()))
                                 .sort((a, b) => {
@@ -828,6 +830,7 @@ const useHyperliquidNativeWebSocket = ({ address, enabled = true, }) => {
                                 withdrawable,
                             };
                             setAggregatedClearingHouseState(aggregatedClearingHouseState);
+                            setRawClearinghouseStates(data.clearinghouseStates || null);
                         }
                         break;
                     case 'allMids':
@@ -905,6 +908,7 @@ const useHyperliquidNativeWebSocket = ({ address, enabled = true, }) => {
         setFinalAssetContexts,
         setFinalAtOICaps,
         setAggregatedClearingHouseState,
+        setRawClearinghouseStates,
         setSpotState,
     ]);
     const connect = useCallback(() => {
@@ -1075,6 +1079,7 @@ const useHyperliquidNativeWebSocket = ({ address, enabled = true, }) => {
         if (subscribedAddress && subscribedAddress !== userAddress) {
             // clear aggregatedClearingHouseState
             setAggregatedClearingHouseState(null);
+            setRawClearinghouseStates(null);
             // clear spotState
             setSpotState(null);
         }
@@ -1084,6 +1089,7 @@ const useHyperliquidNativeWebSocket = ({ address, enabled = true, }) => {
         subscribedAddress,
         sendJsonMessage,
         setAggregatedClearingHouseState,
+        setRawClearinghouseStates,
         setSpotState,
     ]);
     // Handle token subscriptions for activeAssetData
@@ -8139,34 +8145,97 @@ function useAuth() {
     };
 }
 
-const useSpotBalances = () => {
+const useAllUserBalances = () => {
     const spotState = useUserData((state) => state.spotState);
+    const aggregatedClearingHouseState = useHyperliquidData((state) => state.aggregatedClearingHouseState);
+    const rawClearinghouseStates = useHyperliquidData((state) => state.rawClearinghouseStates);
+    const activeAssetData = useHyperliquidData((state) => state.activeAssetData);
+    const { longTokensMetadata, shortTokensMetadata } = useTokenSelectionMetadata();
     return useMemo(() => {
-        if (!spotState) {
-            return {
-                usdhBalance: undefined,
-                spotUsdcBalance: undefined,
-                isLoading: true,
-            };
-        }
-        const balances = spotState.balances || [];
-        let usdhBal = 0;
-        let spotUsdcBal = 0;
-        for (const balance of balances) {
-            const total = parseFloat(balance.total || '0');
-            if (balance.coin === 'USDH') {
-                usdhBal = total;
+        const isLoading = !spotState || !aggregatedClearingHouseState;
+        // Helper function to truncate to 2 decimal places without rounding
+        const truncateToTwoDecimals = (value) => {
+            return Math.floor(value * 100) / 100;
+        };
+        // Get spot balances from spotState
+        let spotUsdcBal = undefined;
+        let spotUsdhBal = undefined;
+        if (spotState) {
+            const balances = spotState.balances || [];
+            for (const balance of balances) {
+                const total = parseFloat(balance.total || '0');
+                if (balance.coin === 'USDC') {
+                    spotUsdcBal = truncateToTwoDecimals(total);
+                }
+                if (balance.coin === 'USDH') {
+                    spotUsdhBal = truncateToTwoDecimals(total);
+                }
             }
-            if (balance.coin === 'USDC') {
-                spotUsdcBal = total;
+        }
+        let availableToTradeUsdhFromAsset = 0;
+        // This activeAssetData only contains data for SELECTED tokens (user's long and short Tokens)
+        // It does NOT contain data for all tokens, so we cannot reliably use it for available to trade as used on hl trade page
+        // so intead, we rely on rawClearinghouseStates which provides market-specific data
+        // if (activeAssetData) {
+        //   Object.values(activeAssetData).forEach((assetData) => {
+        //     if (!assetData.availableToTrade) return;
+        //     const coinSymbol = assetData.coin;
+        //     const availableValue = truncateToTwoDecimals(
+        //       parseFloat(assetData.availableToTrade[0] || '0'),
+        //     );
+        //     // Determine collateral type based on market prefix
+        //     // HIP3 markets have prefix: "xyz:SYMBOL", "flx:SYMBOL", "vntl:SYMBOL", etc.
+        //     if (coinSymbol.includes(':')) {
+        //       const prefix = coinSymbol.split(':')[0];
+        //       if (prefix === 'xyz') {
+        //         // xyz markets use USDC
+        //         availableToTradeUsdcFromAsset = availableValue;
+        //       } else {
+        //         // flx, vntl, hyna and other markets use USDH
+        //         availableToTradeUsdhFromAsset = availableValue;
+        //       }
+        //     } else {
+        //       // Regular markets without prefix are automatically USDC
+        //       availableToTradeUsdcFromAsset = availableValue;
+        //     }
+        //   });
+        // }
+        // Calculate USDC available to trade
+        // Priority 1: Use value from activeAssetData if available (> 0)
+        // Priority 2: Calculate from USDC-specific clearinghouseState (empty prefix)
+        let availableToTradeUsdcValue = undefined;
+        if (rawClearinghouseStates) {
+            // Find USDC market (empty prefix)
+            const usdcMarket = rawClearinghouseStates.find(([prefix]) => prefix === '');
+            const usdcState = usdcMarket === null || usdcMarket === void 0 ? void 0 : usdcMarket[1];
+            if (usdcState === null || usdcState === void 0 ? void 0 : usdcState.marginSummary) {
+                const accountValue = parseFloat(usdcState.marginSummary.accountValue || '0');
+                const totalMarginUsed = parseFloat(usdcState.marginSummary.totalMarginUsed || '0');
+                const calculatedValue = Math.max(0, accountValue - totalMarginUsed);
+                availableToTradeUsdcValue = truncateToTwoDecimals(calculatedValue);
             }
         }
+        // Calculate USDH available to trade
+        // Priority 1: Use value from activeAssetData if available (> 0)
+        // Priority 2: Use spot USDH balance
+        const availableToTradeUsdhValue = availableToTradeUsdhFromAsset > 0
+            ? availableToTradeUsdhFromAsset
+            : spotUsdhBal;
         return {
-            usdhBalance: usdhBal,
             spotUsdcBalance: spotUsdcBal,
-            isLoading: false,
+            availableToTradeUsdc: availableToTradeUsdcValue,
+            spotUsdhBalance: spotUsdhBal,
+            availableToTradeUsdh: availableToTradeUsdhValue,
+            isLoading,
         };
-    }, [spotState]);
+    }, [
+        spotState,
+        aggregatedClearingHouseState,
+        rawClearinghouseStates,
+        activeAssetData,
+        longTokensMetadata,
+        shortTokensMetadata,
+    ]);
 };
 
 const PearHyperliquidContext = createContext(undefined);
@@ -8197,9 +8266,9 @@ const PearHyperliquidProvider = ({ children, apiBaseUrl = 'https://hl-ui.pearpro
                 .then((res) => {
                 const assetToMarkets = new Map();
                 const marketPrefixes = new Map();
-                const FILTERED_PREFIXES = ['vntl', 'hyna'];
+                const FILTERED_PREFIXES = ['hyna'];
                 // Group assets by market prefix to match WebSocket flattening order
-                // WebSocket sends in order: "", "flx", "hyna", "vntl", "xyz"
+                // WebSocket sends in order: "", "flx", "hyna", "vntl", "xyz" (we filter out hyna)
                 const assetsByPrefix = new Map();
                 const allAssetsByPrefix = new Map();
                 res.data.forEach((item) => {
@@ -8424,4 +8493,4 @@ function mapCandleIntervalToTradingViewInterval(interval) {
     }
 }
 
-export { AccountSummaryCalculator, ConflictDetector, MAX_ASSETS_PER_LEG, MINIMUM_ASSET_USD_VALUE, MaxAssetsPerLegError, MinimumPositionSizeError, PearHyperliquidProvider, TokenMetadataExtractor, adjustAdvancePosition, adjustOrder, adjustPosition, calculateMinimumPositionValue, calculateWeightedRatio, cancelOrder, cancelTwap, cancelTwapOrder, closeAllPositions, closePosition, computeBasketCandles, createCandleLookups, createPosition, executeSpotOrder, getAvailableMarkets, getCompleteTimestamps, getMarketPrefix, getPortfolio, isHip3Market, mapCandleIntervalToTradingViewInterval, mapTradingViewIntervalToCandleInterval, markNotificationReadById, markNotificationsRead, toBackendSymbol, toBackendSymbolWithMarket, toDisplaySymbol, toggleWatchlist, updateRiskParameters, useAccountSummary, useActiveBaskets, useAgentWallet, useAllBaskets, useAuth, useAutoSyncFills, useBasketCandles, useFindBasket, useHighlightedBaskets, useHistoricalPriceData, useHistoricalPriceDataStore, useHyperliquidNativeWebSocket, useHyperliquidWebSocket, useMarketData, useMarketDataAllPayload, useMarketDataPayload, useNotifications, useOpenOrders, useOrders, usePearHyperliquid, usePerformanceOverlays, usePerpMetaAssets, usePortfolio, usePosition, useSpotBalances, useSpotOrder, useTokenSelectionMetadata, useTopGainers, useTopLosers, useTradeHistories, useTwap, useUserSelection, useWatchlist, useWatchlistBaskets, useWebData, validateMaxAssetsPerLeg, validateMinimumAssetSize, validatePositionSize };
+export { AccountSummaryCalculator, ConflictDetector, MAX_ASSETS_PER_LEG, MINIMUM_ASSET_USD_VALUE, MaxAssetsPerLegError, MinimumPositionSizeError, PearHyperliquidProvider, TokenMetadataExtractor, adjustAdvancePosition, adjustOrder, adjustPosition, calculateMinimumPositionValue, calculateWeightedRatio, cancelOrder, cancelTwap, cancelTwapOrder, closeAllPositions, closePosition, computeBasketCandles, createCandleLookups, createPosition, executeSpotOrder, getAvailableMarkets, getCompleteTimestamps, getMarketPrefix, getPortfolio, isHip3Market, mapCandleIntervalToTradingViewInterval, mapTradingViewIntervalToCandleInterval, markNotificationReadById, markNotificationsRead, toBackendSymbol, toBackendSymbolWithMarket, toDisplaySymbol, toggleWatchlist, updateRiskParameters, useAccountSummary, useActiveBaskets, useAgentWallet, useAllBaskets, useAllUserBalances, useAuth, useAutoSyncFills, useBasketCandles, useFindBasket, useHighlightedBaskets, useHistoricalPriceData, useHistoricalPriceDataStore, useHyperliquidNativeWebSocket, useHyperliquidWebSocket, useMarketData, useMarketDataAllPayload, useMarketDataPayload, useNotifications, useOpenOrders, useOrders, usePearHyperliquid, usePerformanceOverlays, usePerpMetaAssets, usePortfolio, usePosition, useSpotOrder, useTokenSelectionMetadata, useTopGainers, useTopLosers, useTradeHistories, useTwap, useUserSelection, useWatchlist, useWatchlistBaskets, useWebData, validateMaxAssetsPerLeg, validateMinimumAssetSize, validatePositionSize };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pear-protocol/hyperliquid-sdk",
-  "version": "0.0.66-usdh-2",
+  "version": "0.0.66-usdh-4",
   "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 {};