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

package/dist/constants/perpsConfig.mjs

@@ -0,0 +1,458 @@
+/**
+ * Perps feature constants
+ */
+export const PERPS_CONSTANTS = {
+    FeatureFlagKey: 'perpsEnabled',
+    FeatureName: 'perps', // Constant for Sentry error filtering - enables "feature:perps" dashboard queries
+    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
+    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
+    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
+ */
+export const WITHDRAWAL_CONSTANTS = {
+    DefaultMinAmount: '1.01', // Default minimum withdrawal amount in USDC
+    DefaultFeeAmount: 1, // Default withdrawal fee in USDC
+    DefaultFeeToken: 'USDC', // Default fee token
+};
+/**
+ * MetaMask fee configuration for Perps trading
+ * These fees are protocol-agnostic and apply on top of protocol fees
+ */
+export const METAMASK_FEE_CONFIG = {
+    // Deposit/withdrawal fees
+    DepositFee: 0, // $0 currently
+    WithdrawalFee: 0, // $0 currently
+    // Future: Fee configuration will be fetched from API based on:
+    // - User tier/volume (for MetaMask fee discounts)
+    // - Promotional campaigns
+    // - Protocol-specific agreements
+    // - MetaMask points/rewards integration
+    // Note: Trading fees are now handled by each provider's calculateFees()
+    // which returns complete fee breakdown including MetaMask fees
+};
+/**
+ * Minimum number of aggregators (exchanges) a token must be listed on
+ * to be considered trustworthy for showing the Perps Discovery Banner.
+ * Native tokens (ETH, BNB, etc.) bypass this check.
+ */
+export const PERPS_MIN_AGGREGATORS_FOR_TRUST = 2;
+/**
+ * Validation thresholds for UI warnings and checks
+ * These values control when warnings are shown to users
+ */
+export const 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
+ */
+export const 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
+ */
+export const 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',
+    },
+};
+/**
+ * Leverage slider UI configuration
+ * Controls the visual and interactive aspects of the leverage slider
+ */
+export const LEVERAGE_SLIDER_CONFIG = {
+    // Step sizes for tick marks based on max leverage
+    TickStepLow: 5, // Step size when max leverage <= 20
+    TickStepMedium: 10, // Step size when max leverage <= 50
+    TickStepHigh: 20, // Step size when max leverage > 50
+    // Thresholds for determining tick step size
+    MaxLeverageLowThreshold: 20,
+    MaxLeverageMediumThreshold: 50,
+};
+export const TP_SL_CONFIG = {
+    UsePositionBoundTpsl: true,
+};
+/**
+ * TP/SL View UI configuration
+ * Controls the Take Profit / Stop Loss screen behavior and display options
+ */
+export const TP_SL_VIEW_CONFIG = {
+    // Quick percentage button presets for Take Profit (positive RoE percentages)
+    TakeProfitRoePresets: [10, 25, 50, 100], // +10%, +25%, +50%, +100% RoE
+    // Quick percentage button presets for Stop Loss (negative RoE percentages)
+    StopLossRoePresets: [-5, -10, -25, -50], // -5%, -10%, -25%, -50% RoE
+    // WebSocket price update throttle delay (milliseconds)
+    // Reduces re-renders by batching price updates in the TP/SL screen
+    PriceThrottleMs: 1000,
+    // Maximum number of digits allowed in price/percentage input fields
+    // Prevents overflow and maintains reasonable input constraints
+    MaxInputDigits: 9,
+    // Keypad configuration for price inputs
+    // USD_PERPS is not a real currency - it's a custom configuration
+    // that allows 5 decimal places for crypto prices, overriding the
+    // default USD configuration which only allows 2 decimal places
+    KeypadCurrencyCode: 'USD_PERPS',
+    KeypadDecimals: 5,
+};
+/**
+ * Limit price configuration
+ * Controls preset percentages and behavior for limit orders
+ */
+export const LIMIT_PRICE_CONFIG = {
+    // Preset percentage options for quick selection
+    PresetPercentages: [1, 2], // Available as both positive and negative
+    // Modal opening delay when switching to limit order (milliseconds)
+    // Allows order type modal to close smoothly before opening limit price modal
+    ModalOpenDelay: 300,
+    // Direction-specific preset configurations (Mid/Bid/Ask buttons handled separately)
+    LongPresets: [-1, -2], // Buy below market for long orders
+    ShortPresets: [1, 2], // Sell above market for short orders
+};
+/**
+ * HyperLiquid order limits based on leverage
+ * From: https://hyperliquid.gitbook.io/hyperliquid-docs/trading/contract-specifications
+ */
+export const 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
+ */
+export const 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
+ */
+export const 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
+ */
+export const DATA_LAKE_API_CONFIG = {
+    // Order reporting endpoint - only used for mainnet perps trading
+    OrdersEndpoint: 'https://perps.api.cx.metamask.io/api/v1/orders',
+};
+/**
+ * Funding rate display configuration
+ * Controls how funding rates are formatted and displayed across the app
+ */
+export const FUNDING_RATE_CONFIG = {
+    // Number of decimal places to display for funding rates
+    Decimals: 4,
+    // Default display value when funding rate is zero or unavailable
+    ZeroDisplay: '0.0000%',
+    // Multiplier to convert decimal funding rate to percentage
+    PercentageMultiplier: 100,
+};
+/**
+ * Decimal precision configuration
+ * Controls maximum decimal places for price and input validation
+ */
+export const 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,
+};
+/**
+ * Development-only configuration for testing and debugging
+ * These constants are only active when __DEV__ is true
+ */
+export const DEVELOPMENT_CONFIG = {
+    // Magic number to simulate fee discount state (20% discount)
+    SimulateFeeDiscountAmount: 41,
+    // Magic number to simulate rewards error state (set order amount to this value)
+    SimulateRewardsErrorAmount: 42,
+    // Magic number to simulate rewards loading state
+    SimulateRewardsLoadingAmount: 43,
+    // Future: Add other development helpers as needed
+};
+/**
+ * Home screen configuration
+ * Controls carousel limits and display settings for the main Perps home screen
+ */
+export const HOME_SCREEN_CONFIG = {
+    // Show action buttons (Add Funds / Withdraw) in header instead of fixed footer
+    // Can be controlled via feature flag in the future
+    ShowHeaderActionButtons: true,
+    // Maximum number of items to show in each carousel
+    PositionsCarouselLimit: 10,
+    OrdersCarouselLimit: 10,
+    TrendingMarketsLimit: 5,
+    RecentActivityLimit: 3,
+    // Carousel display behavior
+    CarouselSnapAlignment: 'start',
+    CarouselVisibleItems: 1.2, // Show 1 full item + 20% of next
+    // Icon sizes for consistent display across sections
+    DefaultIconSize: 40, // Default token icon size for cards and rows
+};
+/**
+ * Market sorting configuration
+ * Controls sorting behavior and presets for the trending markets view
+ */
+export const 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
+    // Only Price Change can be toggled for direction (similar to trending tokens pattern)
+    // Other options (volume, open interest, funding rate) use descending sort only
+    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',
+        },
+    ],
+};
+/**
+ * Learn more card configuration
+ * External resources and content for Perps education
+ */
+export const LEARN_MORE_CONFIG = {
+    ExternalUrl: 'https://metamask.io/perps',
+    TitleKey: 'perps.tutorial.card.title',
+    DescriptionKey: 'perps.learn_more.description',
+    CtaKey: 'perps.learn_more.cta',
+};
+/**
+ * Support configuration
+ * Contact support button configuration (matches Settings behavior)
+ */
+export const SUPPORT_CONFIG = {
+    Url: 'https://support.metamask.io',
+    TitleKey: 'perps.support.title',
+    DescriptionKey: 'perps.support.description',
+};
+/**
+ * Feedback survey configuration
+ * External survey for collecting user feedback on Perps trading experience
+ */
+export const FEEDBACK_CONFIG = {
+    Url: 'https://survey.alchemer.com/s3/8649911/MetaMask-Perps-Trading-Feedback',
+    TitleKey: 'perps.feedback.title',
+};
+/**
+ * Support article URLs
+ * Links to specific MetaMask support articles for Perps features
+ */
+export const PERPS_SUPPORT_ARTICLES_URLS = {
+    AdlUrl: 'https://support.metamask.io/manage-crypto/trade/perps/leverage-and-liquidation/#what-is-auto-deleveraging-adl',
+};
+/**
+ * Stop loss prompt banner configuration
+ * Controls when and how the stop loss prompt banner is displayed
+ * Based on TAT-1693 specifications
+ */
+export const STOP_LOSS_PROMPT_CONFIG = {
+    // Distance to liquidation threshold (percentage)
+    // Shows "Add margin" banner when position is within this % of liquidation
+    LiquidationDistanceThreshold: 3,
+    // ROE (Return on Equity) threshold (percentage)
+    // Shows "Set stop loss" banner when ROE drops below this value
+    RoeThreshold: -10,
+    // Minimum loss threshold to show ANY banner (percentage)
+    // No banner shown until ROE drops below this value
+    MinLossThreshold: -10,
+    // Debounce duration for ROE threshold (milliseconds)
+    // User must have ROE below threshold for this duration before showing banner
+    // Prevents banner from appearing during temporary price fluctuations
+    RoeDebounceMs: 60000, // 60 seconds
+    // Minimum position age before showing any banner (milliseconds)
+    // Prevents banner from appearing immediately after opening a position
+    PositionMinAgeMs: 60000, // 60 seconds
+    // Suggested stop loss ROE percentage
+    // When suggesting a stop loss, calculate price at this ROE from entry
+    SuggestedStopLossRoe: -50,
+};
+/**
+ * Transactions history configuration
+ * Controls history display and data fetching parameters
+ */
+export const PERPS_TRANSACTIONS_HISTORY_CONSTANTS = {
+    /**
+     * Default number of days to look back for funding history.
+     * HyperLiquid API requires a startTime and returns max 500 records.
+     * Using 365 days ensures most users see their complete recent history.
+     * Can be increased if users need older funding data.
+     */
+    DefaultFundingHistoryDays: 365,
+};
+//# sourceMappingURL=perpsConfig.mjs.map

