@pear-protocol/hyperliquid-sdk 0.1.29 → 0.1.31

package/dist/index.js

@@ -972,6 +972,23 @@ const useUserSelection$1 = create((set, get) => ({
     resetToDefaults: () => set((prev) => ({ ...prev, ...DEFAULT_STATE })),
 }));
 
+const STABLE_QUOTE_SYMBOLS = new Set([
+    'USDC',
+    'USDH',
+    'USDE',
+    'USDT',
+    'USDT0',
+]);
+const isStableQuoteSymbol = (symbol) => STABLE_QUOTE_SYMBOLS.has(symbol.toUpperCase());
+const hasNonStableTokens = (tokens) => tokens.some((token) => !isStableQuoteSymbol(token.symbol));
+const isStableOnlySide = (tokens) => tokens.length === 0 || tokens.every((token) => isStableQuoteSymbol(token.symbol));
+const isSingleAssetSideAgainstStableQuote = (longTokens, shortTokens) => {
+    const longHasNonStable = hasNonStableTokens(longTokens);
+    const shortHasNonStable = hasNonStableTokens(shortTokens);
+    return ((longHasNonStable && isStableOnlySide(shortTokens)) ||
+        (shortHasNonStable && isStableOnlySide(longTokens)));
+};
+
 const CANDLE_STALE_WARNING_MS = 90000;
 const getCandleSubscriptionKey = (coin, interval) => `${coin}:${interval}`;
 const debugHyperliquidWs = (message, payload) => {
@@ -993,7 +1010,9 @@ const useHyperliquidNativeWebSocket = ({ address, enabled = true, onUserFills, }
     const userSummary = useUserData((state) => state.accountSummary);
     const longTokens = useUserSelection$1((s) => s.longTokens);
     const shortTokens = useUserSelection$1((s) => s.shortTokens);
-    const selectedTokenSymbols = useMemo(() => [...longTokens, ...shortTokens].map((t) => t.symbol), [longTokens, shortTokens]);
+    const selectedTokenSymbols = useMemo(() => [...longTokens, ...shortTokens]
+        .map((t) => t.symbol)
+        .filter((symbol) => !isStableQuoteSymbol(symbol)), [longTokens, shortTokens]);
     const [lastError, setLastError] = useState(null);
     const [subscribedAddress, setSubscribedAddress] = useState(null);
     const [subscribedTokens, setSubscribedTokens] = useState([]);
@@ -1904,7 +1923,7 @@ const useTokenSelectionMetadataStore = create((set) => ({
                 ...longTokensMetadata,
                 ...shortTokensMetadata,
             };
-            return allTokens.some((token) => !allMetadata[token.symbol]);
+            return allTokens.some((token) => !isStableQuoteSymbol(token.symbol) && !allMetadata[token.symbol]);
         })();
         // Open interest and volume (from market data for matching asset basket)
         const { openInterest, volume } = (() => {
@@ -1927,9 +1946,15 @@ const useTokenSelectionMetadataStore = create((set) => ({
                 ? { openInterest: match.openInterest, volume: match.volume }
                 : empty;
         })();
+        const getPrice = (metadata, symbol, field) => {
+            var _a;
+            if (isStableQuoteSymbol(symbol))
+                return 1;
+            return (_a = metadata === null || metadata === void 0 ? void 0 : metadata[field]) !== null && _a !== void 0 ? _a : 0;
+        };
+        const shouldUseAbsoluteQuoteRatio = isSingleAssetSideAgainstStableQuote(longTokens, shortTokens);
         // Price ratio (only when exactly one long and one short)
         const { priceRatio, priceRatio24h } = (() => {
-            var _a, _b, _c, _d;
             if (longTokens.length !== 1 || shortTokens.length !== 1) {
                 return { priceRatio: 1, priceRatio24h: 1 };
             }
@@ -1937,10 +1962,22 @@ const useTokenSelectionMetadataStore = create((set) => ({
             const shortSymbol = shortTokens[0].symbol;
             const longMeta = longTokensMetadata[longSymbol];
             const shortMeta = shortTokensMetadata[shortSymbol];
-            const currentLong = (_a = longMeta === null || longMeta === void 0 ? void 0 : longMeta.currentPrice) !== null && _a !== void 0 ? _a : 0;
-            const currentShort = (_b = shortMeta === null || shortMeta === void 0 ? void 0 : shortMeta.currentPrice) !== null && _b !== void 0 ? _b : 0;
-            const prevLong = (_c = longMeta === null || longMeta === void 0 ? void 0 : longMeta.prevDayPrice) !== null && _c !== void 0 ? _c : 0;
-            const prevShort = (_d = shortMeta === null || shortMeta === void 0 ? void 0 : shortMeta.prevDayPrice) !== null && _d !== void 0 ? _d : 0;
+            const currentLong = getPrice(longMeta, longSymbol, "currentPrice");
+            const currentShort = getPrice(shortMeta, shortSymbol, "currentPrice");
+            const prevLong = getPrice(longMeta, longSymbol, "prevDayPrice");
+            const prevShort = getPrice(shortMeta, shortSymbol, "prevDayPrice");
+            if (isStableQuoteSymbol(longSymbol) && !isStableQuoteSymbol(shortSymbol)) {
+                return {
+                    priceRatio: currentShort || 1,
+                    priceRatio24h: prevShort || 1,
+                };
+            }
+            if (isStableQuoteSymbol(shortSymbol) && !isStableQuoteSymbol(longSymbol)) {
+                return {
+                    priceRatio: currentLong || 1,
+                    priceRatio24h: prevLong || 1,
+                };
+            }
             const ratio = currentShort !== 0 ? currentLong / currentShort : 1;
             const ratio24h = prevShort !== 0 ? prevLong / prevShort : 1;
             return { priceRatio: ratio, priceRatio24h: ratio24h };
@@ -1951,16 +1988,20 @@ const useTokenSelectionMetadataStore = create((set) => ({
             let shortProduct = 1;
             longTokens.forEach((token) => {
                 const metadata = longTokensMetadata[token.symbol];
-                if ((metadata === null || metadata === void 0 ? void 0 : metadata.currentPrice) && token.weight > 0) {
+                const price = getPrice(metadata, token.symbol, "currentPrice");
+                if (price && token.weight > 0) {
                     const weightFactor = token.weight / 100;
-                    longProduct *= Math.pow(metadata.currentPrice, weightFactor);
+                    longProduct *= Math.pow(price, weightFactor);
                 }
             });
             shortTokens.forEach((token) => {
                 const metadata = shortTokensMetadata[token.symbol];
-                if ((metadata === null || metadata === void 0 ? void 0 : metadata.currentPrice) && token.weight > 0) {
-                    const weightFactor = token.weight / 100;
-                    shortProduct *= Math.pow(metadata.currentPrice, -weightFactor);
+                const price = getPrice(metadata, token.symbol, "currentPrice");
+                if (price && token.weight > 0) {
+                    const weightFactor = shouldUseAbsoluteQuoteRatio
+                        ? token.weight / 100
+                        : -(token.weight / 100);
+                    shortProduct *= Math.pow(price, weightFactor);
                 }
             });
             return longProduct * shortProduct;
@@ -1971,16 +2012,20 @@ const useTokenSelectionMetadataStore = create((set) => ({
             let shortProduct = 1;
             longTokens.forEach((token) => {
                 const metadata = longTokensMetadata[token.symbol];
-                if ((metadata === null || metadata === void 0 ? void 0 : metadata.prevDayPrice) && token.weight > 0) {
+                const price = getPrice(metadata, token.symbol, "prevDayPrice");
+                if (price && token.weight > 0) {
                     const weightFactor = token.weight / 100;
-                    longProduct *= Math.pow(metadata.prevDayPrice, weightFactor);
+                    longProduct *= Math.pow(price, weightFactor);
                 }
             });
             shortTokens.forEach((token) => {
                 const metadata = shortTokensMetadata[token.symbol];
-                if ((metadata === null || metadata === void 0 ? void 0 : metadata.prevDayPrice) && token.weight > 0) {
-                    const weightFactor = token.weight / 100;
-                    shortProduct *= Math.pow(metadata.prevDayPrice, -weightFactor);
+                const price = getPrice(metadata, token.symbol, "prevDayPrice");
+                if (price && token.weight > 0) {
+                    const weightFactor = shouldUseAbsoluteQuoteRatio
+                        ? token.weight / 100
+                        : -(token.weight / 100);
+                    shortProduct *= Math.pow(price, weightFactor);
                 }
             });
             return longProduct * shortProduct;
@@ -6440,7 +6485,7 @@ const useHistoricalPriceData = () => {
     const prevIntervalRef = useRef(null);
     // Get all tokens from long and short selections
     const getAllTokens = useCallback(() => {
-        return [...longTokens, ...shortTokens];
+        return [...longTokens, ...shortTokens].filter((token) => !isStableQuoteSymbol(token.symbol));
     }, [longTokens, shortTokens]);
     // Track token and interval changes and manage cache accordingly
     useEffect(() => {
@@ -6578,10 +6623,10 @@ const createCandleLookups = (tokenCandles) => {
 const calculateWeightedRatio = (longTokens, shortTokens, candleLookups, timestamp, priceType) => {
     let longProduct = 1;
     let shortProduct = 1;
+    const shouldUseAbsoluteQuoteRatio = isSingleAssetSideAgainstStableQuote(longTokens, shortTokens);
     // Long side: PRICE^(WEIGHT/100)
     for (const token of longTokens) {
-        const lookup = candleLookups[token.symbol];
-        const candle = lookup === null || lookup === void 0 ? void 0 : lookup.get(timestamp);
+        const candle = getCandleOrStableQuote(candleLookups, token.symbol, timestamp);
         if (candle) {
             const price = candle[priceType];
             if (price > 0) {
@@ -6595,13 +6640,14 @@ const calculateWeightedRatio = (longTokens, shortTokens, candleLookups, timestam
     }
     // Short side: PRICE^-(WEIGHT/100)
     for (const token of shortTokens) {
-        const lookup = candleLookups[token.symbol];
-        const candle = lookup === null || lookup === void 0 ? void 0 : lookup.get(timestamp);
+        const candle = getCandleOrStableQuote(candleLookups, token.symbol, timestamp);
         if (candle) {
             const price = candle[priceType];
             if (price > 0) {
-                const weightFactor = token.weight / 100;
-                shortProduct *= Math.pow(price, -weightFactor);
+                const weightFactor = shouldUseAbsoluteQuoteRatio
+                    ? token.weight / 100
+                    : -(token.weight / 100);
+                shortProduct *= Math.pow(price, weightFactor);
             }
         }
         else {
@@ -6654,19 +6700,37 @@ const getCompleteTimestamps = (candleLookups, requiredSymbols) => {
     result.sort((a, b) => a - b);
     return result;
 };
+const getRequiredSymbols = (longTokens, shortTokens) => [...longTokens, ...shortTokens]
+    .map((token) => token.symbol)
+    .filter((symbol) => !isStableQuoteSymbol(symbol));
+const getCandleOrStableQuote = (candleLookups, symbol, timestamp) => {
+    var _a, _b;
+    if (isStableQuoteSymbol(symbol)) {
+        return {
+            s: symbol,
+            t: timestamp,
+            T: timestamp,
+            o: 1,
+            h: 1,
+            l: 1,
+            c: 1,
+        };
+    }
+    return (_b = (_a = candleLookups[symbol]) === null || _a === void 0 ? void 0 : _a.get(timestamp)) !== null && _b !== void 0 ? _b : null;
+};
 /**
  * Compute basket candles from individual token candles using weighted ratios
  * Optimized version that creates lookup maps once and reuses them
  */
 const computeBasketCandles = (longTokens, shortTokens, tokenCandles) => {
-    var _a, _b;
     if (longTokens.length === 0 && shortTokens.length === 0) {
         return [];
     }
     // Create efficient lookup maps once
     const candleLookups = createCandleLookups(tokenCandles);
-    const allSymbols = [...longTokens, ...shortTokens].map(t => t.symbol);
+    const allSymbols = getRequiredSymbols(longTokens, shortTokens);
     const completeTimestamps = getCompleteTimestamps(candleLookups, allSymbols);
+    const shouldUseAbsoluteQuoteRatio = isSingleAssetSideAgainstStableQuote(longTokens, shortTokens);
     const basketCandles = [];
     for (const timestamp of completeTimestamps) {
         // Compute all OHLC products in a single pass per side
@@ -6676,7 +6740,7 @@ const computeBasketCandles = (longTokens, shortTokens, tokenCandles) => {
         let missing = false;
         // Accumulate volume/trades and compute long side contributions
         for (const token of longTokens) {
-            const candle = (_a = candleLookups[token.symbol]) === null || _a === void 0 ? void 0 : _a.get(timestamp);
+            const candle = getCandleOrStableQuote(candleLookups, token.symbol, timestamp);
             if (!candle) {
                 missing = true;
                 break;
@@ -6701,12 +6765,14 @@ const computeBasketCandles = (longTokens, shortTokens, tokenCandles) => {
             continue;
         // Short side contributions (negative exponent)
         for (const token of shortTokens) {
-            const candle = (_b = candleLookups[token.symbol]) === null || _b === void 0 ? void 0 : _b.get(timestamp);
+            const candle = getCandleOrStableQuote(candleLookups, token.symbol, timestamp);
             if (!candle) {
                 missing = true;
                 break;
             }
-            const weightFactor = -(token.weight / 100);
+            const weightFactor = shouldUseAbsoluteQuoteRatio
+                ? token.weight / 100
+                : -(token.weight / 100);
             const o = candle.o;
             const h = candle.h;
             const l = candle.l;
@@ -6780,7 +6846,7 @@ const useBasketCandles = () => {
     const fetchOverallPerformanceCandles = useCallback(async (startTime, endTime, interval) => {
         await fetchHistoricalPriceData(startTime, endTime, interval);
         const allCandles = await getAllHistoricalPriceData();
-        const allTokens = [...longTokens, ...shortTokens];
+        const allTokens = [...longTokens, ...shortTokens].filter((token) => !isStableQuoteSymbol(token.symbol));
         if (allTokens.length === 0)
             return [];
         const symbolsData = {};
@@ -6880,6 +6946,8 @@ const useBasketCandles = () => {
         let t = null;
         let T = null;
         for (const symbol of symbolSet) {
+            if (isStableQuoteSymbol(symbol))
+                continue;
             const c = candleData.get(symbol);
             if (!c)
                 return null; // missing latest candle for symbol
@@ -6894,6 +6962,17 @@ const useBasketCandles = () => {
         const intervalMs = CANDLE_INTERVAL_MS[candleInterval];
         const maxCarryForwardMs = intervalMs * 2;
         const getCandleForTargetWindow = (symbol) => {
+            if (isStableQuoteSymbol(symbol)) {
+                return {
+                    s: symbol,
+                    t,
+                    T,
+                    o: 1,
+                    h: 1,
+                    l: 1,
+                    c: 1,
+                };
+            }
             const c = snapshot[symbol];
             if (c.t === t)
                 return c;
@@ -6915,6 +6994,7 @@ const useBasketCandles = () => {
         // Compute weighted OHLC similar to computeBasketCandles
         let longOpen = 1, longHigh = 1, longLow = 1, longClose = 1;
         let shortOpen = 1, shortHigh = 1, shortLow = 1, shortClose = 1;
+        const shouldUseAbsoluteQuoteRatio = isSingleAssetSideAgainstStableQuote(longTokens, shortTokens);
         for (const token of longTokens) {
             const c = getCandleForTargetWindow(token.symbol);
             if (!c)
@@ -6932,7 +7012,9 @@ const useBasketCandles = () => {
             const c = getCandleForTargetWindow(token.symbol);
             if (!c)
                 return null;
-            const w = -(token.weight / 100);
+            const w = shouldUseAbsoluteQuoteRatio
+                ? token.weight / 100
+                : -(token.weight / 100);
             const o = c.o, h = c.h, l = c.l, cl = c.c;
             if (!(o > 0 && h > 0 && l > 0 && cl > 0))
                 return null;

package/dist/utils/quote-assets.d.ts

@@ -0,0 +1,6 @@
+import type { TokenSelection } from '../types';
+export declare const STABLE_QUOTE_SYMBOLS: Set<string>;
+export declare const isStableQuoteSymbol: (symbol: string) => boolean;
+export declare const hasNonStableTokens: (tokens: TokenSelection[]) => boolean;
+export declare const isStableOnlySide: (tokens: TokenSelection[]) => boolean;
+export declare const isSingleAssetSideAgainstStableQuote: (longTokens: TokenSelection[], shortTokens: TokenSelection[]) => boolean;

package/package.json

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