@metamask-previews/perps-controller 2.0.0-preview-ce9be8b82 → 2.0.0-preview-373edc9

package/dist/PerpsController-method-action-types.cjs

@@ -1,3 +1,7 @@
 "use strict";
+/**
+ * This file is auto generated.
+ * Do not edit manually.
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 //# sourceMappingURL=PerpsController-method-action-types.cjs.map

package/dist/PerpsController-method-action-types.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"PerpsController-method-action-types.cjs","sourceRoot":"","sources":["../src/PerpsController-method-action-types.ts"],"names":[],"mappings":"","sourcesContent":["import type { PerpsController } from './PerpsController';\n\nexport type PerpsControllerPlaceOrderAction = {\n  type: 'PerpsController:placeOrder';\n  handler: PerpsController['placeOrder'];\n};\n\nexport type PerpsControllerEditOrderAction = {\n  type: 'PerpsController:editOrder';\n  handler: PerpsController['editOrder'];\n};\n\nexport type PerpsControllerCancelOrderAction = {\n  type: 'PerpsController:cancelOrder';\n  handler: PerpsController['cancelOrder'];\n};\n\nexport type PerpsControllerCancelOrdersAction = {\n  type: 'PerpsController:cancelOrders';\n  handler: PerpsController['cancelOrders'];\n};\n\nexport type PerpsControllerClosePositionAction = {\n  type: 'PerpsController:closePosition';\n  handler: PerpsController['closePosition'];\n};\n\nexport type PerpsControllerClosePositionsAction = {\n  type: 'PerpsController:closePositions';\n  handler: PerpsController['closePositions'];\n};\n\nexport type PerpsControllerWithdrawAction = {\n  type: 'PerpsController:withdraw';\n  handler: PerpsController['withdraw'];\n};\n\nexport type PerpsControllerGetPositionsAction = {\n  type: 'PerpsController:getPositions';\n  handler: PerpsController['getPositions'];\n};\n\nexport type PerpsControllerGetOrderFillsAction = {\n  type: 'PerpsController:getOrderFills';\n  handler: PerpsController['getOrderFills'];\n};\n\nexport type PerpsControllerGetOrdersAction = {\n  type: 'PerpsController:getOrders';\n  handler: PerpsController['getOrders'];\n};\n\nexport type PerpsControllerGetOpenOrdersAction = {\n  type: 'PerpsController:getOpenOrders';\n  handler: PerpsController['getOpenOrders'];\n};\n\nexport type PerpsControllerGetFundingAction = {\n  type: 'PerpsController:getFunding';\n  handler: PerpsController['getFunding'];\n};\n\nexport type PerpsControllerGetAccountStateAction = {\n  type: 'PerpsController:getAccountState';\n  handler: PerpsController['getAccountState'];\n};\n\nexport type PerpsControllerGetMarketsAction = {\n  type: 'PerpsController:getMarkets';\n  handler: PerpsController['getMarkets'];\n};\n\nexport type PerpsControllerRefreshEligibilityAction = {\n  type: 'PerpsController:refreshEligibility';\n  handler: PerpsController['refreshEligibility'];\n};\n\nexport type PerpsControllerToggleTestnetAction = {\n  type: 'PerpsController:toggleTestnet';\n  handler: PerpsController['toggleTestnet'];\n};\n\nexport type PerpsControllerDisconnectAction = {\n  type: 'PerpsController:disconnect';\n  handler: PerpsController['disconnect'];\n};\n\nexport type PerpsControllerCalculateFeesAction = {\n  type: 'PerpsController:calculateFees';\n  handler: PerpsController['calculateFees'];\n};\n\nexport type PerpsControllerMarkTutorialCompletedAction = {\n  type: 'PerpsController:markTutorialCompleted';\n  handler: PerpsController['markTutorialCompleted'];\n};\n\nexport type PerpsControllerMarkFirstOrderCompletedAction = {\n  type: 'PerpsController:markFirstOrderCompleted';\n  handler: PerpsController['markFirstOrderCompleted'];\n};\n\nexport type PerpsControllerGetHistoricalPortfolioAction = {\n  type: 'PerpsController:getHistoricalPortfolio';\n  handler: PerpsController['getHistoricalPortfolio'];\n};\n\nexport type PerpsControllerResetFirstTimeUserStateAction = {\n  type: 'PerpsController:resetFirstTimeUserState';\n  handler: PerpsController['resetFirstTimeUserState'];\n};\n\nexport type PerpsControllerClearPendingTransactionRequestsAction = {\n  type: 'PerpsController:clearPendingTransactionRequests';\n  handler: PerpsController['clearPendingTransactionRequests'];\n};\n\nexport type PerpsControllerSaveTradeConfigurationAction = {\n  type: 'PerpsController:saveTradeConfiguration';\n  handler: PerpsController['saveTradeConfiguration'];\n};\n\nexport type PerpsControllerGetTradeConfigurationAction = {\n  type: 'PerpsController:getTradeConfiguration';\n  handler: PerpsController['getTradeConfiguration'];\n};\n\nexport type PerpsControllerSaveMarketFilterPreferencesAction = {\n  type: 'PerpsController:saveMarketFilterPreferences';\n  handler: PerpsController['saveMarketFilterPreferences'];\n};\n\nexport type PerpsControllerGetMarketFilterPreferencesAction = {\n  type: 'PerpsController:getMarketFilterPreferences';\n  handler: PerpsController['getMarketFilterPreferences'];\n};\n\nexport type PerpsControllerSavePendingTradeConfigurationAction = {\n  type: 'PerpsController:savePendingTradeConfiguration';\n  handler: PerpsController['savePendingTradeConfiguration'];\n};\n\nexport type PerpsControllerGetPendingTradeConfigurationAction = {\n  type: 'PerpsController:getPendingTradeConfiguration';\n  handler: PerpsController['getPendingTradeConfiguration'];\n};\n\nexport type PerpsControllerClearPendingTradeConfigurationAction = {\n  type: 'PerpsController:clearPendingTradeConfiguration';\n  handler: PerpsController['clearPendingTradeConfiguration'];\n};\n\nexport type PerpsControllerGetOrderBookGroupingAction = {\n  type: 'PerpsController:getOrderBookGrouping';\n  handler: PerpsController['getOrderBookGrouping'];\n};\n\nexport type PerpsControllerSaveOrderBookGroupingAction = {\n  type: 'PerpsController:saveOrderBookGrouping';\n  handler: PerpsController['saveOrderBookGrouping'];\n};\n\nexport type PerpsControllerSetSelectedPaymentTokenAction = {\n  type: 'PerpsController:setSelectedPaymentToken';\n  handler: PerpsController['setSelectedPaymentToken'];\n};\n\nexport type PerpsControllerResetSelectedPaymentTokenAction = {\n  type: 'PerpsController:resetSelectedPaymentToken';\n  handler: PerpsController['resetSelectedPaymentToken'];\n};\n\nexport type PerpsControllerStartEligibilityMonitoringAction = {\n  type: 'PerpsController:startEligibilityMonitoring';\n  handler: PerpsController['startEligibilityMonitoring'];\n};\n\nexport type PerpsControllerStopEligibilityMonitoringAction = {\n  type: 'PerpsController:stopEligibilityMonitoring';\n  handler: PerpsController['stopEligibilityMonitoring'];\n};\n\nexport type PerpsControllerMethodActions =\n  | PerpsControllerPlaceOrderAction\n  | PerpsControllerEditOrderAction\n  | PerpsControllerCancelOrderAction\n  | PerpsControllerCancelOrdersAction\n  | PerpsControllerClosePositionAction\n  | PerpsControllerClosePositionsAction\n  | PerpsControllerWithdrawAction\n  | PerpsControllerGetPositionsAction\n  | PerpsControllerGetOrderFillsAction\n  | PerpsControllerGetOrdersAction\n  | PerpsControllerGetOpenOrdersAction\n  | PerpsControllerGetFundingAction\n  | PerpsControllerGetAccountStateAction\n  | PerpsControllerGetMarketsAction\n  | PerpsControllerRefreshEligibilityAction\n  | PerpsControllerToggleTestnetAction\n  | PerpsControllerDisconnectAction\n  | PerpsControllerCalculateFeesAction\n  | PerpsControllerMarkTutorialCompletedAction\n  | PerpsControllerMarkFirstOrderCompletedAction\n  | PerpsControllerGetHistoricalPortfolioAction\n  | PerpsControllerResetFirstTimeUserStateAction\n  | PerpsControllerClearPendingTransactionRequestsAction\n  | PerpsControllerSaveTradeConfigurationAction\n  | PerpsControllerGetTradeConfigurationAction\n  | PerpsControllerSaveMarketFilterPreferencesAction\n  | PerpsControllerGetMarketFilterPreferencesAction\n  | PerpsControllerSavePendingTradeConfigurationAction\n  | PerpsControllerGetPendingTradeConfigurationAction\n  | PerpsControllerClearPendingTradeConfigurationAction\n  | PerpsControllerGetOrderBookGroupingAction\n  | PerpsControllerSaveOrderBookGroupingAction\n  | PerpsControllerSetSelectedPaymentTokenAction\n  | PerpsControllerResetSelectedPaymentTokenAction\n  | PerpsControllerStartEligibilityMonitoringAction\n  | PerpsControllerStopEligibilityMonitoringAction;\n"]}
+{"version":3,"file":"PerpsController-method-action-types.cjs","sourceRoot":"","sources":["../src/PerpsController-method-action-types.ts"],"names":[],"mappings":";AAAA;;;GAGG","sourcesContent":["/**\n * This file is auto generated.\n * Do not edit manually.\n */\n\nimport type { PerpsController } from './PerpsController';\n\n/**\n * Place a new order\n * Thin delegation to TradingService\n *\n * @param params - The operation parameters.\n * @returns The order result with order ID and status.\n */\nexport type PerpsControllerPlaceOrderAction = {\n  type: `PerpsController:placeOrder`;\n  handler: PerpsController['placeOrder'];\n};\n\n/**\n * Edit an existing order\n * Thin delegation to TradingService\n *\n * @param params - The operation parameters.\n * @returns The updated order result with order ID and status.\n */\nexport type PerpsControllerEditOrderAction = {\n  type: `PerpsController:editOrder`;\n  handler: PerpsController['editOrder'];\n};\n\n/**\n * Cancel an existing order\n *\n * @param params - The operation parameters.\n * @returns The cancellation result with status.\n */\nexport type PerpsControllerCancelOrderAction = {\n  type: `PerpsController:cancelOrder`;\n  handler: PerpsController['cancelOrder'];\n};\n\n/**\n * Cancel multiple orders in parallel\n * Batch version of cancelOrder() that cancels multiple orders simultaneously\n *\n * @param params - The operation parameters.\n * @returns The batch cancellation results for each order.\n */\nexport type PerpsControllerCancelOrdersAction = {\n  type: `PerpsController:cancelOrders`;\n  handler: PerpsController['cancelOrders'];\n};\n\n/**\n * Close a position (partial or full)\n * Thin delegation to TradingService\n *\n * @param params - The operation parameters.\n * @returns The order result from the close position request.\n */\nexport type PerpsControllerClosePositionAction = {\n  type: `PerpsController:closePosition`;\n  handler: PerpsController['closePosition'];\n};\n\n/**\n * Close multiple positions in parallel\n * Batch version of closePosition() that closes multiple positions simultaneously\n *\n * @param params - The operation parameters.\n * @returns The batch close results for each position.\n */\nexport type PerpsControllerClosePositionsAction = {\n  type: `PerpsController:closePositions`;\n  handler: PerpsController['closePositions'];\n};\n\n/**\n * Withdraw funds from trading account\n *\n * The withdrawal process varies by provider and may involve:\n * - Direct on-chain transfers\n * - Bridge operations\n * - Multi-step validation processes\n *\n * Check the specific provider documentation for detailed withdrawal flows.\n *\n * @param params Withdrawal parameters\n * @returns WithdrawResult with withdrawal ID and tracking info\n */\nexport type PerpsControllerWithdrawAction = {\n  type: `PerpsController:withdraw`;\n  handler: PerpsController['withdraw'];\n};\n\n/**\n * Get current positions\n * Thin delegation to MarketDataService\n *\n * For standalone mode, bypasses getActiveProvider() to allow position queries\n * without full perps initialization (e.g., for showing positions on token details page)\n *\n * @param params - The operation parameters.\n * @returns Array of open positions for the active provider.\n */\nexport type PerpsControllerGetPositionsAction = {\n  type: `PerpsController:getPositions`;\n  handler: PerpsController['getPositions'];\n};\n\n/**\n * Get historical user fills (trade executions)\n * Thin delegation to MarketDataService\n *\n * @param params - The operation parameters.\n * @returns Array of historical trade executions (fills).\n */\nexport type PerpsControllerGetOrderFillsAction = {\n  type: `PerpsController:getOrderFills`;\n  handler: PerpsController['getOrderFills'];\n};\n\n/**\n * Get historical user orders (order lifecycle)\n * Thin delegation to MarketDataService\n *\n * @param params - The operation parameters.\n * @returns Array of historical orders.\n */\nexport type PerpsControllerGetOrdersAction = {\n  type: `PerpsController:getOrders`;\n  handler: PerpsController['getOrders'];\n};\n\n/**\n * Get currently open orders (real-time status)\n * Thin delegation to MarketDataService\n *\n * For standalone mode, bypasses getActiveProvider() to allow open order queries\n * without full perps initialization (e.g., for background preloading)\n *\n * @param params - The operation parameters.\n * @returns A promise that resolves to the result.\n */\nexport type PerpsControllerGetOpenOrdersAction = {\n  type: `PerpsController:getOpenOrders`;\n  handler: PerpsController['getOpenOrders'];\n};\n\n/**\n * Get historical user funding history (funding payments)\n * Thin delegation to MarketDataService\n *\n * @param params - The operation parameters.\n * @returns Array of historical funding payments.\n */\nexport type PerpsControllerGetFundingAction = {\n  type: `PerpsController:getFunding`;\n  handler: PerpsController['getFunding'];\n};\n\n/**\n * Get account state (balances, etc.)\n * Thin delegation to MarketDataService\n *\n * For standalone mode, bypasses getActiveProvider() to allow account state queries\n * without full perps initialization (e.g., for checking if user has perps funds)\n *\n * @param params - The operation parameters.\n * @returns A promise that resolves to the result.\n */\nexport type PerpsControllerGetAccountStateAction = {\n  type: `PerpsController:getAccountState`;\n  handler: PerpsController['getAccountState'];\n};\n\n/**\n * Get historical portfolio data\n * Thin delegation to MarketDataService\n *\n * @param params - The operation parameters.\n * @returns The historical portfolio data points.\n */\nexport type PerpsControllerGetHistoricalPortfolioAction = {\n  type: `PerpsController:getHistoricalPortfolio`;\n  handler: PerpsController['getHistoricalPortfolio'];\n};\n\n/**\n * Get available markets with optional filtering\n * Thin delegation to MarketDataService\n *\n * For standalone mode, bypasses getActiveProvider() to allow market discovery\n * without full perps initialization (e.g., for discovery banners on spot screens)\n *\n * @param params - The operation parameters.\n * @returns Array of available markets matching the filter criteria.\n */\nexport type PerpsControllerGetMarketsAction = {\n  type: `PerpsController:getMarkets`;\n  handler: PerpsController['getMarkets'];\n};\n\n/**\n * Toggle between testnet and mainnet\n *\n * @returns The toggle result with success status and current network mode.\n */\nexport type PerpsControllerToggleTestnetAction = {\n  type: `PerpsController:toggleTestnet`;\n  handler: PerpsController['toggleTestnet'];\n};\n\n/**\n * Calculate trading fees for the active provider\n * Each provider implements its own fee structure\n *\n * @param params - The operation parameters.\n * @returns The fee calculation result for the trade.\n */\nexport type PerpsControllerCalculateFeesAction = {\n  type: `PerpsController:calculateFees`;\n  handler: PerpsController['calculateFees'];\n};\n\n/**\n * Disconnect provider and cleanup subscriptions\n * Call this when navigating away from Perps screens to prevent battery drain\n */\nexport type PerpsControllerDisconnectAction = {\n  type: `PerpsController:disconnect`;\n  handler: PerpsController['disconnect'];\n};\n\n/**\n * Resume eligibility monitoring after onboarding completes.\n * Clears the deferred flag and triggers an immediate eligibility check\n * using the current remote feature flag state.\n */\nexport type PerpsControllerStartEligibilityMonitoringAction = {\n  type: `PerpsController:startEligibilityMonitoring`;\n  handler: PerpsController['startEligibilityMonitoring'];\n};\n\n/**\n * Stops geo-blocking eligibility monitoring.\n * Call this when the user disables basic functionality (e.g. useExternalServices becomes false).\n * Prevents geolocation calls until startEligibilityMonitoring() is called again.\n * Safe to call multiple times.\n */\nexport type PerpsControllerStopEligibilityMonitoringAction = {\n  type: `PerpsController:stopEligibilityMonitoring`;\n  handler: PerpsController['stopEligibilityMonitoring'];\n};\n\nexport type PerpsControllerRefreshEligibilityAction = {\n  type: `PerpsController:refreshEligibility`;\n  handler: PerpsController['refreshEligibility'];\n};\n\n/**\n * Mark that the user has completed the tutorial/onboarding\n * This prevents the tutorial from showing again\n */\nexport type PerpsControllerMarkTutorialCompletedAction = {\n  type: `PerpsController:markTutorialCompleted`;\n  handler: PerpsController['markTutorialCompleted'];\n};\n\nexport type PerpsControllerMarkFirstOrderCompletedAction = {\n  type: `PerpsController:markFirstOrderCompleted`;\n  handler: PerpsController['markFirstOrderCompleted'];\n};\n\n/**\n * Reset first-time user state for both networks\n * This is useful for testing the tutorial flow\n * Called by Reset Account feature in settings\n */\nexport type PerpsControllerResetFirstTimeUserStateAction = {\n  type: `PerpsController:resetFirstTimeUserState`;\n  handler: PerpsController['resetFirstTimeUserState'];\n};\n\n/**\n * Clear pending/bridging withdrawal and deposit requests\n * This is useful when users want to clear stuck pending indicators\n * Called by Reset Account feature in settings\n */\nexport type PerpsControllerClearPendingTransactionRequestsAction = {\n  type: `PerpsController:clearPendingTransactionRequests`;\n  handler: PerpsController['clearPendingTransactionRequests'];\n};\n\n/**\n * Get saved trade configuration for a market\n *\n * @param symbol - The trading pair symbol.\n * @returns The resulting string value.\n */\nexport type PerpsControllerGetTradeConfigurationAction = {\n  type: `PerpsController:getTradeConfiguration`;\n  handler: PerpsController['getTradeConfiguration'];\n};\n\n/**\n * Save trade configuration for a market\n *\n * @param symbol - Market symbol\n * @param leverage - Leverage value\n */\nexport type PerpsControllerSaveTradeConfigurationAction = {\n  type: `PerpsController:saveTradeConfiguration`;\n  handler: PerpsController['saveTradeConfiguration'];\n};\n\n/**\n * Save pending trade configuration for a market\n * This is a temporary configuration that expires after 5 minutes\n *\n * @param symbol - Market symbol\n * @param config - Pending trade configuration (includes optional selected payment token from Pay row)\n * @param config.amount - The amount value.\n * @param config.leverage - The leverage multiplier.\n * @param config.takeProfitPrice - The take profit price.\n * @param config.stopLossPrice - The stop loss price.\n * @param config.limitPrice - The limit price.\n * @param config.orderType - The order type.\n * @param config.selectedPaymentToken - The selected payment token.\n */\nexport type PerpsControllerSavePendingTradeConfigurationAction = {\n  type: `PerpsController:savePendingTradeConfiguration`;\n  handler: PerpsController['savePendingTradeConfiguration'];\n};\n\n/**\n * Get pending trade configuration for a market\n * Returns undefined if config doesn't exist or has expired (more than 5 minutes old)\n *\n * @param symbol - Market symbol\n * @returns Pending trade configuration or undefined\n */\nexport type PerpsControllerGetPendingTradeConfigurationAction = {\n  type: `PerpsController:getPendingTradeConfiguration`;\n  handler: PerpsController['getPendingTradeConfiguration'];\n};\n\n/**\n * Clear pending trade configuration for a market\n *\n * @param symbol - Market symbol\n */\nexport type PerpsControllerClearPendingTradeConfigurationAction = {\n  type: `PerpsController:clearPendingTradeConfiguration`;\n  handler: PerpsController['clearPendingTradeConfiguration'];\n};\n\n/**\n * Get saved market filter preferences\n * Handles backward compatibility with legacy string format\n *\n * @returns The saved sort option ID and direction.\n */\nexport type PerpsControllerGetMarketFilterPreferencesAction = {\n  type: `PerpsController:getMarketFilterPreferences`;\n  handler: PerpsController['getMarketFilterPreferences'];\n};\n\n/**\n * Save market filter preferences\n *\n * @param optionId - Sort/filter option ID\n * @param direction - Sort direction ('asc' or 'desc')\n */\nexport type PerpsControllerSaveMarketFilterPreferencesAction = {\n  type: `PerpsController:saveMarketFilterPreferences`;\n  handler: PerpsController['saveMarketFilterPreferences'];\n};\n\n/**\n * Set the selected payment token for the Perps order/deposit flow.\n * Pass null or a token with description PERPS_CONSTANTS.PerpsBalanceTokenDescription to select Perps balance.\n * Only required fields (address, chainId) are stored in state; description and symbol are optional.\n *\n * @param token - The token identifier.\n */\nexport type PerpsControllerSetSelectedPaymentTokenAction = {\n  type: `PerpsController:setSelectedPaymentToken`;\n  handler: PerpsController['setSelectedPaymentToken'];\n};\n\n/**\n * Reset the selected payment token to Perps balance (null).\n * Call when leaving the Perps order view so the next visit defaults to Perps balance.\n */\nexport type PerpsControllerResetSelectedPaymentTokenAction = {\n  type: `PerpsController:resetSelectedPaymentToken`;\n  handler: PerpsController['resetSelectedPaymentToken'];\n};\n\n/**\n * Get saved order book grouping for a market\n *\n * @param symbol - Market symbol\n * @returns The saved grouping value or undefined if not set\n */\nexport type PerpsControllerGetOrderBookGroupingAction = {\n  type: `PerpsController:getOrderBookGrouping`;\n  handler: PerpsController['getOrderBookGrouping'];\n};\n\n/**\n * Save order book grouping for a market\n *\n * @param symbol - Market symbol\n * @param grouping - Price grouping value\n */\nexport type PerpsControllerSaveOrderBookGroupingAction = {\n  type: `PerpsController:saveOrderBookGrouping`;\n  handler: PerpsController['saveOrderBookGrouping'];\n};\n\n/**\n * Union of all PerpsController action types.\n */\nexport type PerpsControllerMethodActions =\n  | PerpsControllerPlaceOrderAction\n  | PerpsControllerEditOrderAction\n  | PerpsControllerCancelOrderAction\n  | PerpsControllerCancelOrdersAction\n  | PerpsControllerClosePositionAction\n  | PerpsControllerClosePositionsAction\n  | PerpsControllerWithdrawAction\n  | PerpsControllerGetPositionsAction\n  | PerpsControllerGetOrderFillsAction\n  | PerpsControllerGetOrdersAction\n  | PerpsControllerGetOpenOrdersAction\n  | PerpsControllerGetFundingAction\n  | PerpsControllerGetAccountStateAction\n  | PerpsControllerGetHistoricalPortfolioAction\n  | PerpsControllerGetMarketsAction\n  | PerpsControllerToggleTestnetAction\n  | PerpsControllerCalculateFeesAction\n  | PerpsControllerDisconnectAction\n  | PerpsControllerStartEligibilityMonitoringAction\n  | PerpsControllerStopEligibilityMonitoringAction\n  | PerpsControllerRefreshEligibilityAction\n  | PerpsControllerMarkTutorialCompletedAction\n  | PerpsControllerMarkFirstOrderCompletedAction\n  | PerpsControllerResetFirstTimeUserStateAction\n  | PerpsControllerClearPendingTransactionRequestsAction\n  | PerpsControllerGetTradeConfigurationAction\n  | PerpsControllerSaveTradeConfigurationAction\n  | PerpsControllerSavePendingTradeConfigurationAction\n  | PerpsControllerGetPendingTradeConfigurationAction\n  | PerpsControllerClearPendingTradeConfigurationAction\n  | PerpsControllerGetMarketFilterPreferencesAction\n  | PerpsControllerSaveMarketFilterPreferencesAction\n  | PerpsControllerSetSelectedPaymentTokenAction\n  | PerpsControllerResetSelectedPaymentTokenAction\n  | PerpsControllerGetOrderBookGroupingAction\n  | PerpsControllerSaveOrderBookGroupingAction;\n"]}

