@metamask-previews/perps-controller 0.0.0-preview-685dbf46b → 1.0.0-preview-bc00f2c

package/dist/utils/index.d.mts

@@ -0,0 +1,25 @@
+/**
+ * Barrel re-export for all portable utilities in controllers/utils/
+ *
+ * Note: hyperLiquidAdapter and orderCalculations both export calculatePositionSize.
+ * We use selective exports to avoid the name collision.
+ */
+export * from "./accountUtils.mjs";
+export * from "./errorUtils.mjs";
+export { adaptOrderToSDK, adaptPositionFromSDK, adaptOrderFromSDK, adaptMarketFromSDK, adaptAccountStateFromSDK, buildAssetMapping, formatHyperLiquidPrice, formatHyperLiquidSize, calculateHip3AssetId, parseAssetName, adaptHyperLiquidLedgerUpdateToUserHistoryItem, } from "./hyperLiquidAdapter.mjs";
+export * from "./hyperLiquidOrderBookProcessor.mjs";
+export * from "./hyperLiquidValidation.mjs";
+export * from "./idUtils.mjs";
+export * from "./marketDataTransform.mjs";
+export * from "./myxAdapter.mjs";
+export * from "./marketUtils.mjs";
+export * from "./orderCalculations.mjs";
+export * from "./rewardsUtils.mjs";
+export * from "./significantFigures.mjs";
+export * from "./sortMarkets.mjs";
+export * from "./standaloneInfoClient.mjs";
+export * from "./stringParseUtils.mjs";
+export * from "./transferData.mjs";
+export * from "./wait.mjs";
+export declare const getEnvironment: () => 'DEV' | 'PROD';
+//# sourceMappingURL=index.d.mts.map

package/dist/utils/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,mCAA+B;AAC/B,iCAA6B;AAE7B,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EAClB,wBAAwB,EACxB,iBAAiB,EACjB,sBAAsB,EACtB,qBAAqB,EACrB,oBAAoB,EACpB,cAAc,EACd,6CAA6C,GAC9C,iCAA6B;AAC9B,oDAAgD;AAChD,4CAAwC;AACxC,8BAA0B;AAC1B,0CAAsC;AACtC,iCAA6B;AAC7B,kCAA8B;AAC9B,wCAAoC;AACpC,mCAA+B;AAC/B,yCAAqC;AACrC,kCAA8B;AAC9B,2CAAuC;AACvC,uCAAmC;AACnC,mCAA+B;AAC/B,2BAAuB;AAGvB,eAAO,MAAM,cAAc,QAAO,KAAK,GAAG,MAGzC,CAAC"}

package/dist/utils/index.mjs

@@ -0,0 +1,30 @@
+/**
+ * Barrel re-export for all portable utilities in controllers/utils/
+ *
+ * Note: hyperLiquidAdapter and orderCalculations both export calculatePositionSize.
+ * We use selective exports to avoid the name collision.
+ */
+export * from "./accountUtils.mjs";
+export * from "./errorUtils.mjs";
+// hyperLiquidAdapter: selective export to avoid calculatePositionSize clash with orderCalculations
+export { adaptOrderToSDK, adaptPositionFromSDK, adaptOrderFromSDK, adaptMarketFromSDK, adaptAccountStateFromSDK, buildAssetMapping, formatHyperLiquidPrice, formatHyperLiquidSize, calculateHip3AssetId, parseAssetName, adaptHyperLiquidLedgerUpdateToUserHistoryItem } from "./hyperLiquidAdapter.mjs";
+export * from "./hyperLiquidOrderBookProcessor.mjs";
+export * from "./hyperLiquidValidation.mjs";
+export * from "./idUtils.mjs";
+export * from "./marketDataTransform.mjs";
+export * from "./myxAdapter.mjs";
+export * from "./marketUtils.mjs";
+export * from "./orderCalculations.mjs";
+export * from "./rewardsUtils.mjs";
+export * from "./significantFigures.mjs";
+export * from "./sortMarkets.mjs";
+export * from "./standaloneInfoClient.mjs";
+export * from "./stringParseUtils.mjs";
+export * from "./transferData.mjs";
+export * from "./wait.mjs";
+// Inline from former utils.ts (getEnvironment was previously at perps/utils.ts root)
+export const getEnvironment = () => {
+    const env = globalThis.process?.env?.NODE_ENV ?? 'production';
+    return env === 'production' ? 'PROD' : 'DEV';
+};
+//# sourceMappingURL=index.mjs.map

package/dist/utils/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,mCAA+B;AAC/B,iCAA6B;AAC7B,mGAAmG;AACnG,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EAClB,wBAAwB,EACxB,iBAAiB,EACjB,sBAAsB,EACtB,qBAAqB,EACrB,oBAAoB,EACpB,cAAc,EACd,6CAA6C,EAC9C,iCAA6B;AAC9B,oDAAgD;AAChD,4CAAwC;AACxC,8BAA0B;AAC1B,0CAAsC;AACtC,iCAA6B;AAC7B,kCAA8B;AAC9B,wCAAoC;AACpC,mCAA+B;AAC/B,yCAAqC;AACrC,kCAA8B;AAC9B,2CAAuC;AACvC,uCAAmC;AACnC,mCAA+B;AAC/B,2BAAuB;AAEvB,qFAAqF;AACrF,MAAM,CAAC,MAAM,cAAc,GAAG,GAAmB,EAAE;IACjD,MAAM,GAAG,GAAG,UAAU,CAAC,OAAO,EAAE,GAAG,EAAE,QAAQ,IAAI,YAAY,CAAC;IAC9D,OAAO,GAAG,KAAK,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC;AAC/C,CAAC,CAAC","sourcesContent":["/**\n * Barrel re-export for all portable utilities in controllers/utils/\n *\n * Note: hyperLiquidAdapter and orderCalculations both export calculatePositionSize.\n * We use selective exports to avoid the name collision.\n */\nexport * from './accountUtils';\nexport * from './errorUtils';\n// hyperLiquidAdapter: selective export to avoid calculatePositionSize clash with orderCalculations\nexport {\n  adaptOrderToSDK,\n  adaptPositionFromSDK,\n  adaptOrderFromSDK,\n  adaptMarketFromSDK,\n  adaptAccountStateFromSDK,\n  buildAssetMapping,\n  formatHyperLiquidPrice,\n  formatHyperLiquidSize,\n  calculateHip3AssetId,\n  parseAssetName,\n  adaptHyperLiquidLedgerUpdateToUserHistoryItem,\n} from './hyperLiquidAdapter';\nexport * from './hyperLiquidOrderBookProcessor';\nexport * from './hyperLiquidValidation';\nexport * from './idUtils';\nexport * from './marketDataTransform';\nexport * from './myxAdapter';\nexport * from './marketUtils';\nexport * from './orderCalculations';\nexport * from './rewardsUtils';\nexport * from './significantFigures';\nexport * from './sortMarkets';\nexport * from './standaloneInfoClient';\nexport * from './stringParseUtils';\nexport * from './transferData';\nexport * from './wait';\n\n// Inline from former utils.ts (getEnvironment was previously at perps/utils.ts root)\nexport const getEnvironment = (): 'DEV' | 'PROD' => {\n  const env = globalThis.process?.env?.NODE_ENV ?? 'production';\n  return env === 'production' ? 'PROD' : 'DEV';\n};\n"]}

package/dist/utils/marketDataTransform.cjs

