@metamask-previews/perps-controller 0.0.0-preview-ae46ab603 → 0.0.0-preview-e4aa1532

package/dist/utils/marketUtils.cjs

@@ -0,0 +1,420 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getAssetIconUrls = exports.getAssetIconUrl = exports.filterMarketsByQuery = exports.getMarketBadgeType = exports.calculate24hHighLow = exports.calculateFundingCountdown = exports.getPerpsDexFromSymbol = exports.getPerpsDisplaySymbol = exports.shouldIncludeMarket = exports.matchesMarketPattern = exports.compileMarketPattern = exports.validateMarketPattern = exports.escapeRegex = void 0;
+const hyperLiquidConfig_1 = require("../constants/hyperLiquidConfig.cjs");
+/**
+ * Maximum length for market filter patterns (prevents DoS attacks)
+ */
+const MAX_MARKET_PATTERN_LENGTH = 100;
+/**
+ * Escape special regex characters in a string
+ *
+ * @param str - String to escape
+ * @returns Escaped string safe for regex
+ */
+const escapeRegex = (str) => str.replace(/[.*+?^${}()|[\]\\]/gu, '\\$&');
+exports.escapeRegex = escapeRegex;
+/**
+ * Validate market filter pattern for safety
+ * Prevents regex DoS attacks from malicious patterns
+ *
+ * @param pattern - Pattern to validate
+ * @returns true if pattern is safe
+ * @throws Error if pattern is unsafe
+ *
+ * @example Valid patterns
+ * validateMarketPattern("BTC") // → true
+ * validateMarketPattern("xyz:TSLA") // → true
+ * validateMarketPattern("xyz:*") // → true
+ *
+ * @example Invalid patterns
+ * validateMarketPattern("") // → throws Error
+ * validateMarketPattern("xyz:.*") // → throws Error (regex chars)
+ * validateMarketPattern("BTC#SCAM") // → throws Error (invalid char)
+ */
+const validateMarketPattern = (pattern) => {
+    // Reject empty patterns
+    if (!pattern || pattern.trim().length === 0) {
+        throw new Error('Market pattern cannot be empty');
+    }
+    // Trim whitespace and normalize the pattern
+    const normalizedPattern = pattern.trim();
+    // Reject patterns that are too long (potential DoS)
+    if (normalizedPattern.length > MAX_MARKET_PATTERN_LENGTH) {
+        throw new Error(`Market pattern exceeds maximum length (${MAX_MARKET_PATTERN_LENGTH} chars): ${normalizedPattern}`);
+    }
+    // Reject patterns with suspicious regex control characters
+    // Allow only colon and asterisk for our pattern syntax
+    const dangerousChars = /[\\()[\]{}^$+?.|]/u;
+    if (dangerousChars.test(normalizedPattern)) {
+        throw new Error(`Market pattern contains invalid regex characters: ${normalizedPattern}`);
+    }
+    // Allow only: alphanumeric, colon, hyphen, underscore, asterisk
+    const validPattern = /^[a-zA-Z0-9:_\-*]+$/u;
+    if (!validPattern.test(normalizedPattern)) {
+        throw new Error(`Market pattern contains invalid characters: ${normalizedPattern}`);
+    }
+    return true;
+};
+exports.validateMarketPattern = validateMarketPattern;
+/**
+ * Compile market filter pattern into optimized matcher
+ * Supports wildcards ("xyz:*"), DEX shorthand ("xyz"), and exact matches ("xyz:TSLA")
+ *
+ * Note: Main DEX markets (no prefix) don't need filtering - they're always included.
+ * Patterns without colons are treated as HIP-3 DEX shorthand.
+ *
+ * @param pattern - Pattern string (e.g., "xyz:*", "xyz:TSLA", "xyz")
+ * @returns Compiled matcher (RegExp for wildcards/shorthand, string for exact match)
+ *
+ * @example Wildcard - matches all markets from a DEX
+ * compileMarketPattern("xyz:*") // → /^xyz:/
+ *
+ * @example DEX shorthand - equivalent to wildcard
+ * compileMarketPattern("xyz") // → /^xyz:/ (matches all xyz markets)
+ *
+ * @example Exact match - matches specific market
+ * compileMarketPattern("xyz:TSLA") // → "xyz:TSLA"
+ */
+const compileMarketPattern = (pattern) => {
+    // Trim and validate pattern before compilation to prevent regex DoS
+    const normalizedPattern = pattern.trim();
+    (0, exports.validateMarketPattern)(normalizedPattern);
+    if (normalizedPattern.endsWith(':*')) {
+        // Wildcard: "xyz:*" → regex /^xyz:/
+        const prefix = normalizedPattern.slice(0, -2);
+        return new RegExp(`^${(0, exports.escapeRegex)(prefix)}:`, 'u');
+    }
+    if (!normalizedPattern.includes(':')) {
+        // DEX shorthand: "xyz" → regex /^xyz:/
+        return new RegExp(`^${(0, exports.escapeRegex)(normalizedPattern)}:`, 'u');
+    }
+    // Exact match: just use string (fastest)
+    return normalizedPattern;
+};
+exports.compileMarketPattern = compileMarketPattern;
+/**
+ * Check if a symbol matches a compiled pattern matcher
+ *
+ * @param symbol - Market symbol (e.g., "BTC", "xyz:TSLA")
+ * @param matcher - Compiled matcher (string or RegExp)
+ * @returns true if symbol matches the pattern
+ */
+const matchesMarketPattern = (symbol, matcher) => {
+    if (typeof matcher === 'string') {
+        // Exact match - fastest
+        return symbol === matcher;
+    }
+    // RegExp match - still very fast
+    return matcher.test(symbol);
+};
+exports.matchesMarketPattern = matchesMarketPattern;
+/**
+ * Check if a market should be included based on HIP-3 master switch and whitelist/blacklist patterns
+ * Main DEX markets (null dex) are ALWAYS included (no filtering)
+ *
+ * Logic: Check master switch → apply whitelist (if non-empty) → apply blacklist
+ *
+ * @param symbol - Market symbol (e.g., "BTC", "xyz:TSLA")
+ * @param dex - DEX identifier (null for main DEX, "xyz" for HIP-3 DEX)
+ * @param hip3Enabled - Master switch for HIP-3 markets (false = block all HIP-3)
+ * @param compiledEnabledPatterns - Pre-compiled whitelist patterns (empty = allow all)
+ * @param compiledBlockedPatterns - Pre-compiled blacklist patterns (empty = block none)
+ * @returns true if market should be shown to users
+ *
+ * @example Main DEX market (always included)
+ * shouldIncludeMarket("BTC", null, true, [...], [...]) // → true
+ *
+ * @example HIP-3 when master switch is OFF
+ * shouldIncludeMarket("xyz:TSLA", "xyz", false, [...], [...]) // → false (HIP-3 disabled)
+ *
+ * @example HIP-3 with empty whitelist (discovery mode)
+ * shouldIncludeMarket("xyz:TSLA", "xyz", true, [], []) // → true (allow all)
+ *
+ * @example HIP-3 with whitelist
+ * shouldIncludeMarket("xyz:TSLA", "xyz", true,
+ *   [{pattern: "xyz:*", matcher: /^xyz:/}], []) // → true (matches whitelist)
+ *
+ * @example HIP-3 with blacklist
+ * shouldIncludeMarket("xyz:SCAM", "xyz", true, [],
+ *   [{pattern: "xyz:SCAM", matcher: "xyz:SCAM"}]) // → false (blocked)
+ */
+const shouldIncludeMarket = (symbol, dex, hip3Enabled, compiledEnabledPatterns, compiledBlockedPatterns) => {
+    // ALWAYS include main DEX markets (no filtering)
+    if (dex === null) {
+        return true;
+    }
+    // Enforce HIP-3 master switch: if disabled, block ALL HIP-3 markets
+    if (!hip3Enabled) {
+        return false;
+    }
+    // Step 1: Apply whitelist only if non-empty
+    if (compiledEnabledPatterns.length > 0) {
+        const whitelisted = compiledEnabledPatterns.some(({ matcher }) => (0, exports.matchesMarketPattern)(symbol, matcher));
+        if (!whitelisted) {
+            return false;
+        }
+    }
+    // Step 2: Apply blacklist ONLY if non-empty (early return optimization)
+    if (compiledBlockedPatterns.length === 0) {
+        return true; // No blacklist to check - accept immediately
+    }
+    // Only reach here if blacklist has values
+    const blacklisted = compiledBlockedPatterns.some(({ matcher }) => (0, exports.matchesMarketPattern)(symbol, matcher));
+    return !blacklisted;
+};
+exports.shouldIncludeMarket = shouldIncludeMarket;
+/**
+ * Extract the display symbol from a full symbol string
+ * Strips DEX prefix for HIP-3 markets (e.g., "xyz:XYZ100" -> "XYZ100")
+ * Returns the symbol unchanged if no DEX prefix is present
+ *
+ * @param symbol - Full symbol (e.g., "BTC" or "xyz:XYZ100")
+ * @returns Display symbol without DEX prefix (e.g., "BTC" or "XYZ100")
+ */
+const getPerpsDisplaySymbol = (symbol) => {
+    if (!symbol || typeof symbol !== 'string') {
+        return symbol;
+    }
+    // Check for DEX prefix pattern (dex:symbol)
+    const colonIndex = symbol.indexOf(':');
+    if (colonIndex > 0 && colonIndex < symbol.length - 1) {
+        // Return everything after the colon
+        return symbol.substring(colonIndex + 1);
+    }
+    // No DEX prefix found, return original symbol
+    return symbol;
+};
+exports.getPerpsDisplaySymbol = getPerpsDisplaySymbol;
+/**
+ * Extract the DEX identifier from a full symbol string
+ * Returns the DEX prefix for HIP-3 markets (e.g., "xyz:XYZ100" -> "xyz")
+ * Returns null if no DEX prefix is present (main DEX market)
+ *
+ * @param symbol - Full symbol (e.g., "BTC" or "xyz:XYZ100")
+ * @returns DEX identifier or null if main DEX (e.g., "xyz" or null)
+ */
+const getPerpsDexFromSymbol = (symbol) => {
+    if (!symbol || typeof symbol !== 'string') {
+        return null;
+    }
+    // Check for DEX prefix pattern (dex:symbol)
+    const colonIndex = symbol.indexOf(':');
+    if (colonIndex > 0 && colonIndex < symbol.length - 1) {
+        // Return the DEX prefix (everything before the colon)
+        return symbol.substring(0, colonIndex);
+    }
+    // No DEX prefix found, this is a main DEX market
+    return null;
+};
+exports.getPerpsDexFromSymbol = getPerpsDexFromSymbol;
+/**
+ * Calculate the time until the next funding period.
+ * Supports market-specific funding times when provided.
+ * Falls back to default HyperLiquid 1-hour periods (funding paid every hour).
+ *
+ * @param params - Optional funding countdown parameters
+ * @returns Formatted countdown string in HH:MM:SS format
+ */
+const calculateFundingCountdown = (params) => {
+    const now = new Date();
+    const nowMs = now.getTime();
+    // If we have a specific next funding time, check if it's reasonable for HyperLiquid's hourly funding
+    if (params?.nextFundingTime && params.nextFundingTime > nowMs) {
+        const msUntilFunding = params.nextFundingTime - nowMs;
+        const hoursUntilFunding = msUntilFunding / (1000 * 60 * 60);
+        // If API shows >1.1 hours, it's likely incorrect for HyperLiquid's hourly funding
+        // Use fallback calculation instead to show time until next hour
+        if (hoursUntilFunding <= 1.1) {
+            const totalSeconds = Math.floor(msUntilFunding / 1000);
+            const hours = Math.floor(totalSeconds / 3600);
+            const minutes = Math.floor((totalSeconds % 3600) / 60);
+            const seconds = totalSeconds % 60;
+            // Format as HH:MM:SS
+            const formattedHours = String(hours).padStart(2, '0');
+            const formattedMinutes = String(minutes).padStart(2, '0');
+            const formattedSeconds = String(seconds).padStart(2, '0');
+            return `${formattedHours}:${formattedMinutes}:${formattedSeconds}`;
+        }
+        // If >1.1 hours, fall through to use hourly calculation instead
+    }
+    // Fall back to default calculation for HyperLiquid (1-hour periods)
+    // HyperLiquid pays funding every hour, so next funding is at the next hour
+    const utcMinutes = now.getUTCMinutes();
+    const utcSeconds = now.getUTCSeconds();
+    // Calculate time remaining until next hour (next funding time)
+    const minutesUntilNextHour = 59 - utcMinutes;
+    const secondsUntilNextHour = 60 - utcSeconds;
+    // Handle edge case where seconds equals 60
+    const finalSeconds = secondsUntilNextHour === 60 ? 0 : secondsUntilNextHour;
+    const finalMinutes = secondsUntilNextHour === 60
+        ? minutesUntilNextHour + 1
+        : minutesUntilNextHour;
+    // For HyperLiquid 1-hour funding, hours should always be 0
+    // (countdown should never exceed 59:59 since funding happens every hour)
+    const finalHours = finalMinutes === 60 ? 1 : 0;
+    const adjustedMinutes = finalMinutes === 60 ? 0 : finalMinutes;
+    // Format as HH:MM:SS
+    const formattedHours = String(finalHours).padStart(2, '0');
+    const formattedMinutes = String(adjustedMinutes).padStart(2, '0');
+    const formattedSeconds = String(finalSeconds).padStart(2, '0');
+    return `${formattedHours}:${formattedMinutes}:${formattedSeconds}`;
+};
+exports.calculateFundingCountdown = calculateFundingCountdown;
+/**
+ * Calculate 24h high and low from candlestick data.
+ *
+ * @param candleData - Candlestick data containing price candles
+ * @returns Object with high and low prices for the last 24 hours
+ */
+const calculate24hHighLow = (candleData) => {
+    if (!candleData?.candles || candleData.candles.length === 0) {
+        return { high: 0, low: 0 };
+    }
+    // Get candles from last 24 hours
+    const now = Date.now();
+    const twentyFourHoursAgo = now - 24 * 60 * 60 * 1000;
+    let last24hCandles = candleData.candles.filter((candle) => candle.time >= twentyFourHoursAgo);
+    if (last24hCandles.length === 0) {
+        // If no 24h data, use all available candles
+        last24hCandles = [...candleData.candles];
+    }
+    const highs = last24hCandles.map((candle) => parseFloat(candle.high));
+    const lows = last24hCandles.map((candle) => parseFloat(candle.low));
+    return {
+        high: Math.max(...highs),
+        low: Math.min(...lows),
+    };
+};
+exports.calculate24hHighLow = calculate24hHighLow;
+/**
+ * Determine badge type for a market based on its metadata
+ * Prioritizes explicit marketType over generic experimental badge
+ *
+ * @param market - Market data object (only needs marketType and marketSource fields)
+ * @returns Badge type to display, or undefined for no badge (main DEX)
+ *
+ * @example Main DEX
+ * getMarketBadgeType({ symbol: 'BTC', marketSource: null }) // → undefined
+ *
+ * @example Mapped HIP-3 DEX
+ * getMarketBadgeType({ symbol: 'xyz:XYZ100', marketSource: 'xyz', marketType: 'equity' }) // → 'equity'
+ *
+ * @example Unmapped HIP-3 DEX
+ * getMarketBadgeType({ symbol: 'abc:ABC100', marketSource: 'abc' }) // → 'experimental'
+ */
+const getMarketBadgeType = (market) => 
+// Prioritize explicit marketType (e.g., 'equity' for xyz DEX)
+// Fall back to 'experimental' for unmapped HIP-3 DEXs
+// Main DEX markets without marketType show no badge
+market.marketType ?? (market.marketSource ? 'experimental' : undefined);
+exports.getMarketBadgeType = getMarketBadgeType;
+/**
+ * Filter markets by search query
+ * Searches through both symbol and name fields (case-insensitive)
+ *
+ * @param markets - Array of markets to filter
+ * @param searchQuery - Search query string
+ * @returns Filtered array of markets matching the query
+ *
+ * @example
+ * filterMarketsByQuery([{ symbol: 'BTC', name: 'Bitcoin' }], 'btc') // → [{ symbol: 'BTC', name: 'Bitcoin' }]
+ * filterMarketsByQuery([{ symbol: 'BTC', name: 'Bitcoin' }], 'coin') // → [{ symbol: 'BTC', name: 'Bitcoin' }]
+ * filterMarketsByQuery([{ symbol: 'BTC', name: 'Bitcoin' }], '') // → [{ symbol: 'BTC', name: 'Bitcoin' }]
+ */
+const filterMarketsByQuery = (markets, searchQuery) => {
+    // Return all markets if query is empty
+    if (!searchQuery?.trim()) {
+        return markets;
+    }
+    const lowerQuery = searchQuery.toLowerCase().trim();
+    return markets.filter((market) => market.symbol?.toLowerCase().includes(lowerQuery) ||
+        market.name?.toLowerCase().includes(lowerQuery));
+};
+exports.filterMarketsByQuery = filterMarketsByQuery;
+/**
+ * Generate the appropriate icon URL for an asset symbol
+ * Handles both regular assets and HIP-3 assets (dex:symbol format)
+ *
+ * @param symbol - Asset symbol (e.g., "BTC" or "xyz:TSLA")
+ * @param kPrefixAssets - Optional set of assets that have a 'k' prefix to remove
+ * @returns Icon URL for the asset
+ *
+ * @example Regular asset
+ * getAssetIconUrl('BTC') // → 'https://app.hyperliquid.xyz/coins/BTC.svg'
+ *
+ * @example HIP-3 asset
+ * getAssetIconUrl('xyz:TSLA') // → 'https://raw.githubusercontent.com/.../hip3%3Axyz_TSLA.svg'
+ *
+ * @example With k-prefix handling
+ * getAssetIconUrl('kBONK', new Set(['KBONK'])) // → 'https://app.hyperliquid.xyz/coins/BONK.svg'
+ */
+const getAssetIconUrl = (symbol, kPrefixAssets) => {
+    if (!symbol) {
+        return '';
+    }
+    // Check for HIP-3 asset (contains colon) BEFORE uppercasing
+    if (symbol.includes(':')) {
+        const [dex, assetSymbol] = symbol.split(':');
+        return `${hyperLiquidConfig_1.HYPERLIQUID_ASSET_ICONS_BASE_URL}${dex.toLowerCase()}:${assetSymbol.toUpperCase()}.svg`;
+    }
+    // For regular assets, uppercase the entire symbol
+    let processedSymbol = symbol.toUpperCase();
+    // Remove 'k' prefix only for specific assets if provided
+    if (kPrefixAssets?.has(processedSymbol)) {
+        processedSymbol = processedSymbol.substring(1);
+    }
+    // Regular asset
+    return `${hyperLiquidConfig_1.HYPERLIQUID_ASSET_ICONS_BASE_URL}${processedSymbol}.svg`;
+};
+exports.getAssetIconUrl = getAssetIconUrl;
+/**
+ * Generate icon URLs for an asset symbol with fallback support
+ *
+ * Resolution order:
+ * 1. Primary: MetaMask contract-metadata repo (manually curated)
+ * 2. Fallback: HyperLiquid CDN (always available)
+ *
+ * @param symbol - Asset symbol (e.g., "BTC" or "xyz:TSLA")
+ * @param kPrefixAssets - Optional set of assets that have a 'k' prefix to remove
+ * @returns Object with primary and fallback URLs, or null if no symbol
+ *
+ * @example Regular asset
+ * getAssetIconUrls('BTC')
+ * // → { primary: 'https://raw.githubusercontent.com/.../BTC.svg',
+ * //     fallback: 'https://app.hyperliquid.xyz/coins/BTC.svg' }
+ *
+ * @example HIP-3 asset
+ * getAssetIconUrls('xyz:TSLA')
+ * // → { primary: 'https://raw.githubusercontent.com/.../hip3:xyz_TSLA.svg',
+ * //     fallback: 'https://app.hyperliquid.xyz/coins/xyz:TSLA.svg' }
+ */
+const getAssetIconUrls = (symbol, kPrefixAssets) => {
+    if (!symbol) {
+        return null;
+    }
+    // Check for HIP-3 asset (contains colon) BEFORE uppercasing
+    if (symbol.includes(':')) {
+        const [dex, assetSymbol] = symbol.split(':');
+        // HyperLiquid uses dex:SYMBOL format
+        const hyperliquidFormat = `${dex.toLowerCase()}:${assetSymbol.toUpperCase()}`;
+        // MetaMask contract-metadata uses hip3:dex_SYMBOL format
+        const metamaskFormat = `hip3:${dex.toLowerCase()}_${assetSymbol.toUpperCase()}`;
+        return {
+            primary: `${hyperLiquidConfig_1.METAMASK_PERPS_ICONS_BASE_URL}${metamaskFormat}.svg`,
+            fallback: `${hyperLiquidConfig_1.HYPERLIQUID_ASSET_ICONS_BASE_URL}${hyperliquidFormat}.svg`,
+        };
+    }
+    // For regular assets, uppercase the entire symbol
+    let processedSymbol = symbol.toUpperCase();
+    // Remove 'k' prefix only for specific assets if provided
+    if (kPrefixAssets?.has(processedSymbol)) {
+        processedSymbol = processedSymbol.substring(1);
+    }
+    return {
+        primary: `${hyperLiquidConfig_1.METAMASK_PERPS_ICONS_BASE_URL}${processedSymbol}.svg`,
+        fallback: `${hyperLiquidConfig_1.HYPERLIQUID_ASSET_ICONS_BASE_URL}${processedSymbol}.svg`,
+    };
+};
+exports.getAssetIconUrls = getAssetIconUrls;
+//# sourceMappingURL=marketUtils.cjs.map