package/dist/PerpsController-method-action-types.d.cts

@@ -1,147 +1,390 @@
+/**
+ * This file is auto generated.
+ * Do not edit manually.
+ */
 import type { PerpsController } from "./PerpsController.cjs";
+/**
+ * Place a new order
+ * Thin delegation to TradingService
+ *
+ * @param params - The operation parameters.
+ * @returns The order result with order ID and status.
+ */
 export type PerpsControllerPlaceOrderAction = {
-    type: 'PerpsController:placeOrder';
+    type: `PerpsController:placeOrder`;
     handler: PerpsController['placeOrder'];
 };
+/**
+ * Edit an existing order
+ * Thin delegation to TradingService
+ *
+ * @param params - The operation parameters.
+ * @returns The updated order result with order ID and status.
+ */
 export type PerpsControllerEditOrderAction = {
-    type: 'PerpsController:editOrder';
+    type: `PerpsController:editOrder`;
     handler: PerpsController['editOrder'];
 };
+/**
+ * Cancel an existing order
+ *
+ * @param params - The operation parameters.
+ * @returns The cancellation result with status.
+ */
 export type PerpsControllerCancelOrderAction = {
-    type: 'PerpsController:cancelOrder';
+    type: `PerpsController:cancelOrder`;
     handler: PerpsController['cancelOrder'];
 };
