@metamask-previews/perps-controller 5.0.0-preview-4e0ae1bc9 → 5.0.0-preview-bd0d4d2e9

package/dist/constants/perpsConfig.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"perpsConfig.mjs","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"]}
+{"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,2DAA2D;AAC3D,0EAA0E;AAC1E,0EAA0E;AAC1E,uEAAuE;AACvE,yEAAyE;AACzE,2CAA2C;AAC3C,MAAM,CAAC,MAAM,wBAAwB,GAAG,0BAA0B,CAAC;AACnE,MAAM,CAAC,MAAM,0BAA0B,GAAG,+BAA+B,CAAC;AAC1E,MAAM,CAAC,MAAM,4BAA4B,GAAG,KAAM,CAAC;AAEnD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,oCAAoC,GAAG,KAAM,CAAC;AAE3D;;;;;;;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.\n// The user-data key ends in _V2 because the AccountState balance contract\n// changed (TAT-3047) and has no in-payload version field. Bumping the key\n// forces a one-time empty cache on upgrade — consumers fall through to\n// skeleton/fallback until the first WS tick, avoiding stale legacy-shape\n// reads that would surface as $0 balances.\nexport const PERPS_DISK_CACHE_MARKETS = 'PERPS_DISK_CACHE_MARKETS';\nexport const PERPS_DISK_CACHE_USER_DATA = 'PERPS_DISK_CACHE_USER_DATA_V2';\nexport const PERPS_DISK_CACHE_THROTTLE_MS = 30_000;\n\n/**\n * Minimum interval between WebSocket-triggered HL `userAbstraction`\n * refreshes. Balances picking up HL-web mode flips (Unified ↔ Standard)\n * promptly against burning REST quota on every spot tick. Covers the\n * observed user pattern of flipping mode once per session at most.\n */\nexport const ABSTRACTION_MODE_REFRESH_THROTTLE_MS = 60_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/HyperLiquidProvider.cjs

@@ -1253,6 +1253,16 @@ class HyperLiquidProvider {
                 amount: amountFloat,
                 ntli,
             });
