@metamask-previews/perps-controller 0.0.0-preview-685dbf46b → 1.0.0-preview-bc00f2c

package/dist/constants/perpsConfig.cjs

@@ -0,0 +1,295 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PROVIDER_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.ORDER_SLIPPAGE_CONFIG = exports.VALIDATION_THRESHOLDS = exports.WITHDRAWAL_CONSTANTS = exports.PERPS_CONSTANTS = void 0;
+/**
+ * Perps feature constants - Controller layer (portable)
+ *
+ * This file contains only controller-portable configuration:
+ * - Constants used by controller logic, providers, and services
+ * - Calculation thresholds, API configs, and protocol constants
+ *
+ * UI-only constants (layout, display, navigation) live in:
+ * app/components/UI/Perps/constants/perpsConfig.ts
+ */
+exports.PERPS_CONSTANTS = {
+    FeatureFlagKey: 'perpsEnabled',
+    FeatureName: 'perps', // Constant for Sentry error filtering - enables "feature:perps" dashboard queries
+    /** Token description used to identify the synthetic "Perps balance" option in pay-with token lists */
+    PerpsBalanceTokenDescription: 'perps-balance',
+    /** Symbol displayed for the synthetic "Perps balance" token in pay-with token lists */
+    PerpsBalanceTokenSymbol: 'USD',
+    WebsocketTimeout: 5000, // 5 seconds
+    WebsocketCleanupDelay: 1000, // 1 second
+    BackgroundDisconnectDelay: 20000, // 20 seconds delay before disconnecting when app is backgrounded or when user exits perps UX
+    ConnectionTimeoutMs: 10000, // 10 seconds timeout for connection and position loading states
+    DefaultMonitoringTimeoutMs: 10000, // 10 seconds default timeout for data monitoring operations
+    // Connection timing constants
+    ConnectionGracePeriodMs: 20000, // 20 seconds grace period before actual disconnection (same as BackgroundDisconnectDelay for semantic clarity)
+    ConnectionAttemptTimeoutMs: 30000, // 30 seconds timeout for connection attempts to prevent indefinite hanging
+    WebsocketPingTimeoutMs: 5000, // 5 seconds timeout for WebSocket health check ping
+    ConnectRetryDelayMs: 200, // Delay before retrying connect() when connection isn't ready yet
+    ReconnectionCleanupDelayMs: 500, // Platform-agnostic delay to ensure WebSocket is ready
+    ReconnectionDelayAndroidMs: 300, // Android-specific reconnection delay for better reliability on slower devices
+    ReconnectionDelayIosMs: 100, // iOS-specific reconnection delay for optimal performance
+    ReconnectionRetryDelayMs: 5000, // 5 seconds delay between reconnection attempts
+    // Connection manager timing constants
+    BalanceUpdateThrottleMs: 15000, // Update at most every 15 seconds to reduce state updates in PerpsConnectionManager
+    InitialDataDelayMs: 100, // Delay to allow initial data to load after connection establishment
+    // Deposit toast timing
+    DepositTakingLongerToastDelayMs: 30000, // Delay before showing "Deposit taking longer than usual" toast
+    DefaultAssetPreviewLimit: 5,
+    DefaultMaxLeverage: 3, // Default fallback max leverage when market data is unavailable - conservative default
+    FallbackPriceDisplay: '$---', // Display when price data is unavailable
+    FallbackPercentageDisplay: '--%', // Display when change data is unavailable
+    FallbackDataDisplay: '--', // Display when non-price data is unavailable
+    ZeroAmountDisplay: '$0', // Display for zero dollar amounts (e.g., no volume)
+    ZeroAmountDetailedDisplay: '$0.00', // Display for zero dollar amounts with decimals
+    RecentActivityLimit: 3,
+    // Historical data fetching constants
+    FillsLookbackMs: 90 * 24 * 60 * 60 * 1000, // 3 months in milliseconds - limits REST API fills fetch
+};
+/**
+ * Withdrawal-specific constants (protocol-agnostic)
+ * Note: Protocol-specific values like estimated time should be defined in each protocol's config
+ */
+exports.WITHDRAWAL_CONSTANTS = {
+    DefaultMinAmount: '1.01', // Default minimum withdrawal amount in USDC
+    DefaultFeeAmount: 1, // Default withdrawal fee in USDC
+    DefaultFeeToken: 'USDC', // Default fee token
+};
+/**
+ * Validation thresholds for UI warnings and checks
+ * These values control when warnings are shown to users
+ */
+exports.VALIDATION_THRESHOLDS = {
+    // Leverage threshold for warning users about high leverage
+    HighLeverageWarning: 20, // Show warning when leverage > 20x
+    // Limit price difference threshold (as decimal, 0.1 = 10%)
+    LimitPriceDifferenceWarning: 0.1, // Warn if limit price differs by >10% from current price
+    // Price deviation threshold (as decimal, 0.1 = 10%)
+    PriceDeviation: 0.1, // Warn if perps price deviates by >10% from spot price
+};
+/**
+ * Order slippage configuration
+ * Controls default slippage tolerance for different order types
+ * Conservative defaults based on HyperLiquid platform interface
+ * See: docs/perps/hyperliquid/ORDER-MATCHING-ERRORS.md
+ */
+exports.ORDER_SLIPPAGE_CONFIG = {
+    // Market order slippage (basis points)
+    // 300 basis points = 3% = 0.03 decimal
+    // Conservative default for measured rollout, prevents most IOC failures
+    DefaultMarketSlippageBps: 300,
+    // TP/SL order slippage (basis points)
+    // 1000 basis points = 10% = 0.10 decimal
+    // Aligns with HyperLiquid platform default for triggered orders
+    DefaultTpslSlippageBps: 1000,
+    // Limit order slippage (basis points)
+    // 100 basis points = 1% = 0.01 decimal
+    // Kept conservative as limit orders rest on book (not IOC/immediate execution)
+    DefaultLimitSlippageBps: 100,
+};
+/**
+ * Performance optimization constants
+ * These values control debouncing and throttling for better performance
+ */
+exports.PERFORMANCE_CONFIG = {
+    // Price updates debounce delay (milliseconds)
+    // Batches rapid WebSocket price updates to reduce re-renders
+    PriceUpdateDebounceMs: 1000,
+    // Order validation debounce delay (milliseconds)
+    // Prevents excessive validation calls during rapid form input changes
+    ValidationDebounceMs: 300,
+    // Liquidation price debounce delay (milliseconds)
+    // Prevents excessive liquidation price calls during rapid form input changes
+    LiquidationPriceDebounceMs: 500,
+    // Navigation params delay (milliseconds)
+    // Required for React Navigation to complete state transitions before setting params
+    // This ensures navigation context is available when programmatically selecting tabs
+    NavigationParamsDelayMs: 200,
+    // Tab control reset delay (milliseconds)
+    // Delay to reset programmatic tab control after tab switching to prevent render loops
+    TabControlResetDelayMs: 500,
+    // Market data cache duration (milliseconds)
+    // How long to cache market list data before fetching fresh data
+    MarketDataCacheDurationMs: 5 * 60 * 1000, // 5 minutes
+    // Asset metadata cache duration (milliseconds)
+    // How long to cache asset icon validation results
+    AssetMetadataCacheDurationMs: 60 * 60 * 1000, // 1 hour
+    // Max leverage cache duration (milliseconds)
+    // How long to cache max leverage values per asset (leverage rarely changes)
+    MaxLeverageCacheDurationMs: 60 * 60 * 1000, // 1 hour
+    // Rewards cache durations (milliseconds)
+    // How long to cache fee discount data from rewards API
+    FeeDiscountCacheDurationMs: 5 * 60 * 1000, // 5 minutes
+    // How long to cache points calculation parameters from rewards API
+    PointsCalculationCacheDurationMs: 5 * 60 * 1000, // 5 minutes
+    /**
+     * Performance logging markers for filtering logs during development and debugging
+     * These markers help isolate performance-related logs from general application logs
+     * Usage: Use in DevLogger calls to easily filter specific performance areas
+     * Impact: Development only (uses DevLogger) - zero production performance cost
+     *
+     * Examples:
+     * - Filter Sentry performance logs: `adb logcat | grep PERPSMARK_SENTRY`
+     * - Filter MetaMetrics events: `adb logcat | grep PERPSMARK_METRICS`
+     * - Filter WebSocket performance: `adb logcat | grep PERPSMARK_WS`
+     * - Filter all Perps performance: `adb logcat | grep PERPSMARK_`
+     */
+    LoggingMarkers: {
+        // Sentry performance measurement logs (screen loads, bottom sheets, API timing)
+        SentryPerformance: 'PERPSMARK_SENTRY',
+        // MetaMetrics event tracking logs (user interactions, business analytics)
+        MetametricsEvents: 'PERPSMARK_METRICS',
+        // WebSocket performance logs (connection timing, data flow, reconnections)
+        WebsocketPerformance: 'PERPSMARK_SENTRY_WS',
+    },
+};
+exports.TP_SL_CONFIG = {
+    UsePositionBoundTpsl: true,
+};
+/**
+ * HyperLiquid order limits based on leverage
+ * From: https://hyperliquid.gitbook.io/hyperliquid-docs/trading/contract-specifications
+ */
+exports.HYPERLIQUID_ORDER_LIMITS = {
+    // Market orders
+    MarketOrderLimits: {
+        // $15,000,000 for max leverage >= 25
+        HighLeverage: 15000000,
+        // $5,000,000 for max leverage in [20, 25)
+        MediumHighLeverage: 5000000,
+        // $2,000,000 for max leverage in [10, 20)
+        MediumLeverage: 2000000,
+        // $500,000 for max leverage < 10
+        LowLeverage: 500000,
+    },
+    // Limit orders are 10x market order limits
+    LimitOrderMultiplier: 10,
+};
+/**
+ * Close position configuration
+ * Controls behavior and constants specific to position closing
+ */
+exports.CLOSE_POSITION_CONFIG = {
+    // Decimal places for USD amount input display
+    UsdDecimalPlaces: 2,
+    // Default close percentage when opening the close position view
+    DefaultClosePercentage: 100,
+    // Precision for position size calculations to prevent rounding errors
+    AmountCalculationPrecision: 6,
+    // Throttle delay for real-time price updates during position closing
+    PriceThrottleMs: 3000,
+    // Fallback decimal places for tokens without metadata
+    FallbackTokenDecimals: 18,
+};
+/**
+ * Margin adjustment configuration
+ * Controls behavior for adding/removing margin from positions
+ */
+exports.MARGIN_ADJUSTMENT_CONFIG = {
+    // Risk thresholds for margin removal warnings
+    // Threshold values represent ratio of (price distance to liquidation) / (liquidation price)
+    // Values < 1.0 mean price is dangerously close to liquidation
+    LiquidationRiskThreshold: 1.2, // 20% buffer before liquidation - triggers danger state
+    LiquidationWarningThreshold: 1.5, // 50% buffer before liquidation - triggers warning state
+    // Minimum margin adjustment amount (USD)
+    // Prevents dust adjustments and ensures meaningful position changes
+    MinAdjustmentAmount: 1,
+    // Precision for margin calculations
+    // Ensures accurate decimal handling in margin/leverage calculations
+    CalculationPrecision: 6,
+    // Safety buffer for margin removal to account for HyperLiquid's transfer margin requirement
+    // HyperLiquid enforces: transfer_margin_required = max(initial_margin_required, 0.1 * total_position_value)
+    // See: https://hyperliquid.gitbook.io/hyperliquid-docs/trading/margin-and-pnl
+    MarginRemovalSafetyBuffer: 0.1,
+    // Fallback max leverage when market data is unavailable
+    // Conservative value to prevent over-removal of margin
+    // Most HyperLiquid assets support at least 50x leverage
+    FallbackMaxLeverage: 50,
+};
+/**
+ * Data Lake API configuration
+ * Endpoints for reporting perps trading activity for notifications
+ */
+exports.DATA_LAKE_API_CONFIG = {
+    // Order reporting endpoint - only used for mainnet perps trading
+    OrdersEndpoint: 'https://perps.api.cx.metamask.io/api/v1/orders',
+};
+/**
+ * Decimal precision configuration
+ * Controls maximum decimal places for price and input validation
+ */
+exports.DECIMAL_PRECISION_CONFIG = {
+    // Maximum decimal places for price input (matches Hyperliquid limit)
+    // Used in TP/SL forms, limit price inputs, and price validation
+    MaxPriceDecimals: 6,
+    // Maximum significant figures allowed by HyperLiquid API
+    // Orders with more than 5 significant figures will be rejected
+    MaxSignificantFigures: 5,
+    // Defensive fallback for size decimals when market data fails to load
+    // Real szDecimals should always come from market data API (varies by asset)
+    // Using 6 as safe maximum to prevent crashes (covers most assets)
+    // NOTE: This is NOT semantically correct - just a defensive measure
+    FallbackSizeDecimals: 6,
+};
+/**
+ * Market sorting configuration
+ * Controls sorting behavior and presets for the trending markets view
+ */
+exports.MARKET_SORTING_CONFIG = {
+    // Default sort settings
+    DefaultSortOptionId: 'volume',
+    DefaultDirection: 'desc',
+    // Available sort fields (only includes fields supported by PerpsMarketData)
+    SortFields: {
+        Volume: 'volume',
+        PriceChange: 'priceChange',
+        OpenInterest: 'openInterest',
+        FundingRate: 'fundingRate',
+    },
+    // Sort button presets for filter chips (simplified buttons without direction)
+    SortButtonPresets: [
+        { field: 'volume', labelKey: 'perps.sort.volume' },
+        { field: 'priceChange', labelKey: 'perps.sort.price_change' },
+        { field: 'fundingRate', labelKey: 'perps.sort.funding_rate' },
+    ],
+    // Sort options for the bottom sheet
+    // All options support direction toggle (high-to-low / low-to-high)
+    SortOptions: [
+        {
+            id: 'volume',
+            labelKey: 'perps.sort.volume',
+            field: 'volume',
+            direction: 'desc',
+        },
+        {
+            id: 'priceChange',
+            labelKey: 'perps.sort.price_change',
+            field: 'priceChange',
+            direction: 'desc',
+        },
+        {
+            id: 'openInterest',
+            labelKey: 'perps.sort.open_interest',
+            field: 'openInterest',
+            direction: 'desc',
+        },
+        {
+            id: 'fundingRate',
+            labelKey: 'perps.sort.funding_rate',
+            field: 'fundingRate',
+            direction: 'desc',
+        },
+    ],
+};
+/**
+ * Provider configuration for multi-provider support
+ */
+exports.PROVIDER_CONFIG = {
+    /** Default perpetual DEX provider when no explicit selection exists */
+    DefaultProvider: 'hyperliquid',
+    /** Force MYX to testnet only (mainnet credentials not yet available) */
+    MYX_TESTNET_ONLY: true,
+};
+//# sourceMappingURL=perpsConfig.cjs.map