+/**
+ * Cancel multiple orders in parallel
+ * Batch version of cancelOrder() that cancels multiple orders simultaneously
+ *
+ * @param params - The operation parameters.
+ * @returns The batch cancellation results for each order.
+ */
 export type PerpsControllerCancelOrdersAction = {
-    type: 'PerpsController:cancelOrders';
+    type: `PerpsController:cancelOrders`;
     handler: PerpsController['cancelOrders'];
 };
+/**
+ * Close a position (partial or full)
+ * Thin delegation to TradingService
+ *
+ * @param params - The operation parameters.
+ * @returns The order result from the close position request.
+ */
 export type PerpsControllerClosePositionAction = {
-    type: 'PerpsController:closePosition';
+    type: `PerpsController:closePosition`;
     handler: PerpsController['closePosition'];
 };
+/**
+ * Close multiple positions in parallel
+ * Batch version of closePosition() that closes multiple positions simultaneously
+ *
+ * @param params - The operation parameters.
+ * @returns The batch close results for each position.
+ */
 export type PerpsControllerClosePositionsAction = {
-    type: 'PerpsController:closePositions';
+    type: `PerpsController:closePositions`;
     handler: PerpsController['closePositions'];
 };
+/**
+ * Withdraw funds from trading account
+ *
+ * The withdrawal process varies by provider and may involve:
+ * - Direct on-chain transfers
+ * - Bridge operations
+ * - Multi-step validation processes
+ *
+ * Check the specific provider documentation for detailed withdrawal flows.
+ *
+ * @param params Withdrawal parameters
+ * @returns WithdrawResult with withdrawal ID and tracking info
+ */
 export type PerpsControllerWithdrawAction = {
-    type: 'PerpsController:withdraw';
+    type: `PerpsController:withdraw`;
     handler: PerpsController['withdraw'];
 };
+/**
+ * Get current positions
+ * Thin delegation to MarketDataService
+ *
+ * For standalone mode, bypasses getActiveProvider() to allow position queries
+ * without full perps initialization (e.g., for showing positions on token details page)
+ *
+ * @param params - The operation parameters.
+ * @returns Array of open positions for the active provider.
+ */
 export type PerpsControllerGetPositionsAction = {
-    type: 'PerpsController:getPositions';
+    type: `PerpsController:getPositions`;
     handler: PerpsController['getPositions'];
 };
+/**
+ * Get historical user fills (trade executions)
+ * Thin delegation to MarketDataService
+ *
+ * @param params - The operation parameters.
+ * @returns Array of historical trade executions (fills).
+ */
 export type PerpsControllerGetOrderFillsAction = {
-    type: 'PerpsController:getOrderFills';
+    type: `PerpsController:getOrderFills`;
     handler: PerpsController['getOrderFills'];
 };
+/**
+ * Get historical user orders (order lifecycle)
+ * Thin delegation to MarketDataService
+ *
+ * @param params - The operation parameters.
+ * @returns Array of historical orders.
+ */
 export type PerpsControllerGetOrdersAction = {
-    type: 'PerpsController:getOrders';
+    type: `PerpsController:getOrders`;
     handler: PerpsController['getOrders'];
 };
+/**
+ * Get currently open orders (real-time status)
+ * Thin delegation to MarketDataService
+ *
+ * For standalone mode, bypasses getActiveProvider() to allow open order queries
+ * without full perps initialization (e.g., for background preloading)
+ *
+ * @param params - The operation parameters.
+ * @returns A promise that resolves to the result.
+ */
 export type PerpsControllerGetOpenOrdersAction = {
-    type: 'PerpsController:getOpenOrders';
+    type: `PerpsController:getOpenOrders`;
     handler: PerpsController['getOpenOrders'];
 };
+/**
+ * Get historical user funding history (funding payments)
+ * Thin delegation to MarketDataService
+ *
+ * @param params - The operation parameters.
+ * @returns Array of historical funding payments.
+ */
 export type PerpsControllerGetFundingAction = {
-    type: 'PerpsController:getFunding';
+    type: `PerpsController:getFunding`;
     handler: PerpsController['getFunding'];
 };
+/**
+ * Get account state (balances, etc.)
+ * Thin delegation to MarketDataService
+ *
+ * For standalone mode, bypasses getActiveProvider() to allow account state queries
+ * without full perps initialization (e.g., for checking if user has perps funds)
+ *
+ * @param params - The operation parameters.
+ * @returns A promise that resolves to the result.
+ */
 export type PerpsControllerGetAccountStateAction = {
-    type: 'PerpsController:getAccountState';
+    type: `PerpsController:getAccountState`;
     handler: PerpsController['getAccountState'];
 };
+/**
+ * Get historical portfolio data
+ * Thin delegation to MarketDataService
+ *
+ * @param params - The operation parameters.
+ * @returns The historical portfolio data points.
+ */
+export type PerpsControllerGetHistoricalPortfolioAction = {
+    type: `PerpsController:getHistoricalPortfolio`;
+    handler: PerpsController['getHistoricalPortfolio'];
+};
+/**
+ * Get available markets with optional filtering
+ * Thin delegation to MarketDataService
+ *
+ * For standalone mode, bypasses getActiveProvider() to allow market discovery
+ * without full perps initialization (e.g., for discovery banners on spot screens)
+ *
+ * @param params - The operation parameters.
+ * @returns Array of available markets matching the filter criteria.
+ */
 export type PerpsControllerGetMarketsAction = {
-    type: 'PerpsController:getMarkets';
+    type: `PerpsController:getMarkets`;
     handler: PerpsController['getMarkets'];
 };
-export type PerpsControllerRefreshEligibilityAction = {
-    type: 'PerpsController:refreshEligibility';
-    handler: PerpsController['refreshEligibility'];
-};
+/**
+ * Toggle between testnet and mainnet
+ *
+ * @returns The toggle result with success status and current network mode.
+ */
 export type PerpsControllerToggleTestnetAction = {
-    type: 'PerpsController:toggleTestnet';
+    type: `PerpsController:toggleTestnet`;
     handler: PerpsController['toggleTestnet'];
 };
+/**
+ * Calculate trading fees for the active provider
+ * Each provider implements its own fee structure
+ *
+ * @param params - The operation parameters.
+ * @returns The fee calculation result for the trade.
+ */
+export type PerpsControllerCalculateFeesAction = {
+    type: `PerpsController:calculateFees`;
+    handler: PerpsController['calculateFees'];
+};
+/**
+ * Disconnect provider and cleanup subscriptions
+ * Call this when navigating away from Perps screens to prevent battery drain
+ */
 export type PerpsControllerDisconnectAction = {
-    type: 'PerpsController:disconnect';
+    type: `PerpsController:disconnect`;
     handler: PerpsController['disconnect'];
 };
