@metamask-previews/perps-controller 9.3.0-preview-02ebbf830 → 9.3.0-preview-acc8294b8

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_dexDiscoveryCache, _HyperLiquidProvider_referralCheckCache, _HyperLiquidProvider_builderFeeCheckCache, _HyperLiquidProvider_ensureReadyPromise, _HyperLiquidProvider_pendingBuilderFeeApprovals, _HyperLiquidProvider_compiledAllowlistPatterns, _HyperLiquidProvider_compiledBlocklistPatterns, _HyperLiquidProvider_userFeeDiscountBips, _HyperLiquidProvider_hip3Enabled, _HyperLiquidProvider_allowlistMarkets, _HyperLiquidProvider_blocklistMarkets, _HyperLiquidProvider_useUnifiedAccount, _HyperLiquidProvider_dexDiscoveryComplete, _HyperLiquidProvider_unifiedAccountSetupNeedsRetry, _HyperLiquidProvider_pendingValidatedDexsPromise, _HyperLiquidProvider_cachedUsdcTokenId, _HyperLiquidProvider_errorMappings, _HyperLiquidProvider_clientsInitialized, _HyperLiquidProvider_initializationPromise, _HyperLiquidProvider_messenger, _HyperLiquidProvider_builderAddressTestnet, _HyperLiquidProvider_builderAddressMainnet, _HyperLiquidProvider_priceDeviationLimit, _HyperLiquidProvider_compilePatternsSafely, _HyperLiquidProvider_ensureClientsInitialized, _HyperLiquidProvider_isWalletOnHyperliquid, _HyperLiquidProvider_ensureUnifiedAccountEnabled, _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;
+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_useUnifiedAccount, _HyperLiquidProvider_dexDiscoveryComplete, _HyperLiquidProvider_unifiedAccountSetupNeedsRetry, _HyperLiquidProvider_pendingValidatedDexsPromise, _HyperLiquidProvider_cachedUsdcTokenId, _HyperLiquidProvider_errorMappings, _HyperLiquidProvider_clientsInitialized, _HyperLiquidProvider_initializationPromise, _HyperLiquidProvider_messenger, _HyperLiquidProvider_builderAddressTestnet, _HyperLiquidProvider_builderAddressMainnet, _HyperLiquidProvider_priceDeviationLimit, _HyperLiquidProvider_compilePatternsSafely, _HyperLiquidProvider_ensureClientsInitialized, _HyperLiquidProvider_isWalletOnHyperliquid, _HyperLiquidProvider_ensureUnifiedAccountEnabled, _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_isUsdcCollateralDex, _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_excludeNonUsdcCollateralResults, _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");
@@ -77,7 +77,7 @@ class HyperLiquidProvider {
         _HyperLiquidProvider_cachedMetaByDex.set(this, new Map());
         // Last known-good market list for stale fallback when every enabled DEX fails in one fetch window.
         _HyperLiquidProvider_cachedMarketDataWithPrices.set(this, null);
-        // Session cache for spot metadata (contains USDC/USDH token info for HIP-3 collateral checks)
+        // Session cache for spot metadata (contains token info for HIP-3 collateral checks)
         // Pre-fetched in ensureReadyForTrading() to avoid API failures during order placement
         _HyperLiquidProvider_cachedSpotMeta.set(this, null);
         // Unified DEX discovery cache — single source of truth for all perpDexs() derivatives.
@@ -2355,12 +2355,17 @@ class HyperLiquidProvider {
                 errorMessage,
             };
         }));
+        // TAT-3304: Exclude non-USDC-collateral HIP-3 DEXs before merging, so
+        // getMarketDataWithPrices (and the stale snapshot #cacheFreshMarketDataSnapshot
+        // derives from it) enforces the same USDC-only policy as market discovery
+        // and order placement.
+        const usdcFilteredDexDataResults = await __classPrivateFieldGet(this, _HyperLiquidProvider_instances, "m", _HyperLiquidProvider_excludeNonUsdcCollateralResults).call(this, dexDataResults);
         // Combine universe, assetCtxs, and allMids from all DEXs
         const combinedUniverse = [];
         const combinedAssetCtxs = [];
         const combinedAllMids = {};
