@metamask-previews/perps-controller 3.2.0-preview-6ce5d58fa → 4.0.0-preview-1e2fe74a0

package/dist/constants/perpsConfig.cjs

@@ -118,6 +118,34 @@ exports.PERFORMANCE_CONFIG = {
     // Candle subscription debounce delay (milliseconds)
     // Prevents WS subscription churn during rapid market switching (#28141)
     CandleConnectDebounceMs: 500,
+    // Candle WS teardown delay (milliseconds)
+    // When the last subscriber for a cacheKey unsubscribes, wait this long before
+    // tearing down the WS. A subsequent subscribe inside the window cancels the
+    // teardown so rapid back-and-forth switches do not churn the connection.
+    CandleTeardownDelayMs: 150,
+    // Perps REST coalesce TTL (milliseconds)
+    //
+    // Window in which identical GET-style REST calls (getOrderFills, getOrders,
+    // getFunding, historicalOrders) share a single in-flight promise / cached
+    // result. `forceRefresh` still bypasses the cache end-to-end (hooks →
+    // controller → MarketDataService → provider → HyperLiquidClientService), so
+    // pull-to-refresh always hits the network.
+    //
+    // Why 60 s: HyperLiquid's documented rate limit is 1200 weight / IP /
+    // rolling 60 s window. Sizing TTL = window length caps each endpoint-per-
+    // account at ≤1 REST hit per window under any UI activity pattern — rapid
+    // market switching, re-mounts (usePerpsMarketFills, usePerpsTransactionHistory),
+    // and multi-tab scans all share a single request. Live fills/orders/prices
+    // still flow via WS subscriptions, so REST is seed/backfill only — cache
+    // staleness inside the 60 s window is never user-visible.
+    PerpsRestCoalesceTtlMs: 60000,
+    // Candle snapshot REST coalesce TTL (milliseconds).
+    // Longer than PerpsRestCoalesceTtlMs because WS stream keeps live candles
+    // fresh — the REST snapshot only seeds the chart on initial subscribe. A
+    // 30 s window lets rapid market switching (pass 1 → pass 2 of a stress
+    // loop) share the same snapshot per (symbol, interval), cutting
+    // candleSnapshot REST weight roughly in half.
+    PerpsCandleCoalesceTtlMs: 30000,
     // Navigation params delay (milliseconds)
     // Required for React Navigation to complete state transitions before setting params
     // This ensures navigation context is available when programmatically selecting tabs

package/dist/constants/perpsConfig.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"perpsConfig.cjs","sourceRoot":"","sources":["../../src/constants/perpsConfig.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Perps feature constants - Controller layer (portable)\n *\n * This file contains only controller-portable configuration:\n * - Constants used by controller logic, providers, and services\n * - Calculation thresholds, API configs, and protocol constants\n *\n * UI-only constants (layout, display, navigation) live in:\n * app/components/UI/Perps/constants/perpsConfig.ts\n */\nexport const ZERO_ADDRESS = '0x0000000000000000000000000000000000000000';\nexport const ZERO_BALANCE = '0x0';\n\nexport const PERPS_CONSTANTS = {\n  FeatureFlagKey: 'perpsEnabled',\n  FeatureName: 'perps', // Constant for Sentry error filtering - enables \"feature:perps\" dashboard queries\n  /** Token description used to identify the synthetic \"Perps balance\" option in pay-with token lists */\n  PerpsBalanceTokenDescription: 'perps-balance',\n  /** Symbol displayed for the synthetic \"Perps balance\" token in pay-with token lists */\n  PerpsBalanceTokenSymbol: 'USD',\n  WebsocketTimeout: 5000, // 5 seconds\n  WebsocketCleanupDelay: 1000, // 1 second\n  BackgroundDisconnectDelay: 20_000, // 20 seconds delay before disconnecting when app is backgrounded or when user exits perps UX\n  ConnectionTimeoutMs: 10_000, // 10 seconds timeout for connection and position loading states\n  DefaultMonitoringTimeoutMs: 10_000, // 10 seconds default timeout for data monitoring operations\n\n  // Connection timing constants\n  ConnectionGracePeriodMs: 20_000, // 20 seconds grace period before actual disconnection (same as BackgroundDisconnectDelay for semantic clarity)\n  ConnectionAttemptTimeoutMs: 30_000, // 30 seconds timeout for connection attempts to prevent indefinite hanging\n  WebsocketPingTimeoutMs: 5_000, // 5 seconds timeout for WebSocket health check ping\n  ConnectRetryDelayMs: 200, // Delay before retrying connect() when connection isn't ready yet\n  ForegroundPingRetryDelayMs: 500, // Delay before retrying ping in resumeFromForeground — JS thread may be sluggish right after foregrounding\n  ReconnectionCleanupDelayMs: 500, // Platform-agnostic delay to ensure WebSocket is ready\n  ReconnectionDelayAndroidMs: 300, // Android-specific reconnection delay for better reliability on slower devices\n  ReconnectionDelayIosMs: 100, // iOS-specific reconnection delay for optimal performance\n  ReconnectionRetryDelayMs: 5_000, // 5 seconds delay between reconnection attempts\n  NetworkRestoreMaxRetries: 8, // Max retry attempts when reconnecting after WiFi/network restore\n  NetworkRestoreRetryBaseMs: 1_500, // Base delay (ms) between network restore retries (multiplied by attempt number)\n\n  // Connection manager timing constants\n  BalanceUpdateThrottleMs: 15000, // Update at most every 15 seconds to reduce state updates in PerpsConnectionManager\n  InitialDataDelayMs: 100, // Delay to allow initial data to load after connection establishment\n\n  // Deposit toast timing\n  DepositTakingLongerToastDelayMs: 30_000, // Delay before showing \"Deposit taking longer than usual\" toast\n\n  DefaultAssetPreviewLimit: 5,\n  DefaultMaxLeverage: 3 as number, // Default fallback max leverage when market data is unavailable - conservative default\n  FallbackPriceDisplay: '$---', // Display when price data is unavailable\n  FallbackPercentageDisplay: '--%', // Display when change data is unavailable\n  FallbackDataDisplay: '--', // Display when non-price data is unavailable\n  ZeroAmountDisplay: '$0', // Display for zero dollar amounts (e.g., no volume)\n  ZeroAmountDetailedDisplay: '$0.00', // Display for zero dollar amounts with decimals\n\n  RecentActivityLimit: 3,\n\n  // Historical data fetching constants\n  FillsLookbackMs: 90 * 24 * 60 * 60 * 1000, // 3 months in milliseconds - limits REST API fills fetch\n} as const;\n\n/**\n * Withdrawal-specific constants (protocol-agnostic)\n * Note: Protocol-specific values like estimated time should be defined in each protocol's config\n */\nexport const WITHDRAWAL_CONSTANTS = {\n  DefaultMinAmount: '1.01', // Default minimum withdrawal amount in USDC\n  DefaultFeeAmount: 1, // Default withdrawal fee in USDC\n  DefaultFeeToken: 'USDC', // Default fee token\n} as const;\n\n/**\n * Validation thresholds for UI warnings and checks\n * These values control when warnings are shown to users\n */\nexport const VALIDATION_THRESHOLDS = {\n  // Leverage threshold for warning users about high leverage\n  HighLeverageWarning: 20, // Show warning when leverage > 20x\n\n  // Limit price difference threshold (as decimal, 0.1 = 10%)\n  LimitPriceDifferenceWarning: 0.1, // Warn if limit price differs by >10% from current price\n\n  // Price deviation threshold (as decimal, 0.1 = 10%)\n  PriceDeviation: 0.1, // Warn if perps price deviates by >10% from spot price\n} as const;\n\n/**\n * Order slippage configuration\n * Controls default slippage tolerance for different order types\n * Conservative defaults based on HyperLiquid platform interface\n * See: docs/perps/hyperliquid/ORDER-MATCHING-ERRORS.md\n */\nexport const ORDER_SLIPPAGE_CONFIG = {\n  // Market order slippage (basis points)\n  // 300 basis points = 3% = 0.03 decimal\n  // Conservative default for measured rollout, prevents most IOC failures\n  DefaultMarketSlippageBps: 300,\n\n  // TP/SL order slippage (basis points)\n  // 1000 basis points = 10% = 0.10 decimal\n  // Aligns with HyperLiquid platform default for triggered orders\n  DefaultTpslSlippageBps: 1000,\n\n  // Limit order slippage (basis points)\n  // 100 basis points = 1% = 0.01 decimal\n  // Kept conservative as limit orders rest on book (not IOC/immediate execution)\n  DefaultLimitSlippageBps: 100,\n} as const;\n\n/**\n * Max order amount buffer to reduce \"Insufficient margin\" rejections from the exchange.\n * When the user selects 100% (slider or Max), we cap the order at (1 - this) of the\n * theoretical max so that fees, rounding, and exchange-side margin checks are covered.\n * Value as decimal (e.g. 0.005 = 0.5%).\n */\nexport const MAX_ORDER_MARGIN_BUFFER = 0.005; // 0.5%\n\n/**\n * Performance optimization constants\n * These values control debouncing and throttling for better performance\n */\nexport const PERFORMANCE_CONFIG = {\n  // Price updates debounce delay (milliseconds)\n  // Batches rapid WebSocket price updates to reduce re-renders\n  PriceUpdateDebounceMs: 1000,\n\n  // Order validation debounce delay (milliseconds)\n  // Prevents excessive validation calls during rapid form input changes\n  ValidationDebounceMs: 300,\n\n  // Liquidation price debounce delay (milliseconds)\n  // Prevents excessive liquidation price calls during rapid form input changes\n  LiquidationPriceDebounceMs: 500,\n\n  // Candle subscription debounce delay (milliseconds)\n  // Prevents WS subscription churn during rapid market switching (#28141)\n  CandleConnectDebounceMs: 500,\n\n  // Navigation params delay (milliseconds)\n  // Required for React Navigation to complete state transitions before setting params\n  // This ensures navigation context is available when programmatically selecting tabs\n  NavigationParamsDelayMs: 200,\n\n  // Tab control reset delay (milliseconds)\n  // Delay to reset programmatic tab control after tab switching to prevent render loops\n  TabControlResetDelayMs: 500,\n\n  // Market data cache duration (milliseconds)\n  // How long to cache market list data before fetching fresh data\n  MarketDataCacheDurationMs: 5 * 60 * 1000, // 5 minutes\n\n  // Asset metadata cache duration (milliseconds)\n  // How long to cache asset icon validation results\n  AssetMetadataCacheDurationMs: 60 * 60 * 1000, // 1 hour\n\n  // Max leverage cache duration (milliseconds)\n  // How long to cache max leverage values per asset (leverage rarely changes)\n  MaxLeverageCacheDurationMs: 60 * 60 * 1000, // 1 hour\n\n  // Rewards cache durations (milliseconds)\n  // How long to cache fee discount data from rewards API\n  FeeDiscountCacheDurationMs: 5 * 60 * 1000, // 5 minutes\n  // How long to cache points calculation parameters from rewards API\n  PointsCalculationCacheDurationMs: 5 * 60 * 1000, // 5 minutes\n\n  /**\n   * Performance logging markers for filtering logs during development and debugging\n   * These markers help isolate performance-related logs from general application logs\n   * Usage: Use in DevLogger calls to easily filter specific performance areas\n   * Impact: Development only (uses DevLogger) - zero production performance cost\n   *\n   * Examples:\n   * - Filter Sentry performance logs: `adb logcat | grep PERPSMARK_SENTRY`\n   * - Filter MetaMetrics events: `adb logcat | grep PERPSMARK_METRICS`\n   * - Filter WebSocket performance: `adb logcat | grep PERPSMARK_WS`\n   * - Filter all Perps performance: `adb logcat | grep PERPSMARK_`\n   */\n  LoggingMarkers: {\n    // Sentry performance measurement logs (screen loads, bottom sheets, API timing)\n    SentryPerformance: 'PERPSMARK_SENTRY',\n\n    // MetaMetrics event tracking logs (user interactions, business analytics)\n    MetametricsEvents: 'PERPSMARK_METRICS',\n\n    // WebSocket performance logs (connection timing, data flow, reconnections)\n    WebsocketPerformance: 'PERPSMARK_SENTRY_WS',\n  } as const,\n} as const;\n\nexport const TP_SL_CONFIG = {\n  UsePositionBoundTpsl: true,\n} as const;\n\n/**\n * HyperLiquid order limits based on leverage\n * From: https://hyperliquid.gitbook.io/hyperliquid-docs/trading/contract-specifications\n */\nexport const HYPERLIQUID_ORDER_LIMITS = {\n  // Market orders\n  MarketOrderLimits: {\n    // $15,000,000 for max leverage >= 25\n    HighLeverage: 15_000_000,\n    // $5,000,000 for max leverage in [20, 25)\n    MediumHighLeverage: 5_000_000,\n    // $2,000,000 for max leverage in [10, 20)\n    MediumLeverage: 2_000_000,\n    // $500,000 for max leverage < 10\n    LowLeverage: 500_000,\n  },\n  // Limit orders are 10x market order limits\n  LimitOrderMultiplier: 10,\n} as const;\n\n/**\n * Close position configuration\n * Controls behavior and constants specific to position closing\n */\nexport const CLOSE_POSITION_CONFIG = {\n  // Decimal places for USD amount input display\n  UsdDecimalPlaces: 2,\n\n  // Default close percentage when opening the close position view\n  DefaultClosePercentage: 100,\n\n  // Precision for position size calculations to prevent rounding errors\n  AmountCalculationPrecision: 6,\n\n  // Throttle delay for real-time price updates during position closing\n  PriceThrottleMs: 3000,\n\n  // Fallback decimal places for tokens without metadata\n  FallbackTokenDecimals: 18,\n} as const;\n\n/**\n * Margin adjustment configuration\n * Controls behavior for adding/removing margin from positions\n */\nexport const MARGIN_ADJUSTMENT_CONFIG = {\n  // Risk thresholds for margin removal warnings\n  // Threshold values represent ratio of (price distance to liquidation) / (liquidation price)\n  // Values < 1.0 mean price is dangerously close to liquidation\n  LiquidationRiskThreshold: 1.2, // 20% buffer before liquidation - triggers danger state\n  LiquidationWarningThreshold: 1.5, // 50% buffer before liquidation - triggers warning state\n\n  // Minimum margin adjustment amount (USD)\n  // Prevents dust adjustments and ensures meaningful position changes\n  MinAdjustmentAmount: 1,\n\n  // Precision for margin calculations\n  // Ensures accurate decimal handling in margin/leverage calculations\n  CalculationPrecision: 6,\n\n  // Safety buffer for margin removal to account for HyperLiquid's transfer margin requirement\n  // HyperLiquid enforces: transfer_margin_required = max(initial_margin_required, 0.1 * total_position_value)\n  // See: https://hyperliquid.gitbook.io/hyperliquid-docs/trading/margin-and-pnl\n  MarginRemovalSafetyBuffer: 0.1,\n\n  // Fallback max leverage when market data is unavailable\n  // Conservative value to prevent over-removal of margin\n  // Most HyperLiquid assets support at least 50x leverage\n  FallbackMaxLeverage: 50,\n} as const;\n\n/**\n * Data Lake API configuration\n * Endpoints for reporting perps trading activity for notifications\n */\nexport const DATA_LAKE_API_CONFIG = {\n  // Order reporting endpoint - only used for mainnet perps trading\n  OrdersEndpoint: 'https://perps.api.cx.metamask.io/api/v1/orders',\n} as const;\n\n/**\n * Decimal precision configuration\n * Controls maximum decimal places for price and input validation\n */\nexport const DECIMAL_PRECISION_CONFIG = {\n  // Maximum decimal places for price input (matches Hyperliquid limit)\n  // Used in TP/SL forms, limit price inputs, and price validation\n  MaxPriceDecimals: 6,\n  // Maximum significant figures allowed by HyperLiquid API\n  // Orders with more than 5 significant figures will be rejected\n  MaxSignificantFigures: 5,\n  // Defensive fallback for size decimals when market data fails to load\n  // Real szDecimals should always come from market data API (varies by asset)\n  // Using 6 as safe maximum to prevent crashes (covers most assets)\n  // NOTE: This is NOT semantically correct - just a defensive measure\n  FallbackSizeDecimals: 6,\n} as const;\n\n/**\n * Market sorting configuration\n * Controls sorting behavior and presets for the trending markets view\n */\nexport const MARKET_SORTING_CONFIG = {\n  // Default sort settings\n  DefaultSortOptionId: 'volume' as const,\n  DefaultDirection: 'desc' as const,\n\n  // Available sort fields (only includes fields supported by PerpsMarketData)\n  SortFields: {\n    Volume: 'volume',\n    PriceChange: 'priceChange',\n    OpenInterest: 'openInterest',\n    FundingRate: 'fundingRate',\n  } as const,\n\n  // Sort button presets for filter chips (simplified buttons without direction)\n  SortButtonPresets: [\n    { field: 'volume', labelKey: 'perps.sort.volume' },\n    { field: 'priceChange', labelKey: 'perps.sort.price_change' },\n    { field: 'fundingRate', labelKey: 'perps.sort.funding_rate' },\n  ] as const,\n\n  // Sort options for the bottom sheet\n  // All options support direction toggle (high-to-low / low-to-high)\n  SortOptions: [\n    {\n      id: 'volume',\n      labelKey: 'perps.sort.volume',\n      field: 'volume',\n      direction: 'desc',\n    },\n    {\n      id: 'priceChange',\n      labelKey: 'perps.sort.price_change',\n      field: 'priceChange',\n      direction: 'desc',\n    },\n    {\n      id: 'openInterest',\n      labelKey: 'perps.sort.open_interest',\n      field: 'openInterest',\n      direction: 'desc',\n    },\n    {\n      id: 'fundingRate',\n      labelKey: 'perps.sort.funding_rate',\n      field: 'fundingRate',\n      direction: 'desc',\n    },\n  ] as const,\n} as const;\n\n/**\n * Type for valid sort option IDs\n * Derived from SORT_OPTIONS to ensure type safety\n * Valid values: 'volume' | 'priceChange' | 'openInterest' | 'fundingRate'\n */\nexport type SortOptionId =\n  (typeof MARKET_SORTING_CONFIG.SortOptions)[number]['id'];\n\n/**\n * Funding rate display configuration\n * Controls how funding rates are formatted and displayed\n */\nexport const FUNDING_RATE_CONFIG = {\n  // Number of decimal places to display for funding rates\n  Decimals: 4,\n  // Default display value when funding rate is zero or unavailable\n  ZeroDisplay: '0.0000%',\n  // Multiplier to convert decimal funding rate to percentage\n  PercentageMultiplier: 100,\n} as const;\n\n/**\n * Provider configuration for multi-provider support\n */\nexport const PROVIDER_CONFIG = {\n  /** Default perpetual DEX provider when no explicit selection exists */\n  DefaultProvider: 'hyperliquid' as const,\n  /** Force MYX to testnet only (mainnet credentials not yet available) */\n  MYX_TESTNET_ONLY: false,\n} as const;\n\n// Disk-backed cold-start cache keys and throttle interval\nexport const PERPS_DISK_CACHE_MARKETS = 'PERPS_DISK_CACHE_MARKETS';\nexport const PERPS_DISK_CACHE_USER_DATA = 'PERPS_DISK_CACHE_USER_DATA';\nexport const PERPS_DISK_CACHE_THROTTLE_MS = 30_000;\n\n/**\n * Build the standard provider:network cache key from controller state.\n *\n * @param state - Controller state containing provider and network info.\n * @param state.activeProvider - Active perps provider name.\n * @param state.isTestnet - Whether testnet mode is active.\n * @returns Cache key in the format \"provider:mainnet\" or \"provider:testnet\".\n */\nexport function getProviderNetworkKey(state: {\n  activeProvider?: string;\n  isTestnet?: boolean;\n}): string {\n  return `${state.activeProvider ?? PROVIDER_CONFIG.DefaultProvider}:${state.isTestnet ? 'testnet' : 'mainnet'}`;\n}\n\n/**\n * Build a provider:network cache key for a specific provider id.\n * Accounts for MYX_TESTNET_ONLY: MYX is always on testnet regardless of the\n * global network flag.\n *\n * @param providerId - The provider identifier (e.g. \"hyperliquid\", \"myx\").\n * @param isTestnet - Global testnet flag from controller state.\n * @returns Cache key in the format \"provider:mainnet\" or \"provider:testnet\".\n */\nexport function buildProviderCacheKey(\n  providerId: string,\n  isTestnet: boolean,\n): string {\n  const effectiveTestnet =\n    providerId === 'myx'\n      ? PROVIDER_CONFIG.MYX_TESTNET_ONLY || isTestnet\n      : isTestnet;\n  return `${providerId}:${effectiveTestnet ? 'testnet' : 'mainnet'}`;\n}\n"]}
+{"version":3,"file":"perpsConfig.cjs","sourceRoot":"","sources":["../../src/constants/perpsConfig.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Perps feature constants - Controller layer (portable)\n *\n * This file contains only controller-portable configuration:\n * - Constants used by controller logic, providers, and services\n * - Calculation thresholds, API configs, and protocol constants\n *\n * UI-only constants (layout, display, navigation) live in:\n * app/components/UI/Perps/constants/perpsConfig.ts\n */\nexport const ZERO_ADDRESS = '0x0000000000000000000000000000000000000000';\nexport const ZERO_BALANCE = '0x0';\n\nexport const PERPS_CONSTANTS = {\n  FeatureFlagKey: 'perpsEnabled',\n  FeatureName: 'perps', // Constant for Sentry error filtering - enables \"feature:perps\" dashboard queries\n  /** Token description used to identify the synthetic \"Perps balance\" option in pay-with token lists */\n  PerpsBalanceTokenDescription: 'perps-balance',\n  /** Symbol displayed for the synthetic \"Perps balance\" token in pay-with token lists */\n  PerpsBalanceTokenSymbol: 'USD',\n  WebsocketTimeout: 5000, // 5 seconds\n  WebsocketCleanupDelay: 1000, // 1 second\n  BackgroundDisconnectDelay: 20_000, // 20 seconds delay before disconnecting when app is backgrounded or when user exits perps UX\n  ConnectionTimeoutMs: 10_000, // 10 seconds timeout for connection and position loading states\n  DefaultMonitoringTimeoutMs: 10_000, // 10 seconds default timeout for data monitoring operations\n\n  // Connection timing constants\n  ConnectionGracePeriodMs: 20_000, // 20 seconds grace period before actual disconnection (same as BackgroundDisconnectDelay for semantic clarity)\n  ConnectionAttemptTimeoutMs: 30_000, // 30 seconds timeout for connection attempts to prevent indefinite hanging\n  WebsocketPingTimeoutMs: 5_000, // 5 seconds timeout for WebSocket health check ping\n  ConnectRetryDelayMs: 200, // Delay before retrying connect() when connection isn't ready yet\n  ForegroundPingRetryDelayMs: 500, // Delay before retrying ping in resumeFromForeground — JS thread may be sluggish right after foregrounding\n  ReconnectionCleanupDelayMs: 500, // Platform-agnostic delay to ensure WebSocket is ready\n  ReconnectionDelayAndroidMs: 300, // Android-specific reconnection delay for better reliability on slower devices\n  ReconnectionDelayIosMs: 100, // iOS-specific reconnection delay for optimal performance\n  ReconnectionRetryDelayMs: 5_000, // 5 seconds delay between reconnection attempts\n  NetworkRestoreMaxRetries: 8, // Max retry attempts when reconnecting after WiFi/network restore\n  NetworkRestoreRetryBaseMs: 1_500, // Base delay (ms) between network restore retries (multiplied by attempt number)\n\n  // Connection manager timing constants\n  BalanceUpdateThrottleMs: 15000, // Update at most every 15 seconds to reduce state updates in PerpsConnectionManager\n  InitialDataDelayMs: 100, // Delay to allow initial data to load after connection establishment\n\n  // Deposit toast timing\n  DepositTakingLongerToastDelayMs: 30_000, // Delay before showing \"Deposit taking longer than usual\" toast\n\n  DefaultAssetPreviewLimit: 5,\n  DefaultMaxLeverage: 3 as number, // Default fallback max leverage when market data is unavailable - conservative default\n  FallbackPriceDisplay: '$---', // Display when price data is unavailable\n  FallbackPercentageDisplay: '--%', // Display when change data is unavailable\n  FallbackDataDisplay: '--', // Display when non-price data is unavailable\n  ZeroAmountDisplay: '$0', // Display for zero dollar amounts (e.g., no volume)\n  ZeroAmountDetailedDisplay: '$0.00', // Display for zero dollar amounts with decimals\n\n  RecentActivityLimit: 3,\n\n  // Historical data fetching constants\n  FillsLookbackMs: 90 * 24 * 60 * 60 * 1000, // 3 months in milliseconds - limits REST API fills fetch\n} as const;\n\n/**\n * Withdrawal-specific constants (protocol-agnostic)\n * Note: Protocol-specific values like estimated time should be defined in each protocol's config\n */\nexport const WITHDRAWAL_CONSTANTS = {\n  DefaultMinAmount: '1.01', // Default minimum withdrawal amount in USDC\n  DefaultFeeAmount: 1, // Default withdrawal fee in USDC\n  DefaultFeeToken: 'USDC', // Default fee token\n} as const;\n\n/**\n * Validation thresholds for UI warnings and checks\n * These values control when warnings are shown to users\n */\nexport const VALIDATION_THRESHOLDS = {\n  // Leverage threshold for warning users about high leverage\n  HighLeverageWarning: 20, // Show warning when leverage > 20x\n\n  // Limit price difference threshold (as decimal, 0.1 = 10%)\n  LimitPriceDifferenceWarning: 0.1, // Warn if limit price differs by >10% from current price\n\n  // Price deviation threshold (as decimal, 0.1 = 10%)\n  PriceDeviation: 0.1, // Warn if perps price deviates by >10% from spot price\n} as const;\n\n/**\n * Order slippage configuration\n * Controls default slippage tolerance for different order types\n * Conservative defaults based on HyperLiquid platform interface\n * See: docs/perps/hyperliquid/ORDER-MATCHING-ERRORS.md\n */\nexport const ORDER_SLIPPAGE_CONFIG = {\n  // Market order slippage (basis points)\n  // 300 basis points = 3% = 0.03 decimal\n  // Conservative default for measured rollout, prevents most IOC failures\n  DefaultMarketSlippageBps: 300,\n\n  // TP/SL order slippage (basis points)\n  // 1000 basis points = 10% = 0.10 decimal\n  // Aligns with HyperLiquid platform default for triggered orders\n  DefaultTpslSlippageBps: 1000,\n\n  // Limit order slippage (basis points)\n  // 100 basis points = 1% = 0.01 decimal\n  // Kept conservative as limit orders rest on book (not IOC/immediate execution)\n  DefaultLimitSlippageBps: 100,\n} as const;\n\n/**\n * Max order amount buffer to reduce \"Insufficient margin\" rejections from the exchange.\n * When the user selects 100% (slider or Max), we cap the order at (1 - this) of the\n * theoretical max so that fees, rounding, and exchange-side margin checks are covered.\n * Value as decimal (e.g. 0.005 = 0.5%).\n */\nexport const MAX_ORDER_MARGIN_BUFFER = 0.005; // 0.5%\n\n/**\n * Performance optimization constants\n * These values control debouncing and throttling for better performance\n */\nexport const PERFORMANCE_CONFIG = {\n  // Price updates debounce delay (milliseconds)\n  // Batches rapid WebSocket price updates to reduce re-renders\n  PriceUpdateDebounceMs: 1000,\n\n  // Order validation debounce delay (milliseconds)\n  // Prevents excessive validation calls during rapid form input changes\n  ValidationDebounceMs: 300,\n\n  // Liquidation price debounce delay (milliseconds)\n  // Prevents excessive liquidation price calls during rapid form input changes\n  LiquidationPriceDebounceMs: 500,\n\n  // Candle subscription debounce delay (milliseconds)\n  // Prevents WS subscription churn during rapid market switching (#28141)\n  CandleConnectDebounceMs: 500,\n\n  // Candle WS teardown delay (milliseconds)\n  // When the last subscriber for a cacheKey unsubscribes, wait this long before\n  // tearing down the WS. A subsequent subscribe inside the window cancels the\n  // teardown so rapid back-and-forth switches do not churn the connection.\n  CandleTeardownDelayMs: 150,\n\n  // Perps REST coalesce TTL (milliseconds)\n  //\n  // Window in which identical GET-style REST calls (getOrderFills, getOrders,\n  // getFunding, historicalOrders) share a single in-flight promise / cached\n  // result. `forceRefresh` still bypasses the cache end-to-end (hooks →\n  // controller → MarketDataService → provider → HyperLiquidClientService), so\n  // pull-to-refresh always hits the network.\n  //\n  // Why 60 s: HyperLiquid's documented rate limit is 1200 weight / IP /\n  // rolling 60 s window. Sizing TTL = window length caps each endpoint-per-\n  // account at ≤1 REST hit per window under any UI activity pattern — rapid\n  // market switching, re-mounts (usePerpsMarketFills, usePerpsTransactionHistory),\n  // and multi-tab scans all share a single request. Live fills/orders/prices\n  // still flow via WS subscriptions, so REST is seed/backfill only — cache\n  // staleness inside the 60 s window is never user-visible.\n  PerpsRestCoalesceTtlMs: 60_000,\n\n  // Candle snapshot REST coalesce TTL (milliseconds).\n  // Longer than PerpsRestCoalesceTtlMs because WS stream keeps live candles\n  // fresh — the REST snapshot only seeds the chart on initial subscribe. A\n  // 30 s window lets rapid market switching (pass 1 → pass 2 of a stress\n  // loop) share the same snapshot per (symbol, interval), cutting\n  // candleSnapshot REST weight roughly in half.\n  PerpsCandleCoalesceTtlMs: 30_000,\n\n  // Navigation params delay (milliseconds)\n  // Required for React Navigation to complete state transitions before setting params\n  // This ensures navigation context is available when programmatically selecting tabs\n  NavigationParamsDelayMs: 200,\n\n  // Tab control reset delay (milliseconds)\n  // Delay to reset programmatic tab control after tab switching to prevent render loops\n  TabControlResetDelayMs: 500,\n\n  // Market data cache duration (milliseconds)\n  // How long to cache market list data before fetching fresh data\n  MarketDataCacheDurationMs: 5 * 60 * 1000, // 5 minutes\n\n  // Asset metadata cache duration (milliseconds)\n  // How long to cache asset icon validation results\n  AssetMetadataCacheDurationMs: 60 * 60 * 1000, // 1 hour\n\n  // Max leverage cache duration (milliseconds)\n  // How long to cache max leverage values per asset (leverage rarely changes)\n  MaxLeverageCacheDurationMs: 60 * 60 * 1000, // 1 hour\n\n  // Rewards cache durations (milliseconds)\n  // How long to cache fee discount data from rewards API\n  FeeDiscountCacheDurationMs: 5 * 60 * 1000, // 5 minutes\n  // How long to cache points calculation parameters from rewards API\n  PointsCalculationCacheDurationMs: 5 * 60 * 1000, // 5 minutes\n\n  /**\n   * Performance logging markers for filtering logs during development and debugging\n   * These markers help isolate performance-related logs from general application logs\n   * Usage: Use in DevLogger calls to easily filter specific performance areas\n   * Impact: Development only (uses DevLogger) - zero production performance cost\n   *\n   * Examples:\n   * - Filter Sentry performance logs: `adb logcat | grep PERPSMARK_SENTRY`\n   * - Filter MetaMetrics events: `adb logcat | grep PERPSMARK_METRICS`\n   * - Filter WebSocket performance: `adb logcat | grep PERPSMARK_WS`\n   * - Filter all Perps performance: `adb logcat | grep PERPSMARK_`\n   */\n  LoggingMarkers: {\n    // Sentry performance measurement logs (screen loads, bottom sheets, API timing)\n    SentryPerformance: 'PERPSMARK_SENTRY',\n\n    // MetaMetrics event tracking logs (user interactions, business analytics)\n    MetametricsEvents: 'PERPSMARK_METRICS',\n\n    // WebSocket performance logs (connection timing, data flow, reconnections)\n    WebsocketPerformance: 'PERPSMARK_SENTRY_WS',\n  } as const,\n} as const;\n\nexport const TP_SL_CONFIG = {\n  UsePositionBoundTpsl: true,\n} as const;\n\n/**\n * HyperLiquid order limits based on leverage\n * From: https://hyperliquid.gitbook.io/hyperliquid-docs/trading/contract-specifications\n */\nexport const HYPERLIQUID_ORDER_LIMITS = {\n  // Market orders\n  MarketOrderLimits: {\n    // $15,000,000 for max leverage >= 25\n    HighLeverage: 15_000_000,\n    // $5,000,000 for max leverage in [20, 25)\n    MediumHighLeverage: 5_000_000,\n    // $2,000,000 for max leverage in [10, 20)\n    MediumLeverage: 2_000_000,\n    // $500,000 for max leverage < 10\n    LowLeverage: 500_000,\n  },\n  // Limit orders are 10x market order limits\n  LimitOrderMultiplier: 10,\n} as const;\n\n/**\n * Close position configuration\n * Controls behavior and constants specific to position closing\n */\nexport const CLOSE_POSITION_CONFIG = {\n  // Decimal places for USD amount input display\n  UsdDecimalPlaces: 2,\n\n  // Default close percentage when opening the close position view\n  DefaultClosePercentage: 100,\n\n  // Precision for position size calculations to prevent rounding errors\n  AmountCalculationPrecision: 6,\n\n  // Throttle delay for real-time price updates during position closing\n  PriceThrottleMs: 3000,\n\n  // Fallback decimal places for tokens without metadata\n  FallbackTokenDecimals: 18,\n} as const;\n\n/**\n * Margin adjustment configuration\n * Controls behavior for adding/removing margin from positions\n */\nexport const MARGIN_ADJUSTMENT_CONFIG = {\n  // Risk thresholds for margin removal warnings\n  // Threshold values represent ratio of (price distance to liquidation) / (liquidation price)\n  // Values < 1.0 mean price is dangerously close to liquidation\n  LiquidationRiskThreshold: 1.2, // 20% buffer before liquidation - triggers danger state\n  LiquidationWarningThreshold: 1.5, // 50% buffer before liquidation - triggers warning state\n\n  // Minimum margin adjustment amount (USD)\n  // Prevents dust adjustments and ensures meaningful position changes\n  MinAdjustmentAmount: 1,\n\n  // Precision for margin calculations\n  // Ensures accurate decimal handling in margin/leverage calculations\n  CalculationPrecision: 6,\n\n  // Safety buffer for margin removal to account for HyperLiquid's transfer margin requirement\n  // HyperLiquid enforces: transfer_margin_required = max(initial_margin_required, 0.1 * total_position_value)\n  // See: https://hyperliquid.gitbook.io/hyperliquid-docs/trading/margin-and-pnl\n  MarginRemovalSafetyBuffer: 0.1,\n\n  // Fallback max leverage when market data is unavailable\n  // Conservative value to prevent over-removal of margin\n  // Most HyperLiquid assets support at least 50x leverage\n  FallbackMaxLeverage: 50,\n} as const;\n\n/**\n * Data Lake API configuration\n * Endpoints for reporting perps trading activity for notifications\n */\nexport const DATA_LAKE_API_CONFIG = {\n  // Order reporting endpoint - only used for mainnet perps trading\n  OrdersEndpoint: 'https://perps.api.cx.metamask.io/api/v1/orders',\n} as const;\n\n/**\n * Decimal precision configuration\n * Controls maximum decimal places for price and input validation\n */\nexport const DECIMAL_PRECISION_CONFIG = {\n  // Maximum decimal places for price input (matches Hyperliquid limit)\n  // Used in TP/SL forms, limit price inputs, and price validation\n  MaxPriceDecimals: 6,\n  // Maximum significant figures allowed by HyperLiquid API\n  // Orders with more than 5 significant figures will be rejected\n  MaxSignificantFigures: 5,\n  // Defensive fallback for size decimals when market data fails to load\n  // Real szDecimals should always come from market data API (varies by asset)\n  // Using 6 as safe maximum to prevent crashes (covers most assets)\n  // NOTE: This is NOT semantically correct - just a defensive measure\n  FallbackSizeDecimals: 6,\n} as const;\n\n/**\n * Market sorting configuration\n * Controls sorting behavior and presets for the trending markets view\n */\nexport const MARKET_SORTING_CONFIG = {\n  // Default sort settings\n  DefaultSortOptionId: 'volume' as const,\n  DefaultDirection: 'desc' as const,\n\n  // Available sort fields (only includes fields supported by PerpsMarketData)\n  SortFields: {\n    Volume: 'volume',\n    PriceChange: 'priceChange',\n    OpenInterest: 'openInterest',\n    FundingRate: 'fundingRate',\n  } as const,\n\n  // Sort button presets for filter chips (simplified buttons without direction)\n  SortButtonPresets: [\n    { field: 'volume', labelKey: 'perps.sort.volume' },\n    { field: 'priceChange', labelKey: 'perps.sort.price_change' },\n    { field: 'fundingRate', labelKey: 'perps.sort.funding_rate' },\n  ] as const,\n\n  // Sort options for the bottom sheet\n  // All options support direction toggle (high-to-low / low-to-high)\n  SortOptions: [\n    {\n      id: 'volume',\n      labelKey: 'perps.sort.volume',\n      field: 'volume',\n      direction: 'desc',\n    },\n    {\n      id: 'priceChange',\n      labelKey: 'perps.sort.price_change',\n      field: 'priceChange',\n      direction: 'desc',\n    },\n    {\n      id: 'openInterest',\n      labelKey: 'perps.sort.open_interest',\n      field: 'openInterest',\n      direction: 'desc',\n    },\n    {\n      id: 'fundingRate',\n      labelKey: 'perps.sort.funding_rate',\n      field: 'fundingRate',\n      direction: 'desc',\n    },\n  ] as const,\n} as const;\n\n/**\n * Type for valid sort option IDs\n * Derived from SORT_OPTIONS to ensure type safety\n * Valid values: 'volume' | 'priceChange' | 'openInterest' | 'fundingRate'\n */\nexport type SortOptionId =\n  (typeof MARKET_SORTING_CONFIG.SortOptions)[number]['id'];\n\n/**\n * Funding rate display configuration\n * Controls how funding rates are formatted and displayed\n */\nexport const FUNDING_RATE_CONFIG = {\n  // Number of decimal places to display for funding rates\n  Decimals: 4,\n  // Default display value when funding rate is zero or unavailable\n  ZeroDisplay: '0.0000%',\n  // Multiplier to convert decimal funding rate to percentage\n  PercentageMultiplier: 100,\n} as const;\n\n/**\n * Provider configuration for multi-provider support\n */\nexport const PROVIDER_CONFIG = {\n  /** Default perpetual DEX provider when no explicit selection exists */\n  DefaultProvider: 'hyperliquid' as const,\n  /** Force MYX to testnet only (mainnet credentials not yet available) */\n  MYX_TESTNET_ONLY: false,\n} as const;\n\n// Disk-backed cold-start cache keys and throttle interval\nexport const PERPS_DISK_CACHE_MARKETS = 'PERPS_DISK_CACHE_MARKETS';\nexport const PERPS_DISK_CACHE_USER_DATA = 'PERPS_DISK_CACHE_USER_DATA';\nexport const PERPS_DISK_CACHE_THROTTLE_MS = 30_000;\n\n/**\n * Build the standard provider:network cache key from controller state.\n *\n * @param state - Controller state containing provider and network info.\n * @param state.activeProvider - Active perps provider name.\n * @param state.isTestnet - Whether testnet mode is active.\n * @returns Cache key in the format \"provider:mainnet\" or \"provider:testnet\".\n */\nexport function getProviderNetworkKey(state: {\n  activeProvider?: string;\n  isTestnet?: boolean;\n}): string {\n  return `${state.activeProvider ?? PROVIDER_CONFIG.DefaultProvider}:${state.isTestnet ? 'testnet' : 'mainnet'}`;\n}\n\n/**\n * Build a provider:network cache key for a specific provider id.\n * Accounts for MYX_TESTNET_ONLY: MYX is always on testnet regardless of the\n * global network flag.\n *\n * @param providerId - The provider identifier (e.g. \"hyperliquid\", \"myx\").\n * @param isTestnet - Global testnet flag from controller state.\n * @returns Cache key in the format \"provider:mainnet\" or \"provider:testnet\".\n */\nexport function buildProviderCacheKey(\n  providerId: string,\n  isTestnet: boolean,\n): string {\n  const effectiveTestnet =\n    providerId === 'myx'\n      ? PROVIDER_CONFIG.MYX_TESTNET_ONLY || isTestnet\n      : isTestnet;\n  return `${providerId}:${effectiveTestnet ? 'testnet' : 'mainnet'}`;\n}\n"]}

