@metamask-previews/perps-controller 15.1.0-preview-00a181c → 15.1.0-preview-a302de5c3

package/dist/PerpsController.mjs

@@ -9,7 +9,7 @@ var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (
     if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
     return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
 };
-var _PerpsController_instances, _a, _PerpsController_initializationPromise, _PerpsController_isReinitializing, _PerpsController_reinitializationOperationPromise, _PerpsController_disconnectOperationPromise, _PerpsController_lighterRegistrationPromise, _PerpsController_blockedRegionListVersion, _PerpsController_hip3Enabled, _PerpsController_hip3AllowlistMarkets, _PerpsController_hip3BlocklistMarkets, _PerpsController_hip3ConfigSource, _PerpsController_priceDeviationLimit, _PerpsController_attributionContext, _PerpsController_isLighterProviderEnabled, _PerpsController_standaloneProvider, _PerpsController_handlersRegistered, _PerpsController_standaloneProviderIsTestnet, _PerpsController_standaloneProviderHip3Version, _PerpsController_standaloneProviderOperations, _PerpsController_eligibilityCheckDeferred, _PerpsController_ausQueue, _PerpsController_userDiskWrite, _PerpsController_getAgentSigner, _PerpsController_options, _PerpsController_tradingService, _PerpsController_marketDataService, _PerpsController_accountService, _PerpsController_eligibilityService, _PerpsController_dataLakeService, _PerpsController_depositService, _PerpsController_featureFlagConfigurationService, _PerpsController_rewardsIntegrationService, _PerpsController_publishChaseOrderMaxDistanceReached, _PerpsController_logError, _PerpsController_debugLog, _PerpsController_getAggregatedCacheProviderIds, _PerpsController_isMarketCacheEntryCurrent, _PerpsController_isUserCacheIdentityCurrent, _PerpsController_fetchAndCacheUserDataSnapshot, _PerpsController_getOrCreateStandaloneProvider, _PerpsController_trackStandaloneProviderOperation, _PerpsController_retireStandaloneProvider, _PerpsController_cleanupStandaloneProvider, _PerpsController_getMetrics, _PerpsController_findNetworkClientIdForChain, _PerpsController_submitTransaction, _PerpsController_migrateRequestsIfNeeded, _PerpsController_withStreamPause, _PerpsController_initWithoutDisconnectWait, _PerpsController_beginReinitialization, _PerpsController_performInitialization, _PerpsController_createProviders, _PerpsController_assignActiveProvider, _PerpsController_getErrorContext, _PerpsController_getControllerState, _PerpsController_buildMarketAllowedFilter, _PerpsController_compilePatternsSafely, _PerpsController_createServiceContext, _PerpsController_ensureTradingServiceDeps, _PerpsController_getActiveProviderWhenReady, _PerpsController_getUnavailableScalePriceLadder, _PerpsController_getUnavailableOrderCapabilities, _PerpsController_getDirectProviderId, _PerpsController_hasConflictingProviderRoute, _PerpsController_resolveRoutedOrderProvider, _PerpsController_buildGlobalSnapshotContext, _PerpsController_getStaticSnapshotDexes, _PerpsController_preloadWatchedPaths, _PerpsController_preloadTimer, _PerpsController_preloadStartRequested, _PerpsController_isPreloading, _PerpsController_marketPreloadQueued, _PerpsController_isPreloadingUserData, _PerpsController_userPreloadQueued, _PerpsController_lifecycleGeneration, _PerpsController_userSnapshotRequests, _PerpsController_preloadStateUnsubscribe, _PerpsController_accountChangeUnsubscribe, _PerpsController_previousIsTestnet, _PerpsController_previousHip3ConfigVersion, _PerpsController_preloadRefreshMs, _PerpsController_preloadGuardMs, _PerpsController_hydrateCacheFromDiskSync, _PerpsController_persistUserCacheToDisk, _PerpsController_performMarketDataPreload, _PerpsController_performUserDataPreload, _PerpsController_performDisconnect, _PerpsController_persistWatchlistToRemote, _PerpsController_syncWatchlistFromRemote;
+var _PerpsController_instances, _a, _PerpsController_initializationPromise, _PerpsController_isReinitializing, _PerpsController_reinitializationOperationPromise, _PerpsController_disconnectOperationPromise, _PerpsController_myxRegistrationPromise, _PerpsController_lighterRegistrationPromise, _PerpsController_blockedRegionListVersion, _PerpsController_hip3Enabled, _PerpsController_hip3AllowlistMarkets, _PerpsController_hip3BlocklistMarkets, _PerpsController_hip3ConfigSource, _PerpsController_priceDeviationLimit, _PerpsController_attributionContext, _PerpsController_isMYXProviderEnabled, _PerpsController_isLighterProviderEnabled, _PerpsController_standaloneProvider, _PerpsController_handlersRegistered, _PerpsController_standaloneProviderIsTestnet, _PerpsController_standaloneProviderHip3Version, _PerpsController_standaloneProviderOperations, _PerpsController_eligibilityCheckDeferred, _PerpsController_ausQueue, _PerpsController_userDiskWrite, _PerpsController_options, _PerpsController_tradingService, _PerpsController_marketDataService, _PerpsController_accountService, _PerpsController_eligibilityService, _PerpsController_dataLakeService, _PerpsController_depositService, _PerpsController_featureFlagConfigurationService, _PerpsController_rewardsIntegrationService, _PerpsController_publishChaseOrderMaxDistanceReached, _PerpsController_logError, _PerpsController_debugLog, _PerpsController_getAggregatedCacheProviderIds, _PerpsController_isMarketCacheEntryCurrent, _PerpsController_isUserCacheIdentityCurrent, _PerpsController_fetchAndCacheUserDataSnapshot, _PerpsController_getOrCreateStandaloneProvider, _PerpsController_trackStandaloneProviderOperation, _PerpsController_retireStandaloneProvider, _PerpsController_cleanupStandaloneProvider, _PerpsController_getMetrics, _PerpsController_findNetworkClientIdForChain, _PerpsController_submitTransaction, _PerpsController_migrateRequestsIfNeeded, _PerpsController_withStreamPause, _PerpsController_initWithoutDisconnectWait, _PerpsController_beginReinitialization, _PerpsController_performInitialization, _PerpsController_createProviders, _PerpsController_assignActiveProvider, _PerpsController_getErrorContext, _PerpsController_getControllerState, _PerpsController_buildMarketAllowedFilter, _PerpsController_compilePatternsSafely, _PerpsController_createServiceContext, _PerpsController_ensureTradingServiceDeps, _PerpsController_getActiveProviderWhenReady, _PerpsController_getUnavailableScalePriceLadder, _PerpsController_getUnavailableOrderCapabilities, _PerpsController_getDirectProviderId, _PerpsController_hasConflictingProviderRoute, _PerpsController_resolveRoutedOrderProvider, _PerpsController_buildGlobalSnapshotContext, _PerpsController_getStaticSnapshotDexes, _PerpsController_preloadWatchedPaths, _PerpsController_preloadTimer, _PerpsController_preloadStartRequested, _PerpsController_isPreloading, _PerpsController_marketPreloadQueued, _PerpsController_isPreloadingUserData, _PerpsController_userPreloadQueued, _PerpsController_lifecycleGeneration, _PerpsController_userSnapshotRequests, _PerpsController_preloadStateUnsubscribe, _PerpsController_accountChangeUnsubscribe, _PerpsController_previousIsTestnet, _PerpsController_previousHip3ConfigVersion, _PerpsController_preloadRefreshMs, _PerpsController_preloadGuardMs, _PerpsController_hydrateCacheFromDiskSync, _PerpsController_persistUserCacheToDisk, _PerpsController_performMarketDataPreload, _PerpsController_performUserDataPreload, _PerpsController_performDisconnect, _PerpsController_persistWatchlistToRemote, _PerpsController_syncWatchlistFromRemote;
 import { BaseController } from "@metamask/base-controller";
 import { ORIGIN_METAMASK } from "@metamask/controller-utils";
 import { v4 as uuidv4 } from "uuid";