-        let latestDexResults = dexDataResults;
-        __classPrivateFieldGet(this, _HyperLiquidProvider_instances, "m", _HyperLiquidProvider_mergeDexResultsInto).call(this, dexDataResults, combinedUniverse, combinedAssetCtxs, combinedAllMids);
+        let latestDexResults = usdcFilteredDexDataResults;
+        __classPrivateFieldGet(this, _HyperLiquidProvider_instances, "m", _HyperLiquidProvider_mergeDexResultsInto).call(this, usdcFilteredDexDataResults, combinedUniverse, combinedAssetCtxs, combinedAllMids);
         if (combinedUniverse.length === 0) {
             combinedUniverse.length = 0;
             combinedAssetCtxs.length = 0;
@@ -2371,8 +2376,9 @@ class HyperLiquidProvider {
             __classPrivateFieldGet(this, _HyperLiquidProvider_deps, "f").debugLogger.log(`[getMarketDataWithPrices] All DEXs returned empty, retrying in ${retryDelayMs}ms`);
             await new Promise((resolve) => setTimeout(resolve, retryDelayMs));
             const retryResults = await Promise.all(enabledDexs.map((dex) => __classPrivateFieldGet(this, _HyperLiquidProvider_instances, "m", _HyperLiquidProvider_fetchSingleDexFresh).call(this, infoClient, dex)));
-            __classPrivateFieldGet(this, _HyperLiquidProvider_instances, "m", _HyperLiquidProvider_mergeDexResultsInto).call(this, retryResults, combinedUniverse, combinedAssetCtxs, combinedAllMids);
-            latestDexResults = retryResults;
+            const usdcFilteredRetryResults = await __classPrivateFieldGet(this, _HyperLiquidProvider_instances, "m", _HyperLiquidProvider_excludeNonUsdcCollateralResults).call(this, retryResults);
+            __classPrivateFieldGet(this, _HyperLiquidProvider_instances, "m", _HyperLiquidProvider_mergeDexResultsInto).call(this, usdcFilteredRetryResults, combinedUniverse, combinedAssetCtxs, combinedAllMids);
+            latestDexResults = usdcFilteredRetryResults;
             if (combinedUniverse.length === 0) {
                 const failedDexs = retryResults
                     .filter((result) => !result.success)
@@ -4237,7 +4243,7 @@ async function _HyperLiquidProvider_ensureReady() {
     __classPrivateFieldGet(this, _HyperLiquidProvider_deps, "f").debugLogger.log('[ensureReadyForTrading] Starting trading setup (may require signatures)');
     __classPrivateFieldSet(this, _HyperLiquidProvider_tradingSetupPromise, (async () => {
         // Pre-fetch spotMeta for HIP-3 operations (non-blocking if it fails)
-        // This ensures token info (USDC/USDH indices) is available during order placement
+        // This ensures token info (e.g. USDC token index) is available during order placement
         if (__classPrivateFieldGet(this, _HyperLiquidProvider_hip3Enabled, "f")) {
             try {
                 await __classPrivateFieldGet(this, _HyperLiquidProvider_instances, "m", _HyperLiquidProvider_getCachedSpotMeta).call(this);
@@ -4577,7 +4583,7 @@ async function _HyperLiquidProvider_getAssetIdWithRepair(params) {
 }, _HyperLiquidProvider_getCachedSpotMeta = 
 /**
  * Fetch spot metadata with session-based caching
- * Contains token info (USDC, USDH indices) needed for HIP-3 collateral checks
+ * Contains token info (e.g. USDC token index) needed for HIP-3 collateral checks
  * Pre-fetched in ensureReadyForTrading() to ensure availability during order placement
  *
  * @returns SpotMetaResponse with tokens and universe data
@@ -4714,6 +4720,14 @@ async function _HyperLiquidProvider_fetchMarketsForDex(params) {
         __classPrivateFieldGet(this, _HyperLiquidProvider_deps, "f").debugLogger.log(`HyperLiquidProvider: Invalid universe data for DEX ${dex ?? 'main'}`);
         return [];
     }
+    // TAT-3304: Following the USDH sunset, only USDC-collateral HIP-3 DEXs
+    // are supported for trading. Gate non-USDC-collateral DEXs out of market
+    // discovery entirely (regardless of skipFilters) so their markets can
+    // never be surfaced to trade, even via an allowlist entry naming the DEX.
+    if (dex !== null && !(await __classPrivateFieldGet(this, _HyperLiquidProvider_instances, "m", _HyperLiquidProvider_isUsdcCollateralDex).call(this, dex))) {
+        __classPrivateFieldGet(this, _HyperLiquidProvider_deps, "f").debugLogger.log('HyperLiquidProvider: Filtering out non-USDC-collateral HIP-3 DEX from market discovery', { dex });
+        return [];
+    }
     // Transform to MarketInfo format
     const markets = meta.universe.map((asset) => (0, hyperLiquidAdapter_1.adaptMarketFromSDK)(asset));
     // Apply HIP-3 filtering on-demand (cheap array operation)
@@ -4750,288 +4764,37 @@ async function _HyperLiquidProvider_getUsdcTokenId() {
         tokenId: __classPrivateFieldGet(this, _HyperLiquidProvider_cachedUsdcTokenId, "f"),
     });
     return __classPrivateFieldGet(this, _HyperLiquidProvider_cachedUsdcTokenId, "f");
-}, _HyperLiquidProvider_isUsdhCollateralDex = 
+}, _HyperLiquidProvider_isUsdcCollateralDex = 
 /**
- * Check if a HIP-3 DEX uses USDH as collateral (vs USDC)
- * Per HyperLiquid docs: USDH DEXs pull collateral from spot balance automatically
+ * Check if a HIP-3 DEX uses USDC as its collateral token
+ *
+ * TAT-3304: Following the USDH sunset, only USDC-collateral DEXs are
+ * supported for trading. This gate filters non-USDC-collateral DEXs
+ * (e.g. the now-sunset USDH) out of market discovery and blocks order
+ * placement, replacing the previous USDH-specific auto-swap path.
+ *
+ * Fails closed: only returns true when the collateral token index
+ * positively resolves to USDC against spot metadata. If the token can't
+ * be resolved (e.g. missing/stale spot metadata), the DEX is treated as
+ * non-USDC and gated out, since we can't otherwise verify the USDC-only
+ * requirement. This only affects HIP-3 DEXs — main-DEX trading (dex ===
+ * null) never calls this gate.
  *
  * @param dexName - The DEX identifier (empty string for main DEX).
  * @returns A promise that resolves to the boolean result.
  */
-async function _HyperLiquidProvider_isUsdhCollateralDex(dexName) {
+async function _HyperLiquidProvider_isUsdcCollateralDex(dexName) {
     const meta = await __classPrivateFieldGet(this, _HyperLiquidProvider_instances, "m", _HyperLiquidProvider_getCachedMeta).call(this, { dexName });
     const spotMeta = await __classPrivateFieldGet(this, _HyperLiquidProvider_instances, "m", _HyperLiquidProvider_getCachedSpotMeta).call(this);
     const collateralToken = spotMeta.tokens.find((tok) => tok.index === meta.collateralToken);
-    const isUsdh = collateralToken?.name === hyperLiquidConfig_1.USDH_CONFIG.TokenName;
+    const isUsdc = collateralToken?.name === hyperLiquidConfig_1.USDC_SYMBOL;
     __classPrivateFieldGet(this, _HyperLiquidProvider_deps, "f").debugLogger.log('HyperLiquidProvider: Checked DEX collateral type', {
         dexName,
         collateralTokenIndex: meta.collateralToken,
         collateralTokenName: collateralToken?.name,
-        isUsdh,
-    });
-    return isUsdh;
-}, _HyperLiquidProvider_getSpotUsdhBalance = 
-/**
- * Get user's USDH balance in spot wallet
- *
- * @returns A promise that resolves to the numeric result.
- */
-async function _HyperLiquidProvider_getSpotUsdhBalance() {
-    const infoClient = __classPrivateFieldGet(this, _HyperLiquidProvider_clientService, "f").getInfoClient();
-    const userAddress = await __classPrivateFieldGet(this, _HyperLiquidProvider_walletService, "f").getUserAddressWithDefault();
-    const spotState = await infoClient.spotClearinghouseState({
-        user: userAddress,
-    });
-    const usdhBalance = spotState.balances.find((b) => b.coin === hyperLiquidConfig_1.USDH_CONFIG.TokenName);
-    const balance = usdhBalance ? parseFloat(usdhBalance.total) : 0;
-    __classPrivateFieldGet(this, _HyperLiquidProvider_deps, "f").debugLogger.log('HyperLiquidProvider: Spot USDH balance', {
-        balance,
-        userAddress,
-    });
-    return balance;
-}, _HyperLiquidProvider_getSpotUsdcBalance = 
-/**
- * Get user's USDC balance in spot wallet
- * Required for USDH DEX orders - need USDC in spot to swap to USDH
- *
- * @returns A promise that resolves to the numeric result.
- */
-async function _HyperLiquidProvider_getSpotUsdcBalance() {
-    const infoClient = __classPrivateFieldGet(this, _HyperLiquidProvider_clientService, "f").getInfoClient();
-    const userAddress = await __classPrivateFieldGet(this, _HyperLiquidProvider_walletService, "f").getUserAddressWithDefault();
-    const spotState = await infoClient.spotClearinghouseState({
-        user: userAddress,
-    });
-    const usdcBalance = spotState.balances.find((b) => b.coin === 'USDC');
-    const balance = usdcBalance ? parseFloat(usdcBalance.total) : 0;
-    __classPrivateFieldGet(this, _HyperLiquidProvider_deps, "f").debugLogger.log('HyperLiquidProvider: Spot USDC balance', {
-        balance,
-        userAddress,
-    });
-    return balance;
-}, _HyperLiquidProvider_transferUsdcToSpot = 
-/**
- * Transfer USDC from main perps wallet to spot wallet
- * Required before swapping USDC→USDH for USDH DEX orders
- *
- * @param amount - The amount value.
- * @returns A promise that resolves to the result.
- */
-async function _HyperLiquidProvider_transferUsdcToSpot(amount) {
-    const exchangeClient = __classPrivateFieldGet(this, _HyperLiquidProvider_clientService, "f").getExchangeClient();
-    const userAddress = await __classPrivateFieldGet(this, _HyperLiquidProvider_walletService, "f").getUserAddressWithDefault();
-    __classPrivateFieldGet(this, _HyperLiquidProvider_deps, "f").debugLogger.log('HyperLiquidProvider: Transferring USDC to spot', {
-        amount,
-        userAddress,
-    });
-    try {
-        const result = await exchangeClient.sendAsset({
-            destination: userAddress,
-            sourceDex: '', // Main perps DEX (empty string)
-            destinationDex: 'spot',
-            token: await __classPrivateFieldGet(this, _HyperLiquidProvider_instances, "m", _HyperLiquidProvider_getUsdcTokenId).call(this),
-            amount: amount.toString(),
-        });
-        if (result.status === 'ok') {
-            __classPrivateFieldGet(this, _HyperLiquidProvider_deps, "f").debugLogger.log('HyperLiquidProvider: USDC transferred to spot', {
-                amount,
-            });
-            return { success: true };
-        }
-        return { success: false, error: perpsErrorCodes_1.PERPS_ERROR_CODES.TRANSFER_FAILED };
-    }
-    catch (error) {
-        const errorMsg = (0, errorUtils_1.ensureError)(error, 'HyperLiquidProvider.transferUSDCToPerps').message;
-        __classPrivateFieldGet(this, _HyperLiquidProvider_deps, "f").debugLogger.log('HyperLiquidProvider: USDC transfer to spot failed', {
-            error: errorMsg,
-        });
-        return { success: false, error: errorMsg };
-    }
-}, _HyperLiquidProvider_swapUsdcToUsdh = 
-/**
- * Swap USDC to USDH on spot market
- * Returns the result of the swap including filled size
- *
- * @param amount - The amount value.
- * @returns A promise that resolves to the result.
- */
-async function _HyperLiquidProvider_swapUsdcToUsdh(amount) {
-    const spotMeta = await __classPrivateFieldGet(this, _HyperLiquidProvider_instances, "m", _HyperLiquidProvider_getCachedSpotMeta).call(this);
-    // Find USDH and USDC tokens by name
-    const usdhToken = spotMeta.tokens.find((tok) => tok.name === hyperLiquidConfig_1.USDH_CONFIG.TokenName);
-    const usdcToken = spotMeta.tokens.find((tok) => tok.name === 'USDC');
-    if (!usdhToken || !usdcToken) {
-        return {
-            success: false,
-            error: perpsErrorCodes_1.PERPS_ERROR_CODES.SPOT_PAIR_NOT_FOUND,
-        };
-    }
-    // Find USDH/USDC pair by token indices (NOT by name - name is @230)
-    const usdhUsdcPair = spotMeta.universe.find((univ) => univ.tokens.includes(usdhToken.index) &&
-        univ.tokens.includes(usdcToken.index));
-    if (!usdhUsdcPair) {
-        return { success: false, error: perpsErrorCodes_1.PERPS_ERROR_CODES.SPOT_PAIR_NOT_FOUND };
-    }
-    const spotAssetId = hyperLiquidConfig_1.SPOT_ASSET_ID_OFFSET + usdhUsdcPair.index;
-    __classPrivateFieldGet(this, _HyperLiquidProvider_deps, "f").debugLogger.log('HyperLiquidProvider: Found USDH/USDC spot pair', {
-        pairIndex: usdhUsdcPair.index,
-        pairName: usdhUsdcPair.name,
-        spotAssetId,
-        usdhTokenIndex: usdhToken.index,
-        usdcTokenIndex: usdcToken.index,
-    });
-    // Get current mid price
-    const infoClient = __classPrivateFieldGet(this, _HyperLiquidProvider_clientService, "f").getInfoClient();
-    const allMids = await infoClient.allMids();
-    const pairKey = `@${usdhUsdcPair.index}`;
-    const usdhPrice = parseFloat(allMids[pairKey] || '1');
-    if (usdhPrice === 0) {
-        return {
-            success: false,
-            error: perpsErrorCodes_1.PERPS_ERROR_CODES.PRICE_UNAVAILABLE,
-        };
-    }
-    // Calculate order parameters
-    // USDH is pegged 1:1 to USDC, add small slippage buffer
-    const slippageMultiplier = 1 + hyperLiquidConfig_1.USDH_CONFIG.SwapSlippageBps / hyperLiquidConfig_1.BASIS_POINTS_DIVISOR;
-    const maxPrice = usdhPrice * slippageMultiplier;
-    // Size in USDH = amount / price (since we're buying USDH with USDC)
-    let sizeInUsdh = amount / usdhPrice;
-    // Format size according to HyperLiquid requirements
-    let formattedSize = sizeInUsdh.toFixed(usdhToken.szDecimals);
-    // CRITICAL: Ensure USDC cost meets $10 minimum after rounding
-    // At price ~0.999995, buying 10.00 USDH costs 9.99995 USDC (under minimum)
-    // Bump up by one increment if needed to meet minimum
-    const minSpotOrderValue = hyperLiquidConfig_1.TRADING_DEFAULTS.amount.mainnet;
-    const estimatedCost = parseFloat(formattedSize) * usdhPrice;
-    if (estimatedCost < minSpotOrderValue) {
-        const increment = Math.pow(10, -usdhToken.szDecimals); // 0.01 for szDecimals=2
-        sizeInUsdh = parseFloat(formattedSize) + increment;
-        formattedSize = sizeInUsdh.toFixed(usdhToken.szDecimals);
-    }
-    // Format price according to HyperLiquid requirements
-    const formattedPrice = (0, hyperLiquidAdapter_1.formatHyperLiquidPrice)({
-        price: maxPrice,
-        szDecimals: usdhToken.szDecimals,
-    });
-    __classPrivateFieldGet(this, _HyperLiquidProvider_deps, "f").debugLogger.log('HyperLiquidProvider: Placing USDC→USDH swap order', {
-        usdcAmount: amount,
-        usdhPrice,
-        maxPrice: formattedPrice,
-        size: formattedSize,
-        szDecimals: usdhToken.szDecimals,
-    });
-    try {
-        const exchangeClient = __classPrivateFieldGet(this, _HyperLiquidProvider_clientService, "f").getExchangeClient();
-        const result = await exchangeClient.order({
-            orders: [
-                {
-                    a: spotAssetId,
-                    b: true, // Buy USDH
-                    p: formattedPrice,
-                    s: formattedSize,
-                    r: false, // Not reduce-only
-                    t: { limit: { tif: 'Ioc' } }, // Immediate-or-cancel
-                },
-            ],
-            grouping: 'na',
-        });
-        if (result.status !== 'ok') {
-            return {
-                success: false,
-                error: perpsErrorCodes_1.PERPS_ERROR_CODES.SWAP_FAILED,
-            };
-        }
-        // Check order status
-        const status = result.response?.data?.statuses?.[0];
-        if (isStatusObject(status) && (0, utils_1.hasProperty)(status, 'error')) {
-            return { success: false, error: String(status.error) };
-        }
-        // Note: `in` narrows the HyperLiquid SDK discriminated union to the
-        // branch that has `filled`; `hasProperty` only narrows the key and
-        // types `status.filled` as `unknown`, which loses access to `.totalSz`.
-        /* eslint-disable no-restricted-syntax */
-        const filledSize = isStatusObject(status) && 'filled' in status
-            ? parseFloat(status.filled?.totalSz ?? '0')
-            : 0;
-        /* eslint-enable no-restricted-syntax */
-        __classPrivateFieldGet(this, _HyperLiquidProvider_deps, "f").debugLogger.log('HyperLiquidProvider: USDC→USDH swap completed', {
-            success: true,
-            filledSize,
-            requestedSize: formattedSize,
-        });
-        return { success: true, filledSize };
-    }
-    catch (error) {
-        const errorMsg = (0, errorUtils_1.ensureError)(error, 'HyperLiquidProvider.swapUSDCToUSDH').message;
-        __classPrivateFieldGet(this, _HyperLiquidProvider_deps, "f").debugLogger.log('HyperLiquidProvider: USDC→USDH swap error', {
-            error: errorMsg,
-        });
-        return { success: false, error: errorMsg };
-    }
-}, _HyperLiquidProvider_ensureUsdhCollateralForOrder = 
-/**
- * Ensure sufficient USDH collateral in spot for HIP-3 DEX order
- * If user lacks USDH, auto-swap from USDC
- *
- * @param dexName - The DEX identifier (empty string for main DEX).
- * @param requiredMargin - The required margin amount.
- */
-async function _HyperLiquidProvider_ensureUsdhCollateralForOrder(dexName, requiredMargin) {
-    const spotUsdhBalance = await __classPrivateFieldGet(this, _HyperLiquidProvider_instances, "m", _HyperLiquidProvider_getSpotUsdhBalance).call(this);
-    __classPrivateFieldGet(this, _HyperLiquidProvider_deps, "f").debugLogger.log('HyperLiquidProvider: Checking USDH collateral', {
-        dexName,
-        requiredMargin,
-        spotUsdhBalance,
-    });
-    if (spotUsdhBalance >= requiredMargin) {
-        __classPrivateFieldGet(this, _HyperLiquidProvider_deps, "f").debugLogger.log('HyperLiquidProvider: Sufficient USDH in spot');
-        return;
-    }
-    const shortfall = requiredMargin - spotUsdhBalance;
-    // HyperLiquid spot has $10 minimum order value
-    const minSpotOrderValue = hyperLiquidConfig_1.TRADING_DEFAULTS.amount.mainnet;
-    // If user has some USDH already, we can swap just the shortfall (if >= $10)
-    // If user has zero USDH, they need at least $10 for first swap
-    const swapAmount = spotUsdhBalance > 0 && shortfall >= minSpotOrderValue
-        ? shortfall
-        : Math.max(shortfall, minSpotOrderValue);
-    // Step 1: Check spot USDC balance
-    const spotUsdcBalance = await __classPrivateFieldGet(this, _HyperLiquidProvider_instances, "m", _HyperLiquidProvider_getSpotUsdcBalance).call(this);
-    // Calculate total available USDC (spot + what we can transfer from perps)
-    // For now, check if we have enough in spot first
-    const totalUsdcNeeded = swapAmount - spotUsdcBalance;
-    // Step 2: If insufficient USDC in spot, transfer from main perps
-    if (spotUsdcBalance < swapAmount) {
-        const transferAmount = totalUsdcNeeded;
-        __classPrivateFieldGet(this, _HyperLiquidProvider_deps, "f").debugLogger.log('HyperLiquidProvider: Transferring USDC to spot for swap', {
-            spotUsdcBalance,
-            swapAmount,
-            transferAmount,
-        });
-        const transferResult = await __classPrivateFieldGet(this, _HyperLiquidProvider_instances, "m", _HyperLiquidProvider_transferUsdcToSpot).call(this, transferAmount);
-        if (!transferResult.success) {
-            // Provide user-friendly error for insufficient funds
-            if (transferResult.error?.includes('Insufficient balance')) {
-                throw new Error(`Insufficient USDC balance. Need $${swapAmount.toFixed(2)} for USDH swap but transfer failed. Please deposit more USDC to your HyperLiquid account.`);
-            }
-            throw new Error(`Failed to transfer USDC to spot: ${transferResult.error}`);
-        }
-    }
-    // Step 3: Swap USDC → USDH
-    __classPrivateFieldGet(this, _HyperLiquidProvider_deps, "f").debugLogger.log('HyperLiquidProvider: Swapping USDC→USDH for collateral', {
-        shortfall,
-        swapAmount,
-        minOrderValue: minSpotOrderValue,
-    });
-    const swapResult = await __classPrivateFieldGet(this, _HyperLiquidProvider_instances, "m", _HyperLiquidProvider_swapUsdcToUsdh).call(this, swapAmount);
-    if (!swapResult.success) {
-        throw new Error(`Failed to acquire USDH collateral for ${dexName}: ${swapResult.error}`);
-    }
-    __classPrivateFieldGet(this, _HyperLiquidProvider_deps, "f").debugLogger.log('HyperLiquidProvider: USDH collateral acquired', {
-        dexName,
-        filledSize: swapResult.filledSize,
+        isUsdc,
     });
+    return isUsdc;
 }, _HyperLiquidProvider_buildAssetMapping = 
 /**
  * Build asset ID mapping from market metadata
@@ -5851,26 +5614,19 @@ async function _HyperLiquidProvider_prepareAssetForTrading(params) {
  */
 async function _HyperLiquidProvider_handleHip3PreOrder(params) {
     const { dexName, symbol, orderPrice, positionSize, leverage, isBuy } = params;
-    // Check if this DEX uses USDH collateral (vs USDC)
-    // For USDH DEXs, HyperLiquid automatically pulls from spot balance
-    const isUsdhDex = await __classPrivateFieldGet(this, _HyperLiquidProvider_instances, "m", _HyperLiquidProvider_isUsdhCollateralDex).call(this, dexName);
-    if (isUsdhDex) {
-        __classPrivateFieldGet(this, _HyperLiquidProvider_deps, "f").debugLogger.log('HyperLiquidProvider: USDH-collateralized DEX detected', {
+    // TAT-3304: Only USDC-collateral HIP-3 DEXs are supported for trading.
+    // Following the USDH sunset, reject orders on any non-USDC-collateral
+    // DEX here instead of attempting the (now-removed) USDH auto-swap path.
+    // Market discovery (#fetchMarketsForDex) already filters such DEXs out,
+    // so this is a defense-in-depth check against stale caches or a
+    // misconfigured allowlist entry.
+    const isUsdcDex = await __classPrivateFieldGet(this, _HyperLiquidProvider_instances, "m", _HyperLiquidProvider_isUsdcCollateralDex).call(this, dexName);
+    if (!isUsdcDex) {
+        __classPrivateFieldGet(this, _HyperLiquidProvider_deps, "f").debugLogger.log('HyperLiquidProvider: Rejecting order for non-USDC-collateral DEX', {
             dexName,
             symbol,
         });
-        // Calculate required margin and ensure USDH is in spot
-        const requiredMargin = await __classPrivateFieldGet(this, _HyperLiquidProvider_instances, "m", _HyperLiquidProvider_calculateHip3RequiredMargin).call(this, {
-            symbol,
-            dexName,
-            positionSize,
-            orderPrice,
-            leverage,
-            isBuy,
-        });
-        await __classPrivateFieldGet(this, _HyperLiquidProvider_instances, "m", _HyperLiquidProvider_ensureUsdhCollateralForOrder).call(this, dexName, requiredMargin);
-        // Unified Account will pull USDH from spot automatically
-        return { transferInfo: null };
+        throw new Error(perpsErrorCodes_1.PERPS_ERROR_CODES.UNSUPPORTED_COLLATERAL);
     }
     if (__classPrivateFieldGet(this, _HyperLiquidProvider_useUnifiedAccount, "f")) {
         __classPrivateFieldGet(this, _HyperLiquidProvider_deps, "f").debugLogger.log('Using Unified Account (no manual transfer)', {
@@ -6087,6 +5843,52 @@ async function _HyperLiquidProvider_getAllMids(infoClient, dexParam) {
         failedStep: allMidsErrorMessage ? 'allMids' : undefined,
         errorMessage: allMidsErrorMessage,
     };
+}, _HyperLiquidProvider_excludeNonUsdcCollateralResults = 
+/**
+ * Filter out successful HIP-3 DexFetchResults whose collateral token is
+ * not USDC, so getMarketDataWithPrices enforces the same USDC-only policy
+ * as market discovery (#fetchMarketsForDex) and order placement
+ * (#handleHip3PreOrder) — otherwise a non-USDC HIP-3 market could appear
+ * in overview data (and the cached stale snapshot derived from it) while
+ * order placement rejects it (TAT-3304).
+ *
+ * Main-DEX results (dex === null) and already-failed results pass through
+ * unchanged. #isUsdcCollateralDex fails closed, and on an unexpected
+ * error checking it (e.g. a spotMeta fetch failure) this also fails
+ * closed by dropping the DEX's result, rather than failing the whole
+ * method and losing main-DEX overview data.
+ *
+ * @param results - The DEX fetch results to filter.
+ * @returns A promise that resolves to the filtered results.
+ */
+async function _HyperLiquidProvider_excludeNonUsdcCollateralResults(results) {
+    return Promise.all(results.map(async (result) => {
+        if (result.dex === null || !result.success) {
+            return result;
+        }
+        let isUsdcDex;
+        try {
+            isUsdcDex = await __classPrivateFieldGet(this, _HyperLiquidProvider_instances, "m", _HyperLiquidProvider_isUsdcCollateralDex).call(this, result.dex);
+        }
+        catch (error) {
+            __classPrivateFieldGet(this, _HyperLiquidProvider_deps, "f").debugLogger.log('HyperLiquidProvider: Failed to check collateral type for HIP-3 DEX; excluding from market data', {
+                dex: result.dex,
+                error: (0, errorUtils_1.ensureError)(error, 'HyperLiquidProvider.excludeNonUsdcCollateralResults').message,
+            });
+            isUsdcDex = false;
+        }
+        if (isUsdcDex) {
+            return result;
+        }
+        __classPrivateFieldGet(this, _HyperLiquidProvider_deps, "f").debugLogger.log('HyperLiquidProvider: Excluding non-USDC-collateral HIP-3 DEX from market data', { dex: result.dex });
+        return {
+            ...result,
+            meta: null,
+            assetCtxs: [],
+            allMids: {},
+            success: false,
+        };
+    }));
 }, _HyperLiquidProvider_mergeDexResultsInto = function _HyperLiquidProvider_mergeDexResultsInto(results, combinedUniverse, combinedAssetCtxs, combinedAllMids) {
     results.forEach((result) => {
         if (result.success && result.meta?.universe) {