@@ -0,0 +1,211 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatChange = exports.transformMarketData = exports.calculateOpenInterestUSD = void 0;
+/**
+ * Market data transformation utilities.
+ *
+ * Portable: no mobile-specific imports.
+ * Formatters are injected via MarketDataFormatters interface.
+ */
+const hyperLiquidAdapter_1 = require("./hyperLiquidAdapter.cjs");
+const hyperLiquidConfig_1 = require("../constants/hyperLiquidConfig.cjs");
+const perpsConfig_1 = require("../constants/perpsConfig.cjs");
+/**
+ * Calculate open interest in USD
+ * Open interest from HyperLiquid is in contracts/units, not USD
+ * To get USD value, multiply by current price
+ *
+ * @param openInterest - Raw open interest value in contracts/units
+ * @param currentPrice - Current price of the asset
+ * @returns Open interest in USD, or NaN if invalid
+ */
+function calculateOpenInterestUSD(openInterest, currentPrice) {
+    if (openInterest === undefined || currentPrice === undefined) {
+        return NaN;
+    }
+    const openInterestNum = typeof openInterest === 'string' ? parseFloat(openInterest) : openInterest;
+    const priceNum = typeof currentPrice === 'string' ? parseFloat(currentPrice) : currentPrice;
+    if (isNaN(openInterestNum) || isNaN(priceNum)) {
+        return NaN;
+    }
+    return openInterestNum * priceNum;
+}
+exports.calculateOpenInterestUSD = calculateOpenInterestUSD;
+/**
+ * Calculate 24h percentage change
+ * Shows -100% when current price is missing but previous price exists
+ *
+ * @param params - The parameters for calculating the 24h change.
+ * @returns The 24h percentage change value.
+ */
+function calculateChange24hPercent(params) {
+    const { hasCurrentPrice, currentPrice, prevDayPrice } = params;
+    if (!hasCurrentPrice) {
+        return prevDayPrice > 0 ? -100 : 0;
+    }
+    if (prevDayPrice <= 0) {
+        return 0;
+    }
+    return ((currentPrice - prevDayPrice) / prevDayPrice) * 100;
+}
+/**
+ * Extract funding data for a symbol from predicted fundings.
+ * Looks for specified exchange first, falls back to first available.
+ *
+ * @param params - Parameters for extracting funding data
+ * @param params.predictedFundings - Array of predicted funding data
+ * @param params.symbol - Asset symbol to extract funding for
+ * @param params.exchangeName - Exchange to prioritize (defaults to HyperLiquid's 'HlPerp')
+ * @returns Funding data including next funding time, interval, and predicted rate
+ */
+function extractFundingData(params) {
+    const { predictedFundings, symbol, exchangeName = hyperLiquidConfig_1.HYPERLIQUID_CONFIG.ExchangeName, } = params;
+    const result = {};
+    if (!predictedFundings) {
+        return result;
+    }
+    const fundingData = predictedFundings.find(([assetSymbol]) => assetSymbol === symbol);
+    if (!fundingData?.[1] ||
+        !Array.isArray(fundingData[1]) ||
+        fundingData[1].length === 0) {
+        return result;
+    }
+    // Look for specified exchange (e.g., 'HlPerp' for HyperLiquid)
+    const targetExchange = fundingData[1].find((exchange) => Array.isArray(exchange) && exchange[0] === exchangeName);
+    if (targetExchange?.[1]) {
+        result.nextFundingTime = targetExchange[1].nextFundingTime;
+        result.fundingIntervalHours = targetExchange[1].fundingIntervalHours;
+        result.predictedFundingRate = parseFloat(targetExchange[1].fundingRate);
+        return result;
+    }
+    // Fallback to first exchange if target not found
+    const firstExchange = fundingData[1][0];
+    if (Array.isArray(firstExchange) && firstExchange[1]) {
+        result.nextFundingTime = firstExchange[1].nextFundingTime;
+        result.fundingIntervalHours = firstExchange[1].fundingIntervalHours;
+    }
+    return result;
+}
+/**
+ * Transform raw HyperLiquid market data to UI-friendly format
+ *
+ * @param hyperLiquidData - Raw data from HyperLiquid API
+ * @param formatters - Injectable formatters for platform-agnostic formatting
+ * @param assetMarketTypes - Optional mapping of asset symbols to market types
+ * @returns Transformed market data ready for UI consumption
+ */
+function transformMarketData(hyperLiquidData, formatters, assetMarketTypes) {
+    const { universe, assetCtxs, allMids, predictedFundings } = hyperLiquidData;
+    return universe.map((asset, index) => {
+        const symbol = asset.name;
+        const currentPrice = parseFloat(allMids[symbol]);
+        // Find matching asset context for additional data
+        // The assetCtxs array is aligned with universe array by index
+        const assetCtx = assetCtxs[index];
+        // Calculate 24h change
+        const prevDayPrice = assetCtx ? parseFloat(assetCtx.prevDayPx) : 0;
+        // Handle missing current price data
+        const hasCurrentPrice = !isNaN(currentPrice);
+        const effectiveCurrentPrice = hasCurrentPrice ? currentPrice : 0;
+        // For dollar change: show $0.00 when current price is missing
+        const change24h = hasCurrentPrice
+            ? effectiveCurrentPrice - prevDayPrice
+            : 0;
+        // For percentage: show -100% when current price is missing but previous price exists
+        const change24hPercent = calculateChange24hPercent({
+            hasCurrentPrice,
+            currentPrice: effectiveCurrentPrice,
+            prevDayPrice,
+        });
+        // Format volume (dayNtlVlm is daily notional volume)
+        // If assetCtx is missing or dayNtlVlm is not available, use NaN to indicate missing data
+        const volume = assetCtx?.dayNtlVlm ? parseFloat(assetCtx.dayNtlVlm) : NaN;
+        // Calculate open interest in USD
+        const openInterest = calculateOpenInterestUSD(assetCtx?.openInterest, currentPrice);
+        // Get current funding rate from assetCtx - this is the actual current funding rate
+        let fundingRate;
+        if (assetCtx && 'funding' in assetCtx) {
+            fundingRate = parseFloat(assetCtx.funding);
+        }
+        // Extract funding timing and predicted rate
+        const fundingData = extractFundingData({
+            predictedFundings,
+            symbol,
+        });
+        // Use current funding rate from assetCtx, not predicted
+        // The predicted rate is for the next funding period
+        if (!fundingRate && fundingData.predictedFundingRate !== undefined) {
+            fundingRate = fundingData.predictedFundingRate;
+        }
+        // Extract DEX and base symbol for display
+        // e.g., "flx:TSLA" → { dex: "flx", symbol: "TSLA" }
+        const { dex } = (0, hyperLiquidAdapter_1.parseAssetName)(symbol);
+        const marketSource = dex ?? undefined;
+        // HIP-3 markets have a DEX prefix (e.g., xyz:TSLA, flx:GOLD)
+        // Crypto markets (HIP-2) don't have a prefix (e.g., BTC, ETH)
+        const isHip3 = Boolean(dex);
+        // Determine market type from explicit mapping only
+        // Only explicitly mapped HIP-3 markets get a marketType (e.g., 'xyz:GOLD' → 'commodity')
+        // Unmapped HIP-3 markets (e.g., 'hyna:BTC') have no marketType - they go to "New" tab
+        // Main DEX crypto also has no marketType
+        const explicitMarketType = assetMarketTypes?.[symbol];
+        const marketType = explicitMarketType;
+        // Mark as "new" if it's a HIP-3 market but not explicitly categorized
+        // New markets are always HIP-3 (non-crypto) that haven't been assigned a category yet
+        const isNewMarket = isHip3 && !explicitMarketType;
+        return {
+            symbol,
+            name: symbol,
+            maxLeverage: `${asset.maxLeverage}x`,
+            price: isNaN(currentPrice)
+                ? perpsConfig_1.PERPS_CONSTANTS.FallbackPriceDisplay
+                : formatters.formatPerpsFiat(currentPrice, {
+                    ranges: formatters.priceRangesUniversal,
+                }),
+            change24h: isNaN(change24h)
+                ? perpsConfig_1.PERPS_CONSTANTS.ZeroAmountDetailedDisplay
+                : formatChange(change24h, formatters),
+            change24hPercent: isNaN(change24hPercent)
+                ? '0.00%'
+                : formatters.formatPercentage(change24hPercent),
+            volume: isNaN(volume)
+                ? perpsConfig_1.PERPS_CONSTANTS.FallbackPriceDisplay
+                : formatters.formatVolume(volume),
+            openInterest: isNaN(openInterest)
+                ? perpsConfig_1.PERPS_CONSTANTS.FallbackPriceDisplay
+                : formatters.formatVolume(openInterest),
+            nextFundingTime: fundingData.nextFundingTime,
+            fundingIntervalHours: fundingData.fundingIntervalHours,
+            fundingRate,
+            marketSource,
+            marketType,
+            isHip3,
+            isNewMarket,
+        };
+    });
+}
+exports.transformMarketData = transformMarketData;
+/**
+ * Format 24h change with sign.
+ * Uses more decimal places for smaller amounts to show meaningful precision.
+ *
+ * @param change - The price change value to format
+ * @param formatters - Injectable formatters
+ * @returns Formatted change string with sign and dollar symbol
+ */
+function formatChange(change, formatters) {
+    if (isNaN(change) || !isFinite(change)) {
+        return '$0.00';
+    }
+    if (change === 0) {
+        return '$0.00';
+    }
+    const formatted = formatters.formatPerpsFiat(Math.abs(change), {
+        ranges: formatters.priceRangesUniversal,
+    });
+    // Remove $ sign and add it back with proper sign placement
+    const valueWithoutDollar = formatted.replace('$', '');
+    return change > 0 ? `+$${valueWithoutDollar}` : `-$${valueWithoutDollar}`;
+}
+exports.formatChange = formatChange;
+//# sourceMappingURL=marketDataTransform.cjs.map

