@metamask-previews/perps-controller 13.1.0-preview-8c2a2eeb2 → 13.1.0-preview-4f4c98e

package/dist/utils/index.d.mts

@@ -1,28 +0,0 @@
-/**
- * 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, adaptPositionTriggerOrderFromSDK, adaptTpslLinkageToGrouping, adaptTriggerOrderTypeFromSDK, 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 "./marketSearch.mjs";
-export * from "./marketUtils.mjs";
-export * from "./orderCalculations.mjs";
-export * from "./orderTypes.mjs";
-export * from "./perpsDiskPersistence.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';
-export * from "./perpsFormatters.mjs";
-//# sourceMappingURL=index.d.mts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,mCAAkC;AAClC,iCAAgC;AAEhC,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,iBAAiB,EACjB,gCAAgC,EAChC,0BAA0B,EAC1B,4BAA4B,EAC5B,kBAAkB,EAClB,wBAAwB,EACxB,iBAAiB,EACjB,sBAAsB,EACtB,qBAAqB,EACrB,oBAAoB,EACpB,cAAc,EACd,6CAA6C,GAC9C,iCAAgC;AACjC,oDAAmD;AACnD,4CAA2C;AAC3C,8BAA6B;AAC7B,0CAAyC;AACzC,mCAAkC;AAClC,kCAAiC;AACjC,wCAAuC;AACvC,iCAAgC;AAChC,2CAA0C;AAC1C,mCAAkC;AAClC,yCAAwC;AACxC,kCAAiC;AACjC,2CAA0C;AAC1C,uCAAsC;AACtC,mCAAkC;AAClC,2BAA0B;AAG1B,eAAO,MAAM,cAAc,QAAO,KAAK,GAAG,MAGzC,CAAC;AACF,sCAAqC"}

package/dist/utils/index.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,mCAAkC;AAClC,iCAAgC;AAChC,mGAAmG;AACnG,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,iBAAiB,EACjB,gCAAgC,EAChC,0BAA0B,EAC1B,4BAA4B,EAC5B,kBAAkB,EAClB,wBAAwB,EACxB,iBAAiB,EACjB,sBAAsB,EACtB,qBAAqB,EACrB,oBAAoB,EACpB,cAAc,EACd,6CAA6C,EAC9C,iCAAgC;AACjC,oDAAmD;AACnD,4CAA2C;AAC3C,8BAA6B;AAC7B,0CAAyC;AACzC,mCAAkC;AAClC,kCAAiC;AACjC,wCAAuC;AACvC,iCAAgC;AAChC,2CAA0C;AAC1C,mCAAkC;AAClC,yCAAwC;AACxC,kCAAiC;AACjC,2CAA0C;AAC1C,uCAAsC;AACtC,mCAAkC;AAClC,2BAA0B;AAE1B,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;AACF,sCAAqC","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.js';\nexport * from './errorUtils.js';\n// hyperLiquidAdapter: selective export to avoid calculatePositionSize clash with orderCalculations\nexport {\n  adaptOrderToSDK,\n  adaptPositionFromSDK,\n  adaptOrderFromSDK,\n  adaptPositionTriggerOrderFromSDK,\n  adaptTpslLinkageToGrouping,\n  adaptTriggerOrderTypeFromSDK,\n  adaptMarketFromSDK,\n  adaptAccountStateFromSDK,\n  buildAssetMapping,\n  formatHyperLiquidPrice,\n  formatHyperLiquidSize,\n  calculateHip3AssetId,\n  parseAssetName,\n  adaptHyperLiquidLedgerUpdateToUserHistoryItem,\n} from './hyperLiquidAdapter.js';\nexport * from './hyperLiquidOrderBookProcessor.js';\nexport * from './hyperLiquidValidation.js';\nexport * from './idUtils.js';\nexport * from './marketDataTransform.js';\nexport * from './marketSearch.js';\nexport * from './marketUtils.js';\nexport * from './orderCalculations.js';\nexport * from './orderTypes.js';\nexport * from './perpsDiskPersistence.js';\nexport * from './rewardsUtils.js';\nexport * from './significantFigures.js';\nexport * from './sortMarkets.js';\nexport * from './standaloneInfoClient.js';\nexport * from './stringParseUtils.js';\nexport * from './transferData.js';\nexport * from './wait.js';\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};\nexport * from './perpsFormatters.js';\n"]}

package/dist/utils/marketDataTransform.cjs

@@ -1,250 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.formatChange = exports.transformMarketData = exports.isMarketTradable = exports.calculateOpenInterestUSD = void 0;
-/**
- * Market data transformation utilities.
- *
- * Portable: no mobile-specific imports.
- * Formatters are injected via MarketDataFormatters interface.
- */
-const utils_1 = require("@metamask/utils");
-const hyperLiquidConfig_js_1 = require("../constants/hyperLiquidConfig.cjs");
-const perpsConfig_js_1 = require("../constants/perpsConfig.cjs");
-const hyperLiquidAdapter_js_1 = require("./hyperLiquidAdapter.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;
-/**
- * Determine whether a market is currently tradable based on how far its market
- * (mid) price has drifted from the oracle (reference) price.
- *
- * HyperLiquid rejects orders when the order price is more than 95% away from the
- * reference price ("Order price cannot be more than 95% away from the reference
- * price"). This most often affects HIP-3 builder-deployed markets, which can become
- * temporarily untradable when their mid price diverges far from the oracle price.
- * Clients use this signal to proactively warn the user (e.g. a "trading unavailable"
- * banner) instead of letting the order fail on submission.
- *
- * Note: the deviation limit is a HyperLiquid protocol rule. Other providers may have
- * different rules and should compute tradability accordingly.
- *
- * @param params - The parameters for the tradability check.
- * @param params.midPrice - Current market/mid price.
- * @param params.oraclePrice - Current oracle/reference price.
- * @param params.deviationLimit - Max allowed deviation as a decimal fraction
- * (defaults to HyperLiquid's 0.95). A market is untradable when
- * `abs(midPrice - oraclePrice) / oraclePrice > deviationLimit`.
- * @returns `true` when the market is tradable (or when prices are unavailable, so the
- * absence of data never blocks trading); `false` when the deviation exceeds the limit.
- */
-function isMarketTradable(params) {
-    const { midPrice, oraclePrice, deviationLimit = hyperLiquidConfig_js_1.HYPERLIQUID_CONFIG.OraclePriceDeviationLimit, } = params;
-    // Without usable prices we cannot assess deviation — default to tradable so missing
-    // data never blocks the user. A non-positive price means "no data" (e.g. the transient
-    // zero price emitted before the first real tick), not an untradable market.
-    if (midPrice === undefined ||
-        oraclePrice === undefined ||
-        isNaN(midPrice) ||
-        isNaN(oraclePrice) ||
-        midPrice <= 0 ||
-        oraclePrice <= 0) {
-        return true;
-    }
-    const deviation = Math.abs(midPrice - oraclePrice) / oraclePrice;
-    return deviation <= deviationLimit;
-}
-exports.isMarketTradable = isMarketTradable;
-/**
- * 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_js_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
- * @param assetNames - Optional mapping of asset symbols to human-readable names.
- * Defaults to the bundled HYPERLIQUID_ASSET_NAMES; unmapped assets fall back to
- * their ticker symbol.
- * @returns Transformed market data ready for UI consumption
- */
-function transformMarketData(hyperLiquidData, formatters, assetMarketTypes, assetNames) {
-    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 && (0, utils_1.hasProperty)(assetCtx, 'funding')) {
-            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_js_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 static mapping
-        const marketType = assetMarketTypes?.[symbol];
-        // Mark as "new" if it's a HIP-3 market but not explicitly categorized
-        const isNewMarket = isHip3 && !marketType;
-        return {
-            symbol,
-            name: (0, hyperLiquidConfig_js_1.getHyperLiquidAssetName)(symbol, assetNames),
-            maxLeverage: `${asset.maxLeverage}x`,
-            price: isNaN(currentPrice)
-                ? perpsConfig_js_1.PERPS_CONSTANTS.FallbackPriceDisplay
-                : formatters.formatPerpsFiat(currentPrice, {
-                    ranges: formatters.priceRangesUniversal,
-                }),
-            change24h: isNaN(change24h)
-                ? perpsConfig_js_1.PERPS_CONSTANTS.ZeroAmountDetailedDisplay
-                : formatChange(change24h, formatters),
-            change24hPercent: isNaN(change24hPercent)
-                ? '0.00%'
-                : formatters.formatPercentage(change24hPercent),
-            volume: isNaN(volume)
-                ? perpsConfig_js_1.PERPS_CONSTANTS.FallbackPriceDisplay
-                : formatters.formatVolume(volume),
-            openInterest: isNaN(openInterest)
-                ? perpsConfig_js_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

@@ -1 +0,0 @@
-{"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 { hasProperty } from '@metamask/utils';\n\nimport {\n  HYPERLIQUID_CONFIG,\n  getHyperLiquidAssetName,\n} from '../constants/hyperLiquidConfig.js';\nimport { PERPS_CONSTANTS } from '../constants/perpsConfig.js';\nimport type {\n  AllMidsResponse,\n  PerpsUniverse,\n  PerpsAssetCtx,\n  PredictedFunding,\n} from '../types/hyperliquid-types.js';\nimport type {\n  PerpsMarketData,\n  MarketType,\n  MarketDataFormatters,\n} from '../types/index.js';\nimport { parseAssetName } from './hyperLiquidAdapter.js';\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 * Determine whether a market is currently tradable based on how far its market\n * (mid) price has drifted from the oracle (reference) price.\n *\n * HyperLiquid rejects orders when the order price is more than 95% away from the\n * reference price (\"Order price cannot be more than 95% away from the reference\n * price\"). This most often affects HIP-3 builder-deployed markets, which can become\n * temporarily untradable when their mid price diverges far from the oracle price.\n * Clients use this signal to proactively warn the user (e.g. a \"trading unavailable\"\n * banner) instead of letting the order fail on submission.\n *\n * Note: the deviation limit is a HyperLiquid protocol rule. Other providers may have\n * different rules and should compute tradability accordingly.\n *\n * @param params - The parameters for the tradability check.\n * @param params.midPrice - Current market/mid price.\n * @param params.oraclePrice - Current oracle/reference price.\n * @param params.deviationLimit - Max allowed deviation as a decimal fraction\n * (defaults to HyperLiquid's 0.95). A market is untradable when\n * `abs(midPrice - oraclePrice) / oraclePrice > deviationLimit`.\n * @returns `true` when the market is tradable (or when prices are unavailable, so the\n * absence of data never blocks trading); `false` when the deviation exceeds the limit.\n */\nexport function isMarketTradable(params: {\n  midPrice: number | undefined;\n  oraclePrice: number | undefined;\n  deviationLimit?: number;\n}): boolean {\n  const {\n    midPrice,\n    oraclePrice,\n    deviationLimit = HYPERLIQUID_CONFIG.OraclePriceDeviationLimit,\n  } = params;\n\n  // Without usable prices we cannot assess deviation — default to tradable so missing\n  // data never blocks the user. A non-positive price means \"no data\" (e.g. the transient\n  // zero price emitted before the first real tick), not an untradable market.\n  if (\n    midPrice === undefined ||\n    oraclePrice === undefined ||\n    isNaN(midPrice) ||\n    isNaN(oraclePrice) ||\n    midPrice <= 0 ||\n    oraclePrice <= 0\n  ) {\n    return true;\n  }\n\n  const deviation = Math.abs(midPrice - oraclePrice) / oraclePrice;\n  return deviation <= deviationLimit;\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 * @param assetNames - Optional mapping of asset symbols to human-readable names.\n * Defaults to the bundled HYPERLIQUID_ASSET_NAMES; unmapped assets fall back to\n * their ticker symbol.\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  assetNames?: Record<string, string>,\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 && hasProperty(assetCtx, 'funding')) {\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 static mapping\n    const marketType: MarketType | undefined = assetMarketTypes?.[symbol];\n\n    // Mark as \"new\" if it's a HIP-3 market but not explicitly categorized\n    const isNewMarket = isHip3 && !marketType;\n\n    return {\n      symbol,\n      name: getHyperLiquidAssetName(symbol, assetNames),\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.map

@@ -1 +0,0 @@
-{"version":3,"file":"marketDataTransform.d.cts","sourceRoot":"","sources":["../../src/utils/marketDataTransform.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EACV,eAAe,EACf,aAAa,EACb,aAAa,EACb,gBAAgB,EACjB,uCAAsC;AACvC,OAAO,KAAK,EACV,eAAe,EACf,UAAU,EACV,oBAAoB,EACrB,2BAA0B;AAG3B;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CACtC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,EACzC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GACxC,MAAM,CAeR;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE;IACvC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,GAAG,OAAO,CAuBV;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;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CACjC,eAAe,EAAE,qBAAqB,EACtC,UAAU,EAAE,oBAAoB,EAChC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,EAC7C,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAClC,eAAe,EAAE,CAwGnB;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,oBAAoB,GAC/B,MAAM,CAeR"}

package/dist/utils/marketDataTransform.d.mts

@@ -1,71 +0,0 @@
-import type { AllMidsResponse, PerpsUniverse, PerpsAssetCtx, PredictedFunding } from "../types/hyperliquid-types.mjs";
-import type { PerpsMarketData, MarketType, MarketDataFormatters } from "../types/index.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;
-/**
- * Determine whether a market is currently tradable based on how far its market
- * (mid) price has drifted from the oracle (reference) price.
- *
- * HyperLiquid rejects orders when the order price is more than 95% away from the
- * reference price ("Order price cannot be more than 95% away from the reference
- * price"). This most often affects HIP-3 builder-deployed markets, which can become
- * temporarily untradable when their mid price diverges far from the oracle price.
- * Clients use this signal to proactively warn the user (e.g. a "trading unavailable"
- * banner) instead of letting the order fail on submission.
- *
- * Note: the deviation limit is a HyperLiquid protocol rule. Other providers may have
- * different rules and should compute tradability accordingly.
- *
- * @param params - The parameters for the tradability check.
- * @param params.midPrice - Current market/mid price.
- * @param params.oraclePrice - Current oracle/reference price.
- * @param params.deviationLimit - Max allowed deviation as a decimal fraction
- * (defaults to HyperLiquid's 0.95). A market is untradable when
- * `abs(midPrice - oraclePrice) / oraclePrice > deviationLimit`.
- * @returns `true` when the market is tradable (or when prices are unavailable, so the
- * absence of data never blocks trading); `false` when the deviation exceeds the limit.
- */
-export declare function isMarketTradable(params: {
-    midPrice: number | undefined;
-    oraclePrice: number | undefined;
-    deviationLimit?: number;
-}): boolean;
-/**
- * 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
- * @param assetNames - Optional mapping of asset symbols to human-readable names.
- * Defaults to the bundled HYPERLIQUID_ASSET_NAMES; unmapped assets fall back to
- * their ticker symbol.
- * @returns Transformed market data ready for UI consumption
- */
-export declare function transformMarketData(hyperLiquidData: HyperLiquidMarketData, formatters: MarketDataFormatters, assetMarketTypes?: Record<string, MarketType>, assetNames?: Record<string, string>): 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

@@ -1 +0,0 @@
-{"version":3,"file":"marketDataTransform.d.mts","sourceRoot":"","sources":["../../src/utils/marketDataTransform.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EACV,eAAe,EACf,aAAa,EACb,aAAa,EACb,gBAAgB,EACjB,uCAAsC;AACvC,OAAO,KAAK,EACV,eAAe,EACf,UAAU,EACV,oBAAoB,EACrB,2BAA0B;AAG3B;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CACtC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,EACzC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GACxC,MAAM,CAeR;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE;IACvC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,GAAG,OAAO,CAuBV;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;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CACjC,eAAe,EAAE,qBAAqB,EACtC,UAAU,EAAE,oBAAoB,EAChC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,EAC7C,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAClC,eAAe,EAAE,CAwGnB;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,oBAAoB,GAC/B,MAAM,CAeR"}

package/dist/utils/marketDataTransform.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"marketDataTransform.mjs","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 { hasProperty } from '@metamask/utils';\n\nimport {\n  HYPERLIQUID_CONFIG,\n  getHyperLiquidAssetName,\n} from '../constants/hyperLiquidConfig.js';\nimport { PERPS_CONSTANTS } from '../constants/perpsConfig.js';\nimport type {\n  AllMidsResponse,\n  PerpsUniverse,\n  PerpsAssetCtx,\n  PredictedFunding,\n} from '../types/hyperliquid-types.js';\nimport type {\n  PerpsMarketData,\n  MarketType,\n  MarketDataFormatters,\n} from '../types/index.js';\nimport { parseAssetName } from './hyperLiquidAdapter.js';\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 * Determine whether a market is currently tradable based on how far its market\n * (mid) price has drifted from the oracle (reference) price.\n *\n * HyperLiquid rejects orders when the order price is more than 95% away from the\n * reference price (\"Order price cannot be more than 95% away from the reference\n * price\"). This most often affects HIP-3 builder-deployed markets, which can become\n * temporarily untradable when their mid price diverges far from the oracle price.\n * Clients use this signal to proactively warn the user (e.g. a \"trading unavailable\"\n * banner) instead of letting the order fail on submission.\n *\n * Note: the deviation limit is a HyperLiquid protocol rule. Other providers may have\n * different rules and should compute tradability accordingly.\n *\n * @param params - The parameters for the tradability check.\n * @param params.midPrice - Current market/mid price.\n * @param params.oraclePrice - Current oracle/reference price.\n * @param params.deviationLimit - Max allowed deviation as a decimal fraction\n * (defaults to HyperLiquid's 0.95). A market is untradable when\n * `abs(midPrice - oraclePrice) / oraclePrice > deviationLimit`.\n * @returns `true` when the market is tradable (or when prices are unavailable, so the\n * absence of data never blocks trading); `false` when the deviation exceeds the limit.\n */\nexport function isMarketTradable(params: {\n  midPrice: number | undefined;\n  oraclePrice: number | undefined;\n  deviationLimit?: number;\n}): boolean {\n  const {\n    midPrice,\n    oraclePrice,\n    deviationLimit = HYPERLIQUID_CONFIG.OraclePriceDeviationLimit,\n  } = params;\n\n  // Without usable prices we cannot assess deviation — default to tradable so missing\n  // data never blocks the user. A non-positive price means \"no data\" (e.g. the transient\n  // zero price emitted before the first real tick), not an untradable market.\n  if (\n    midPrice === undefined ||\n    oraclePrice === undefined ||\n    isNaN(midPrice) ||\n    isNaN(oraclePrice) ||\n    midPrice <= 0 ||\n    oraclePrice <= 0\n  ) {\n    return true;\n  }\n\n  const deviation = Math.abs(midPrice - oraclePrice) / oraclePrice;\n  return deviation <= deviationLimit;\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 * @param assetNames - Optional mapping of asset symbols to human-readable names.\n * Defaults to the bundled HYPERLIQUID_ASSET_NAMES; unmapped assets fall back to\n * their ticker symbol.\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  assetNames?: Record<string, string>,\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 && hasProperty(assetCtx, 'funding')) {\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 static mapping\n    const marketType: MarketType | undefined = assetMarketTypes?.[symbol];\n\n    // Mark as \"new\" if it's a HIP-3 market but not explicitly categorized\n    const isNewMarket = isHip3 && !marketType;\n\n    return {\n      symbol,\n      name: getHyperLiquidAssetName(symbol, assetNames),\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/marketSearch.cjs

@@ -1,111 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.rankMarketsByQuery = exports.getMarketMatchRank = exports.MarketMatchRank = void 0;
-/**
- * Relevance tier for a market/query match. Lower values sort first.
- */
-var MarketMatchRank;
-(function (MarketMatchRank) {
-    MarketMatchRank[MarketMatchRank["Exact"] = 0] = "Exact";
-    MarketMatchRank[MarketMatchRank["Prefix"] = 1] = "Prefix";
-    MarketMatchRank[MarketMatchRank["Substring"] = 2] = "Substring";
-})(MarketMatchRank || (exports.MarketMatchRank = MarketMatchRank = {}));
-/**
- * Rank a single field value against a normalized query.
- *
- * @param value - Field value (e.g. symbol or name); may be undefined.
- * @param query - Already trimmed, lower-cased, non-empty query.
- * @returns The match tier, or null when the field does not match.
- */
-function fieldRank(value, query) {
-    if (!value) {
-        return null;
-    }
-    const normalized = value.toLowerCase();
-    if (normalized === query) {
-        return MarketMatchRank.Exact;
-    }
-    if (normalized.startsWith(query)) {
-        return MarketMatchRank.Prefix;
-    }
-    if (normalized.includes(query)) {
-        return MarketMatchRank.Substring;
-    }
-    return null;
-}
-/**
- * Rank an array of keyword strings against a normalized query.
- * Returns the best (lowest) rank found across all keywords, or null.
- *
- * @param keywords - Array of keyword strings; may be undefined.
- * @param query - Already trimmed, lower-cased, non-empty query.
- * @returns The best match tier across all keywords, or null when none match.
- */
-function keywordsRank(keywords, query) {
-    if (!keywords || keywords.length === 0) {
-        return null;
-    }
-    let best = null;
-    for (const keyword of keywords) {
-        const rank = fieldRank(keyword, query);
-        if (rank === MarketMatchRank.Exact) {
-            return rank;
-        }
-        if (rank !== null && (best === null || rank < best)) {
-            best = rank;
-        }
-    }
-    return best;
-}
-/**
- * Compute the best (lowest) relevance rank for a market against a search query,
- * considering its ticker symbol, human-readable name, and optional keywords
- * from Terminal API metadata.
- *
- * @param market - Market to score (uses `symbol`, `name`, and optional `keywords`).
- * @param searchQuery - User search text (trimmed/cased internally).
- * @returns The match rank, or null when the market does not match (or the query
- * is empty/whitespace).
- */
-function getMarketMatchRank(market, searchQuery) {
-    if (!searchQuery?.trim()) {
-        return null;
-    }
-    const query = searchQuery.toLowerCase().trim();
-    const ranks = [
-        fieldRank(market.symbol, query),
-        fieldRank(market.name, query),
-        keywordsRank(market.keywords, query),
-    ].filter((rank) => rank !== null);
-    return ranks.length > 0 ? Math.min(...ranks) : null;
-}
-exports.getMarketMatchRank = getMarketMatchRank;
-/**
- * Filter and rank markets by a search query, matching the human-readable name or
- * ticker symbol. Exact matches sort first, then prefix, then substring; markets
- * sharing a rank keep their input order (stable). An empty/whitespace query
- * returns the markets unchanged (no filtering), matching `filterMarketsByQuery`.
- *
- * @param markets - Markets to search.
- * @param searchQuery - User search text.
- * @returns Matching markets ordered by relevance.
- */
-function rankMarketsByQuery(markets, searchQuery) {
-    if (!searchQuery?.trim()) {
-        return markets;
-    }
-    const query = searchQuery.toLowerCase().trim();
-    const matches = [];
-    markets.forEach((market) => {
-        const rank = getMarketMatchRank(market, query);
-        if (rank !== null) {
-            matches.push({ market, rank });
-        }
-    });
-    // Stable sort by rank only; Array.prototype.sort is stable in modern engines,
-    // so equal-rank markets retain their original relative order.
-    matches.sort((a, b) => a.rank - b.rank);
-    return matches.map((match) => match.market);
-}
-exports.rankMarketsByQuery = rankMarketsByQuery;
-//# sourceMappingURL=marketSearch.cjs.map

package/dist/utils/marketSearch.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"marketSearch.cjs","sourceRoot":"","sources":["../../src/utils/marketSearch.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Market search ranking (TAT-2413).\n *\n * Provisional, standalone helper layered on the same match semantics as\n * `filterMarketsByQuery` (case-insensitive substring on a market's ticker symbol\n * and human-readable name). It adds the one thing `filterMarketsByQuery` does\n * not: relevance ranking — exact matches first, then prefix, then substring;\n * ties keep their input order (stable). No fuzzy/phonetic matching (out of scope\n * for v1).\n *\n * Kept in its own file so it can be promoted or relocated later without touching\n * the shared `marketUtils`. A market matches here (rank !== null) iff\n * `filterMarketsByQuery` would include it, so the two stay behaviorally aligned.\n *\n * Portable: no platform-specific imports.\n */\nimport type { PerpsMarketData } from '../types/index.js';\n\n/**\n * Relevance tier for a market/query match. Lower values sort first.\n */\nexport enum MarketMatchRank {\n  Exact = 0,\n  Prefix = 1,\n  Substring = 2,\n}\n\n/**\n * Rank a single field value against a normalized query.\n *\n * @param value - Field value (e.g. symbol or name); may be undefined.\n * @param query - Already trimmed, lower-cased, non-empty query.\n * @returns The match tier, or null when the field does not match.\n */\nfunction fieldRank(\n  value: string | undefined,\n  query: string,\n): MarketMatchRank | null {\n  if (!value) {\n    return null;\n  }\n  const normalized = value.toLowerCase();\n  if (normalized === query) {\n    return MarketMatchRank.Exact;\n  }\n  if (normalized.startsWith(query)) {\n    return MarketMatchRank.Prefix;\n  }\n  if (normalized.includes(query)) {\n    return MarketMatchRank.Substring;\n  }\n  return null;\n}\n\n/**\n * Rank an array of keyword strings against a normalized query.\n * Returns the best (lowest) rank found across all keywords, or null.\n *\n * @param keywords - Array of keyword strings; may be undefined.\n * @param query - Already trimmed, lower-cased, non-empty query.\n * @returns The best match tier across all keywords, or null when none match.\n */\nfunction keywordsRank(\n  keywords: string[] | undefined,\n  query: string,\n): MarketMatchRank | null {\n  if (!keywords || keywords.length === 0) {\n    return null;\n  }\n  let best: MarketMatchRank | null = null;\n  for (const keyword of keywords) {\n    const rank = fieldRank(keyword, query);\n    if (rank === MarketMatchRank.Exact) {\n      return rank;\n    }\n    if (rank !== null && (best === null || rank < best)) {\n      best = rank;\n    }\n  }\n  return best;\n}\n\n/**\n * Compute the best (lowest) relevance rank for a market against a search query,\n * considering its ticker symbol, human-readable name, and optional keywords\n * from Terminal API metadata.\n *\n * @param market - Market to score (uses `symbol`, `name`, and optional `keywords`).\n * @param searchQuery - User search text (trimmed/cased internally).\n * @returns The match rank, or null when the market does not match (or the query\n * is empty/whitespace).\n */\nexport function getMarketMatchRank(\n  market: Pick<PerpsMarketData, 'symbol' | 'name' | 'keywords'>,\n  searchQuery: string,\n): MarketMatchRank | null {\n  if (!searchQuery?.trim()) {\n    return null;\n  }\n  const query = searchQuery.toLowerCase().trim();\n  const ranks = [\n    fieldRank(market.symbol, query),\n    fieldRank(market.name, query),\n    keywordsRank(market.keywords, query),\n  ].filter((rank): rank is MarketMatchRank => rank !== null);\n\n  return ranks.length > 0 ? Math.min(...ranks) : null;\n}\n\n/**\n * Filter and rank markets by a search query, matching the human-readable name or\n * ticker symbol. Exact matches sort first, then prefix, then substring; markets\n * sharing a rank keep their input order (stable). An empty/whitespace query\n * returns the markets unchanged (no filtering), matching `filterMarketsByQuery`.\n *\n * @param markets - Markets to search.\n * @param searchQuery - User search text.\n * @returns Matching markets ordered by relevance.\n */\nexport function rankMarketsByQuery(\n  markets: PerpsMarketData[],\n  searchQuery: string,\n): PerpsMarketData[] {\n  if (!searchQuery?.trim()) {\n    return markets;\n  }\n  const query = searchQuery.toLowerCase().trim();\n\n  const matches: { market: PerpsMarketData; rank: MarketMatchRank }[] = [];\n  markets.forEach((market) => {\n    const rank = getMarketMatchRank(market, query);\n    if (rank !== null) {\n      matches.push({ market, rank });\n    }\n  });\n\n  // Stable sort by rank only; Array.prototype.sort is stable in modern engines,\n  // so equal-rank markets retain their original relative order.\n  matches.sort((a, b) => a.rank - b.rank);\n  return matches.map((match) => match.market);\n}\n"]}

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

@@ -1 +0,0 @@
-{"version":3,"file":"marketSearch.d.cts","sourceRoot":"","sources":["../../src/utils/marketSearch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,2BAA0B;AAEzD;;GAEG;AACH,oBAAY,eAAe;IACzB,KAAK,IAAI;IACT,MAAM,IAAI;IACV,SAAS,IAAI;CACd;AAyDD;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,IAAI,CAAC,eAAe,EAAE,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC,EAC7D,WAAW,EAAE,MAAM,GAClB,eAAe,GAAG,IAAI,CAYxB;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,eAAe,EAAE,EAC1B,WAAW,EAAE,MAAM,GAClB,eAAe,EAAE,CAkBnB"}

package/dist/utils/marketSearch.d.mts

@@ -1,48 +0,0 @@
-/**
- * Market search ranking (TAT-2413).
- *
- * Provisional, standalone helper layered on the same match semantics as
- * `filterMarketsByQuery` (case-insensitive substring on a market's ticker symbol
- * and human-readable name). It adds the one thing `filterMarketsByQuery` does
- * not: relevance ranking — exact matches first, then prefix, then substring;
- * ties keep their input order (stable). No fuzzy/phonetic matching (out of scope
- * for v1).
- *
- * Kept in its own file so it can be promoted or relocated later without touching
- * the shared `marketUtils`. A market matches here (rank !== null) iff
- * `filterMarketsByQuery` would include it, so the two stay behaviorally aligned.
- *
- * Portable: no platform-specific imports.
- */
-import type { PerpsMarketData } from "../types/index.mjs";
-/**
- * Relevance tier for a market/query match. Lower values sort first.
- */
-export declare enum MarketMatchRank {
-    Exact = 0,
-    Prefix = 1,
-    Substring = 2
-}
-/**
- * Compute the best (lowest) relevance rank for a market against a search query,
- * considering its ticker symbol, human-readable name, and optional keywords
- * from Terminal API metadata.
- *
- * @param market - Market to score (uses `symbol`, `name`, and optional `keywords`).
- * @param searchQuery - User search text (trimmed/cased internally).
- * @returns The match rank, or null when the market does not match (or the query
- * is empty/whitespace).
- */
-export declare function getMarketMatchRank(market: Pick<PerpsMarketData, 'symbol' | 'name' | 'keywords'>, searchQuery: string): MarketMatchRank | null;
-/**
- * Filter and rank markets by a search query, matching the human-readable name or
- * ticker symbol. Exact matches sort first, then prefix, then substring; markets
- * sharing a rank keep their input order (stable). An empty/whitespace query
- * returns the markets unchanged (no filtering), matching `filterMarketsByQuery`.
- *
- * @param markets - Markets to search.
- * @param searchQuery - User search text.
- * @returns Matching markets ordered by relevance.
- */
-export declare function rankMarketsByQuery(markets: PerpsMarketData[], searchQuery: string): PerpsMarketData[];
-//# sourceMappingURL=marketSearch.d.mts.map