@@ -69,6 +69,16 @@ function cloneUserDataSnapshot(snapshot) {
         },
     };
 }
+/**
+ * Returns the first non-empty string from the given values.
+ * Env vars default to '' (not null/undefined), so ?? wouldn't fall through.
+ *
+ * @param vals - String values to check in order.
+ * @returns The first non-empty string, or '' if all are empty/undefined.
+ */
+export function firstNonEmpty(...vals) {
+    return (vals.find((val) => val !== null && val !== undefined && val !== '') ?? '');
+}
 /**
  * Maps an active provider mode to the corresponding exchange key used in the
  * AUS {@link PerpsWatchlistMarkets} schema.
@@ -84,9 +94,31 @@ function cloneUserDataSnapshot(snapshot) {
 export function resolveWatchlistExchangeKey(activeProvider) {
     const map = {
         hyperliquid: 'hyperliquid',
+        myx: 'myx',
     };
     return map[activeProvider] ?? null;
 }
+/**
+ * Resolves MYX auth config from provider credentials, handling
+ * testnet/mainnet fallback logic.
+ *
+ * @param myx - MYX provider credentials.
+ * @param isTestnet - Whether the controller is in testnet mode.
+ * @returns Resolved appId, apiSecret, and brokerAddress.
+ */
+export function resolveMyxAuthConfig(myx, isTestnet) {
+    return {
+        appId: isTestnet
+            ? (myx.appIdTestnet ?? '')
+            : firstNonEmpty(myx.appIdMainnet, myx.appIdTestnet),
+        apiSecret: isTestnet
+            ? (myx.apiSecretTestnet ?? '')
+            : firstNonEmpty(myx.apiSecretMainnet, myx.apiSecretTestnet),
+        brokerAddress: isTestnet
+            ? (myx.brokerAddressTestnet ?? '')
+            : firstNonEmpty(myx.brokerAddressMainnet, myx.brokerAddressTestnet),
+    };
+}
 // Re-export error codes from separate file to avoid circular dependencies
 export { PERPS_ERROR_CODES } from "./perpsErrorCodes.mjs";
 /**
@@ -108,6 +140,7 @@ export { PerpsMode, DEFAULT_ORDER_BOOK_PREFERENCES, DEFAULT_PERPS_MODE, DEFAULT_
  * To change the active provider, modify the `activeProvider` value below:
  * - 'hyperliquid': HyperLiquid provider (default, production)
  * - 'aggregated': Multi-provider aggregation mode
+ * - 'myx': MYX provider (future implementation)
  *
  * @returns The default perps controller state.
  */