package/dist/utils/marketDataTransform.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"marketDataTransform.cjs","sourceRoot":"","sources":["../../src/utils/marketDataTransform.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Market data transformation utilities.\n *\n * Portable: no mobile-specific imports.\n * Formatters are injected via MarketDataFormatters interface.\n */\nimport { parseAssetName } from './hyperLiquidAdapter';\nimport { HYPERLIQUID_CONFIG } from '../constants/hyperLiquidConfig';\nimport { PERPS_CONSTANTS } from '../constants/perpsConfig';\nimport type {\n  PerpsMarketData,\n  MarketType,\n  MarketDataFormatters,\n} from '../types';\nimport type {\n  AllMidsResponse,\n  PerpsUniverse,\n  PerpsAssetCtx,\n  PredictedFunding,\n} from '../types/hyperliquid-types';\n\n/**\n * Calculate open interest in USD\n * Open interest from HyperLiquid is in contracts/units, not USD\n * To get USD value, multiply by current price\n *\n * @param openInterest - Raw open interest value in contracts/units\n * @param currentPrice - Current price of the asset\n * @returns Open interest in USD, or NaN if invalid\n */\nexport function calculateOpenInterestUSD(\n  openInterest: string | number | undefined,\n  currentPrice: string | number | undefined,\n): number {\n  if (openInterest === undefined || currentPrice === undefined) {\n    return NaN;\n  }\n\n  const openInterestNum =\n    typeof openInterest === 'string' ? parseFloat(openInterest) : openInterest;\n  const priceNum =\n    typeof currentPrice === 'string' ? parseFloat(currentPrice) : currentPrice;\n\n  if (isNaN(openInterestNum) || isNaN(priceNum)) {\n    return NaN;\n  }\n\n  return openInterestNum * priceNum;\n}\n\n/**\n * HyperLiquid-specific market data structure\n */\nexport type HyperLiquidMarketData = {\n  universe: PerpsUniverse[];\n  assetCtxs: PerpsAssetCtx[];\n  allMids: AllMidsResponse;\n  predictedFundings?: PredictedFunding[];\n};\n\n/**\n * Parameters for calculating 24h percentage change\n */\ntype CalculateChange24hPercentParams = {\n  hasCurrentPrice: boolean;\n  currentPrice: number;\n  prevDayPrice: number;\n};\n\n/**\n * Calculate 24h percentage change\n * Shows -100% when current price is missing but previous price exists\n *\n * @param params - The parameters for calculating the 24h change.\n * @returns The 24h percentage change value.\n */\nfunction calculateChange24hPercent(\n  params: CalculateChange24hPercentParams,\n): number {\n  const { hasCurrentPrice, currentPrice, prevDayPrice } = params;\n\n  if (!hasCurrentPrice) {\n    return prevDayPrice > 0 ? -100 : 0;\n  }\n\n  if (prevDayPrice <= 0) {\n    return 0;\n  }\n\n  return ((currentPrice - prevDayPrice) / prevDayPrice) * 100;\n}\n\n/**\n * Funding data extracted from predicted fundings\n */\ntype FundingData = {\n  nextFundingTime?: number;\n  fundingIntervalHours?: number;\n  predictedFundingRate?: number;\n};\n\n/**\n * Parameters for extracting funding data\n */\ntype ExtractFundingDataParams = {\n  predictedFundings?: PredictedFunding[];\n  symbol: string;\n  exchangeName?: string;\n};\n\n/**\n * Extract funding data for a symbol from predicted fundings.\n * Looks for specified exchange first, falls back to first available.\n *\n * @param params - Parameters for extracting funding data\n * @param params.predictedFundings - Array of predicted funding data\n * @param params.symbol - Asset symbol to extract funding for\n * @param params.exchangeName - Exchange to prioritize (defaults to HyperLiquid's 'HlPerp')\n * @returns Funding data including next funding time, interval, and predicted rate\n */\nfunction extractFundingData(params: ExtractFundingDataParams): FundingData {\n  const {\n    predictedFundings,\n    symbol,\n    exchangeName = HYPERLIQUID_CONFIG.ExchangeName,\n  } = params;\n\n  const result: FundingData = {};\n\n  if (!predictedFundings) {\n    return result;\n  }\n\n  const fundingData = predictedFundings.find(\n    ([assetSymbol]) => assetSymbol === symbol,\n  );\n\n  if (\n    !fundingData?.[1] ||\n    !Array.isArray(fundingData[1]) ||\n    fundingData[1].length === 0\n  ) {\n    return result;\n  }\n\n  // Look for specified exchange (e.g., 'HlPerp' for HyperLiquid)\n  const targetExchange = fundingData[1].find(\n    (exchange: unknown) =>\n      Array.isArray(exchange) && exchange[0] === exchangeName,\n  );\n\n  if (targetExchange?.[1]) {\n    result.nextFundingTime = targetExchange[1].nextFundingTime;\n    result.fundingIntervalHours = targetExchange[1].fundingIntervalHours;\n    result.predictedFundingRate = parseFloat(targetExchange[1].fundingRate);\n    return result;\n  }\n\n  // Fallback to first exchange if target not found\n  const firstExchange = fundingData[1][0];\n  if (Array.isArray(firstExchange) && firstExchange[1]) {\n    result.nextFundingTime = firstExchange[1].nextFundingTime;\n    result.fundingIntervalHours = firstExchange[1].fundingIntervalHours;\n  }\n\n  return result;\n}\n\n/**\n * Transform raw HyperLiquid market data to UI-friendly format\n *\n * @param hyperLiquidData - Raw data from HyperLiquid API\n * @param formatters - Injectable formatters for platform-agnostic formatting\n * @param assetMarketTypes - Optional mapping of asset symbols to market types\n * @returns Transformed market data ready for UI consumption\n */\nexport function transformMarketData(\n  hyperLiquidData: HyperLiquidMarketData,\n  formatters: MarketDataFormatters,\n  assetMarketTypes?: Record<string, MarketType>,\n): PerpsMarketData[] {\n  const { universe, assetCtxs, allMids, predictedFundings } = hyperLiquidData;\n\n  return universe.map((asset, index) => {\n    const symbol = asset.name;\n    const currentPrice = parseFloat(allMids[symbol]);\n\n    // Find matching asset context for additional data\n    // The assetCtxs array is aligned with universe array by index\n    const assetCtx = assetCtxs[index];\n\n    // Calculate 24h change\n    const prevDayPrice = assetCtx ? parseFloat(assetCtx.prevDayPx) : 0;\n\n    // Handle missing current price data\n    const hasCurrentPrice = !isNaN(currentPrice);\n    const effectiveCurrentPrice = hasCurrentPrice ? currentPrice : 0;\n\n    // For dollar change: show $0.00 when current price is missing\n    const change24h = hasCurrentPrice\n      ? effectiveCurrentPrice - prevDayPrice\n      : 0;\n\n    // For percentage: show -100% when current price is missing but previous price exists\n    const change24hPercent = calculateChange24hPercent({\n      hasCurrentPrice,\n      currentPrice: effectiveCurrentPrice,\n      prevDayPrice,\n    });\n\n    // Format volume (dayNtlVlm is daily notional volume)\n    // If assetCtx is missing or dayNtlVlm is not available, use NaN to indicate missing data\n    const volume = assetCtx?.dayNtlVlm ? parseFloat(assetCtx.dayNtlVlm) : NaN;\n\n    // Calculate open interest in USD\n    const openInterest = calculateOpenInterestUSD(\n      assetCtx?.openInterest,\n      currentPrice,\n    );\n\n    // Get current funding rate from assetCtx - this is the actual current funding rate\n    let fundingRate: number | undefined;\n\n    if (assetCtx && 'funding' in assetCtx) {\n      fundingRate = parseFloat(assetCtx.funding);\n    }\n\n    // Extract funding timing and predicted rate\n    const fundingData = extractFundingData({\n      predictedFundings,\n      symbol,\n    });\n\n    // Use current funding rate from assetCtx, not predicted\n    // The predicted rate is for the next funding period\n    if (!fundingRate && fundingData.predictedFundingRate !== undefined) {\n      fundingRate = fundingData.predictedFundingRate;\n    }\n\n    // Extract DEX and base symbol for display\n    // e.g., \"flx:TSLA\" → { dex: \"flx\", symbol: \"TSLA\" }\n    const { dex } = parseAssetName(symbol);\n    const marketSource = dex ?? undefined;\n\n    // HIP-3 markets have a DEX prefix (e.g., xyz:TSLA, flx:GOLD)\n    // Crypto markets (HIP-2) don't have a prefix (e.g., BTC, ETH)\n    const isHip3 = Boolean(dex);\n\n    // Determine market type from explicit mapping only\n    // Only explicitly mapped HIP-3 markets get a marketType (e.g., 'xyz:GOLD' → 'commodity')\n    // Unmapped HIP-3 markets (e.g., 'hyna:BTC') have no marketType - they go to \"New\" tab\n    // Main DEX crypto also has no marketType\n    const explicitMarketType = assetMarketTypes?.[symbol];\n    const marketType: MarketType | undefined = explicitMarketType;\n\n    // Mark as \"new\" if it's a HIP-3 market but not explicitly categorized\n    // New markets are always HIP-3 (non-crypto) that haven't been assigned a category yet\n    const isNewMarket = isHip3 && !explicitMarketType;\n\n    return {\n      symbol,\n      name: symbol,\n      maxLeverage: `${asset.maxLeverage}x`,\n      price: isNaN(currentPrice)\n        ? PERPS_CONSTANTS.FallbackPriceDisplay\n        : formatters.formatPerpsFiat(currentPrice, {\n            ranges: formatters.priceRangesUniversal,\n          }),\n      change24h: isNaN(change24h)\n        ? PERPS_CONSTANTS.ZeroAmountDetailedDisplay\n        : formatChange(change24h, formatters),\n      change24hPercent: isNaN(change24hPercent)\n        ? '0.00%'\n        : formatters.formatPercentage(change24hPercent),\n      volume: isNaN(volume)\n        ? PERPS_CONSTANTS.FallbackPriceDisplay\n        : formatters.formatVolume(volume),\n      openInterest: isNaN(openInterest)\n        ? PERPS_CONSTANTS.FallbackPriceDisplay\n        : formatters.formatVolume(openInterest),\n      nextFundingTime: fundingData.nextFundingTime,\n      fundingIntervalHours: fundingData.fundingIntervalHours,\n      fundingRate,\n      marketSource,\n      marketType,\n      isHip3,\n      isNewMarket,\n    };\n  });\n}\n\n/**\n * Format 24h change with sign.\n * Uses more decimal places for smaller amounts to show meaningful precision.\n *\n * @param change - The price change value to format\n * @param formatters - Injectable formatters\n * @returns Formatted change string with sign and dollar symbol\n */\nexport function formatChange(\n  change: number,\n  formatters: MarketDataFormatters,\n): string {\n  if (isNaN(change) || !isFinite(change)) {\n    return '$0.00';\n  }\n  if (change === 0) {\n    return '$0.00';\n  }\n\n  const formatted = formatters.formatPerpsFiat(Math.abs(change), {\n    ranges: formatters.priceRangesUniversal,\n  });\n\n  // Remove $ sign and add it back with proper sign placement\n  const valueWithoutDollar = formatted.replace('$', '');\n  return change > 0 ? `+$${valueWithoutDollar}` : `-$${valueWithoutDollar}`;\n}\n"]}

