@pear-protocol/hyperliquid-sdk 0.0.36 → 0.0.38

package/dist/clients/notifications.d.ts

@@ -5,3 +5,9 @@ import type { ApiResponse } from '../types';
 export declare function markNotificationsRead(baseUrl: string, accessToken: string, timestampMs: number): Promise<ApiResponse<{
     updated: number;
 }>>;
+/**
+ * Mark a single notification as read by id
+ */
+export declare function markNotificationReadById(baseUrl: string, accessToken: string, id: string): Promise<ApiResponse<{
+    updated: number;
+}>>;

package/dist/hooks/useNotifications.d.ts

@@ -5,6 +5,9 @@ export interface UseNotificationsResult {
     markReadUntil: (timestampMs: number) => Promise<{
         updated: number;
     }>;
+    markReadById: (id: string) => Promise<{
+        updated: number;
+    }>;
 }
 /**
  * Provides notifications and fills checkpoint data sourced from the SDK WebSocket.

package/dist/index.d.ts

@@ -150,7 +150,7 @@ interface PositionAssetDetailDto {
     entryPrice: number;
     platformSize: number;
     actualSize: number;
-    cumFunding: CumFundingDto;
+    leverage: number;
     marginUsed: number;
     entryPositionValue: number;
     positionValue: number;
@@ -168,12 +168,10 @@ interface TpSlThreshold {
 interface OpenPositionDto {
     positionId: string;
     address: string;
-    leverage: number;
     stopLoss: TpSlThreshold | null;
     takeProfit: TpSlThreshold | null;
     entryRatio: number;
     markRatio: number;
-    netFunding: number;
     entryPositionValue: number;
     positionValue: number;
     marginUsed: number;
@@ -964,6 +962,9 @@ interface UseNotificationsResult {
     markReadUntil: (timestampMs: number) => Promise<{
         updated: number;
     }>;
+    markReadById: (id: string) => Promise<{
+        updated: number;
+    }>;
 }
 /**
  * Provides notifications and fills checkpoint data sourced from the SDK WebSocket.
@@ -998,6 +999,12 @@ declare const useHyperliquidNativeWebSocket: ({ address, }: UseHyperliquidNative
 declare function markNotificationsRead(baseUrl: string, accessToken: string, timestampMs: number): Promise<ApiResponse<{
     updated: number;
 }>>;
+/**
+ * Mark a single notification as read by id
+ */
+declare function markNotificationReadById(baseUrl: string, accessToken: string, id: string): Promise<ApiResponse<{
+    updated: number;
+}>>;
 
 /**
  * Account summary calculation utility class
@@ -1101,5 +1108,5 @@ declare function mapTradingViewIntervalToCandleInterval(interval: string): Candl
  */
 declare function mapCandleIntervalToTradingViewInterval(interval: CandleInterval): string;
 
-export { AccountSummaryCalculator, AuthStatus, ConflictDetector, PearHyperliquidProvider, TokenMetadataExtractor, adjustOrder, adjustPosition, calculateWeightedRatio, cancelOrder, cancelTwap, cancelTwapOrder, closeAllPositions, closePosition, computeBasketCandles, createCandleLookups, createPosition, getCompleteTimestamps, mapCandleIntervalToTradingViewInterval, mapTradingViewIntervalToCandleInterval, markNotificationsRead, updateRiskParameters, useAccountSummary, useAddress, useAgentWallet, useAuth, useAutoSyncFills, useBasketCandles, useHistoricalPriceData, useHistoricalPriceDataStore, useHyperliquidNativeWebSocket, useHyperliquidWebSocket, useNotifications, useOpenOrders, useOrders, usePearAgentWallet, usePearAuth, usePearHyperliquid, usePerformanceOverlays, usePosition, useTokenSelectionMetadata, useTradeHistories, useTwap, useUserSelection, useWebData };
+export { AccountSummaryCalculator, AuthStatus, ConflictDetector, PearHyperliquidProvider, TokenMetadataExtractor, adjustOrder, adjustPosition, calculateWeightedRatio, cancelOrder, cancelTwap, cancelTwapOrder, closeAllPositions, closePosition, computeBasketCandles, createCandleLookups, createPosition, getCompleteTimestamps, mapCandleIntervalToTradingViewInterval, mapTradingViewIntervalToCandleInterval, markNotificationReadById, markNotificationsRead, updateRiskParameters, useAccountSummary, useAddress, useAgentWallet, useAuth, useAutoSyncFills, useBasketCandles, useHistoricalPriceData, useHistoricalPriceDataStore, useHyperliquidNativeWebSocket, useHyperliquidWebSocket, useNotifications, useOpenOrders, useOrders, usePearAgentWallet, usePearAuth, usePearHyperliquid, usePerformanceOverlays, usePosition, useTokenSelectionMetadata, useTradeHistories, useTwap, useUserSelection, useWebData };
 export type { AccountSummaryResponseDto, 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, CreatePositionRequestInput, CreatePositionResponseDto, CrossMarginSummaryDto, CumFundingDto, ExecutionType, HLWebSocketResponse, HistoricalRange, LadderConfigInput, MarginSummaryDto, NotificationCategory, NotificationDto, OpenLimitOrderDto, OpenPositionDto, OrderAssetDto, OrderStatus, PairAssetInput, PerformanceOverlay, PositionAdjustmentType, PositionAssetDetailDto, PositionAssetSummaryDto, PositionResponseStatus, RealtimeBar, RealtimeBarsCallback, TokenConflict, TokenHistoricalPriceData, TokenMetadata, TokenSelection, TpSlThresholdInput, TpSlThresholdType, TradeHistoryAssetDataDto, TradeHistoryDataDto, TwapChunkStatusDto, TwapMonitoringDto, UniverseAsset, UpdateRiskParametersRequestInput, UpdateRiskParametersResponseDto, UseAgentWalletOptions, UseAuthOptions, UseBasketCandlesReturn, UseHistoricalPriceDataReturn, UseNotificationsResult, UsePerformanceOverlaysReturn, UseTokenSelectionMetadataReturn, UserProfile, UserSelectionState, WebData2Response, WebSocketAckResponse, WebSocketChannel, WebSocketConnectionState, WebSocketDataMessage, WebSocketMessage, WebSocketSubscribeMessage, WsAllMidsData };