@@ -460,7 +493,6 @@ const MESSENGER_EXPOSED_METHODS = [
     'markTutorialCompleted',
     'placeOrder',
     'previewPositionModify',
-    'prepareTradingWallet',
     'reconnect',
     'recordMarketViewed',
     'refreshEligibility',
@@ -481,7 +513,6 @@ const MESSENGER_EXPOSED_METHODS = [
     'setLiveDataConfig',
     'setSelectedPaymentToken',
     'setVisibleCandleCount',
-    'setTradingWalletOverride',
     'startEligibilityMonitoring',
     'startMarketDataPreload',
     'stopEligibilityMonitoring',
@@ -518,7 +549,7 @@ const MESSENGER_EXPOSED_METHODS = [
  * - Live data uses direct callbacks for maximum performance
  */
 export class PerpsController extends BaseController {
-    constructor({ messenger, state = {}, clientConfig = {}, infrastructure, deferEligibilityCheck = false, getAgentSigner, }) {
+    constructor({ messenger, state = {}, clientConfig = {}, infrastructure, deferEligibilityCheck = false, }) {
         super({
             name: 'PerpsController',
             metadata,
@@ -531,6 +562,8 @@ export class PerpsController extends BaseController {
         _PerpsController_isReinitializing.set(this, false);
         _PerpsController_reinitializationOperationPromise.set(this, null);
         _PerpsController_disconnectOperationPromise.set(this, null);
+        /** Tracks the async MYX dynamic import so performInitialization can await it. */
+        _PerpsController_myxRegistrationPromise.set(this, null);
         _PerpsController_lighterRegistrationPromise.set(this, null);
         this.blockedRegionList = {
             list: [],
@@ -560,7 +593,7 @@ export class PerpsController extends BaseController {
         _PerpsController_attributionContext.set(this, {});
         /**
          * Active provider instance for routing operations.
-         * When activeProvider is 'hyperliquid' or 'lighter': points to specific provider directly
+         * When activeProvider is 'hyperliquid' or 'myx': points to specific provider directly
          * When activeProvider is 'aggregated': points to AggregatedPerpsProvider wrapper
          */
         this.activeProviderInstance = null;
@@ -590,9 +623,6 @@ export class PerpsController extends BaseController {
          */
         _PerpsController_ausQueue.set(this, Promise.resolve());
         _PerpsController_userDiskWrite.set(this, Promise.resolve());
-        // Resolves the local agent signer for the selected master account, or null.
-        // Passed through to the HyperLiquid provider for the agent signing seam.
-        _PerpsController_getAgentSigner.set(this, undefined);
         // Store options for dependency injection (allows core package to inject platform-specific services)
         _PerpsController_options.set(this, void 0);
         // Service instances (instantiated with platform dependencies)
@@ -620,7 +650,6 @@ export class PerpsController extends BaseController {
         _PerpsController_previousIsTestnet.set(this, null);
         _PerpsController_previousHip3ConfigVersion.set(this, null);
         __classPrivateFieldSet(this, _PerpsController_eligibilityCheckDeferred, deferEligibilityCheck, "f");
-        __classPrivateFieldSet(this, _PerpsController_getAgentSigner, getAgentSigner, "f");
         // Store options for dependency injection
         __classPrivateFieldSet(this, _PerpsController_options, {
             messenger,
@@ -983,6 +1012,50 @@ export class PerpsController extends BaseController {
             return __classPrivateFieldGet(this, _PerpsController_instances, "m", _PerpsController_initWithoutDisconnectWait).call(this);
         }
     }
+    /**
+     * Registers the MYX provider after dynamic import resolves.
+     *
+     * Extracted from the import().then() callback so it can be tested directly
+     * (Jest cannot resolve dynamic imports without --experimental-vm-modules).
+     *
+     * @param MYXProvider - Constructor class for the MYX provider.
+     */
+    registerMYXProvider(MYXProvider) {
+        if (typeof MYXProvider !== 'function') {
+            return;
+        }
+        const myxIsTestnet = PROVIDER_CONFIG.MYX_TESTNET_ONLY || this.state.isTestnet;
+        const myx = __classPrivateFieldGet(this, _PerpsController_options, "f").clientConfig?.providerCredentials?.myx ?? {};
+        const myxAuthConfig = resolveMyxAuthConfig(myx, myxIsTestnet);
+        const MYXProviderConstructor = MYXProvider;
+        const myxProvider = new MYXProviderConstructor({
+            isTestnet: myxIsTestnet,
+            platformDependencies: __classPrivateFieldGet(this, _PerpsController_options, "f").infrastructure,
+            messenger: this.messenger,
+            myxAuthConfig,
+        });
+        this.providers.set('myx', myxProvider);
+        __classPrivateFieldGet(this, _PerpsController_instances, "m", _PerpsController_debugLog).call(this, 'PerpsController: MYX provider registered', {
+            isTestnet: myxIsTestnet,
+        });
+    }
+    /**
+     * Handles errors from the MYX dynamic import.
+     *
+     * Module-not-found errors are expected (extension doesn't ship MYX) → debug log.
+     * Other errors indicate constructor/config problems → Sentry via logError.
+     *
+     * @param error - The caught error from the dynamic import or constructor.
+     */
+    handleMYXImportError(error) {
+        const isModuleError = error?.code === 'MODULE_NOT_FOUND';
+        if (isModuleError) {
+            __classPrivateFieldGet(this, _PerpsController_instances, "m", _PerpsController_debugLog).call(this, 'PerpsController: MYX provider module not available, skipping registration');
+        }
+        else {
+            __classPrivateFieldGet(this, _PerpsController_instances, "m", _PerpsController_logError).call(this, error instanceof Error ? error : new Error(String(error)), __classPrivateFieldGet(this, _PerpsController_instances, "m", _PerpsController_getErrorContext).call(this, 'createProviders.myx'));
+        }
+    }
     /**
      * Registers the Lighter provider after dynamic import resolves.
      *
@@ -1802,7 +1875,7 @@ export class PerpsController extends BaseController {
         if (params?.standalone && params.userAddress) {
             // Use activeProviderInstance if available (respects provider abstraction)
             // Fallback to cached standalone provider for pre-initialization discovery
-            // TODO: When adding new providers, consider a provider factory pattern
+            // TODO: When adding new providers (MYX), consider a provider factory pattern
             const provider = this.activeProviderInstance ?? __classPrivateFieldGet(this, _PerpsController_instances, "m", _PerpsController_getOrCreateStandaloneProvider).call(this);
             const operation = provider.getPositions(params);
             return provider === __classPrivateFieldGet(this, _PerpsController_standaloneProvider, "f")
@@ -2391,25 +2464,6 @@ export class PerpsController extends BaseController {
         // Provided properties win over attribution context.
         return { ...utm, ...properties };
     }
-    /**
-     * Override (or clear) the trading wallet the HyperLiquid provider signs with.
-     *
-     * The host app calls this with a local agent signer when an agent wallet
-     * activates, and with `null` when the keyring locks (restoring the master
-     * keyring path). Throws when the HyperLiquid provider is not (yet)
-     * registered — callers should treat that as best-effort.
-     *
-     * @param signer - The agent signer to sign with, or null for the master path.
-     * @returns A promise that resolves when the clients have re-initialized with
-     * the new wallet.
-     */
-    async setTradingWalletOverride(signer) {
-        const provider = this.providers.get('hyperliquid');
-        if (!(provider instanceof HyperLiquidProvider)) {
-            throw new Error(PERPS_ERROR_CODES.PROVIDER_NOT_AVAILABLE);
-        }
-        return provider.setTradingWalletOverride(signer);
-    }
     /**
      * Toggle between testnet and mainnet
      *
@@ -3014,24 +3068,6 @@ export class PerpsController extends BaseController {
             ? provider.approveSubscriptionBuilderFee()
             : false;
     }
-    /**
-     * Run the deferred trading-readiness steps for the active provider
-     * (unified account enablement with user signing, builder fee approval) so
-     * any required master signature surfaces during a guided session (e.g.
-     * agent wallet setup) instead of as a surprise prompt on the first order.
-     *
-     * Reuses the provider's own trading-readiness sequence, which is cached:
-     * an already-ready wallet completes without any signature. Providers
-     * without deferred setup make this a no-op. Best-effort by design of the
-     * underlying sequence: builder-fee failures are swallowed there and retried
-     * at order time; only initialization/migration errors propagate.
-     */
-    async prepareTradingWallet() {
-        const provider = await __classPrivateFieldGet(this, _PerpsController_instances, "m", _PerpsController_getActiveProviderWhenReady).call(this);
-        if (provider.prepareTradingWallet) {
-            await provider.prepareTradingWallet();
-        }
-    }
     /**
      * Drop the cached subscription benefits snapshot.
      *
@@ -3824,7 +3860,36 @@ export class PerpsController extends BaseController {
         return __classPrivateFieldGet(this, _PerpsController_isReinitializing, "f");
     }
 }
-_a = PerpsController, _PerpsController_initializationPromise = new WeakMap(), _PerpsController_isReinitializing = new WeakMap(), _PerpsController_reinitializationOperationPromise = new WeakMap(), _PerpsController_disconnectOperationPromise = new WeakMap(), _PerpsController_lighterRegistrationPromise = new WeakMap(), _PerpsController_blockedRegionListVersion = new WeakMap(), _PerpsController_hip3Enabled = new WeakMap(), _PerpsController_hip3AllowlistMarkets = new WeakMap(), _PerpsController_hip3BlocklistMarkets = new WeakMap(), _PerpsController_hip3ConfigSource = new WeakMap(), _PerpsController_priceDeviationLimit = new WeakMap(), _PerpsController_attributionContext = new WeakMap(), _PerpsController_standaloneProvider = new WeakMap(), _PerpsController_handlersRegistered = new WeakMap(), _PerpsController_standaloneProviderIsTestnet = new WeakMap(), _PerpsController_standaloneProviderHip3Version = new WeakMap(), _PerpsController_standaloneProviderOperations = new WeakMap(), _PerpsController_eligibilityCheckDeferred = new WeakMap(), _PerpsController_ausQueue = new WeakMap(), _PerpsController_userDiskWrite = new WeakMap(), _PerpsController_getAgentSigner = new WeakMap(), _PerpsController_options = new WeakMap(), _PerpsController_tradingService = new WeakMap(), _PerpsController_marketDataService = new WeakMap(), _PerpsController_accountService = new WeakMap(), _PerpsController_eligibilityService = new WeakMap(), _PerpsController_dataLakeService = new WeakMap(), _PerpsController_depositService = new WeakMap(), _PerpsController_featureFlagConfigurationService = new WeakMap(), _PerpsController_rewardsIntegrationService = new WeakMap(), _PerpsController_publishChaseOrderMaxDistanceReached = new WeakMap(), _PerpsController_preloadTimer = new WeakMap(), _PerpsController_preloadStartRequested = new WeakMap(), _PerpsController_isPreloading = new WeakMap(), _PerpsController_marketPreloadQueued = new WeakMap(), _PerpsController_isPreloadingUserData = new WeakMap(), _PerpsController_userPreloadQueued = new WeakMap(), _PerpsController_lifecycleGeneration = new WeakMap(), _PerpsController_userSnapshotRequests = new WeakMap(), _PerpsController_preloadStateUnsubscribe = new WeakMap(), _PerpsController_accountChangeUnsubscribe = new WeakMap(), _PerpsController_previousIsTestnet = new WeakMap(), _PerpsController_previousHip3ConfigVersion = new WeakMap(), _PerpsController_instances = new WeakSet(), _PerpsController_isLighterProviderEnabled = function _PerpsController_isLighterProviderEnabled() {
+_a = PerpsController, _PerpsController_initializationPromise = new WeakMap(), _PerpsController_isReinitializing = new WeakMap(), _PerpsController_reinitializationOperationPromise = new WeakMap(), _PerpsController_disconnectOperationPromise = new WeakMap(), _PerpsController_myxRegistrationPromise = new WeakMap(), _PerpsController_lighterRegistrationPromise = new WeakMap(), _PerpsController_blockedRegionListVersion = new WeakMap(), _PerpsController_hip3Enabled = new WeakMap(), _PerpsController_hip3AllowlistMarkets = new WeakMap(), _PerpsController_hip3BlocklistMarkets = new WeakMap(), _PerpsController_hip3ConfigSource = new WeakMap(), _PerpsController_priceDeviationLimit = new WeakMap(), _PerpsController_attributionContext = new WeakMap(), _PerpsController_standaloneProvider = new WeakMap(), _PerpsController_handlersRegistered = new WeakMap(), _PerpsController_standaloneProviderIsTestnet = new WeakMap(), _PerpsController_standaloneProviderHip3Version = new WeakMap(), _PerpsController_standaloneProviderOperations = new WeakMap(), _PerpsController_eligibilityCheckDeferred = new WeakMap(), _PerpsController_ausQueue = new WeakMap(), _PerpsController_userDiskWrite = new WeakMap(), _PerpsController_options = new WeakMap(), _PerpsController_tradingService = new WeakMap(), _PerpsController_marketDataService = new WeakMap(), _PerpsController_accountService = new WeakMap(), _PerpsController_eligibilityService = new WeakMap(), _PerpsController_dataLakeService = new WeakMap(), _PerpsController_depositService = new WeakMap(), _PerpsController_featureFlagConfigurationService = new WeakMap(), _PerpsController_rewardsIntegrationService = new WeakMap(), _PerpsController_publishChaseOrderMaxDistanceReached = new WeakMap(), _PerpsController_preloadTimer = new WeakMap(), _PerpsController_preloadStartRequested = new WeakMap(), _PerpsController_isPreloading = new WeakMap(), _PerpsController_marketPreloadQueued = new WeakMap(), _PerpsController_isPreloadingUserData = new WeakMap(), _PerpsController_userPreloadQueued = new WeakMap(), _PerpsController_lifecycleGeneration = new WeakMap(), _PerpsController_userSnapshotRequests = new WeakMap(), _PerpsController_preloadStateUnsubscribe = new WeakMap(), _PerpsController_accountChangeUnsubscribe = new WeakMap(), _PerpsController_previousIsTestnet = new WeakMap(), _PerpsController_previousHip3ConfigVersion = new WeakMap(), _PerpsController_instances = new WeakSet(), _PerpsController_isMYXProviderEnabled = function _PerpsController_isMYXProviderEnabled() {
+    const myx = __classPrivateFieldGet(this, _PerpsController_options, "f").clientConfig?.providerCredentials?.myx;
+    // Local env-var override (MM_PERPS_MYX_PROVIDER_ENABLED) always wins —
+    // matches the UI selector (resolvePerpsMyxProviderEnabled) so controller
+    // and UI agree on whether MYX is available.
+    if (myx?.enabled) {
+        return true;
+    }
+    // Credentials present → MYX is enabled regardless of remote flag.
+    // Use || so empty-string env vars (default '') fall through.
+    const hasCredentials = Boolean(
+    // eslint-disable-next-line @typescript-eslint/prefer-nullish-coalescing
+    myx?.appIdTestnet || myx?.appIdMainnet);
+    if (hasCredentials) {
+        return true;
+    }
+    // No local override or credentials — check remote flag as fallback
+    try {
+        const remoteState = this.messenger.call('RemoteFeatureFlagController:getState');
+        const remoteFlag = remoteState.remoteFeatureFlags?.perpsMyxProviderEnabled;
+        if (isVersionGatedFeatureFlag(remoteFlag)) {
+            const validated = __classPrivateFieldGet(this, _PerpsController_options, "f").infrastructure.featureFlags.validateVersionGated(remoteFlag);
+            return validated ?? false;
+        }
+        return false;
+    }
+    catch {
+        return false;
+    }
+}, _PerpsController_isLighterProviderEnabled = function _PerpsController_isLighterProviderEnabled() {
     const lighter = __classPrivateFieldGet(this, _PerpsController_options, "f").clientConfig?.providerCredentials?.lighter;
     if (lighter?.enabled) {
         return true;
@@ -3862,6 +3927,7 @@ _a = PerpsController, _PerpsController_initializationPromise = new WeakMap(), _P
             continue;
         }
         if (providerId === 'hyperliquid' ||
+            (providerId === 'myx' && __classPrivateFieldGet(this, _PerpsController_instances, "m", _PerpsController_isMYXProviderEnabled).call(this)) ||
             (providerId === 'lighter' && __classPrivateFieldGet(this, _PerpsController_instances, "m", _PerpsController_isLighterProviderEnabled).call(this)) ||
             this.providers.has(providerId)) {
             providerIds.add(providerId);
@@ -3984,7 +4050,6 @@ _a = PerpsController, _PerpsController_initializationPromise = new WeakMap(), _P
         priceDeviationLimit: __classPrivateFieldGet(this, _PerpsController_priceDeviationLimit, "f"),
         platformDependencies: __classPrivateFieldGet(this, _PerpsController_options, "f").infrastructure,
         messenger: this.messenger,
-        getAgentSigner: __classPrivateFieldGet(this, _PerpsController_getAgentSigner, "f"),
         builderAddressTestnet: __classPrivateFieldGet(this, _PerpsController_options, "f").clientConfig?.providerCredentials?.hyperliquid
             ?.builderAddressTestnet,
         builderAddressMainnet: __classPrivateFieldGet(this, _PerpsController_options, "f").clientConfig?.providerCredentials?.hyperliquid
@@ -4207,13 +4272,15 @@ async function _PerpsController_performInitialization() {
             this.providers.clear();
             await __classPrivateFieldGet(this, _PerpsController_instances, "m", _PerpsController_cleanupStandaloneProvider).call(this);
             __classPrivateFieldGet(this, _PerpsController_instances, "m", _PerpsController_createProviders).call(this);
-            // Await the Lighter dynamic import (if started) so Lighter is in the
-            // providers map before we assign the active provider. Runs concurrently
-            // with the WebSocket readiness delay for zero additional latency.
+            // Await MYX dynamic import (if started) so MYX is in the providers
+            // map before we assign the active provider. Runs concurrently with
+            // the WebSocket readiness delay for zero additional latency.
             await Promise.all([
                 wait(PERPS_CONSTANTS.ReconnectionCleanupDelayMs),
+                __classPrivateFieldGet(this, _PerpsController_myxRegistrationPromise, "f"),
                 __classPrivateFieldGet(this, _PerpsController_lighterRegistrationPromise, "f"),
             ]);
+            __classPrivateFieldSet(this, _PerpsController_myxRegistrationPromise, null, "f");
             __classPrivateFieldSet(this, _PerpsController_lighterRegistrationPromise, null, "f");
             __classPrivateFieldGet(this, _PerpsController_instances, "m", _PerpsController_assignActiveProvider).call(this);
             this.isInitialized = true;
@@ -4284,7 +4351,6 @@ async function _PerpsController_performInitialization() {
         priceDeviationLimit: __classPrivateFieldGet(this, _PerpsController_priceDeviationLimit, "f"),
         platformDependencies: __classPrivateFieldGet(this, _PerpsController_options, "f").infrastructure,
         messenger: this.messenger,
-        getAgentSigner: __classPrivateFieldGet(this, _PerpsController_getAgentSigner, "f"),
         builderAddressTestnet: __classPrivateFieldGet(this, _PerpsController_options, "f").clientConfig?.providerCredentials?.hyperliquid
             ?.builderAddressTestnet,
         builderAddressMainnet: __classPrivateFieldGet(this, _PerpsController_options, "f").clientConfig?.providerCredentials?.hyperliquid
@@ -4296,12 +4362,32 @@ async function _PerpsController_performInitialization() {
         onChaseOrderMaxDistanceReached: __classPrivateFieldGet(this, _PerpsController_publishChaseOrderMaxDistanceReached, "f"),
     });
     this.providers.set('hyperliquid', hyperLiquidProvider);
-    // Register Lighter provider if enabled (POC). Dynamic import so clients
-    // that do not ship the Lighter files skip registration silently, and so
-    // bundlers can code-split it out when it is not enabled.
-    // Uses .then()/.catch() instead of await because #createProviders is not
-    // async; registration completing asynchronously is fine since the provider
-    // is only used when explicitly enabled and selected.
+    // Register MYX provider if enabled via feature flag.
+    // Dynamic import because the MYX package pulls in heavy dependencies we
+    // don't want bundled in extension. Until MYX fixes their package, extension
+    // doesn't ship it — the catch branch silently skips registration.
+    // Uses .then()/.catch() instead of await because #createProviders is not async;
+    // MYX registration completing asynchronously is fine since it's only used when
+    // explicitly enabled and selected.
+    const isMYXEnabled = __classPrivateFieldGet(this, _PerpsController_instances, "m", _PerpsController_isMYXProviderEnabled).call(this);
+    if (isMYXEnabled) {
+        // IMPORTANT: Must use import() — NOT require() — for core/extension tree-shaking.
+        // require() is synchronous and bundlers include it in the main bundle.
+        // import() enables true code splitting so MYX is excluded when not enabled.
+        // NOTE: Keep the path in a variable so ts-bridge does not rewrite the
+        // import argument and strip the webpackIgnore magic comment in core dist.
+        const myxModulePath = './providers/MYXProvider';
+        __classPrivateFieldSet(this, _PerpsController_myxRegistrationPromise, import(
+        /* webpackIgnore: true */ myxModulePath)
+            .then(({ MYXProvider }) => {
+            this.registerMYXProvider(MYXProvider);
+            return undefined;
+        })
+            .catch((error) => this.handleMYXImportError(error)), "f");
+    }
+    // Register Lighter provider if enabled (POC). Same dynamic-import pattern
+    // as MYX so clients that do not ship the Lighter files skip registration
+    // silently.
     const isLighterEnabled = __classPrivateFieldGet(this, _PerpsController_instances, "m", _PerpsController_isLighterProviderEnabled).call(this);
     if (isLighterEnabled) {
         // NOTE: Keep the path in a variable so ts-bridge does not rewrite the
@@ -4333,11 +4419,7 @@ async function _PerpsController_performInitialization() {
         this.activeProviderInstance = hyperLiquidProvider;
         __classPrivateFieldGet(this, _PerpsController_instances, "m", _PerpsController_debugLog).call(this, `PerpsController: Using direct provider (${activeProvider})`);
     }
-    else {
-        // Any other direct provider, including a value persisted by an older
-        // version whose venue has since been removed. `activeProvider` is
-        // persisted, so throwing here would fail initialization on every
-        // launch — the stale value must self-heal.
+    else if (activeProvider === 'myx' || activeProvider === 'lighter') {
         const directProvider = this.providers.get(activeProvider);
         if (directProvider) {
             this.activeProviderInstance = directProvider;
@@ -4351,6 +4433,9 @@ async function _PerpsController_performInitialization() {
         }
         __classPrivateFieldGet(this, _PerpsController_instances, "m", _PerpsController_debugLog).call(this, `PerpsController: Using direct provider (${this.activeProviderInstance === hyperLiquidProvider ? 'hyperliquid' : activeProvider})`);
     }
+    else {
+        throw new Error(`Unsupported provider: ${String(activeProvider)}. Currently only 'hyperliquid', 'myx', 'lighter', and 'aggregated' are supported.`);
+    }
 }, _PerpsController_getErrorContext = function _PerpsController_getErrorContext(method, extra) {
     return {
         tags: {
@@ -5072,6 +5157,7 @@ async function _PerpsController_persistWatchlistToRemote(network) {
     const existingWatchlist = prefs.perps
         .watchlistMarkets ?? {
         hyperliquid: { testnet: [], mainnet: [] },
+        myx: { testnet: [], mainnet: [] },
     };
     const nextWatchlistMarkets = {
         ...existingWatchlist,
@@ -5139,6 +5225,7 @@ async function _PerpsController_syncWatchlistFromRemote() {
                 const existingWatchlist = prefs.perps
                     .watchlistMarkets ?? {
                     hyperliquid: { testnet: [], mainnet: [] },
+                    myx: { testnet: [], mainnet: [] },
                 };
                 const nextWatchlistMarkets = {
                     ...existingWatchlist,