package/dist/utils/marketDataTransform.d.cts

@@ -0,0 +1,40 @@
+import type { PerpsMarketData, MarketType, MarketDataFormatters } from "../types/index.cjs";
+import type { AllMidsResponse, PerpsUniverse, PerpsAssetCtx, PredictedFunding } from "../types/hyperliquid-types.cjs";
+/**
+ * Calculate open interest in USD
+ * Open interest from HyperLiquid is in contracts/units, not USD
+ * To get USD value, multiply by current price
+ *
+ * @param openInterest - Raw open interest value in contracts/units
+ * @param currentPrice - Current price of the asset
+ * @returns Open interest in USD, or NaN if invalid
+ */
+export declare function calculateOpenInterestUSD(openInterest: string | number | undefined, currentPrice: string | number | undefined): number;
+/**
+ * HyperLiquid-specific market data structure
+ */
+export type HyperLiquidMarketData = {
+    universe: PerpsUniverse[];
+    assetCtxs: PerpsAssetCtx[];
+    allMids: AllMidsResponse;
+    predictedFundings?: PredictedFunding[];
+};
+/**
+ * Transform raw HyperLiquid market data to UI-friendly format
+ *
+ * @param hyperLiquidData - Raw data from HyperLiquid API
+ * @param formatters - Injectable formatters for platform-agnostic formatting
+ * @param assetMarketTypes - Optional mapping of asset symbols to market types
+ * @returns Transformed market data ready for UI consumption
+ */
+export declare function transformMarketData(hyperLiquidData: HyperLiquidMarketData, formatters: MarketDataFormatters, assetMarketTypes?: Record<string, MarketType>): PerpsMarketData[];
+/**
+ * Format 24h change with sign.
+ * Uses more decimal places for smaller amounts to show meaningful precision.
+ *
+ * @param change - The price change value to format
+ * @param formatters - Injectable formatters
+ * @returns Formatted change string with sign and dollar symbol
+ */
+export declare function formatChange(change: number, formatters: MarketDataFormatters): string;
+//# sourceMappingURL=marketDataTransform.d.cts.map

package/dist/utils/marketDataTransform.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"marketDataTransform.d.cts","sourceRoot":"","sources":["../../src/utils/marketDataTransform.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EACV,eAAe,EACf,UAAU,EACV,oBAAoB,EACrB,2BAAiB;AAClB,OAAO,KAAK,EACV,eAAe,EACf,aAAa,EACb,aAAa,EACb,gBAAgB,EACjB,uCAAmC;AAEpC;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CACtC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,EACzC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GACxC,MAAM,CAeR;AAED;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,SAAS,EAAE,aAAa,EAAE,CAAC;IAC3B,OAAO,EAAE,eAAe,CAAC;IACzB,iBAAiB,CAAC,EAAE,gBAAgB,EAAE,CAAC;CACxC,CAAC;AA8GF;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,eAAe,EAAE,qBAAqB,EACtC,UAAU,EAAE,oBAAoB,EAChC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,GAC5C,eAAe,EAAE,CA6GnB;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,oBAAoB,GAC/B,MAAM,CAeR"}

package/dist/utils/marketDataTransform.d.mts