package/dist/constants/perpsConfig.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"perpsConfig.mjs","sourceRoot":"","sources":["../../src/constants/perpsConfig.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Perps feature constants\n */\nexport const PERPS_CONSTANTS = {\n  FeatureFlagKey: 'perpsEnabled',\n  FeatureName: 'perps', // Constant for Sentry error filtering - enables \"feature:perps\" dashboard queries\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  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  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 * MetaMask fee configuration for Perps trading\n * These fees are protocol-agnostic and apply on top of protocol fees\n */\nexport const METAMASK_FEE_CONFIG = {\n  // Deposit/withdrawal fees\n  DepositFee: 0, // $0 currently\n  WithdrawalFee: 0, // $0 currently\n\n  // Future: Fee configuration will be fetched from API based on:\n  // - User tier/volume (for MetaMask fee discounts)\n  // - Promotional campaigns\n  // - Protocol-specific agreements\n  // - MetaMask points/rewards integration\n  // Note: Trading fees are now handled by each provider's calculateFees()\n  // which returns complete fee breakdown including MetaMask fees\n} as const;\n\n/**\n * Minimum number of aggregators (exchanges) a token must be listed on\n * to be considered trustworthy for showing the Perps Discovery Banner.\n * Native tokens (ETH, BNB, etc.) bypass this check.\n */\nexport const PERPS_MIN_AGGREGATORS_FOR_TRUST = 2;\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\n/**\n * Leverage slider UI configuration\n * Controls the visual and interactive aspects of the leverage slider\n */\nexport const LEVERAGE_SLIDER_CONFIG = {\n  // Step sizes for tick marks based on max leverage\n  TickStepLow: 5, // Step size when max leverage <= 20\n  TickStepMedium: 10, // Step size when max leverage <= 50\n  TickStepHigh: 20, // Step size when max leverage > 50\n\n  // Thresholds for determining tick step size\n  MaxLeverageLowThreshold: 20,\n  MaxLeverageMediumThreshold: 50,\n} as const;\n\nexport const TP_SL_CONFIG = {\n  UsePositionBoundTpsl: true,\n} as const;\n\n/**\n * TP/SL View UI configuration\n * Controls the Take Profit / Stop Loss screen behavior and display options\n */\nexport const TP_SL_VIEW_CONFIG = {\n  // Quick percentage button presets for Take Profit (positive RoE percentages)\n  TakeProfitRoePresets: [10, 25, 50, 100], // +10%, +25%, +50%, +100% RoE\n\n  // Quick percentage button presets for Stop Loss (negative RoE percentages)\n  StopLossRoePresets: [-5, -10, -25, -50], // -5%, -10%, -25%, -50% RoE\n\n  // WebSocket price update throttle delay (milliseconds)\n  // Reduces re-renders by batching price updates in the TP/SL screen\n  PriceThrottleMs: 1000,\n\n  // Maximum number of digits allowed in price/percentage input fields\n  // Prevents overflow and maintains reasonable input constraints\n  MaxInputDigits: 9,\n\n  // Keypad configuration for price inputs\n  // USD_PERPS is not a real currency - it's a custom configuration\n  // that allows 5 decimal places for crypto prices, overriding the\n  // default USD configuration which only allows 2 decimal places\n  KeypadCurrencyCode: 'USD_PERPS' as const,\n  KeypadDecimals: 5,\n} as const;\n\n/**\n * Limit price configuration\n * Controls preset percentages and behavior for limit orders\n */\nexport const LIMIT_PRICE_CONFIG = {\n  // Preset percentage options for quick selection\n  PresetPercentages: [1, 2], // Available as both positive and negative\n\n  // Modal opening delay when switching to limit order (milliseconds)\n  // Allows order type modal to close smoothly before opening limit price modal\n  ModalOpenDelay: 300,\n\n  // Direction-specific preset configurations (Mid/Bid/Ask buttons handled separately)\n  LongPresets: [-1, -2], // Buy below market for long orders\n  ShortPresets: [1, 2], // Sell above market for short orders\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 * Funding rate display configuration\n * Controls how funding rates are formatted and displayed across the app\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 * 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 * Development-only configuration for testing and debugging\n * These constants are only active when __DEV__ is true\n */\nexport const DEVELOPMENT_CONFIG = {\n  // Magic number to simulate fee discount state (20% discount)\n  SimulateFeeDiscountAmount: 41,\n\n  // Magic number to simulate rewards error state (set order amount to this value)\n  SimulateRewardsErrorAmount: 42,\n\n  // Magic number to simulate rewards loading state\n  SimulateRewardsLoadingAmount: 43,\n\n  // Future: Add other development helpers as needed\n} as const;\n\n/**\n * Home screen configuration\n * Controls carousel limits and display settings for the main Perps home screen\n */\nexport const HOME_SCREEN_CONFIG = {\n  // Show action buttons (Add Funds / Withdraw) in header instead of fixed footer\n  // Can be controlled via feature flag in the future\n  ShowHeaderActionButtons: true,\n\n  // Maximum number of items to show in each carousel\n  PositionsCarouselLimit: 10,\n  OrdersCarouselLimit: 10,\n  TrendingMarketsLimit: 5,\n  RecentActivityLimit: 3,\n\n  // Carousel display behavior\n  CarouselSnapAlignment: 'start' as const,\n  CarouselVisibleItems: 1.2, // Show 1 full item + 20% of next\n\n  // Icon sizes for consistent display across sections\n  DefaultIconSize: 40, // Default token icon size for cards and rows\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  // Only Price Change can be toggled for direction (similar to trending tokens pattern)\n  // Other options (volume, open interest, funding rate) use descending sort only\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 * Type for sort button presets (filter chips)\n * Derived from SORT_BUTTON_PRESETS to ensure type safety\n */\nexport type SortButtonPreset =\n  (typeof MARKET_SORTING_CONFIG.SortButtonPresets)[number];\n\n/**\n * Learn more card configuration\n * External resources and content for Perps education\n */\nexport const LEARN_MORE_CONFIG = {\n  ExternalUrl: 'https://metamask.io/perps',\n  TitleKey: 'perps.tutorial.card.title',\n  DescriptionKey: 'perps.learn_more.description',\n  CtaKey: 'perps.learn_more.cta',\n} as const;\n\n/**\n * Support configuration\n * Contact support button configuration (matches Settings behavior)\n */\nexport const SUPPORT_CONFIG = {\n  Url: 'https://support.metamask.io',\n  TitleKey: 'perps.support.title',\n  DescriptionKey: 'perps.support.description',\n} as const;\n\n/**\n * Feedback survey configuration\n * External survey for collecting user feedback on Perps trading experience\n */\nexport const FEEDBACK_CONFIG = {\n  Url: 'https://survey.alchemer.com/s3/8649911/MetaMask-Perps-Trading-Feedback',\n  TitleKey: 'perps.feedback.title',\n} as const;\n\n/**\n * Support article URLs\n * Links to specific MetaMask support articles for Perps features\n */\nexport const PERPS_SUPPORT_ARTICLES_URLS = {\n  AdlUrl:\n    'https://support.metamask.io/manage-crypto/trade/perps/leverage-and-liquidation/#what-is-auto-deleveraging-adl',\n} as const;\n\n/**\n * Stop loss prompt banner configuration\n * Controls when and how the stop loss prompt banner is displayed\n * Based on TAT-1693 specifications\n */\nexport const STOP_LOSS_PROMPT_CONFIG = {\n  // Distance to liquidation threshold (percentage)\n  // Shows \"Add margin\" banner when position is within this % of liquidation\n  LiquidationDistanceThreshold: 3,\n\n  // ROE (Return on Equity) threshold (percentage)\n  // Shows \"Set stop loss\" banner when ROE drops below this value\n  RoeThreshold: -10,\n\n  // Minimum loss threshold to show ANY banner (percentage)\n  // No banner shown until ROE drops below this value\n  MinLossThreshold: -10,\n\n  // Debounce duration for ROE threshold (milliseconds)\n  // User must have ROE below threshold for this duration before showing banner\n  // Prevents banner from appearing during temporary price fluctuations\n  RoeDebounceMs: 60_000, // 60 seconds\n\n  // Minimum position age before showing any banner (milliseconds)\n  // Prevents banner from appearing immediately after opening a position\n  PositionMinAgeMs: 60_000, // 60 seconds\n\n  // Suggested stop loss ROE percentage\n  // When suggesting a stop loss, calculate price at this ROE from entry\n  SuggestedStopLossRoe: -50,\n} as const;\n\n/**\n * Transactions history configuration\n * Controls history display and data fetching parameters\n */\nexport const PERPS_TRANSACTIONS_HISTORY_CONSTANTS = {\n  /**\n   * Default number of days to look back for funding history.\n   * HyperLiquid API requires a startTime and returns max 500 records.\n   * Using 365 days ensures most users see their complete recent history.\n   * Can be increased if users need older funding data.\n   */\n  DefaultFundingHistoryDays: 365,\n} as const;\n"]}

