@metamask-previews/perps-controller 0.0.0-preview-e4aa1532 → 0.0.0-preview-6dfa4aeba

package/dist/utils/marketUtils.mjs

@@ -1,404 +0,0 @@
-import { HYPERLIQUID_ASSET_ICONS_BASE_URL, METAMASK_PERPS_ICONS_BASE_URL } from "../constants/hyperLiquidConfig.mjs";
-/**
- * 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
- */
-export const escapeRegex = (str) => str.replace(/[.*+?^${}()|[\]\\]/gu, '\\$&');
-/**
- * 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)
- */
-export 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;
-};
-/**
- * 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"
- */
-export const compileMarketPattern = (pattern) => {
-    // Trim and validate pattern before compilation to prevent regex DoS
-    const normalizedPattern = pattern.trim();
-    validateMarketPattern(normalizedPattern);
-    if (normalizedPattern.endsWith(':*')) {
-        // Wildcard: "xyz:*" → regex /^xyz:/
-        const prefix = normalizedPattern.slice(0, -2);
-        return new RegExp(`^${escapeRegex(prefix)}:`, 'u');
-    }
-    if (!normalizedPattern.includes(':')) {
-        // DEX shorthand: "xyz" → regex /^xyz:/
-        return new RegExp(`^${escapeRegex(normalizedPattern)}:`, 'u');
-    }
-    // Exact match: just use string (fastest)
-    return normalizedPattern;
-};
-/**
- * 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
- */
-export const matchesMarketPattern = (symbol, matcher) => {
-    if (typeof matcher === 'string') {
-        // Exact match - fastest
-        return symbol === matcher;
-    }
-    // RegExp match - still very fast
-    return matcher.test(symbol);
-};
-/**
- * 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)
- */
-export 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 }) => 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 }) => matchesMarketPattern(symbol, matcher));
-    return !blacklisted;
-};
-/**
- * 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")
- */
-export 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;
-};
-/**
- * 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)
- */
-export 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;
-};
-/**
- * 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
- */
-export 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}`;
-};
-/**
- * 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
- */
-export 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),
-    };
-};
-/**
- * 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'
- */
-export 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);
-/**
- * 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' }]
- */
-export 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));
-};
-/**
- * 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'
- */
-export 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 `${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 `${HYPERLIQUID_ASSET_ICONS_BASE_URL}${processedSymbol}.svg`;
-};
-/**
- * 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' }
- */
-export 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: `${METAMASK_PERPS_ICONS_BASE_URL}${metamaskFormat}.svg`,
-            fallback: `${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: `${METAMASK_PERPS_ICONS_BASE_URL}${processedSymbol}.svg`,
-        fallback: `${HYPERLIQUID_ASSET_ICONS_BASE_URL}${processedSymbol}.svg`,
-    };
-};
-//# sourceMappingURL=marketUtils.mjs.map

package/dist/utils/marketUtils.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"marketUtils.mjs","sourceRoot":"","sources":["../../src/utils/marketUtils.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gCAAgC,EAChC,6BAA6B,EAC9B,2CAAuC;AAQxC;;GAEG;AACH,MAAM,yBAAyB,GAAG,GAAG,CAAC;AAetC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,GAAW,EAAU,EAAE,CACjD,GAAG,CAAC,OAAO,CAAC,sBAAsB,EAAE,MAAM,CAAC,CAAC;AAE9C;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,OAAe,EAAW,EAAE;IAChE,wBAAwB;IACxB,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACpD,CAAC;IAED,4CAA4C;IAC5C,MAAM,iBAAiB,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAEzC,oDAAoD;IACpD,IAAI,iBAAiB,CAAC,MAAM,GAAG,yBAAyB,EAAE,CAAC;QACzD,MAAM,IAAI,KAAK,CACb,0CAA0C,yBAAyB,YAAY,iBAAiB,EAAE,CACnG,CAAC;IACJ,CAAC;IAED,2DAA2D;IAC3D,uDAAuD;IACvD,MAAM,cAAc,GAAG,oBAAoB,CAAC;IAC5C,IAAI,cAAc,CAAC,IAAI,CAAC,iBAAiB,CAAC,EAAE,CAAC;QAC3C,MAAM,IAAI,KAAK,CACb,qDAAqD,iBAAiB,EAAE,CACzE,CAAC;IACJ,CAAC;IAED,gEAAgE;IAChE,MAAM,YAAY,GAAG,sBAAsB,CAAC;IAC5C,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,iBAAiB,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CACb,+CAA+C,iBAAiB,EAAE,CACnE,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,OAAe,EAAwB,EAAE;IAC5E,oEAAoE;IACpE,MAAM,iBAAiB,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IACzC,qBAAqB,CAAC,iBAAiB,CAAC,CAAC;IAEzC,IAAI,iBAAiB,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACrC,oCAAoC;QACpC,MAAM,MAAM,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC9C,OAAO,IAAI,MAAM,CAAC,IAAI,WAAW,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IACrD,CAAC;IAED,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACrC,uCAAuC;QACvC,OAAO,IAAI,MAAM,CAAC,IAAI,WAAW,CAAC,iBAAiB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAChE,CAAC;IAED,yCAAyC;IACzC,OAAO,iBAAiB,CAAC;AAC3B,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAClC,MAAc,EACd,OAA6B,EACpB,EAAE;IACX,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAChC,wBAAwB;QACxB,OAAO,MAAM,KAAK,OAAO,CAAC;IAC5B,CAAC;IAED,iCAAiC;IACjC,OAAO,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC9B,CAAC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,MAAc,EACd,GAAkB,EAClB,WAAoB,EACpB,uBAAgD,EAChD,uBAAgD,EACvC,EAAE;IACX,iDAAiD;IACjD,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QACjB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,oEAAoE;IACpE,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,4CAA4C;IAC5C,IAAI,uBAAuB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvC,MAAM,WAAW,GAAG,uBAAuB,CAAC,IAAI,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAC/D,oBAAoB,CAAC,MAAM,EAAE,OAAO,CAAC,CACtC,CAAC;QACF,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,wEAAwE;IACxE,IAAI,uBAAuB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzC,OAAO,IAAI,CAAC,CAAC,6CAA6C;IAC5D,CAAC;IAED,0CAA0C;IAC1C,MAAM,WAAW,GAAG,uBAAuB,CAAC,IAAI,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAC/D,oBAAoB,CAAC,MAAM,EAAE,OAAO,CAAC,CACtC,CAAC;IAEF,OAAO,CAAC,WAAW,CAAC;AACtB,CAAC,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,MAAc,EAAU,EAAE;IAC9D,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC1C,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,4CAA4C;IAC5C,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACvC,IAAI,UAAU,GAAG,CAAC,IAAI,UAAU,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrD,oCAAoC;QACpC,OAAO,MAAM,CAAC,SAAS,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC;IAC1C,CAAC;IAED,8CAA8C;IAC9C,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,MAAc,EAAiB,EAAE;IACrE,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC1C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,4CAA4C;IAC5C,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACvC,IAAI,UAAU,GAAG,CAAC,IAAI,UAAU,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrD,sDAAsD;QACtD,OAAO,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;IACzC,CAAC;IAED,iDAAiD;IACjD,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAcF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CACvC,MAA+B,EACvB,EAAE;IACV,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,EAAE,CAAC;IAE5B,qGAAqG;IACrG,IAAI,MAAM,EAAE,eAAe,IAAI,MAAM,CAAC,eAAe,GAAG,KAAK,EAAE,CAAC;QAC9D,MAAM,cAAc,GAAG,MAAM,CAAC,eAAe,GAAG,KAAK,CAAC;QACtD,MAAM,iBAAiB,GAAG,cAAc,GAAG,CAAC,IAAI,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;QAE5D,kFAAkF;QAClF,gEAAgE;QAChE,IAAI,iBAAiB,IAAI,GAAG,EAAE,CAAC;YAC7B,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;YAEvD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;YAC9C,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;YACvD,MAAM,OAAO,GAAG,YAAY,GAAG,EAAE,CAAC;YAElC,qBAAqB;YACrB,MAAM,cAAc,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;YACtD,MAAM,gBAAgB,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;YAC1D,MAAM,gBAAgB,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;YAE1D,OAAO,GAAG,cAAc,IAAI,gBAAgB,IAAI,gBAAgB,EAAE,CAAC;QACrE,CAAC;QACD,gEAAgE;IAClE,CAAC;IAED,oEAAoE;IACpE,2EAA2E;IAC3E,MAAM,UAAU,GAAG,GAAG,CAAC,aAAa,EAAE,CAAC;IACvC,MAAM,UAAU,GAAG,GAAG,CAAC,aAAa,EAAE,CAAC;IAEvC,+DAA+D;IAC/D,MAAM,oBAAoB,GAAG,EAAE,GAAG,UAAU,CAAC;IAC7C,MAAM,oBAAoB,GAAG,EAAE,GAAG,UAAU,CAAC;IAE7C,2CAA2C;IAC3C,MAAM,YAAY,GAAG,oBAAoB,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,oBAAoB,CAAC;IAC5E,MAAM,YAAY,GAChB,oBAAoB,KAAK,EAAE;QACzB,CAAC,CAAC,oBAAoB,GAAG,CAAC;QAC1B,CAAC,CAAC,oBAAoB,CAAC;IAE3B,2DAA2D;IAC3D,yEAAyE;IACzE,MAAM,UAAU,GAAG,YAAY,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/C,MAAM,eAAe,GAAG,YAAY,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC;IAE/D,qBAAqB;IACrB,MAAM,cAAc,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC3D,MAAM,gBAAgB,GAAG,MAAM,CAAC,eAAe,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAClE,MAAM,gBAAgB,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAE/D,OAAO,GAAG,cAAc,IAAI,gBAAgB,IAAI,gBAAgB,EAAE,CAAC;AACrE,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,UAA6B,EACE,EAAE;IACjC,IAAI,CAAC,UAAU,EAAE,OAAO,IAAI,UAAU,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5D,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;IAC7B,CAAC;IAED,iCAAiC;IACjC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,MAAM,kBAAkB,GAAG,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAErD,IAAI,cAAc,GAAG,UAAU,CAAC,OAAO,CAAC,MAAM,CAC5C,CAAC,MAAmB,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,IAAI,kBAAkB,CAC3D,CAAC;IAEF,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChC,4CAA4C;QAC5C,cAAc,GAAG,CAAC,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IAC3C,CAAC;IAED,MAAM,KAAK,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC,MAAmB,EAAE,EAAE,CACvD,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CACxB,CAAC;IACF,MAAM,IAAI,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC,MAAmB,EAAE,EAAE,CACtD,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,CACvB,CAAC;IAEF,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACxB,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;KACvB,CAAC;AACJ,CAAC,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAChC,MAA4D,EACrC,EAAE;AACzB,8DAA8D;AAC9D,sDAAsD;AACtD,oDAAoD;AACpD,MAAM,CAAC,UAAU,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;AAE1E;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAClC,OAA0B,EAC1B,WAAmB,EACA,EAAE;IACrB,uCAAuC;IACvC,IAAI,CAAC,WAAW,EAAE,IAAI,EAAE,EAAE,CAAC;QACzB,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,MAAM,UAAU,GAAG,WAAW,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;IAEpD,OAAO,OAAO,CAAC,MAAM,CACnB,CAAC,MAAM,EAAE,EAAE,CACT,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC;QACjD,MAAM,CAAC,IAAI,EAAE,WAAW,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,CAClD,CAAC;AACJ,CAAC,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,MAAc,EACd,aAA2B,EACnB,EAAE;IACV,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,4DAA4D;IAC5D,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACzB,MAAM,CAAC,GAAG,EAAE,WAAW,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC7C,OAAO,GAAG,gCAAgC,GAAG,GAAG,CAAC,WAAW,EAAE,IAAI,WAAW,CAAC,WAAW,EAAE,MAAM,CAAC;IACpG,CAAC;IAED,kDAAkD;IAClD,IAAI,eAAe,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;IAE3C,yDAAyD;IACzD,IAAI,aAAa,EAAE,GAAG,CAAC,eAAe,CAAC,EAAE,CAAC;QACxC,eAAe,GAAG,eAAe,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IACjD,CAAC;IAED,gBAAgB;IAChB,OAAO,GAAG,gCAAgC,GAAG,eAAe,MAAM,CAAC;AACrE,CAAC,CAAC;AAYF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAC9B,MAAc,EACd,aAA2B,EACL,EAAE;IACxB,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,IAAI,CAAC;IACd,CAAC;IAED,4DAA4D;IAC5D,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACzB,MAAM,CAAC,GAAG,EAAE,WAAW,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC7C,qCAAqC;QACrC,MAAM,iBAAiB,GAAG,GAAG,GAAG,CAAC,WAAW,EAAE,IAAI,WAAW,CAAC,WAAW,EAAE,EAAE,CAAC;QAC9E,yDAAyD;QACzD,MAAM,cAAc,GAAG,QAAQ,GAAG,CAAC,WAAW,EAAE,IAAI,WAAW,CAAC,WAAW,EAAE,EAAE,CAAC;QAChF,OAAO;YACL,OAAO,EAAE,GAAG,6BAA6B,GAAG,cAAc,MAAM;YAChE,QAAQ,EAAE,GAAG,gCAAgC,GAAG,iBAAiB,MAAM;SACxE,CAAC;IACJ,CAAC;IAED,kDAAkD;IAClD,IAAI,eAAe,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;IAE3C,yDAAyD;IACzD,IAAI,aAAa,EAAE,GAAG,CAAC,eAAe,CAAC,EAAE,CAAC;QACxC,eAAe,GAAG,eAAe,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IACjD,CAAC;IAED,OAAO;QACL,OAAO,EAAE,GAAG,6BAA6B,GAAG,eAAe,MAAM;QACjE,QAAQ,EAAE,GAAG,gCAAgC,GAAG,eAAe,MAAM;KACtE,CAAC;AACJ,CAAC,CAAC","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"]}

package/dist/utils/orderBookGrouping.cjs

@@ -1,151 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.aggregateOrderBookLevels = exports.selectDefaultGrouping = exports.formatGroupingLabel = exports.calculateGroupingOptions = exports.calculateAggregationParams = exports.MAX_ORDER_BOOK_LEVELS = void 0;
-/**
- * Maximum API levels to request from Hyperliquid L2Book API.
- * The API returns at most ~20 levels per side when using nSigFigs aggregation.
- */
-exports.MAX_ORDER_BOOK_LEVELS = 20;
-/**
- * Calculate nSigFigs and mantissa based on grouping and price.
- * These parameters match Hyperliquid's L2Book API aggregation:
- * - nSigFigs: 5, mantissa: 2 → finest granularity (~$1-2 for BTC)
- * - nSigFigs: 5, mantissa: 5 → ~$5 increments for BTC
- * - nSigFigs: 4 → ~$10 increments for BTC
- * - nSigFigs: 3 → ~$100 increments for BTC
- * - nSigFigs: 2 → ~$1000 increments for BTC (widest range)
- *
- * mantissa is only applicable when nSigFigs is 5.
- *
- * @param grouping - The price grouping increment
- * @param price - The current mid price
- * @returns Aggregation parameters for the API
- */
-function calculateAggregationParams(grouping, price) {
-    // Guard against invalid inputs that would cause Math.log10 to return -Infinity or NaN
-    if (price <= 0 || grouping <= 0) {
-        return { nSigFigs: 5 };
-    }
-    const magnitude = Math.floor(Math.log10(price));
-    const groupingMagnitude = Math.floor(Math.log10(grouping));
-    const baseNSigFigs = magnitude - groupingMagnitude + 1;
-    if (baseNSigFigs >= 5) {
-        // Finest granularity needs mantissa
-        // Derive mantissa from the first digit of grouping
-        const firstDigit = Math.floor(grouping / Math.pow(10, groupingMagnitude));
-        const mantissa = firstDigit <= 2 ? 2 : 5;
-        return { nSigFigs: 5, mantissa };
-    }
-    // Clamp nSigFigs between 2 and 5 (API only supports these values)
-    const clampedNSigFigs = Math.max(2, Math.min(5, baseNSigFigs));
-    return { nSigFigs: clampedNSigFigs };
-}
-exports.calculateAggregationParams = calculateAggregationParams;
-/**
- * Calculate dynamic grouping options based on asset's mid price.
- * Uses "1-2-5 per decade" scale anchored to price magnitude.
- *
- * @param midPrice - The current mid price of the asset
- * @returns Array of grouping options suitable for the price magnitude
- * @example
- * calculateGroupingOptions(87000) → [1, 2, 5, 10, 100, 1000]           // BTC
- * calculateGroupingOptions(33)    → [0.001, 0.002, 0.005, 0.01, 0.1, 1] // HYPE
- * calculateGroupingOptions(0.002) → [0.000001, 0.00001, 0.0001]        // PUMP
- */
-function calculateGroupingOptions(midPrice) {
-    if (midPrice <= 0) {
-        return [0.01, 0.1, 1]; // Fallback for invalid prices
-    }
-    const priceExponent = Math.floor(Math.log10(midPrice));
-    const base = Math.pow(10, priceExponent - 4);
-    const multipliers = [1, 2, 5, 10, 100, 1000];
-    return multipliers.map((multiplier) => base * multiplier);
-}
-exports.calculateGroupingOptions = calculateGroupingOptions;
-/**
- * Format grouping value for display (e.g., "0.001", "1", "100").
- *
- * @param value - The grouping value to format
- * @returns Formatted string representation
- */
-function formatGroupingLabel(value) {
-    if (value >= 1) {
-        return value.toString();
-    }
-    // Calculate decimal places needed
-    const decimals = Math.max(0, Math.ceil(-Math.log10(value)));
-    return value.toFixed(decimals);
-}
-exports.formatGroupingLabel = formatGroupingLabel;
-/**
- * Select a sensible default grouping option.
- * Picks a middle option that gives reasonable granularity.
- *
- * @param options - Array of available grouping options
- * @returns The recommended default grouping value
- */
-function selectDefaultGrouping(options) {
-    // Pick the 4th option (index 3) which is typically a good balance
-    // For BTC: 10, for HYPE: 0.01, etc.
-    return options[3] ?? options[Math.floor(options.length / 2)] ?? options[0];
-}
-exports.selectDefaultGrouping = selectDefaultGrouping;
-/**
- * Aggregate order book levels by price grouping.
- * Groups prices into buckets, sums sizes, and recalculates cumulative totals.
- *
- * @param levels - Raw order book levels from API
- * @param groupingSize - Price bucket size (e.g., 10 means group by $10 increments)
- * @param side - 'bid' rounds down to bucket, 'ask' rounds up to bucket
- * @returns Aggregated order book levels
- */
-function aggregateOrderBookLevels(levels, groupingSize, side) {
-    if (!levels.length || groupingSize <= 0) {
-        return levels;
-    }
-    // Group levels by price bucket
-    const buckets = new Map();
-    for (const level of levels) {
-        const price = parseFloat(level.price);
-        const size = parseFloat(level.size);
-        const notional = parseFloat(level.notional);
-        // Round price to bucket
-        // Bids: round down (floor) to include in lower bucket
-        // Asks: round up (ceil) to include in higher bucket
-        let bucketPrice;
-        if (side === 'bid') {
-            bucketPrice = Math.floor(price / groupingSize) * groupingSize;
-        }
-        else {
-            bucketPrice = Math.ceil(price / groupingSize) * groupingSize;
-        }
-        const existing = buckets.get(bucketPrice);
-        if (existing) {
-            existing.size += size;
-            existing.notional += notional;
-        }
-        else {
-            buckets.set(bucketPrice, { size, notional, price: bucketPrice });
-        }
-    }
-    // Convert buckets to array and sort
-    const sortedBuckets = Array.from(buckets.values()).sort((bucketA, bucketB) => side === 'bid'
-        ? bucketB.price - bucketA.price
-        : bucketA.price - bucketB.price);
-    // Calculate cumulative totals
-    let cumulativeSize = 0;
-    let cumulativeNotional = 0;
-    return sortedBuckets.map((bucket) => {
-        cumulativeSize += bucket.size;
-        cumulativeNotional += bucket.notional;
-        return {
-            price: bucket.price.toString(),
-            size: bucket.size.toString(),
-            total: cumulativeSize.toString(),
-            notional: bucket.notional.toFixed(2),
-            totalNotional: cumulativeNotional.toFixed(2),
-        };
-    });
-}
-exports.aggregateOrderBookLevels = aggregateOrderBookLevels;
-//# sourceMappingURL=orderBookGrouping.cjs.map

package/dist/utils/orderBookGrouping.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"orderBookGrouping.cjs","sourceRoot":"","sources":["../../src/utils/orderBookGrouping.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Order book level structure for grouping\n */\nexport type OrderBookLevel = {\n  price: string;\n  size: string;\n  total: string;\n  notional: string;\n  totalNotional: string;\n};\n\n/**\n * Maximum API levels to request from Hyperliquid L2Book API.\n * The API returns at most ~20 levels per side when using nSigFigs aggregation.\n */\nexport const MAX_ORDER_BOOK_LEVELS = 20;\n\n/**\n * Parameters for Hyperliquid L2Book API aggregation.\n */\nexport type AggregationParams = {\n  nSigFigs: 2 | 3 | 4 | 5;\n  mantissa?: 2 | 5;\n};\n\n/**\n * Calculate nSigFigs and mantissa based on grouping and price.\n * These parameters match Hyperliquid's L2Book API aggregation:\n * - nSigFigs: 5, mantissa: 2 → finest granularity (~$1-2 for BTC)\n * - nSigFigs: 5, mantissa: 5 → ~$5 increments for BTC\n * - nSigFigs: 4 → ~$10 increments for BTC\n * - nSigFigs: 3 → ~$100 increments for BTC\n * - nSigFigs: 2 → ~$1000 increments for BTC (widest range)\n *\n * mantissa is only applicable when nSigFigs is 5.\n *\n * @param grouping - The price grouping increment\n * @param price - The current mid price\n * @returns Aggregation parameters for the API\n */\nexport function calculateAggregationParams(\n  grouping: number,\n  price: number,\n): AggregationParams {\n  // Guard against invalid inputs that would cause Math.log10 to return -Infinity or NaN\n  if (price <= 0 || grouping <= 0) {\n    return { nSigFigs: 5 };\n  }\n\n  const magnitude = Math.floor(Math.log10(price));\n  const groupingMagnitude = Math.floor(Math.log10(grouping));\n  const baseNSigFigs = magnitude - groupingMagnitude + 1;\n\n  if (baseNSigFigs >= 5) {\n    // Finest granularity needs mantissa\n    // Derive mantissa from the first digit of grouping\n    const firstDigit = Math.floor(grouping / Math.pow(10, groupingMagnitude));\n    const mantissa = firstDigit <= 2 ? 2 : 5;\n    return { nSigFigs: 5, mantissa };\n  }\n\n  // Clamp nSigFigs between 2 and 5 (API only supports these values)\n  const clampedNSigFigs = Math.max(2, Math.min(5, baseNSigFigs)) as\n    | 2\n    | 3\n    | 4\n    | 5;\n  return { nSigFigs: clampedNSigFigs };\n}\n\n/**\n * Calculate dynamic grouping options based on asset's mid price.\n * Uses \"1-2-5 per decade\" scale anchored to price magnitude.\n *\n * @param midPrice - The current mid price of the asset\n * @returns Array of grouping options suitable for the price magnitude\n * @example\n * calculateGroupingOptions(87000) → [1, 2, 5, 10, 100, 1000]           // BTC\n * calculateGroupingOptions(33)    → [0.001, 0.002, 0.005, 0.01, 0.1, 1] // HYPE\n * calculateGroupingOptions(0.002) → [0.000001, 0.00001, 0.0001]        // PUMP\n */\nexport function calculateGroupingOptions(midPrice: number): number[] {\n  if (midPrice <= 0) {\n    return [0.01, 0.1, 1]; // Fallback for invalid prices\n  }\n\n  const priceExponent = Math.floor(Math.log10(midPrice));\n  const base = Math.pow(10, priceExponent - 4);\n  const multipliers = [1, 2, 5, 10, 100, 1000];\n\n  return multipliers.map((multiplier) => base * multiplier);\n}\n\n/**\n * Format grouping value for display (e.g., \"0.001\", \"1\", \"100\").\n *\n * @param value - The grouping value to format\n * @returns Formatted string representation\n */\nexport function formatGroupingLabel(value: number): string {\n  if (value >= 1) {\n    return value.toString();\n  }\n  // Calculate decimal places needed\n  const decimals = Math.max(0, Math.ceil(-Math.log10(value)));\n  return value.toFixed(decimals);\n}\n\n/**\n * Select a sensible default grouping option.\n * Picks a middle option that gives reasonable granularity.\n *\n * @param options - Array of available grouping options\n * @returns The recommended default grouping value\n */\nexport function selectDefaultGrouping(options: number[]): number {\n  // Pick the 4th option (index 3) which is typically a good balance\n  // For BTC: 10, for HYPE: 0.01, etc.\n  return options[3] ?? options[Math.floor(options.length / 2)] ?? options[0];\n}\n\n/**\n * Aggregate order book levels by price grouping.\n * Groups prices into buckets, sums sizes, and recalculates cumulative totals.\n *\n * @param levels - Raw order book levels from API\n * @param groupingSize - Price bucket size (e.g., 10 means group by $10 increments)\n * @param side - 'bid' rounds down to bucket, 'ask' rounds up to bucket\n * @returns Aggregated order book levels\n */\nexport function aggregateOrderBookLevels(\n  levels: OrderBookLevel[],\n  groupingSize: number,\n  side: 'bid' | 'ask',\n): OrderBookLevel[] {\n  if (!levels.length || groupingSize <= 0) {\n    return levels;\n  }\n\n  // Group levels by price bucket\n  const buckets = new Map<\n    number,\n    { size: number; notional: number; price: number }\n  >();\n\n  for (const level of levels) {\n    const price = parseFloat(level.price);\n    const size = parseFloat(level.size);\n    const notional = parseFloat(level.notional);\n\n    // Round price to bucket\n    // Bids: round down (floor) to include in lower bucket\n    // Asks: round up (ceil) to include in higher bucket\n    let bucketPrice: number;\n    if (side === 'bid') {\n      bucketPrice = Math.floor(price / groupingSize) * groupingSize;\n    } else {\n      bucketPrice = Math.ceil(price / groupingSize) * groupingSize;\n    }\n\n    const existing = buckets.get(bucketPrice);\n    if (existing) {\n      existing.size += size;\n      existing.notional += notional;\n    } else {\n      buckets.set(bucketPrice, { size, notional, price: bucketPrice });\n    }\n  }\n\n  // Convert buckets to array and sort\n  const sortedBuckets = Array.from(buckets.values()).sort((bucketA, bucketB) =>\n    side === 'bid'\n      ? bucketB.price - bucketA.price\n      : bucketA.price - bucketB.price,\n  );\n\n  // Calculate cumulative totals\n  let cumulativeSize = 0;\n  let cumulativeNotional = 0;\n\n  return sortedBuckets.map((bucket) => {\n    cumulativeSize += bucket.size;\n    cumulativeNotional += bucket.notional;\n\n    return {\n      price: bucket.price.toString(),\n      size: bucket.size.toString(),\n      total: cumulativeSize.toString(),\n      notional: bucket.notional.toFixed(2),\n      totalNotional: cumulativeNotional.toFixed(2),\n    };\n  });\n}\n"]}