package/dist/constants/perpsConfig.cjs.map

@@ -0,0 +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 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  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\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 * 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  // 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 * 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: true,\n} as const;\n"]}

package/dist/constants/perpsConfig.d.cts

@@ -0,0 +1,221 @@
+/**
+ * Perps feature constants - Controller layer (portable)
+ *
+ * This file contains only controller-portable configuration:
+ * - Constants used by controller logic, providers, and services
+ * - Calculation thresholds, API configs, and protocol constants
+ *
+ * UI-only constants (layout, display, navigation) live in:
+ * app/components/UI/Perps/constants/perpsConfig.ts
+ */
+export declare const PERPS_CONSTANTS: {
+    readonly FeatureFlagKey: "perpsEnabled";
+    readonly FeatureName: "perps";
+    /** Token description used to identify the synthetic "Perps balance" option in pay-with token lists */
+    readonly PerpsBalanceTokenDescription: "perps-balance";
+    /** Symbol displayed for the synthetic "Perps balance" token in pay-with token lists */
+    readonly PerpsBalanceTokenSymbol: "USD";
+    readonly WebsocketTimeout: 5000;
+    readonly WebsocketCleanupDelay: 1000;
+    readonly BackgroundDisconnectDelay: 20000;
+    readonly ConnectionTimeoutMs: 10000;
+    readonly DefaultMonitoringTimeoutMs: 10000;
+    readonly ConnectionGracePeriodMs: 20000;
+    readonly ConnectionAttemptTimeoutMs: 30000;
+    readonly WebsocketPingTimeoutMs: 5000;
+    readonly ConnectRetryDelayMs: 200;
+    readonly ReconnectionCleanupDelayMs: 500;
+    readonly ReconnectionDelayAndroidMs: 300;
+    readonly ReconnectionDelayIosMs: 100;
+    readonly ReconnectionRetryDelayMs: 5000;
+    readonly BalanceUpdateThrottleMs: 15000;
+    readonly InitialDataDelayMs: 100;
+    readonly DepositTakingLongerToastDelayMs: 30000;
+    readonly DefaultAssetPreviewLimit: 5;
+    readonly DefaultMaxLeverage: number;
+    readonly FallbackPriceDisplay: "$---";
+    readonly FallbackPercentageDisplay: "--%";
+    readonly FallbackDataDisplay: "--";
+    readonly ZeroAmountDisplay: "$0";
+    readonly ZeroAmountDetailedDisplay: "$0.00";
+    readonly RecentActivityLimit: 3;
+    readonly FillsLookbackMs: number;
+};
+/**
+ * Withdrawal-specific constants (protocol-agnostic)
+ * Note: Protocol-specific values like estimated time should be defined in each protocol's config
+ */
+export declare const WITHDRAWAL_CONSTANTS: {
+    readonly DefaultMinAmount: "1.01";
+    readonly DefaultFeeAmount: 1;
+    readonly DefaultFeeToken: "USDC";
+};
+/**
+ * Validation thresholds for UI warnings and checks
+ * These values control when warnings are shown to users
+ */
+export declare const VALIDATION_THRESHOLDS: {
+    readonly HighLeverageWarning: 20;
+    readonly LimitPriceDifferenceWarning: 0.1;
+    readonly PriceDeviation: 0.1;
+};
+/**
+ * Order slippage configuration
+ * Controls default slippage tolerance for different order types
+ * Conservative defaults based on HyperLiquid platform interface
+ * See: docs/perps/hyperliquid/ORDER-MATCHING-ERRORS.md
+ */
+export declare const ORDER_SLIPPAGE_CONFIG: {
+    readonly DefaultMarketSlippageBps: 300;
+    readonly DefaultTpslSlippageBps: 1000;
+    readonly DefaultLimitSlippageBps: 100;
+};
+/**
+ * Performance optimization constants
+ * These values control debouncing and throttling for better performance
+ */
+export declare const PERFORMANCE_CONFIG: {
+    readonly PriceUpdateDebounceMs: 1000;
+    readonly ValidationDebounceMs: 300;
+    readonly LiquidationPriceDebounceMs: 500;
+    readonly NavigationParamsDelayMs: 200;
+    readonly TabControlResetDelayMs: 500;
+    readonly MarketDataCacheDurationMs: number;
+    readonly AssetMetadataCacheDurationMs: number;
+    readonly MaxLeverageCacheDurationMs: number;
+    readonly FeeDiscountCacheDurationMs: number;
+    readonly PointsCalculationCacheDurationMs: number;
+    /**
+     * Performance logging markers for filtering logs during development and debugging
+     * These markers help isolate performance-related logs from general application logs
+     * Usage: Use in DevLogger calls to easily filter specific performance areas
+     * Impact: Development only (uses DevLogger) - zero production performance cost
+     *
+     * Examples:
+     * - Filter Sentry performance logs: `adb logcat | grep PERPSMARK_SENTRY`
+     * - Filter MetaMetrics events: `adb logcat | grep PERPSMARK_METRICS`
+     * - Filter WebSocket performance: `adb logcat | grep PERPSMARK_WS`
+     * - Filter all Perps performance: `adb logcat | grep PERPSMARK_`
+     */
+    readonly LoggingMarkers: {
+        readonly SentryPerformance: "PERPSMARK_SENTRY";
+        readonly MetametricsEvents: "PERPSMARK_METRICS";
+        readonly WebsocketPerformance: "PERPSMARK_SENTRY_WS";
+    };
+};
+export declare const TP_SL_CONFIG: {
+    readonly UsePositionBoundTpsl: true;
+};
+/**
+ * HyperLiquid order limits based on leverage
+ * From: https://hyperliquid.gitbook.io/hyperliquid-docs/trading/contract-specifications
+ */
+export declare const HYPERLIQUID_ORDER_LIMITS: {
+    readonly MarketOrderLimits: {
+        readonly HighLeverage: 15000000;
+        readonly MediumHighLeverage: 5000000;
+        readonly MediumLeverage: 2000000;
+        readonly LowLeverage: 500000;
+    };
+    readonly LimitOrderMultiplier: 10;
+};
+/**
+ * Close position configuration
+ * Controls behavior and constants specific to position closing
+ */
+export declare const CLOSE_POSITION_CONFIG: {
+    readonly UsdDecimalPlaces: 2;
+    readonly DefaultClosePercentage: 100;
+    readonly AmountCalculationPrecision: 6;
+    readonly PriceThrottleMs: 3000;
+    readonly FallbackTokenDecimals: 18;
+};
+/**
+ * Margin adjustment configuration
+ * Controls behavior for adding/removing margin from positions
+ */
+export declare const MARGIN_ADJUSTMENT_CONFIG: {
+    readonly LiquidationRiskThreshold: 1.2;
+    readonly LiquidationWarningThreshold: 1.5;
+    readonly MinAdjustmentAmount: 1;
+    readonly CalculationPrecision: 6;
+    readonly MarginRemovalSafetyBuffer: 0.1;
+    readonly FallbackMaxLeverage: 50;
+};
+/**
+ * Data Lake API configuration
+ * Endpoints for reporting perps trading activity for notifications
+ */
+export declare const DATA_LAKE_API_CONFIG: {
+    readonly OrdersEndpoint: "https://perps.api.cx.metamask.io/api/v1/orders";
+};
+/**
+ * Decimal precision configuration
+ * Controls maximum decimal places for price and input validation
+ */
+export declare const DECIMAL_PRECISION_CONFIG: {
+    readonly MaxPriceDecimals: 6;
+    readonly MaxSignificantFigures: 5;
+    readonly FallbackSizeDecimals: 6;
+};
+/**
+ * Market sorting configuration
+ * Controls sorting behavior and presets for the trending markets view
+ */
+export declare const MARKET_SORTING_CONFIG: {
+    readonly DefaultSortOptionId: "volume";
+    readonly DefaultDirection: "desc";
+    readonly SortFields: {
+        readonly Volume: "volume";
+        readonly PriceChange: "priceChange";
+        readonly OpenInterest: "openInterest";
+        readonly FundingRate: "fundingRate";
+    };
+    readonly SortButtonPresets: readonly [{
+        readonly field: "volume";
+        readonly labelKey: "perps.sort.volume";
+    }, {
+        readonly field: "priceChange";
+        readonly labelKey: "perps.sort.price_change";
+    }, {
+        readonly field: "fundingRate";
+        readonly labelKey: "perps.sort.funding_rate";
+    }];
+    readonly SortOptions: readonly [{
+        readonly id: "volume";
+        readonly labelKey: "perps.sort.volume";
+        readonly field: "volume";
+        readonly direction: "desc";
+    }, {
+        readonly id: "priceChange";
+        readonly labelKey: "perps.sort.price_change";
+        readonly field: "priceChange";
+        readonly direction: "desc";
+    }, {
+        readonly id: "openInterest";
+        readonly labelKey: "perps.sort.open_interest";
+        readonly field: "openInterest";
+        readonly direction: "desc";
+    }, {
+        readonly id: "fundingRate";
+        readonly labelKey: "perps.sort.funding_rate";
+        readonly field: "fundingRate";
+        readonly direction: "desc";
+    }];
+};
+/**
+ * Type for valid sort option IDs
+ * Derived from SORT_OPTIONS to ensure type safety
+ * Valid values: 'volume' | 'priceChange' | 'openInterest' | 'fundingRate'
+ */
+export type SortOptionId = (typeof MARKET_SORTING_CONFIG.SortOptions)[number]['id'];
+/**
+ * Provider configuration for multi-provider support
+ */
+export declare const PROVIDER_CONFIG: {
+    /** Default perpetual DEX provider when no explicit selection exists */
+    readonly DefaultProvider: "hyperliquid";
+    /** Force MYX to testnet only (mainnet credentials not yet available) */
+    readonly MYX_TESTNET_ONLY: true;
+};
+//# sourceMappingURL=perpsConfig.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"perpsConfig.d.cts","sourceRoot":"","sources":["../../src/constants/perpsConfig.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,eAAO,MAAM,eAAe;;;IAG1B,sGAAsG;;IAEtG,uFAAuF;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqC/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;;;GAGG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;IAwC7B;;;;;;;;;;;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;;GAEG;AACH,eAAO,MAAM,eAAe;IAC1B,uEAAuE;;IAEvE,wEAAwE;;CAEhE,CAAC"}