package/dist/index.js

@@ -8348,74 +8348,62 @@ async function cancelTwap(baseUrl, accessToken, orderId) {
     }
 }
 
-const calculatePositionAsset = (asset, currentPrice, totalInitialPositionSize, leverage, cumFunding, isLong = true) => {
-    const initialPositionValue = asset.entryPrice * asset.size;
-    const positionValue = currentPrice * asset.size;
-    const marginUsed = positionValue / leverage;
+const calculatePositionAsset = (asset, currentPrice, totalInitialPositionSize, leverage, isLong = true) => {
+    const entryNotional = asset.entryPrice * asset.size;
+    const currentNotional = currentPrice * asset.size;
+    const marginUsed = currentNotional / (leverage || 1);
     const unrealizedPnl = isLong
-        ? positionValue - initialPositionValue
-        : initialPositionValue - positionValue;
+        ? currentNotional - entryNotional
+        : entryNotional - currentNotional;
     return {
         coin: asset.coin,
         entryPrice: asset.entryPrice,
         actualSize: asset.size,
+        leverage: leverage,
         marginUsed: marginUsed,
-        positionValue: positionValue,
+        positionValue: currentNotional,
         unrealizedPnl: unrealizedPnl,
-        entryPositionValue: initialPositionValue,
-        initialWeight: initialPositionValue / totalInitialPositionSize,
-        cumFunding: {
-            allTime: parseFloat((cumFunding === null || cumFunding === void 0 ? void 0 : cumFunding.allTime) || "0"),
-            sinceChange: parseFloat((cumFunding === null || cumFunding === void 0 ? void 0 : cumFunding.sinceChange) || "0"),
-            sinceOpen: parseFloat((cumFunding === null || cumFunding === void 0 ? void 0 : cumFunding.sinceOpen) || "0"),
-        }
+        entryPositionValue: entryNotional,
+        initialWeight: totalInitialPositionSize > 0 ? entryNotional / totalInitialPositionSize : 0,
     };
 };
 const buildPositionValue = (rawPositions, webData2, allMids) => {
     return rawPositions.map((position) => {
-        const webData2Position = webData2.clearinghouseState.assetPositions.find(ap => {
-            var _a, _b, _c, _d;
-            const longCoin = (_b = (_a = position.longAssets) === null || _a === void 0 ? void 0 : _a[0]) === null || _b === void 0 ? void 0 : _b.coin;
-            const shortCoin = (_d = (_c = position.shortAssets) === null || _c === void 0 ? void 0 : _c[0]) === null || _d === void 0 ? void 0 : _d.coin;
-            return ap.position.coin === longCoin || ap.position.coin === shortCoin;
-        });
         let mappedPosition = {
             positionId: position.positionId,
             address: position.address,
-            leverage: webData2Position === null || webData2Position === void 0 ? void 0 : webData2Position.position.leverage.value, // TODO: consider if user manually change leverage from the HL UI
             entryRatio: 1,
             marginUsed: 0,
             markRatio: 1,
             unrealizedPnl: 0,
-            netFunding: 0,
             positionValue: 0,
+            entryPositionValue: 0,
             takeProfit: position.takeProfit,
             stopLoss: position.stopLoss,
         };
         const totalInitialPositionSize = position.longAssets.reduce((acc, asset) => acc + (asset.entryPrice * asset.size), 0) +
             position.shortAssets.reduce((acc, asset) => acc + (asset.entryPrice * asset.size), 0);
         mappedPosition.longAssets = position.longAssets.map(longAsset => {
-            var _a;
+            var _a, _b, _c;
             const currentPrice = parseFloat(allMids.mids[longAsset.coin]);
-            const cumFunding = (_a = webData2.clearinghouseState.assetPositions.find(ap => ap.position.coin === longAsset.coin)) === null || _a === void 0 ? void 0 : _a.position.cumFunding;
-            const mappedPositionAssets = calculatePositionAsset(longAsset, currentPrice, totalInitialPositionSize, mappedPosition.leverage, cumFunding, true);
+            const assetState = (_a = webData2.clearinghouseState.assetPositions.find(ap => ap.position.coin === longAsset.coin)) === null || _a === void 0 ? void 0 : _a.position;
+            const leverage = (_c = (_b = assetState === null || assetState === void 0 ? void 0 : assetState.leverage) === null || _b === void 0 ? void 0 : _b.value) !== null && _c !== void 0 ? _c : 0;
+            const mappedPositionAssets = calculatePositionAsset(longAsset, currentPrice, totalInitialPositionSize, leverage, true);
             mappedPosition.entryPositionValue += mappedPositionAssets.entryPositionValue;
             mappedPosition.unrealizedPnl += mappedPositionAssets.unrealizedPnl;
             mappedPosition.positionValue += mappedPositionAssets.positionValue;
             mappedPosition.marginUsed += mappedPositionAssets.marginUsed;
-            mappedPosition.netFunding += mappedPositionAssets.cumFunding.sinceOpen;
-            // Calculate weighted entry and mark ratios for long positions
             mappedPosition.entryRatio *= Math.pow(longAsset.entryPrice, mappedPositionAssets.initialWeight);
             mappedPosition.markRatio *= Math.pow(currentPrice, mappedPositionAssets.initialWeight);
             return mappedPositionAssets;
         });
         mappedPosition.shortAssets = position.shortAssets.map(shortAsset => {
-            var _a;
+            var _a, _b, _c;
             const currentPrice = parseFloat(allMids.mids[shortAsset.coin]);
-            const cumFunding = (_a = webData2.clearinghouseState.assetPositions.find(ap => ap.position.coin === shortAsset.coin)) === null || _a === void 0 ? void 0 : _a.position.cumFunding;
-            const mappedPositionAssets = calculatePositionAsset(shortAsset, currentPrice, totalInitialPositionSize, mappedPosition.leverage, cumFunding, false);
+            const assetState = (_a = webData2.clearinghouseState.assetPositions.find(ap => ap.position.coin === shortAsset.coin)) === null || _a === void 0 ? void 0 : _a.position;
+            const leverage = (_c = (_b = assetState === null || assetState === void 0 ? void 0 : assetState.leverage) === null || _b === void 0 ? void 0 : _b.value) !== null && _c !== void 0 ? _c : 0;
+            const mappedPositionAssets = calculatePositionAsset(shortAsset, currentPrice, totalInitialPositionSize, leverage, false);
             mappedPosition.entryPositionValue += mappedPositionAssets.entryPositionValue;
-            mappedPosition.netFunding += mappedPositionAssets.cumFunding.sinceOpen;
             mappedPosition.unrealizedPnl += mappedPositionAssets.unrealizedPnl;
             mappedPosition.positionValue += mappedPositionAssets.positionValue;
             mappedPosition.marginUsed += mappedPositionAssets.marginUsed;
@@ -8423,6 +8411,7 @@ const buildPositionValue = (rawPositions, webData2, allMids) => {
             mappedPosition.markRatio *= Math.pow(currentPrice, -mappedPositionAssets.initialWeight);
             return mappedPositionAssets;
         });
+        mappedPosition.positionValue = mappedPosition.entryPositionValue + mappedPosition.unrealizedPnl;
         return mappedPosition;
     });
 };
@@ -8540,15 +8529,11 @@ function useOrders() {
             if (!hasAssets) {
                 return {
                     ...ord,
-                    leverage: pos.leverage,
                     longAssets: mapAssets(pos.longAssets),
                     shortAssets: mapAssets(pos.shortAssets),
                 };
             }
-            // Always sync leverage from position for TP/SL
-            if (ord.leverage !== pos.leverage) {
-                return { ...ord, leverage: pos.leverage };
-            }
+            // Leverage is now tracked per-asset in positions; keep order leverage as-is
             return ord;
         });
     }, [openOrders, positionsById]);