package/dist/utils/marketUtils.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"marketUtils.cjs","sourceRoot":"","sources":["../../src/utils/marketUtils.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  HYPERLIQUID_ASSET_ICONS_BASE_URL,\n  METAMASK_PERPS_ICONS_BASE_URL,\n} from '../constants/hyperLiquidConfig';\nimport type {\n  BadgeType,\n  CandleData,\n  CandleStick,\n  PerpsMarketData,\n} from '../types';\n\n/**\n * Maximum length for market filter patterns (prevents DoS attacks)\n */\nconst MAX_MARKET_PATTERN_LENGTH = 100;\n\n/**\n * Pattern matcher type - either string (exact match) or RegExp (wildcard)\n */\nexport type MarketPatternMatcher = RegExp | string;\n\n/**\n * Pre-compiled pattern with original pattern string and matcher\n */\nexport type CompiledMarketPattern = {\n  pattern: string;\n  matcher: MarketPatternMatcher;\n};\n\n/**\n * Escape special regex characters in a string\n *\n * @param str - String to escape\n * @returns Escaped string safe for regex\n */\nexport const escapeRegex = (str: string): string =>\n  str.replace(/[.*+?^${}()|[\\]\\\\]/gu, '\\\\$&');\n\n/**\n * Validate market filter pattern for safety\n * Prevents regex DoS attacks from malicious patterns\n *\n * @param pattern - Pattern to validate\n * @returns true if pattern is safe\n * @throws Error if pattern is unsafe\n *\n * @example Valid patterns\n * validateMarketPattern(\"BTC\") // → true\n * validateMarketPattern(\"xyz:TSLA\") // → true\n * validateMarketPattern(\"xyz:*\") // → true\n *\n * @example Invalid patterns\n * validateMarketPattern(\"\") // → throws Error\n * validateMarketPattern(\"xyz:.*\") // → throws Error (regex chars)\n * validateMarketPattern(\"BTC#SCAM\") // → throws Error (invalid char)\n */\nexport const validateMarketPattern = (pattern: string): boolean => {\n  // Reject empty patterns\n  if (!pattern || pattern.trim().length === 0) {\n    throw new Error('Market pattern cannot be empty');\n  }\n\n  // Trim whitespace and normalize the pattern\n  const normalizedPattern = pattern.trim();\n\n  // Reject patterns that are too long (potential DoS)\n  if (normalizedPattern.length > MAX_MARKET_PATTERN_LENGTH) {\n    throw new Error(\n      `Market pattern exceeds maximum length (${MAX_MARKET_PATTERN_LENGTH} chars): ${normalizedPattern}`,\n    );\n  }\n\n  // Reject patterns with suspicious regex control characters\n  // Allow only colon and asterisk for our pattern syntax\n  const dangerousChars = /[\\\\()[\\]{}^$+?.|]/u;\n  if (dangerousChars.test(normalizedPattern)) {\n    throw new Error(\n      `Market pattern contains invalid regex characters: ${normalizedPattern}`,\n    );\n  }\n\n  // Allow only: alphanumeric, colon, hyphen, underscore, asterisk\n  const validPattern = /^[a-zA-Z0-9:_\\-*]+$/u;\n  if (!validPattern.test(normalizedPattern)) {\n    throw new Error(\n      `Market pattern contains invalid characters: ${normalizedPattern}`,\n    );\n  }\n\n  return true;\n};\n\n/**\n * Compile market filter pattern into optimized matcher\n * Supports wildcards (\"xyz:*\"), DEX shorthand (\"xyz\"), and exact matches (\"xyz:TSLA\")\n *\n * Note: Main DEX markets (no prefix) don't need filtering - they're always included.\n * Patterns without colons are treated as HIP-3 DEX shorthand.\n *\n * @param pattern - Pattern string (e.g., \"xyz:*\", \"xyz:TSLA\", \"xyz\")\n * @returns Compiled matcher (RegExp for wildcards/shorthand, string for exact match)\n *\n * @example Wildcard - matches all markets from a DEX\n * compileMarketPattern(\"xyz:*\") // → /^xyz:/\n *\n * @example DEX shorthand - equivalent to wildcard\n * compileMarketPattern(\"xyz\") // → /^xyz:/ (matches all xyz markets)\n *\n * @example Exact match - matches specific market\n * compileMarketPattern(\"xyz:TSLA\") // → \"xyz:TSLA\"\n */\nexport const compileMarketPattern = (pattern: string): MarketPatternMatcher => {\n  // Trim and validate pattern before compilation to prevent regex DoS\n  const normalizedPattern = pattern.trim();\n  validateMarketPattern(normalizedPattern);\n\n  if (normalizedPattern.endsWith(':*')) {\n    // Wildcard: \"xyz:*\" → regex /^xyz:/\n    const prefix = normalizedPattern.slice(0, -2);\n    return new RegExp(`^${escapeRegex(prefix)}:`, 'u');\n  }\n\n  if (!normalizedPattern.includes(':')) {\n    // DEX shorthand: \"xyz\" → regex /^xyz:/\n    return new RegExp(`^${escapeRegex(normalizedPattern)}:`, 'u');\n  }\n\n  // Exact match: just use string (fastest)\n  return normalizedPattern;\n};\n\n/**\n * Check if a symbol matches a compiled pattern matcher\n *\n * @param symbol - Market symbol (e.g., \"BTC\", \"xyz:TSLA\")\n * @param matcher - Compiled matcher (string or RegExp)\n * @returns true if symbol matches the pattern\n */\nexport const matchesMarketPattern = (\n  symbol: string,\n  matcher: MarketPatternMatcher,\n): boolean => {\n  if (typeof matcher === 'string') {\n    // Exact match - fastest\n    return symbol === matcher;\n  }\n\n  // RegExp match - still very fast\n  return matcher.test(symbol);\n};\n\n/**\n * Check if a market should be included based on HIP-3 master switch and whitelist/blacklist patterns\n * Main DEX markets (null dex) are ALWAYS included (no filtering)\n *\n * Logic: Check master switch → apply whitelist (if non-empty) → apply blacklist\n *\n * @param symbol - Market symbol (e.g., \"BTC\", \"xyz:TSLA\")\n * @param dex - DEX identifier (null for main DEX, \"xyz\" for HIP-3 DEX)\n * @param hip3Enabled - Master switch for HIP-3 markets (false = block all HIP-3)\n * @param compiledEnabledPatterns - Pre-compiled whitelist patterns (empty = allow all)\n * @param compiledBlockedPatterns - Pre-compiled blacklist patterns (empty = block none)\n * @returns true if market should be shown to users\n *\n * @example Main DEX market (always included)\n * shouldIncludeMarket(\"BTC\", null, true, [...], [...]) // → true\n *\n * @example HIP-3 when master switch is OFF\n * shouldIncludeMarket(\"xyz:TSLA\", \"xyz\", false, [...], [...]) // → false (HIP-3 disabled)\n *\n * @example HIP-3 with empty whitelist (discovery mode)\n * shouldIncludeMarket(\"xyz:TSLA\", \"xyz\", true, [], []) // → true (allow all)\n *\n * @example HIP-3 with whitelist\n * shouldIncludeMarket(\"xyz:TSLA\", \"xyz\", true,\n *   [{pattern: \"xyz:*\", matcher: /^xyz:/}], []) // → true (matches whitelist)\n *\n * @example HIP-3 with blacklist\n * shouldIncludeMarket(\"xyz:SCAM\", \"xyz\", true, [],\n *   [{pattern: \"xyz:SCAM\", matcher: \"xyz:SCAM\"}]) // → false (blocked)\n */\nexport const shouldIncludeMarket = (\n  symbol: string,\n  dex: string | null,\n  hip3Enabled: boolean,\n  compiledEnabledPatterns: CompiledMarketPattern[],\n  compiledBlockedPatterns: CompiledMarketPattern[],\n): boolean => {\n  // ALWAYS include main DEX markets (no filtering)\n  if (dex === null) {\n    return true;\n  }\n\n  // Enforce HIP-3 master switch: if disabled, block ALL HIP-3 markets\n  if (!hip3Enabled) {\n    return false;\n  }\n\n  // Step 1: Apply whitelist only if non-empty\n  if (compiledEnabledPatterns.length > 0) {\n    const whitelisted = compiledEnabledPatterns.some(({ matcher }) =>\n      matchesMarketPattern(symbol, matcher),\n    );\n    if (!whitelisted) {\n      return false;\n    }\n  }\n\n  // Step 2: Apply blacklist ONLY if non-empty (early return optimization)\n  if (compiledBlockedPatterns.length === 0) {\n    return true; // No blacklist to check - accept immediately\n  }\n\n  // Only reach here if blacklist has values\n  const blacklisted = compiledBlockedPatterns.some(({ matcher }) =>\n    matchesMarketPattern(symbol, matcher),\n  );\n\n  return !blacklisted;\n};\n\n/**\n * Extract the display symbol from a full symbol string\n * Strips DEX prefix for HIP-3 markets (e.g., \"xyz:XYZ100\" -> \"XYZ100\")\n * Returns the symbol unchanged if no DEX prefix is present\n *\n * @param symbol - Full symbol (e.g., \"BTC\" or \"xyz:XYZ100\")\n * @returns Display symbol without DEX prefix (e.g., \"BTC\" or \"XYZ100\")\n */\nexport const getPerpsDisplaySymbol = (symbol: string): string => {\n  if (!symbol || typeof symbol !== 'string') {\n    return symbol;\n  }\n\n  // Check for DEX prefix pattern (dex:symbol)\n  const colonIndex = symbol.indexOf(':');\n  if (colonIndex > 0 && colonIndex < symbol.length - 1) {\n    // Return everything after the colon\n    return symbol.substring(colonIndex + 1);\n  }\n\n  // No DEX prefix found, return original symbol\n  return symbol;\n};\n\n/**\n * Extract the DEX identifier from a full symbol string\n * Returns the DEX prefix for HIP-3 markets (e.g., \"xyz:XYZ100\" -> \"xyz\")\n * Returns null if no DEX prefix is present (main DEX market)\n *\n * @param symbol - Full symbol (e.g., \"BTC\" or \"xyz:XYZ100\")\n * @returns DEX identifier or null if main DEX (e.g., \"xyz\" or null)\n */\nexport const getPerpsDexFromSymbol = (symbol: string): string | null => {\n  if (!symbol || typeof symbol !== 'string') {\n    return null;\n  }\n\n  // Check for DEX prefix pattern (dex:symbol)\n  const colonIndex = symbol.indexOf(':');\n  if (colonIndex > 0 && colonIndex < symbol.length - 1) {\n    // Return the DEX prefix (everything before the colon)\n    return symbol.substring(0, colonIndex);\n  }\n\n  // No DEX prefix found, this is a main DEX market\n  return null;\n};\n\ntype FundingCountdownParams = {\n  /**\n   * Next funding time in milliseconds since epoch (optional, market-specific)\n   */\n  nextFundingTime?: number;\n  /**\n   * Funding interval in hours (optional, market-specific)\n   * Default is 1 hour for HyperLiquid (funding is paid every hour)\n   */\n  fundingIntervalHours?: number;\n};\n\n/**\n * Calculate the time until the next funding period.\n * Supports market-specific funding times when provided.\n * Falls back to default HyperLiquid 1-hour periods (funding paid every hour).\n *\n * @param params - Optional funding countdown parameters\n * @returns Formatted countdown string in HH:MM:SS format\n */\nexport const calculateFundingCountdown = (\n  params?: FundingCountdownParams,\n): string => {\n  const now = new Date();\n  const nowMs = now.getTime();\n\n  // If we have a specific next funding time, check if it's reasonable for HyperLiquid's hourly funding\n  if (params?.nextFundingTime && params.nextFundingTime > nowMs) {\n    const msUntilFunding = params.nextFundingTime - nowMs;\n    const hoursUntilFunding = msUntilFunding / (1000 * 60 * 60);\n\n    // If API shows >1.1 hours, it's likely incorrect for HyperLiquid's hourly funding\n    // Use fallback calculation instead to show time until next hour\n    if (hoursUntilFunding <= 1.1) {\n      const totalSeconds = Math.floor(msUntilFunding / 1000);\n\n      const hours = Math.floor(totalSeconds / 3600);\n      const minutes = Math.floor((totalSeconds % 3600) / 60);\n      const seconds = totalSeconds % 60;\n\n      // Format as HH:MM:SS\n      const formattedHours = String(hours).padStart(2, '0');\n      const formattedMinutes = String(minutes).padStart(2, '0');\n      const formattedSeconds = String(seconds).padStart(2, '0');\n\n      return `${formattedHours}:${formattedMinutes}:${formattedSeconds}`;\n    }\n    // If >1.1 hours, fall through to use hourly calculation instead\n  }\n\n  // Fall back to default calculation for HyperLiquid (1-hour periods)\n  // HyperLiquid pays funding every hour, so next funding is at the next hour\n  const utcMinutes = now.getUTCMinutes();\n  const utcSeconds = now.getUTCSeconds();\n\n  // Calculate time remaining until next hour (next funding time)\n  const minutesUntilNextHour = 59 - utcMinutes;\n  const secondsUntilNextHour = 60 - utcSeconds;\n\n  // Handle edge case where seconds equals 60\n  const finalSeconds = secondsUntilNextHour === 60 ? 0 : secondsUntilNextHour;\n  const finalMinutes =\n    secondsUntilNextHour === 60\n      ? minutesUntilNextHour + 1\n      : minutesUntilNextHour;\n\n  // For HyperLiquid 1-hour funding, hours should always be 0\n  // (countdown should never exceed 59:59 since funding happens every hour)\n  const finalHours = finalMinutes === 60 ? 1 : 0;\n  const adjustedMinutes = finalMinutes === 60 ? 0 : finalMinutes;\n\n  // Format as HH:MM:SS\n  const formattedHours = String(finalHours).padStart(2, '0');\n  const formattedMinutes = String(adjustedMinutes).padStart(2, '0');\n  const formattedSeconds = String(finalSeconds).padStart(2, '0');\n\n  return `${formattedHours}:${formattedMinutes}:${formattedSeconds}`;\n};\n\n/**\n * Calculate 24h high and low from candlestick data.\n *\n * @param candleData - Candlestick data containing price candles\n * @returns Object with high and low prices for the last 24 hours\n */\nexport const calculate24hHighLow = (\n  candleData: CandleData | null,\n): { high: number; low: number } => {\n  if (!candleData?.candles || candleData.candles.length === 0) {\n    return { high: 0, low: 0 };\n  }\n\n  // Get candles from last 24 hours\n  const now = Date.now();\n  const twentyFourHoursAgo = now - 24 * 60 * 60 * 1000;\n\n  let last24hCandles = candleData.candles.filter(\n    (candle: CandleStick) => candle.time >= twentyFourHoursAgo,\n  );\n\n  if (last24hCandles.length === 0) {\n    // If no 24h data, use all available candles\n    last24hCandles = [...candleData.candles];\n  }\n\n  const highs = last24hCandles.map((candle: CandleStick) =>\n    parseFloat(candle.high),\n  );\n  const lows = last24hCandles.map((candle: CandleStick) =>\n    parseFloat(candle.low),\n  );\n\n  return {\n    high: Math.max(...highs),\n    low: Math.min(...lows),\n  };\n};\n\n/**\n * Determine badge type for a market based on its metadata\n * Prioritizes explicit marketType over generic experimental badge\n *\n * @param market - Market data object (only needs marketType and marketSource fields)\n * @returns Badge type to display, or undefined for no badge (main DEX)\n *\n * @example Main DEX\n * getMarketBadgeType({ symbol: 'BTC', marketSource: null }) // → undefined\n *\n * @example Mapped HIP-3 DEX\n * getMarketBadgeType({ symbol: 'xyz:XYZ100', marketSource: 'xyz', marketType: 'equity' }) // → 'equity'\n *\n * @example Unmapped HIP-3 DEX\n * getMarketBadgeType({ symbol: 'abc:ABC100', marketSource: 'abc' }) // → 'experimental'\n */\nexport const getMarketBadgeType = (\n  market: Pick<PerpsMarketData, 'marketType' | 'marketSource'>,\n): BadgeType | undefined =>\n  // Prioritize explicit marketType (e.g., 'equity' for xyz DEX)\n  // Fall back to 'experimental' for unmapped HIP-3 DEXs\n  // Main DEX markets without marketType show no badge\n  market.marketType ?? (market.marketSource ? 'experimental' : undefined);\n\n/**\n * Filter markets by search query\n * Searches through both symbol and name fields (case-insensitive)\n *\n * @param markets - Array of markets to filter\n * @param searchQuery - Search query string\n * @returns Filtered array of markets matching the query\n *\n * @example\n * filterMarketsByQuery([{ symbol: 'BTC', name: 'Bitcoin' }], 'btc') // → [{ symbol: 'BTC', name: 'Bitcoin' }]\n * filterMarketsByQuery([{ symbol: 'BTC', name: 'Bitcoin' }], 'coin') // → [{ symbol: 'BTC', name: 'Bitcoin' }]\n * filterMarketsByQuery([{ symbol: 'BTC', name: 'Bitcoin' }], '') // → [{ symbol: 'BTC', name: 'Bitcoin' }]\n */\nexport const filterMarketsByQuery = (\n  markets: PerpsMarketData[],\n  searchQuery: string,\n): PerpsMarketData[] => {\n  // Return all markets if query is empty\n  if (!searchQuery?.trim()) {\n    return markets;\n  }\n\n  const lowerQuery = searchQuery.toLowerCase().trim();\n\n  return markets.filter(\n    (market) =>\n      market.symbol?.toLowerCase().includes(lowerQuery) ||\n      market.name?.toLowerCase().includes(lowerQuery),\n  );\n};\n\n/**\n * Generate the appropriate icon URL for an asset symbol\n * Handles both regular assets and HIP-3 assets (dex:symbol format)\n *\n * @param symbol - Asset symbol (e.g., \"BTC\" or \"xyz:TSLA\")\n * @param kPrefixAssets - Optional set of assets that have a 'k' prefix to remove\n * @returns Icon URL for the asset\n *\n * @example Regular asset\n * getAssetIconUrl('BTC') // → 'https://app.hyperliquid.xyz/coins/BTC.svg'\n *\n * @example HIP-3 asset\n * getAssetIconUrl('xyz:TSLA') // → 'https://raw.githubusercontent.com/.../hip3%3Axyz_TSLA.svg'\n *\n * @example With k-prefix handling\n * getAssetIconUrl('kBONK', new Set(['KBONK'])) // → 'https://app.hyperliquid.xyz/coins/BONK.svg'\n */\nexport const getAssetIconUrl = (\n  symbol: string,\n  kPrefixAssets?: Set<string>,\n): string => {\n  if (!symbol) {\n    return '';\n  }\n\n  // Check for HIP-3 asset (contains colon) BEFORE uppercasing\n  if (symbol.includes(':')) {\n    const [dex, assetSymbol] = symbol.split(':');\n    return `${HYPERLIQUID_ASSET_ICONS_BASE_URL}${dex.toLowerCase()}:${assetSymbol.toUpperCase()}.svg`;\n  }\n\n  // For regular assets, uppercase the entire symbol\n  let processedSymbol = symbol.toUpperCase();\n\n  // Remove 'k' prefix only for specific assets if provided\n  if (kPrefixAssets?.has(processedSymbol)) {\n    processedSymbol = processedSymbol.substring(1);\n  }\n\n  // Regular asset\n  return `${HYPERLIQUID_ASSET_ICONS_BASE_URL}${processedSymbol}.svg`;\n};\n\n/**\n * Icon URLs with primary (MetaMask-hosted) and fallback (HyperLiquid) sources\n */\nexport type AssetIconUrls = {\n  /** MetaMask contract-metadata repo (preferred source) */\n  primary: string;\n  /** HyperLiquid CDN (fallback source) */\n  fallback: string;\n};\n\n/**\n * Generate icon URLs for an asset symbol with fallback support\n *\n * Resolution order:\n * 1. Primary: MetaMask contract-metadata repo (manually curated)\n * 2. Fallback: HyperLiquid CDN (always available)\n *\n * @param symbol - Asset symbol (e.g., \"BTC\" or \"xyz:TSLA\")\n * @param kPrefixAssets - Optional set of assets that have a 'k' prefix to remove\n * @returns Object with primary and fallback URLs, or null if no symbol\n *\n * @example Regular asset\n * getAssetIconUrls('BTC')\n * // → { primary: 'https://raw.githubusercontent.com/.../BTC.svg',\n * //     fallback: 'https://app.hyperliquid.xyz/coins/BTC.svg' }\n *\n * @example HIP-3 asset\n * getAssetIconUrls('xyz:TSLA')\n * // → { primary: 'https://raw.githubusercontent.com/.../hip3:xyz_TSLA.svg',\n * //     fallback: 'https://app.hyperliquid.xyz/coins/xyz:TSLA.svg' }\n */\nexport const getAssetIconUrls = (\n  symbol: string,\n  kPrefixAssets?: Set<string>,\n): AssetIconUrls | null => {\n  if (!symbol) {\n    return null;\n  }\n\n  // Check for HIP-3 asset (contains colon) BEFORE uppercasing\n  if (symbol.includes(':')) {\n    const [dex, assetSymbol] = symbol.split(':');\n    // HyperLiquid uses dex:SYMBOL format\n    const hyperliquidFormat = `${dex.toLowerCase()}:${assetSymbol.toUpperCase()}`;\n    // MetaMask contract-metadata uses hip3:dex_SYMBOL format\n    const metamaskFormat = `hip3:${dex.toLowerCase()}_${assetSymbol.toUpperCase()}`;\n    return {\n      primary: `${METAMASK_PERPS_ICONS_BASE_URL}${metamaskFormat}.svg`,\n      fallback: `${HYPERLIQUID_ASSET_ICONS_BASE_URL}${hyperliquidFormat}.svg`,\n    };\n  }\n\n  // For regular assets, uppercase the entire symbol\n  let processedSymbol = symbol.toUpperCase();\n\n  // Remove 'k' prefix only for specific assets if provided\n  if (kPrefixAssets?.has(processedSymbol)) {\n    processedSymbol = processedSymbol.substring(1);\n  }\n\n  return {\n    primary: `${METAMASK_PERPS_ICONS_BASE_URL}${processedSymbol}.svg`,\n    fallback: `${HYPERLIQUID_ASSET_ICONS_BASE_URL}${processedSymbol}.svg`,\n  };\n};\n"]}