@metamask-previews/perps-controller 8.2.0-preview-b2742a2fc → 8.3.0-preview-a8fd340

package/dist/utils/marketDataTransform.d.mts

@@ -10,6 +10,34 @@ import type { AllMidsResponse, PerpsUniverse, PerpsAssetCtx, PredictedFunding }
  * @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
  */

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

@@ -1 +1 @@
-{"version":3,"file":"marketDataTransform.d.mts","sourceRoot":"","sources":["../../src/utils/marketDataTransform.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EACV,eAAe,EACf,UAAU,EACV,oBAAoB,EACrB,2BAAiB;AAClB,OAAO,KAAK,EACV,eAAe,EACf,aAAa,EACb,aAAa,EACb,gBAAgB,EACjB,uCAAmC;AAGpC;;;;;;;;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;;;;;;;;;;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,CA6GnB;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,oBAAoB,GAC/B,MAAM,CAeR"}
+{"version":3,"file":"marketDataTransform.d.mts","sourceRoot":"","sources":["../../src/utils/marketDataTransform.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EACV,eAAe,EACf,UAAU,EACV,oBAAoB,EACrB,2BAAiB;AAClB,OAAO,KAAK,EACV,eAAe,EACf,aAAa,EACb,aAAa,EACb,gBAAgB,EACjB,uCAAmC;AAGpC;;;;;;;;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

@@ -28,6 +28,45 @@ export function calculateOpenInterestUSD(openInterest, currentPrice) {
     }
     return openInterestNum * priceNum;
 }
+/**
+ * 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 function isMarketTradable(params) {
+    const { midPrice, oraclePrice, deviationLimit = 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;
+}
 /**
  * Calculate 24h percentage change
  * Shows -100% when current price is missing but previous price exists
@@ -144,15 +183,10 @@ export function transformMarketData(hyperLiquidData, formatters, assetMarketType
         // 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;
+        // 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
-        // New markets are always HIP-3 (non-crypto) that haven't been assigned a category yet
-        const isNewMarket = isHip3 && !explicitMarketType;
+        const isNewMarket = isHip3 && !marketType;
         return {
             symbol,
             name: getHyperLiquidAssetName(symbol, assetNames),

package/dist/utils/marketDataTransform.mjs.map

@@ -1 +1 @@
-{"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';\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';\nimport { parseAssetName } from './hyperLiquidAdapter';\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 * @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 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: 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"]}
+{"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';\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';\nimport { parseAssetName } from './hyperLiquidAdapter';\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

@@ -33,11 +33,36 @@ function fieldRank(value, query) {
     }
     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 both its ticker symbol and human-readable name.
+ * considering its ticker symbol, human-readable name, and optional keywords
+ * from Terminal API metadata.
  *
- * @param market - Market to score (uses `symbol` and `name`).
+ * @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).
@@ -50,6 +75,7 @@ function getMarketMatchRank(market, searchQuery) {
     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;
 }

package/dist/utils/marketSearch.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"marketSearch.cjs","sourceRoot":"","sources":["../../src/utils/marketSearch.ts"],"names":[],"mappings":";;;AAkBA;;GAEG;AACH,IAAY,eAIX;AAJD,WAAY,eAAe;IACzB,uDAAS,CAAA;IACT,yDAAU,CAAA;IACV,+DAAa,CAAA;AACf,CAAC,EAJW,eAAe,+BAAf,eAAe,QAI1B;AAED;;;;;;GAMG;AACH,SAAS,SAAS,CAChB,KAAyB,EACzB,KAAa;IAEb,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IACvC,IAAI,UAAU,KAAK,KAAK,EAAE,CAAC;QACzB,OAAO,eAAe,CAAC,KAAK,CAAC;IAC/B,CAAC;IACD,IAAI,UAAU,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO,eAAe,CAAC,MAAM,CAAC;IAChC,CAAC;IACD,IAAI,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,eAAe,CAAC,SAAS,CAAC;IACnC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,kBAAkB,CAChC,MAAgD,EAChD,WAAmB;IAEnB,IAAI,CAAC,WAAW,EAAE,IAAI,EAAE,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,KAAK,GAAG,WAAW,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;IAC/C,MAAM,KAAK,GAAG;QACZ,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC;QAC/B,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC;KAC9B,CAAC,MAAM,CAAC,CAAC,IAAI,EAA2B,EAAE,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IAE3D,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACtD,CAAC;AAdD,gDAcC;AAED;;;;;;;;;GASG;AACH,SAAgB,kBAAkB,CAChC,OAA0B,EAC1B,WAAmB;IAEnB,IAAI,CAAC,WAAW,EAAE,IAAI,EAAE,EAAE,CAAC;QACzB,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,MAAM,KAAK,GAAG,WAAW,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;IAE/C,MAAM,OAAO,GAAyD,EAAE,CAAC;IACzE,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE;QACzB,MAAM,IAAI,GAAG,kBAAkB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAC/C,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAClB,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QACjC,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,8EAA8E;IAC9E,8DAA8D;IAC9D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC;IACxC,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AAC9C,CAAC;AArBD,gDAqBC","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';\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 * Compute the best (lowest) relevance rank for a market against a search query,\n * considering both its ticker symbol and human-readable name.\n *\n * @param market - Market to score (uses `symbol` and `name`).\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'>,\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  ].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"]}
+{"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';\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

@@ -25,14 +25,15 @@ export declare enum MarketMatchRank {
 }
 /**
  * Compute the best (lowest) relevance rank for a market against a search query,
- * considering both its ticker symbol and human-readable name.
+ * considering its ticker symbol, human-readable name, and optional keywords
+ * from Terminal API metadata.
  *
- * @param market - Market to score (uses `symbol` and `name`).
+ * @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'>, searchQuery: string): MarketMatchRank | null;
+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

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

@@ -1 +1 @@
-{"version":3,"file":"marketSearch.d.cts","sourceRoot":"","sources":["../../src/utils/marketSearch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,2BAAiB;AAEhD;;GAEG;AACH,oBAAY,eAAe;IACzB,KAAK,IAAI;IACT,MAAM,IAAI;IACV,SAAS,IAAI;CACd;AA6BD;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,IAAI,CAAC,eAAe,EAAE,QAAQ,GAAG,MAAM,CAAC,EAChD,WAAW,EAAE,MAAM,GAClB,eAAe,GAAG,IAAI,CAWxB;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,eAAe,EAAE,EAC1B,WAAW,EAAE,MAAM,GAClB,eAAe,EAAE,CAkBnB"}
+{"version":3,"file":"marketSearch.d.cts","sourceRoot":"","sources":["../../src/utils/marketSearch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,2BAAiB;AAEhD;;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

@@ -25,14 +25,15 @@ export declare enum MarketMatchRank {
 }
 /**
  * Compute the best (lowest) relevance rank for a market against a search query,
- * considering both its ticker symbol and human-readable name.
+ * considering its ticker symbol, human-readable name, and optional keywords
+ * from Terminal API metadata.
  *
- * @param market - Market to score (uses `symbol` and `name`).
+ * @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'>, searchQuery: string): MarketMatchRank | null;
+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

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

@@ -1 +1 @@
-{"version":3,"file":"marketSearch.d.mts","sourceRoot":"","sources":["../../src/utils/marketSearch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,2BAAiB;AAEhD;;GAEG;AACH,oBAAY,eAAe;IACzB,KAAK,IAAI;IACT,MAAM,IAAI;IACV,SAAS,IAAI;CACd;AA6BD;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,IAAI,CAAC,eAAe,EAAE,QAAQ,GAAG,MAAM,CAAC,EAChD,WAAW,EAAE,MAAM,GAClB,eAAe,GAAG,IAAI,CAWxB;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,eAAe,EAAE,EAC1B,WAAW,EAAE,MAAM,GAClB,eAAe,EAAE,CAkBnB"}
+{"version":3,"file":"marketSearch.d.mts","sourceRoot":"","sources":["../../src/utils/marketSearch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,2BAAiB;AAEhD;;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.mjs

@@ -30,11 +30,36 @@ function fieldRank(value, query) {
     }
     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 both its ticker symbol and human-readable name.
+ * considering its ticker symbol, human-readable name, and optional keywords
+ * from Terminal API metadata.
  *
- * @param market - Market to score (uses `symbol` and `name`).
+ * @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).
@@ -47,6 +72,7 @@ export function getMarketMatchRank(market, searchQuery) {
     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;
 }

package/dist/utils/marketSearch.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"marketSearch.mjs","sourceRoot":"","sources":["../../src/utils/marketSearch.ts"],"names":[],"mappings":"AAkBA;;GAEG;AACH,MAAM,CAAN,IAAY,eAIX;AAJD,WAAY,eAAe;IACzB,uDAAS,CAAA;IACT,yDAAU,CAAA;IACV,+DAAa,CAAA;AACf,CAAC,EAJW,eAAe,KAAf,eAAe,QAI1B;AAED;;;;;;GAMG;AACH,SAAS,SAAS,CAChB,KAAyB,EACzB,KAAa;IAEb,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IACvC,IAAI,UAAU,KAAK,KAAK,EAAE,CAAC;QACzB,OAAO,eAAe,CAAC,KAAK,CAAC;IAC/B,CAAC;IACD,IAAI,UAAU,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO,eAAe,CAAC,MAAM,CAAC;IAChC,CAAC;IACD,IAAI,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,eAAe,CAAC,SAAS,CAAC;IACnC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CAChC,MAAgD,EAChD,WAAmB;IAEnB,IAAI,CAAC,WAAW,EAAE,IAAI,EAAE,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,KAAK,GAAG,WAAW,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;IAC/C,MAAM,KAAK,GAAG;QACZ,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC;QAC/B,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC;KAC9B,CAAC,MAAM,CAAC,CAAC,IAAI,EAA2B,EAAE,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IAE3D,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACtD,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,kBAAkB,CAChC,OAA0B,EAC1B,WAAmB;IAEnB,IAAI,CAAC,WAAW,EAAE,IAAI,EAAE,EAAE,CAAC;QACzB,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,MAAM,KAAK,GAAG,WAAW,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;IAE/C,MAAM,OAAO,GAAyD,EAAE,CAAC;IACzE,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE;QACzB,MAAM,IAAI,GAAG,kBAAkB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAC/C,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAClB,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QACjC,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,8EAA8E;IAC9E,8DAA8D;IAC9D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC;IACxC,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AAC9C,CAAC","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';\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 * Compute the best (lowest) relevance rank for a market against a search query,\n * considering both its ticker symbol and human-readable name.\n *\n * @param market - Market to score (uses `symbol` and `name`).\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'>,\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  ].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"]}
+{"version":3,"file":"marketSearch.mjs","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';\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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metamask-previews/perps-controller",
-  "version": "8.2.0-preview-b2742a2fc",
+  "version": "8.3.0-preview-a8fd340",
   "description": "Controller for perpetual trading functionality in MetaMask",
   "keywords": [
     "Ethereum",
@@ -100,6 +100,7 @@
     "@metamask/base-controller": "^9.1.0",
     "@metamask/controller-utils": "^12.3.0",
     "@metamask/messenger": "^1.2.0",
+    "@metamask/superstruct": "^3.1.0",
     "@metamask/utils": "^11.11.0",
     "@nktkas/hyperliquid": "^0.32.2",
     "bignumber.js": "^9.1.2",
@@ -107,7 +108,7 @@
     "uuid": "^8.3.2"
   },
   "devDependencies": {
-    "@metamask/account-tree-controller": "^7.5.2",
+    "@metamask/account-tree-controller": "^7.5.3",
     "@metamask/auto-changelog": "^6.1.0",
     "@metamask/geolocation-controller": "^0.1.3",
     "@metamask/keyring-controller": "^27.1.0",