package/dist/constants/perpsErrorCodes.cjs

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PERPS_ERROR_CODES = void 0;
+/**
+ * Error codes for PerpsController
+ * These codes are returned to the UI layer for translation
+ * Extracted to separate file to avoid circular dependencies with translatePerpsError
+ */
+exports.PERPS_ERROR_CODES = {
+    CLIENT_NOT_INITIALIZED: 'CLIENT_NOT_INITIALIZED',
+    CLIENT_REINITIALIZING: 'CLIENT_REINITIALIZING',
+    PROVIDER_NOT_AVAILABLE: 'PROVIDER_NOT_AVAILABLE',
+    TOKEN_NOT_SUPPORTED: 'TOKEN_NOT_SUPPORTED',
+    BRIDGE_CONTRACT_NOT_FOUND: 'BRIDGE_CONTRACT_NOT_FOUND',
+    WITHDRAW_FAILED: 'WITHDRAW_FAILED',
+    POSITIONS_FAILED: 'POSITIONS_FAILED',
+    ACCOUNT_STATE_FAILED: 'ACCOUNT_STATE_FAILED',
+    MARKETS_FAILED: 'MARKETS_FAILED',
+    UNKNOWN_ERROR: 'UNKNOWN_ERROR',
+    // Provider-agnostic order errors
+    ORDER_LEVERAGE_REDUCTION_FAILED: 'ORDER_LEVERAGE_REDUCTION_FAILED',
+    // HyperLiquid-specific order errors
+    IOC_CANCEL: 'IOC_CANCEL', // Order could not immediately match (insufficient liquidity)
+    // Connection errors
+    CONNECTION_TIMEOUT: 'CONNECTION_TIMEOUT',
+    // Validation errors - withdraw
+    WITHDRAW_ASSET_ID_REQUIRED: 'WITHDRAW_ASSET_ID_REQUIRED',
+    WITHDRAW_AMOUNT_REQUIRED: 'WITHDRAW_AMOUNT_REQUIRED',
+    WITHDRAW_AMOUNT_POSITIVE: 'WITHDRAW_AMOUNT_POSITIVE',
+    WITHDRAW_INVALID_DESTINATION: 'WITHDRAW_INVALID_DESTINATION',
+    WITHDRAW_ASSET_NOT_SUPPORTED: 'WITHDRAW_ASSET_NOT_SUPPORTED',
+    WITHDRAW_INSUFFICIENT_BALANCE: 'WITHDRAW_INSUFFICIENT_BALANCE',
+    // Validation errors - deposit
+    DEPOSIT_ASSET_ID_REQUIRED: 'DEPOSIT_ASSET_ID_REQUIRED',
+    DEPOSIT_AMOUNT_REQUIRED: 'DEPOSIT_AMOUNT_REQUIRED',
+    DEPOSIT_AMOUNT_POSITIVE: 'DEPOSIT_AMOUNT_POSITIVE',
+    DEPOSIT_MINIMUM_AMOUNT: 'DEPOSIT_MINIMUM_AMOUNT',
+    // Validation errors - order
+    ORDER_COIN_REQUIRED: 'ORDER_COIN_REQUIRED',
+    ORDER_LIMIT_PRICE_REQUIRED: 'ORDER_LIMIT_PRICE_REQUIRED',
+    ORDER_PRICE_POSITIVE: 'ORDER_PRICE_POSITIVE',
+    ORDER_UNKNOWN_COIN: 'ORDER_UNKNOWN_COIN',
+    ORDER_SIZE_POSITIVE: 'ORDER_SIZE_POSITIVE',
+    ORDER_PRICE_REQUIRED: 'ORDER_PRICE_REQUIRED',
+    ORDER_SIZE_MIN: 'ORDER_SIZE_MIN',
+    ORDER_LEVERAGE_INVALID: 'ORDER_LEVERAGE_INVALID',
+    ORDER_LEVERAGE_BELOW_POSITION: 'ORDER_LEVERAGE_BELOW_POSITION',
+    ORDER_MAX_VALUE_EXCEEDED: 'ORDER_MAX_VALUE_EXCEEDED',
+    // HyperLiquid client/service errors
+    EXCHANGE_CLIENT_NOT_AVAILABLE: 'EXCHANGE_CLIENT_NOT_AVAILABLE',
+    INFO_CLIENT_NOT_AVAILABLE: 'INFO_CLIENT_NOT_AVAILABLE',
+    SUBSCRIPTION_CLIENT_NOT_AVAILABLE: 'SUBSCRIPTION_CLIENT_NOT_AVAILABLE',
+    // Wallet/account errors
+    NO_ACCOUNT_SELECTED: 'NO_ACCOUNT_SELECTED',
+    INVALID_ADDRESS_FORMAT: 'INVALID_ADDRESS_FORMAT',
+    // Transfer/swap errors
+    TRANSFER_FAILED: 'TRANSFER_FAILED',
+    SWAP_FAILED: 'SWAP_FAILED',
+    SPOT_PAIR_NOT_FOUND: 'SPOT_PAIR_NOT_FOUND',
+    PRICE_UNAVAILABLE: 'PRICE_UNAVAILABLE',
+    // Batch operation errors
+    BATCH_CANCEL_FAILED: 'BATCH_CANCEL_FAILED',
+    BATCH_CLOSE_FAILED: 'BATCH_CLOSE_FAILED',
+    // Position/margin errors
+    INSUFFICIENT_MARGIN: 'INSUFFICIENT_MARGIN',
+    INSUFFICIENT_BALANCE: 'INSUFFICIENT_BALANCE',
+    REDUCE_ONLY_VIOLATION: 'REDUCE_ONLY_VIOLATION',
+    POSITION_WOULD_FLIP: 'POSITION_WOULD_FLIP',
+    MARGIN_ADJUSTMENT_FAILED: 'MARGIN_ADJUSTMENT_FAILED',
+    TPSL_UPDATE_FAILED: 'TPSL_UPDATE_FAILED',
+    // Order execution errors
+    ORDER_REJECTED: 'ORDER_REJECTED',
+    SLIPPAGE_EXCEEDED: 'SLIPPAGE_EXCEEDED',
+    RATE_LIMIT_EXCEEDED: 'RATE_LIMIT_EXCEEDED',
+    // Network/service errors
+    SERVICE_UNAVAILABLE: 'SERVICE_UNAVAILABLE',
+    NETWORK_ERROR: 'NETWORK_ERROR',
+};
+//# sourceMappingURL=perpsErrorCodes.cjs.map