+            // Guard: confirm spendableBalance can cover margin addition.
+            // spendableBalance is already mode-aware (includes free spot in Unified,
+            // excludes it in Standard), so no extra spot fetch needed.
+            if (amountFloat > 0) {
+                const accountState = await this.getAccountState();
+                const spendable = parseFloat(accountState.spendableBalance);
+                if (spendable < amountFloat) {
+                    throw new Error(`Insufficient balance for margin addition: need ${amountFloat}, available ${spendable.toFixed(2)}`);
+                }
+            }
             // Call SDK to update isolated margin
             const exchangeClient = __classPrivateFieldGet(this, _HyperLiquidProvider_clientService, "f").getExchangeClient();
             const result = await exchangeClient.updateIsolatedMargin({
@@ -1986,7 +1996,9 @@ class HyperLiquidProvider {
             const userAddress = await __classPrivateFieldGet(this, _HyperLiquidProvider_walletService, "f").getUserAddressWithDefault(params?.accountId);
             __classPrivateFieldGet(this, _HyperLiquidProvider_deps, "f").debugLogger.log('User address for account state:', userAddress);
             __classPrivateFieldGet(this, _HyperLiquidProvider_deps, "f").debugLogger.log('Network mode:', __classPrivateFieldGet(this, _HyperLiquidProvider_clientService, "f").isTestnetMode() ? 'TESTNET' : 'MAINNET');
-            // Get Spot balance (global, not DEX-specific) and Perps states across all DEXs.
+            // Get Spot balance, Perps states across DEXs, and the HL abstraction
+            // mode (Unified / Standard / Portfolio / DEX-abstraction). Mode decides
+            // whether spot USDC is perps collateral — see addSpotBalanceToAccountState.
             // One transient DEX failure should not blank the entire account state.
             const [spotStateResult, perpsStateResult, abstractionResult] = await Promise.allSettled([
                 infoClient.spotClearinghouseState({ user: userAddress }),
@@ -2042,15 +2054,14 @@ class HyperLiquidProvider {
                 const dexAccountState = (0, hyperLiquidAdapter_1.adaptAccountStateFromSDK)(result.data);
                 __classPrivateFieldGet(this, _HyperLiquidProvider_deps, "f").debugLogger.log(`DEX ${result.dex ?? 'main'} account state:`, {
                     totalBalance: dexAccountState.totalBalance,
-                    availableBalance: dexAccountState.availableBalance,
+                    spendableBalance: dexAccountState.spendableBalance,
+                    withdrawableBalance: dexAccountState.withdrawableBalance,
                     marginUsed: dexAccountState.marginUsed,
                     unrealizedPnl: dexAccountState.unrealizedPnl,
                 });
                 return dexAccountState;
             });
-            const aggregatedAccountState = (0, accountUtils_1.addSpotBalanceToAccountState)((0, accountUtils_1.aggregateAccountStates)(dexAccountStates), spotState, {
-                foldIntoCollateral: (0, hyperliquid_types_1.hyperLiquidModeFoldsSpot)(abstractionMode),
-            });
+            const aggregatedAccountState = (0, accountUtils_1.addSpotBalanceToAccountState)((0, accountUtils_1.aggregateAccountStates)(dexAccountStates), spotState, { foldIntoCollateral: (0, hyperliquid_types_1.hyperLiquidModeFoldsSpot)(abstractionMode) });
             // Build per-sub-account breakdown (HIP-3 DEXs map to sub-accounts)
             const subAccountBreakdown = {};
             perpsStateResults.forEach((result) => {
@@ -2058,7 +2069,8 @@ class HyperLiquidProvider {
                 const dexAccountState = (0, hyperLiquidAdapter_1.adaptAccountStateFromSDK)(perpsState);
                 const subAccountKey = dex ?? ''; // Empty string for main DEX
                 subAccountBreakdown[subAccountKey] = {
-                    availableBalance: dexAccountState.availableBalance,
+                    spendableBalance: dexAccountState.spendableBalance,
+                    withdrawableBalance: dexAccountState.withdrawableBalance,
                     totalBalance: dexAccountState.totalBalance,
                 };
             });
@@ -2730,14 +2742,10 @@ class HyperLiquidProvider {
             // Step 5: Validate amount against account balance
             __classPrivateFieldGet(this, _HyperLiquidProvider_deps, "f").debugLogger.log('HyperLiquidProvider: CHECKING ACCOUNT BALANCE');
             const accountState = await this.getAccountState();
-            // Release-branch bridge for Unified Account: availableToTradeBalance
-            // includes collateral HL can draw in target mode. The larger balance
-            // contract will replace this with an explicit withdrawableBalance field.
-            const availableBalance = parseFloat(accountState.availableToTradeBalance ?? accountState.availableBalance);
+            const withdrawableBalance = parseFloat(accountState.withdrawableBalance);
             __classPrivateFieldGet(this, _HyperLiquidProvider_deps, "f").debugLogger.log('HyperLiquidProvider: ACCOUNT BALANCE', {
-                availableBalance,
-                clearinghouseAvailableBalance: accountState.availableBalance,
-                availableToTradeBalance: accountState.availableToTradeBalance,
+                withdrawableBalance,
+                spendableBalance: accountState.spendableBalance,
                 totalBalance: accountState.totalBalance,
                 marginUsed: accountState.marginUsed,
                 unrealizedPnl: accountState.unrealizedPnl,
@@ -2753,16 +2761,20 @@ class HyperLiquidProvider {
             const withdrawAmount = parseFloat(params.amount);
             __classPrivateFieldGet(this, _HyperLiquidProvider_deps, "f").debugLogger.log('HyperLiquidProvider: WITHDRAWAL AMOUNT', {
                 requestedAmount: withdrawAmount,
-                availableBalance,
-                sufficientBalance: withdrawAmount <= availableBalance,
+                withdrawableBalance,
+                sufficientBalance: withdrawAmount <= withdrawableBalance,
             });
-            const balanceValidation = (0, hyperLiquidValidation_1.validateBalance)(withdrawAmount, availableBalance);
+            // Validate against withdrawableBalance — the mode-aware cap.
+            // No spot sweep: withdrawableBalance already reflects what withdraw3
+            // can pull. In Unified mode HL handles cross-wallet internally; in
+            // Standard mode spot is not withdrawable via perps.
+            const balanceValidation = (0, hyperLiquidValidation_1.validateBalance)(withdrawAmount, withdrawableBalance);
             if (!balanceValidation.isValid) {
                 __classPrivateFieldGet(this, _HyperLiquidProvider_deps, "f").debugLogger.log('HyperLiquidProvider: INSUFFICIENT BALANCE', {
                     error: balanceValidation.error,
                     requestedAmount: withdrawAmount,
-                    availableBalance,
-                    difference: withdrawAmount - availableBalance,
+                    withdrawableBalance,
+                    difference: withdrawAmount - withdrawableBalance,
                 });
                 throw new Error(balanceValidation.error);
             }
@@ -5244,7 +5256,7 @@ async function _HyperLiquidProvider_getBalanceForDex(params) {
         : { user: userAddress };
     const accountState = await infoClient.clearinghouseState(queryParams);
     const adapted = (0, hyperLiquidAdapter_1.adaptAccountStateFromSDK)(accountState);
-    return parseFloat(adapted.availableBalance);
+    return parseFloat(adapted.withdrawableBalance);
 }, _HyperLiquidProvider_findSourceDexWithBalance = 
 /**
  * Find source DEX with sufficient balance for transfer
@@ -5461,7 +5473,7 @@ async function _HyperLiquidProvider_calculateHip3RequiredMargin(params) {
         const existingIsLong = parseFloat(existingPosition.size) > 0;
         const orderIsLong = isBuy;
         if (existingIsLong === orderIsLong) {
-            // Increasing position - HyperLiquid validates availableBalance >= totalRequiredMargin
+            // Increasing position - HyperLiquid validates spendableBalance >= totalRequiredMargin
             // BEFORE reallocating existing locked margin. Must transfer TOTAL margin temporarily.
             const existingSize = Math.abs(parseFloat(existingPosition.size));
             const existingMargin = parseFloat(existingPosition.marginUsed);
@@ -5551,7 +5563,7 @@ async function _HyperLiquidProvider_handleHip3PostOrderRebalance(params) {
             try {
                 __classPrivateFieldGet(this, _HyperLiquidProvider_deps, "f").debugLogger.log('🔄 HyperLiquidProvider: Auto-rebalancing excess margin back to main DEX', {
                     dex: dexName,
-                    availableBalance: postOrderBalance.toFixed(2),
+                    spendableBalance: postOrderBalance.toFixed(2),
                     desiredBuffer: desiredBuffer.toFixed(2),
                     excessAmount: excessAmount.toFixed(2),
                     destinationDex: transferInfo.sourceDex,