@metamask-previews/perps-controller 3.1.0-preview-d6985be → 3.1.1-preview-9c8c0a0

package/dist/providers/HyperLiquidProvider.cjs

@@ -10,7 +10,7 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
     if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
     return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
 };
-var _HyperLiquidProvider_instances, _HyperLiquidProvider_deps, _HyperLiquidProvider_clientService, _HyperLiquidProvider_walletService, _HyperLiquidProvider_subscriptionService, _HyperLiquidProvider_symbolToAssetId, _HyperLiquidProvider_userFeeCache, _HyperLiquidProvider_maxLeverageCache, _HyperLiquidProvider_cachedMetaByDex, _HyperLiquidProvider_cachedMarketDataWithPrices, _HyperLiquidProvider_cachedSpotMeta, _HyperLiquidProvider_perpDexsCache, _HyperLiquidProvider_referralCheckCache, _HyperLiquidProvider_builderFeeCheckCache, _HyperLiquidProvider_ensureReadyPromise, _HyperLiquidProvider_pendingBuilderFeeApprovals, _HyperLiquidProvider_compiledAllowlistPatterns, _HyperLiquidProvider_compiledBlocklistPatterns, _HyperLiquidProvider_userFeeDiscountBips, _HyperLiquidProvider_hip3Enabled, _HyperLiquidProvider_allowlistMarkets, _HyperLiquidProvider_blocklistMarkets, _HyperLiquidProvider_useDexAbstraction, _HyperLiquidProvider_cachedValidatedDexs, _HyperLiquidProvider_cachedAllPerpDexs, _HyperLiquidProvider_dexDiscoveryComplete, _HyperLiquidProvider_pendingValidatedDexsPromise, _HyperLiquidProvider_cachedUsdcTokenId, _HyperLiquidProvider_errorMappings, _HyperLiquidProvider_clientsInitialized, _HyperLiquidProvider_initializationPromise, _HyperLiquidProvider_messenger, _HyperLiquidProvider_builderAddressTestnet, _HyperLiquidProvider_builderAddressMainnet, _HyperLiquidProvider_compilePatternsSafely, _HyperLiquidProvider_ensureClientsInitialized, _HyperLiquidProvider_ensureDexAbstractionEnabled, _HyperLiquidProvider_ensureReady, _HyperLiquidProvider_tradingSetupPromise, _HyperLiquidProvider_tradingSetupComplete, _HyperLiquidProvider_ensureReadyForTrading, _HyperLiquidProvider_getOrFetchPrice, _HyperLiquidProvider_filterFills, _HyperLiquidProvider_getAllAvailableDexs, _HyperLiquidProvider_getValidatedDexs, _HyperLiquidProvider_fetchValidatedDexsInternal, _HyperLiquidProvider_extractDexsFromAllowlist, _HyperLiquidProvider_getCachedMeta, _HyperLiquidProvider_backfillAssetMapForDex, _HyperLiquidProvider_getAssetIdWithRepair, _HyperLiquidProvider_getCachedSpotMeta, _HyperLiquidProvider_getCachedPerpDexs, _HyperLiquidProvider_calculateHip3FeeMultiplier, _HyperLiquidProvider_getCacheKey, _HyperLiquidProvider_fetchMarketsForDex, _HyperLiquidProvider_getUsdcTokenId, _HyperLiquidProvider_isUsdhCollateralDex, _HyperLiquidProvider_getSpotUsdhBalance, _HyperLiquidProvider_getSpotUsdcBalance, _HyperLiquidProvider_transferUsdcToSpot, _HyperLiquidProvider_swapUsdcToUsdh, _HyperLiquidProvider_ensureUsdhCollateralForOrder, _HyperLiquidProvider_buildAssetMapping, _HyperLiquidProvider_queryUserDataAcrossDexs, _HyperLiquidProvider_mapError, _HyperLiquidProvider_getErrorContext, _HyperLiquidProvider_checkBuilderFeeApproval, _HyperLiquidProvider_ensureBuilderFeeApproval, _HyperLiquidProvider_checkBuilderFeeStatus, _HyperLiquidProvider_getBalanceForDex, _HyperLiquidProvider_findSourceDexWithBalance, _HyperLiquidProvider_autoTransferForHip3Order, _HyperLiquidProvider_autoTransferBackAfterClose, _HyperLiquidProvider_calculateHip3RequiredMargin, _HyperLiquidProvider_handleHip3PostOrderRebalance, _HyperLiquidProvider_handleHip3OrderRollback, _HyperLiquidProvider_validateOrderBeforePlacement, _HyperLiquidProvider_getAssetInfo, _HyperLiquidProvider_prepareAssetForTrading, _HyperLiquidProvider_handleHip3PreOrder, _HyperLiquidProvider_submitOrderWithRollback, _HyperLiquidProvider_handleOrderError, _HyperLiquidProvider_getStandaloneValidatedDexs, _HyperLiquidProvider_getAllMids, _HyperLiquidProvider_fetchSingleDexFresh, _HyperLiquidProvider_mergeDexResultsInto, _HyperLiquidProvider_cacheFreshMarketDataSnapshot, _HyperLiquidProvider_getStaleMarketDataSnapshot, _HyperLiquidProvider_isFeeCacheValid, _HyperLiquidProvider_getBuilderAddress, _HyperLiquidProvider_getReferralCode, _HyperLiquidProvider_ensureReferralSet, _HyperLiquidProvider_isReferralCodeReady, _HyperLiquidProvider_checkReferralSet, _HyperLiquidProvider_setReferralCode;
+var _HyperLiquidProvider_instances, _HyperLiquidProvider_deps, _HyperLiquidProvider_clientService, _HyperLiquidProvider_walletService, _HyperLiquidProvider_subscriptionService, _HyperLiquidProvider_symbolToAssetId, _HyperLiquidProvider_userFeeCache, _HyperLiquidProvider_maxLeverageCache, _HyperLiquidProvider_cachedMetaByDex, _HyperLiquidProvider_cachedMarketDataWithPrices, _HyperLiquidProvider_cachedSpotMeta, _HyperLiquidProvider_dexDiscoveryCache, _HyperLiquidProvider_referralCheckCache, _HyperLiquidProvider_builderFeeCheckCache, _HyperLiquidProvider_ensureReadyPromise, _HyperLiquidProvider_pendingBuilderFeeApprovals, _HyperLiquidProvider_compiledAllowlistPatterns, _HyperLiquidProvider_compiledBlocklistPatterns, _HyperLiquidProvider_userFeeDiscountBips, _HyperLiquidProvider_hip3Enabled, _HyperLiquidProvider_allowlistMarkets, _HyperLiquidProvider_blocklistMarkets, _HyperLiquidProvider_useDexAbstraction, _HyperLiquidProvider_dexDiscoveryComplete, _HyperLiquidProvider_pendingValidatedDexsPromise, _HyperLiquidProvider_cachedUsdcTokenId, _HyperLiquidProvider_errorMappings, _HyperLiquidProvider_clientsInitialized, _HyperLiquidProvider_initializationPromise, _HyperLiquidProvider_messenger, _HyperLiquidProvider_builderAddressTestnet, _HyperLiquidProvider_builderAddressMainnet, _HyperLiquidProvider_compilePatternsSafely, _HyperLiquidProvider_ensureClientsInitialized, _HyperLiquidProvider_ensureDexAbstractionEnabled, _HyperLiquidProvider_ensureReady, _HyperLiquidProvider_tradingSetupPromise, _HyperLiquidProvider_tradingSetupComplete, _HyperLiquidProvider_ensureReadyForTrading, _HyperLiquidProvider_getOrFetchPrice, _HyperLiquidProvider_filterFills, _HyperLiquidProvider_getAllAvailableDexs, _HyperLiquidProvider_getValidatedDexs, _HyperLiquidProvider_fetchValidatedDexsInternal, _HyperLiquidProvider_getCachedMeta, _HyperLiquidProvider_backfillAssetMapForDex, _HyperLiquidProvider_getAssetIdWithRepair, _HyperLiquidProvider_getCachedSpotMeta, _HyperLiquidProvider_getCachedPerpDexs, _HyperLiquidProvider_calculateHip3FeeMultiplier, _HyperLiquidProvider_getCacheKey, _HyperLiquidProvider_fetchMarketsForDex, _HyperLiquidProvider_getUsdcTokenId, _HyperLiquidProvider_isUsdhCollateralDex, _HyperLiquidProvider_getSpotUsdhBalance, _HyperLiquidProvider_getSpotUsdcBalance, _HyperLiquidProvider_transferUsdcToSpot, _HyperLiquidProvider_swapUsdcToUsdh, _HyperLiquidProvider_ensureUsdhCollateralForOrder, _HyperLiquidProvider_buildAssetMapping, _HyperLiquidProvider_queryUserDataAcrossDexs, _HyperLiquidProvider_mapError, _HyperLiquidProvider_getErrorContext, _HyperLiquidProvider_checkBuilderFeeApproval, _HyperLiquidProvider_ensureBuilderFeeApproval, _HyperLiquidProvider_checkBuilderFeeStatus, _HyperLiquidProvider_getBalanceForDex, _HyperLiquidProvider_findSourceDexWithBalance, _HyperLiquidProvider_autoTransferForHip3Order, _HyperLiquidProvider_autoTransferBackAfterClose, _HyperLiquidProvider_calculateHip3RequiredMargin, _HyperLiquidProvider_handleHip3PostOrderRebalance, _HyperLiquidProvider_handleHip3OrderRollback, _HyperLiquidProvider_validateOrderBeforePlacement, _HyperLiquidProvider_getAssetInfo, _HyperLiquidProvider_prepareAssetForTrading, _HyperLiquidProvider_handleHip3PreOrder, _HyperLiquidProvider_submitOrderWithRollback, _HyperLiquidProvider_handleOrderError, _HyperLiquidProvider_getStandaloneValidatedDexs, _HyperLiquidProvider_getAllMids, _HyperLiquidProvider_fetchSingleDexFresh, _HyperLiquidProvider_mergeDexResultsInto, _HyperLiquidProvider_cacheFreshMarketDataSnapshot, _HyperLiquidProvider_getStaleMarketDataSnapshot, _HyperLiquidProvider_isFeeCacheValid, _HyperLiquidProvider_getBuilderAddress, _HyperLiquidProvider_getReferralCode, _HyperLiquidProvider_ensureReferralSet, _HyperLiquidProvider_isReferralCodeReady, _HyperLiquidProvider_checkReferralSet, _HyperLiquidProvider_setReferralCode;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.HyperLiquidProvider = void 0;
 const utils_1 = require("@metamask/utils");
