@metamask-previews/perps-controller 5.0.0-preview-d6324f95d → 5.0.0-preview-938a7fe

package/CHANGELOG.md

@@ -7,6 +7,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Changed
+
+- **BREAKING:** Rename `AccountState.availableBalance` to `spendableBalance` and `AccountState.availableToTradeBalance` to `withdrawableBalance` for clearer semantics across abstraction modes ([#8678](https://github.com/MetaMask/core/pull/8678))
+- Mode-aware spot fold: `addSpotBalanceToAccountState` now folds free spot USDC into both `spendableBalance` and `withdrawableBalance` for Unified/Portfolio modes, while Standard/DEX-abstraction modes keep spot separate ([#8678](https://github.com/MetaMask/core/pull/8678))
+- Add throttled WS-driven `userAbstraction` refresh so HL-web mode flips propagate back without requiring a restart or account switch ([#8678](https://github.com/MetaMask/core/pull/8678))
+- Fix position direction display for flipped positions ([#8707](https://github.com/MetaMask/core/pull/8707))
+
 ## [5.0.0]
 
 ### Added

package/dist/constants/hyperLiquidConfig.cjs

@@ -352,7 +352,7 @@ exports.MAINNET_HIP3_CONFIG = {
  * HIP-3 margin management configuration
  * Controls margin buffers and auto-rebalance behavior for HIP-3 DEXes with isolated margin
  *
- * Background: HyperLiquid validates availableBalance >= totalRequiredMargin BEFORE reallocating
+ * Background: HyperLiquid validates spendableBalance >= totalRequiredMargin BEFORE reallocating
  * existing locked margin. This requires temporary over-funding when increasing positions,
  * followed by automatic cleanup to minimize locked capital.
  */

package/dist/constants/hyperLiquidConfig.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"hyperLiquidConfig.cjs","sourceRoot":"","sources":["../../src/constants/hyperLiquidConfig.ts"],"names":[],"mappings":"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","sourcesContent":["import type { CaipAssetId, CaipChainId, Hex } from '@metamask/utils';\n\nimport type {\n  HyperLiquidNetwork,\n  HyperLiquidEndpoints,\n  HyperLiquidAssetConfigs,\n  BridgeContractConfig,\n  HyperLiquidBridgeContracts,\n  HyperLiquidTransportConfig,\n  TradingDefaultsConfig,\n  FeeRatesConfig,\n} from '../types/perps-types';\n\n// Network constants\nexport const ARBITRUM_MAINNET_CHAIN_ID_HEX = '0xa4b1' as const;\nexport const ARBITRUM_MAINNET_CHAIN_ID = '42161';\nexport const ARBITRUM_TESTNET_CHAIN_ID = '421614';\nexport const ARBITRUM_MAINNET_CAIP_CHAIN_ID = `eip155:${ARBITRUM_MAINNET_CHAIN_ID}`;\nexport const ARBITRUM_TESTNET_CAIP_CHAIN_ID = `eip155:${ARBITRUM_TESTNET_CHAIN_ID}`;\n\n// Hyperliquid chain constants\nexport const HYPERLIQUID_MAINNET_CHAIN_ID = '0x3e7'; // 999 in decimal\nexport const HYPERLIQUID_TESTNET_CHAIN_ID = '0x3e6'; // 998 in decimal (assumed)\nexport const HYPERLIQUID_MAINNET_CAIP_CHAIN_ID = 'eip155:999' as CaipChainId;\nexport const HYPERLIQUID_TESTNET_CAIP_CHAIN_ID = 'eip155:998' as CaipChainId;\nexport const HYPERLIQUID_NETWORK_NAME = 'Hyperliquid';\n\n// Token constants\nexport const USDC_SYMBOL = 'USDC';\nexport const USDC_NAME = 'USD Coin';\nexport const USDC_DECIMALS = 6;\nexport const TOKEN_DECIMALS = 18;\n\n// Network constants\nexport const ARBITRUM_SEPOLIA_CHAIN_ID = '0x66eee'; // 421614 in decimal\n\n// USDC token addresses\nexport const USDC_ETHEREUM_MAINNET_ADDRESS =\n  '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48';\nexport const USDC_ARBITRUM_MAINNET_ADDRESS =\n  '0xaf88d065e77c8cC2239327C5EDb3A432268e5831';\nexport const USDC_ARBITRUM_TESTNET_ADDRESS =\n  '0x75faf114eafb1BDbe2F0316DF893fd58CE46AA4d';\n\n// USDC token icon URL using MetaMask's official Token Icons API\n// Format: https://static.cx.metamask.io/api/v1/tokenIcons/{chainId}/{contractAddress}.png\n// This URL follows the same pattern used throughout MetaMask (bridges, swaps, etc.)\nexport const USDC_TOKEN_ICON_URL = `https://static.cx.metamask.io/api/v1/tokenIcons/1/${USDC_ETHEREUM_MAINNET_ADDRESS}.png`;\n\n// WebSocket endpoints\nexport const HYPERLIQUID_ENDPOINTS: HyperLiquidEndpoints = {\n  mainnet: 'wss://api.hyperliquid.xyz/ws',\n  testnet: 'wss://api.hyperliquid-testnet.xyz/ws',\n};\n\n// Asset icons base URL (HyperLiquid CDN - fallback source)\nexport const HYPERLIQUID_ASSET_ICONS_BASE_URL =\n  'https://app.hyperliquid.xyz/coins/';\n\n// MetaMask-hosted Perps asset icons (primary source)\n// Assets uploaded to: https://github.com/MetaMask/contract-metadata/tree/master/icons/eip155:999\n// HIP-3 assets use format: hip3:dex_SYMBOL.svg (e.g., hip3:xyz_AAPL.svg)\n// Regular assets use format: SYMBOL.svg (e.g., BTC.svg)\nexport const METAMASK_PERPS_ICONS_BASE_URL =\n  'https://raw.githubusercontent.com/MetaMask/contract-metadata/master/icons/eip155:999/';\n\n// Asset configurations for multichain abstraction\nexport const HYPERLIQUID_ASSET_CONFIGS: HyperLiquidAssetConfigs = {\n  usdc: {\n    mainnet: `${ARBITRUM_MAINNET_CAIP_CHAIN_ID}/erc20:0xaf88d065e77c8cC2239327C5EDb3A432268e5831/default`,\n    testnet: `${ARBITRUM_TESTNET_CAIP_CHAIN_ID}/erc20:0x75faf114eafb1BDbe2F0316DF893fd58CE46AA4d/default`,\n  },\n};\n\n// HyperLiquid bridge contract addresses for direct USDC deposits\n// These are the official bridge contracts where USDC must be sent to credit user's HyperLiquid account\nexport const HYPERLIQUID_BRIDGE_CONTRACTS: HyperLiquidBridgeContracts = {\n  mainnet: {\n    chainId: ARBITRUM_MAINNET_CAIP_CHAIN_ID,\n    contractAddress: '0x2df1c51e09aecf9cacb7bc98cb1742757f163df7',\n  },\n  testnet: {\n    chainId: ARBITRUM_TESTNET_CAIP_CHAIN_ID,\n    contractAddress: '0x08cfc1B6b2dCF36A1480b99353A354AA8AC56f89',\n  },\n};\n\n// SDK transport configuration\nexport const HYPERLIQUID_TRANSPORT_CONFIG: HyperLiquidTransportConfig = {\n  timeout: 10_000,\n  keepAlive: { interval: 30_000 },\n  reconnect: {\n    maxRetries: 5,\n    connectionTimeout: 10_000,\n  },\n};\n\n// Trading configuration constants\nexport const TRADING_DEFAULTS: TradingDefaultsConfig = {\n  leverage: 3, // 3x default leverage\n  marginPercent: 10, // 10% fixed margin default\n  takeProfitPercent: 0.3, // 30% take profit\n  stopLossPercent: 0.1, // 10% stop loss\n  amount: {\n    mainnet: 10, // $10 minimum order size\n    testnet: 10, // $10 minimum order size\n  },\n};\n\n// Fee configuration\n// Note: These are base rates (Tier 0, no discounts)\n// Actual fees will be calculated based on user's volume tier and staking\nexport const FEE_RATES: FeeRatesConfig = {\n  taker: 0.00045, // 0.045% - Market orders and aggressive limit orders\n  maker: 0.00015, // 0.015% - Limit orders that add liquidity\n};\n\n/**\n * HIP-3 dynamic fee calculation configuration\n *\n * HIP-3 (builder-deployed) perpetual markets have variable fees based on:\n * 1. deployerFeeScale - Per-DEX fee multiplier (fetched from perpDexs API)\n * 2. growthMode - Per-asset 90% fee reduction (fetched from meta API)\n *\n * Fee Formula (from HyperLiquid docs):\n * - scaleIfHip3 = deployerFeeScale < 1 ? deployerFeeScale + 1 : deployerFeeScale * 2\n * - growthModeScale = growthMode ? 0.1 : 1\n * - finalRate = baseRate * scaleIfHip3 * growthModeScale\n *\n * Example: For xyz:TSLA with deployerFeeScale=1.0 and growthMode=\"enabled\":\n * - scaleIfHip3 = 1.0 * 2 = 2.0\n * - growthModeScale = 0.1 (90% reduction)\n * - Final multiplier = 2.0 * 0.1 = 0.2 (effectively 80% off standard 2x HIP-3 fees)\n *\n * @see https://hyperliquid.gitbook.io/hyperliquid-docs/trading/fees#fee-formula-for-developers\n * @see parseAssetName() in HyperLiquidProvider for HIP-3 asset detection\n */\nexport const HIP3_FEE_CONFIG = {\n  /**\n   * Growth Mode multiplier - 90% fee reduction for assets in growth phase\n   * This is a protocol constant from HyperLiquid's fee formula\n   */\n  GrowthModeScale: 0.1,\n\n  /**\n   * Default deployerFeeScale when API is unavailable\n   * Most HIP-3 DEXs use 1.0, which results in 2x base fees\n   */\n  DefaultDeployerFeeScale: 1.0,\n\n  /**\n   * Cache TTL for perpDexs data (5 minutes)\n   * Fee scales rarely change, so longer cache is acceptable\n   */\n  PerpDexsCacheTtlMs: 5 * 60 * 1000,\n\n  /**\n   * @deprecated Use dynamic calculation via calculateHip3FeeMultiplier()\n   * Kept for backwards compatibility during migration\n   */\n  FeeMultiplier: 2,\n} as const;\n\nconst BUILDER_FEE_MAX_FEE_DECIMAL = 0.001;\n\n// Builder fee configuration\nexport const BUILDER_FEE_CONFIG = {\n  // Test builder wallet\n  TestnetBuilder: '0x724e57771ba749650875bd8adb2e29a85d0cacfa' as Hex,\n  // Production builder wallet\n  MainnetBuilder: '0xe95a5e31904e005066614247d309e00d8ad753aa' as Hex,\n  // Fee in decimal (10 bp = 0.1%)\n  MaxFeeDecimal: BUILDER_FEE_MAX_FEE_DECIMAL,\n  MaxFeeTenthsBps: BUILDER_FEE_MAX_FEE_DECIMAL * 100000,\n  MaxFeeRate: `${(BUILDER_FEE_MAX_FEE_DECIMAL * 100)\n    .toFixed(4)\n    .replace(/\\.?0+$/u, '')}%`,\n};\n\n// Referral code configuration\nexport const REFERRAL_CONFIG = {\n  // Production referral code\n  MainnetCode: 'MMCSI',\n  // Development/testnet referral code\n  TestnetCode: 'MMCSITEST',\n};\n\n// Deposit constants\nexport const DEPOSIT_CONFIG = {\n  EstimatedGasLimit: 100000, // Estimated gas limit for bridge deposit\n  DefaultSlippage: 1, // 1% default slippage for bridge quotes\n  BridgeQuoteTimeout: 1000, // 1 second timeout for bridge quotes\n  RefreshRate: 30000, // 30 seconds quote refresh rate\n  EstimatedTime: {\n    DirectDeposit: '3-5 seconds', // Direct USDC deposit on Arbitrum\n    SameChainSwap: '30-60 seconds', // Swap on same chain before deposit\n  },\n};\n\n// Withdrawal constants (HyperLiquid-specific)\nexport const HYPERLIQUID_WITHDRAWAL_MINUTES = 5; // HyperLiquid withdrawal processing time in minutes\n\n// Type helpers\nexport type SupportedAsset = keyof typeof HYPERLIQUID_ASSET_CONFIGS;\n\n// Configuration helpers\nexport function getWebSocketEndpoint(isTestnet: boolean): string {\n  return isTestnet\n    ? HYPERLIQUID_ENDPOINTS.testnet\n    : HYPERLIQUID_ENDPOINTS.mainnet;\n}\n\nexport function getChainId(isTestnet: boolean): string {\n  return isTestnet ? ARBITRUM_TESTNET_CHAIN_ID : ARBITRUM_MAINNET_CHAIN_ID;\n}\n\nexport function getCaipChainId(isTestnet: boolean): CaipChainId {\n  const network: HyperLiquidNetwork = isTestnet ? 'testnet' : 'mainnet';\n  return HYPERLIQUID_BRIDGE_CONTRACTS[network].chainId;\n}\n\nexport function getBridgeInfo(isTestnet: boolean): BridgeContractConfig {\n  const network: HyperLiquidNetwork = isTestnet ? 'testnet' : 'mainnet';\n  return HYPERLIQUID_BRIDGE_CONTRACTS[network];\n}\n\nexport function getSupportedAssets(isTestnet?: boolean): CaipAssetId[] {\n  const network = isTestnet ? 'testnet' : 'mainnet';\n  return Object.values(HYPERLIQUID_ASSET_CONFIGS).map(\n    (config) => config[network],\n  );\n}\n\n// CAIP asset namespace constants\nexport const CAIP_ASSET_NAMESPACES = {\n  Erc20: 'erc20',\n} as const;\n\n/**\n * HyperLiquid protocol-specific configuration\n * Contains constants specific to HyperLiquid's perps exchange\n */\nexport const HYPERLIQUID_CONFIG = {\n  // Exchange name used in predicted funding data\n  // HyperLiquid uses 'HlPerp' as their perps exchange identifier\n  ExchangeName: 'HlPerp',\n} as const;\n\n/**\n * HIP-3 multi-DEX asset ID calculation constants\n * Per HIP-3-IMPLEMENTATION.md:\n * - Main DEX: assetId = index (0, 1, 2, ...)\n * - HIP-3 DEX: assetId = BASE_ASSET_ID + (perpDexIndex × DEX_MULTIPLIER) + index\n *\n * This formula enables proper order routing across multiple DEXs:\n * - Main DEX (perpDexIndex=0): Uses index directly (BTC=0, ETH=1, SOL=2, etc.)\n * - xyz DEX (perpDexIndex=1): 100000 + (1 × 10000) + index = 110000-110999\n * - abc DEX (perpDexIndex=2): 100000 + (2 × 10000) + index = 120000-120999\n *\n * Supports up to 10 HIP-3 DEXs with 10000 assets each.\n */\nexport const HIP3_ASSET_ID_CONFIG = {\n  // Base offset for HIP-3 asset IDs (100000)\n  // Ensures HIP-3 asset IDs don't conflict with main DEX indices\n  BaseAssetId: 100000,\n\n  // Multiplier for DEX index in asset ID calculation (10000)\n  // Allocates 10000 asset ID slots per DEX (0-9999)\n  DexMultiplier: 10000,\n} as const;\n\n/**\n * Basis points conversion constant\n * 1 basis point (bp) = 0.01% = 0.0001 as decimal\n * Used for fee discount calculations (e.g., 6500 bps = 65%)\n */\nexport const BASIS_POINTS_DIVISOR = 10000;\n\n/**\n * Offset added to spot market pair index to derive the spot asset ID\n * used in HyperLiquid order routing.\n * Per HyperLiquid protocol: spotAssetId = SPOT_ASSET_ID_OFFSET + pairIndex\n */\nexport const SPOT_ASSET_ID_OFFSET = 10000;\n\n/**\n * HIP-3 asset market type classifications (PRODUCTION DEFAULT)\n *\n * This is the production default configuration, can be overridden via feature flag\n * (remoteFeatureFlags.perpsAssetMarketTypes) for dynamic control.\n *\n * Maps asset symbols (e.g., \"xyz:TSLA\") to their market type for badge display.\n *\n * Market type determines the badge shown in the UI:\n * - 'equity': STOCK badge (stocks like TSLA, NVDA)\n * - 'commodity': COMMODITY badge (commodities like GOLD)\n * - 'forex': FOREX badge (forex pairs)\n * - undefined: No badge for crypto or unmapped assets\n *\n * Format: 'dex:SYMBOL' → MarketType\n * This allows flexible per-asset classification.\n * Assets not listed here will have no market type (undefined).\n */\nexport const HIP3_ASSET_MARKET_TYPES: Record<\n  string,\n  'equity' | 'commodity' | 'forex' | 'crypto'\n> = {\n  // xyz DEX - Equities\n  'xyz:TSLA': 'equity',\n  'xyz:NVDA': 'equity',\n  'xyz:XYZ100': 'equity',\n  'xyz:INTC': 'equity',\n  'xyz:MU': 'equity',\n  'xyz:CRCL': 'equity',\n  'xyz:HOOD': 'equity',\n  'xyz:SNDK': 'equity',\n  'xyz:GOOGL': 'equity',\n  'xyz:COIN': 'equity',\n  'xyz:ORCL': 'equity',\n  'xyz:AMZN': 'equity',\n  'xyz:PLTR': 'equity',\n  'xyz:AAPL': 'equity',\n  'xyz:META': 'equity',\n  'xyz:AMD': 'equity',\n  'xyz:MSFT': 'equity',\n  'xyz:BABA': 'equity',\n  'xyz:RIVN': 'equity',\n  'xyz:NFLX': 'equity',\n  'xyz:COST': 'equity',\n  'xyz:LLY': 'equity',\n  'xyz:TSM': 'equity',\n  'xyz:SKHX': 'equity',\n  'xyz:MSTR': 'equity',\n  'xyz:CRWV': 'equity',\n  'xyz:SMSN': 'equity',\n\n  'xyz:GME': 'equity',\n  'xyz:SOFTBANK': 'equity',\n  'xyz:HYUNDAI': 'equity',\n  'xyz:KIOXIA': 'equity',\n  'xyz:HIMS': 'equity',\n  'xyz:EWY': 'equity',\n  'xyz:EWJ': 'equity',\n  'xyz:SP500': 'equity',\n  'xyz:JP225': 'equity',\n  'xyz:KR200': 'equity',\n  'xyz:VIX': 'equity',\n  'xyz:USAR': 'equity',\n\n  // xyz DEX - Commodities\n  'xyz:GOLD': 'commodity',\n  'xyz:SILVER': 'commodity',\n  'xyz:CL': 'commodity',\n  'xyz:COPPER': 'commodity',\n  'xyz:ALUMINIUM': 'commodity',\n  'xyz:URANIUM': 'commodity',\n  'xyz:URNM': 'commodity',\n  'xyz:NATGAS': 'commodity',\n  'xyz:PLATINUM': 'commodity',\n  'xyz:PALLADIUM': 'commodity',\n  'xyz:BRENTOIL': 'commodity',\n\n  // xyz DEX - Forex\n  'xyz:EUR': 'forex',\n  'xyz:JPY': 'forex',\n  'xyz:DXY': 'forex',\n} as const;\n\n/**\n * Testnet-specific HIP-3 DEX configuration\n *\n * On testnet, there are many HIP-3 DEXs (test deployments from various builders).\n * Subscribing to all of them causes connection/subscription overload and instability.\n * This configuration limits which DEXs are discovered and subscribed to on testnet.\n */\nexport const TESTNET_HIP3_CONFIG = {\n  /**\n   * Allowed DEX names for testnet\n   * Empty array = main DEX only (no HIP-3 DEXs)\n   * Add specific DEX names to test with particular HIP-3 DEXs: ['testdex1', 'testdex2']\n   */\n  EnabledDexs: ['xyz'] as string[],\n\n  /**\n   * Set to true to enable full HIP-3 discovery on testnet (not recommended)\n   * When false, only DEXs in ENABLED_DEXS are used\n   */\n  AutoDiscoverAll: false,\n} as const;\n\n/**\n * Mainnet-specific HIP-3 DEX configuration\n *\n * On mainnet, DEX filtering is dynamically determined from the allowlist markets\n * feature flag. This avoids hardcoding DEX names and ensures consistency with\n * the market filtering logic.\n *\n * When AutoDiscoverAll is false and no allowlist is provided, only the main DEX is used.\n * When an allowlist is provided, DEXs are extracted from the allowlist patterns.\n */\nexport const MAINNET_HIP3_CONFIG = {\n  /**\n   * Set to true to enable full HIP-3 discovery on mainnet\n   * When false, DEXs are filtered based on the allowlist markets feature flag\n   * (recommended for production to reduce subscription overhead)\n   */\n  AutoDiscoverAll: false,\n} as const;\n\n/**\n * HIP-3 margin management configuration\n * Controls margin buffers and auto-rebalance behavior for HIP-3 DEXes with isolated margin\n *\n * Background: HyperLiquid validates availableBalance >= totalRequiredMargin BEFORE reallocating\n * existing locked margin. This requires temporary over-funding when increasing positions,\n * followed by automatic cleanup to minimize locked capital.\n */\nexport const HIP3_MARGIN_CONFIG = {\n  /**\n   * Margin buffer multiplier for fees and slippage (0.3% = multiply by 1.003)\n   * Covers HyperLiquid's max taker fee (0.035%) with comfortable margin\n   */\n  BufferMultiplier: 1.003,\n\n  /**\n   * Desired buffer to keep on HIP-3 DEX after auto-rebalance (USDC amount)\n   * Small buffer allows quick follow-up orders without transfers\n   */\n  RebalanceDesiredBuffer: 0.1,\n\n  /**\n   * Minimum excess threshold to trigger auto-rebalance (USDC amount)\n   * Prevents unnecessary transfers for tiny amounts\n   */\n  RebalanceMinThreshold: 0.1,\n} as const;\n\n/**\n * Configuration for USDH collateral handling on HIP-3 DEXs\n * Per HyperLiquid docs: USDH DEXs pull collateral from spot balance automatically\n *\n * USDH is HyperLiquid's native stablecoin pegged 1:1 to USDC\n */\nexport const USDH_CONFIG = {\n  /** Token name for USDH collateral */\n  TokenName: 'USDH',\n\n  /**\n   * Maximum slippage for USDC→USDH spot swap in basis points\n   * USDH is pegged 1:1 to USDC so slippage should be minimal\n   * 10 bps (0.1%) provides small buffer for spread\n   */\n  SwapSlippageBps: 10,\n} as const;\n\n// Progress bar constants\nexport const INITIAL_AMOUNT_UI_PROGRESS = 10;\nexport const WITHDRAWAL_PROGRESS_STAGES = [\n  25, 35, 45, 55, 65, 75, 85, 90, 95, 98,\n];\nexport const PROGRESS_BAR_COMPLETION_DELAY_MS = 500;\n"]}
+{"version":3,"file":"hyperLiquidConfig.cjs","sourceRoot":"","sources":["../../src/constants/hyperLiquidConfig.ts"],"names":[],"mappings":"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","sourcesContent":["import type { CaipAssetId, CaipChainId, Hex } from '@metamask/utils';\n\nimport type {\n  HyperLiquidNetwork,\n  HyperLiquidEndpoints,\n  HyperLiquidAssetConfigs,\n  BridgeContractConfig,\n  HyperLiquidBridgeContracts,\n  HyperLiquidTransportConfig,\n  TradingDefaultsConfig,\n  FeeRatesConfig,\n} from '../types/perps-types';\n\n// Network constants\nexport const ARBITRUM_MAINNET_CHAIN_ID_HEX = '0xa4b1' as const;\nexport const ARBITRUM_MAINNET_CHAIN_ID = '42161';\nexport const ARBITRUM_TESTNET_CHAIN_ID = '421614';\nexport const ARBITRUM_MAINNET_CAIP_CHAIN_ID = `eip155:${ARBITRUM_MAINNET_CHAIN_ID}`;\nexport const ARBITRUM_TESTNET_CAIP_CHAIN_ID = `eip155:${ARBITRUM_TESTNET_CHAIN_ID}`;\n\n// Hyperliquid chain constants\nexport const HYPERLIQUID_MAINNET_CHAIN_ID = '0x3e7'; // 999 in decimal\nexport const HYPERLIQUID_TESTNET_CHAIN_ID = '0x3e6'; // 998 in decimal (assumed)\nexport const HYPERLIQUID_MAINNET_CAIP_CHAIN_ID = 'eip155:999' as CaipChainId;\nexport const HYPERLIQUID_TESTNET_CAIP_CHAIN_ID = 'eip155:998' as CaipChainId;\nexport const HYPERLIQUID_NETWORK_NAME = 'Hyperliquid';\n\n// Token constants\nexport const USDC_SYMBOL = 'USDC';\nexport const USDC_NAME = 'USD Coin';\nexport const USDC_DECIMALS = 6;\nexport const TOKEN_DECIMALS = 18;\n\n// Network constants\nexport const ARBITRUM_SEPOLIA_CHAIN_ID = '0x66eee'; // 421614 in decimal\n\n// USDC token addresses\nexport const USDC_ETHEREUM_MAINNET_ADDRESS =\n  '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48';\nexport const USDC_ARBITRUM_MAINNET_ADDRESS =\n  '0xaf88d065e77c8cC2239327C5EDb3A432268e5831';\nexport const USDC_ARBITRUM_TESTNET_ADDRESS =\n  '0x75faf114eafb1BDbe2F0316DF893fd58CE46AA4d';\n\n// USDC token icon URL using MetaMask's official Token Icons API\n// Format: https://static.cx.metamask.io/api/v1/tokenIcons/{chainId}/{contractAddress}.png\n// This URL follows the same pattern used throughout MetaMask (bridges, swaps, etc.)\nexport const USDC_TOKEN_ICON_URL = `https://static.cx.metamask.io/api/v1/tokenIcons/1/${USDC_ETHEREUM_MAINNET_ADDRESS}.png`;\n\n// WebSocket endpoints\nexport const HYPERLIQUID_ENDPOINTS: HyperLiquidEndpoints = {\n  mainnet: 'wss://api.hyperliquid.xyz/ws',\n  testnet: 'wss://api.hyperliquid-testnet.xyz/ws',\n};\n\n// Asset icons base URL (HyperLiquid CDN - fallback source)\nexport const HYPERLIQUID_ASSET_ICONS_BASE_URL =\n  'https://app.hyperliquid.xyz/coins/';\n\n// MetaMask-hosted Perps asset icons (primary source)\n// Assets uploaded to: https://github.com/MetaMask/contract-metadata/tree/master/icons/eip155:999\n// HIP-3 assets use format: hip3:dex_SYMBOL.svg (e.g., hip3:xyz_AAPL.svg)\n// Regular assets use format: SYMBOL.svg (e.g., BTC.svg)\nexport const METAMASK_PERPS_ICONS_BASE_URL =\n  'https://raw.githubusercontent.com/MetaMask/contract-metadata/master/icons/eip155:999/';\n\n// Asset configurations for multichain abstraction\nexport const HYPERLIQUID_ASSET_CONFIGS: HyperLiquidAssetConfigs = {\n  usdc: {\n    mainnet: `${ARBITRUM_MAINNET_CAIP_CHAIN_ID}/erc20:0xaf88d065e77c8cC2239327C5EDb3A432268e5831/default`,\n    testnet: `${ARBITRUM_TESTNET_CAIP_CHAIN_ID}/erc20:0x75faf114eafb1BDbe2F0316DF893fd58CE46AA4d/default`,\n  },\n};\n\n// HyperLiquid bridge contract addresses for direct USDC deposits\n// These are the official bridge contracts where USDC must be sent to credit user's HyperLiquid account\nexport const HYPERLIQUID_BRIDGE_CONTRACTS: HyperLiquidBridgeContracts = {\n  mainnet: {\n    chainId: ARBITRUM_MAINNET_CAIP_CHAIN_ID,\n    contractAddress: '0x2df1c51e09aecf9cacb7bc98cb1742757f163df7',\n  },\n  testnet: {\n    chainId: ARBITRUM_TESTNET_CAIP_CHAIN_ID,\n    contractAddress: '0x08cfc1B6b2dCF36A1480b99353A354AA8AC56f89',\n  },\n};\n\n// SDK transport configuration\nexport const HYPERLIQUID_TRANSPORT_CONFIG: HyperLiquidTransportConfig = {\n  timeout: 10_000,\n  keepAlive: { interval: 30_000 },\n  reconnect: {\n    maxRetries: 5,\n    connectionTimeout: 10_000,\n  },\n};\n\n// Trading configuration constants\nexport const TRADING_DEFAULTS: TradingDefaultsConfig = {\n  leverage: 3, // 3x default leverage\n  marginPercent: 10, // 10% fixed margin default\n  takeProfitPercent: 0.3, // 30% take profit\n  stopLossPercent: 0.1, // 10% stop loss\n  amount: {\n    mainnet: 10, // $10 minimum order size\n    testnet: 10, // $10 minimum order size\n  },\n};\n\n// Fee configuration\n// Note: These are base rates (Tier 0, no discounts)\n// Actual fees will be calculated based on user's volume tier and staking\nexport const FEE_RATES: FeeRatesConfig = {\n  taker: 0.00045, // 0.045% - Market orders and aggressive limit orders\n  maker: 0.00015, // 0.015% - Limit orders that add liquidity\n};\n\n/**\n * HIP-3 dynamic fee calculation configuration\n *\n * HIP-3 (builder-deployed) perpetual markets have variable fees based on:\n * 1. deployerFeeScale - Per-DEX fee multiplier (fetched from perpDexs API)\n * 2. growthMode - Per-asset 90% fee reduction (fetched from meta API)\n *\n * Fee Formula (from HyperLiquid docs):\n * - scaleIfHip3 = deployerFeeScale < 1 ? deployerFeeScale + 1 : deployerFeeScale * 2\n * - growthModeScale = growthMode ? 0.1 : 1\n * - finalRate = baseRate * scaleIfHip3 * growthModeScale\n *\n * Example: For xyz:TSLA with deployerFeeScale=1.0 and growthMode=\"enabled\":\n * - scaleIfHip3 = 1.0 * 2 = 2.0\n * - growthModeScale = 0.1 (90% reduction)\n * - Final multiplier = 2.0 * 0.1 = 0.2 (effectively 80% off standard 2x HIP-3 fees)\n *\n * @see https://hyperliquid.gitbook.io/hyperliquid-docs/trading/fees#fee-formula-for-developers\n * @see parseAssetName() in HyperLiquidProvider for HIP-3 asset detection\n */\nexport const HIP3_FEE_CONFIG = {\n  /**\n   * Growth Mode multiplier - 90% fee reduction for assets in growth phase\n   * This is a protocol constant from HyperLiquid's fee formula\n   */\n  GrowthModeScale: 0.1,\n\n  /**\n   * Default deployerFeeScale when API is unavailable\n   * Most HIP-3 DEXs use 1.0, which results in 2x base fees\n   */\n  DefaultDeployerFeeScale: 1.0,\n\n  /**\n   * Cache TTL for perpDexs data (5 minutes)\n   * Fee scales rarely change, so longer cache is acceptable\n   */\n  PerpDexsCacheTtlMs: 5 * 60 * 1000,\n\n  /**\n   * @deprecated Use dynamic calculation via calculateHip3FeeMultiplier()\n   * Kept for backwards compatibility during migration\n   */\n  FeeMultiplier: 2,\n} as const;\n\nconst BUILDER_FEE_MAX_FEE_DECIMAL = 0.001;\n\n// Builder fee configuration\nexport const BUILDER_FEE_CONFIG = {\n  // Test builder wallet\n  TestnetBuilder: '0x724e57771ba749650875bd8adb2e29a85d0cacfa' as Hex,\n  // Production builder wallet\n  MainnetBuilder: '0xe95a5e31904e005066614247d309e00d8ad753aa' as Hex,\n  // Fee in decimal (10 bp = 0.1%)\n  MaxFeeDecimal: BUILDER_FEE_MAX_FEE_DECIMAL,\n  MaxFeeTenthsBps: BUILDER_FEE_MAX_FEE_DECIMAL * 100000,\n  MaxFeeRate: `${(BUILDER_FEE_MAX_FEE_DECIMAL * 100)\n    .toFixed(4)\n    .replace(/\\.?0+$/u, '')}%`,\n};\n\n// Referral code configuration\nexport const REFERRAL_CONFIG = {\n  // Production referral code\n  MainnetCode: 'MMCSI',\n  // Development/testnet referral code\n  TestnetCode: 'MMCSITEST',\n};\n\n// Deposit constants\nexport const DEPOSIT_CONFIG = {\n  EstimatedGasLimit: 100000, // Estimated gas limit for bridge deposit\n  DefaultSlippage: 1, // 1% default slippage for bridge quotes\n  BridgeQuoteTimeout: 1000, // 1 second timeout for bridge quotes\n  RefreshRate: 30000, // 30 seconds quote refresh rate\n  EstimatedTime: {\n    DirectDeposit: '3-5 seconds', // Direct USDC deposit on Arbitrum\n    SameChainSwap: '30-60 seconds', // Swap on same chain before deposit\n  },\n};\n\n// Withdrawal constants (HyperLiquid-specific)\nexport const HYPERLIQUID_WITHDRAWAL_MINUTES = 5; // HyperLiquid withdrawal processing time in minutes\n\n// Type helpers\nexport type SupportedAsset = keyof typeof HYPERLIQUID_ASSET_CONFIGS;\n\n// Configuration helpers\nexport function getWebSocketEndpoint(isTestnet: boolean): string {\n  return isTestnet\n    ? HYPERLIQUID_ENDPOINTS.testnet\n    : HYPERLIQUID_ENDPOINTS.mainnet;\n}\n\nexport function getChainId(isTestnet: boolean): string {\n  return isTestnet ? ARBITRUM_TESTNET_CHAIN_ID : ARBITRUM_MAINNET_CHAIN_ID;\n}\n\nexport function getCaipChainId(isTestnet: boolean): CaipChainId {\n  const network: HyperLiquidNetwork = isTestnet ? 'testnet' : 'mainnet';\n  return HYPERLIQUID_BRIDGE_CONTRACTS[network].chainId;\n}\n\nexport function getBridgeInfo(isTestnet: boolean): BridgeContractConfig {\n  const network: HyperLiquidNetwork = isTestnet ? 'testnet' : 'mainnet';\n  return HYPERLIQUID_BRIDGE_CONTRACTS[network];\n}\n\nexport function getSupportedAssets(isTestnet?: boolean): CaipAssetId[] {\n  const network = isTestnet ? 'testnet' : 'mainnet';\n  return Object.values(HYPERLIQUID_ASSET_CONFIGS).map(\n    (config) => config[network],\n  );\n}\n\n// CAIP asset namespace constants\nexport const CAIP_ASSET_NAMESPACES = {\n  Erc20: 'erc20',\n} as const;\n\n/**\n * HyperLiquid protocol-specific configuration\n * Contains constants specific to HyperLiquid's perps exchange\n */\nexport const HYPERLIQUID_CONFIG = {\n  // Exchange name used in predicted funding data\n  // HyperLiquid uses 'HlPerp' as their perps exchange identifier\n  ExchangeName: 'HlPerp',\n} as const;\n\n/**\n * HIP-3 multi-DEX asset ID calculation constants\n * Per HIP-3-IMPLEMENTATION.md:\n * - Main DEX: assetId = index (0, 1, 2, ...)\n * - HIP-3 DEX: assetId = BASE_ASSET_ID + (perpDexIndex × DEX_MULTIPLIER) + index\n *\n * This formula enables proper order routing across multiple DEXs:\n * - Main DEX (perpDexIndex=0): Uses index directly (BTC=0, ETH=1, SOL=2, etc.)\n * - xyz DEX (perpDexIndex=1): 100000 + (1 × 10000) + index = 110000-110999\n * - abc DEX (perpDexIndex=2): 100000 + (2 × 10000) + index = 120000-120999\n *\n * Supports up to 10 HIP-3 DEXs with 10000 assets each.\n */\nexport const HIP3_ASSET_ID_CONFIG = {\n  // Base offset for HIP-3 asset IDs (100000)\n  // Ensures HIP-3 asset IDs don't conflict with main DEX indices\n  BaseAssetId: 100000,\n\n  // Multiplier for DEX index in asset ID calculation (10000)\n  // Allocates 10000 asset ID slots per DEX (0-9999)\n  DexMultiplier: 10000,\n} as const;\n\n/**\n * Basis points conversion constant\n * 1 basis point (bp) = 0.01% = 0.0001 as decimal\n * Used for fee discount calculations (e.g., 6500 bps = 65%)\n */\nexport const BASIS_POINTS_DIVISOR = 10000;\n\n/**\n * Offset added to spot market pair index to derive the spot asset ID\n * used in HyperLiquid order routing.\n * Per HyperLiquid protocol: spotAssetId = SPOT_ASSET_ID_OFFSET + pairIndex\n */\nexport const SPOT_ASSET_ID_OFFSET = 10000;\n\n/**\n * HIP-3 asset market type classifications (PRODUCTION DEFAULT)\n *\n * This is the production default configuration, can be overridden via feature flag\n * (remoteFeatureFlags.perpsAssetMarketTypes) for dynamic control.\n *\n * Maps asset symbols (e.g., \"xyz:TSLA\") to their market type for badge display.\n *\n * Market type determines the badge shown in the UI:\n * - 'equity': STOCK badge (stocks like TSLA, NVDA)\n * - 'commodity': COMMODITY badge (commodities like GOLD)\n * - 'forex': FOREX badge (forex pairs)\n * - undefined: No badge for crypto or unmapped assets\n *\n * Format: 'dex:SYMBOL' → MarketType\n * This allows flexible per-asset classification.\n * Assets not listed here will have no market type (undefined).\n */\nexport const HIP3_ASSET_MARKET_TYPES: Record<\n  string,\n  'equity' | 'commodity' | 'forex' | 'crypto'\n> = {\n  // xyz DEX - Equities\n  'xyz:TSLA': 'equity',\n  'xyz:NVDA': 'equity',\n  'xyz:XYZ100': 'equity',\n  'xyz:INTC': 'equity',\n  'xyz:MU': 'equity',\n  'xyz:CRCL': 'equity',\n  'xyz:HOOD': 'equity',\n  'xyz:SNDK': 'equity',\n  'xyz:GOOGL': 'equity',\n  'xyz:COIN': 'equity',\n  'xyz:ORCL': 'equity',\n  'xyz:AMZN': 'equity',\n  'xyz:PLTR': 'equity',\n  'xyz:AAPL': 'equity',\n  'xyz:META': 'equity',\n  'xyz:AMD': 'equity',\n  'xyz:MSFT': 'equity',\n  'xyz:BABA': 'equity',\n  'xyz:RIVN': 'equity',\n  'xyz:NFLX': 'equity',\n  'xyz:COST': 'equity',\n  'xyz:LLY': 'equity',\n  'xyz:TSM': 'equity',\n  'xyz:SKHX': 'equity',\n  'xyz:MSTR': 'equity',\n  'xyz:CRWV': 'equity',\n  'xyz:SMSN': 'equity',\n\n  'xyz:GME': 'equity',\n  'xyz:SOFTBANK': 'equity',\n  'xyz:HYUNDAI': 'equity',\n  'xyz:KIOXIA': 'equity',\n  'xyz:HIMS': 'equity',\n  'xyz:EWY': 'equity',\n  'xyz:EWJ': 'equity',\n  'xyz:SP500': 'equity',\n  'xyz:JP225': 'equity',\n  'xyz:KR200': 'equity',\n  'xyz:VIX': 'equity',\n  'xyz:USAR': 'equity',\n\n  // xyz DEX - Commodities\n  'xyz:GOLD': 'commodity',\n  'xyz:SILVER': 'commodity',\n  'xyz:CL': 'commodity',\n  'xyz:COPPER': 'commodity',\n  'xyz:ALUMINIUM': 'commodity',\n  'xyz:URANIUM': 'commodity',\n  'xyz:URNM': 'commodity',\n  'xyz:NATGAS': 'commodity',\n  'xyz:PLATINUM': 'commodity',\n  'xyz:PALLADIUM': 'commodity',\n  'xyz:BRENTOIL': 'commodity',\n\n  // xyz DEX - Forex\n  'xyz:EUR': 'forex',\n  'xyz:JPY': 'forex',\n  'xyz:DXY': 'forex',\n} as const;\n\n/**\n * Testnet-specific HIP-3 DEX configuration\n *\n * On testnet, there are many HIP-3 DEXs (test deployments from various builders).\n * Subscribing to all of them causes connection/subscription overload and instability.\n * This configuration limits which DEXs are discovered and subscribed to on testnet.\n */\nexport const TESTNET_HIP3_CONFIG = {\n  /**\n   * Allowed DEX names for testnet\n   * Empty array = main DEX only (no HIP-3 DEXs)\n   * Add specific DEX names to test with particular HIP-3 DEXs: ['testdex1', 'testdex2']\n   */\n  EnabledDexs: ['xyz'] as string[],\n\n  /**\n   * Set to true to enable full HIP-3 discovery on testnet (not recommended)\n   * When false, only DEXs in ENABLED_DEXS are used\n   */\n  AutoDiscoverAll: false,\n} as const;\n\n/**\n * Mainnet-specific HIP-3 DEX configuration\n *\n * On mainnet, DEX filtering is dynamically determined from the allowlist markets\n * feature flag. This avoids hardcoding DEX names and ensures consistency with\n * the market filtering logic.\n *\n * When AutoDiscoverAll is false and no allowlist is provided, only the main DEX is used.\n * When an allowlist is provided, DEXs are extracted from the allowlist patterns.\n */\nexport const MAINNET_HIP3_CONFIG = {\n  /**\n   * Set to true to enable full HIP-3 discovery on mainnet\n   * When false, DEXs are filtered based on the allowlist markets feature flag\n   * (recommended for production to reduce subscription overhead)\n   */\n  AutoDiscoverAll: false,\n} as const;\n\n/**\n * HIP-3 margin management configuration\n * Controls margin buffers and auto-rebalance behavior for HIP-3 DEXes with isolated margin\n *\n * Background: HyperLiquid validates spendableBalance >= totalRequiredMargin BEFORE reallocating\n * existing locked margin. This requires temporary over-funding when increasing positions,\n * followed by automatic cleanup to minimize locked capital.\n */\nexport const HIP3_MARGIN_CONFIG = {\n  /**\n   * Margin buffer multiplier for fees and slippage (0.3% = multiply by 1.003)\n   * Covers HyperLiquid's max taker fee (0.035%) with comfortable margin\n   */\n  BufferMultiplier: 1.003,\n\n  /**\n   * Desired buffer to keep on HIP-3 DEX after auto-rebalance (USDC amount)\n   * Small buffer allows quick follow-up orders without transfers\n   */\n  RebalanceDesiredBuffer: 0.1,\n\n  /**\n   * Minimum excess threshold to trigger auto-rebalance (USDC amount)\n   * Prevents unnecessary transfers for tiny amounts\n   */\n  RebalanceMinThreshold: 0.1,\n} as const;\n\n/**\n * Configuration for USDH collateral handling on HIP-3 DEXs\n * Per HyperLiquid docs: USDH DEXs pull collateral from spot balance automatically\n *\n * USDH is HyperLiquid's native stablecoin pegged 1:1 to USDC\n */\nexport const USDH_CONFIG = {\n  /** Token name for USDH collateral */\n  TokenName: 'USDH',\n\n  /**\n   * Maximum slippage for USDC→USDH spot swap in basis points\n   * USDH is pegged 1:1 to USDC so slippage should be minimal\n   * 10 bps (0.1%) provides small buffer for spread\n   */\n  SwapSlippageBps: 10,\n} as const;\n\n// Progress bar constants\nexport const INITIAL_AMOUNT_UI_PROGRESS = 10;\nexport const WITHDRAWAL_PROGRESS_STAGES = [\n  25, 35, 45, 55, 65, 75, 85, 90, 95, 98,\n];\nexport const PROGRESS_BAR_COMPLETION_DELAY_MS = 500;\n"]}

package/dist/constants/hyperLiquidConfig.d.cts

@@ -197,7 +197,7 @@ export declare const MAINNET_HIP3_CONFIG: {
  * HIP-3 margin management configuration
  * Controls margin buffers and auto-rebalance behavior for HIP-3 DEXes with isolated margin
  *
- * Background: HyperLiquid validates availableBalance >= totalRequiredMargin BEFORE reallocating
+ * Background: HyperLiquid validates spendableBalance >= totalRequiredMargin BEFORE reallocating
  * existing locked margin. This requires temporary over-funding when increasing positions,
  * followed by automatic cleanup to minimize locked capital.
  */

package/dist/constants/hyperLiquidConfig.d.mts

@@ -197,7 +197,7 @@ export declare const MAINNET_HIP3_CONFIG: {
  * HIP-3 margin management configuration
  * Controls margin buffers and auto-rebalance behavior for HIP-3 DEXes with isolated margin
  *
- * Background: HyperLiquid validates availableBalance >= totalRequiredMargin BEFORE reallocating
+ * Background: HyperLiquid validates spendableBalance >= totalRequiredMargin BEFORE reallocating
  * existing locked margin. This requires temporary over-funding when increasing positions,
  * followed by automatic cleanup to minimize locked capital.
  */

package/dist/constants/hyperLiquidConfig.mjs

@@ -344,7 +344,7 @@ export const MAINNET_HIP3_CONFIG = {
  * HIP-3 margin management configuration
  * Controls margin buffers and auto-rebalance behavior for HIP-3 DEXes with isolated margin
  *
- * Background: HyperLiquid validates availableBalance >= totalRequiredMargin BEFORE reallocating
+ * Background: HyperLiquid validates spendableBalance >= totalRequiredMargin BEFORE reallocating
  * existing locked margin. This requires temporary over-funding when increasing positions,
  * followed by automatic cleanup to minimize locked capital.
  */

package/dist/constants/hyperLiquidConfig.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"hyperLiquidConfig.mjs","sourceRoot":"","sources":["../../src/constants/hyperLiquidConfig.ts"],"names":[],"mappings":"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","sourcesContent":["import type { CaipAssetId, CaipChainId, Hex } from '@metamask/utils';\n\nimport type {\n  HyperLiquidNetwork,\n  HyperLiquidEndpoints,\n  HyperLiquidAssetConfigs,\n  BridgeContractConfig,\n  HyperLiquidBridgeContracts,\n  HyperLiquidTransportConfig,\n  TradingDefaultsConfig,\n  FeeRatesConfig,\n} from '../types/perps-types';\n\n// Network constants\nexport const ARBITRUM_MAINNET_CHAIN_ID_HEX = '0xa4b1' as const;\nexport const ARBITRUM_MAINNET_CHAIN_ID = '42161';\nexport const ARBITRUM_TESTNET_CHAIN_ID = '421614';\nexport const ARBITRUM_MAINNET_CAIP_CHAIN_ID = `eip155:${ARBITRUM_MAINNET_CHAIN_ID}`;\nexport const ARBITRUM_TESTNET_CAIP_CHAIN_ID = `eip155:${ARBITRUM_TESTNET_CHAIN_ID}`;\n\n// Hyperliquid chain constants\nexport const HYPERLIQUID_MAINNET_CHAIN_ID = '0x3e7'; // 999 in decimal\nexport const HYPERLIQUID_TESTNET_CHAIN_ID = '0x3e6'; // 998 in decimal (assumed)\nexport const HYPERLIQUID_MAINNET_CAIP_CHAIN_ID = 'eip155:999' as CaipChainId;\nexport const HYPERLIQUID_TESTNET_CAIP_CHAIN_ID = 'eip155:998' as CaipChainId;\nexport const HYPERLIQUID_NETWORK_NAME = 'Hyperliquid';\n\n// Token constants\nexport const USDC_SYMBOL = 'USDC';\nexport const USDC_NAME = 'USD Coin';\nexport const USDC_DECIMALS = 6;\nexport const TOKEN_DECIMALS = 18;\n\n// Network constants\nexport const ARBITRUM_SEPOLIA_CHAIN_ID = '0x66eee'; // 421614 in decimal\n\n// USDC token addresses\nexport const USDC_ETHEREUM_MAINNET_ADDRESS =\n  '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48';\nexport const USDC_ARBITRUM_MAINNET_ADDRESS =\n  '0xaf88d065e77c8cC2239327C5EDb3A432268e5831';\nexport const USDC_ARBITRUM_TESTNET_ADDRESS =\n  '0x75faf114eafb1BDbe2F0316DF893fd58CE46AA4d';\n\n// USDC token icon URL using MetaMask's official Token Icons API\n// Format: https://static.cx.metamask.io/api/v1/tokenIcons/{chainId}/{contractAddress}.png\n// This URL follows the same pattern used throughout MetaMask (bridges, swaps, etc.)\nexport const USDC_TOKEN_ICON_URL = `https://static.cx.metamask.io/api/v1/tokenIcons/1/${USDC_ETHEREUM_MAINNET_ADDRESS}.png`;\n\n// WebSocket endpoints\nexport const HYPERLIQUID_ENDPOINTS: HyperLiquidEndpoints = {\n  mainnet: 'wss://api.hyperliquid.xyz/ws',\n  testnet: 'wss://api.hyperliquid-testnet.xyz/ws',\n};\n\n// Asset icons base URL (HyperLiquid CDN - fallback source)\nexport const HYPERLIQUID_ASSET_ICONS_BASE_URL =\n  'https://app.hyperliquid.xyz/coins/';\n\n// MetaMask-hosted Perps asset icons (primary source)\n// Assets uploaded to: https://github.com/MetaMask/contract-metadata/tree/master/icons/eip155:999\n// HIP-3 assets use format: hip3:dex_SYMBOL.svg (e.g., hip3:xyz_AAPL.svg)\n// Regular assets use format: SYMBOL.svg (e.g., BTC.svg)\nexport const METAMASK_PERPS_ICONS_BASE_URL =\n  'https://raw.githubusercontent.com/MetaMask/contract-metadata/master/icons/eip155:999/';\n\n// Asset configurations for multichain abstraction\nexport const HYPERLIQUID_ASSET_CONFIGS: HyperLiquidAssetConfigs = {\n  usdc: {\n    mainnet: `${ARBITRUM_MAINNET_CAIP_CHAIN_ID}/erc20:0xaf88d065e77c8cC2239327C5EDb3A432268e5831/default`,\n    testnet: `${ARBITRUM_TESTNET_CAIP_CHAIN_ID}/erc20:0x75faf114eafb1BDbe2F0316DF893fd58CE46AA4d/default`,\n  },\n};\n\n// HyperLiquid bridge contract addresses for direct USDC deposits\n// These are the official bridge contracts where USDC must be sent to credit user's HyperLiquid account\nexport const HYPERLIQUID_BRIDGE_CONTRACTS: HyperLiquidBridgeContracts = {\n  mainnet: {\n    chainId: ARBITRUM_MAINNET_CAIP_CHAIN_ID,\n    contractAddress: '0x2df1c51e09aecf9cacb7bc98cb1742757f163df7',\n  },\n  testnet: {\n    chainId: ARBITRUM_TESTNET_CAIP_CHAIN_ID,\n    contractAddress: '0x08cfc1B6b2dCF36A1480b99353A354AA8AC56f89',\n  },\n};\n\n// SDK transport configuration\nexport const HYPERLIQUID_TRANSPORT_CONFIG: HyperLiquidTransportConfig = {\n  timeout: 10_000,\n  keepAlive: { interval: 30_000 },\n  reconnect: {\n    maxRetries: 5,\n    connectionTimeout: 10_000,\n  },\n};\n\n// Trading configuration constants\nexport const TRADING_DEFAULTS: TradingDefaultsConfig = {\n  leverage: 3, // 3x default leverage\n  marginPercent: 10, // 10% fixed margin default\n  takeProfitPercent: 0.3, // 30% take profit\n  stopLossPercent: 0.1, // 10% stop loss\n  amount: {\n    mainnet: 10, // $10 minimum order size\n    testnet: 10, // $10 minimum order size\n  },\n};\n\n// Fee configuration\n// Note: These are base rates (Tier 0, no discounts)\n// Actual fees will be calculated based on user's volume tier and staking\nexport const FEE_RATES: FeeRatesConfig = {\n  taker: 0.00045, // 0.045% - Market orders and aggressive limit orders\n  maker: 0.00015, // 0.015% - Limit orders that add liquidity\n};\n\n/**\n * HIP-3 dynamic fee calculation configuration\n *\n * HIP-3 (builder-deployed) perpetual markets have variable fees based on:\n * 1. deployerFeeScale - Per-DEX fee multiplier (fetched from perpDexs API)\n * 2. growthMode - Per-asset 90% fee reduction (fetched from meta API)\n *\n * Fee Formula (from HyperLiquid docs):\n * - scaleIfHip3 = deployerFeeScale < 1 ? deployerFeeScale + 1 : deployerFeeScale * 2\n * - growthModeScale = growthMode ? 0.1 : 1\n * - finalRate = baseRate * scaleIfHip3 * growthModeScale\n *\n * Example: For xyz:TSLA with deployerFeeScale=1.0 and growthMode=\"enabled\":\n * - scaleIfHip3 = 1.0 * 2 = 2.0\n * - growthModeScale = 0.1 (90% reduction)\n * - Final multiplier = 2.0 * 0.1 = 0.2 (effectively 80% off standard 2x HIP-3 fees)\n *\n * @see https://hyperliquid.gitbook.io/hyperliquid-docs/trading/fees#fee-formula-for-developers\n * @see parseAssetName() in HyperLiquidProvider for HIP-3 asset detection\n */\nexport const HIP3_FEE_CONFIG = {\n  /**\n   * Growth Mode multiplier - 90% fee reduction for assets in growth phase\n   * This is a protocol constant from HyperLiquid's fee formula\n   */\n  GrowthModeScale: 0.1,\n\n  /**\n   * Default deployerFeeScale when API is unavailable\n   * Most HIP-3 DEXs use 1.0, which results in 2x base fees\n   */\n  DefaultDeployerFeeScale: 1.0,\n\n  /**\n   * Cache TTL for perpDexs data (5 minutes)\n   * Fee scales rarely change, so longer cache is acceptable\n   */\n  PerpDexsCacheTtlMs: 5 * 60 * 1000,\n\n  /**\n   * @deprecated Use dynamic calculation via calculateHip3FeeMultiplier()\n   * Kept for backwards compatibility during migration\n   */\n  FeeMultiplier: 2,\n} as const;\n\nconst BUILDER_FEE_MAX_FEE_DECIMAL = 0.001;\n\n// Builder fee configuration\nexport const BUILDER_FEE_CONFIG = {\n  // Test builder wallet\n  TestnetBuilder: '0x724e57771ba749650875bd8adb2e29a85d0cacfa' as Hex,\n  // Production builder wallet\n  MainnetBuilder: '0xe95a5e31904e005066614247d309e00d8ad753aa' as Hex,\n  // Fee in decimal (10 bp = 0.1%)\n  MaxFeeDecimal: BUILDER_FEE_MAX_FEE_DECIMAL,\n  MaxFeeTenthsBps: BUILDER_FEE_MAX_FEE_DECIMAL * 100000,\n  MaxFeeRate: `${(BUILDER_FEE_MAX_FEE_DECIMAL * 100)\n    .toFixed(4)\n    .replace(/\\.?0+$/u, '')}%`,\n};\n\n// Referral code configuration\nexport const REFERRAL_CONFIG = {\n  // Production referral code\n  MainnetCode: 'MMCSI',\n  // Development/testnet referral code\n  TestnetCode: 'MMCSITEST',\n};\n\n// Deposit constants\nexport const DEPOSIT_CONFIG = {\n  EstimatedGasLimit: 100000, // Estimated gas limit for bridge deposit\n  DefaultSlippage: 1, // 1% default slippage for bridge quotes\n  BridgeQuoteTimeout: 1000, // 1 second timeout for bridge quotes\n  RefreshRate: 30000, // 30 seconds quote refresh rate\n  EstimatedTime: {\n    DirectDeposit: '3-5 seconds', // Direct USDC deposit on Arbitrum\n    SameChainSwap: '30-60 seconds', // Swap on same chain before deposit\n  },\n};\n\n// Withdrawal constants (HyperLiquid-specific)\nexport const HYPERLIQUID_WITHDRAWAL_MINUTES = 5; // HyperLiquid withdrawal processing time in minutes\n\n// Type helpers\nexport type SupportedAsset = keyof typeof HYPERLIQUID_ASSET_CONFIGS;\n\n// Configuration helpers\nexport function getWebSocketEndpoint(isTestnet: boolean): string {\n  return isTestnet\n    ? HYPERLIQUID_ENDPOINTS.testnet\n    : HYPERLIQUID_ENDPOINTS.mainnet;\n}\n\nexport function getChainId(isTestnet: boolean): string {\n  return isTestnet ? ARBITRUM_TESTNET_CHAIN_ID : ARBITRUM_MAINNET_CHAIN_ID;\n}\n\nexport function getCaipChainId(isTestnet: boolean): CaipChainId {\n  const network: HyperLiquidNetwork = isTestnet ? 'testnet' : 'mainnet';\n  return HYPERLIQUID_BRIDGE_CONTRACTS[network].chainId;\n}\n\nexport function getBridgeInfo(isTestnet: boolean): BridgeContractConfig {\n  const network: HyperLiquidNetwork = isTestnet ? 'testnet' : 'mainnet';\n  return HYPERLIQUID_BRIDGE_CONTRACTS[network];\n}\n\nexport function getSupportedAssets(isTestnet?: boolean): CaipAssetId[] {\n  const network = isTestnet ? 'testnet' : 'mainnet';\n  return Object.values(HYPERLIQUID_ASSET_CONFIGS).map(\n    (config) => config[network],\n  );\n}\n\n// CAIP asset namespace constants\nexport const CAIP_ASSET_NAMESPACES = {\n  Erc20: 'erc20',\n} as const;\n\n/**\n * HyperLiquid protocol-specific configuration\n * Contains constants specific to HyperLiquid's perps exchange\n */\nexport const HYPERLIQUID_CONFIG = {\n  // Exchange name used in predicted funding data\n  // HyperLiquid uses 'HlPerp' as their perps exchange identifier\n  ExchangeName: 'HlPerp',\n} as const;\n\n/**\n * HIP-3 multi-DEX asset ID calculation constants\n * Per HIP-3-IMPLEMENTATION.md:\n * - Main DEX: assetId = index (0, 1, 2, ...)\n * - HIP-3 DEX: assetId = BASE_ASSET_ID + (perpDexIndex × DEX_MULTIPLIER) + index\n *\n * This formula enables proper order routing across multiple DEXs:\n * - Main DEX (perpDexIndex=0): Uses index directly (BTC=0, ETH=1, SOL=2, etc.)\n * - xyz DEX (perpDexIndex=1): 100000 + (1 × 10000) + index = 110000-110999\n * - abc DEX (perpDexIndex=2): 100000 + (2 × 10000) + index = 120000-120999\n *\n * Supports up to 10 HIP-3 DEXs with 10000 assets each.\n */\nexport const HIP3_ASSET_ID_CONFIG = {\n  // Base offset for HIP-3 asset IDs (100000)\n  // Ensures HIP-3 asset IDs don't conflict with main DEX indices\n  BaseAssetId: 100000,\n\n  // Multiplier for DEX index in asset ID calculation (10000)\n  // Allocates 10000 asset ID slots per DEX (0-9999)\n  DexMultiplier: 10000,\n} as const;\n\n/**\n * Basis points conversion constant\n * 1 basis point (bp) = 0.01% = 0.0001 as decimal\n * Used for fee discount calculations (e.g., 6500 bps = 65%)\n */\nexport const BASIS_POINTS_DIVISOR = 10000;\n\n/**\n * Offset added to spot market pair index to derive the spot asset ID\n * used in HyperLiquid order routing.\n * Per HyperLiquid protocol: spotAssetId = SPOT_ASSET_ID_OFFSET + pairIndex\n */\nexport const SPOT_ASSET_ID_OFFSET = 10000;\n\n/**\n * HIP-3 asset market type classifications (PRODUCTION DEFAULT)\n *\n * This is the production default configuration, can be overridden via feature flag\n * (remoteFeatureFlags.perpsAssetMarketTypes) for dynamic control.\n *\n * Maps asset symbols (e.g., \"xyz:TSLA\") to their market type for badge display.\n *\n * Market type determines the badge shown in the UI:\n * - 'equity': STOCK badge (stocks like TSLA, NVDA)\n * - 'commodity': COMMODITY badge (commodities like GOLD)\n * - 'forex': FOREX badge (forex pairs)\n * - undefined: No badge for crypto or unmapped assets\n *\n * Format: 'dex:SYMBOL' → MarketType\n * This allows flexible per-asset classification.\n * Assets not listed here will have no market type (undefined).\n */\nexport const HIP3_ASSET_MARKET_TYPES: Record<\n  string,\n  'equity' | 'commodity' | 'forex' | 'crypto'\n> = {\n  // xyz DEX - Equities\n  'xyz:TSLA': 'equity',\n  'xyz:NVDA': 'equity',\n  'xyz:XYZ100': 'equity',\n  'xyz:INTC': 'equity',\n  'xyz:MU': 'equity',\n  'xyz:CRCL': 'equity',\n  'xyz:HOOD': 'equity',\n  'xyz:SNDK': 'equity',\n  'xyz:GOOGL': 'equity',\n  'xyz:COIN': 'equity',\n  'xyz:ORCL': 'equity',\n  'xyz:AMZN': 'equity',\n  'xyz:PLTR': 'equity',\n  'xyz:AAPL': 'equity',\n  'xyz:META': 'equity',\n  'xyz:AMD': 'equity',\n  'xyz:MSFT': 'equity',\n  'xyz:BABA': 'equity',\n  'xyz:RIVN': 'equity',\n  'xyz:NFLX': 'equity',\n  'xyz:COST': 'equity',\n  'xyz:LLY': 'equity',\n  'xyz:TSM': 'equity',\n  'xyz:SKHX': 'equity',\n  'xyz:MSTR': 'equity',\n  'xyz:CRWV': 'equity',\n  'xyz:SMSN': 'equity',\n\n  'xyz:GME': 'equity',\n  'xyz:SOFTBANK': 'equity',\n  'xyz:HYUNDAI': 'equity',\n  'xyz:KIOXIA': 'equity',\n  'xyz:HIMS': 'equity',\n  'xyz:EWY': 'equity',\n  'xyz:EWJ': 'equity',\n  'xyz:SP500': 'equity',\n  'xyz:JP225': 'equity',\n  'xyz:KR200': 'equity',\n  'xyz:VIX': 'equity',\n  'xyz:USAR': 'equity',\n\n  // xyz DEX - Commodities\n  'xyz:GOLD': 'commodity',\n  'xyz:SILVER': 'commodity',\n  'xyz:CL': 'commodity',\n  'xyz:COPPER': 'commodity',\n  'xyz:ALUMINIUM': 'commodity',\n  'xyz:URANIUM': 'commodity',\n  'xyz:URNM': 'commodity',\n  'xyz:NATGAS': 'commodity',\n  'xyz:PLATINUM': 'commodity',\n  'xyz:PALLADIUM': 'commodity',\n  'xyz:BRENTOIL': 'commodity',\n\n  // xyz DEX - Forex\n  'xyz:EUR': 'forex',\n  'xyz:JPY': 'forex',\n  'xyz:DXY': 'forex',\n} as const;\n\n/**\n * Testnet-specific HIP-3 DEX configuration\n *\n * On testnet, there are many HIP-3 DEXs (test deployments from various builders).\n * Subscribing to all of them causes connection/subscription overload and instability.\n * This configuration limits which DEXs are discovered and subscribed to on testnet.\n */\nexport const TESTNET_HIP3_CONFIG = {\n  /**\n   * Allowed DEX names for testnet\n   * Empty array = main DEX only (no HIP-3 DEXs)\n   * Add specific DEX names to test with particular HIP-3 DEXs: ['testdex1', 'testdex2']\n   */\n  EnabledDexs: ['xyz'] as string[],\n\n  /**\n   * Set to true to enable full HIP-3 discovery on testnet (not recommended)\n   * When false, only DEXs in ENABLED_DEXS are used\n   */\n  AutoDiscoverAll: false,\n} as const;\n\n/**\n * Mainnet-specific HIP-3 DEX configuration\n *\n * On mainnet, DEX filtering is dynamically determined from the allowlist markets\n * feature flag. This avoids hardcoding DEX names and ensures consistency with\n * the market filtering logic.\n *\n * When AutoDiscoverAll is false and no allowlist is provided, only the main DEX is used.\n * When an allowlist is provided, DEXs are extracted from the allowlist patterns.\n */\nexport const MAINNET_HIP3_CONFIG = {\n  /**\n   * Set to true to enable full HIP-3 discovery on mainnet\n   * When false, DEXs are filtered based on the allowlist markets feature flag\n   * (recommended for production to reduce subscription overhead)\n   */\n  AutoDiscoverAll: false,\n} as const;\n\n/**\n * HIP-3 margin management configuration\n * Controls margin buffers and auto-rebalance behavior for HIP-3 DEXes with isolated margin\n *\n * Background: HyperLiquid validates availableBalance >= totalRequiredMargin BEFORE reallocating\n * existing locked margin. This requires temporary over-funding when increasing positions,\n * followed by automatic cleanup to minimize locked capital.\n */\nexport const HIP3_MARGIN_CONFIG = {\n  /**\n   * Margin buffer multiplier for fees and slippage (0.3% = multiply by 1.003)\n   * Covers HyperLiquid's max taker fee (0.035%) with comfortable margin\n   */\n  BufferMultiplier: 1.003,\n\n  /**\n   * Desired buffer to keep on HIP-3 DEX after auto-rebalance (USDC amount)\n   * Small buffer allows quick follow-up orders without transfers\n   */\n  RebalanceDesiredBuffer: 0.1,\n\n  /**\n   * Minimum excess threshold to trigger auto-rebalance (USDC amount)\n   * Prevents unnecessary transfers for tiny amounts\n   */\n  RebalanceMinThreshold: 0.1,\n} as const;\n\n/**\n * Configuration for USDH collateral handling on HIP-3 DEXs\n * Per HyperLiquid docs: USDH DEXs pull collateral from spot balance automatically\n *\n * USDH is HyperLiquid's native stablecoin pegged 1:1 to USDC\n */\nexport const USDH_CONFIG = {\n  /** Token name for USDH collateral */\n  TokenName: 'USDH',\n\n  /**\n   * Maximum slippage for USDC→USDH spot swap in basis points\n   * USDH is pegged 1:1 to USDC so slippage should be minimal\n   * 10 bps (0.1%) provides small buffer for spread\n   */\n  SwapSlippageBps: 10,\n} as const;\n\n// Progress bar constants\nexport const INITIAL_AMOUNT_UI_PROGRESS = 10;\nexport const WITHDRAWAL_PROGRESS_STAGES = [\n  25, 35, 45, 55, 65, 75, 85, 90, 95, 98,\n];\nexport const PROGRESS_BAR_COMPLETION_DELAY_MS = 500;\n"]}
+{"version":3,"file":"hyperLiquidConfig.mjs","sourceRoot":"","sources":["../../src/constants/hyperLiquidConfig.ts"],"names":[],"mappings":"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","sourcesContent":["import type { CaipAssetId, CaipChainId, Hex } from '@metamask/utils';\n\nimport type {\n  HyperLiquidNetwork,\n  HyperLiquidEndpoints,\n  HyperLiquidAssetConfigs,\n  BridgeContractConfig,\n  HyperLiquidBridgeContracts,\n  HyperLiquidTransportConfig,\n  TradingDefaultsConfig,\n  FeeRatesConfig,\n} from '../types/perps-types';\n\n// Network constants\nexport const ARBITRUM_MAINNET_CHAIN_ID_HEX = '0xa4b1' as const;\nexport const ARBITRUM_MAINNET_CHAIN_ID = '42161';\nexport const ARBITRUM_TESTNET_CHAIN_ID = '421614';\nexport const ARBITRUM_MAINNET_CAIP_CHAIN_ID = `eip155:${ARBITRUM_MAINNET_CHAIN_ID}`;\nexport const ARBITRUM_TESTNET_CAIP_CHAIN_ID = `eip155:${ARBITRUM_TESTNET_CHAIN_ID}`;\n\n// Hyperliquid chain constants\nexport const HYPERLIQUID_MAINNET_CHAIN_ID = '0x3e7'; // 999 in decimal\nexport const HYPERLIQUID_TESTNET_CHAIN_ID = '0x3e6'; // 998 in decimal (assumed)\nexport const HYPERLIQUID_MAINNET_CAIP_CHAIN_ID = 'eip155:999' as CaipChainId;\nexport const HYPERLIQUID_TESTNET_CAIP_CHAIN_ID = 'eip155:998' as CaipChainId;\nexport const HYPERLIQUID_NETWORK_NAME = 'Hyperliquid';\n\n// Token constants\nexport const USDC_SYMBOL = 'USDC';\nexport const USDC_NAME = 'USD Coin';\nexport const USDC_DECIMALS = 6;\nexport const TOKEN_DECIMALS = 18;\n\n// Network constants\nexport const ARBITRUM_SEPOLIA_CHAIN_ID = '0x66eee'; // 421614 in decimal\n\n// USDC token addresses\nexport const USDC_ETHEREUM_MAINNET_ADDRESS =\n  '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48';\nexport const USDC_ARBITRUM_MAINNET_ADDRESS =\n  '0xaf88d065e77c8cC2239327C5EDb3A432268e5831';\nexport const USDC_ARBITRUM_TESTNET_ADDRESS =\n  '0x75faf114eafb1BDbe2F0316DF893fd58CE46AA4d';\n\n// USDC token icon URL using MetaMask's official Token Icons API\n// Format: https://static.cx.metamask.io/api/v1/tokenIcons/{chainId}/{contractAddress}.png\n// This URL follows the same pattern used throughout MetaMask (bridges, swaps, etc.)\nexport const USDC_TOKEN_ICON_URL = `https://static.cx.metamask.io/api/v1/tokenIcons/1/${USDC_ETHEREUM_MAINNET_ADDRESS}.png`;\n\n// WebSocket endpoints\nexport const HYPERLIQUID_ENDPOINTS: HyperLiquidEndpoints = {\n  mainnet: 'wss://api.hyperliquid.xyz/ws',\n  testnet: 'wss://api.hyperliquid-testnet.xyz/ws',\n};\n\n// Asset icons base URL (HyperLiquid CDN - fallback source)\nexport const HYPERLIQUID_ASSET_ICONS_BASE_URL =\n  'https://app.hyperliquid.xyz/coins/';\n\n// MetaMask-hosted Perps asset icons (primary source)\n// Assets uploaded to: https://github.com/MetaMask/contract-metadata/tree/master/icons/eip155:999\n// HIP-3 assets use format: hip3:dex_SYMBOL.svg (e.g., hip3:xyz_AAPL.svg)\n// Regular assets use format: SYMBOL.svg (e.g., BTC.svg)\nexport const METAMASK_PERPS_ICONS_BASE_URL =\n  'https://raw.githubusercontent.com/MetaMask/contract-metadata/master/icons/eip155:999/';\n\n// Asset configurations for multichain abstraction\nexport const HYPERLIQUID_ASSET_CONFIGS: HyperLiquidAssetConfigs = {\n  usdc: {\n    mainnet: `${ARBITRUM_MAINNET_CAIP_CHAIN_ID}/erc20:0xaf88d065e77c8cC2239327C5EDb3A432268e5831/default`,\n    testnet: `${ARBITRUM_TESTNET_CAIP_CHAIN_ID}/erc20:0x75faf114eafb1BDbe2F0316DF893fd58CE46AA4d/default`,\n  },\n};\n\n// HyperLiquid bridge contract addresses for direct USDC deposits\n// These are the official bridge contracts where USDC must be sent to credit user's HyperLiquid account\nexport const HYPERLIQUID_BRIDGE_CONTRACTS: HyperLiquidBridgeContracts = {\n  mainnet: {\n    chainId: ARBITRUM_MAINNET_CAIP_CHAIN_ID,\n    contractAddress: '0x2df1c51e09aecf9cacb7bc98cb1742757f163df7',\n  },\n  testnet: {\n    chainId: ARBITRUM_TESTNET_CAIP_CHAIN_ID,\n    contractAddress: '0x08cfc1B6b2dCF36A1480b99353A354AA8AC56f89',\n  },\n};\n\n// SDK transport configuration\nexport const HYPERLIQUID_TRANSPORT_CONFIG: HyperLiquidTransportConfig = {\n  timeout: 10_000,\n  keepAlive: { interval: 30_000 },\n  reconnect: {\n    maxRetries: 5,\n    connectionTimeout: 10_000,\n  },\n};\n\n// Trading configuration constants\nexport const TRADING_DEFAULTS: TradingDefaultsConfig = {\n  leverage: 3, // 3x default leverage\n  marginPercent: 10, // 10% fixed margin default\n  takeProfitPercent: 0.3, // 30% take profit\n  stopLossPercent: 0.1, // 10% stop loss\n  amount: {\n    mainnet: 10, // $10 minimum order size\n    testnet: 10, // $10 minimum order size\n  },\n};\n\n// Fee configuration\n// Note: These are base rates (Tier 0, no discounts)\n// Actual fees will be calculated based on user's volume tier and staking\nexport const FEE_RATES: FeeRatesConfig = {\n  taker: 0.00045, // 0.045% - Market orders and aggressive limit orders\n  maker: 0.00015, // 0.015% - Limit orders that add liquidity\n};\n\n/**\n * HIP-3 dynamic fee calculation configuration\n *\n * HIP-3 (builder-deployed) perpetual markets have variable fees based on:\n * 1. deployerFeeScale - Per-DEX fee multiplier (fetched from perpDexs API)\n * 2. growthMode - Per-asset 90% fee reduction (fetched from meta API)\n *\n * Fee Formula (from HyperLiquid docs):\n * - scaleIfHip3 = deployerFeeScale < 1 ? deployerFeeScale + 1 : deployerFeeScale * 2\n * - growthModeScale = growthMode ? 0.1 : 1\n * - finalRate = baseRate * scaleIfHip3 * growthModeScale\n *\n * Example: For xyz:TSLA with deployerFeeScale=1.0 and growthMode=\"enabled\":\n * - scaleIfHip3 = 1.0 * 2 = 2.0\n * - growthModeScale = 0.1 (90% reduction)\n * - Final multiplier = 2.0 * 0.1 = 0.2 (effectively 80% off standard 2x HIP-3 fees)\n *\n * @see https://hyperliquid.gitbook.io/hyperliquid-docs/trading/fees#fee-formula-for-developers\n * @see parseAssetName() in HyperLiquidProvider for HIP-3 asset detection\n */\nexport const HIP3_FEE_CONFIG = {\n  /**\n   * Growth Mode multiplier - 90% fee reduction for assets in growth phase\n   * This is a protocol constant from HyperLiquid's fee formula\n   */\n  GrowthModeScale: 0.1,\n\n  /**\n   * Default deployerFeeScale when API is unavailable\n   * Most HIP-3 DEXs use 1.0, which results in 2x base fees\n   */\n  DefaultDeployerFeeScale: 1.0,\n\n  /**\n   * Cache TTL for perpDexs data (5 minutes)\n   * Fee scales rarely change, so longer cache is acceptable\n   */\n  PerpDexsCacheTtlMs: 5 * 60 * 1000,\n\n  /**\n   * @deprecated Use dynamic calculation via calculateHip3FeeMultiplier()\n   * Kept for backwards compatibility during migration\n   */\n  FeeMultiplier: 2,\n} as const;\n\nconst BUILDER_FEE_MAX_FEE_DECIMAL = 0.001;\n\n// Builder fee configuration\nexport const BUILDER_FEE_CONFIG = {\n  // Test builder wallet\n  TestnetBuilder: '0x724e57771ba749650875bd8adb2e29a85d0cacfa' as Hex,\n  // Production builder wallet\n  MainnetBuilder: '0xe95a5e31904e005066614247d309e00d8ad753aa' as Hex,\n  // Fee in decimal (10 bp = 0.1%)\n  MaxFeeDecimal: BUILDER_FEE_MAX_FEE_DECIMAL,\n  MaxFeeTenthsBps: BUILDER_FEE_MAX_FEE_DECIMAL * 100000,\n  MaxFeeRate: `${(BUILDER_FEE_MAX_FEE_DECIMAL * 100)\n    .toFixed(4)\n    .replace(/\\.?0+$/u, '')}%`,\n};\n\n// Referral code configuration\nexport const REFERRAL_CONFIG = {\n  // Production referral code\n  MainnetCode: 'MMCSI',\n  // Development/testnet referral code\n  TestnetCode: 'MMCSITEST',\n};\n\n// Deposit constants\nexport const DEPOSIT_CONFIG = {\n  EstimatedGasLimit: 100000, // Estimated gas limit for bridge deposit\n  DefaultSlippage: 1, // 1% default slippage for bridge quotes\n  BridgeQuoteTimeout: 1000, // 1 second timeout for bridge quotes\n  RefreshRate: 30000, // 30 seconds quote refresh rate\n  EstimatedTime: {\n    DirectDeposit: '3-5 seconds', // Direct USDC deposit on Arbitrum\n    SameChainSwap: '30-60 seconds', // Swap on same chain before deposit\n  },\n};\n\n// Withdrawal constants (HyperLiquid-specific)\nexport const HYPERLIQUID_WITHDRAWAL_MINUTES = 5; // HyperLiquid withdrawal processing time in minutes\n\n// Type helpers\nexport type SupportedAsset = keyof typeof HYPERLIQUID_ASSET_CONFIGS;\n\n// Configuration helpers\nexport function getWebSocketEndpoint(isTestnet: boolean): string {\n  return isTestnet\n    ? HYPERLIQUID_ENDPOINTS.testnet\n    : HYPERLIQUID_ENDPOINTS.mainnet;\n}\n\nexport function getChainId(isTestnet: boolean): string {\n  return isTestnet ? ARBITRUM_TESTNET_CHAIN_ID : ARBITRUM_MAINNET_CHAIN_ID;\n}\n\nexport function getCaipChainId(isTestnet: boolean): CaipChainId {\n  const network: HyperLiquidNetwork = isTestnet ? 'testnet' : 'mainnet';\n  return HYPERLIQUID_BRIDGE_CONTRACTS[network].chainId;\n}\n\nexport function getBridgeInfo(isTestnet: boolean): BridgeContractConfig {\n  const network: HyperLiquidNetwork = isTestnet ? 'testnet' : 'mainnet';\n  return HYPERLIQUID_BRIDGE_CONTRACTS[network];\n}\n\nexport function getSupportedAssets(isTestnet?: boolean): CaipAssetId[] {\n  const network = isTestnet ? 'testnet' : 'mainnet';\n  return Object.values(HYPERLIQUID_ASSET_CONFIGS).map(\n    (config) => config[network],\n  );\n}\n\n// CAIP asset namespace constants\nexport const CAIP_ASSET_NAMESPACES = {\n  Erc20: 'erc20',\n} as const;\n\n/**\n * HyperLiquid protocol-specific configuration\n * Contains constants specific to HyperLiquid's perps exchange\n */\nexport const HYPERLIQUID_CONFIG = {\n  // Exchange name used in predicted funding data\n  // HyperLiquid uses 'HlPerp' as their perps exchange identifier\n  ExchangeName: 'HlPerp',\n} as const;\n\n/**\n * HIP-3 multi-DEX asset ID calculation constants\n * Per HIP-3-IMPLEMENTATION.md:\n * - Main DEX: assetId = index (0, 1, 2, ...)\n * - HIP-3 DEX: assetId = BASE_ASSET_ID + (perpDexIndex × DEX_MULTIPLIER) + index\n *\n * This formula enables proper order routing across multiple DEXs:\n * - Main DEX (perpDexIndex=0): Uses index directly (BTC=0, ETH=1, SOL=2, etc.)\n * - xyz DEX (perpDexIndex=1): 100000 + (1 × 10000) + index = 110000-110999\n * - abc DEX (perpDexIndex=2): 100000 + (2 × 10000) + index = 120000-120999\n *\n * Supports up to 10 HIP-3 DEXs with 10000 assets each.\n */\nexport const HIP3_ASSET_ID_CONFIG = {\n  // Base offset for HIP-3 asset IDs (100000)\n  // Ensures HIP-3 asset IDs don't conflict with main DEX indices\n  BaseAssetId: 100000,\n\n  // Multiplier for DEX index in asset ID calculation (10000)\n  // Allocates 10000 asset ID slots per DEX (0-9999)\n  DexMultiplier: 10000,\n} as const;\n\n/**\n * Basis points conversion constant\n * 1 basis point (bp) = 0.01% = 0.0001 as decimal\n * Used for fee discount calculations (e.g., 6500 bps = 65%)\n */\nexport const BASIS_POINTS_DIVISOR = 10000;\n\n/**\n * Offset added to spot market pair index to derive the spot asset ID\n * used in HyperLiquid order routing.\n * Per HyperLiquid protocol: spotAssetId = SPOT_ASSET_ID_OFFSET + pairIndex\n */\nexport const SPOT_ASSET_ID_OFFSET = 10000;\n\n/**\n * HIP-3 asset market type classifications (PRODUCTION DEFAULT)\n *\n * This is the production default configuration, can be overridden via feature flag\n * (remoteFeatureFlags.perpsAssetMarketTypes) for dynamic control.\n *\n * Maps asset symbols (e.g., \"xyz:TSLA\") to their market type for badge display.\n *\n * Market type determines the badge shown in the UI:\n * - 'equity': STOCK badge (stocks like TSLA, NVDA)\n * - 'commodity': COMMODITY badge (commodities like GOLD)\n * - 'forex': FOREX badge (forex pairs)\n * - undefined: No badge for crypto or unmapped assets\n *\n * Format: 'dex:SYMBOL' → MarketType\n * This allows flexible per-asset classification.\n * Assets not listed here will have no market type (undefined).\n */\nexport const HIP3_ASSET_MARKET_TYPES: Record<\n  string,\n  'equity' | 'commodity' | 'forex' | 'crypto'\n> = {\n  // xyz DEX - Equities\n  'xyz:TSLA': 'equity',\n  'xyz:NVDA': 'equity',\n  'xyz:XYZ100': 'equity',\n  'xyz:INTC': 'equity',\n  'xyz:MU': 'equity',\n  'xyz:CRCL': 'equity',\n  'xyz:HOOD': 'equity',\n  'xyz:SNDK': 'equity',\n  'xyz:GOOGL': 'equity',\n  'xyz:COIN': 'equity',\n  'xyz:ORCL': 'equity',\n  'xyz:AMZN': 'equity',\n  'xyz:PLTR': 'equity',\n  'xyz:AAPL': 'equity',\n  'xyz:META': 'equity',\n  'xyz:AMD': 'equity',\n  'xyz:MSFT': 'equity',\n  'xyz:BABA': 'equity',\n  'xyz:RIVN': 'equity',\n  'xyz:NFLX': 'equity',\n  'xyz:COST': 'equity',\n  'xyz:LLY': 'equity',\n  'xyz:TSM': 'equity',\n  'xyz:SKHX': 'equity',\n  'xyz:MSTR': 'equity',\n  'xyz:CRWV': 'equity',\n  'xyz:SMSN': 'equity',\n\n  'xyz:GME': 'equity',\n  'xyz:SOFTBANK': 'equity',\n  'xyz:HYUNDAI': 'equity',\n  'xyz:KIOXIA': 'equity',\n  'xyz:HIMS': 'equity',\n  'xyz:EWY': 'equity',\n  'xyz:EWJ': 'equity',\n  'xyz:SP500': 'equity',\n  'xyz:JP225': 'equity',\n  'xyz:KR200': 'equity',\n  'xyz:VIX': 'equity',\n  'xyz:USAR': 'equity',\n\n  // xyz DEX - Commodities\n  'xyz:GOLD': 'commodity',\n  'xyz:SILVER': 'commodity',\n  'xyz:CL': 'commodity',\n  'xyz:COPPER': 'commodity',\n  'xyz:ALUMINIUM': 'commodity',\n  'xyz:URANIUM': 'commodity',\n  'xyz:URNM': 'commodity',\n  'xyz:NATGAS': 'commodity',\n  'xyz:PLATINUM': 'commodity',\n  'xyz:PALLADIUM': 'commodity',\n  'xyz:BRENTOIL': 'commodity',\n\n  // xyz DEX - Forex\n  'xyz:EUR': 'forex',\n  'xyz:JPY': 'forex',\n  'xyz:DXY': 'forex',\n} as const;\n\n/**\n * Testnet-specific HIP-3 DEX configuration\n *\n * On testnet, there are many HIP-3 DEXs (test deployments from various builders).\n * Subscribing to all of them causes connection/subscription overload and instability.\n * This configuration limits which DEXs are discovered and subscribed to on testnet.\n */\nexport const TESTNET_HIP3_CONFIG = {\n  /**\n   * Allowed DEX names for testnet\n   * Empty array = main DEX only (no HIP-3 DEXs)\n   * Add specific DEX names to test with particular HIP-3 DEXs: ['testdex1', 'testdex2']\n   */\n  EnabledDexs: ['xyz'] as string[],\n\n  /**\n   * Set to true to enable full HIP-3 discovery on testnet (not recommended)\n   * When false, only DEXs in ENABLED_DEXS are used\n   */\n  AutoDiscoverAll: false,\n} as const;\n\n/**\n * Mainnet-specific HIP-3 DEX configuration\n *\n * On mainnet, DEX filtering is dynamically determined from the allowlist markets\n * feature flag. This avoids hardcoding DEX names and ensures consistency with\n * the market filtering logic.\n *\n * When AutoDiscoverAll is false and no allowlist is provided, only the main DEX is used.\n * When an allowlist is provided, DEXs are extracted from the allowlist patterns.\n */\nexport const MAINNET_HIP3_CONFIG = {\n  /**\n   * Set to true to enable full HIP-3 discovery on mainnet\n   * When false, DEXs are filtered based on the allowlist markets feature flag\n   * (recommended for production to reduce subscription overhead)\n   */\n  AutoDiscoverAll: false,\n} as const;\n\n/**\n * HIP-3 margin management configuration\n * Controls margin buffers and auto-rebalance behavior for HIP-3 DEXes with isolated margin\n *\n * Background: HyperLiquid validates spendableBalance >= totalRequiredMargin BEFORE reallocating\n * existing locked margin. This requires temporary over-funding when increasing positions,\n * followed by automatic cleanup to minimize locked capital.\n */\nexport const HIP3_MARGIN_CONFIG = {\n  /**\n   * Margin buffer multiplier for fees and slippage (0.3% = multiply by 1.003)\n   * Covers HyperLiquid's max taker fee (0.035%) with comfortable margin\n   */\n  BufferMultiplier: 1.003,\n\n  /**\n   * Desired buffer to keep on HIP-3 DEX after auto-rebalance (USDC amount)\n   * Small buffer allows quick follow-up orders without transfers\n   */\n  RebalanceDesiredBuffer: 0.1,\n\n  /**\n   * Minimum excess threshold to trigger auto-rebalance (USDC amount)\n   * Prevents unnecessary transfers for tiny amounts\n   */\n  RebalanceMinThreshold: 0.1,\n} as const;\n\n/**\n * Configuration for USDH collateral handling on HIP-3 DEXs\n * Per HyperLiquid docs: USDH DEXs pull collateral from spot balance automatically\n *\n * USDH is HyperLiquid's native stablecoin pegged 1:1 to USDC\n */\nexport const USDH_CONFIG = {\n  /** Token name for USDH collateral */\n  TokenName: 'USDH',\n\n  /**\n   * Maximum slippage for USDC→USDH spot swap in basis points\n   * USDH is pegged 1:1 to USDC so slippage should be minimal\n   * 10 bps (0.1%) provides small buffer for spread\n   */\n  SwapSlippageBps: 10,\n} as const;\n\n// Progress bar constants\nexport const INITIAL_AMOUNT_UI_PROGRESS = 10;\nexport const WITHDRAWAL_PROGRESS_STAGES = [\n  25, 35, 45, 55, 65, 75, 85, 90, 95, 98,\n];\nexport const PROGRESS_BAR_COMPLETION_DELAY_MS = 500;\n"]}

package/dist/constants/perpsConfig.cjs

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.buildProviderCacheKey = exports.getProviderNetworkKey = exports.PERPS_DISK_CACHE_THROTTLE_MS = exports.PERPS_DISK_CACHE_USER_DATA = exports.PERPS_DISK_CACHE_MARKETS = exports.PROVIDER_CONFIG = exports.FUNDING_RATE_CONFIG = exports.MARKET_SORTING_CONFIG = exports.DECIMAL_PRECISION_CONFIG = exports.DATA_LAKE_API_CONFIG = exports.MARGIN_ADJUSTMENT_CONFIG = exports.CLOSE_POSITION_CONFIG = exports.HYPERLIQUID_ORDER_LIMITS = exports.TP_SL_CONFIG = exports.PERFORMANCE_CONFIG = exports.MAX_ORDER_MARGIN_BUFFER = exports.ORDER_SLIPPAGE_CONFIG = exports.VALIDATION_THRESHOLDS = exports.WITHDRAWAL_CONSTANTS = exports.PERPS_CONSTANTS = exports.ZERO_BALANCE = exports.ZERO_ADDRESS = void 0;
+exports.buildProviderCacheKey = exports.getProviderNetworkKey = exports.ABSTRACTION_MODE_REFRESH_THROTTLE_MS = exports.PERPS_DISK_CACHE_THROTTLE_MS = exports.PERPS_DISK_CACHE_USER_DATA = exports.PERPS_DISK_CACHE_MARKETS = exports.PROVIDER_CONFIG = exports.FUNDING_RATE_CONFIG = exports.MARKET_SORTING_CONFIG = exports.DECIMAL_PRECISION_CONFIG = exports.DATA_LAKE_API_CONFIG = exports.MARGIN_ADJUSTMENT_CONFIG = exports.CLOSE_POSITION_CONFIG = exports.HYPERLIQUID_ORDER_LIMITS = exports.TP_SL_CONFIG = exports.PERFORMANCE_CONFIG = exports.MAX_ORDER_MARGIN_BUFFER = exports.ORDER_SLIPPAGE_CONFIG = exports.VALIDATION_THRESHOLDS = exports.WITHDRAWAL_CONSTANTS = exports.PERPS_CONSTANTS = exports.ZERO_BALANCE = exports.ZERO_ADDRESS = void 0;
 /**
  * Perps feature constants - Controller layer (portable)
  *
@@ -347,10 +347,22 @@ exports.PROVIDER_CONFIG = {
     /** Force MYX to testnet only (mainnet credentials not yet available) */
     MYX_TESTNET_ONLY: false,
 };
-// Disk-backed cold-start cache keys and throttle interval
+// Disk-backed cold-start cache keys and throttle interval.
+// The user-data key ends in _V2 because the AccountState balance contract
+// changed (TAT-3047) and has no in-payload version field. Bumping the key
+// forces a one-time empty cache on upgrade — consumers fall through to
+// skeleton/fallback until the first WS tick, avoiding stale legacy-shape
+// reads that would surface as $0 balances.
 exports.PERPS_DISK_CACHE_MARKETS = 'PERPS_DISK_CACHE_MARKETS';
-exports.PERPS_DISK_CACHE_USER_DATA = 'PERPS_DISK_CACHE_USER_DATA';
+exports.PERPS_DISK_CACHE_USER_DATA = 'PERPS_DISK_CACHE_USER_DATA_V2';
 exports.PERPS_DISK_CACHE_THROTTLE_MS = 30000;
+/**
+ * Minimum interval between WebSocket-triggered HL `userAbstraction`
+ * refreshes. Balances picking up HL-web mode flips (Unified ↔ Standard)
+ * promptly against burning REST quota on every spot tick. Covers the
+ * observed user pattern of flipping mode once per session at most.
+ */
+exports.ABSTRACTION_MODE_REFRESH_THROTTLE_MS = 60000;
 /**
  * Build the standard provider:network cache key from controller state.
  *

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  // 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.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.\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/constants/perpsConfig.d.cts

@@ -244,8 +244,15 @@ export declare const PROVIDER_CONFIG: {
     readonly MYX_TESTNET_ONLY: false;
 };
 export declare const PERPS_DISK_CACHE_MARKETS = "PERPS_DISK_CACHE_MARKETS";
-export declare const PERPS_DISK_CACHE_USER_DATA = "PERPS_DISK_CACHE_USER_DATA";
+export declare const PERPS_DISK_CACHE_USER_DATA = "PERPS_DISK_CACHE_USER_DATA_V2";
 export declare const PERPS_DISK_CACHE_THROTTLE_MS = 30000;
+/**
+ * Minimum interval between WebSocket-triggered HL `userAbstraction`
+ * refreshes. Balances picking up HL-web mode flips (Unified ↔ Standard)
+ * promptly against burning REST quota on every spot tick. Covers the
+ * observed user pattern of flipping mode once per session at most.
+ */
+export declare const ABSTRACTION_MODE_REFRESH_THROTTLE_MS = 60000;
 /**
  * Build the standard provider:network cache key from controller state.
  *

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;;;;;;;;;;;;;;;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"}
+{"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;AAQX,eAAO,MAAM,wBAAwB,6BAA6B,CAAC;AACnE,eAAO,MAAM,0BAA0B,kCAAkC,CAAC;AAC1E,eAAO,MAAM,4BAA4B,QAAS,CAAC;AAEnD;;;;;GAKG;AACH,eAAO,MAAM,oCAAoC,QAAS,CAAC;AAE3D;;;;;;;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

@@ -244,8 +244,15 @@ export declare const PROVIDER_CONFIG: {
     readonly MYX_TESTNET_ONLY: false;
 };
 export declare const PERPS_DISK_CACHE_MARKETS = "PERPS_DISK_CACHE_MARKETS";
-export declare const PERPS_DISK_CACHE_USER_DATA = "PERPS_DISK_CACHE_USER_DATA";
+export declare const PERPS_DISK_CACHE_USER_DATA = "PERPS_DISK_CACHE_USER_DATA_V2";
 export declare const PERPS_DISK_CACHE_THROTTLE_MS = 30000;
+/**
+ * Minimum interval between WebSocket-triggered HL `userAbstraction`
+ * refreshes. Balances picking up HL-web mode flips (Unified ↔ Standard)
+ * promptly against burning REST quota on every spot tick. Covers the
+ * observed user pattern of flipping mode once per session at most.
+ */
+export declare const ABSTRACTION_MODE_REFRESH_THROTTLE_MS = 60000;
 /**
  * Build the standard provider:network cache key from controller state.
  *

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;;;;;;;;;;;;;;;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"}
+{"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;AAQX,eAAO,MAAM,wBAAwB,6BAA6B,CAAC;AACnE,eAAO,MAAM,0BAA0B,kCAAkC,CAAC;AAC1E,eAAO,MAAM,4BAA4B,QAAS,CAAC;AAEnD;;;;;GAKG;AACH,eAAO,MAAM,oCAAoC,QAAS,CAAC;AAE3D;;;;;;;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

@@ -344,10 +344,22 @@ export const PROVIDER_CONFIG = {
     /** Force MYX to testnet only (mainnet credentials not yet available) */
     MYX_TESTNET_ONLY: false,
 };
-// Disk-backed cold-start cache keys and throttle interval
+// Disk-backed cold-start cache keys and throttle interval.
+// The user-data key ends in _V2 because the AccountState balance contract
+// changed (TAT-3047) and has no in-payload version field. Bumping the key
+// forces a one-time empty cache on upgrade — consumers fall through to
+// skeleton/fallback until the first WS tick, avoiding stale legacy-shape
+// reads that would surface as $0 balances.
 export const PERPS_DISK_CACHE_MARKETS = 'PERPS_DISK_CACHE_MARKETS';
-export const PERPS_DISK_CACHE_USER_DATA = 'PERPS_DISK_CACHE_USER_DATA';
+export const PERPS_DISK_CACHE_USER_DATA = 'PERPS_DISK_CACHE_USER_DATA_V2';
 export const PERPS_DISK_CACHE_THROTTLE_MS = 30000;
+/**
+ * Minimum interval between WebSocket-triggered HL `userAbstraction`
+ * refreshes. Balances picking up HL-web mode flips (Unified ↔ Standard)
+ * promptly against burning REST quota on every spot tick. Covers the
+ * observed user pattern of flipping mode once per session at most.
+ */
+export const ABSTRACTION_MODE_REFRESH_THROTTLE_MS = 60000;
 /**
  * Build the standard provider:network cache key from controller state.
  *