-export type PerpsControllerCalculateFeesAction = {
-    type: 'PerpsController:calculateFees';
-    handler: PerpsController['calculateFees'];
+/**
+ * Resume eligibility monitoring after onboarding completes.
+ * Clears the deferred flag and triggers an immediate eligibility check
+ * using the current remote feature flag state.
+ */
+export type PerpsControllerStartEligibilityMonitoringAction = {
+    type: `PerpsController:startEligibilityMonitoring`;
+    handler: PerpsController['startEligibilityMonitoring'];
+};
+/**
+ * Stops geo-blocking eligibility monitoring.
+ * Call this when the user disables basic functionality (e.g. useExternalServices becomes false).
+ * Prevents geolocation calls until startEligibilityMonitoring() is called again.
+ * Safe to call multiple times.
+ */
+export type PerpsControllerStopEligibilityMonitoringAction = {
+    type: `PerpsController:stopEligibilityMonitoring`;
+    handler: PerpsController['stopEligibilityMonitoring'];
+};
+export type PerpsControllerRefreshEligibilityAction = {
+    type: `PerpsController:refreshEligibility`;
+    handler: PerpsController['refreshEligibility'];
 };
+/**
+ * Mark that the user has completed the tutorial/onboarding
+ * This prevents the tutorial from showing again
+ */
 export type PerpsControllerMarkTutorialCompletedAction = {
-    type: 'PerpsController:markTutorialCompleted';
+    type: `PerpsController:markTutorialCompleted`;
     handler: PerpsController['markTutorialCompleted'];
 };
 export type PerpsControllerMarkFirstOrderCompletedAction = {
-    type: 'PerpsController:markFirstOrderCompleted';
+    type: `PerpsController:markFirstOrderCompleted`;
     handler: PerpsController['markFirstOrderCompleted'];
 };
-export type PerpsControllerGetHistoricalPortfolioAction = {
-    type: 'PerpsController:getHistoricalPortfolio';
-    handler: PerpsController['getHistoricalPortfolio'];
-};
+/**
+ * Reset first-time user state for both networks
+ * This is useful for testing the tutorial flow
+ * Called by Reset Account feature in settings
+ */
 export type PerpsControllerResetFirstTimeUserStateAction = {
-    type: 'PerpsController:resetFirstTimeUserState';
+    type: `PerpsController:resetFirstTimeUserState`;
     handler: PerpsController['resetFirstTimeUserState'];
 };
+/**
+ * Clear pending/bridging withdrawal and deposit requests
+ * This is useful when users want to clear stuck pending indicators
+ * Called by Reset Account feature in settings
+ */
 export type PerpsControllerClearPendingTransactionRequestsAction = {
-    type: 'PerpsController:clearPendingTransactionRequests';
+    type: `PerpsController:clearPendingTransactionRequests`;
     handler: PerpsController['clearPendingTransactionRequests'];
 };
-export type PerpsControllerSaveTradeConfigurationAction = {
-    type: 'PerpsController:saveTradeConfiguration';
-    handler: PerpsController['saveTradeConfiguration'];
-};
+/**
+ * Get saved trade configuration for a market
+ *
+ * @param symbol - The trading pair symbol.
+ * @returns The resulting string value.
+ */
 export type PerpsControllerGetTradeConfigurationAction = {
-    type: 'PerpsController:getTradeConfiguration';
+    type: `PerpsController:getTradeConfiguration`;
     handler: PerpsController['getTradeConfiguration'];
 };
-export type PerpsControllerSaveMarketFilterPreferencesAction = {
-    type: 'PerpsController:saveMarketFilterPreferences';
-    handler: PerpsController['saveMarketFilterPreferences'];
-};
-export type PerpsControllerGetMarketFilterPreferencesAction = {
-    type: 'PerpsController:getMarketFilterPreferences';
-    handler: PerpsController['getMarketFilterPreferences'];
+/**
+ * Save trade configuration for a market
+ *
+ * @param symbol - Market symbol
+ * @param leverage - Leverage value
+ */
+export type PerpsControllerSaveTradeConfigurationAction = {
+    type: `PerpsController:saveTradeConfiguration`;
+    handler: PerpsController['saveTradeConfiguration'];
 };
+/**
+ * Save pending trade configuration for a market
+ * This is a temporary configuration that expires after 5 minutes
+ *
+ * @param symbol - Market symbol
+ * @param config - Pending trade configuration (includes optional selected payment token from Pay row)
+ * @param config.amount - The amount value.
+ * @param config.leverage - The leverage multiplier.
+ * @param config.takeProfitPrice - The take profit price.
+ * @param config.stopLossPrice - The stop loss price.
+ * @param config.limitPrice - The limit price.
+ * @param config.orderType - The order type.
+ * @param config.selectedPaymentToken - The selected payment token.
+ */
 export type PerpsControllerSavePendingTradeConfigurationAction = {
-    type: 'PerpsController:savePendingTradeConfiguration';
+    type: `PerpsController:savePendingTradeConfiguration`;
     handler: PerpsController['savePendingTradeConfiguration'];
 };
+/**
+ * Get pending trade configuration for a market
+ * Returns undefined if config doesn't exist or has expired (more than 5 minutes old)
+ *
+ * @param symbol - Market symbol
+ * @returns Pending trade configuration or undefined
+ */
 export type PerpsControllerGetPendingTradeConfigurationAction = {
-    type: 'PerpsController:getPendingTradeConfiguration';
+    type: `PerpsController:getPendingTradeConfiguration`;
     handler: PerpsController['getPendingTradeConfiguration'];
 };
+/**
+ * Clear pending trade configuration for a market
+ *
+ * @param symbol - Market symbol
+ */
 export type PerpsControllerClearPendingTradeConfigurationAction = {
-    type: 'PerpsController:clearPendingTradeConfiguration';
+    type: `PerpsController:clearPendingTradeConfiguration`;
     handler: PerpsController['clearPendingTradeConfiguration'];
 };
-export type PerpsControllerGetOrderBookGroupingAction = {
-    type: 'PerpsController:getOrderBookGrouping';
-    handler: PerpsController['getOrderBookGrouping'];
+/**
+ * Get saved market filter preferences
+ * Handles backward compatibility with legacy string format
+ *
+ * @returns The saved sort option ID and direction.
+ */
+export type PerpsControllerGetMarketFilterPreferencesAction = {
+    type: `PerpsController:getMarketFilterPreferences`;
+    handler: PerpsController['getMarketFilterPreferences'];
 };
-export type PerpsControllerSaveOrderBookGroupingAction = {
-    type: 'PerpsController:saveOrderBookGrouping';
-    handler: PerpsController['saveOrderBookGrouping'];
+/**
+ * Save market filter preferences
+ *
+ * @param optionId - Sort/filter option ID
+ * @param direction - Sort direction ('asc' or 'desc')
+ */
+export type PerpsControllerSaveMarketFilterPreferencesAction = {
+    type: `PerpsController:saveMarketFilterPreferences`;
+    handler: PerpsController['saveMarketFilterPreferences'];
 };
+/**
+ * Set the selected payment token for the Perps order/deposit flow.
+ * Pass null or a token with description PERPS_CONSTANTS.PerpsBalanceTokenDescription to select Perps balance.
+ * Only required fields (address, chainId) are stored in state; description and symbol are optional.
+ *
+ * @param token - The token identifier.
+ */
 export type PerpsControllerSetSelectedPaymentTokenAction = {
-    type: 'PerpsController:setSelectedPaymentToken';
+    type: `PerpsController:setSelectedPaymentToken`;
     handler: PerpsController['setSelectedPaymentToken'];
 };
+/**
+ * Reset the selected payment token to Perps balance (null).
+ * Call when leaving the Perps order view so the next visit defaults to Perps balance.
+ */
 export type PerpsControllerResetSelectedPaymentTokenAction = {
-    type: 'PerpsController:resetSelectedPaymentToken';
+    type: `PerpsController:resetSelectedPaymentToken`;
     handler: PerpsController['resetSelectedPaymentToken'];
 };
-export type PerpsControllerStartEligibilityMonitoringAction = {
-    type: 'PerpsController:startEligibilityMonitoring';
-    handler: PerpsController['startEligibilityMonitoring'];
+/**
+ * Get saved order book grouping for a market
+ *
+ * @param symbol - Market symbol
+ * @returns The saved grouping value or undefined if not set
+ */
+export type PerpsControllerGetOrderBookGroupingAction = {
+    type: `PerpsController:getOrderBookGrouping`;
+    handler: PerpsController['getOrderBookGrouping'];
 };
-export type PerpsControllerStopEligibilityMonitoringAction = {
-    type: 'PerpsController:stopEligibilityMonitoring';
-    handler: PerpsController['stopEligibilityMonitoring'];
+/**
+ * Save order book grouping for a market
+ *
+ * @param symbol - Market symbol
+ * @param grouping - Price grouping value
+ */
+export type PerpsControllerSaveOrderBookGroupingAction = {
+    type: `PerpsController:saveOrderBookGrouping`;
+    handler: PerpsController['saveOrderBookGrouping'];
 };
-export type PerpsControllerMethodActions = PerpsControllerPlaceOrderAction | PerpsControllerEditOrderAction | PerpsControllerCancelOrderAction | PerpsControllerCancelOrdersAction | PerpsControllerClosePositionAction | PerpsControllerClosePositionsAction | PerpsControllerWithdrawAction | PerpsControllerGetPositionsAction | PerpsControllerGetOrderFillsAction | PerpsControllerGetOrdersAction | PerpsControllerGetOpenOrdersAction | PerpsControllerGetFundingAction | PerpsControllerGetAccountStateAction | PerpsControllerGetMarketsAction | PerpsControllerRefreshEligibilityAction | PerpsControllerToggleTestnetAction | PerpsControllerDisconnectAction | PerpsControllerCalculateFeesAction | PerpsControllerMarkTutorialCompletedAction | PerpsControllerMarkFirstOrderCompletedAction | PerpsControllerGetHistoricalPortfolioAction | PerpsControllerResetFirstTimeUserStateAction | PerpsControllerClearPendingTransactionRequestsAction | PerpsControllerSaveTradeConfigurationAction | PerpsControllerGetTradeConfigurationAction | PerpsControllerSaveMarketFilterPreferencesAction | PerpsControllerGetMarketFilterPreferencesAction | PerpsControllerSavePendingTradeConfigurationAction | PerpsControllerGetPendingTradeConfigurationAction | PerpsControllerClearPendingTradeConfigurationAction | PerpsControllerGetOrderBookGroupingAction | PerpsControllerSaveOrderBookGroupingAction | PerpsControllerSetSelectedPaymentTokenAction | PerpsControllerResetSelectedPaymentTokenAction | PerpsControllerStartEligibilityMonitoringAction | PerpsControllerStopEligibilityMonitoringAction;
+/**
+ * Union of all PerpsController action types.
+ */
+export type PerpsControllerMethodActions = PerpsControllerPlaceOrderAction | PerpsControllerEditOrderAction | PerpsControllerCancelOrderAction | PerpsControllerCancelOrdersAction | PerpsControllerClosePositionAction | PerpsControllerClosePositionsAction | PerpsControllerWithdrawAction | PerpsControllerGetPositionsAction | PerpsControllerGetOrderFillsAction | PerpsControllerGetOrdersAction | PerpsControllerGetOpenOrdersAction | PerpsControllerGetFundingAction | PerpsControllerGetAccountStateAction | PerpsControllerGetHistoricalPortfolioAction | PerpsControllerGetMarketsAction | PerpsControllerToggleTestnetAction | PerpsControllerCalculateFeesAction | PerpsControllerDisconnectAction | PerpsControllerStartEligibilityMonitoringAction | PerpsControllerStopEligibilityMonitoringAction | PerpsControllerRefreshEligibilityAction | PerpsControllerMarkTutorialCompletedAction | PerpsControllerMarkFirstOrderCompletedAction | PerpsControllerResetFirstTimeUserStateAction | PerpsControllerClearPendingTransactionRequestsAction | PerpsControllerGetTradeConfigurationAction | PerpsControllerSaveTradeConfigurationAction | PerpsControllerSavePendingTradeConfigurationAction | PerpsControllerGetPendingTradeConfigurationAction | PerpsControllerClearPendingTradeConfigurationAction | PerpsControllerGetMarketFilterPreferencesAction | PerpsControllerSaveMarketFilterPreferencesAction | PerpsControllerSetSelectedPaymentTokenAction | PerpsControllerResetSelectedPaymentTokenAction | PerpsControllerGetOrderBookGroupingAction | PerpsControllerSaveOrderBookGroupingAction;
 //# sourceMappingURL=PerpsController-method-action-types.d.cts.map

package/dist/PerpsController-method-action-types.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"PerpsController-method-action-types.d.cts","sourceRoot":"","sources":["../src/PerpsController-method-action-types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"PerpsController-method-action-types.d.cts","sourceRoot":"","sources":["../src/PerpsController-method-action-types.ts"],"names":[],"mappings":"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"}

package/dist/PerpsController-method-action-types.d.mts

@@ -1,147 +1,390 @@
+/**
+ * This file is auto generated.
+ * Do not edit manually.
+ */
 import type { PerpsController } from "./PerpsController.mjs";
+/**
+ * Place a new order
+ * Thin delegation to TradingService
+ *
+ * @param params - The operation parameters.
+ * @returns The order result with order ID and status.
+ */
 export type PerpsControllerPlaceOrderAction = {
-    type: 'PerpsController:placeOrder';
+    type: `PerpsController:placeOrder`;
     handler: PerpsController['placeOrder'];
 };
+/**
+ * Edit an existing order
+ * Thin delegation to TradingService
+ *
+ * @param params - The operation parameters.
+ * @returns The updated order result with order ID and status.
+ */
 export type PerpsControllerEditOrderAction = {
-    type: 'PerpsController:editOrder';
+    type: `PerpsController:editOrder`;
     handler: PerpsController['editOrder'];
 };
+/**
+ * Cancel an existing order
+ *
+ * @param params - The operation parameters.
+ * @returns The cancellation result with status.
+ */
 export type PerpsControllerCancelOrderAction = {
-    type: 'PerpsController:cancelOrder';
+    type: `PerpsController:cancelOrder`;
     handler: PerpsController['cancelOrder'];
 };
+/**
+ * Cancel multiple orders in parallel
+ * Batch version of cancelOrder() that cancels multiple orders simultaneously
+ *
+ * @param params - The operation parameters.
+ * @returns The batch cancellation results for each order.
+ */
 export type PerpsControllerCancelOrdersAction = {
-    type: 'PerpsController:cancelOrders';
+    type: `PerpsController:cancelOrders`;
     handler: PerpsController['cancelOrders'];
 };
+/**
+ * Close a position (partial or full)
+ * Thin delegation to TradingService
+ *
+ * @param params - The operation parameters.
+ * @returns The order result from the close position request.
+ */
 export type PerpsControllerClosePositionAction = {
-    type: 'PerpsController:closePosition';
+    type: `PerpsController:closePosition`;
     handler: PerpsController['closePosition'];
 };
+/**
+ * Close multiple positions in parallel
+ * Batch version of closePosition() that closes multiple positions simultaneously
+ *
+ * @param params - The operation parameters.
+ * @returns The batch close results for each position.
+ */
 export type PerpsControllerClosePositionsAction = {
-    type: 'PerpsController:closePositions';
+    type: `PerpsController:closePositions`;
     handler: PerpsController['closePositions'];
 };
+/**
+ * Withdraw funds from trading account
+ *
+ * The withdrawal process varies by provider and may involve:
+ * - Direct on-chain transfers
+ * - Bridge operations
+ * - Multi-step validation processes
+ *
+ * Check the specific provider documentation for detailed withdrawal flows.
+ *
+ * @param params Withdrawal parameters
+ * @returns WithdrawResult with withdrawal ID and tracking info
+ */
 export type PerpsControllerWithdrawAction = {
-    type: 'PerpsController:withdraw';
+    type: `PerpsController:withdraw`;
     handler: PerpsController['withdraw'];
 };
+/**
+ * Get current positions
+ * Thin delegation to MarketDataService
+ *
+ * For standalone mode, bypasses getActiveProvider() to allow position queries
+ * without full perps initialization (e.g., for showing positions on token details page)
+ *
+ * @param params - The operation parameters.
+ * @returns Array of open positions for the active provider.
+ */
 export type PerpsControllerGetPositionsAction = {
-    type: 'PerpsController:getPositions';
+    type: `PerpsController:getPositions`;
     handler: PerpsController['getPositions'];
 };
+/**
+ * Get historical user fills (trade executions)
+ * Thin delegation to MarketDataService
+ *
+ * @param params - The operation parameters.
+ * @returns Array of historical trade executions (fills).
+ */
 export type PerpsControllerGetOrderFillsAction = {
-    type: 'PerpsController:getOrderFills';
+    type: `PerpsController:getOrderFills`;
     handler: PerpsController['getOrderFills'];
 };
+/**
+ * Get historical user orders (order lifecycle)
+ * Thin delegation to MarketDataService
+ *
+ * @param params - The operation parameters.
+ * @returns Array of historical orders.
+ */
 export type PerpsControllerGetOrdersAction = {
-    type: 'PerpsController:getOrders';
+    type: `PerpsController:getOrders`;
     handler: PerpsController['getOrders'];
 };
+/**
+ * Get currently open orders (real-time status)
+ * Thin delegation to MarketDataService
+ *
+ * For standalone mode, bypasses getActiveProvider() to allow open order queries
+ * without full perps initialization (e.g., for background preloading)
+ *
+ * @param params - The operation parameters.
+ * @returns A promise that resolves to the result.
+ */
 export type PerpsControllerGetOpenOrdersAction = {
-    type: 'PerpsController:getOpenOrders';
+    type: `PerpsController:getOpenOrders`;
     handler: PerpsController['getOpenOrders'];
 };
+/**
+ * Get historical user funding history (funding payments)
+ * Thin delegation to MarketDataService
+ *
+ * @param params - The operation parameters.
+ * @returns Array of historical funding payments.
+ */
 export type PerpsControllerGetFundingAction = {
-    type: 'PerpsController:getFunding';
+    type: `PerpsController:getFunding`;
     handler: PerpsController['getFunding'];
 };
+/**
+ * Get account state (balances, etc.)
+ * Thin delegation to MarketDataService
+ *
+ * For standalone mode, bypasses getActiveProvider() to allow account state queries
+ * without full perps initialization (e.g., for checking if user has perps funds)
+ *
+ * @param params - The operation parameters.
+ * @returns A promise that resolves to the result.
+ */
 export type PerpsControllerGetAccountStateAction = {
-    type: 'PerpsController:getAccountState';
+    type: `PerpsController:getAccountState`;
     handler: PerpsController['getAccountState'];
 };
+/**
+ * Get historical portfolio data
+ * Thin delegation to MarketDataService
+ *
+ * @param params - The operation parameters.
+ * @returns The historical portfolio data points.
+ */
+export type PerpsControllerGetHistoricalPortfolioAction = {
+    type: `PerpsController:getHistoricalPortfolio`;
+    handler: PerpsController['getHistoricalPortfolio'];
+};
+/**
+ * Get available markets with optional filtering
+ * Thin delegation to MarketDataService
+ *
+ * For standalone mode, bypasses getActiveProvider() to allow market discovery
+ * without full perps initialization (e.g., for discovery banners on spot screens)
+ *
+ * @param params - The operation parameters.
+ * @returns Array of available markets matching the filter criteria.
+ */
 export type PerpsControllerGetMarketsAction = {
-    type: 'PerpsController:getMarkets';
+    type: `PerpsController:getMarkets`;
     handler: PerpsController['getMarkets'];
 };
-export type PerpsControllerRefreshEligibilityAction = {
-    type: 'PerpsController:refreshEligibility';
-    handler: PerpsController['refreshEligibility'];
-};
+/**
+ * Toggle between testnet and mainnet
+ *
+ * @returns The toggle result with success status and current network mode.
+ */
 export type PerpsControllerToggleTestnetAction = {
-    type: 'PerpsController:toggleTestnet';
+    type: `PerpsController:toggleTestnet`;
     handler: PerpsController['toggleTestnet'];
 };
+/**
+ * Calculate trading fees for the active provider
+ * Each provider implements its own fee structure
+ *
+ * @param params - The operation parameters.
+ * @returns The fee calculation result for the trade.
+ */
+export type PerpsControllerCalculateFeesAction = {
+    type: `PerpsController:calculateFees`;
+    handler: PerpsController['calculateFees'];
+};
+/**
+ * Disconnect provider and cleanup subscriptions
+ * Call this when navigating away from Perps screens to prevent battery drain
+ */
 export type PerpsControllerDisconnectAction = {
-    type: 'PerpsController:disconnect';
+    type: `PerpsController:disconnect`;
     handler: PerpsController['disconnect'];
 };
-export type PerpsControllerCalculateFeesAction = {
-    type: 'PerpsController:calculateFees';
-    handler: PerpsController['calculateFees'];
+/**
+ * Resume eligibility monitoring after onboarding completes.
+ * Clears the deferred flag and triggers an immediate eligibility check
+ * using the current remote feature flag state.
+ */
+export type PerpsControllerStartEligibilityMonitoringAction = {
+    type: `PerpsController:startEligibilityMonitoring`;
+    handler: PerpsController['startEligibilityMonitoring'];
+};
+/**
+ * Stops geo-blocking eligibility monitoring.
+ * Call this when the user disables basic functionality (e.g. useExternalServices becomes false).
+ * Prevents geolocation calls until startEligibilityMonitoring() is called again.
+ * Safe to call multiple times.
+ */
+export type PerpsControllerStopEligibilityMonitoringAction = {
+    type: `PerpsController:stopEligibilityMonitoring`;
+    handler: PerpsController['stopEligibilityMonitoring'];
+};
+export type PerpsControllerRefreshEligibilityAction = {
+    type: `PerpsController:refreshEligibility`;
+    handler: PerpsController['refreshEligibility'];
 };
+/**
+ * Mark that the user has completed the tutorial/onboarding
+ * This prevents the tutorial from showing again
+ */
 export type PerpsControllerMarkTutorialCompletedAction = {
-    type: 'PerpsController:markTutorialCompleted';
+    type: `PerpsController:markTutorialCompleted`;
     handler: PerpsController['markTutorialCompleted'];
 };
 export type PerpsControllerMarkFirstOrderCompletedAction = {
-    type: 'PerpsController:markFirstOrderCompleted';
+    type: `PerpsController:markFirstOrderCompleted`;
     handler: PerpsController['markFirstOrderCompleted'];
 };
-export type PerpsControllerGetHistoricalPortfolioAction = {
-    type: 'PerpsController:getHistoricalPortfolio';
-    handler: PerpsController['getHistoricalPortfolio'];
-};
+/**
+ * Reset first-time user state for both networks
+ * This is useful for testing the tutorial flow
+ * Called by Reset Account feature in settings
+ */
 export type PerpsControllerResetFirstTimeUserStateAction = {
-    type: 'PerpsController:resetFirstTimeUserState';
+    type: `PerpsController:resetFirstTimeUserState`;
     handler: PerpsController['resetFirstTimeUserState'];
 };
+/**
+ * Clear pending/bridging withdrawal and deposit requests
+ * This is useful when users want to clear stuck pending indicators
+ * Called by Reset Account feature in settings
+ */
 export type PerpsControllerClearPendingTransactionRequestsAction = {
-    type: 'PerpsController:clearPendingTransactionRequests';
+    type: `PerpsController:clearPendingTransactionRequests`;
     handler: PerpsController['clearPendingTransactionRequests'];
 };
-export type PerpsControllerSaveTradeConfigurationAction = {
-    type: 'PerpsController:saveTradeConfiguration';
-    handler: PerpsController['saveTradeConfiguration'];
-};
+/**
+ * Get saved trade configuration for a market
+ *
+ * @param symbol - The trading pair symbol.
+ * @returns The resulting string value.
+ */
 export type PerpsControllerGetTradeConfigurationAction = {
-    type: 'PerpsController:getTradeConfiguration';
+    type: `PerpsController:getTradeConfiguration`;
     handler: PerpsController['getTradeConfiguration'];
 };
-export type PerpsControllerSaveMarketFilterPreferencesAction = {
-    type: 'PerpsController:saveMarketFilterPreferences';
-    handler: PerpsController['saveMarketFilterPreferences'];
-};
-export type PerpsControllerGetMarketFilterPreferencesAction = {
-    type: 'PerpsController:getMarketFilterPreferences';
-    handler: PerpsController['getMarketFilterPreferences'];
+/**
+ * Save trade configuration for a market
+ *
+ * @param symbol - Market symbol
+ * @param leverage - Leverage value
+ */
+export type PerpsControllerSaveTradeConfigurationAction = {
+    type: `PerpsController:saveTradeConfiguration`;
+    handler: PerpsController['saveTradeConfiguration'];
 };
+/**
+ * Save pending trade configuration for a market
+ * This is a temporary configuration that expires after 5 minutes
+ *
+ * @param symbol - Market symbol
+ * @param config - Pending trade configuration (includes optional selected payment token from Pay row)
+ * @param config.amount - The amount value.
+ * @param config.leverage - The leverage multiplier.
+ * @param config.takeProfitPrice - The take profit price.
+ * @param config.stopLossPrice - The stop loss price.
+ * @param config.limitPrice - The limit price.
+ * @param config.orderType - The order type.
+ * @param config.selectedPaymentToken - The selected payment token.
+ */
 export type PerpsControllerSavePendingTradeConfigurationAction = {
-    type: 'PerpsController:savePendingTradeConfiguration';
+    type: `PerpsController:savePendingTradeConfiguration`;
     handler: PerpsController['savePendingTradeConfiguration'];
 };
+/**
+ * Get pending trade configuration for a market
+ * Returns undefined if config doesn't exist or has expired (more than 5 minutes old)
+ *
+ * @param symbol - Market symbol
+ * @returns Pending trade configuration or undefined
+ */
 export type PerpsControllerGetPendingTradeConfigurationAction = {
-    type: 'PerpsController:getPendingTradeConfiguration';
+    type: `PerpsController:getPendingTradeConfiguration`;
     handler: PerpsController['getPendingTradeConfiguration'];
 };
+/**
+ * Clear pending trade configuration for a market
+ *
+ * @param symbol - Market symbol
+ */
 export type PerpsControllerClearPendingTradeConfigurationAction = {
-    type: 'PerpsController:clearPendingTradeConfiguration';
+    type: `PerpsController:clearPendingTradeConfiguration`;
     handler: PerpsController['clearPendingTradeConfiguration'];
 };
-export type PerpsControllerGetOrderBookGroupingAction = {
-    type: 'PerpsController:getOrderBookGrouping';
-    handler: PerpsController['getOrderBookGrouping'];
+/**
+ * Get saved market filter preferences
+ * Handles backward compatibility with legacy string format
+ *
+ * @returns The saved sort option ID and direction.
+ */
+export type PerpsControllerGetMarketFilterPreferencesAction = {
+    type: `PerpsController:getMarketFilterPreferences`;
+    handler: PerpsController['getMarketFilterPreferences'];
 };
-export type PerpsControllerSaveOrderBookGroupingAction = {
-    type: 'PerpsController:saveOrderBookGrouping';
-    handler: PerpsController['saveOrderBookGrouping'];
+/**
+ * Save market filter preferences
+ *
+ * @param optionId - Sort/filter option ID
+ * @param direction - Sort direction ('asc' or 'desc')
+ */
+export type PerpsControllerSaveMarketFilterPreferencesAction = {
+    type: `PerpsController:saveMarketFilterPreferences`;
+    handler: PerpsController['saveMarketFilterPreferences'];
 };
+/**
+ * Set the selected payment token for the Perps order/deposit flow.
+ * Pass null or a token with description PERPS_CONSTANTS.PerpsBalanceTokenDescription to select Perps balance.
+ * Only required fields (address, chainId) are stored in state; description and symbol are optional.
+ *
+ * @param token - The token identifier.
+ */
 export type PerpsControllerSetSelectedPaymentTokenAction = {
-    type: 'PerpsController:setSelectedPaymentToken';
+    type: `PerpsController:setSelectedPaymentToken`;
     handler: PerpsController['setSelectedPaymentToken'];
 };
+/**
+ * Reset the selected payment token to Perps balance (null).
+ * Call when leaving the Perps order view so the next visit defaults to Perps balance.
+ */
 export type PerpsControllerResetSelectedPaymentTokenAction = {
-    type: 'PerpsController:resetSelectedPaymentToken';
+    type: `PerpsController:resetSelectedPaymentToken`;
     handler: PerpsController['resetSelectedPaymentToken'];
 };
-export type PerpsControllerStartEligibilityMonitoringAction = {
-    type: 'PerpsController:startEligibilityMonitoring';
-    handler: PerpsController['startEligibilityMonitoring'];
+/**
+ * Get saved order book grouping for a market
+ *
+ * @param symbol - Market symbol
+ * @returns The saved grouping value or undefined if not set
+ */
+export type PerpsControllerGetOrderBookGroupingAction = {
+    type: `PerpsController:getOrderBookGrouping`;
+    handler: PerpsController['getOrderBookGrouping'];
 };
-export type PerpsControllerStopEligibilityMonitoringAction = {
-    type: 'PerpsController:stopEligibilityMonitoring';
-    handler: PerpsController['stopEligibilityMonitoring'];
+/**
+ * Save order book grouping for a market
+ *
+ * @param symbol - Market symbol
+ * @param grouping - Price grouping value
+ */
+export type PerpsControllerSaveOrderBookGroupingAction = {
+    type: `PerpsController:saveOrderBookGrouping`;
+    handler: PerpsController['saveOrderBookGrouping'];
 };
-export type PerpsControllerMethodActions = PerpsControllerPlaceOrderAction | PerpsControllerEditOrderAction | PerpsControllerCancelOrderAction | PerpsControllerCancelOrdersAction | PerpsControllerClosePositionAction | PerpsControllerClosePositionsAction | PerpsControllerWithdrawAction | PerpsControllerGetPositionsAction | PerpsControllerGetOrderFillsAction | PerpsControllerGetOrdersAction | PerpsControllerGetOpenOrdersAction | PerpsControllerGetFundingAction | PerpsControllerGetAccountStateAction | PerpsControllerGetMarketsAction | PerpsControllerRefreshEligibilityAction | PerpsControllerToggleTestnetAction | PerpsControllerDisconnectAction | PerpsControllerCalculateFeesAction | PerpsControllerMarkTutorialCompletedAction | PerpsControllerMarkFirstOrderCompletedAction | PerpsControllerGetHistoricalPortfolioAction | PerpsControllerResetFirstTimeUserStateAction | PerpsControllerClearPendingTransactionRequestsAction | PerpsControllerSaveTradeConfigurationAction | PerpsControllerGetTradeConfigurationAction | PerpsControllerSaveMarketFilterPreferencesAction | PerpsControllerGetMarketFilterPreferencesAction | PerpsControllerSavePendingTradeConfigurationAction | PerpsControllerGetPendingTradeConfigurationAction | PerpsControllerClearPendingTradeConfigurationAction | PerpsControllerGetOrderBookGroupingAction | PerpsControllerSaveOrderBookGroupingAction | PerpsControllerSetSelectedPaymentTokenAction | PerpsControllerResetSelectedPaymentTokenAction | PerpsControllerStartEligibilityMonitoringAction | PerpsControllerStopEligibilityMonitoringAction;
+/**
+ * Union of all PerpsController action types.
+ */
+export type PerpsControllerMethodActions = PerpsControllerPlaceOrderAction | PerpsControllerEditOrderAction | PerpsControllerCancelOrderAction | PerpsControllerCancelOrdersAction | PerpsControllerClosePositionAction | PerpsControllerClosePositionsAction | PerpsControllerWithdrawAction | PerpsControllerGetPositionsAction | PerpsControllerGetOrderFillsAction | PerpsControllerGetOrdersAction | PerpsControllerGetOpenOrdersAction | PerpsControllerGetFundingAction | PerpsControllerGetAccountStateAction | PerpsControllerGetHistoricalPortfolioAction | PerpsControllerGetMarketsAction | PerpsControllerToggleTestnetAction | PerpsControllerCalculateFeesAction | PerpsControllerDisconnectAction | PerpsControllerStartEligibilityMonitoringAction | PerpsControllerStopEligibilityMonitoringAction | PerpsControllerRefreshEligibilityAction | PerpsControllerMarkTutorialCompletedAction | PerpsControllerMarkFirstOrderCompletedAction | PerpsControllerResetFirstTimeUserStateAction | PerpsControllerClearPendingTransactionRequestsAction | PerpsControllerGetTradeConfigurationAction | PerpsControllerSaveTradeConfigurationAction | PerpsControllerSavePendingTradeConfigurationAction | PerpsControllerGetPendingTradeConfigurationAction | PerpsControllerClearPendingTradeConfigurationAction | PerpsControllerGetMarketFilterPreferencesAction | PerpsControllerSaveMarketFilterPreferencesAction | PerpsControllerSetSelectedPaymentTokenAction | PerpsControllerResetSelectedPaymentTokenAction | PerpsControllerGetOrderBookGroupingAction | PerpsControllerSaveOrderBookGroupingAction;
 //# sourceMappingURL=PerpsController-method-action-types.d.mts.map

package/dist/PerpsController-method-action-types.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"PerpsController-method-action-types.d.mts","sourceRoot":"","sources":["../src/PerpsController-method-action-types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"PerpsController-method-action-types.d.mts","sourceRoot":"","sources":["../src/PerpsController-method-action-types.ts"],"names":[],"mappings":"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"}

package/dist/PerpsController-method-action-types.mjs

@@ -1,2 +1,6 @@
+/**
+ * This file is auto generated.
+ * Do not edit manually.
+ */
 export {};
 //# sourceMappingURL=PerpsController-method-action-types.mjs.map

package/dist/PerpsController-method-action-types.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"PerpsController-method-action-types.mjs","sourceRoot":"","sources":["../src/PerpsController-method-action-types.ts"],"names":[],"mappings":"","sourcesContent":["import type { PerpsController } from './PerpsController';\n\nexport type PerpsControllerPlaceOrderAction = {\n  type: 'PerpsController:placeOrder';\n  handler: PerpsController['placeOrder'];\n};\n\nexport type PerpsControllerEditOrderAction = {\n  type: 'PerpsController:editOrder';\n  handler: PerpsController['editOrder'];\n};\n\nexport type PerpsControllerCancelOrderAction = {\n  type: 'PerpsController:cancelOrder';\n  handler: PerpsController['cancelOrder'];\n};\n\nexport type PerpsControllerCancelOrdersAction = {\n  type: 'PerpsController:cancelOrders';\n  handler: PerpsController['cancelOrders'];\n};\n\nexport type PerpsControllerClosePositionAction = {\n  type: 'PerpsController:closePosition';\n  handler: PerpsController['closePosition'];\n};\n\nexport type PerpsControllerClosePositionsAction = {\n  type: 'PerpsController:closePositions';\n  handler: PerpsController['closePositions'];\n};\n\nexport type PerpsControllerWithdrawAction = {\n  type: 'PerpsController:withdraw';\n  handler: PerpsController['withdraw'];\n};\n\nexport type PerpsControllerGetPositionsAction = {\n  type: 'PerpsController:getPositions';\n  handler: PerpsController['getPositions'];\n};\n\nexport type PerpsControllerGetOrderFillsAction = {\n  type: 'PerpsController:getOrderFills';\n  handler: PerpsController['getOrderFills'];\n};\n\nexport type PerpsControllerGetOrdersAction = {\n  type: 'PerpsController:getOrders';\n  handler: PerpsController['getOrders'];\n};\n\nexport type PerpsControllerGetOpenOrdersAction = {\n  type: 'PerpsController:getOpenOrders';\n  handler: PerpsController['getOpenOrders'];\n};\n\nexport type PerpsControllerGetFundingAction = {\n  type: 'PerpsController:getFunding';\n  handler: PerpsController['getFunding'];\n};\n\nexport type PerpsControllerGetAccountStateAction = {\n  type: 'PerpsController:getAccountState';\n  handler: PerpsController['getAccountState'];\n};\n\nexport type PerpsControllerGetMarketsAction = {\n  type: 'PerpsController:getMarkets';\n  handler: PerpsController['getMarkets'];\n};\n\nexport type PerpsControllerRefreshEligibilityAction = {\n  type: 'PerpsController:refreshEligibility';\n  handler: PerpsController['refreshEligibility'];\n};\n\nexport type PerpsControllerToggleTestnetAction = {\n  type: 'PerpsController:toggleTestnet';\n  handler: PerpsController['toggleTestnet'];\n};\n\nexport type PerpsControllerDisconnectAction = {\n  type: 'PerpsController:disconnect';\n  handler: PerpsController['disconnect'];\n};\n\nexport type PerpsControllerCalculateFeesAction = {\n  type: 'PerpsController:calculateFees';\n  handler: PerpsController['calculateFees'];\n};\n\nexport type PerpsControllerMarkTutorialCompletedAction = {\n  type: 'PerpsController:markTutorialCompleted';\n  handler: PerpsController['markTutorialCompleted'];\n};\n\nexport type PerpsControllerMarkFirstOrderCompletedAction = {\n  type: 'PerpsController:markFirstOrderCompleted';\n  handler: PerpsController['markFirstOrderCompleted'];\n};\n\nexport type PerpsControllerGetHistoricalPortfolioAction = {\n  type: 'PerpsController:getHistoricalPortfolio';\n  handler: PerpsController['getHistoricalPortfolio'];\n};\n\nexport type PerpsControllerResetFirstTimeUserStateAction = {\n  type: 'PerpsController:resetFirstTimeUserState';\n  handler: PerpsController['resetFirstTimeUserState'];\n};\n\nexport type PerpsControllerClearPendingTransactionRequestsAction = {\n  type: 'PerpsController:clearPendingTransactionRequests';\n  handler: PerpsController['clearPendingTransactionRequests'];\n};\n\nexport type PerpsControllerSaveTradeConfigurationAction = {\n  type: 'PerpsController:saveTradeConfiguration';\n  handler: PerpsController['saveTradeConfiguration'];\n};\n\nexport type PerpsControllerGetTradeConfigurationAction = {\n  type: 'PerpsController:getTradeConfiguration';\n  handler: PerpsController['getTradeConfiguration'];\n};\n\nexport type PerpsControllerSaveMarketFilterPreferencesAction = {\n  type: 'PerpsController:saveMarketFilterPreferences';\n  handler: PerpsController['saveMarketFilterPreferences'];\n};\n\nexport type PerpsControllerGetMarketFilterPreferencesAction = {\n  type: 'PerpsController:getMarketFilterPreferences';\n  handler: PerpsController['getMarketFilterPreferences'];\n};\n\nexport type PerpsControllerSavePendingTradeConfigurationAction = {\n  type: 'PerpsController:savePendingTradeConfiguration';\n  handler: PerpsController['savePendingTradeConfiguration'];\n};\n\nexport type PerpsControllerGetPendingTradeConfigurationAction = {\n  type: 'PerpsController:getPendingTradeConfiguration';\n  handler: PerpsController['getPendingTradeConfiguration'];\n};\n\nexport type PerpsControllerClearPendingTradeConfigurationAction = {\n  type: 'PerpsController:clearPendingTradeConfiguration';\n  handler: PerpsController['clearPendingTradeConfiguration'];\n};\n\nexport type PerpsControllerGetOrderBookGroupingAction = {\n  type: 'PerpsController:getOrderBookGrouping';\n  handler: PerpsController['getOrderBookGrouping'];\n};\n\nexport type PerpsControllerSaveOrderBookGroupingAction = {\n  type: 'PerpsController:saveOrderBookGrouping';\n  handler: PerpsController['saveOrderBookGrouping'];\n};\n\nexport type PerpsControllerSetSelectedPaymentTokenAction = {\n  type: 'PerpsController:setSelectedPaymentToken';\n  handler: PerpsController['setSelectedPaymentToken'];\n};\n\nexport type PerpsControllerResetSelectedPaymentTokenAction = {\n  type: 'PerpsController:resetSelectedPaymentToken';\n  handler: PerpsController['resetSelectedPaymentToken'];\n};\n\nexport type PerpsControllerStartEligibilityMonitoringAction = {\n  type: 'PerpsController:startEligibilityMonitoring';\n  handler: PerpsController['startEligibilityMonitoring'];\n};\n\nexport type PerpsControllerStopEligibilityMonitoringAction = {\n  type: 'PerpsController:stopEligibilityMonitoring';\n  handler: PerpsController['stopEligibilityMonitoring'];\n};\n\nexport type PerpsControllerMethodActions =\n  | PerpsControllerPlaceOrderAction\n  | PerpsControllerEditOrderAction\n  | PerpsControllerCancelOrderAction\n  | PerpsControllerCancelOrdersAction\n  | PerpsControllerClosePositionAction\n  | PerpsControllerClosePositionsAction\n  | PerpsControllerWithdrawAction\n  | PerpsControllerGetPositionsAction\n  | PerpsControllerGetOrderFillsAction\n  | PerpsControllerGetOrdersAction\n  | PerpsControllerGetOpenOrdersAction\n  | PerpsControllerGetFundingAction\n  | PerpsControllerGetAccountStateAction\n  | PerpsControllerGetMarketsAction\n  | PerpsControllerRefreshEligibilityAction\n  | PerpsControllerToggleTestnetAction\n  | PerpsControllerDisconnectAction\n  | PerpsControllerCalculateFeesAction\n  | PerpsControllerMarkTutorialCompletedAction\n  | PerpsControllerMarkFirstOrderCompletedAction\n  | PerpsControllerGetHistoricalPortfolioAction\n  | PerpsControllerResetFirstTimeUserStateAction\n  | PerpsControllerClearPendingTransactionRequestsAction\n  | PerpsControllerSaveTradeConfigurationAction\n  | PerpsControllerGetTradeConfigurationAction\n  | PerpsControllerSaveMarketFilterPreferencesAction\n  | PerpsControllerGetMarketFilterPreferencesAction\n  | PerpsControllerSavePendingTradeConfigurationAction\n  | PerpsControllerGetPendingTradeConfigurationAction\n  | PerpsControllerClearPendingTradeConfigurationAction\n  | PerpsControllerGetOrderBookGroupingAction\n  | PerpsControllerSaveOrderBookGroupingAction\n  | PerpsControllerSetSelectedPaymentTokenAction\n  | PerpsControllerResetSelectedPaymentTokenAction\n  | PerpsControllerStartEligibilityMonitoringAction\n  | PerpsControllerStopEligibilityMonitoringAction;\n"]}
+{"version":3,"file":"PerpsController-method-action-types.mjs","sourceRoot":"","sources":["../src/PerpsController-method-action-types.ts"],"names":[],"mappings":"AAAA;;;GAGG","sourcesContent":["/**\n * This file is auto generated.\n * Do not edit manually.\n */\n\nimport type { PerpsController } from './PerpsController';\n\n/**\n * Place a new order\n * Thin delegation to TradingService\n *\n * @param params - The operation parameters.\n * @returns The order result with order ID and status.\n */\nexport type PerpsControllerPlaceOrderAction = {\n  type: `PerpsController:placeOrder`;\n  handler: PerpsController['placeOrder'];\n};\n\n/**\n * Edit an existing order\n * Thin delegation to TradingService\n *\n * @param params - The operation parameters.\n * @returns The updated order result with order ID and status.\n */\nexport type PerpsControllerEditOrderAction = {\n  type: `PerpsController:editOrder`;\n  handler: PerpsController['editOrder'];\n};\n\n/**\n * Cancel an existing order\n *\n * @param params - The operation parameters.\n * @returns The cancellation result with status.\n */\nexport type PerpsControllerCancelOrderAction = {\n  type: `PerpsController:cancelOrder`;\n  handler: PerpsController['cancelOrder'];\n};\n\n/**\n * Cancel multiple orders in parallel\n * Batch version of cancelOrder() that cancels multiple orders simultaneously\n *\n * @param params - The operation parameters.\n * @returns The batch cancellation results for each order.\n */\nexport type PerpsControllerCancelOrdersAction = {\n  type: `PerpsController:cancelOrders`;\n  handler: PerpsController['cancelOrders'];\n};\n\n/**\n * Close a position (partial or full)\n * Thin delegation to TradingService\n *\n * @param params - The operation parameters.\n * @returns The order result from the close position request.\n */\nexport type PerpsControllerClosePositionAction = {\n  type: `PerpsController:closePosition`;\n  handler: PerpsController['closePosition'];\n};\n\n/**\n * Close multiple positions in parallel\n * Batch version of closePosition() that closes multiple positions simultaneously\n *\n * @param params - The operation parameters.\n * @returns The batch close results for each position.\n */\nexport type PerpsControllerClosePositionsAction = {\n  type: `PerpsController:closePositions`;\n  handler: PerpsController['closePositions'];\n};\n\n/**\n * Withdraw funds from trading account\n *\n * The withdrawal process varies by provider and may involve:\n * - Direct on-chain transfers\n * - Bridge operations\n * - Multi-step validation processes\n *\n * Check the specific provider documentation for detailed withdrawal flows.\n *\n * @param params Withdrawal parameters\n * @returns WithdrawResult with withdrawal ID and tracking info\n */\nexport type PerpsControllerWithdrawAction = {\n  type: `PerpsController:withdraw`;\n  handler: PerpsController['withdraw'];\n};\n\n/**\n * Get current positions\n * Thin delegation to MarketDataService\n *\n * For standalone mode, bypasses getActiveProvider() to allow position queries\n * without full perps initialization (e.g., for showing positions on token details page)\n *\n * @param params - The operation parameters.\n * @returns Array of open positions for the active provider.\n */\nexport type PerpsControllerGetPositionsAction = {\n  type: `PerpsController:getPositions`;\n  handler: PerpsController['getPositions'];\n};\n\n/**\n * Get historical user fills (trade executions)\n * Thin delegation to MarketDataService\n *\n * @param params - The operation parameters.\n * @returns Array of historical trade executions (fills).\n */\nexport type PerpsControllerGetOrderFillsAction = {\n  type: `PerpsController:getOrderFills`;\n  handler: PerpsController['getOrderFills'];\n};\n\n/**\n * Get historical user orders (order lifecycle)\n * Thin delegation to MarketDataService\n *\n * @param params - The operation parameters.\n * @returns Array of historical orders.\n */\nexport type PerpsControllerGetOrdersAction = {\n  type: `PerpsController:getOrders`;\n  handler: PerpsController['getOrders'];\n};\n\n/**\n * Get currently open orders (real-time status)\n * Thin delegation to MarketDataService\n *\n * For standalone mode, bypasses getActiveProvider() to allow open order queries\n * without full perps initialization (e.g., for background preloading)\n *\n * @param params - The operation parameters.\n * @returns A promise that resolves to the result.\n */\nexport type PerpsControllerGetOpenOrdersAction = {\n  type: `PerpsController:getOpenOrders`;\n  handler: PerpsController['getOpenOrders'];\n};\n\n/**\n * Get historical user funding history (funding payments)\n * Thin delegation to MarketDataService\n *\n * @param params - The operation parameters.\n * @returns Array of historical funding payments.\n */\nexport type PerpsControllerGetFundingAction = {\n  type: `PerpsController:getFunding`;\n  handler: PerpsController['getFunding'];\n};\n\n/**\n * Get account state (balances, etc.)\n * Thin delegation to MarketDataService\n *\n * For standalone mode, bypasses getActiveProvider() to allow account state queries\n * without full perps initialization (e.g., for checking if user has perps funds)\n *\n * @param params - The operation parameters.\n * @returns A promise that resolves to the result.\n */\nexport type PerpsControllerGetAccountStateAction = {\n  type: `PerpsController:getAccountState`;\n  handler: PerpsController['getAccountState'];\n};\n\n/**\n * Get historical portfolio data\n * Thin delegation to MarketDataService\n *\n * @param params - The operation parameters.\n * @returns The historical portfolio data points.\n */\nexport type PerpsControllerGetHistoricalPortfolioAction = {\n  type: `PerpsController:getHistoricalPortfolio`;\n  handler: PerpsController['getHistoricalPortfolio'];\n};\n\n/**\n * Get available markets with optional filtering\n * Thin delegation to MarketDataService\n *\n * For standalone mode, bypasses getActiveProvider() to allow market discovery\n * without full perps initialization (e.g., for discovery banners on spot screens)\n *\n * @param params - The operation parameters.\n * @returns Array of available markets matching the filter criteria.\n */\nexport type PerpsControllerGetMarketsAction = {\n  type: `PerpsController:getMarkets`;\n  handler: PerpsController['getMarkets'];\n};\n\n/**\n * Toggle between testnet and mainnet\n *\n * @returns The toggle result with success status and current network mode.\n */\nexport type PerpsControllerToggleTestnetAction = {\n  type: `PerpsController:toggleTestnet`;\n  handler: PerpsController['toggleTestnet'];\n};\n\n/**\n * Calculate trading fees for the active provider\n * Each provider implements its own fee structure\n *\n * @param params - The operation parameters.\n * @returns The fee calculation result for the trade.\n */\nexport type PerpsControllerCalculateFeesAction = {\n  type: `PerpsController:calculateFees`;\n  handler: PerpsController['calculateFees'];\n};\n\n/**\n * Disconnect provider and cleanup subscriptions\n * Call this when navigating away from Perps screens to prevent battery drain\n */\nexport type PerpsControllerDisconnectAction = {\n  type: `PerpsController:disconnect`;\n  handler: PerpsController['disconnect'];\n};\n\n/**\n * Resume eligibility monitoring after onboarding completes.\n * Clears the deferred flag and triggers an immediate eligibility check\n * using the current remote feature flag state.\n */\nexport type PerpsControllerStartEligibilityMonitoringAction = {\n  type: `PerpsController:startEligibilityMonitoring`;\n  handler: PerpsController['startEligibilityMonitoring'];\n};\n\n/**\n * Stops geo-blocking eligibility monitoring.\n * Call this when the user disables basic functionality (e.g. useExternalServices becomes false).\n * Prevents geolocation calls until startEligibilityMonitoring() is called again.\n * Safe to call multiple times.\n */\nexport type PerpsControllerStopEligibilityMonitoringAction = {\n  type: `PerpsController:stopEligibilityMonitoring`;\n  handler: PerpsController['stopEligibilityMonitoring'];\n};\n\nexport type PerpsControllerRefreshEligibilityAction = {\n  type: `PerpsController:refreshEligibility`;\n  handler: PerpsController['refreshEligibility'];\n};\n\n/**\n * Mark that the user has completed the tutorial/onboarding\n * This prevents the tutorial from showing again\n */\nexport type PerpsControllerMarkTutorialCompletedAction = {\n  type: `PerpsController:markTutorialCompleted`;\n  handler: PerpsController['markTutorialCompleted'];\n};\n\nexport type PerpsControllerMarkFirstOrderCompletedAction = {\n  type: `PerpsController:markFirstOrderCompleted`;\n  handler: PerpsController['markFirstOrderCompleted'];\n};\n\n/**\n * Reset first-time user state for both networks\n * This is useful for testing the tutorial flow\n * Called by Reset Account feature in settings\n */\nexport type PerpsControllerResetFirstTimeUserStateAction = {\n  type: `PerpsController:resetFirstTimeUserState`;\n  handler: PerpsController['resetFirstTimeUserState'];\n};\n\n/**\n * Clear pending/bridging withdrawal and deposit requests\n * This is useful when users want to clear stuck pending indicators\n * Called by Reset Account feature in settings\n */\nexport type PerpsControllerClearPendingTransactionRequestsAction = {\n  type: `PerpsController:clearPendingTransactionRequests`;\n  handler: PerpsController['clearPendingTransactionRequests'];\n};\n\n/**\n * Get saved trade configuration for a market\n *\n * @param symbol - The trading pair symbol.\n * @returns The resulting string value.\n */\nexport type PerpsControllerGetTradeConfigurationAction = {\n  type: `PerpsController:getTradeConfiguration`;\n  handler: PerpsController['getTradeConfiguration'];\n};\n\n/**\n * Save trade configuration for a market\n *\n * @param symbol - Market symbol\n * @param leverage - Leverage value\n */\nexport type PerpsControllerSaveTradeConfigurationAction = {\n  type: `PerpsController:saveTradeConfiguration`;\n  handler: PerpsController['saveTradeConfiguration'];\n};\n\n/**\n * Save pending trade configuration for a market\n * This is a temporary configuration that expires after 5 minutes\n *\n * @param symbol - Market symbol\n * @param config - Pending trade configuration (includes optional selected payment token from Pay row)\n * @param config.amount - The amount value.\n * @param config.leverage - The leverage multiplier.\n * @param config.takeProfitPrice - The take profit price.\n * @param config.stopLossPrice - The stop loss price.\n * @param config.limitPrice - The limit price.\n * @param config.orderType - The order type.\n * @param config.selectedPaymentToken - The selected payment token.\n */\nexport type PerpsControllerSavePendingTradeConfigurationAction = {\n  type: `PerpsController:savePendingTradeConfiguration`;\n  handler: PerpsController['savePendingTradeConfiguration'];\n};\n\n/**\n * Get pending trade configuration for a market\n * Returns undefined if config doesn't exist or has expired (more than 5 minutes old)\n *\n * @param symbol - Market symbol\n * @returns Pending trade configuration or undefined\n */\nexport type PerpsControllerGetPendingTradeConfigurationAction = {\n  type: `PerpsController:getPendingTradeConfiguration`;\n  handler: PerpsController['getPendingTradeConfiguration'];\n};\n\n/**\n * Clear pending trade configuration for a market\n *\n * @param symbol - Market symbol\n */\nexport type PerpsControllerClearPendingTradeConfigurationAction = {\n  type: `PerpsController:clearPendingTradeConfiguration`;\n  handler: PerpsController['clearPendingTradeConfiguration'];\n};\n\n/**\n * Get saved market filter preferences\n * Handles backward compatibility with legacy string format\n *\n * @returns The saved sort option ID and direction.\n */\nexport type PerpsControllerGetMarketFilterPreferencesAction = {\n  type: `PerpsController:getMarketFilterPreferences`;\n  handler: PerpsController['getMarketFilterPreferences'];\n};\n\n/**\n * Save market filter preferences\n *\n * @param optionId - Sort/filter option ID\n * @param direction - Sort direction ('asc' or 'desc')\n */\nexport type PerpsControllerSaveMarketFilterPreferencesAction = {\n  type: `PerpsController:saveMarketFilterPreferences`;\n  handler: PerpsController['saveMarketFilterPreferences'];\n};\n\n/**\n * Set the selected payment token for the Perps order/deposit flow.\n * Pass null or a token with description PERPS_CONSTANTS.PerpsBalanceTokenDescription to select Perps balance.\n * Only required fields (address, chainId) are stored in state; description and symbol are optional.\n *\n * @param token - The token identifier.\n */\nexport type PerpsControllerSetSelectedPaymentTokenAction = {\n  type: `PerpsController:setSelectedPaymentToken`;\n  handler: PerpsController['setSelectedPaymentToken'];\n};\n\n/**\n * Reset the selected payment token to Perps balance (null).\n * Call when leaving the Perps order view so the next visit defaults to Perps balance.\n */\nexport type PerpsControllerResetSelectedPaymentTokenAction = {\n  type: `PerpsController:resetSelectedPaymentToken`;\n  handler: PerpsController['resetSelectedPaymentToken'];\n};\n\n/**\n * Get saved order book grouping for a market\n *\n * @param symbol - Market symbol\n * @returns The saved grouping value or undefined if not set\n */\nexport type PerpsControllerGetOrderBookGroupingAction = {\n  type: `PerpsController:getOrderBookGrouping`;\n  handler: PerpsController['getOrderBookGrouping'];\n};\n\n/**\n * Save order book grouping for a market\n *\n * @param symbol - Market symbol\n * @param grouping - Price grouping value\n */\nexport type PerpsControllerSaveOrderBookGroupingAction = {\n  type: `PerpsController:saveOrderBookGrouping`;\n  handler: PerpsController['saveOrderBookGrouping'];\n};\n\n/**\n * Union of all PerpsController action types.\n */\nexport type PerpsControllerMethodActions =\n  | PerpsControllerPlaceOrderAction\n  | PerpsControllerEditOrderAction\n  | PerpsControllerCancelOrderAction\n  | PerpsControllerCancelOrdersAction\n  | PerpsControllerClosePositionAction\n  | PerpsControllerClosePositionsAction\n  | PerpsControllerWithdrawAction\n  | PerpsControllerGetPositionsAction\n  | PerpsControllerGetOrderFillsAction\n  | PerpsControllerGetOrdersAction\n  | PerpsControllerGetOpenOrdersAction\n  | PerpsControllerGetFundingAction\n  | PerpsControllerGetAccountStateAction\n  | PerpsControllerGetHistoricalPortfolioAction\n  | PerpsControllerGetMarketsAction\n  | PerpsControllerToggleTestnetAction\n  | PerpsControllerCalculateFeesAction\n  | PerpsControllerDisconnectAction\n  | PerpsControllerStartEligibilityMonitoringAction\n  | PerpsControllerStopEligibilityMonitoringAction\n  | PerpsControllerRefreshEligibilityAction\n  | PerpsControllerMarkTutorialCompletedAction\n  | PerpsControllerMarkFirstOrderCompletedAction\n  | PerpsControllerResetFirstTimeUserStateAction\n  | PerpsControllerClearPendingTransactionRequestsAction\n  | PerpsControllerGetTradeConfigurationAction\n  | PerpsControllerSaveTradeConfigurationAction\n  | PerpsControllerSavePendingTradeConfigurationAction\n  | PerpsControllerGetPendingTradeConfigurationAction\n  | PerpsControllerClearPendingTradeConfigurationAction\n  | PerpsControllerGetMarketFilterPreferencesAction\n  | PerpsControllerSaveMarketFilterPreferencesAction\n  | PerpsControllerSetSelectedPaymentTokenAction\n  | PerpsControllerResetSelectedPaymentTokenAction\n  | PerpsControllerGetOrderBookGroupingAction\n  | PerpsControllerSaveOrderBookGroupingAction;\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metamask-previews/perps-controller",
-  "version": "2.0.0-preview-ce9be8b82",
+  "version": "2.0.0-preview-373edc9",
   "description": "Controller for perpetual trading functionality in MetaMask",
   "keywords": [
     "MetaMask",
@@ -65,12 +65,12 @@
     "@metamask/account-tree-controller": "^7.0.0",
     "@metamask/auto-changelog": "^3.4.4",
     "@metamask/geolocation-controller": "^0.1.2",
-    "@metamask/keyring-controller": "^25.1.1",
+    "@metamask/keyring-controller": "^25.2.0",
     "@metamask/keyring-internal-api": "^10.0.0",
     "@metamask/network-controller": "^30.0.1",
     "@metamask/profile-sync-controller": "^28.0.2",
     "@metamask/remote-feature-flag-controller": "^4.2.0",
-    "@metamask/transaction-controller": "^63.3.1",
+    "@metamask/transaction-controller": "^64.0.0",
     "@ts-bridge/cli": "^0.6.4",
     "@types/jest": "^29.5.14",
     "@types/uuid": "^8.3.0",