@@ -19,6 +19,7 @@ const hyperLiquidConfig_1 = require("../constants/hyperLiquidConfig.cjs");
 const perpsConfig_1 = require("../constants/perpsConfig.cjs");
 const transactionsHistoryConfig_1 = require("../constants/transactionsHistoryConfig.cjs");
 const perpsErrorCodes_1 = require("../perpsErrorCodes.cjs");
+const DexDiscoveryCacheManager_1 = require("../services/DexDiscoveryCacheManager.cjs");
 const HyperLiquidClientService_1 = require("../services/HyperLiquidClientService.cjs");
 const HyperLiquidSubscriptionService_1 = require("../services/HyperLiquidSubscriptionService.cjs");
 const HyperLiquidWalletService_1 = require("../services/HyperLiquidWalletService.cjs");
@@ -75,9 +76,10 @@ class HyperLiquidProvider {
         // Session cache for spot metadata (contains USDC/USDH token info for HIP-3 collateral checks)
         // Pre-fetched in ensureReadyForTrading() to avoid API failures during order placement
         _HyperLiquidProvider_cachedSpotMeta.set(this, null);
-        // Cache for perpDexs data (deployerFeeScale for dynamic fee calculation)
-        // TTL-based cache - fee scales rarely change
-        _HyperLiquidProvider_perpDexsCache.set(this, { data: null, timestamp: 0 });
+        // Unified DEX discovery cache — single source of truth for all perpDexs() derivatives.
+        // Replaces three separate caches to eliminate desync bugs by construction.
+        // All writes go through #dexDiscoveryCache.update(); readers use .state.
+        _HyperLiquidProvider_dexDiscoveryCache.set(this, void 0);
         // Session cache for referral state (cleared on disconnect/reconnect)
         // Key: `network:userAddress`, Value: true if referral is set
         _HyperLiquidProvider_referralCheckCache.set(this, new Map());
@@ -98,9 +100,6 @@ class HyperLiquidProvider {
         _HyperLiquidProvider_allowlistMarkets.set(this, void 0);
         _HyperLiquidProvider_blocklistMarkets.set(this, void 0);
         _HyperLiquidProvider_useDexAbstraction.set(this, void 0);
-        // Cache for validated DEXs to avoid redundant perpDexs() API calls
-        _HyperLiquidProvider_cachedValidatedDexs.set(this, null);
-        _HyperLiquidProvider_cachedAllPerpDexs.set(this, null);
         // True once DEX discovery has succeeded with real data (not a fallback).
         // When false, #ensureReadyPromise is reset after each init so the next
         // caller retries DEX discovery instead of reusing a degraded mapping.
@@ -151,6 +150,11 @@ class HyperLiquidProvider {
         __classPrivateFieldSet(this, _HyperLiquidProvider_clientService, new HyperLiquidClientService_1.HyperLiquidClientService(__classPrivateFieldGet(this, _HyperLiquidProvider_deps, "f"), {
             isTestnet,
         }), "f");
+        __classPrivateFieldSet(this, _HyperLiquidProvider_dexDiscoveryCache, new DexDiscoveryCacheManager_1.DexDiscoveryCacheManager({
+            isTestnetMode: () => __classPrivateFieldGet(this, _HyperLiquidProvider_clientService, "f").isTestnetMode(),
+            debugLogger: __classPrivateFieldGet(this, _HyperLiquidProvider_deps, "f").debugLogger,
+            getAllowlistMarkets: () => __classPrivateFieldGet(this, _HyperLiquidProvider_allowlistMarkets, "f"),
+        }), "f");
         __classPrivateFieldSet(this, _HyperLiquidProvider_walletService, new HyperLiquidWalletService_1.HyperLiquidWalletService(__classPrivateFieldGet(this, _HyperLiquidProvider_deps, "f"), __classPrivateFieldGet(this, _HyperLiquidProvider_messenger, "f"), {
             isTestnet,
         }), "f");
@@ -3472,7 +3476,7 @@ class HyperLiquidProvider {
             // to prevent repeated signing requests across reconnections
             __classPrivateFieldGet(this, _HyperLiquidProvider_cachedMetaByDex, "f").clear();
             __classPrivateFieldSet(this, _HyperLiquidProvider_cachedSpotMeta, null, "f");
-            __classPrivateFieldSet(this, _HyperLiquidProvider_perpDexsCache, { data: null, timestamp: 0 }, "f");
+            __classPrivateFieldGet(this, _HyperLiquidProvider_dexDiscoveryCache, "f").reset();
             __classPrivateFieldSet(this, _HyperLiquidProvider_dexDiscoveryComplete, false, "f");
             // Await pending initialization before clearing to prevent the IIFE from
             // setting clientsInitialized = true after disconnect completes
@@ -3649,7 +3653,7 @@ class HyperLiquidProvider {
     }
 }
 exports.HyperLiquidProvider = HyperLiquidProvider;
-_HyperLiquidProvider_deps = new WeakMap(), _HyperLiquidProvider_clientService = new WeakMap(), _HyperLiquidProvider_walletService = new WeakMap(), _HyperLiquidProvider_subscriptionService = new WeakMap(), _HyperLiquidProvider_symbolToAssetId = new WeakMap(), _HyperLiquidProvider_userFeeCache = new WeakMap(), _HyperLiquidProvider_maxLeverageCache = new WeakMap(), _HyperLiquidProvider_cachedMetaByDex = new WeakMap(), _HyperLiquidProvider_cachedMarketDataWithPrices = new WeakMap(), _HyperLiquidProvider_cachedSpotMeta = new WeakMap(), _HyperLiquidProvider_perpDexsCache = new WeakMap(), _HyperLiquidProvider_referralCheckCache = new WeakMap(), _HyperLiquidProvider_builderFeeCheckCache = new WeakMap(), _HyperLiquidProvider_ensureReadyPromise = new WeakMap(), _HyperLiquidProvider_pendingBuilderFeeApprovals = new WeakMap(), _HyperLiquidProvider_compiledAllowlistPatterns = new WeakMap(), _HyperLiquidProvider_compiledBlocklistPatterns = new WeakMap(), _HyperLiquidProvider_userFeeDiscountBips = new WeakMap(), _HyperLiquidProvider_hip3Enabled = new WeakMap(), _HyperLiquidProvider_allowlistMarkets = new WeakMap(), _HyperLiquidProvider_blocklistMarkets = new WeakMap(), _HyperLiquidProvider_useDexAbstraction = new WeakMap(), _HyperLiquidProvider_cachedValidatedDexs = new WeakMap(), _HyperLiquidProvider_cachedAllPerpDexs = new WeakMap(), _HyperLiquidProvider_dexDiscoveryComplete = new WeakMap(), _HyperLiquidProvider_pendingValidatedDexsPromise = new WeakMap(), _HyperLiquidProvider_cachedUsdcTokenId = new WeakMap(), _HyperLiquidProvider_errorMappings = new WeakMap(), _HyperLiquidProvider_clientsInitialized = new WeakMap(), _HyperLiquidProvider_initializationPromise = new WeakMap(), _HyperLiquidProvider_messenger = new WeakMap(), _HyperLiquidProvider_builderAddressTestnet = new WeakMap(), _HyperLiquidProvider_builderAddressMainnet = new WeakMap(), _HyperLiquidProvider_tradingSetupPromise = new WeakMap(), _HyperLiquidProvider_tradingSetupComplete = new WeakMap(), _HyperLiquidProvider_instances = new WeakSet(), _HyperLiquidProvider_compilePatternsSafely = function _HyperLiquidProvider_compilePatternsSafely(patterns, listName) {
+_HyperLiquidProvider_deps = new WeakMap(), _HyperLiquidProvider_clientService = new WeakMap(), _HyperLiquidProvider_walletService = new WeakMap(), _HyperLiquidProvider_subscriptionService = new WeakMap(), _HyperLiquidProvider_symbolToAssetId = new WeakMap(), _HyperLiquidProvider_userFeeCache = new WeakMap(), _HyperLiquidProvider_maxLeverageCache = new WeakMap(), _HyperLiquidProvider_cachedMetaByDex = new WeakMap(), _HyperLiquidProvider_cachedMarketDataWithPrices = new WeakMap(), _HyperLiquidProvider_cachedSpotMeta = new WeakMap(), _HyperLiquidProvider_dexDiscoveryCache = new WeakMap(), _HyperLiquidProvider_referralCheckCache = new WeakMap(), _HyperLiquidProvider_builderFeeCheckCache = new WeakMap(), _HyperLiquidProvider_ensureReadyPromise = new WeakMap(), _HyperLiquidProvider_pendingBuilderFeeApprovals = new WeakMap(), _HyperLiquidProvider_compiledAllowlistPatterns = new WeakMap(), _HyperLiquidProvider_compiledBlocklistPatterns = new WeakMap(), _HyperLiquidProvider_userFeeDiscountBips = new WeakMap(), _HyperLiquidProvider_hip3Enabled = new WeakMap(), _HyperLiquidProvider_allowlistMarkets = new WeakMap(), _HyperLiquidProvider_blocklistMarkets = new WeakMap(), _HyperLiquidProvider_useDexAbstraction = new WeakMap(), _HyperLiquidProvider_dexDiscoveryComplete = new WeakMap(), _HyperLiquidProvider_pendingValidatedDexsPromise = new WeakMap(), _HyperLiquidProvider_cachedUsdcTokenId = new WeakMap(), _HyperLiquidProvider_errorMappings = new WeakMap(), _HyperLiquidProvider_clientsInitialized = new WeakMap(), _HyperLiquidProvider_initializationPromise = new WeakMap(), _HyperLiquidProvider_messenger = new WeakMap(), _HyperLiquidProvider_builderAddressTestnet = new WeakMap(), _HyperLiquidProvider_builderAddressMainnet = new WeakMap(), _HyperLiquidProvider_tradingSetupPromise = new WeakMap(), _HyperLiquidProvider_tradingSetupComplete = new WeakMap(), _HyperLiquidProvider_instances = new WeakSet(), _HyperLiquidProvider_compilePatternsSafely = function _HyperLiquidProvider_compilePatternsSafely(patterns, listName) {
     const compiled = [];
     for (const pattern of patterns) {
         try {
@@ -3981,27 +3985,26 @@ async function _HyperLiquidProvider_getOrFetchPrice(params) {
  * @returns Array of all DEX names (null for main DEX, strings for HIP-3 DEXs)
  */
 async function _HyperLiquidProvider_getAllAvailableDexs() {
-    // If already cached by getValidatedDexs, use that
-    if (__classPrivateFieldGet(this, _HyperLiquidProvider_cachedAllPerpDexs, "f") !== null &&
-        Array.isArray(__classPrivateFieldGet(this, _HyperLiquidProvider_cachedAllPerpDexs, "f"))) {
+    // Use unified state if available
+    if (__classPrivateFieldGet(this, _HyperLiquidProvider_dexDiscoveryCache, "f").state) {
         const availableHip3Dexs = [];
-        __classPrivateFieldGet(this, _HyperLiquidProvider_cachedAllPerpDexs, "f").forEach((dex) => {
+        __classPrivateFieldGet(this, _HyperLiquidProvider_dexDiscoveryCache, "f").state.raw.forEach((dex) => {
             if (dex !== null) {
                 availableHip3Dexs.push(dex.name);
             }
         });
         return [null, ...availableHip3Dexs];
     }
-    // Fetch fresh from API
+    // Fetch fresh from API and update unified state
     const infoClient = __classPrivateFieldGet(this, _HyperLiquidProvider_clientService, "f").getInfoClient();
     try {
         const allDexs = await infoClient.perpDexs();
         if (!allDexs || !Array.isArray(allDexs)) {
             return [null]; // Fallback to main DEX only
         }
-        __classPrivateFieldSet(this, _HyperLiquidProvider_cachedAllPerpDexs, allDexs, "f");
+        const state = __classPrivateFieldGet(this, _HyperLiquidProvider_dexDiscoveryCache, "f").update(allDexs);
         const availableHip3Dexs = [];
-        allDexs.forEach((dex) => {
+        state.raw.forEach((dex) => {
             if (dex !== null) {
                 availableHip3Dexs.push(dex.name);
             }
@@ -4028,9 +4031,15 @@ async function _HyperLiquidProvider_getAllAvailableDexs() {
  * @returns Array of DEX names to use (null = main DEX, strings = HIP-3 DEXs)
  */
 async function _HyperLiquidProvider_getValidatedDexs() {
+    // Kill switch: HIP-3 disabled, return main DEX only
+    // Must check before cache — #getAllAvailableDexs() can populate
+    // state.validated without the hip3Enabled gate
+    if (!__classPrivateFieldGet(this, _HyperLiquidProvider_hip3Enabled, "f")) {
+        return [null];
+    }
     // Return cached result if available
-    if (__classPrivateFieldGet(this, _HyperLiquidProvider_cachedValidatedDexs, "f") !== null) {
-        return __classPrivateFieldGet(this, _HyperLiquidProvider_cachedValidatedDexs, "f");
+    if (__classPrivateFieldGet(this, _HyperLiquidProvider_dexDiscoveryCache, "f").state?.validated) {
+        return __classPrivateFieldGet(this, _HyperLiquidProvider_dexDiscoveryCache, "f").state.validated;
     }
     // If a fetch is already in progress, reuse the pending promise
     // This prevents duplicate perpDexs() API calls from concurrent callers
@@ -4059,9 +4068,8 @@ async function _HyperLiquidProvider_fetchValidatedDexsInternal() {
     // Kill switch: HIP-3 disabled, return main DEX only
     if (!__classPrivateFieldGet(this, _HyperLiquidProvider_hip3Enabled, "f")) {
         __classPrivateFieldGet(this, _HyperLiquidProvider_deps, "f").debugLogger.log('HyperLiquidProvider: HIP-3 disabled via hip3Enabled flag');
-        __classPrivateFieldSet(this, _HyperLiquidProvider_cachedAllPerpDexs, [null], "f");
-        __classPrivateFieldSet(this, _HyperLiquidProvider_cachedValidatedDexs, [null], "f");
-        return __classPrivateFieldGet(this, _HyperLiquidProvider_cachedValidatedDexs, "f");
+        const state = __classPrivateFieldGet(this, _HyperLiquidProvider_dexDiscoveryCache, "f").update([null]);
+        return state.validated;
     }
     // Fetch all available DEXs from HyperLiquid
     const infoClient = __classPrivateFieldGet(this, _HyperLiquidProvider_clientService, "f").getInfoClient();
@@ -4085,110 +4093,13 @@ async function _HyperLiquidProvider_fetchValidatedDexsInternal() {
         // Do not cache — may be transient, allow retry on next call
         return [null];
     }
-    // Cache for buildAssetMapping() to avoid duplicate call
-    __classPrivateFieldSet(this, _HyperLiquidProvider_cachedAllPerpDexs, allDexs, "f");
-    // Extract HIP-3 DEX names (filter out null which represents main DEX)
-    const availableHip3Dexs = [];
-    allDexs.forEach((dex) => {
-        if (dex !== null) {
-            availableHip3Dexs.push(dex.name);
-        }
-    });
+    // Atomically update unified state (raw + validated + timestamp)
+    const state = __classPrivateFieldGet(this, _HyperLiquidProvider_dexDiscoveryCache, "f").update(allDexs);
     __classPrivateFieldGet(this, _HyperLiquidProvider_deps, "f").debugLogger.log('HyperLiquidProvider: Available DEXs (market filtering applied at data layer)', {
-        count: availableHip3Dexs.length,
-        dexNames: availableHip3Dexs,
+        count: state.validated.filter((dex) => dex !== null).length,
+        dexNames: state.validated.filter((dex) => dex !== null),
     });
-    // Testnet-specific filtering: Limit DEXs to avoid subscription overload
-    // On testnet, there are many HIP-3 DEXs (test deployments) that cause instability
-    if (__classPrivateFieldGet(this, _HyperLiquidProvider_clientService, "f").isTestnetMode()) {
-        const { EnabledDexs, AutoDiscoverAll } = hyperLiquidConfig_1.TESTNET_HIP3_CONFIG;
-        if (!AutoDiscoverAll) {
-            if (EnabledDexs.length === 0) {
-                // Main DEX only - no HIP-3 DEXs on testnet
-                __classPrivateFieldGet(this, _HyperLiquidProvider_deps, "f").debugLogger.log('HyperLiquidProvider: Testnet - using main DEX only (HIP-3 DEXs filtered)', {
-                    availableHip3Dexs: availableHip3Dexs.length,
-                    reason: 'TESTNET_HIP3_CONFIG.EnabledDexs is empty',
-                });
-                __classPrivateFieldSet(this, _HyperLiquidProvider_cachedValidatedDexs, [null], "f");
-                return __classPrivateFieldGet(this, _HyperLiquidProvider_cachedValidatedDexs, "f");
-            }
-            // Filter to specific allowed DEXs on testnet
-            const filteredDexs = availableHip3Dexs.filter((dex) => EnabledDexs.includes(dex));
-            __classPrivateFieldGet(this, _HyperLiquidProvider_deps, "f").debugLogger.log('HyperLiquidProvider: Testnet - filtered to allowed DEXs', {
-                allowedDexs: EnabledDexs,
-                filteredDexs,
-                availableHip3Dexs: availableHip3Dexs.length,
-            });
-            __classPrivateFieldSet(this, _HyperLiquidProvider_cachedValidatedDexs, [null, ...filteredDexs], "f");
-            return __classPrivateFieldGet(this, _HyperLiquidProvider_cachedValidatedDexs, "f");
-        }
-        // AUTO_DISCOVER_ALL is true - proceed with all DEXs (not recommended for testnet)
-        __classPrivateFieldGet(this, _HyperLiquidProvider_deps, "f").debugLogger.log('HyperLiquidProvider: Testnet - AUTO_DISCOVER_ALL enabled, using all DEXs', { totalDexCount: availableHip3Dexs.length + 1 });
-    }
-    else {
-        // Mainnet-specific filtering: Extract allowed DEXs from the allowlist patterns
-        // This reduces WebSocket subscription overhead dynamically based on feature flags
-        const { AutoDiscoverAll } = hyperLiquidConfig_1.MAINNET_HIP3_CONFIG;
-        if (!AutoDiscoverAll) {
-            // Extract unique DEX names from allowlist patterns
-            // Patterns like "xyz:*", "xyz:TSLA", or "xyz" all indicate DEX "xyz"
-            const allowedDexsFromAllowlist = __classPrivateFieldGet(this, _HyperLiquidProvider_instances, "m", _HyperLiquidProvider_extractDexsFromAllowlist).call(this);
-            if (allowedDexsFromAllowlist.length === 0) {
-                // No HIP-3 DEXs in allowlist - main DEX only
-                __classPrivateFieldGet(this, _HyperLiquidProvider_deps, "f").debugLogger.log('HyperLiquidProvider: Mainnet - using main DEX only (no HIP-3 DEXs in allowlist)', {
-                    availableHip3Dexs: availableHip3Dexs.length,
-                    allowlistMarkets: __classPrivateFieldGet(this, _HyperLiquidProvider_allowlistMarkets, "f"),
-                });
-                __classPrivateFieldSet(this, _HyperLiquidProvider_cachedValidatedDexs, [null], "f");
-                return __classPrivateFieldGet(this, _HyperLiquidProvider_cachedValidatedDexs, "f");
-            }
-            // Filter to DEXs that are both available AND in the allowlist
-            const filteredDexs = availableHip3Dexs.filter((dex) => allowedDexsFromAllowlist.includes(dex));
-            __classPrivateFieldGet(this, _HyperLiquidProvider_deps, "f").debugLogger.log('HyperLiquidProvider: Mainnet - filtered to allowlist DEXs', {
-                allowedDexsFromAllowlist,
-                filteredDexs,
-                availableHip3Dexs: availableHip3Dexs.length,
-            });
-            __classPrivateFieldSet(this, _HyperLiquidProvider_cachedValidatedDexs, [null, ...filteredDexs], "f");
-            return __classPrivateFieldGet(this, _HyperLiquidProvider_cachedValidatedDexs, "f");
-        }
-        // AUTO_DISCOVER_ALL is true - proceed with all DEXs
-        __classPrivateFieldGet(this, _HyperLiquidProvider_deps, "f").debugLogger.log('HyperLiquidProvider: Mainnet - AUTO_DISCOVER_ALL enabled, using all DEXs', { totalDexCount: availableHip3Dexs.length + 1 });
-    }
-    // Fallback: Return all DEXs (when AUTO_DISCOVER_ALL is true)
-    // Market filtering is applied at subscription data layer
-    __classPrivateFieldGet(this, _HyperLiquidProvider_deps, "f").debugLogger.log('HyperLiquidProvider: All DEXs enabled (market filtering at data layer)', {
-        mainDex: true,
-        hip3Dexs: availableHip3Dexs,
-        totalDexCount: availableHip3Dexs.length + 1,
-    });
-    __classPrivateFieldSet(this, _HyperLiquidProvider_cachedValidatedDexs, [null, ...availableHip3Dexs], "f");
-    return __classPrivateFieldGet(this, _HyperLiquidProvider_cachedValidatedDexs, "f");
-}, _HyperLiquidProvider_extractDexsFromAllowlist = function _HyperLiquidProvider_extractDexsFromAllowlist() {
-    if (__classPrivateFieldGet(this, _HyperLiquidProvider_allowlistMarkets, "f").length === 0) {
-        return [];
-    }
-    const dexNames = new Set();
-    for (const pattern of __classPrivateFieldGet(this, _HyperLiquidProvider_allowlistMarkets, "f")) {
-        // Pattern formats:
-        // - "xyz:*" -> DEX "xyz" (wildcard)
-        // - "xyz:TSLA" -> DEX "xyz" (exact match)
-        // - "xyz" -> DEX "xyz" (shorthand)
-        const colonIndex = pattern.indexOf(':');
-        if (colonIndex > 0) {
-            // Has colon - extract DEX prefix
-            const dex = pattern.substring(0, colonIndex);
-            dexNames.add(dex);
-        }
-        else if (pattern.length > 0 && !pattern.includes('*')) {
-            // No colon and not a wildcard - could be DEX shorthand
-            // Only add if it looks like a valid DEX name (lowercase alphanumeric)
-            if (/^[a-z][a-z0-9]*$/iu.test(pattern)) {
-                dexNames.add(pattern.toLowerCase());
-            }
-        }
-    }
-    return Array.from(dexNames);
+    return state.validated;
 }, _HyperLiquidProvider_getCachedMeta = 
 /**
  * Get cached meta response for a DEX, fetching from API if not cached
@@ -4247,7 +4158,7 @@ async function _HyperLiquidProvider_backfillAssetMapForDex(dex, meta) {
     if (!meta?.universe || !Array.isArray(meta.universe)) {
         return false;
     }
-    if (!__classPrivateFieldGet(this, _HyperLiquidProvider_cachedAllPerpDexs, "f")) {
+    if (!__classPrivateFieldGet(this, _HyperLiquidProvider_dexDiscoveryCache, "f").state) {
         try {
             await __classPrivateFieldGet(this, _HyperLiquidProvider_instances, "m", _HyperLiquidProvider_getValidatedDexs).call(this);
         }
@@ -4258,7 +4169,7 @@ async function _HyperLiquidProvider_backfillAssetMapForDex(dex, meta) {
             });
         }
     }
-    const allPerpDexs = __classPrivateFieldGet(this, _HyperLiquidProvider_cachedAllPerpDexs, "f") ?? [null];
+    const allPerpDexs = __classPrivateFieldGet(this, _HyperLiquidProvider_dexDiscoveryCache, "f").state?.raw ?? [null];
     const perpDexIndex = allPerpDexs.findIndex((entry) => {
         if (dex === null) {
             return entry === null;
@@ -4350,22 +4261,24 @@ async function _HyperLiquidProvider_getCachedSpotMeta() {
  */
 async function _HyperLiquidProvider_getCachedPerpDexs() {
     const now = Date.now();
-    // Return cached data if still valid
-    if (__classPrivateFieldGet(this, _HyperLiquidProvider_perpDexsCache, "f").data &&
-        now - __classPrivateFieldGet(this, _HyperLiquidProvider_perpDexsCache, "f").timestamp < hyperLiquidConfig_1.HIP3_FEE_CONFIG.PerpDexsCacheTtlMs) {
+    // Return cached data if still valid (uses unified state timestamp for TTL)
+    if (__classPrivateFieldGet(this, _HyperLiquidProvider_dexDiscoveryCache, "f").state &&
+        now - __classPrivateFieldGet(this, _HyperLiquidProvider_dexDiscoveryCache, "f").state.timestamp <
+            hyperLiquidConfig_1.HIP3_FEE_CONFIG.PerpDexsCacheTtlMs) {
+        const raw = __classPrivateFieldGet(this, _HyperLiquidProvider_dexDiscoveryCache, "f").state.raw;
         __classPrivateFieldGet(this, _HyperLiquidProvider_deps, "f").debugLogger.log('[getCachedPerpDexs] Using cached perpDexs data', {
-            age: `${Math.round((now - __classPrivateFieldGet(this, _HyperLiquidProvider_perpDexsCache, "f").timestamp) / 1000)}s`,
-            count: __classPrivateFieldGet(this, _HyperLiquidProvider_perpDexsCache, "f").data.length,
+            age: `${Math.round((now - __classPrivateFieldGet(this, _HyperLiquidProvider_dexDiscoveryCache, "f").state.timestamp) / 1000)}s`,
+            count: raw.length,
         });
-        return __classPrivateFieldGet(this, _HyperLiquidProvider_perpDexsCache, "f").data;
+        return raw;
     }
     // Fetch fresh data from API
     // Note: SDK types are incomplete, but API returns deployerFeeScale
     await __classPrivateFieldGet(this, _HyperLiquidProvider_instances, "m", _HyperLiquidProvider_ensureClientsInitialized).call(this);
     const infoClient = __classPrivateFieldGet(this, _HyperLiquidProvider_clientService, "f").getInfoClient();
     const perpDexs = (await infoClient.perpDexs());
-    // Cache the result
-    __classPrivateFieldSet(this, _HyperLiquidProvider_perpDexsCache, { data: perpDexs, timestamp: now }, "f");
+    // Atomically update unified state (raw + validated + timestamp)
+    __classPrivateFieldGet(this, _HyperLiquidProvider_dexDiscoveryCache, "f").update(perpDexs);
     __classPrivateFieldGet(this, _HyperLiquidProvider_deps, "f").debugLogger.log('[getCachedPerpDexs] Fetched and cached perpDexs data', {
         count: perpDexs.length,
         dexes: perpDexs
@@ -4796,15 +4709,15 @@ async function _HyperLiquidProvider_buildAssetMapping() {
         // If getValidatedDexs fails, fall back to main DEX only to keep the provider
         // functional. Without this, a transient perpDexs() failure would permanently
         // brick #ensureReady via the cached rejected promise.
-        // Do not set #cachedAllPerpDexs or #cachedValidatedDexs here — leave them null
+        // Do not update #dexDiscoveryCache here — leave state null
         // so #getValidatedDexs retries on the next call (same as #fetchValidatedDexsInternal).
         __classPrivateFieldGet(this, _HyperLiquidProvider_deps, "f").debugLogger.log('[buildAssetMapping] getValidatedDexs failed, falling back to main DEX', { error: String(dexError) });
         dexsToMap = [null];
     }
-    // Local fallback only — never write [null] into #cachedAllPerpDexs here.
-    // That cache is owned exclusively by #fetchValidatedDexsInternal; writing a
+    // Local fallback only — never write [null] into #dexDiscoveryCache here.
+    // That state is owned exclusively by #dexDiscoveryCache.update(); writing a
     // fallback here would prevent subsequent callers from retrying perpDexs().
-    const allPerpDexs = __classPrivateFieldGet(this, _HyperLiquidProvider_cachedAllPerpDexs, "f") ?? [null];
+    const allPerpDexs = __classPrivateFieldGet(this, _HyperLiquidProvider_dexDiscoveryCache, "f").state?.raw ?? [null];
     __classPrivateFieldGet(this, _HyperLiquidProvider_deps, "f").debugLogger.log('HyperLiquidProvider: Starting asset mapping rebuild', {
         dexs: dexsToMap,
         previousMapSize: __classPrivateFieldGet(this, _HyperLiquidProvider_symbolToAssetId, "f").size,
@@ -4857,7 +4770,7 @@ async function _HyperLiquidProvider_buildAssetMapping() {
     }));
     // Build mapping with DEX prefixes for HIP-3 DEXs using the utility function
     __classPrivateFieldGet(this, _HyperLiquidProvider_symbolToAssetId, "f").clear();
-    let dexDiscoveryComplete = __classPrivateFieldGet(this, _HyperLiquidProvider_cachedValidatedDexs, "f") !== null;
+    let dexDiscoveryComplete = __classPrivateFieldGet(this, _HyperLiquidProvider_dexDiscoveryCache, "f").state !== null;
     allMetas.forEach((result) => {
         if (result.status === 'fulfilled' &&
             result.value.success &&
@@ -5148,8 +5061,7 @@ async function _HyperLiquidProvider_findSourceDexWithBalance(params) {
     }
     // Try other HIP-3 DEXs
     // Get all available DEXs from cache (includes all HIP-3 DEXs since we no longer filter)
-    const availableDexs = __classPrivateFieldGet(this, _HyperLiquidProvider_cachedValidatedDexs, "f")?.filter((dex) => dex !== null) ??
-        [];
+    const availableDexs = __classPrivateFieldGet(this, _HyperLiquidProvider_dexDiscoveryCache, "f").state?.validated?.filter((dex) => dex !== null) ?? [];
     for (const dex of availableDexs) {
         if (dex === targetDex) {
             continue;
@@ -5733,14 +5645,14 @@ async function _HyperLiquidProvider_submitOrderWithRollback(params) {
  * @returns A promise that resolves to the result.
  */
 async function _HyperLiquidProvider_getStandaloneValidatedDexs() {
-    // Return cached result if available
-    if (__classPrivateFieldGet(this, _HyperLiquidProvider_cachedValidatedDexs, "f") !== null) {
-        return __classPrivateFieldGet(this, _HyperLiquidProvider_cachedValidatedDexs, "f");
+    // Return cached result if available (unified state)
+    if (__classPrivateFieldGet(this, _HyperLiquidProvider_dexDiscoveryCache, "f").state?.validated) {
+        return __classPrivateFieldGet(this, _HyperLiquidProvider_dexDiscoveryCache, "f").state.validated;
     }
     // Kill switch: HIP-3 disabled, return main DEX only
     if (!__classPrivateFieldGet(this, _HyperLiquidProvider_hip3Enabled, "f")) {
-        __classPrivateFieldSet(this, _HyperLiquidProvider_cachedValidatedDexs, [null], "f");
-        return __classPrivateFieldGet(this, _HyperLiquidProvider_cachedValidatedDexs, "f");
+        const state = __classPrivateFieldGet(this, _HyperLiquidProvider_dexDiscoveryCache, "f").update([null]);
+        return state.validated;
     }
     // Fetch available DEXs via standalone client
     const standaloneInfoClient = (0, standaloneInfoClient_1.createStandaloneInfoClient)({
@@ -5752,33 +5664,18 @@ async function _HyperLiquidProvider_getStandaloneValidatedDexs() {
     }
     catch {
         __classPrivateFieldGet(this, _HyperLiquidProvider_deps, "f").debugLogger.log('HyperLiquidProvider: standalone perpDexs() failed, falling back to main DEX only');
+        // Do not cache — transient error, allow retry on next call
         return [null];
     }
     // Validate response
     if (!allDexs || !Array.isArray(allDexs)) {
+        // Do not cache — may be transient, allow retry on next call
         return [null];
     }
-    // Populate #cachedAllPerpDexs so buildAssetMapping can compute perpDexIndex.
-    // Without this, getValidatedDexs returns from #cachedValidatedDexs (string names)
-    // but #cachedAllPerpDexs (raw objects for index computation) stays null,
-    // causing "Could not find perpDexIndex for DEX xyz" failures.
-    __classPrivateFieldSet(this, _HyperLiquidProvider_cachedAllPerpDexs, allDexs, "f");
-    // Extract HIP-3 DEX names (filter out null which represents main DEX)
-    const availableHip3Dexs = [];
-    allDexs.forEach((dex) => {
-        if (dex !== null) {
-            availableHip3Dexs.push(dex.name);
-        }
-    });
-    // Filter by allowlist patterns (same logic as fetchValidatedDexsInternal)
-    const allowedDexsFromAllowlist = __classPrivateFieldGet(this, _HyperLiquidProvider_instances, "m", _HyperLiquidProvider_extractDexsFromAllowlist).call(this);
-    if (allowedDexsFromAllowlist.length === 0) {
-        __classPrivateFieldSet(this, _HyperLiquidProvider_cachedValidatedDexs, [null], "f");
-        return __classPrivateFieldGet(this, _HyperLiquidProvider_cachedValidatedDexs, "f");
-    }
-    const filteredDexs = availableHip3Dexs.filter((dex) => allowedDexsFromAllowlist.includes(dex));
-    __classPrivateFieldSet(this, _HyperLiquidProvider_cachedValidatedDexs, [null, ...filteredDexs], "f");
-    return __classPrivateFieldGet(this, _HyperLiquidProvider_cachedValidatedDexs, "f");
+    // Atomically update unified state (raw + validated + timestamp).
+    // buildAssetMapping uses state.raw for perpDexIndex computation.
+    const state = __classPrivateFieldGet(this, _HyperLiquidProvider_dexDiscoveryCache, "f").update(allDexs);
+    return state.validated;
 }, _HyperLiquidProvider_getAllMids = 
 /**
  * Get allMids for a DEX — uses WS snapshot as primary source, REST as fallback.