@@ -0,0 +1,40 @@
+import type { PerpsMarketData, MarketType, MarketDataFormatters } from "../types/index.mjs";
+import type { AllMidsResponse, PerpsUniverse, PerpsAssetCtx, PredictedFunding } from "../types/hyperliquid-types.mjs";
+/**
+ * Calculate open interest in USD
+ * Open interest from HyperLiquid is in contracts/units, not USD
+ * To get USD value, multiply by current price
+ *
+ * @param openInterest - Raw open interest value in contracts/units
+ * @param currentPrice - Current price of the asset
+ * @returns Open interest in USD, or NaN if invalid
+ */
+export declare function calculateOpenInterestUSD(openInterest: string | number | undefined, currentPrice: string | number | undefined): number;
+/**
+ * HyperLiquid-specific market data structure
+ */
+export type HyperLiquidMarketData = {
+    universe: PerpsUniverse[];
+    assetCtxs: PerpsAssetCtx[];
+    allMids: AllMidsResponse;
+    predictedFundings?: PredictedFunding[];
+};
+/**
+ * Transform raw HyperLiquid market data to UI-friendly format
+ *
+ * @param hyperLiquidData - Raw data from HyperLiquid API
+ * @param formatters - Injectable formatters for platform-agnostic formatting
+ * @param assetMarketTypes - Optional mapping of asset symbols to market types
+ * @returns Transformed market data ready for UI consumption
+ */
+export declare function transformMarketData(hyperLiquidData: HyperLiquidMarketData, formatters: MarketDataFormatters, assetMarketTypes?: Record<string, MarketType>): PerpsMarketData[];
+/**
+ * Format 24h change with sign.
+ * Uses more decimal places for smaller amounts to show meaningful precision.
+ *
+ * @param change - The price change value to format
+ * @param formatters - Injectable formatters
+ * @returns Formatted change string with sign and dollar symbol
+ */
+export declare function formatChange(change: number, formatters: MarketDataFormatters): string;
+//# sourceMappingURL=marketDataTransform.d.mts.map

package/dist/utils/marketDataTransform.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"marketDataTransform.d.mts","sourceRoot":"","sources":["../../src/utils/marketDataTransform.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EACV,eAAe,EACf,UAAU,EACV,oBAAoB,EACrB,2BAAiB;AAClB,OAAO,KAAK,EACV,eAAe,EACf,aAAa,EACb,aAAa,EACb,gBAAgB,EACjB,uCAAmC;AAEpC;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CACtC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,EACzC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GACxC,MAAM,CAeR;AAED;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,SAAS,EAAE,aAAa,EAAE,CAAC;IAC3B,OAAO,EAAE,eAAe,CAAC;IACzB,iBAAiB,CAAC,EAAE,gBAAgB,EAAE,CAAC;CACxC,CAAC;AA8GF;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,eAAe,EAAE,qBAAqB,EACtC,UAAU,EAAE,oBAAoB,EAChC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,GAC5C,eAAe,EAAE,CA6GnB;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,oBAAoB,GAC/B,MAAM,CAeR"}

package/dist/utils/marketDataTransform.mjs

@@ -0,0 +1,205 @@
+/**
+ * Market data transformation utilities.
+ *
+ * Portable: no mobile-specific imports.
+ * Formatters are injected via MarketDataFormatters interface.
+ */
+import { parseAssetName } from "./hyperLiquidAdapter.mjs";
+import { HYPERLIQUID_CONFIG } from "../constants/hyperLiquidConfig.mjs";
+import { PERPS_CONSTANTS } from "../constants/perpsConfig.mjs";
+/**
+ * Calculate open interest in USD
+ * Open interest from HyperLiquid is in contracts/units, not USD
+ * To get USD value, multiply by current price
+ *
+ * @param openInterest - Raw open interest value in contracts/units
+ * @param currentPrice - Current price of the asset
+ * @returns Open interest in USD, or NaN if invalid
+ */
+export function calculateOpenInterestUSD(openInterest, currentPrice) {
+    if (openInterest === undefined || currentPrice === undefined) {
+        return NaN;
+    }
+    const openInterestNum = typeof openInterest === 'string' ? parseFloat(openInterest) : openInterest;
+    const priceNum = typeof currentPrice === 'string' ? parseFloat(currentPrice) : currentPrice;
+    if (isNaN(openInterestNum) || isNaN(priceNum)) {
+        return NaN;
+    }
+    return openInterestNum * priceNum;
+}
+/**
+ * Calculate 24h percentage change
+ * Shows -100% when current price is missing but previous price exists
+ *
+ * @param params - The parameters for calculating the 24h change.
+ * @returns The 24h percentage change value.
+ */
+function calculateChange24hPercent(params) {
+    const { hasCurrentPrice, currentPrice, prevDayPrice } = params;
+    if (!hasCurrentPrice) {
+        return prevDayPrice > 0 ? -100 : 0;
+    }
+    if (prevDayPrice <= 0) {
+        return 0;
+    }
+    return ((currentPrice - prevDayPrice) / prevDayPrice) * 100;
+}
+/**
+ * Extract funding data for a symbol from predicted fundings.
+ * Looks for specified exchange first, falls back to first available.
+ *
+ * @param params - Parameters for extracting funding data
+ * @param params.predictedFundings - Array of predicted funding data
+ * @param params.symbol - Asset symbol to extract funding for
+ * @param params.exchangeName - Exchange to prioritize (defaults to HyperLiquid's 'HlPerp')
+ * @returns Funding data including next funding time, interval, and predicted rate
+ */
+function extractFundingData(params) {
+    const { predictedFundings, symbol, exchangeName = HYPERLIQUID_CONFIG.ExchangeName, } = params;
+    const result = {};
+    if (!predictedFundings) {
+        return result;
+    }
+    const fundingData = predictedFundings.find(([assetSymbol]) => assetSymbol === symbol);
+    if (!fundingData?.[1] ||
+        !Array.isArray(fundingData[1]) ||
+        fundingData[1].length === 0) {
+        return result;
+    }
+    // Look for specified exchange (e.g., 'HlPerp' for HyperLiquid)
+    const targetExchange = fundingData[1].find((exchange) => Array.isArray(exchange) && exchange[0] === exchangeName);
+    if (targetExchange?.[1]) {
+        result.nextFundingTime = targetExchange[1].nextFundingTime;
+        result.fundingIntervalHours = targetExchange[1].fundingIntervalHours;
+        result.predictedFundingRate = parseFloat(targetExchange[1].fundingRate);
+        return result;
+    }
+    // Fallback to first exchange if target not found
+    const firstExchange = fundingData[1][0];
+    if (Array.isArray(firstExchange) && firstExchange[1]) {
+        result.nextFundingTime = firstExchange[1].nextFundingTime;
+        result.fundingIntervalHours = firstExchange[1].fundingIntervalHours;
+    }
+    return result;
+}
+/**
+ * Transform raw HyperLiquid market data to UI-friendly format
+ *
+ * @param hyperLiquidData - Raw data from HyperLiquid API
+ * @param formatters - Injectable formatters for platform-agnostic formatting
+ * @param assetMarketTypes - Optional mapping of asset symbols to market types
+ * @returns Transformed market data ready for UI consumption
+ */
+export function transformMarketData(hyperLiquidData, formatters, assetMarketTypes) {
+    const { universe, assetCtxs, allMids, predictedFundings } = hyperLiquidData;
+    return universe.map((asset, index) => {
+        const symbol = asset.name;
+        const currentPrice = parseFloat(allMids[symbol]);
+        // Find matching asset context for additional data
+        // The assetCtxs array is aligned with universe array by index
+        const assetCtx = assetCtxs[index];
+        // Calculate 24h change
+        const prevDayPrice = assetCtx ? parseFloat(assetCtx.prevDayPx) : 0;
+        // Handle missing current price data
+        const hasCurrentPrice = !isNaN(currentPrice);
+        const effectiveCurrentPrice = hasCurrentPrice ? currentPrice : 0;
+        // For dollar change: show $0.00 when current price is missing
+        const change24h = hasCurrentPrice
+            ? effectiveCurrentPrice - prevDayPrice
+            : 0;
+        // For percentage: show -100% when current price is missing but previous price exists
+        const change24hPercent = calculateChange24hPercent({
+            hasCurrentPrice,
+            currentPrice: effectiveCurrentPrice,
+            prevDayPrice,
+        });
+        // Format volume (dayNtlVlm is daily notional volume)
+        // If assetCtx is missing or dayNtlVlm is not available, use NaN to indicate missing data
+        const volume = assetCtx?.dayNtlVlm ? parseFloat(assetCtx.dayNtlVlm) : NaN;
+        // Calculate open interest in USD
+        const openInterest = calculateOpenInterestUSD(assetCtx?.openInterest, currentPrice);
+        // Get current funding rate from assetCtx - this is the actual current funding rate
+        let fundingRate;
+        if (assetCtx && 'funding' in assetCtx) {
+            fundingRate = parseFloat(assetCtx.funding);
+        }
+        // Extract funding timing and predicted rate
+        const fundingData = extractFundingData({
+            predictedFundings,
+            symbol,
+        });
+        // Use current funding rate from assetCtx, not predicted
+        // The predicted rate is for the next funding period
+        if (!fundingRate && fundingData.predictedFundingRate !== undefined) {
+            fundingRate = fundingData.predictedFundingRate;
+        }
+        // Extract DEX and base symbol for display
+        // e.g., "flx:TSLA" → { dex: "flx", symbol: "TSLA" }
+        const { dex } = parseAssetName(symbol);
+        const marketSource = dex ?? undefined;
+        // HIP-3 markets have a DEX prefix (e.g., xyz:TSLA, flx:GOLD)
+        // Crypto markets (HIP-2) don't have a prefix (e.g., BTC, ETH)
+        const isHip3 = Boolean(dex);
+        // Determine market type from explicit mapping only
+        // Only explicitly mapped HIP-3 markets get a marketType (e.g., 'xyz:GOLD' → 'commodity')
+        // Unmapped HIP-3 markets (e.g., 'hyna:BTC') have no marketType - they go to "New" tab
+        // Main DEX crypto also has no marketType
+        const explicitMarketType = assetMarketTypes?.[symbol];
+        const marketType = explicitMarketType;
+        // Mark as "new" if it's a HIP-3 market but not explicitly categorized
+        // New markets are always HIP-3 (non-crypto) that haven't been assigned a category yet
+        const isNewMarket = isHip3 && !explicitMarketType;
+        return {
+            symbol,
+            name: symbol,
+            maxLeverage: `${asset.maxLeverage}x`,
+            price: isNaN(currentPrice)
+                ? PERPS_CONSTANTS.FallbackPriceDisplay
+                : formatters.formatPerpsFiat(currentPrice, {
+                    ranges: formatters.priceRangesUniversal,
+                }),
+            change24h: isNaN(change24h)
+                ? PERPS_CONSTANTS.ZeroAmountDetailedDisplay
+                : formatChange(change24h, formatters),
+            change24hPercent: isNaN(change24hPercent)
+                ? '0.00%'
+                : formatters.formatPercentage(change24hPercent),
+            volume: isNaN(volume)
+                ? PERPS_CONSTANTS.FallbackPriceDisplay
+                : formatters.formatVolume(volume),
+            openInterest: isNaN(openInterest)
+                ? PERPS_CONSTANTS.FallbackPriceDisplay
+                : formatters.formatVolume(openInterest),
+            nextFundingTime: fundingData.nextFundingTime,
+            fundingIntervalHours: fundingData.fundingIntervalHours,
+            fundingRate,
+            marketSource,
+            marketType,
+            isHip3,
+            isNewMarket,
+        };
+    });
+}
+/**
+ * Format 24h change with sign.
+ * Uses more decimal places for smaller amounts to show meaningful precision.
+ *
+ * @param change - The price change value to format
+ * @param formatters - Injectable formatters
+ * @returns Formatted change string with sign and dollar symbol
+ */
+export function formatChange(change, formatters) {
+    if (isNaN(change) || !isFinite(change)) {
+        return '$0.00';
+    }
+    if (change === 0) {
+        return '$0.00';
+    }
+    const formatted = formatters.formatPerpsFiat(Math.abs(change), {
+        ranges: formatters.priceRangesUniversal,
+    });
+    // Remove $ sign and add it back with proper sign placement
+    const valueWithoutDollar = formatted.replace('$', '');
+    return change > 0 ? `+$${valueWithoutDollar}` : `-$${valueWithoutDollar}`;
+}
+//# sourceMappingURL=marketDataTransform.mjs.map

