Merge branch 'main' into fix/recipient-account-icons

Author: ccharly

app/actions/settings/index.js

@@ -12,13 +12,6 @@ export function setShowHexData(showHexData) {
   };
 }
 
-export function setShowCustomNonce(showCustomNonce) {
-  return {
-    type: 'SET_SHOW_CUSTOM_NONCE',
-    showCustomNonce,
-  };
-}
-
 export function setShowFiatOnTestnets(showFiatOnTestnets) {
   return {
     type: 'SET_SHOW_FIAT_ON_TESTNETS',

app/components/UI/Perps/constants/hyperLiquidConfig.ts

@@ -114,33 +114,47 @@ export const FEE_RATES: FeeRatesConfig = {
 };
 
 /**
- * HIP-3 fee multiplier configuration
+ * HIP-3 dynamic fee calculation configuration
  *
- * HIP-3 (builder-deployed) perpetual markets charge 2x base fees compared to
- * validator-operated markets. This covers a 50/50 split between the protocol
- * and the builder/deployer.
+ * HIP-3 (builder-deployed) perpetual markets have variable fees based on:
+ * 1. deployerFeeScale - Per-DEX fee multiplier (fetched from perpDexs API)
+ * 2. growthMode - Per-asset 90% fee reduction (fetched from meta API)
  *
- * Reference: HIP-3.md line 45 - "From the user perspective, fees are 2x the
- * usual fees on validator-operated perp markets."
+ * Fee Formula (from HyperLiquid docs):
+ * - scaleIfHip3 = deployerFeeScale < 1 ? deployerFeeScale + 1 : deployerFeeScale * 2
+ * - growthModeScale = growthMode ? 0.1 : 1
+ * - finalRate = baseRate * scaleIfHip3 * growthModeScale
  *
- * Applied to:
- * - Base fee rates (taker/maker)
- * - User-specific discounted rates
- * - All fee calculations for HIP-3 assets (identified by dex:SYMBOL format)
+ * Example: For xyz:TSLA with deployerFeeScale=1.0 and growthMode="enabled":
+ * - scaleIfHip3 = 1.0 * 2 = 2.0
+ * - growthModeScale = 0.1 (90% reduction)
+ * - Final multiplier = 2.0 * 0.1 = 0.2 (effectively 80% off standard 2x HIP-3 fees)
  *
- * Example: For xyz:TSLA (HIP-3 asset):
- * - Base taker rate: 0.045%
- * - After HIP-3 multiplier: 0.045% × 2 = 0.090%
- * - Protocol receives: 0.045% (same as regular markets)
- * - Builder receives: 0.045% (deployed market incentive)
- *
- * @see HIP-3.md for detailed protocol specification
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/trading/fees#fee-formula-for-developers
  * @see parseAssetName() in HyperLiquidProvider for HIP-3 asset detection
  */
 export const HIP3_FEE_CONFIG = {
   /**
-   * Fee multiplier for HIP-3 assets (2x base rate)
-   * Covers 50% deployer share + 50% protocol share
+   * Growth Mode multiplier - 90% fee reduction for assets in growth phase
+   * This is a protocol constant from HyperLiquid's fee formula
+   */
+  GROWTH_MODE_SCALE: 0.1,
+
+  /**
+   * Default deployerFeeScale when API is unavailable
+   * Most HIP-3 DEXs use 1.0, which results in 2x base fees
+   */
+  DEFAULT_DEPLOYER_FEE_SCALE: 1.0,
+
+  /**
+   * Cache TTL for perpDexs data (5 minutes)
+   * Fee scales rarely change, so longer cache is acceptable
+   */
+  PERP_DEXS_CACHE_TTL_MS: 5 * 60 * 1000,
+
+  /**
+   * @deprecated Use dynamic calculation via calculateHip3FeeMultiplier()
+   * Kept for backwards compatibility during migration
    */
   FEE_MULTIPLIER: 2,
 } as const;

app/components/UI/Perps/controllers/providers/HyperLiquidProvider.ts

@@ -125,6 +125,10 @@ import type {
   UserHistoryItem,
 } from '../types';
 import { PERPS_ERROR_CODES } from '../PerpsController';
+import type {
+  ExtendedAssetMeta,
+  ExtendedPerpDex,
+} from '../../types/perps-types';
 
 // Helper method parameter interfaces (module-level for class-dependent methods only)
 interface GetAssetInfoParams {
@@ -224,6 +228,13 @@ export class HyperLiquidProvider implements IPerpsProvider {
   // Filtering is applied on-demand (cheap array operations) - no need for separate processed cache
   private cachedMetaByDex = new Map<string, MetaResponse>();
 
+  // Cache for perpDexs data (deployerFeeScale for dynamic fee calculation)
+  // TTL-based cache - fee scales rarely change
+  private perpDexsCache: {
+    data: ExtendedPerpDex[] | null;
+    timestamp: number;
+  } = { data: null, timestamp: 0 };
+
   // Session cache for referral state (cleared on disconnect/reconnect)
   // Key: `network:userAddress`, Value: true if referral is set
   private referralCheckCache = new Map<string, boolean>();
@@ -644,6 +655,116 @@ export class HyperLiquidProvider implements IPerpsProvider {
     return meta;
   }
 
+  /**
+   * Fetch perpDexs data with TTL-based caching
+   * Returns deployerFeeScale info needed for dynamic fee calculation
+   * @returns Array of ExtendedPerpDex objects (null entries represent main DEX)
+   */
+  private async getCachedPerpDexs(): Promise<ExtendedPerpDex[]> {
+    const now = Date.now();
+
+    // Return cached data if still valid
+    if (
+      this.perpDexsCache.data &&
+      now - this.perpDexsCache.timestamp <
+        HIP3_FEE_CONFIG.PERP_DEXS_CACHE_TTL_MS
+    ) {
+      DevLogger.log('[getCachedPerpDexs] Using cached perpDexs data', {
+        age: `${Math.round((now - this.perpDexsCache.timestamp) / 1000)}s`,
+        count: this.perpDexsCache.data.length,
+      });
+      return this.perpDexsCache.data;
+    }
+
+    // Fetch fresh data from API
+    // Note: SDK types are incomplete, but API returns deployerFeeScale
+    this.ensureClientsInitialized();
+    const infoClient = this.clientService.getInfoClient();
+    const perpDexs =
+      (await infoClient.perpDexs()) as unknown as ExtendedPerpDex[];
+
+    // Cache the result
+    this.perpDexsCache = { data: perpDexs, timestamp: now };
+
+    DevLogger.log('[getCachedPerpDexs] Fetched and cached perpDexs data', {
+      count: perpDexs.length,
+      dexes: perpDexs
+        .filter((d) => d !== null)
+        .map((d) => ({
+          name: d.name,
+          deployerFeeScale: d.deployerFeeScale,
+        })),
+    });
+
+    return perpDexs;
+  }
+
+  /**
+   * Calculate HIP-3 fee multiplier using HyperLiquid's official formula
+   * Fetches deployerFeeScale from perpDexs API and growthMode from meta API
+   *
+   * Formula from HyperLiquid docs:
+   * - scaleIfHip3 = deployerFeeScale < 1 ? deployerFeeScale + 1 : deployerFeeScale * 2
+   * - growthModeScale = growthMode ? 0.1 : 1
+   * - finalMultiplier = scaleIfHip3 * growthModeScale
+   *
+   * @see https://hyperliquid.gitbook.io/hyperliquid-docs/trading/fees#fee-formula-for-developers
+   */
+  private async calculateHip3FeeMultiplier(params: {
+    dexName: string;
+    assetSymbol: string;
+  }): Promise<number> {
+    const { dexName, assetSymbol } = params;
+
+    try {
+      // Get deployerFeeScale from perpDexs
+      const perpDexs = await this.getCachedPerpDexs();
+      const dexInfo = perpDexs.find((d) => d?.name === dexName);
+      const parsedScale = parseFloat(dexInfo?.deployerFeeScale ?? '');
+      const deployerFeeScale = Number.isNaN(parsedScale)
+        ? HIP3_FEE_CONFIG.DEFAULT_DEPLOYER_FEE_SCALE
+        : parsedScale;
+
+      // Get growthMode from meta for this specific asset
+      const meta = await this.getCachedMeta({ dexName });
+      const fullAssetName = `${dexName}:${assetSymbol}`;
+      const assetMeta = meta.universe.find(
+        (u) => (u as ExtendedAssetMeta).name === fullAssetName,
+      ) as ExtendedAssetMeta | undefined;
+      const isGrowthMode = assetMeta?.growthMode === 'enabled';
+
+      // Apply official formula
+      const scaleIfHip3 =
+        deployerFeeScale < 1 ? deployerFeeScale + 1 : deployerFeeScale * 2;
+      const growthModeScale = isGrowthMode
+        ? HIP3_FEE_CONFIG.GROWTH_MODE_SCALE
+        : 1;
+
+      const finalMultiplier = scaleIfHip3 * growthModeScale;
+
+      DevLogger.log('HIP-3 Dynamic Fee Calculation', {
+        dexName,
+        assetSymbol,
+        fullAssetName,
+        deployerFeeScale,
+        isGrowthMode,
+        scaleIfHip3,
+        growthModeScale,
+        finalMultiplier,
+      });
+
+      return finalMultiplier;
+    } catch (error) {
+      DevLogger.log('HIP-3 Fee Calculation Failed, using fallback', {
+        dexName,
+        assetSymbol,
+        error: ensureError(error).message,
+      });
+      // Safe fallback: standard HIP-3 2x multiplier (no Growth Mode discount)
+      return HIP3_FEE_CONFIG.DEFAULT_DEPLOYER_FEE_SCALE * 2;
+    }
+  }
+
   /**
    * Generate session cache key for user-specific caches
    * Format: "network:userAddress" (address normalized to lowercase)
@@ -5071,21 +5192,27 @@ export class HyperLiquidProvider implements IPerpsProvider {
     let feeRate =
       orderType === 'market' || !isMaker ? FEE_RATES.taker : FEE_RATES.maker;
 
-    // HIP-3 assets have 2× base fees (per fees.md line 9)
-    // Parse coin to detect HIP-3 DEX (e.g., "xyz:TSLA" → dex="xyz")
-    const { dex } = parseAssetName(coin);
+    // Parse coin to detect HIP-3 DEX (e.g., "xyz:TSLA" → dex="xyz", symbol="TSLA")
+    const { dex, symbol } = parseAssetName(coin);
     const isHip3Asset = dex !== null;
 
-    if (isHip3Asset) {
+    // Calculate HIP-3 fee multiplier dynamically (handles Growth Mode)
+    let hip3Multiplier = 1;
+    if (isHip3Asset && dex && symbol) {
+      hip3Multiplier = await this.calculateHip3FeeMultiplier({
+        dexName: dex,
+        assetSymbol: symbol,
+      });
       const originalRate = feeRate;
-      feeRate *= HIP3_FEE_CONFIG.FEE_MULTIPLIER;
+      feeRate *= hip3Multiplier;
 
-      DevLogger.log('HIP-3 Fee Multiplier Applied', {
+      DevLogger.log('HIP-3 Dynamic Fee Multiplier Applied', {
         coin,
         dex,
+        symbol,
         originalBaseRate: originalRate,
         hip3BaseRate: feeRate,
-        multiplier: HIP3_FEE_CONFIG.FEE_MULTIPLIER,
+        hip3Multiplier,
       });
     }
 
@@ -5095,6 +5222,7 @@ export class HyperLiquidProvider implements IPerpsProvider {
       amount,
       coin,
       isHip3Asset,
+      hip3Multiplier,
       baseFeeRate: feeRate,
       baseTakerRate: FEE_RATES.taker,
       baseMakerRate: FEE_RATES.maker,
@@ -5119,9 +5247,9 @@ export class HyperLiquidProvider implements IPerpsProvider {
               ? cached.perpsTakerRate
               : cached.perpsMakerRate;
 
-          // Apply HIP-3 multiplier to user-specific rates
-          if (isHip3Asset) {
-            userFeeRate *= HIP3_FEE_CONFIG.FEE_MULTIPLIER;
+          // Apply HIP-3 dynamic multiplier to user-specific rates (includes Growth Mode)
+          if (isHip3Asset && hip3Multiplier > 0) {
+            userFeeRate *= hip3Multiplier;
           }
 
           feeRate = userFeeRate;
@@ -5134,6 +5262,7 @@ export class HyperLiquidProvider implements IPerpsProvider {
             spotMakerRate: cached.spotMakerRate,
             selectedRate: feeRate,
             isHip3Asset,
+            hip3Multiplier,
             cacheExpiry: new Date(cached.timestamp + cached.ttl).toISOString(),
             cacheAge: `${Math.round((Date.now() - cached.timestamp) / 1000)}s`,
           });
@@ -5245,9 +5374,9 @@ export class HyperLiquidProvider implements IPerpsProvider {
             ? rates.perpsTakerRate
             : rates.perpsMakerRate;
 
-        // Apply HIP-3 multiplier to API-fetched rates
-        if (isHip3Asset) {
-          userFeeRate *= HIP3_FEE_CONFIG.FEE_MULTIPLIER;
+        // Apply HIP-3 dynamic multiplier to API-fetched rates (includes Growth Mode)
+        if (isHip3Asset && hip3Multiplier > 0) {
+          userFeeRate *= hip3Multiplier;
         }
 
         feeRate = userFeeRate;
@@ -5257,6 +5386,7 @@ export class HyperLiquidProvider implements IPerpsProvider {
           selectedRatePercentage: `${(feeRate * 100).toFixed(4)}%`,
           discountApplied: perpsTakerRate < FEE_RATES.taker,
           isHip3Asset,
+          hip3Multiplier,
           cacheExpiry: new Date(rates.timestamp + rates.ttl).toISOString(),
         });
       }
@@ -5389,6 +5519,7 @@ export class HyperLiquidProvider implements IPerpsProvider {
       this.referralCheckCache.clear();
       this.builderFeeCheckCache.clear();
       this.cachedMetaByDex.clear();
+      this.perpDexsCache = { data: null, timestamp: 0 };
 
       // Clear pending promise trackers to prevent memory leaks and ensure clean state
       this.ensureReadyPromise = null;

app/components/UI/Perps/types/perps-types.ts

@@ -87,3 +87,33 @@ export interface ReconnectOptions {
    */
   force?: boolean;
 }
+
+/**
+ * Extended asset metadata including Growth Mode fields not in SDK types.
+ * The HyperLiquid API returns these fields but the SDK doesn't type them.
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/trading/fees#fee-formula-for-developers
+ */
+export interface ExtendedAssetMeta {
+  name: string;
+  szDecimals: number;
+  maxLeverage: number;
+  /** Per-asset Growth Mode status - "enabled" means 90% fee reduction */
+  growthMode?: 'enabled' | null;
+  /** ISO timestamp of last Growth Mode change */
+  lastGrowthModeChangeTime?: string;
+}
+
+/**
+ * Extended perp DEX info including fee scale fields not in SDK types.
+ * The HyperLiquid API returns these fields but the SDK doesn't type them.
+ * @see https://hyperliquid.gitbook.io/hyperliquid-docs/trading/fees#fee-formula-for-developers
+ */
+export interface ExtendedPerpDex {
+  name: string;
+  fullName?: string;
+  deployer?: string;
+  /** DEX-level fee scale (e.g., "1.0" for xyz DEX) - determines HIP-3 multiplier */
+  deployerFeeScale?: string;
+  /** ISO timestamp of last fee scale change */
+  lastDeployerFeeScaleChangeTime?: string;
+}