package/dist/constants/perpsErrorCodes.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"perpsErrorCodes.cjs","sourceRoot":"","sources":["../../src/constants/perpsErrorCodes.ts"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACU,QAAA,iBAAiB,GAAG;IAC/B,sBAAsB,EAAE,wBAAwB;IAChD,qBAAqB,EAAE,uBAAuB;IAC9C,sBAAsB,EAAE,wBAAwB;IAChD,mBAAmB,EAAE,qBAAqB;IAC1C,yBAAyB,EAAE,2BAA2B;IACtD,eAAe,EAAE,iBAAiB;IAClC,gBAAgB,EAAE,kBAAkB;IACpC,oBAAoB,EAAE,sBAAsB;IAC5C,cAAc,EAAE,gBAAgB;IAChC,aAAa,EAAE,eAAe;IAC9B,iCAAiC;IACjC,+BAA+B,EAAE,iCAAiC;IAClE,oCAAoC;IACpC,UAAU,EAAE,YAAY,EAAE,6DAA6D;IACvF,oBAAoB;IACpB,kBAAkB,EAAE,oBAAoB;IACxC,+BAA+B;IAC/B,0BAA0B,EAAE,4BAA4B;IACxD,wBAAwB,EAAE,0BAA0B;IACpD,wBAAwB,EAAE,0BAA0B;IACpD,4BAA4B,EAAE,8BAA8B;IAC5D,4BAA4B,EAAE,8BAA8B;IAC5D,6BAA6B,EAAE,+BAA+B;IAC9D,8BAA8B;IAC9B,yBAAyB,EAAE,2BAA2B;IACtD,uBAAuB,EAAE,yBAAyB;IAClD,uBAAuB,EAAE,yBAAyB;IAClD,sBAAsB,EAAE,wBAAwB;IAChD,4BAA4B;IAC5B,mBAAmB,EAAE,qBAAqB;IAC1C,0BAA0B,EAAE,4BAA4B;IACxD,oBAAoB,EAAE,sBAAsB;IAC5C,kBAAkB,EAAE,oBAAoB;IACxC,mBAAmB,EAAE,qBAAqB;IAC1C,oBAAoB,EAAE,sBAAsB;IAC5C,cAAc,EAAE,gBAAgB;IAChC,sBAAsB,EAAE,wBAAwB;IAChD,6BAA6B,EAAE,+BAA+B;IAC9D,wBAAwB,EAAE,0BAA0B;IACpD,oCAAoC;IACpC,6BAA6B,EAAE,+BAA+B;IAC9D,yBAAyB,EAAE,2BAA2B;IACtD,iCAAiC,EAAE,mCAAmC;IACtE,wBAAwB;IACxB,mBAAmB,EAAE,qBAAqB;IAC1C,sBAAsB,EAAE,wBAAwB;IAChD,uBAAuB;IACvB,eAAe,EAAE,iBAAiB;IAClC,WAAW,EAAE,aAAa;IAC1B,mBAAmB,EAAE,qBAAqB;IAC1C,iBAAiB,EAAE,mBAAmB;IACtC,yBAAyB;IACzB,mBAAmB,EAAE,qBAAqB;IAC1C,kBAAkB,EAAE,oBAAoB;IACxC,yBAAyB;IACzB,mBAAmB,EAAE,qBAAqB;IAC1C,oBAAoB,EAAE,sBAAsB;IAC5C,qBAAqB,EAAE,uBAAuB;IAC9C,mBAAmB,EAAE,qBAAqB;IAC1C,wBAAwB,EAAE,0BAA0B;IACpD,kBAAkB,EAAE,oBAAoB;IACxC,yBAAyB;IACzB,cAAc,EAAE,gBAAgB;IAChC,iBAAiB,EAAE,mBAAmB;IACtC,mBAAmB,EAAE,qBAAqB;IAC1C,yBAAyB;IACzB,mBAAmB,EAAE,qBAAqB;IAC1C,aAAa,EAAE,eAAe;CACtB,CAAC","sourcesContent":["/**\n * Error codes for PerpsController\n * These codes are returned to the UI layer for translation\n * Extracted to separate file to avoid circular dependencies with translatePerpsError\n */\nexport const PERPS_ERROR_CODES = {\n  CLIENT_NOT_INITIALIZED: 'CLIENT_NOT_INITIALIZED',\n  CLIENT_REINITIALIZING: 'CLIENT_REINITIALIZING',\n  PROVIDER_NOT_AVAILABLE: 'PROVIDER_NOT_AVAILABLE',\n  TOKEN_NOT_SUPPORTED: 'TOKEN_NOT_SUPPORTED',\n  BRIDGE_CONTRACT_NOT_FOUND: 'BRIDGE_CONTRACT_NOT_FOUND',\n  WITHDRAW_FAILED: 'WITHDRAW_FAILED',\n  POSITIONS_FAILED: 'POSITIONS_FAILED',\n  ACCOUNT_STATE_FAILED: 'ACCOUNT_STATE_FAILED',\n  MARKETS_FAILED: 'MARKETS_FAILED',\n  UNKNOWN_ERROR: 'UNKNOWN_ERROR',\n  // Provider-agnostic order errors\n  ORDER_LEVERAGE_REDUCTION_FAILED: 'ORDER_LEVERAGE_REDUCTION_FAILED',\n  // HyperLiquid-specific order errors\n  IOC_CANCEL: 'IOC_CANCEL', // Order could not immediately match (insufficient liquidity)\n  // Connection errors\n  CONNECTION_TIMEOUT: 'CONNECTION_TIMEOUT',\n  // Validation errors - withdraw\n  WITHDRAW_ASSET_ID_REQUIRED: 'WITHDRAW_ASSET_ID_REQUIRED',\n  WITHDRAW_AMOUNT_REQUIRED: 'WITHDRAW_AMOUNT_REQUIRED',\n  WITHDRAW_AMOUNT_POSITIVE: 'WITHDRAW_AMOUNT_POSITIVE',\n  WITHDRAW_INVALID_DESTINATION: 'WITHDRAW_INVALID_DESTINATION',\n  WITHDRAW_ASSET_NOT_SUPPORTED: 'WITHDRAW_ASSET_NOT_SUPPORTED',\n  WITHDRAW_INSUFFICIENT_BALANCE: 'WITHDRAW_INSUFFICIENT_BALANCE',\n  // Validation errors - deposit\n  DEPOSIT_ASSET_ID_REQUIRED: 'DEPOSIT_ASSET_ID_REQUIRED',\n  DEPOSIT_AMOUNT_REQUIRED: 'DEPOSIT_AMOUNT_REQUIRED',\n  DEPOSIT_AMOUNT_POSITIVE: 'DEPOSIT_AMOUNT_POSITIVE',\n  DEPOSIT_MINIMUM_AMOUNT: 'DEPOSIT_MINIMUM_AMOUNT',\n  // Validation errors - order\n  ORDER_COIN_REQUIRED: 'ORDER_COIN_REQUIRED',\n  ORDER_LIMIT_PRICE_REQUIRED: 'ORDER_LIMIT_PRICE_REQUIRED',\n  ORDER_PRICE_POSITIVE: 'ORDER_PRICE_POSITIVE',\n  ORDER_UNKNOWN_COIN: 'ORDER_UNKNOWN_COIN',\n  ORDER_SIZE_POSITIVE: 'ORDER_SIZE_POSITIVE',\n  ORDER_PRICE_REQUIRED: 'ORDER_PRICE_REQUIRED',\n  ORDER_SIZE_MIN: 'ORDER_SIZE_MIN',\n  ORDER_LEVERAGE_INVALID: 'ORDER_LEVERAGE_INVALID',\n  ORDER_LEVERAGE_BELOW_POSITION: 'ORDER_LEVERAGE_BELOW_POSITION',\n  ORDER_MAX_VALUE_EXCEEDED: 'ORDER_MAX_VALUE_EXCEEDED',\n  // HyperLiquid client/service errors\n  EXCHANGE_CLIENT_NOT_AVAILABLE: 'EXCHANGE_CLIENT_NOT_AVAILABLE',\n  INFO_CLIENT_NOT_AVAILABLE: 'INFO_CLIENT_NOT_AVAILABLE',\n  SUBSCRIPTION_CLIENT_NOT_AVAILABLE: 'SUBSCRIPTION_CLIENT_NOT_AVAILABLE',\n  // Wallet/account errors\n  NO_ACCOUNT_SELECTED: 'NO_ACCOUNT_SELECTED',\n  INVALID_ADDRESS_FORMAT: 'INVALID_ADDRESS_FORMAT',\n  // Transfer/swap errors\n  TRANSFER_FAILED: 'TRANSFER_FAILED',\n  SWAP_FAILED: 'SWAP_FAILED',\n  SPOT_PAIR_NOT_FOUND: 'SPOT_PAIR_NOT_FOUND',\n  PRICE_UNAVAILABLE: 'PRICE_UNAVAILABLE',\n  // Batch operation errors\n  BATCH_CANCEL_FAILED: 'BATCH_CANCEL_FAILED',\n  BATCH_CLOSE_FAILED: 'BATCH_CLOSE_FAILED',\n  // Position/margin errors\n  INSUFFICIENT_MARGIN: 'INSUFFICIENT_MARGIN',\n  INSUFFICIENT_BALANCE: 'INSUFFICIENT_BALANCE',\n  REDUCE_ONLY_VIOLATION: 'REDUCE_ONLY_VIOLATION',\n  POSITION_WOULD_FLIP: 'POSITION_WOULD_FLIP',\n  MARGIN_ADJUSTMENT_FAILED: 'MARGIN_ADJUSTMENT_FAILED',\n  TPSL_UPDATE_FAILED: 'TPSL_UPDATE_FAILED',\n  // Order execution errors\n  ORDER_REJECTED: 'ORDER_REJECTED',\n  SLIPPAGE_EXCEEDED: 'SLIPPAGE_EXCEEDED',\n  RATE_LIMIT_EXCEEDED: 'RATE_LIMIT_EXCEEDED',\n  // Network/service errors\n  SERVICE_UNAVAILABLE: 'SERVICE_UNAVAILABLE',\n  NETWORK_ERROR: 'NETWORK_ERROR',\n} as const;\n\nexport type PerpsErrorCode =\n  (typeof PERPS_ERROR_CODES)[keyof typeof PERPS_ERROR_CODES];\n"]}