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

package/dist/utils/marketUtils.d.cts

@@ -0,0 +1,227 @@
+import type { BadgeType, CandleData, PerpsMarketData } from "../types/index.cjs";
+/**
+ * Pattern matcher type - either string (exact match) or RegExp (wildcard)
+ */
+export type MarketPatternMatcher = RegExp | string;
+/**
+ * Pre-compiled pattern with original pattern string and matcher
+ */
+export type CompiledMarketPattern = {
+    pattern: string;
+    matcher: MarketPatternMatcher;
+};
+/**
+ * Escape special regex characters in a string
+ *
+ * @param str - String to escape
+ * @returns Escaped string safe for regex
+ */
+export declare const escapeRegex: (str: string) => string;
+/**
+ * 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 declare const validateMarketPattern: (pattern: string) => boolean;
+/**
+ * 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 declare const compileMarketPattern: (pattern: string) => MarketPatternMatcher;
+/**
+ * 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 declare const matchesMarketPattern: (symbol: string, matcher: MarketPatternMatcher) => boolean;
+/**
+ * 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 declare const shouldIncludeMarket: (symbol: string, dex: string | null, hip3Enabled: boolean, compiledEnabledPatterns: CompiledMarketPattern[], compiledBlockedPatterns: CompiledMarketPattern[]) => boolean;
+/**
+ * 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 declare const getPerpsDisplaySymbol: (symbol: string) => string;
+/**
+ * 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 declare const getPerpsDexFromSymbol: (symbol: string) => string | null;
+type FundingCountdownParams = {
+    /**
+     * Next funding time in milliseconds since epoch (optional, market-specific)
+     */
+    nextFundingTime?: number;
+    /**
+     * Funding interval in hours (optional, market-specific)
+     * Default is 1 hour for HyperLiquid (funding is paid every hour)
+     */
+    fundingIntervalHours?: number;
+};
+/**
+ * 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 declare const calculateFundingCountdown: (params?: FundingCountdownParams) => string;
+/**
+ * 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 declare const calculate24hHighLow: (candleData: CandleData | null) => {
+    high: number;
+    low: number;
+};
+/**
+ * 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 declare const getMarketBadgeType: (market: Pick<PerpsMarketData, 'marketType' | 'marketSource'>) => BadgeType | 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 declare const filterMarketsByQuery: (markets: PerpsMarketData[], searchQuery: string) => PerpsMarketData[];
+/**
+ * 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 declare const getAssetIconUrl: (symbol: string, kPrefixAssets?: Set<string>) => string;
+/**
+ * Icon URLs with primary (MetaMask-hosted) and fallback (HyperLiquid) sources
+ */
+export type AssetIconUrls = {
+    /** MetaMask contract-metadata repo (preferred source) */
+    primary: string;
+    /** HyperLiquid CDN (fallback source) */
+    fallback: string;
+};
+/**
+ * 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 declare const getAssetIconUrls: (symbol: string, kPrefixAssets?: Set<string>) => AssetIconUrls | null;
+export {};
+//# sourceMappingURL=marketUtils.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"marketUtils.d.cts","sourceRoot":"","sources":["../../src/utils/marketUtils.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,SAAS,EACT,UAAU,EAEV,eAAe,EAChB,2BAAiB;AAOlB;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,MAAM,CAAC;AAEnD;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,oBAAoB,CAAC;CAC/B,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,WAAW,QAAS,MAAM,KAAG,MACG,CAAC;AAE9C;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,qBAAqB,YAAa,MAAM,KAAG,OAkCvD,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,oBAAoB,YAAa,MAAM,KAAG,oBAkBtD,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,WACvB,MAAM,WACL,oBAAoB,KAC5B,OAQF,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,eAAO,MAAM,mBAAmB,WACtB,MAAM,OACT,MAAM,GAAG,IAAI,eACL,OAAO,2BACK,qBAAqB,EAAE,2BACvB,qBAAqB,EAAE,KAC/C,OAgCF,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,WAAY,MAAM,KAAG,MActD,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,WAAY,MAAM,KAAG,MAAM,GAAG,IAc/D,CAAC;AAEF,KAAK,sBAAsB,GAAG;IAC5B;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,yBAAyB,YAC3B,sBAAsB,KAC9B,MAuDF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,eAClB,UAAU,GAAG,IAAI,KAC5B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CA6B7B,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,kBAAkB,WACrB,KAAK,eAAe,EAAE,YAAY,GAAG,cAAc,CAAC,KAC3D,SAAS,GAAG,SAI0D,CAAC;AAE1E;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,oBAAoB,YACtB,eAAe,EAAE,eACb,MAAM,KAClB,eAAe,EAajB,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,eAAe,WAClB,MAAM,kBACE,IAAI,MAAM,CAAC,KAC1B,MAqBF,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,yDAAyD;IACzD,OAAO,EAAE,MAAM,CAAC;IAChB,wCAAwC;IACxC,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,gBAAgB,WACnB,MAAM,kBACE,IAAI,MAAM,CAAC,KAC1B,aAAa,GAAG,IA8BlB,CAAC"}

package/dist/utils/marketUtils.d.mts

@@ -0,0 +1,227 @@
+import type { BadgeType, CandleData, PerpsMarketData } from "../types/index.mjs";
+/**
+ * Pattern matcher type - either string (exact match) or RegExp (wildcard)
+ */
+export type MarketPatternMatcher = RegExp | string;
+/**
+ * Pre-compiled pattern with original pattern string and matcher
+ */
+export type CompiledMarketPattern = {
+    pattern: string;
+    matcher: MarketPatternMatcher;
+};
+/**
+ * Escape special regex characters in a string
+ *
+ * @param str - String to escape
+ * @returns Escaped string safe for regex
+ */
+export declare const escapeRegex: (str: string) => string;
+/**
+ * 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 declare const validateMarketPattern: (pattern: string) => boolean;
+/**
+ * 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 declare const compileMarketPattern: (pattern: string) => MarketPatternMatcher;
+/**
+ * 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 declare const matchesMarketPattern: (symbol: string, matcher: MarketPatternMatcher) => boolean;
+/**
+ * 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 declare const shouldIncludeMarket: (symbol: string, dex: string | null, hip3Enabled: boolean, compiledEnabledPatterns: CompiledMarketPattern[], compiledBlockedPatterns: CompiledMarketPattern[]) => boolean;
+/**
+ * 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 declare const getPerpsDisplaySymbol: (symbol: string) => string;
+/**
+ * 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 declare const getPerpsDexFromSymbol: (symbol: string) => string | null;
+type FundingCountdownParams = {
+    /**
+     * Next funding time in milliseconds since epoch (optional, market-specific)
+     */
+    nextFundingTime?: number;
+    /**
+     * Funding interval in hours (optional, market-specific)
+     * Default is 1 hour for HyperLiquid (funding is paid every hour)
+     */
+    fundingIntervalHours?: number;
+};
+/**
+ * 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 declare const calculateFundingCountdown: (params?: FundingCountdownParams) => string;
+/**
+ * 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 declare const calculate24hHighLow: (candleData: CandleData | null) => {
+    high: number;
+    low: number;
+};
+/**
+ * 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 declare const getMarketBadgeType: (market: Pick<PerpsMarketData, 'marketType' | 'marketSource'>) => BadgeType | 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 declare const filterMarketsByQuery: (markets: PerpsMarketData[], searchQuery: string) => PerpsMarketData[];
+/**
+ * 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 declare const getAssetIconUrl: (symbol: string, kPrefixAssets?: Set<string>) => string;
+/**
+ * Icon URLs with primary (MetaMask-hosted) and fallback (HyperLiquid) sources
+ */
+export type AssetIconUrls = {
+    /** MetaMask contract-metadata repo (preferred source) */
+    primary: string;
+    /** HyperLiquid CDN (fallback source) */
+    fallback: string;
+};
+/**
+ * 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 declare const getAssetIconUrls: (symbol: string, kPrefixAssets?: Set<string>) => AssetIconUrls | null;
+export {};
+//# sourceMappingURL=marketUtils.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"marketUtils.d.mts","sourceRoot":"","sources":["../../src/utils/marketUtils.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,SAAS,EACT,UAAU,EAEV,eAAe,EAChB,2BAAiB;AAOlB;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,MAAM,CAAC;AAEnD;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,oBAAoB,CAAC;CAC/B,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,WAAW,QAAS,MAAM,KAAG,MACG,CAAC;AAE9C;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,qBAAqB,YAAa,MAAM,KAAG,OAkCvD,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,oBAAoB,YAAa,MAAM,KAAG,oBAkBtD,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,WACvB,MAAM,WACL,oBAAoB,KAC5B,OAQF,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,eAAO,MAAM,mBAAmB,WACtB,MAAM,OACT,MAAM,GAAG,IAAI,eACL,OAAO,2BACK,qBAAqB,EAAE,2BACvB,qBAAqB,EAAE,KAC/C,OAgCF,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,WAAY,MAAM,KAAG,MActD,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,WAAY,MAAM,KAAG,MAAM,GAAG,IAc/D,CAAC;AAEF,KAAK,sBAAsB,GAAG;IAC5B;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,yBAAyB,YAC3B,sBAAsB,KAC9B,MAuDF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,eAClB,UAAU,GAAG,IAAI,KAC5B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CA6B7B,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,kBAAkB,WACrB,KAAK,eAAe,EAAE,YAAY,GAAG,cAAc,CAAC,KAC3D,SAAS,GAAG,SAI0D,CAAC;AAE1E;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,oBAAoB,YACtB,eAAe,EAAE,eACb,MAAM,KAClB,eAAe,EAajB,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,eAAe,WAClB,MAAM,kBACE,IAAI,MAAM,CAAC,KAC1B,MAqBF,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,yDAAyD;IACzD,OAAO,EAAE,MAAM,CAAC;IAChB,wCAAwC;IACxC,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,gBAAgB,WACnB,MAAM,kBACE,IAAI,MAAM,CAAC,KAC1B,aAAa,GAAG,IA8BlB,CAAC"}