package/dist/utils/marketDataTransform.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"marketDataTransform.mjs","sourceRoot":"","sources":["../../src/utils/marketDataTransform.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,cAAc,EAAE,iCAA6B;AACtD,OAAO,EAAE,kBAAkB,EAAE,2CAAuC;AACpE,OAAO,EAAE,eAAe,EAAE,qCAAiC;AAa3D;;;;;;;;GAQG;AACH,MAAM,UAAU,wBAAwB,CACtC,YAAyC,EACzC,YAAyC;IAEzC,IAAI,YAAY,KAAK,SAAS,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;QAC7D,OAAO,GAAG,CAAC;IACb,CAAC;IAED,MAAM,eAAe,GACnB,OAAO,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC;IAC7E,MAAM,QAAQ,GACZ,OAAO,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC;IAE7E,IAAI,KAAK,CAAC,eAAe,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC9C,OAAO,GAAG,CAAC;IACb,CAAC;IAED,OAAO,eAAe,GAAG,QAAQ,CAAC;AACpC,CAAC;AAqBD;;;;;;GAMG;AACH,SAAS,yBAAyB,CAChC,MAAuC;IAEvC,MAAM,EAAE,eAAe,EAAE,YAAY,EAAE,YAAY,EAAE,GAAG,MAAM,CAAC;IAE/D,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,OAAO,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACrC,CAAC;IAED,IAAI,YAAY,IAAI,CAAC,EAAE,CAAC;QACtB,OAAO,CAAC,CAAC;IACX,CAAC;IAED,OAAO,CAAC,CAAC,YAAY,GAAG,YAAY,CAAC,GAAG,YAAY,CAAC,GAAG,GAAG,CAAC;AAC9D,CAAC;AAoBD;;;;;;;;;GASG;AACH,SAAS,kBAAkB,CAAC,MAAgC;IAC1D,MAAM,EACJ,iBAAiB,EACjB,MAAM,EACN,YAAY,GAAG,kBAAkB,CAAC,YAAY,GAC/C,GAAG,MAAM,CAAC;IAEX,MAAM,MAAM,GAAgB,EAAE,CAAC;IAE/B,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACvB,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,WAAW,GAAG,iBAAiB,CAAC,IAAI,CACxC,CAAC,CAAC,WAAW,CAAC,EAAE,EAAE,CAAC,WAAW,KAAK,MAAM,CAC1C,CAAC;IAEF,IACE,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;QACjB,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;QAC9B,WAAW,CAAC,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,EAC3B,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,+DAA+D;IAC/D,MAAM,cAAc,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CACxC,CAAC,QAAiB,EAAE,EAAE,CACpB,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,KAAK,YAAY,CAC1D,CAAC;IAEF,IAAI,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxB,MAAM,CAAC,eAAe,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC;QAC3D,MAAM,CAAC,oBAAoB,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC,oBAAoB,CAAC;QACrE,MAAM,CAAC,oBAAoB,GAAG,UAAU,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;QACxE,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,iDAAiD;IACjD,MAAM,aAAa,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACxC,IAAI,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;QACrD,MAAM,CAAC,eAAe,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC;QAC1D,MAAM,CAAC,oBAAoB,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC,oBAAoB,CAAC;IACtE,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CACjC,eAAsC,EACtC,UAAgC,EAChC,gBAA6C;IAE7C,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,iBAAiB,EAAE,GAAG,eAAe,CAAC;IAE5E,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;QACnC,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC;QAC1B,MAAM,YAAY,GAAG,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;QAEjD,kDAAkD;QAClD,8DAA8D;QAC9D,MAAM,QAAQ,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;QAElC,uBAAuB;QACvB,MAAM,YAAY,GAAG,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAEnE,oCAAoC;QACpC,MAAM,eAAe,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QAC7C,MAAM,qBAAqB,GAAG,eAAe,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;QAEjE,8DAA8D;QAC9D,MAAM,SAAS,GAAG,eAAe;YAC/B,CAAC,CAAC,qBAAqB,GAAG,YAAY;YACtC,CAAC,CAAC,CAAC,CAAC;QAEN,qFAAqF;QACrF,MAAM,gBAAgB,GAAG,yBAAyB,CAAC;YACjD,eAAe;YACf,YAAY,EAAE,qBAAqB;YACnC,YAAY;SACb,CAAC,CAAC;QAEH,qDAAqD;QACrD,yFAAyF;QACzF,MAAM,MAAM,GAAG,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QAE1E,iCAAiC;QACjC,MAAM,YAAY,GAAG,wBAAwB,CAC3C,QAAQ,EAAE,YAAY,EACtB,YAAY,CACb,CAAC;QAEF,mFAAmF;QACnF,IAAI,WAA+B,CAAC;QAEpC,IAAI,QAAQ,IAAI,SAAS,IAAI,QAAQ,EAAE,CAAC;YACtC,WAAW,GAAG,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC7C,CAAC;QAED,4CAA4C;QAC5C,MAAM,WAAW,GAAG,kBAAkB,CAAC;YACrC,iBAAiB;YACjB,MAAM;SACP,CAAC,CAAC;QAEH,wDAAwD;QACxD,oDAAoD;QACpD,IAAI,CAAC,WAAW,IAAI,WAAW,CAAC,oBAAoB,KAAK,SAAS,EAAE,CAAC;YACnE,WAAW,GAAG,WAAW,CAAC,oBAAoB,CAAC;QACjD,CAAC;QAED,0CAA0C;QAC1C,oDAAoD;QACpD,MAAM,EAAE,GAAG,EAAE,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;QACvC,MAAM,YAAY,GAAG,GAAG,IAAI,SAAS,CAAC;QAEtC,6DAA6D;QAC7D,8DAA8D;QAC9D,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAE5B,mDAAmD;QACnD,yFAAyF;QACzF,sFAAsF;QACtF,yCAAyC;QACzC,MAAM,kBAAkB,GAAG,gBAAgB,EAAE,CAAC,MAAM,CAAC,CAAC;QACtD,MAAM,UAAU,GAA2B,kBAAkB,CAAC;QAE9D,sEAAsE;QACtE,sFAAsF;QACtF,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC;QAElD,OAAO;YACL,MAAM;YACN,IAAI,EAAE,MAAM;YACZ,WAAW,EAAE,GAAG,KAAK,CAAC,WAAW,GAAG;YACpC,KAAK,EAAE,KAAK,CAAC,YAAY,CAAC;gBACxB,CAAC,CAAC,eAAe,CAAC,oBAAoB;gBACtC,CAAC,CAAC,UAAU,CAAC,eAAe,CAAC,YAAY,EAAE;oBACvC,MAAM,EAAE,UAAU,CAAC,oBAAoB;iBACxC,CAAC;YACN,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC;gBACzB,CAAC,CAAC,eAAe,CAAC,yBAAyB;gBAC3C,CAAC,CAAC,YAAY,CAAC,SAAS,EAAE,UAAU,CAAC;YACvC,gBAAgB,EAAE,KAAK,CAAC,gBAAgB,CAAC;gBACvC,CAAC,CAAC,OAAO;gBACT,CAAC,CAAC,UAAU,CAAC,gBAAgB,CAAC,gBAAgB,CAAC;YACjD,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC;gBACnB,CAAC,CAAC,eAAe,CAAC,oBAAoB;gBACtC,CAAC,CAAC,UAAU,CAAC,YAAY,CAAC,MAAM,CAAC;YACnC,YAAY,EAAE,KAAK,CAAC,YAAY,CAAC;gBAC/B,CAAC,CAAC,eAAe,CAAC,oBAAoB;gBACtC,CAAC,CAAC,UAAU,CAAC,YAAY,CAAC,YAAY,CAAC;YACzC,eAAe,EAAE,WAAW,CAAC,eAAe;YAC5C,oBAAoB,EAAE,WAAW,CAAC,oBAAoB;YACtD,WAAW;YACX,YAAY;YACZ,UAAU;YACV,MAAM;YACN,WAAW;SACZ,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAC1B,MAAc,EACd,UAAgC;IAEhC,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACvC,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,IAAI,MAAM,KAAK,CAAC,EAAE,CAAC;QACjB,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,MAAM,SAAS,GAAG,UAAU,CAAC,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE;QAC7D,MAAM,EAAE,UAAU,CAAC,oBAAoB;KACxC,CAAC,CAAC;IAEH,2DAA2D;IAC3D,MAAM,kBAAkB,GAAG,SAAS,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACtD,OAAO,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,kBAAkB,EAAE,CAAC,CAAC,CAAC,KAAK,kBAAkB,EAAE,CAAC;AAC5E,CAAC","sourcesContent":["/**\n * Market data transformation utilities.\n *\n * Portable: no mobile-specific imports.\n * Formatters are injected via MarketDataFormatters interface.\n */\nimport { parseAssetName } from './hyperLiquidAdapter';\nimport { HYPERLIQUID_CONFIG } from '../constants/hyperLiquidConfig';\nimport { PERPS_CONSTANTS } from '../constants/perpsConfig';\nimport type {\n  PerpsMarketData,\n  MarketType,\n  MarketDataFormatters,\n} from '../types';\nimport type {\n  AllMidsResponse,\n  PerpsUniverse,\n  PerpsAssetCtx,\n  PredictedFunding,\n} from '../types/hyperliquid-types';\n\n/**\n * Calculate open interest in USD\n * Open interest from HyperLiquid is in contracts/units, not USD\n * To get USD value, multiply by current price\n *\n * @param openInterest - Raw open interest value in contracts/units\n * @param currentPrice - Current price of the asset\n * @returns Open interest in USD, or NaN if invalid\n */\nexport function calculateOpenInterestUSD(\n  openInterest: string | number | undefined,\n  currentPrice: string | number | undefined,\n): number {\n  if (openInterest === undefined || currentPrice === undefined) {\n    return NaN;\n  }\n\n  const openInterestNum =\n    typeof openInterest === 'string' ? parseFloat(openInterest) : openInterest;\n  const priceNum =\n    typeof currentPrice === 'string' ? parseFloat(currentPrice) : currentPrice;\n\n  if (isNaN(openInterestNum) || isNaN(priceNum)) {\n    return NaN;\n  }\n\n  return openInterestNum * priceNum;\n}\n\n/**\n * HyperLiquid-specific market data structure\n */\nexport type HyperLiquidMarketData = {\n  universe: PerpsUniverse[];\n  assetCtxs: PerpsAssetCtx[];\n  allMids: AllMidsResponse;\n  predictedFundings?: PredictedFunding[];\n};\n\n/**\n * Parameters for calculating 24h percentage change\n */\ntype CalculateChange24hPercentParams = {\n  hasCurrentPrice: boolean;\n  currentPrice: number;\n  prevDayPrice: number;\n};\n\n/**\n * Calculate 24h percentage change\n * Shows -100% when current price is missing but previous price exists\n *\n * @param params - The parameters for calculating the 24h change.\n * @returns The 24h percentage change value.\n */\nfunction calculateChange24hPercent(\n  params: CalculateChange24hPercentParams,\n): number {\n  const { hasCurrentPrice, currentPrice, prevDayPrice } = params;\n\n  if (!hasCurrentPrice) {\n    return prevDayPrice > 0 ? -100 : 0;\n  }\n\n  if (prevDayPrice <= 0) {\n    return 0;\n  }\n\n  return ((currentPrice - prevDayPrice) / prevDayPrice) * 100;\n}\n\n/**\n * Funding data extracted from predicted fundings\n */\ntype FundingData = {\n  nextFundingTime?: number;\n  fundingIntervalHours?: number;\n  predictedFundingRate?: number;\n};\n\n/**\n * Parameters for extracting funding data\n */\ntype ExtractFundingDataParams = {\n  predictedFundings?: PredictedFunding[];\n  symbol: string;\n  exchangeName?: string;\n};\n\n/**\n * Extract funding data for a symbol from predicted fundings.\n * Looks for specified exchange first, falls back to first available.\n *\n * @param params - Parameters for extracting funding data\n * @param params.predictedFundings - Array of predicted funding data\n * @param params.symbol - Asset symbol to extract funding for\n * @param params.exchangeName - Exchange to prioritize (defaults to HyperLiquid's 'HlPerp')\n * @returns Funding data including next funding time, interval, and predicted rate\n */\nfunction extractFundingData(params: ExtractFundingDataParams): FundingData {\n  const {\n    predictedFundings,\n    symbol,\n    exchangeName = HYPERLIQUID_CONFIG.ExchangeName,\n  } = params;\n\n  const result: FundingData = {};\n\n  if (!predictedFundings) {\n    return result;\n  }\n\n  const fundingData = predictedFundings.find(\n    ([assetSymbol]) => assetSymbol === symbol,\n  );\n\n  if (\n    !fundingData?.[1] ||\n    !Array.isArray(fundingData[1]) ||\n    fundingData[1].length === 0\n  ) {\n    return result;\n  }\n\n  // Look for specified exchange (e.g., 'HlPerp' for HyperLiquid)\n  const targetExchange = fundingData[1].find(\n    (exchange: unknown) =>\n      Array.isArray(exchange) && exchange[0] === exchangeName,\n  );\n\n  if (targetExchange?.[1]) {\n    result.nextFundingTime = targetExchange[1].nextFundingTime;\n    result.fundingIntervalHours = targetExchange[1].fundingIntervalHours;\n    result.predictedFundingRate = parseFloat(targetExchange[1].fundingRate);\n    return result;\n  }\n\n  // Fallback to first exchange if target not found\n  const firstExchange = fundingData[1][0];\n  if (Array.isArray(firstExchange) && firstExchange[1]) {\n    result.nextFundingTime = firstExchange[1].nextFundingTime;\n    result.fundingIntervalHours = firstExchange[1].fundingIntervalHours;\n  }\n\n  return result;\n}\n\n/**\n * Transform raw HyperLiquid market data to UI-friendly format\n *\n * @param hyperLiquidData - Raw data from HyperLiquid API\n * @param formatters - Injectable formatters for platform-agnostic formatting\n * @param assetMarketTypes - Optional mapping of asset symbols to market types\n * @returns Transformed market data ready for UI consumption\n */\nexport function transformMarketData(\n  hyperLiquidData: HyperLiquidMarketData,\n  formatters: MarketDataFormatters,\n  assetMarketTypes?: Record<string, MarketType>,\n): PerpsMarketData[] {\n  const { universe, assetCtxs, allMids, predictedFundings } = hyperLiquidData;\n\n  return universe.map((asset, index) => {\n    const symbol = asset.name;\n    const currentPrice = parseFloat(allMids[symbol]);\n\n    // Find matching asset context for additional data\n    // The assetCtxs array is aligned with universe array by index\n    const assetCtx = assetCtxs[index];\n\n    // Calculate 24h change\n    const prevDayPrice = assetCtx ? parseFloat(assetCtx.prevDayPx) : 0;\n\n    // Handle missing current price data\n    const hasCurrentPrice = !isNaN(currentPrice);\n    const effectiveCurrentPrice = hasCurrentPrice ? currentPrice : 0;\n\n    // For dollar change: show $0.00 when current price is missing\n    const change24h = hasCurrentPrice\n      ? effectiveCurrentPrice - prevDayPrice\n      : 0;\n\n    // For percentage: show -100% when current price is missing but previous price exists\n    const change24hPercent = calculateChange24hPercent({\n      hasCurrentPrice,\n      currentPrice: effectiveCurrentPrice,\n      prevDayPrice,\n    });\n\n    // Format volume (dayNtlVlm is daily notional volume)\n    // If assetCtx is missing or dayNtlVlm is not available, use NaN to indicate missing data\n    const volume = assetCtx?.dayNtlVlm ? parseFloat(assetCtx.dayNtlVlm) : NaN;\n\n    // Calculate open interest in USD\n    const openInterest = calculateOpenInterestUSD(\n      assetCtx?.openInterest,\n      currentPrice,\n    );\n\n    // Get current funding rate from assetCtx - this is the actual current funding rate\n    let fundingRate: number | undefined;\n\n    if (assetCtx && 'funding' in assetCtx) {\n      fundingRate = parseFloat(assetCtx.funding);\n    }\n\n    // Extract funding timing and predicted rate\n    const fundingData = extractFundingData({\n      predictedFundings,\n      symbol,\n    });\n\n    // Use current funding rate from assetCtx, not predicted\n    // The predicted rate is for the next funding period\n    if (!fundingRate && fundingData.predictedFundingRate !== undefined) {\n      fundingRate = fundingData.predictedFundingRate;\n    }\n\n    // Extract DEX and base symbol for display\n    // e.g., \"flx:TSLA\" → { dex: \"flx\", symbol: \"TSLA\" }\n    const { dex } = parseAssetName(symbol);\n    const marketSource = dex ?? undefined;\n\n    // HIP-3 markets have a DEX prefix (e.g., xyz:TSLA, flx:GOLD)\n    // Crypto markets (HIP-2) don't have a prefix (e.g., BTC, ETH)\n    const isHip3 = Boolean(dex);\n\n    // Determine market type from explicit mapping only\n    // Only explicitly mapped HIP-3 markets get a marketType (e.g., 'xyz:GOLD' → 'commodity')\n    // Unmapped HIP-3 markets (e.g., 'hyna:BTC') have no marketType - they go to \"New\" tab\n    // Main DEX crypto also has no marketType\n    const explicitMarketType = assetMarketTypes?.[symbol];\n    const marketType: MarketType | undefined = explicitMarketType;\n\n    // Mark as \"new\" if it's a HIP-3 market but not explicitly categorized\n    // New markets are always HIP-3 (non-crypto) that haven't been assigned a category yet\n    const isNewMarket = isHip3 && !explicitMarketType;\n\n    return {\n      symbol,\n      name: symbol,\n      maxLeverage: `${asset.maxLeverage}x`,\n      price: isNaN(currentPrice)\n        ? PERPS_CONSTANTS.FallbackPriceDisplay\n        : formatters.formatPerpsFiat(currentPrice, {\n            ranges: formatters.priceRangesUniversal,\n          }),\n      change24h: isNaN(change24h)\n        ? PERPS_CONSTANTS.ZeroAmountDetailedDisplay\n        : formatChange(change24h, formatters),\n      change24hPercent: isNaN(change24hPercent)\n        ? '0.00%'\n        : formatters.formatPercentage(change24hPercent),\n      volume: isNaN(volume)\n        ? PERPS_CONSTANTS.FallbackPriceDisplay\n        : formatters.formatVolume(volume),\n      openInterest: isNaN(openInterest)\n        ? PERPS_CONSTANTS.FallbackPriceDisplay\n        : formatters.formatVolume(openInterest),\n      nextFundingTime: fundingData.nextFundingTime,\n      fundingIntervalHours: fundingData.fundingIntervalHours,\n      fundingRate,\n      marketSource,\n      marketType,\n      isHip3,\n      isNewMarket,\n    };\n  });\n}\n\n/**\n * Format 24h change with sign.\n * Uses more decimal places for smaller amounts to show meaningful precision.\n *\n * @param change - The price change value to format\n * @param formatters - Injectable formatters\n * @returns Formatted change string with sign and dollar symbol\n */\nexport function formatChange(\n  change: number,\n  formatters: MarketDataFormatters,\n): string {\n  if (isNaN(change) || !isFinite(change)) {\n    return '$0.00';\n  }\n  if (change === 0) {\n    return '$0.00';\n  }\n\n  const formatted = formatters.formatPerpsFiat(Math.abs(change), {\n    ranges: formatters.priceRangesUniversal,\n  });\n\n  // Remove $ sign and add it back with proper sign placement\n  const valueWithoutDollar = formatted.replace('$', '');\n  return change > 0 ? `+$${valueWithoutDollar}` : `-$${valueWithoutDollar}`;\n}\n"]}