@@ -8598,6 +8583,19 @@ async function markNotificationsRead(baseUrl, accessToken, timestampMs) {
         throw toApiError(error);
     }
 }
+/**
+ * Mark a single notification as read by id
+ */
+async function markNotificationReadById(baseUrl, accessToken, id) {
+    const url = joinUrl(baseUrl, '/notifications/read');
+    try {
+        const response = await axios$1.post(url, { id }, { headers: { 'Content-Type': 'application/json', 'Authorization': `Bearer ${accessToken}` } });
+        return { data: response.data, status: response.status, headers: response.headers };
+    }
+    catch (error) {
+        throw toApiError(error);
+    }
+}
 
 /**
  * Provides notifications and fills checkpoint data sourced from the SDK WebSocket.
@@ -8632,6 +8630,16 @@ function useNotifications() {
             }
             return data;
         }, [apiBaseUrl, accessToken, isAuthenticated, notifications, setNotifications]),
+        markReadById: useCallback(async (id) => {
+            if (!isAuthenticated || !accessToken)
+                throw new Error('Not authenticated');
+            const { data } = await markNotificationReadById(apiBaseUrl, accessToken, id);
+            if (notifications) {
+                const updated = notifications.map((n) => (n.id === id ? { ...n, is_read: true } : n));
+                setNotifications(updated);
+            }
+            return data;
+        }, [apiBaseUrl, accessToken, isAuthenticated, notifications, setNotifications]),
     };
 }
 
@@ -8933,4 +8941,4 @@ function mapCandleIntervalToTradingViewInterval(interval) {
     }
 }
 
-export { AccountSummaryCalculator, AuthStatus, ConflictDetector, PearHyperliquidProvider, TokenMetadataExtractor, adjustOrder, adjustPosition, calculateWeightedRatio, cancelOrder, cancelTwap, cancelTwapOrder, closeAllPositions, closePosition, computeBasketCandles, createCandleLookups, createPosition, getCompleteTimestamps, mapCandleIntervalToTradingViewInterval, mapTradingViewIntervalToCandleInterval, markNotificationsRead, updateRiskParameters, useAccountSummary, useAddress, useAgentWallet, useAuth, useAutoSyncFills, useBasketCandles, useHistoricalPriceData, useHistoricalPriceDataStore, useHyperliquidNativeWebSocket, useHyperliquidWebSocket, useNotifications, useOpenOrders, useOrders, usePearAgentWallet, usePearAuth, usePearHyperliquid, usePerformanceOverlays, usePosition, useTokenSelectionMetadata, useTradeHistories, useTwap, useUserSelection, useWebData };
+export { AccountSummaryCalculator, AuthStatus, ConflictDetector, PearHyperliquidProvider, TokenMetadataExtractor, adjustOrder, adjustPosition, calculateWeightedRatio, cancelOrder, cancelTwap, cancelTwapOrder, closeAllPositions, closePosition, computeBasketCandles, createCandleLookups, createPosition, getCompleteTimestamps, mapCandleIntervalToTradingViewInterval, mapTradingViewIntervalToCandleInterval, markNotificationReadById, markNotificationsRead, updateRiskParameters, useAccountSummary, useAddress, useAgentWallet, useAuth, useAutoSyncFills, useBasketCandles, useHistoricalPriceData, useHistoricalPriceDataStore, useHyperliquidNativeWebSocket, useHyperliquidWebSocket, useNotifications, useOpenOrders, useOrders, usePearAgentWallet, usePearAuth, usePearHyperliquid, usePerformanceOverlays, usePosition, useTokenSelectionMetadata, useTradeHistories, useTwap, useUserSelection, useWebData };

package/dist/types.d.ts

@@ -171,7 +171,7 @@ export interface PositionAssetDetailDto {
     entryPrice: number;
     platformSize: number;
     actualSize: number;
-    cumFunding: CumFundingDto;
+    leverage: number;
     marginUsed: number;
     entryPositionValue: number;
     positionValue: number;
@@ -189,12 +189,10 @@ export interface TpSlThreshold {
 export interface OpenPositionDto {
     positionId: string;
     address: string;
-    leverage: number;
     stopLoss: TpSlThreshold | null;
     takeProfit: TpSlThreshold | null;
     entryRatio: number;
     markRatio: number;
-    netFunding: number;
     entryPositionValue: number;
     positionValue: number;
     marginUsed: number;

package/package.json

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