package/dist/constants/perpsConfig.d.cts

@@ -91,6 +91,9 @@ export declare const PERFORMANCE_CONFIG: {
     readonly ValidationDebounceMs: 300;
     readonly LiquidationPriceDebounceMs: 500;
     readonly CandleConnectDebounceMs: 500;
+    readonly CandleTeardownDelayMs: 150;
+    readonly PerpsRestCoalesceTtlMs: 60000;
+    readonly PerpsCandleCoalesceTtlMs: 30000;
     readonly NavigationParamsDelayMs: 200;
     readonly TabControlResetDelayMs: 500;
     readonly MarketDataCacheDurationMs: number;

package/dist/constants/perpsConfig.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"perpsConfig.d.cts","sourceRoot":"","sources":["../../src/constants/perpsConfig.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,eAAO,MAAM,YAAY,+CAA+C,CAAC;AACzE,eAAO,MAAM,YAAY,QAAQ,CAAC;AAElC,eAAO,MAAM,eAAe;;;IAG1B,sGAAsG;;IAEtG,uFAAuF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwC/E,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;;;CAIvB,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,qBAAqB;;;;CASxB,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB;;;;CAexB,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,QAAQ,CAAC;AAE7C;;;GAGG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;IA4C7B;;;;;;;;;;;OAWG;;;;;;CAWK,CAAC;AAEX,eAAO,MAAM,YAAY;;CAEf,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;CAc3B,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,qBAAqB;;;;;;CAexB,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,wBAAwB;;;;;;;CAwB3B,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;CAGvB,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,wBAAwB;;;;CAY3B,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgDxB,CAAC;AAEX;;;;GAIG;AACH,MAAM,MAAM,YAAY,GACtB,CAAC,OAAO,qBAAqB,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC;AAE3D;;;GAGG;AACH,eAAO,MAAM,mBAAmB;;;;CAOtB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,eAAe;IAC1B,uEAAuE;;IAEvE,wEAAwE;;CAEhE,CAAC;AAGX,eAAO,MAAM,wBAAwB,6BAA6B,CAAC;AACnE,eAAO,MAAM,0BAA0B,+BAA+B,CAAC;AACvE,eAAO,MAAM,4BAA4B,QAAS,CAAC;AAEnD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE;IAC3C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,GAAG,MAAM,CAET;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,OAAO,GACjB,MAAM,CAMR"}
+{"version":3,"file":"perpsConfig.d.cts","sourceRoot":"","sources":["../../src/constants/perpsConfig.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,eAAO,MAAM,YAAY,+CAA+C,CAAC;AACzE,eAAO,MAAM,YAAY,QAAQ,CAAC;AAElC,eAAO,MAAM,eAAe;;;IAG1B,sGAAsG;;IAEtG,uFAAuF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwC/E,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;;;CAIvB,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,qBAAqB;;;;CASxB,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB;;;;CAexB,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,QAAQ,CAAC;AAE7C;;;GAGG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;IA2E7B;;;;;;;;;;;OAWG;;;;;;CAWK,CAAC;AAEX,eAAO,MAAM,YAAY;;CAEf,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;CAc3B,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,qBAAqB;;;;;;CAexB,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,wBAAwB;;;;;;;CAwB3B,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;CAGvB,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,wBAAwB;;;;CAY3B,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgDxB,CAAC;AAEX;;;;GAIG;AACH,MAAM,MAAM,YAAY,GACtB,CAAC,OAAO,qBAAqB,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC;AAE3D;;;GAGG;AACH,eAAO,MAAM,mBAAmB;;;;CAOtB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,eAAe;IAC1B,uEAAuE;;IAEvE,wEAAwE;;CAEhE,CAAC;AAGX,eAAO,MAAM,wBAAwB,6BAA6B,CAAC;AACnE,eAAO,MAAM,0BAA0B,+BAA+B,CAAC;AACvE,eAAO,MAAM,4BAA4B,QAAS,CAAC;AAEnD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE;IAC3C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,GAAG,MAAM,CAET;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,OAAO,GACjB,MAAM,CAMR"}

package/dist/constants/perpsConfig.d.mts

@@ -91,6 +91,9 @@ export declare const PERFORMANCE_CONFIG: {
     readonly ValidationDebounceMs: 300;
     readonly LiquidationPriceDebounceMs: 500;
     readonly CandleConnectDebounceMs: 500;
+    readonly CandleTeardownDelayMs: 150;
+    readonly PerpsRestCoalesceTtlMs: 60000;
+    readonly PerpsCandleCoalesceTtlMs: 30000;
     readonly NavigationParamsDelayMs: 200;
     readonly TabControlResetDelayMs: 500;
     readonly MarketDataCacheDurationMs: number;

package/dist/constants/perpsConfig.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"perpsConfig.d.mts","sourceRoot":"","sources":["../../src/constants/perpsConfig.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,eAAO,MAAM,YAAY,+CAA+C,CAAC;AACzE,eAAO,MAAM,YAAY,QAAQ,CAAC;AAElC,eAAO,MAAM,eAAe;;;IAG1B,sGAAsG;;IAEtG,uFAAuF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwC/E,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;;;CAIvB,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,qBAAqB;;;;CASxB,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB;;;;CAexB,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,QAAQ,CAAC;AAE7C;;;GAGG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;IA4C7B;;;;;;;;;;;OAWG;;;;;;CAWK,CAAC;AAEX,eAAO,MAAM,YAAY;;CAEf,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;CAc3B,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,qBAAqB;;;;;;CAexB,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,wBAAwB;;;;;;;CAwB3B,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;CAGvB,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,wBAAwB;;;;CAY3B,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgDxB,CAAC;AAEX;;;;GAIG;AACH,MAAM,MAAM,YAAY,GACtB,CAAC,OAAO,qBAAqB,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC;AAE3D;;;GAGG;AACH,eAAO,MAAM,mBAAmB;;;;CAOtB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,eAAe;IAC1B,uEAAuE;;IAEvE,wEAAwE;;CAEhE,CAAC;AAGX,eAAO,MAAM,wBAAwB,6BAA6B,CAAC;AACnE,eAAO,MAAM,0BAA0B,+BAA+B,CAAC;AACvE,eAAO,MAAM,4BAA4B,QAAS,CAAC;AAEnD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE;IAC3C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,GAAG,MAAM,CAET;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,OAAO,GACjB,MAAM,CAMR"}
+{"version":3,"file":"perpsConfig.d.mts","sourceRoot":"","sources":["../../src/constants/perpsConfig.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,eAAO,MAAM,YAAY,+CAA+C,CAAC;AACzE,eAAO,MAAM,YAAY,QAAQ,CAAC;AAElC,eAAO,MAAM,eAAe;;;IAG1B,sGAAsG;;IAEtG,uFAAuF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwC/E,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;;;CAIvB,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,qBAAqB;;;;CASxB,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB;;;;CAexB,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,QAAQ,CAAC;AAE7C;;;GAGG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;IA2E7B;;;;;;;;;;;OAWG;;;;;;CAWK,CAAC;AAEX,eAAO,MAAM,YAAY;;CAEf,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;CAc3B,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,qBAAqB;;;;;;CAexB,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,wBAAwB;;;;;;;CAwB3B,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;CAGvB,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,wBAAwB;;;;CAY3B,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgDxB,CAAC;AAEX;;;;GAIG;AACH,MAAM,MAAM,YAAY,GACtB,CAAC,OAAO,qBAAqB,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC;AAE3D;;;GAGG;AACH,eAAO,MAAM,mBAAmB;;;;CAOtB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,eAAe;IAC1B,uEAAuE;;IAEvE,wEAAwE;;CAEhE,CAAC;AAGX,eAAO,MAAM,wBAAwB,6BAA6B,CAAC;AACnE,eAAO,MAAM,0BAA0B,+BAA+B,CAAC;AACvE,eAAO,MAAM,4BAA4B,QAAS,CAAC;AAEnD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE;IAC3C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,GAAG,MAAM,CAET;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,OAAO,GACjB,MAAM,CAMR"}

package/dist/constants/perpsConfig.mjs

@@ -115,6 +115,34 @@ export const PERFORMANCE_CONFIG = {
     // Candle subscription debounce delay (milliseconds)
     // Prevents WS subscription churn during rapid market switching (#28141)
     CandleConnectDebounceMs: 500,
+    // Candle WS teardown delay (milliseconds)
+    // When the last subscriber for a cacheKey unsubscribes, wait this long before
+    // tearing down the WS. A subsequent subscribe inside the window cancels the
+    // teardown so rapid back-and-forth switches do not churn the connection.
+    CandleTeardownDelayMs: 150,
+    // Perps REST coalesce TTL (milliseconds)
+    //
+    // Window in which identical GET-style REST calls (getOrderFills, getOrders,
+    // getFunding, historicalOrders) share a single in-flight promise / cached
+    // result. `forceRefresh` still bypasses the cache end-to-end (hooks →
+    // controller → MarketDataService → provider → HyperLiquidClientService), so
+    // pull-to-refresh always hits the network.
+    //
+    // Why 60 s: HyperLiquid's documented rate limit is 1200 weight / IP /
+    // rolling 60 s window. Sizing TTL = window length caps each endpoint-per-
+    // account at ≤1 REST hit per window under any UI activity pattern — rapid
+    // market switching, re-mounts (usePerpsMarketFills, usePerpsTransactionHistory),
+    // and multi-tab scans all share a single request. Live fills/orders/prices
+    // still flow via WS subscriptions, so REST is seed/backfill only — cache
+    // staleness inside the 60 s window is never user-visible.
+    PerpsRestCoalesceTtlMs: 60000,
+    // Candle snapshot REST coalesce TTL (milliseconds).
+    // Longer than PerpsRestCoalesceTtlMs because WS stream keeps live candles
+    // fresh — the REST snapshot only seeds the chart on initial subscribe. A
+    // 30 s window lets rapid market switching (pass 1 → pass 2 of a stress
+    // loop) share the same snapshot per (symbol, interval), cutting
+    // candleSnapshot REST weight roughly in half.
+    PerpsCandleCoalesceTtlMs: 30000,
     // Navigation params delay (milliseconds)
     // Required for React Navigation to complete state transitions before setting params
     // This ensures navigation context is available when programmatically selecting tabs

package/dist/constants/perpsConfig.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"perpsConfig.mjs","sourceRoot":"","sources":["../../src/constants/perpsConfig.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,4CAA4C,CAAC;AACzE,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,CAAC;AAElC,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,cAAc,EAAE,cAAc;IAC9B,WAAW,EAAE,OAAO,EAAE,kFAAkF;IACxG,sGAAsG;IACtG,4BAA4B,EAAE,eAAe;IAC7C,uFAAuF;IACvF,uBAAuB,EAAE,KAAK;IAC9B,gBAAgB,EAAE,IAAI,EAAE,YAAY;IACpC,qBAAqB,EAAE,IAAI,EAAE,WAAW;IACxC,yBAAyB,EAAE,KAAM,EAAE,6FAA6F;IAChI,mBAAmB,EAAE,KAAM,EAAE,gEAAgE;IAC7F,0BAA0B,EAAE,KAAM,EAAE,4DAA4D;IAEhG,8BAA8B;IAC9B,uBAAuB,EAAE,KAAM,EAAE,+GAA+G;IAChJ,0BAA0B,EAAE,KAAM,EAAE,2EAA2E;IAC/G,sBAAsB,EAAE,IAAK,EAAE,oDAAoD;IACnF,mBAAmB,EAAE,GAAG,EAAE,kEAAkE;IAC5F,0BAA0B,EAAE,GAAG,EAAE,2GAA2G;IAC5I,0BAA0B,EAAE,GAAG,EAAE,uDAAuD;IACxF,0BAA0B,EAAE,GAAG,EAAE,+EAA+E;IAChH,sBAAsB,EAAE,GAAG,EAAE,0DAA0D;IACvF,wBAAwB,EAAE,IAAK,EAAE,gDAAgD;IACjF,wBAAwB,EAAE,CAAC,EAAE,kEAAkE;IAC/F,yBAAyB,EAAE,IAAK,EAAE,iFAAiF;IAEnH,sCAAsC;IACtC,uBAAuB,EAAE,KAAK,EAAE,oFAAoF;IACpH,kBAAkB,EAAE,GAAG,EAAE,qEAAqE;IAE9F,uBAAuB;IACvB,+BAA+B,EAAE,KAAM,EAAE,gEAAgE;IAEzG,wBAAwB,EAAE,CAAC;IAC3B,kBAAkB,EAAE,CAAW,EAAE,uFAAuF;IACxH,oBAAoB,EAAE,MAAM,EAAE,yCAAyC;IACvE,yBAAyB,EAAE,KAAK,EAAE,0CAA0C;IAC5E,mBAAmB,EAAE,IAAI,EAAE,6CAA6C;IACxE,iBAAiB,EAAE,IAAI,EAAE,oDAAoD;IAC7E,yBAAyB,EAAE,OAAO,EAAE,gDAAgD;IAEpF,mBAAmB,EAAE,CAAC;IAEtB,qCAAqC;IACrC,eAAe,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,yDAAyD;CAC5F,CAAC;AAEX;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,gBAAgB,EAAE,MAAM,EAAE,4CAA4C;IACtE,gBAAgB,EAAE,CAAC,EAAE,iCAAiC;IACtD,eAAe,EAAE,MAAM,EAAE,oBAAoB;CACrC,CAAC;AAEX;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,2DAA2D;IAC3D,mBAAmB,EAAE,EAAE,EAAE,mCAAmC;IAE5D,2DAA2D;IAC3D,2BAA2B,EAAE,GAAG,EAAE,yDAAyD;IAE3F,oDAAoD;IACpD,cAAc,EAAE,GAAG,EAAE,uDAAuD;CACpE,CAAC;AAEX;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,uCAAuC;IACvC,uCAAuC;IACvC,wEAAwE;IACxE,wBAAwB,EAAE,GAAG;IAE7B,sCAAsC;IACtC,yCAAyC;IACzC,gEAAgE;IAChE,sBAAsB,EAAE,IAAI;IAE5B,sCAAsC;IACtC,uCAAuC;IACvC,+EAA+E;IAC/E,uBAAuB,EAAE,GAAG;CACpB,CAAC;AAEX;;;;;GAKG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,KAAK,CAAC,CAAC,OAAO;AAErD;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,8CAA8C;IAC9C,6DAA6D;IAC7D,qBAAqB,EAAE,IAAI;IAE3B,iDAAiD;IACjD,sEAAsE;IACtE,oBAAoB,EAAE,GAAG;IAEzB,kDAAkD;IAClD,6EAA6E;IAC7E,0BAA0B,EAAE,GAAG;IAE/B,oDAAoD;IACpD,wEAAwE;IACxE,uBAAuB,EAAE,GAAG;IAE5B,yCAAyC;IACzC,oFAAoF;IACpF,oFAAoF;IACpF,uBAAuB,EAAE,GAAG;IAE5B,yCAAyC;IACzC,sFAAsF;IACtF,sBAAsB,EAAE,GAAG;IAE3B,4CAA4C;IAC5C,gEAAgE;IAChE,yBAAyB,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI,EAAE,YAAY;IAEtD,+CAA+C;IAC/C,kDAAkD;IAClD,4BAA4B,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,SAAS;IAEvD,6CAA6C;IAC7C,4EAA4E;IAC5E,0BAA0B,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,SAAS;IAErD,yCAAyC;IACzC,uDAAuD;IACvD,0BAA0B,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI,EAAE,YAAY;IACvD,mEAAmE;IACnE,gCAAgC,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI,EAAE,YAAY;IAE7D;;;;;;;;;;;OAWG;IACH,cAAc,EAAE;QACd,gFAAgF;QAChF,iBAAiB,EAAE,kBAAkB;QAErC,0EAA0E;QAC1E,iBAAiB,EAAE,mBAAmB;QAEtC,2EAA2E;QAC3E,oBAAoB,EAAE,qBAAqB;KACnC;CACF,CAAC;AAEX,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,oBAAoB,EAAE,IAAI;CAClB,CAAC;AAEX;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,gBAAgB;IAChB,iBAAiB,EAAE;QACjB,qCAAqC;QACrC,YAAY,EAAE,QAAU;QACxB,0CAA0C;QAC1C,kBAAkB,EAAE,OAAS;QAC7B,0CAA0C;QAC1C,cAAc,EAAE,OAAS;QACzB,iCAAiC;QACjC,WAAW,EAAE,MAAO;KACrB;IACD,2CAA2C;IAC3C,oBAAoB,EAAE,EAAE;CAChB,CAAC;AAEX;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,8CAA8C;IAC9C,gBAAgB,EAAE,CAAC;IAEnB,gEAAgE;IAChE,sBAAsB,EAAE,GAAG;IAE3B,sEAAsE;IACtE,0BAA0B,EAAE,CAAC;IAE7B,qEAAqE;IACrE,eAAe,EAAE,IAAI;IAErB,sDAAsD;IACtD,qBAAqB,EAAE,EAAE;CACjB,CAAC;AAEX;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,8CAA8C;IAC9C,4FAA4F;IAC5F,8DAA8D;IAC9D,wBAAwB,EAAE,GAAG,EAAE,wDAAwD;IACvF,2BAA2B,EAAE,GAAG,EAAE,yDAAyD;IAE3F,yCAAyC;IACzC,oEAAoE;IACpE,mBAAmB,EAAE,CAAC;IAEtB,oCAAoC;IACpC,oEAAoE;IACpE,oBAAoB,EAAE,CAAC;IAEvB,4FAA4F;IAC5F,4GAA4G;IAC5G,8EAA8E;IAC9E,yBAAyB,EAAE,GAAG;IAE9B,wDAAwD;IACxD,uDAAuD;IACvD,wDAAwD;IACxD,mBAAmB,EAAE,EAAE;CACf,CAAC;AAEX;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,iEAAiE;IACjE,cAAc,EAAE,gDAAgD;CACxD,CAAC;AAEX;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,qEAAqE;IACrE,gEAAgE;IAChE,gBAAgB,EAAE,CAAC;IACnB,yDAAyD;IACzD,+DAA+D;IAC/D,qBAAqB,EAAE,CAAC;IACxB,sEAAsE;IACtE,4EAA4E;IAC5E,kEAAkE;IAClE,oEAAoE;IACpE,oBAAoB,EAAE,CAAC;CACf,CAAC;AAEX;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,wBAAwB;IACxB,mBAAmB,EAAE,QAAiB;IACtC,gBAAgB,EAAE,MAAe;IAEjC,4EAA4E;IAC5E,UAAU,EAAE;QACV,MAAM,EAAE,QAAQ;QAChB,WAAW,EAAE,aAAa;QAC1B,YAAY,EAAE,cAAc;QAC5B,WAAW,EAAE,aAAa;KAClB;IAEV,8EAA8E;IAC9E,iBAAiB,EAAE;QACjB,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,mBAAmB,EAAE;QAClD,EAAE,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,yBAAyB,EAAE;QAC7D,EAAE,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,yBAAyB,EAAE;KACrD;IAEV,oCAAoC;IACpC,mEAAmE;IACnE,WAAW,EAAE;QACX;YACE,EAAE,EAAE,QAAQ;YACZ,QAAQ,EAAE,mBAAmB;YAC7B,KAAK,EAAE,QAAQ;YACf,SAAS,EAAE,MAAM;SAClB;QACD;YACE,EAAE,EAAE,aAAa;YACjB,QAAQ,EAAE,yBAAyB;YACnC,KAAK,EAAE,aAAa;YACpB,SAAS,EAAE,MAAM;SAClB;QACD;YACE,EAAE,EAAE,cAAc;YAClB,QAAQ,EAAE,0BAA0B;YACpC,KAAK,EAAE,cAAc;YACrB,SAAS,EAAE,MAAM;SAClB;QACD;YACE,EAAE,EAAE,aAAa;YACjB,QAAQ,EAAE,yBAAyB;YACnC,KAAK,EAAE,aAAa;YACpB,SAAS,EAAE,MAAM;SAClB;KACO;CACF,CAAC;AAUX;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,wDAAwD;IACxD,QAAQ,EAAE,CAAC;IACX,iEAAiE;IACjE,WAAW,EAAE,SAAS;IACtB,2DAA2D;IAC3D,oBAAoB,EAAE,GAAG;CACjB,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,uEAAuE;IACvE,eAAe,EAAE,aAAsB;IACvC,wEAAwE;IACxE,gBAAgB,EAAE,KAAK;CACf,CAAC;AAEX,0DAA0D;AAC1D,MAAM,CAAC,MAAM,wBAAwB,GAAG,0BAA0B,CAAC;AACnE,MAAM,CAAC,MAAM,0BAA0B,GAAG,4BAA4B,CAAC;AACvE,MAAM,CAAC,MAAM,4BAA4B,GAAG,KAAM,CAAC;AAEnD;;;;;;;GAOG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAGrC;IACC,OAAO,GAAG,KAAK,CAAC,cAAc,IAAI,eAAe,CAAC,eAAe,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC;AACjH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,qBAAqB,CACnC,UAAkB,EAClB,SAAkB;IAElB,MAAM,gBAAgB,GACpB,UAAU,KAAK,KAAK;QAClB,CAAC,CAAC,eAAe,CAAC,gBAAgB,IAAI,SAAS;QAC/C,CAAC,CAAC,SAAS,CAAC;IAChB,OAAO,GAAG,UAAU,IAAI,gBAAgB,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC;AACrE,CAAC","sourcesContent":["/**\n * Perps feature constants - Controller layer (portable)\n *\n * This file contains only controller-portable configuration:\n * - Constants used by controller logic, providers, and services\n * - Calculation thresholds, API configs, and protocol constants\n *\n * UI-only constants (layout, display, navigation) live in:\n * app/components/UI/Perps/constants/perpsConfig.ts\n */\nexport const ZERO_ADDRESS = '0x0000000000000000000000000000000000000000';\nexport const ZERO_BALANCE = '0x0';\n\nexport const PERPS_CONSTANTS = {\n  FeatureFlagKey: 'perpsEnabled',\n  FeatureName: 'perps', // Constant for Sentry error filtering - enables \"feature:perps\" dashboard queries\n  /** Token description used to identify the synthetic \"Perps balance\" option in pay-with token lists */\n  PerpsBalanceTokenDescription: 'perps-balance',\n  /** Symbol displayed for the synthetic \"Perps balance\" token in pay-with token lists */\n  PerpsBalanceTokenSymbol: 'USD',\n  WebsocketTimeout: 5000, // 5 seconds\n  WebsocketCleanupDelay: 1000, // 1 second\n  BackgroundDisconnectDelay: 20_000, // 20 seconds delay before disconnecting when app is backgrounded or when user exits perps UX\n  ConnectionTimeoutMs: 10_000, // 10 seconds timeout for connection and position loading states\n  DefaultMonitoringTimeoutMs: 10_000, // 10 seconds default timeout for data monitoring operations\n\n  // Connection timing constants\n  ConnectionGracePeriodMs: 20_000, // 20 seconds grace period before actual disconnection (same as BackgroundDisconnectDelay for semantic clarity)\n  ConnectionAttemptTimeoutMs: 30_000, // 30 seconds timeout for connection attempts to prevent indefinite hanging\n  WebsocketPingTimeoutMs: 5_000, // 5 seconds timeout for WebSocket health check ping\n  ConnectRetryDelayMs: 200, // Delay before retrying connect() when connection isn't ready yet\n  ForegroundPingRetryDelayMs: 500, // Delay before retrying ping in resumeFromForeground — JS thread may be sluggish right after foregrounding\n  ReconnectionCleanupDelayMs: 500, // Platform-agnostic delay to ensure WebSocket is ready\n  ReconnectionDelayAndroidMs: 300, // Android-specific reconnection delay for better reliability on slower devices\n  ReconnectionDelayIosMs: 100, // iOS-specific reconnection delay for optimal performance\n  ReconnectionRetryDelayMs: 5_000, // 5 seconds delay between reconnection attempts\n  NetworkRestoreMaxRetries: 8, // Max retry attempts when reconnecting after WiFi/network restore\n  NetworkRestoreRetryBaseMs: 1_500, // Base delay (ms) between network restore retries (multiplied by attempt number)\n\n  // Connection manager timing constants\n  BalanceUpdateThrottleMs: 15000, // Update at most every 15 seconds to reduce state updates in PerpsConnectionManager\n  InitialDataDelayMs: 100, // Delay to allow initial data to load after connection establishment\n\n  // Deposit toast timing\n  DepositTakingLongerToastDelayMs: 30_000, // Delay before showing \"Deposit taking longer than usual\" toast\n\n  DefaultAssetPreviewLimit: 5,\n  DefaultMaxLeverage: 3 as number, // Default fallback max leverage when market data is unavailable - conservative default\n  FallbackPriceDisplay: '$---', // Display when price data is unavailable\n  FallbackPercentageDisplay: '--%', // Display when change data is unavailable\n  FallbackDataDisplay: '--', // Display when non-price data is unavailable\n  ZeroAmountDisplay: '$0', // Display for zero dollar amounts (e.g., no volume)\n  ZeroAmountDetailedDisplay: '$0.00', // Display for zero dollar amounts with decimals\n\n  RecentActivityLimit: 3,\n\n  // Historical data fetching constants\n  FillsLookbackMs: 90 * 24 * 60 * 60 * 1000, // 3 months in milliseconds - limits REST API fills fetch\n} as const;\n\n/**\n * Withdrawal-specific constants (protocol-agnostic)\n * Note: Protocol-specific values like estimated time should be defined in each protocol's config\n */\nexport const WITHDRAWAL_CONSTANTS = {\n  DefaultMinAmount: '1.01', // Default minimum withdrawal amount in USDC\n  DefaultFeeAmount: 1, // Default withdrawal fee in USDC\n  DefaultFeeToken: 'USDC', // Default fee token\n} as const;\n\n/**\n * Validation thresholds for UI warnings and checks\n * These values control when warnings are shown to users\n */\nexport const VALIDATION_THRESHOLDS = {\n  // Leverage threshold for warning users about high leverage\n  HighLeverageWarning: 20, // Show warning when leverage > 20x\n\n  // Limit price difference threshold (as decimal, 0.1 = 10%)\n  LimitPriceDifferenceWarning: 0.1, // Warn if limit price differs by >10% from current price\n\n  // Price deviation threshold (as decimal, 0.1 = 10%)\n  PriceDeviation: 0.1, // Warn if perps price deviates by >10% from spot price\n} as const;\n\n/**\n * Order slippage configuration\n * Controls default slippage tolerance for different order types\n * Conservative defaults based on HyperLiquid platform interface\n * See: docs/perps/hyperliquid/ORDER-MATCHING-ERRORS.md\n */\nexport const ORDER_SLIPPAGE_CONFIG = {\n  // Market order slippage (basis points)\n  // 300 basis points = 3% = 0.03 decimal\n  // Conservative default for measured rollout, prevents most IOC failures\n  DefaultMarketSlippageBps: 300,\n\n  // TP/SL order slippage (basis points)\n  // 1000 basis points = 10% = 0.10 decimal\n  // Aligns with HyperLiquid platform default for triggered orders\n  DefaultTpslSlippageBps: 1000,\n\n  // Limit order slippage (basis points)\n  // 100 basis points = 1% = 0.01 decimal\n  // Kept conservative as limit orders rest on book (not IOC/immediate execution)\n  DefaultLimitSlippageBps: 100,\n} as const;\n\n/**\n * Max order amount buffer to reduce \"Insufficient margin\" rejections from the exchange.\n * When the user selects 100% (slider or Max), we cap the order at (1 - this) of the\n * theoretical max so that fees, rounding, and exchange-side margin checks are covered.\n * Value as decimal (e.g. 0.005 = 0.5%).\n */\nexport const MAX_ORDER_MARGIN_BUFFER = 0.005; // 0.5%\n\n/**\n * Performance optimization constants\n * These values control debouncing and throttling for better performance\n */\nexport const PERFORMANCE_CONFIG = {\n  // Price updates debounce delay (milliseconds)\n  // Batches rapid WebSocket price updates to reduce re-renders\n  PriceUpdateDebounceMs: 1000,\n\n  // Order validation debounce delay (milliseconds)\n  // Prevents excessive validation calls during rapid form input changes\n  ValidationDebounceMs: 300,\n\n  // Liquidation price debounce delay (milliseconds)\n  // Prevents excessive liquidation price calls during rapid form input changes\n  LiquidationPriceDebounceMs: 500,\n\n  // Candle subscription debounce delay (milliseconds)\n  // Prevents WS subscription churn during rapid market switching (#28141)\n  CandleConnectDebounceMs: 500,\n\n  // Navigation params delay (milliseconds)\n  // Required for React Navigation to complete state transitions before setting params\n  // This ensures navigation context is available when programmatically selecting tabs\n  NavigationParamsDelayMs: 200,\n\n  // Tab control reset delay (milliseconds)\n  // Delay to reset programmatic tab control after tab switching to prevent render loops\n  TabControlResetDelayMs: 500,\n\n  // Market data cache duration (milliseconds)\n  // How long to cache market list data before fetching fresh data\n  MarketDataCacheDurationMs: 5 * 60 * 1000, // 5 minutes\n\n  // Asset metadata cache duration (milliseconds)\n  // How long to cache asset icon validation results\n  AssetMetadataCacheDurationMs: 60 * 60 * 1000, // 1 hour\n\n  // Max leverage cache duration (milliseconds)\n  // How long to cache max leverage values per asset (leverage rarely changes)\n  MaxLeverageCacheDurationMs: 60 * 60 * 1000, // 1 hour\n\n  // Rewards cache durations (milliseconds)\n  // How long to cache fee discount data from rewards API\n  FeeDiscountCacheDurationMs: 5 * 60 * 1000, // 5 minutes\n  // How long to cache points calculation parameters from rewards API\n  PointsCalculationCacheDurationMs: 5 * 60 * 1000, // 5 minutes\n\n  /**\n   * Performance logging markers for filtering logs during development and debugging\n   * These markers help isolate performance-related logs from general application logs\n   * Usage: Use in DevLogger calls to easily filter specific performance areas\n   * Impact: Development only (uses DevLogger) - zero production performance cost\n   *\n   * Examples:\n   * - Filter Sentry performance logs: `adb logcat | grep PERPSMARK_SENTRY`\n   * - Filter MetaMetrics events: `adb logcat | grep PERPSMARK_METRICS`\n   * - Filter WebSocket performance: `adb logcat | grep PERPSMARK_WS`\n   * - Filter all Perps performance: `adb logcat | grep PERPSMARK_`\n   */\n  LoggingMarkers: {\n    // Sentry performance measurement logs (screen loads, bottom sheets, API timing)\n    SentryPerformance: 'PERPSMARK_SENTRY',\n\n    // MetaMetrics event tracking logs (user interactions, business analytics)\n    MetametricsEvents: 'PERPSMARK_METRICS',\n\n    // WebSocket performance logs (connection timing, data flow, reconnections)\n    WebsocketPerformance: 'PERPSMARK_SENTRY_WS',\n  } as const,\n} as const;\n\nexport const TP_SL_CONFIG = {\n  UsePositionBoundTpsl: true,\n} as const;\n\n/**\n * HyperLiquid order limits based on leverage\n * From: https://hyperliquid.gitbook.io/hyperliquid-docs/trading/contract-specifications\n */\nexport const HYPERLIQUID_ORDER_LIMITS = {\n  // Market orders\n  MarketOrderLimits: {\n    // $15,000,000 for max leverage >= 25\n    HighLeverage: 15_000_000,\n    // $5,000,000 for max leverage in [20, 25)\n    MediumHighLeverage: 5_000_000,\n    // $2,000,000 for max leverage in [10, 20)\n    MediumLeverage: 2_000_000,\n    // $500,000 for max leverage < 10\n    LowLeverage: 500_000,\n  },\n  // Limit orders are 10x market order limits\n  LimitOrderMultiplier: 10,\n} as const;\n\n/**\n * Close position configuration\n * Controls behavior and constants specific to position closing\n */\nexport const CLOSE_POSITION_CONFIG = {\n  // Decimal places for USD amount input display\n  UsdDecimalPlaces: 2,\n\n  // Default close percentage when opening the close position view\n  DefaultClosePercentage: 100,\n\n  // Precision for position size calculations to prevent rounding errors\n  AmountCalculationPrecision: 6,\n\n  // Throttle delay for real-time price updates during position closing\n  PriceThrottleMs: 3000,\n\n  // Fallback decimal places for tokens without metadata\n  FallbackTokenDecimals: 18,\n} as const;\n\n/**\n * Margin adjustment configuration\n * Controls behavior for adding/removing margin from positions\n */\nexport const MARGIN_ADJUSTMENT_CONFIG = {\n  // Risk thresholds for margin removal warnings\n  // Threshold values represent ratio of (price distance to liquidation) / (liquidation price)\n  // Values < 1.0 mean price is dangerously close to liquidation\n  LiquidationRiskThreshold: 1.2, // 20% buffer before liquidation - triggers danger state\n  LiquidationWarningThreshold: 1.5, // 50% buffer before liquidation - triggers warning state\n\n  // Minimum margin adjustment amount (USD)\n  // Prevents dust adjustments and ensures meaningful position changes\n  MinAdjustmentAmount: 1,\n\n  // Precision for margin calculations\n  // Ensures accurate decimal handling in margin/leverage calculations\n  CalculationPrecision: 6,\n\n  // Safety buffer for margin removal to account for HyperLiquid's transfer margin requirement\n  // HyperLiquid enforces: transfer_margin_required = max(initial_margin_required, 0.1 * total_position_value)\n  // See: https://hyperliquid.gitbook.io/hyperliquid-docs/trading/margin-and-pnl\n  MarginRemovalSafetyBuffer: 0.1,\n\n  // Fallback max leverage when market data is unavailable\n  // Conservative value to prevent over-removal of margin\n  // Most HyperLiquid assets support at least 50x leverage\n  FallbackMaxLeverage: 50,\n} as const;\n\n/**\n * Data Lake API configuration\n * Endpoints for reporting perps trading activity for notifications\n */\nexport const DATA_LAKE_API_CONFIG = {\n  // Order reporting endpoint - only used for mainnet perps trading\n  OrdersEndpoint: 'https://perps.api.cx.metamask.io/api/v1/orders',\n} as const;\n\n/**\n * Decimal precision configuration\n * Controls maximum decimal places for price and input validation\n */\nexport const DECIMAL_PRECISION_CONFIG = {\n  // Maximum decimal places for price input (matches Hyperliquid limit)\n  // Used in TP/SL forms, limit price inputs, and price validation\n  MaxPriceDecimals: 6,\n  // Maximum significant figures allowed by HyperLiquid API\n  // Orders with more than 5 significant figures will be rejected\n  MaxSignificantFigures: 5,\n  // Defensive fallback for size decimals when market data fails to load\n  // Real szDecimals should always come from market data API (varies by asset)\n  // Using 6 as safe maximum to prevent crashes (covers most assets)\n  // NOTE: This is NOT semantically correct - just a defensive measure\n  FallbackSizeDecimals: 6,\n} as const;\n\n/**\n * Market sorting configuration\n * Controls sorting behavior and presets for the trending markets view\n */\nexport const MARKET_SORTING_CONFIG = {\n  // Default sort settings\n  DefaultSortOptionId: 'volume' as const,\n  DefaultDirection: 'desc' as const,\n\n  // Available sort fields (only includes fields supported by PerpsMarketData)\n  SortFields: {\n    Volume: 'volume',\n    PriceChange: 'priceChange',\n    OpenInterest: 'openInterest',\n    FundingRate: 'fundingRate',\n  } as const,\n\n  // Sort button presets for filter chips (simplified buttons without direction)\n  SortButtonPresets: [\n    { field: 'volume', labelKey: 'perps.sort.volume' },\n    { field: 'priceChange', labelKey: 'perps.sort.price_change' },\n    { field: 'fundingRate', labelKey: 'perps.sort.funding_rate' },\n  ] as const,\n\n  // Sort options for the bottom sheet\n  // All options support direction toggle (high-to-low / low-to-high)\n  SortOptions: [\n    {\n      id: 'volume',\n      labelKey: 'perps.sort.volume',\n      field: 'volume',\n      direction: 'desc',\n    },\n    {\n      id: 'priceChange',\n      labelKey: 'perps.sort.price_change',\n      field: 'priceChange',\n      direction: 'desc',\n    },\n    {\n      id: 'openInterest',\n      labelKey: 'perps.sort.open_interest',\n      field: 'openInterest',\n      direction: 'desc',\n    },\n    {\n      id: 'fundingRate',\n      labelKey: 'perps.sort.funding_rate',\n      field: 'fundingRate',\n      direction: 'desc',\n    },\n  ] as const,\n} as const;\n\n/**\n * Type for valid sort option IDs\n * Derived from SORT_OPTIONS to ensure type safety\n * Valid values: 'volume' | 'priceChange' | 'openInterest' | 'fundingRate'\n */\nexport type SortOptionId =\n  (typeof MARKET_SORTING_CONFIG.SortOptions)[number]['id'];\n\n/**\n * Funding rate display configuration\n * Controls how funding rates are formatted and displayed\n */\nexport const FUNDING_RATE_CONFIG = {\n  // Number of decimal places to display for funding rates\n  Decimals: 4,\n  // Default display value when funding rate is zero or unavailable\n  ZeroDisplay: '0.0000%',\n  // Multiplier to convert decimal funding rate to percentage\n  PercentageMultiplier: 100,\n} as const;\n\n/**\n * Provider configuration for multi-provider support\n */\nexport const PROVIDER_CONFIG = {\n  /** Default perpetual DEX provider when no explicit selection exists */\n  DefaultProvider: 'hyperliquid' as const,\n  /** Force MYX to testnet only (mainnet credentials not yet available) */\n  MYX_TESTNET_ONLY: false,\n} as const;\n\n// Disk-backed cold-start cache keys and throttle interval\nexport const PERPS_DISK_CACHE_MARKETS = 'PERPS_DISK_CACHE_MARKETS';\nexport const PERPS_DISK_CACHE_USER_DATA = 'PERPS_DISK_CACHE_USER_DATA';\nexport const PERPS_DISK_CACHE_THROTTLE_MS = 30_000;\n\n/**\n * Build the standard provider:network cache key from controller state.\n *\n * @param state - Controller state containing provider and network info.\n * @param state.activeProvider - Active perps provider name.\n * @param state.isTestnet - Whether testnet mode is active.\n * @returns Cache key in the format \"provider:mainnet\" or \"provider:testnet\".\n */\nexport function getProviderNetworkKey(state: {\n  activeProvider?: string;\n  isTestnet?: boolean;\n}): string {\n  return `${state.activeProvider ?? PROVIDER_CONFIG.DefaultProvider}:${state.isTestnet ? 'testnet' : 'mainnet'}`;\n}\n\n/**\n * Build a provider:network cache key for a specific provider id.\n * Accounts for MYX_TESTNET_ONLY: MYX is always on testnet regardless of the\n * global network flag.\n *\n * @param providerId - The provider identifier (e.g. \"hyperliquid\", \"myx\").\n * @param isTestnet - Global testnet flag from controller state.\n * @returns Cache key in the format \"provider:mainnet\" or \"provider:testnet\".\n */\nexport function buildProviderCacheKey(\n  providerId: string,\n  isTestnet: boolean,\n): string {\n  const effectiveTestnet =\n    providerId === 'myx'\n      ? PROVIDER_CONFIG.MYX_TESTNET_ONLY || isTestnet\n      : isTestnet;\n  return `${providerId}:${effectiveTestnet ? 'testnet' : 'mainnet'}`;\n}\n"]}
+{"version":3,"file":"perpsConfig.mjs","sourceRoot":"","sources":["../../src/constants/perpsConfig.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,4CAA4C,CAAC;AACzE,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,CAAC;AAElC,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,cAAc,EAAE,cAAc;IAC9B,WAAW,EAAE,OAAO,EAAE,kFAAkF;IACxG,sGAAsG;IACtG,4BAA4B,EAAE,eAAe;IAC7C,uFAAuF;IACvF,uBAAuB,EAAE,KAAK;IAC9B,gBAAgB,EAAE,IAAI,EAAE,YAAY;IACpC,qBAAqB,EAAE,IAAI,EAAE,WAAW;IACxC,yBAAyB,EAAE,KAAM,EAAE,6FAA6F;IAChI,mBAAmB,EAAE,KAAM,EAAE,gEAAgE;IAC7F,0BAA0B,EAAE,KAAM,EAAE,4DAA4D;IAEhG,8BAA8B;IAC9B,uBAAuB,EAAE,KAAM,EAAE,+GAA+G;IAChJ,0BAA0B,EAAE,KAAM,EAAE,2EAA2E;IAC/G,sBAAsB,EAAE,IAAK,EAAE,oDAAoD;IACnF,mBAAmB,EAAE,GAAG,EAAE,kEAAkE;IAC5F,0BAA0B,EAAE,GAAG,EAAE,2GAA2G;IAC5I,0BAA0B,EAAE,GAAG,EAAE,uDAAuD;IACxF,0BAA0B,EAAE,GAAG,EAAE,+EAA+E;IAChH,sBAAsB,EAAE,GAAG,EAAE,0DAA0D;IACvF,wBAAwB,EAAE,IAAK,EAAE,gDAAgD;IACjF,wBAAwB,EAAE,CAAC,EAAE,kEAAkE;IAC/F,yBAAyB,EAAE,IAAK,EAAE,iFAAiF;IAEnH,sCAAsC;IACtC,uBAAuB,EAAE,KAAK,EAAE,oFAAoF;IACpH,kBAAkB,EAAE,GAAG,EAAE,qEAAqE;IAE9F,uBAAuB;IACvB,+BAA+B,EAAE,KAAM,EAAE,gEAAgE;IAEzG,wBAAwB,EAAE,CAAC;IAC3B,kBAAkB,EAAE,CAAW,EAAE,uFAAuF;IACxH,oBAAoB,EAAE,MAAM,EAAE,yCAAyC;IACvE,yBAAyB,EAAE,KAAK,EAAE,0CAA0C;IAC5E,mBAAmB,EAAE,IAAI,EAAE,6CAA6C;IACxE,iBAAiB,EAAE,IAAI,EAAE,oDAAoD;IAC7E,yBAAyB,EAAE,OAAO,EAAE,gDAAgD;IAEpF,mBAAmB,EAAE,CAAC;IAEtB,qCAAqC;IACrC,eAAe,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,yDAAyD;CAC5F,CAAC;AAEX;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,gBAAgB,EAAE,MAAM,EAAE,4CAA4C;IACtE,gBAAgB,EAAE,CAAC,EAAE,iCAAiC;IACtD,eAAe,EAAE,MAAM,EAAE,oBAAoB;CACrC,CAAC;AAEX;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,2DAA2D;IAC3D,mBAAmB,EAAE,EAAE,EAAE,mCAAmC;IAE5D,2DAA2D;IAC3D,2BAA2B,EAAE,GAAG,EAAE,yDAAyD;IAE3F,oDAAoD;IACpD,cAAc,EAAE,GAAG,EAAE,uDAAuD;CACpE,CAAC;AAEX;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,uCAAuC;IACvC,uCAAuC;IACvC,wEAAwE;IACxE,wBAAwB,EAAE,GAAG;IAE7B,sCAAsC;IACtC,yCAAyC;IACzC,gEAAgE;IAChE,sBAAsB,EAAE,IAAI;IAE5B,sCAAsC;IACtC,uCAAuC;IACvC,+EAA+E;IAC/E,uBAAuB,EAAE,GAAG;CACpB,CAAC;AAEX;;;;;GAKG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,KAAK,CAAC,CAAC,OAAO;AAErD;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,8CAA8C;IAC9C,6DAA6D;IAC7D,qBAAqB,EAAE,IAAI;IAE3B,iDAAiD;IACjD,sEAAsE;IACtE,oBAAoB,EAAE,GAAG;IAEzB,kDAAkD;IAClD,6EAA6E;IAC7E,0BAA0B,EAAE,GAAG;IAE/B,oDAAoD;IACpD,wEAAwE;IACxE,uBAAuB,EAAE,GAAG;IAE5B,0CAA0C;IAC1C,8EAA8E;IAC9E,4EAA4E;IAC5E,yEAAyE;IACzE,qBAAqB,EAAE,GAAG;IAE1B,yCAAyC;IACzC,EAAE;IACF,4EAA4E;IAC5E,0EAA0E;IAC1E,sEAAsE;IACtE,4EAA4E;IAC5E,2CAA2C;IAC3C,EAAE;IACF,sEAAsE;IACtE,0EAA0E;IAC1E,0EAA0E;IAC1E,iFAAiF;IACjF,2EAA2E;IAC3E,yEAAyE;IACzE,0DAA0D;IAC1D,sBAAsB,EAAE,KAAM;IAE9B,oDAAoD;IACpD,0EAA0E;IAC1E,yEAAyE;IACzE,uEAAuE;IACvE,gEAAgE;IAChE,8CAA8C;IAC9C,wBAAwB,EAAE,KAAM;IAEhC,yCAAyC;IACzC,oFAAoF;IACpF,oFAAoF;IACpF,uBAAuB,EAAE,GAAG;IAE5B,yCAAyC;IACzC,sFAAsF;IACtF,sBAAsB,EAAE,GAAG;IAE3B,4CAA4C;IAC5C,gEAAgE;IAChE,yBAAyB,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI,EAAE,YAAY;IAEtD,+CAA+C;IAC/C,kDAAkD;IAClD,4BAA4B,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,SAAS;IAEvD,6CAA6C;IAC7C,4EAA4E;IAC5E,0BAA0B,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,SAAS;IAErD,yCAAyC;IACzC,uDAAuD;IACvD,0BAA0B,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI,EAAE,YAAY;IACvD,mEAAmE;IACnE,gCAAgC,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI,EAAE,YAAY;IAE7D;;;;;;;;;;;OAWG;IACH,cAAc,EAAE;QACd,gFAAgF;QAChF,iBAAiB,EAAE,kBAAkB;QAErC,0EAA0E;QAC1E,iBAAiB,EAAE,mBAAmB;QAEtC,2EAA2E;QAC3E,oBAAoB,EAAE,qBAAqB;KACnC;CACF,CAAC;AAEX,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,oBAAoB,EAAE,IAAI;CAClB,CAAC;AAEX;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,gBAAgB;IAChB,iBAAiB,EAAE;QACjB,qCAAqC;QACrC,YAAY,EAAE,QAAU;QACxB,0CAA0C;QAC1C,kBAAkB,EAAE,OAAS;QAC7B,0CAA0C;QAC1C,cAAc,EAAE,OAAS;QACzB,iCAAiC;QACjC,WAAW,EAAE,MAAO;KACrB;IACD,2CAA2C;IAC3C,oBAAoB,EAAE,EAAE;CAChB,CAAC;AAEX;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,8CAA8C;IAC9C,gBAAgB,EAAE,CAAC;IAEnB,gEAAgE;IAChE,sBAAsB,EAAE,GAAG;IAE3B,sEAAsE;IACtE,0BAA0B,EAAE,CAAC;IAE7B,qEAAqE;IACrE,eAAe,EAAE,IAAI;IAErB,sDAAsD;IACtD,qBAAqB,EAAE,EAAE;CACjB,CAAC;AAEX;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,8CAA8C;IAC9C,4FAA4F;IAC5F,8DAA8D;IAC9D,wBAAwB,EAAE,GAAG,EAAE,wDAAwD;IACvF,2BAA2B,EAAE,GAAG,EAAE,yDAAyD;IAE3F,yCAAyC;IACzC,oEAAoE;IACpE,mBAAmB,EAAE,CAAC;IAEtB,oCAAoC;IACpC,oEAAoE;IACpE,oBAAoB,EAAE,CAAC;IAEvB,4FAA4F;IAC5F,4GAA4G;IAC5G,8EAA8E;IAC9E,yBAAyB,EAAE,GAAG;IAE9B,wDAAwD;IACxD,uDAAuD;IACvD,wDAAwD;IACxD,mBAAmB,EAAE,EAAE;CACf,CAAC;AAEX;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,iEAAiE;IACjE,cAAc,EAAE,gDAAgD;CACxD,CAAC;AAEX;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,qEAAqE;IACrE,gEAAgE;IAChE,gBAAgB,EAAE,CAAC;IACnB,yDAAyD;IACzD,+DAA+D;IAC/D,qBAAqB,EAAE,CAAC;IACxB,sEAAsE;IACtE,4EAA4E;IAC5E,kEAAkE;IAClE,oEAAoE;IACpE,oBAAoB,EAAE,CAAC;CACf,CAAC;AAEX;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,wBAAwB;IACxB,mBAAmB,EAAE,QAAiB;IACtC,gBAAgB,EAAE,MAAe;IAEjC,4EAA4E;IAC5E,UAAU,EAAE;QACV,MAAM,EAAE,QAAQ;QAChB,WAAW,EAAE,aAAa;QAC1B,YAAY,EAAE,cAAc;QAC5B,WAAW,EAAE,aAAa;KAClB;IAEV,8EAA8E;IAC9E,iBAAiB,EAAE;QACjB,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,mBAAmB,EAAE;QAClD,EAAE,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,yBAAyB,EAAE;QAC7D,EAAE,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,yBAAyB,EAAE;KACrD;IAEV,oCAAoC;IACpC,mEAAmE;IACnE,WAAW,EAAE;QACX;YACE,EAAE,EAAE,QAAQ;YACZ,QAAQ,EAAE,mBAAmB;YAC7B,KAAK,EAAE,QAAQ;YACf,SAAS,EAAE,MAAM;SAClB;QACD;YACE,EAAE,EAAE,aAAa;YACjB,QAAQ,EAAE,yBAAyB;YACnC,KAAK,EAAE,aAAa;YACpB,SAAS,EAAE,MAAM;SAClB;QACD;YACE,EAAE,EAAE,cAAc;YAClB,QAAQ,EAAE,0BAA0B;YACpC,KAAK,EAAE,cAAc;YACrB,SAAS,EAAE,MAAM;SAClB;QACD;YACE,EAAE,EAAE,aAAa;YACjB,QAAQ,EAAE,yBAAyB;YACnC,KAAK,EAAE,aAAa;YACpB,SAAS,EAAE,MAAM;SAClB;KACO;CACF,CAAC;AAUX;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,wDAAwD;IACxD,QAAQ,EAAE,CAAC;IACX,iEAAiE;IACjE,WAAW,EAAE,SAAS;IACtB,2DAA2D;IAC3D,oBAAoB,EAAE,GAAG;CACjB,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,uEAAuE;IACvE,eAAe,EAAE,aAAsB;IACvC,wEAAwE;IACxE,gBAAgB,EAAE,KAAK;CACf,CAAC;AAEX,0DAA0D;AAC1D,MAAM,CAAC,MAAM,wBAAwB,GAAG,0BAA0B,CAAC;AACnE,MAAM,CAAC,MAAM,0BAA0B,GAAG,4BAA4B,CAAC;AACvE,MAAM,CAAC,MAAM,4BAA4B,GAAG,KAAM,CAAC;AAEnD;;;;;;;GAOG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAGrC;IACC,OAAO,GAAG,KAAK,CAAC,cAAc,IAAI,eAAe,CAAC,eAAe,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC;AACjH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,qBAAqB,CACnC,UAAkB,EAClB,SAAkB;IAElB,MAAM,gBAAgB,GACpB,UAAU,KAAK,KAAK;QAClB,CAAC,CAAC,eAAe,CAAC,gBAAgB,IAAI,SAAS;QAC/C,CAAC,CAAC,SAAS,CAAC;IAChB,OAAO,GAAG,UAAU,IAAI,gBAAgB,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC;AACrE,CAAC","sourcesContent":["/**\n * Perps feature constants - Controller layer (portable)\n *\n * This file contains only controller-portable configuration:\n * - Constants used by controller logic, providers, and services\n * - Calculation thresholds, API configs, and protocol constants\n *\n * UI-only constants (layout, display, navigation) live in:\n * app/components/UI/Perps/constants/perpsConfig.ts\n */\nexport const ZERO_ADDRESS = '0x0000000000000000000000000000000000000000';\nexport const ZERO_BALANCE = '0x0';\n\nexport const PERPS_CONSTANTS = {\n  FeatureFlagKey: 'perpsEnabled',\n  FeatureName: 'perps', // Constant for Sentry error filtering - enables \"feature:perps\" dashboard queries\n  /** Token description used to identify the synthetic \"Perps balance\" option in pay-with token lists */\n  PerpsBalanceTokenDescription: 'perps-balance',\n  /** Symbol displayed for the synthetic \"Perps balance\" token in pay-with token lists */\n  PerpsBalanceTokenSymbol: 'USD',\n  WebsocketTimeout: 5000, // 5 seconds\n  WebsocketCleanupDelay: 1000, // 1 second\n  BackgroundDisconnectDelay: 20_000, // 20 seconds delay before disconnecting when app is backgrounded or when user exits perps UX\n  ConnectionTimeoutMs: 10_000, // 10 seconds timeout for connection and position loading states\n  DefaultMonitoringTimeoutMs: 10_000, // 10 seconds default timeout for data monitoring operations\n\n  // Connection timing constants\n  ConnectionGracePeriodMs: 20_000, // 20 seconds grace period before actual disconnection (same as BackgroundDisconnectDelay for semantic clarity)\n  ConnectionAttemptTimeoutMs: 30_000, // 30 seconds timeout for connection attempts to prevent indefinite hanging\n  WebsocketPingTimeoutMs: 5_000, // 5 seconds timeout for WebSocket health check ping\n  ConnectRetryDelayMs: 200, // Delay before retrying connect() when connection isn't ready yet\n  ForegroundPingRetryDelayMs: 500, // Delay before retrying ping in resumeFromForeground — JS thread may be sluggish right after foregrounding\n  ReconnectionCleanupDelayMs: 500, // Platform-agnostic delay to ensure WebSocket is ready\n  ReconnectionDelayAndroidMs: 300, // Android-specific reconnection delay for better reliability on slower devices\n  ReconnectionDelayIosMs: 100, // iOS-specific reconnection delay for optimal performance\n  ReconnectionRetryDelayMs: 5_000, // 5 seconds delay between reconnection attempts\n  NetworkRestoreMaxRetries: 8, // Max retry attempts when reconnecting after WiFi/network restore\n  NetworkRestoreRetryBaseMs: 1_500, // Base delay (ms) between network restore retries (multiplied by attempt number)\n\n  // Connection manager timing constants\n  BalanceUpdateThrottleMs: 15000, // Update at most every 15 seconds to reduce state updates in PerpsConnectionManager\n  InitialDataDelayMs: 100, // Delay to allow initial data to load after connection establishment\n\n  // Deposit toast timing\n  DepositTakingLongerToastDelayMs: 30_000, // Delay before showing \"Deposit taking longer than usual\" toast\n\n  DefaultAssetPreviewLimit: 5,\n  DefaultMaxLeverage: 3 as number, // Default fallback max leverage when market data is unavailable - conservative default\n  FallbackPriceDisplay: '$---', // Display when price data is unavailable\n  FallbackPercentageDisplay: '--%', // Display when change data is unavailable\n  FallbackDataDisplay: '--', // Display when non-price data is unavailable\n  ZeroAmountDisplay: '$0', // Display for zero dollar amounts (e.g., no volume)\n  ZeroAmountDetailedDisplay: '$0.00', // Display for zero dollar amounts with decimals\n\n  RecentActivityLimit: 3,\n\n  // Historical data fetching constants\n  FillsLookbackMs: 90 * 24 * 60 * 60 * 1000, // 3 months in milliseconds - limits REST API fills fetch\n} as const;\n\n/**\n * Withdrawal-specific constants (protocol-agnostic)\n * Note: Protocol-specific values like estimated time should be defined in each protocol's config\n */\nexport const WITHDRAWAL_CONSTANTS = {\n  DefaultMinAmount: '1.01', // Default minimum withdrawal amount in USDC\n  DefaultFeeAmount: 1, // Default withdrawal fee in USDC\n  DefaultFeeToken: 'USDC', // Default fee token\n} as const;\n\n/**\n * Validation thresholds for UI warnings and checks\n * These values control when warnings are shown to users\n */\nexport const VALIDATION_THRESHOLDS = {\n  // Leverage threshold for warning users about high leverage\n  HighLeverageWarning: 20, // Show warning when leverage > 20x\n\n  // Limit price difference threshold (as decimal, 0.1 = 10%)\n  LimitPriceDifferenceWarning: 0.1, // Warn if limit price differs by >10% from current price\n\n  // Price deviation threshold (as decimal, 0.1 = 10%)\n  PriceDeviation: 0.1, // Warn if perps price deviates by >10% from spot price\n} as const;\n\n/**\n * Order slippage configuration\n * Controls default slippage tolerance for different order types\n * Conservative defaults based on HyperLiquid platform interface\n * See: docs/perps/hyperliquid/ORDER-MATCHING-ERRORS.md\n */\nexport const ORDER_SLIPPAGE_CONFIG = {\n  // Market order slippage (basis points)\n  // 300 basis points = 3% = 0.03 decimal\n  // Conservative default for measured rollout, prevents most IOC failures\n  DefaultMarketSlippageBps: 300,\n\n  // TP/SL order slippage (basis points)\n  // 1000 basis points = 10% = 0.10 decimal\n  // Aligns with HyperLiquid platform default for triggered orders\n  DefaultTpslSlippageBps: 1000,\n\n  // Limit order slippage (basis points)\n  // 100 basis points = 1% = 0.01 decimal\n  // Kept conservative as limit orders rest on book (not IOC/immediate execution)\n  DefaultLimitSlippageBps: 100,\n} as const;\n\n/**\n * Max order amount buffer to reduce \"Insufficient margin\" rejections from the exchange.\n * When the user selects 100% (slider or Max), we cap the order at (1 - this) of the\n * theoretical max so that fees, rounding, and exchange-side margin checks are covered.\n * Value as decimal (e.g. 0.005 = 0.5%).\n */\nexport const MAX_ORDER_MARGIN_BUFFER = 0.005; // 0.5%\n\n/**\n * Performance optimization constants\n * These values control debouncing and throttling for better performance\n */\nexport const PERFORMANCE_CONFIG = {\n  // Price updates debounce delay (milliseconds)\n  // Batches rapid WebSocket price updates to reduce re-renders\n  PriceUpdateDebounceMs: 1000,\n\n  // Order validation debounce delay (milliseconds)\n  // Prevents excessive validation calls during rapid form input changes\n  ValidationDebounceMs: 300,\n\n  // Liquidation price debounce delay (milliseconds)\n  // Prevents excessive liquidation price calls during rapid form input changes\n  LiquidationPriceDebounceMs: 500,\n\n  // Candle subscription debounce delay (milliseconds)\n  // Prevents WS subscription churn during rapid market switching (#28141)\n  CandleConnectDebounceMs: 500,\n\n  // Candle WS teardown delay (milliseconds)\n  // When the last subscriber for a cacheKey unsubscribes, wait this long before\n  // tearing down the WS. A subsequent subscribe inside the window cancels the\n  // teardown so rapid back-and-forth switches do not churn the connection.\n  CandleTeardownDelayMs: 150,\n\n  // Perps REST coalesce TTL (milliseconds)\n  //\n  // Window in which identical GET-style REST calls (getOrderFills, getOrders,\n  // getFunding, historicalOrders) share a single in-flight promise / cached\n  // result. `forceRefresh` still bypasses the cache end-to-end (hooks →\n  // controller → MarketDataService → provider → HyperLiquidClientService), so\n  // pull-to-refresh always hits the network.\n  //\n  // Why 60 s: HyperLiquid's documented rate limit is 1200 weight / IP /\n  // rolling 60 s window. Sizing TTL = window length caps each endpoint-per-\n  // account at ≤1 REST hit per window under any UI activity pattern — rapid\n  // market switching, re-mounts (usePerpsMarketFills, usePerpsTransactionHistory),\n  // and multi-tab scans all share a single request. Live fills/orders/prices\n  // still flow via WS subscriptions, so REST is seed/backfill only — cache\n  // staleness inside the 60 s window is never user-visible.\n  PerpsRestCoalesceTtlMs: 60_000,\n\n  // Candle snapshot REST coalesce TTL (milliseconds).\n  // Longer than PerpsRestCoalesceTtlMs because WS stream keeps live candles\n  // fresh — the REST snapshot only seeds the chart on initial subscribe. A\n  // 30 s window lets rapid market switching (pass 1 → pass 2 of a stress\n  // loop) share the same snapshot per (symbol, interval), cutting\n  // candleSnapshot REST weight roughly in half.\n  PerpsCandleCoalesceTtlMs: 30_000,\n\n  // Navigation params delay (milliseconds)\n  // Required for React Navigation to complete state transitions before setting params\n  // This ensures navigation context is available when programmatically selecting tabs\n  NavigationParamsDelayMs: 200,\n\n  // Tab control reset delay (milliseconds)\n  // Delay to reset programmatic tab control after tab switching to prevent render loops\n  TabControlResetDelayMs: 500,\n\n  // Market data cache duration (milliseconds)\n  // How long to cache market list data before fetching fresh data\n  MarketDataCacheDurationMs: 5 * 60 * 1000, // 5 minutes\n\n  // Asset metadata cache duration (milliseconds)\n  // How long to cache asset icon validation results\n  AssetMetadataCacheDurationMs: 60 * 60 * 1000, // 1 hour\n\n  // Max leverage cache duration (milliseconds)\n  // How long to cache max leverage values per asset (leverage rarely changes)\n  MaxLeverageCacheDurationMs: 60 * 60 * 1000, // 1 hour\n\n  // Rewards cache durations (milliseconds)\n  // How long to cache fee discount data from rewards API\n  FeeDiscountCacheDurationMs: 5 * 60 * 1000, // 5 minutes\n  // How long to cache points calculation parameters from rewards API\n  PointsCalculationCacheDurationMs: 5 * 60 * 1000, // 5 minutes\n\n  /**\n   * Performance logging markers for filtering logs during development and debugging\n   * These markers help isolate performance-related logs from general application logs\n   * Usage: Use in DevLogger calls to easily filter specific performance areas\n   * Impact: Development only (uses DevLogger) - zero production performance cost\n   *\n   * Examples:\n   * - Filter Sentry performance logs: `adb logcat | grep PERPSMARK_SENTRY`\n   * - Filter MetaMetrics events: `adb logcat | grep PERPSMARK_METRICS`\n   * - Filter WebSocket performance: `adb logcat | grep PERPSMARK_WS`\n   * - Filter all Perps performance: `adb logcat | grep PERPSMARK_`\n   */\n  LoggingMarkers: {\n    // Sentry performance measurement logs (screen loads, bottom sheets, API timing)\n    SentryPerformance: 'PERPSMARK_SENTRY',\n\n    // MetaMetrics event tracking logs (user interactions, business analytics)\n    MetametricsEvents: 'PERPSMARK_METRICS',\n\n    // WebSocket performance logs (connection timing, data flow, reconnections)\n    WebsocketPerformance: 'PERPSMARK_SENTRY_WS',\n  } as const,\n} as const;\n\nexport const TP_SL_CONFIG = {\n  UsePositionBoundTpsl: true,\n} as const;\n\n/**\n * HyperLiquid order limits based on leverage\n * From: https://hyperliquid.gitbook.io/hyperliquid-docs/trading/contract-specifications\n */\nexport const HYPERLIQUID_ORDER_LIMITS = {\n  // Market orders\n  MarketOrderLimits: {\n    // $15,000,000 for max leverage >= 25\n    HighLeverage: 15_000_000,\n    // $5,000,000 for max leverage in [20, 25)\n    MediumHighLeverage: 5_000_000,\n    // $2,000,000 for max leverage in [10, 20)\n    MediumLeverage: 2_000_000,\n    // $500,000 for max leverage < 10\n    LowLeverage: 500_000,\n  },\n  // Limit orders are 10x market order limits\n  LimitOrderMultiplier: 10,\n} as const;\n\n/**\n * Close position configuration\n * Controls behavior and constants specific to position closing\n */\nexport const CLOSE_POSITION_CONFIG = {\n  // Decimal places for USD amount input display\n  UsdDecimalPlaces: 2,\n\n  // Default close percentage when opening the close position view\n  DefaultClosePercentage: 100,\n\n  // Precision for position size calculations to prevent rounding errors\n  AmountCalculationPrecision: 6,\n\n  // Throttle delay for real-time price updates during position closing\n  PriceThrottleMs: 3000,\n\n  // Fallback decimal places for tokens without metadata\n  FallbackTokenDecimals: 18,\n} as const;\n\n/**\n * Margin adjustment configuration\n * Controls behavior for adding/removing margin from positions\n */\nexport const MARGIN_ADJUSTMENT_CONFIG = {\n  // Risk thresholds for margin removal warnings\n  // Threshold values represent ratio of (price distance to liquidation) / (liquidation price)\n  // Values < 1.0 mean price is dangerously close to liquidation\n  LiquidationRiskThreshold: 1.2, // 20% buffer before liquidation - triggers danger state\n  LiquidationWarningThreshold: 1.5, // 50% buffer before liquidation - triggers warning state\n\n  // Minimum margin adjustment amount (USD)\n  // Prevents dust adjustments and ensures meaningful position changes\n  MinAdjustmentAmount: 1,\n\n  // Precision for margin calculations\n  // Ensures accurate decimal handling in margin/leverage calculations\n  CalculationPrecision: 6,\n\n  // Safety buffer for margin removal to account for HyperLiquid's transfer margin requirement\n  // HyperLiquid enforces: transfer_margin_required = max(initial_margin_required, 0.1 * total_position_value)\n  // See: https://hyperliquid.gitbook.io/hyperliquid-docs/trading/margin-and-pnl\n  MarginRemovalSafetyBuffer: 0.1,\n\n  // Fallback max leverage when market data is unavailable\n  // Conservative value to prevent over-removal of margin\n  // Most HyperLiquid assets support at least 50x leverage\n  FallbackMaxLeverage: 50,\n} as const;\n\n/**\n * Data Lake API configuration\n * Endpoints for reporting perps trading activity for notifications\n */\nexport const DATA_LAKE_API_CONFIG = {\n  // Order reporting endpoint - only used for mainnet perps trading\n  OrdersEndpoint: 'https://perps.api.cx.metamask.io/api/v1/orders',\n} as const;\n\n/**\n * Decimal precision configuration\n * Controls maximum decimal places for price and input validation\n */\nexport const DECIMAL_PRECISION_CONFIG = {\n  // Maximum decimal places for price input (matches Hyperliquid limit)\n  // Used in TP/SL forms, limit price inputs, and price validation\n  MaxPriceDecimals: 6,\n  // Maximum significant figures allowed by HyperLiquid API\n  // Orders with more than 5 significant figures will be rejected\n  MaxSignificantFigures: 5,\n  // Defensive fallback for size decimals when market data fails to load\n  // Real szDecimals should always come from market data API (varies by asset)\n  // Using 6 as safe maximum to prevent crashes (covers most assets)\n  // NOTE: This is NOT semantically correct - just a defensive measure\n  FallbackSizeDecimals: 6,\n} as const;\n\n/**\n * Market sorting configuration\n * Controls sorting behavior and presets for the trending markets view\n */\nexport const MARKET_SORTING_CONFIG = {\n  // Default sort settings\n  DefaultSortOptionId: 'volume' as const,\n  DefaultDirection: 'desc' as const,\n\n  // Available sort fields (only includes fields supported by PerpsMarketData)\n  SortFields: {\n    Volume: 'volume',\n    PriceChange: 'priceChange',\n    OpenInterest: 'openInterest',\n    FundingRate: 'fundingRate',\n  } as const,\n\n  // Sort button presets for filter chips (simplified buttons without direction)\n  SortButtonPresets: [\n    { field: 'volume', labelKey: 'perps.sort.volume' },\n    { field: 'priceChange', labelKey: 'perps.sort.price_change' },\n    { field: 'fundingRate', labelKey: 'perps.sort.funding_rate' },\n  ] as const,\n\n  // Sort options for the bottom sheet\n  // All options support direction toggle (high-to-low / low-to-high)\n  SortOptions: [\n    {\n      id: 'volume',\n      labelKey: 'perps.sort.volume',\n      field: 'volume',\n      direction: 'desc',\n    },\n    {\n      id: 'priceChange',\n      labelKey: 'perps.sort.price_change',\n      field: 'priceChange',\n      direction: 'desc',\n    },\n    {\n      id: 'openInterest',\n      labelKey: 'perps.sort.open_interest',\n      field: 'openInterest',\n      direction: 'desc',\n    },\n    {\n      id: 'fundingRate',\n      labelKey: 'perps.sort.funding_rate',\n      field: 'fundingRate',\n      direction: 'desc',\n    },\n  ] as const,\n} as const;\n\n/**\n * Type for valid sort option IDs\n * Derived from SORT_OPTIONS to ensure type safety\n * Valid values: 'volume' | 'priceChange' | 'openInterest' | 'fundingRate'\n */\nexport type SortOptionId =\n  (typeof MARKET_SORTING_CONFIG.SortOptions)[number]['id'];\n\n/**\n * Funding rate display configuration\n * Controls how funding rates are formatted and displayed\n */\nexport const FUNDING_RATE_CONFIG = {\n  // Number of decimal places to display for funding rates\n  Decimals: 4,\n  // Default display value when funding rate is zero or unavailable\n  ZeroDisplay: '0.0000%',\n  // Multiplier to convert decimal funding rate to percentage\n  PercentageMultiplier: 100,\n} as const;\n\n/**\n * Provider configuration for multi-provider support\n */\nexport const PROVIDER_CONFIG = {\n  /** Default perpetual DEX provider when no explicit selection exists */\n  DefaultProvider: 'hyperliquid' as const,\n  /** Force MYX to testnet only (mainnet credentials not yet available) */\n  MYX_TESTNET_ONLY: false,\n} as const;\n\n// Disk-backed cold-start cache keys and throttle interval\nexport const PERPS_DISK_CACHE_MARKETS = 'PERPS_DISK_CACHE_MARKETS';\nexport const PERPS_DISK_CACHE_USER_DATA = 'PERPS_DISK_CACHE_USER_DATA';\nexport const PERPS_DISK_CACHE_THROTTLE_MS = 30_000;\n\n/**\n * Build the standard provider:network cache key from controller state.\n *\n * @param state - Controller state containing provider and network info.\n * @param state.activeProvider - Active perps provider name.\n * @param state.isTestnet - Whether testnet mode is active.\n * @returns Cache key in the format \"provider:mainnet\" or \"provider:testnet\".\n */\nexport function getProviderNetworkKey(state: {\n  activeProvider?: string;\n  isTestnet?: boolean;\n}): string {\n  return `${state.activeProvider ?? PROVIDER_CONFIG.DefaultProvider}:${state.isTestnet ? 'testnet' : 'mainnet'}`;\n}\n\n/**\n * Build a provider:network cache key for a specific provider id.\n * Accounts for MYX_TESTNET_ONLY: MYX is always on testnet regardless of the\n * global network flag.\n *\n * @param providerId - The provider identifier (e.g. \"hyperliquid\", \"myx\").\n * @param isTestnet - Global testnet flag from controller state.\n * @returns Cache key in the format \"provider:mainnet\" or \"provider:testnet\".\n */\nexport function buildProviderCacheKey(\n  providerId: string,\n  isTestnet: boolean,\n): string {\n  const effectiveTestnet =\n    providerId === 'myx'\n      ? PROVIDER_CONFIG.MYX_TESTNET_ONLY || isTestnet\n      : isTestnet;\n  return `${providerId}:${effectiveTestnet ? 'testnet' : 'mainnet'}`;\n}\n"]}

package/dist/providers/AggregatedPerpsProvider.cjs

@@ -137,9 +137,9 @@ class AggregatedPerpsProvider {
         }));
         return __classPrivateFieldGet(this, _AggregatedPerpsProvider_instances, "m", _AggregatedPerpsProvider_extractSuccessfulResults).call(this, results, 'getMarketDataWithPrices').flat();
     }
-    async getOrderFills(params) {
+    async getOrderFills(params, options) {
         const results = await Promise.allSettled(__classPrivateFieldGet(this, _AggregatedPerpsProvider_instances, "m", _AggregatedPerpsProvider_getActiveProviders).call(this).map(async ([id, provider]) => {
-            const fills = await provider.getOrderFills(params);
+            const fills = await provider.getOrderFills(params, options);
             return fills.map((fill) => ({ ...fill, providerId: id }));
         }));
         return __classPrivateFieldGet(this, _AggregatedPerpsProvider_instances, "m", _AggregatedPerpsProvider_extractSuccessfulResults).call(this, results, 'getOrderFills').flat();
@@ -151,9 +151,9 @@ class AggregatedPerpsProvider {
         }));
         return __classPrivateFieldGet(this, _AggregatedPerpsProvider_instances, "m", _AggregatedPerpsProvider_extractSuccessfulResults).call(this, results, 'getOrFetchFills').flat();
     }
-    async getOrders(params) {
+    async getOrders(params, options) {
         const results = await Promise.allSettled(__classPrivateFieldGet(this, _AggregatedPerpsProvider_instances, "m", _AggregatedPerpsProvider_getActiveProviders).call(this).map(async ([id, provider]) => {
-            const orders = await provider.getOrders(params);
+            const orders = await provider.getOrders(params, options);
             return orders.map((order) => ({ ...order, providerId: id }));
         }));
         return __classPrivateFieldGet(this, _AggregatedPerpsProvider_instances, "m", _AggregatedPerpsProvider_extractSuccessfulResults).call(this, results, 'getOrders').flat();
@@ -165,9 +165,9 @@ class AggregatedPerpsProvider {
         }));
         return __classPrivateFieldGet(this, _AggregatedPerpsProvider_instances, "m", _AggregatedPerpsProvider_extractSuccessfulResults).call(this, results, 'getOpenOrders').flat();
     }
-    async getFunding(params) {
+    async getFunding(params, options) {
         const results = await Promise.allSettled(__classPrivateFieldGet(this, _AggregatedPerpsProvider_instances, "m", _AggregatedPerpsProvider_getActiveProviders).call(this).map(async ([_providerId, provider]) => {
-            const funding = await provider.getFunding(params);
+            const funding = await provider.getFunding(params, options);
             // Funding type doesn't have providerId - we could add it if needed
             return funding;
         }));
@@ -190,6 +190,16 @@ class AggregatedPerpsProvider {
         // Delegate to default provider (protocol-specific)
         return __classPrivateFieldGet(this, _AggregatedPerpsProvider_instances, "m", _AggregatedPerpsProvider_getDefaultProvider).call(this).getUserNonFundingLedgerUpdates(params);
     }
+    /**
+     * Resolve the currently selected CAIP account identifier. Accounts are
+     * shared across sub-providers (same InternalAccountController), so the
+     * default provider's view is authoritative.
+     *
+     * @returns Resolved CAIP account id from the default sub-provider.
+     */
+    async getCurrentAccountId() {
+        return __classPrivateFieldGet(this, _AggregatedPerpsProvider_instances, "m", _AggregatedPerpsProvider_getDefaultProvider).call(this).getCurrentAccountId();
+    }
     /**
      * Get user history from all providers.
      *