@metamask-previews/perps-controller 9.2.1-preview-9c0a7053d → 9.2.1-preview-e856aaf70

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_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_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_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");
@@ -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 token info for HIP-3 collateral checks)
+        // 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);
         // Unified DEX discovery cache — single source of truth for all perpDexs() derivatives.
@@ -4237,7 +4237,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 (e.g. USDC token index) is available during order placement
+        // This ensures token info (USDC/USDH indices) is available during order placement
         if (__classPrivateFieldGet(this, _HyperLiquidProvider_hip3Enabled, "f")) {
             try {
                 await __classPrivateFieldGet(this, _HyperLiquidProvider_instances, "m", _HyperLiquidProvider_getCachedSpotMeta).call(this);
@@ -4577,7 +4577,7 @@ async function _HyperLiquidProvider_getAssetIdWithRepair(params) {
 }, _HyperLiquidProvider_getCachedSpotMeta = 
 /**
  * Fetch spot metadata with session-based caching
- * Contains token info (e.g. USDC token index) needed for HIP-3 collateral checks
+ * Contains token info (USDC, USDH indices) needed for HIP-3 collateral checks
  * Pre-fetched in ensureReadyForTrading() to ensure availability during order placement
  *
  * @returns SpotMetaResponse with tokens and universe data
@@ -4714,14 +4714,6 @@ 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)
@@ -4758,36 +4750,288 @@ async function _HyperLiquidProvider_getUsdcTokenId() {
         tokenId: __classPrivateFieldGet(this, _HyperLiquidProvider_cachedUsdcTokenId, "f"),
     });
     return __classPrivateFieldGet(this, _HyperLiquidProvider_cachedUsdcTokenId, "f");
-}, _HyperLiquidProvider_isUsdcCollateralDex = 
+}, _HyperLiquidProvider_isUsdhCollateralDex = 
 /**
- * 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 open (treated as USDC) when the collateral token index can't be
- * resolved against spot metadata, so an unexpected/incomplete metadata
- * shape doesn't spuriously block an otherwise-valid market — only a DEX
- * whose collateral token positively resolves to something other than
- * USDC is gated.
+ * Check if a HIP-3 DEX uses USDH as collateral (vs USDC)
+ * Per HyperLiquid docs: USDH DEXs pull collateral from spot balance automatically
  *
  * @param dexName - The DEX identifier (empty string for main DEX).
  * @returns A promise that resolves to the boolean result.
  */
-async function _HyperLiquidProvider_isUsdcCollateralDex(dexName) {
+async function _HyperLiquidProvider_isUsdhCollateralDex(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 isUsdc = !collateralToken || collateralToken.name === hyperLiquidConfig_1.USDC_SYMBOL;
+    const isUsdh = collateralToken?.name === hyperLiquidConfig_1.USDH_CONFIG.TokenName;
     __classPrivateFieldGet(this, _HyperLiquidProvider_deps, "f").debugLogger.log('HyperLiquidProvider: Checked DEX collateral type', {
         dexName,
         collateralTokenIndex: meta.collateralToken,
         collateralTokenName: collateralToken?.name,
-        isUsdc,
+        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,
     });
-    return isUsdc;
 }, _HyperLiquidProvider_buildAssetMapping = 
 /**
  * Build asset ID mapping from market metadata
@@ -5607,19 +5851,26 @@ async function _HyperLiquidProvider_prepareAssetForTrading(params) {
  */
 async function _HyperLiquidProvider_handleHip3PreOrder(params) {
     const { dexName, symbol, orderPrice, positionSize, leverage, isBuy } = params;
-    // 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', {
+    // 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', {
             dexName,
             symbol,
         });
-        throw new Error(perpsErrorCodes_1.PERPS_ERROR_CODES.UNSUPPORTED_COLLATERAL);
+        // 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 };
     }
     if (__classPrivateFieldGet(this, _HyperLiquidProvider_useUnifiedAccount, "f")) {
         __classPrivateFieldGet(this, _HyperLiquidProvider_deps, "f").debugLogger.log('Using Unified Account (no manual transfer)', {