@metamask-previews/perps-controller 22.0.0-preview-35f016caa → 22.1.0-preview-01e391e

package/dist/services/FeatureFlagConfigurationService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FeatureFlagConfigurationService.d.ts","sourceRoot":"","sources":["../../src/services/FeatureFlagConfigurationService.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,yBAAyB,EACzB,2BAA2B,EAC5B,MAAM,mBAAmB,CAAC;AAO3B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,+BAA+B;;IAG1C;;;;OAIG;IACH,YAAY,IAAI,EAAE,yBAAyB,EAE1C;IAuID;;;;;;;;;;;OAWG;IACH,iBAAiB,CAAC,OAAO,EAAE;QACzB,gCAAgC,EAAE,2BAA2B,CAAC;QAC9D,OAAO,EAAE,cAAc,CAAC;KACzB,GAAG,IAAI,CA2HP;IAED;;;;;;;;;OASG;IACH,kBAAkB,CAAC,OAAO,EAAE;QAC1B,gCAAgC,EAAE,2BAA2B,CAAC;QAC9D,OAAO,EAAE,cAAc,CAAC;KACzB,GAAG,IAAI,CAsBP;IAED;;;;;;;;;OASG;IACH,iBAAiB,CAAC,OAAO,EAAE;QACzB,IAAI,EAAE,MAAM,EAAE,CAAC;QACf,MAAM,EAAE,QAAQ,GAAG,UAAU,CAAC;QAC9B,OAAO,EAAE,cAAc,CAAC;KACzB,GAAG,IAAI,CAoCP;CACF"}
+{"version":3,"file":"FeatureFlagConfigurationService.d.ts","sourceRoot":"","sources":["../../src/services/FeatureFlagConfigurationService.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,yBAAyB,EACzB,2BAA2B,EAC5B,MAAM,mBAAmB,CAAC;AAO3B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,+BAA+B;;IAS1C;;;;OAIG;IACH,YAAY,IAAI,EAAE,yBAAyB,EAE1C;IA4ID;;;;;;;;;;;OAWG;IACH,iBAAiB,CAAC,OAAO,EAAE;QACzB,gCAAgC,EAAE,2BAA2B,CAAC;QAC9D,OAAO,EAAE,cAAc,CAAC;KACzB,GAAG,IAAI,CA2HP;IAED;;;;;;;;;OASG;IACH,kBAAkB,CAAC,OAAO,EAAE;QAC1B,gCAAgC,EAAE,2BAA2B,CAAC;QAC9D,OAAO,EAAE,cAAc,CAAC;KACzB,GAAG,IAAI,CAsBP;IAED;;;;;;;;;OASG;IACH,iBAAiB,CAAC,OAAO,EAAE;QACzB,IAAI,EAAE,MAAM,EAAE,CAAC;QACf,MAAM,EAAE,QAAQ,GAAG,UAAU,CAAC;QAC9B,OAAO,EAAE,cAAc,CAAC;KACzB,GAAG,IAAI,CAoCP;CACF"}

package/dist/services/FeatureFlagConfigurationService.js

@@ -22,6 +22,11 @@ import { parseCommaSeparatedString, stripQuotes, } from '../utils/stringParseUti
  */
 export class FeatureFlagConfigurationService {
     #deps;
+    /**
+     * Invalid (fieldName, pattern) pairs already reported, so a malformed remote
+     * flag is logged once per service lifetime instead of on every state change.
+     */
+    #reportedInvalidPatterns = new Set();
     /**
      * Create a new FeatureFlagConfigurationService instance
      *
@@ -79,7 +84,8 @@ export class FeatureFlagConfigurationService {
     }
     /**
      * Filter out patterns that fail market pattern validation.
-     * Invalid patterns are logged and dropped instead of propagated downstream.
+     * Invalid patterns are dropped instead of propagated downstream, and each
+     * distinct (fieldName, pattern) pair is logged at most once.
      *
      * @param patterns - The array of market patterns to validate.
      * @param fieldName - The name of the field being validated (for logging).
@@ -92,13 +98,17 @@ export class FeatureFlagConfigurationService {
                 return true;
             }
             catch (error) {
-                this.#deps.logger.error(ensureError(error, `FeatureFlagConfigurationService.filterValidPatterns`), {
-                    tags: { feature: PERPS_CONSTANTS.FeatureName },
-                    context: {
-                        name: 'FeatureFlagConfigurationService.filterValidPatterns',
-                        data: { fieldName, pattern },
-                    },
-                });
+                const reportKey = JSON.stringify([fieldName, pattern]);
+                if (!this.#reportedInvalidPatterns.has(reportKey)) {
+                    this.#reportedInvalidPatterns.add(reportKey);
+                    this.#deps.logger.error(ensureError(error, `FeatureFlagConfigurationService.filterValidPatterns`), {
+                        tags: { feature: PERPS_CONSTANTS.FeatureName },
+                        context: {
+                            name: 'FeatureFlagConfigurationService.filterValidPatterns',
+                            data: { fieldName, pattern },
+                        },
+                    });
+                }
                 return false;
             }
         });

package/dist/services/FeatureFlagConfigurationService.js.map

@@ -1 +1 @@
-{"version":3,"file":"FeatureFlagConfigurationService.js","sourceRoot":"","sources":["../../src/services/FeatureFlagConfigurationService.ts"],"names":[],"mappings":"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","sourcesContent":["import { hasProperty } from '@metamask/utils';\n\nimport { PERPS_CONSTANTS } from '../constants/perpsConfig.js';\nimport { isVersionGatedFeatureFlag } from '../types/index.js';\nimport type {\n  PerpsPlatformDependencies,\n  PerpsRemoteFeatureFlagState,\n} from '../types/index.js';\nimport { ensureError } from '../utils/errorUtils.js';\nimport { validateMarketPattern } from '../utils/marketUtils.js';\nimport {\n  parseCommaSeparatedString,\n  stripQuotes,\n} from '../utils/stringParseUtils.js';\nimport type { ServiceContext } from './ServiceContext.js';\n\n/**\n * FeatureFlagConfigurationService\n *\n * Handles HIP-3 configuration and geo-blocking configuration from remote feature flags.\n * Implements \"sticky remote\" pattern: once remote config is loaded, never downgrade to fallback.\n * Orchestrates validation, change detection, and version management for feature flag updates.\n *\n * Responsibilities:\n * - Remote feature flag validation and parsing\n * - HIP-3 configuration management (equity, allowlist, blocklist)\n * - Geo-blocking configuration from remote flags\n * - Change detection and version management\n * - \"Sticky remote\" pattern enforcement (never downgrade)\n *\n * Instance-based service with constructor injection of platform dependencies.\n */\nexport class FeatureFlagConfigurationService {\n  readonly #deps: PerpsPlatformDependencies;\n\n  /**\n   * Create a new FeatureFlagConfigurationService instance\n   *\n   * @param deps - Platform dependencies for logging, metrics, etc.\n   */\n  constructor(deps: PerpsPlatformDependencies) {\n    this.#deps = deps;\n  }\n\n  /**\n   * Validate and parse market list from remote feature flags\n   * Handles both string (comma-separated) and array formats from LaunchDarkly\n   *\n   * @param remoteValue - The raw value from remote feature flags (string or array).\n   * @param fieldName - The name of the field being validated (for logging).\n   * @param currentValue - The current local market list as fallback reference.\n   * @returns The validated market list, or undefined if validation fails.\n   */\n  #validateMarketList(\n    remoteValue: unknown,\n    fieldName: string,\n    currentValue: string[],\n  ): string[] | undefined {\n    this.#deps.debugLogger.log(\n      `PerpsController: HIP-3 ${fieldName} validation`,\n      {\n        remoteValue,\n        type: typeof remoteValue,\n        isArray: Array.isArray(remoteValue),\n      },\n    );\n\n    // LaunchDarkly returns comma-separated strings for list values\n    // Values may have literal quotes (e.g., '\"xyz\"') due to JSON encoding quirks\n    if (typeof remoteValue === 'string') {\n      const parsed = this.#filterValidPatterns(\n        parseCommaSeparatedString(remoteValue).map(stripQuotes),\n        fieldName,\n      );\n\n      if (parsed.length > 0) {\n        this.#deps.debugLogger.log(\n          `PerpsController: HIP-3 ${fieldName} validated from string`,\n          { validatedMarkets: parsed },\n        );\n        return parsed;\n      }\n\n      this.#deps.debugLogger.log(\n        `PerpsController: HIP-3 ${fieldName} string was empty after parsing`,\n        { fallbackValue: currentValue },\n      );\n      return undefined;\n    }\n\n    // Fallback: Validate array of non-empty strings\n    if (\n      Array.isArray(remoteValue) &&\n      remoteValue.every((item) => typeof item === 'string' && item.length > 0)\n    ) {\n      const validatedMarkets = this.#filterValidPatterns(\n        (remoteValue as string[])\n          .map((market) => stripQuotes(market.trim()))\n          .filter((market) => market.length > 0),\n        fieldName,\n      );\n\n      if (validatedMarkets.length > 0) {\n        this.#deps.debugLogger.log(\n          `PerpsController: HIP-3 ${fieldName} validated from array`,\n          { validatedMarkets },\n        );\n        return validatedMarkets;\n      }\n\n      this.#deps.debugLogger.log(\n        `PerpsController: HIP-3 ${fieldName} array was empty after filtering`,\n        { fallbackValue: currentValue },\n      );\n      return undefined;\n    }\n\n    this.#deps.debugLogger.log(\n      `PerpsController: HIP-3 ${fieldName} validation FAILED - falling back to local config`,\n      {\n        reason: Array.isArray(remoteValue)\n          ? 'Array contains non-string or empty values'\n          : 'Invalid type (expected string or array)',\n        fallbackValue: currentValue,\n      },\n    );\n    return undefined;\n  }\n\n  /**\n   * Filter out patterns that fail market pattern validation.\n   * Invalid patterns are logged and dropped instead of propagated downstream.\n   *\n   * @param patterns - The array of market patterns to validate.\n   * @param fieldName - The name of the field being validated (for logging).\n   * @returns The filtered array containing only valid market patterns.\n   */\n  #filterValidPatterns(patterns: string[], fieldName: string): string[] {\n    return patterns.filter((pattern) => {\n      try {\n        validateMarketPattern(pattern);\n        return true;\n      } catch (error) {\n        this.#deps.logger.error(\n          ensureError(\n            error,\n            `FeatureFlagConfigurationService.filterValidPatterns`,\n          ),\n          {\n            tags: { feature: PERPS_CONSTANTS.FeatureName },\n            context: {\n              name: 'FeatureFlagConfigurationService.filterValidPatterns',\n              data: { fieldName, pattern },\n            },\n          },\n        );\n        return false;\n      }\n    });\n  }\n\n  /**\n   * Check if arrays have different values (order-independent comparison)\n   *\n   * @param a - The first string array to compare.\n   * @param b - The second string array to compare.\n   * @returns True if the arrays contain different values.\n   */\n  #arraysHaveDifferentValues(a: string[], b: string[]): boolean {\n    return (\n      JSON.stringify(\n        [...a].sort((itemA, itemB) => itemA.localeCompare(itemB)),\n      ) !==\n      JSON.stringify([...b].sort((itemA, itemB) => itemA.localeCompare(itemB)))\n    );\n  }\n\n  /**\n   * Refresh HIP-3 configuration when remote feature flags change.\n   * This method extracts HIP-3 settings from remote flags, validates them,\n   * and updates internal state if they differ from current values.\n   * When config changes, increments hip3ConfigVersion to trigger ConnectionManager reconnection.\n   *\n   * Follows the \"sticky remote\" pattern: once remote config is loaded, never downgrade to fallback.\n   *\n   * @param options - Configuration object\n   * @param options.remoteFeatureFlagControllerState - Remote feature flag state\n   * @param options.context - ServiceContext providing state access callbacks\n   */\n  refreshHip3Config(options: {\n    remoteFeatureFlagControllerState: PerpsRemoteFeatureFlagState;\n    context: ServiceContext;\n  }): void {\n    const { remoteFeatureFlagControllerState, context } = options;\n\n    if (\n      !context.getHip3Config ||\n      !context.setHip3Config ||\n      !context.incrementHip3ConfigVersion\n    ) {\n      throw new Error(\n        'Required HIP-3 callbacks not available in ServiceContext',\n      );\n    }\n\n    const remoteFlags = remoteFeatureFlagControllerState.remoteFeatureFlags;\n    const currentConfig = context.getHip3Config();\n\n    // Extract and validate remote HIP-3 equity enabled flag\n    const equityFlag = remoteFlags?.perpsHip3Enabled;\n    // Use type guard to validate before calling - validatedVersionGatedFeatureFlag also\n    // handles invalid flags internally, but proper typing requires the guard\n    const validatedEquity = isVersionGatedFeatureFlag(equityFlag)\n      ? this.#deps.featureFlags.validateVersionGated(equityFlag)\n      : undefined;\n\n    this.#deps.debugLogger.log(\n      'PerpsController: HIP-3 equity flag validation',\n      {\n        equityFlag,\n        validatedEquity,\n        willUse: validatedEquity === undefined ? 'fallback' : 'remote',\n      },\n    );\n\n    // Extract and validate remote HIP-3 market lists\n    const validatedAllowlistMarkets = hasProperty(\n      remoteFlags,\n      'perpsHip3AllowlistMarkets',\n    )\n      ? this.#validateMarketList(\n          remoteFlags.perpsHip3AllowlistMarkets,\n          'allowlistMarkets',\n          currentConfig.allowlistMarkets,\n        )\n      : undefined;\n\n    const validatedBlocklistMarkets = hasProperty(\n      remoteFlags,\n      'perpsHip3BlocklistMarkets',\n    )\n      ? this.#validateMarketList(\n          remoteFlags.perpsHip3BlocklistMarkets,\n          'blocklistMarkets',\n          currentConfig.blocklistMarkets,\n        )\n      : undefined;\n\n    // Detect changes (only if we have valid remote values)\n    const equityChanged =\n      validatedEquity !== undefined &&\n      validatedEquity !== currentConfig.enabled;\n    const allowlistMarketsChanged =\n      validatedAllowlistMarkets !== undefined &&\n      this.#arraysHaveDifferentValues(\n        validatedAllowlistMarkets,\n        currentConfig.allowlistMarkets,\n      );\n    const blocklistMarketsChanged =\n      validatedBlocklistMarkets !== undefined &&\n      this.#arraysHaveDifferentValues(\n        validatedBlocklistMarkets,\n        currentConfig.blocklistMarkets,\n      );\n\n    if (equityChanged || allowlistMarketsChanged || blocklistMarketsChanged) {\n      this.#deps.debugLogger.log(\n        'PerpsController: HIP-3 config changed via remote feature flags',\n        {\n          equityChanged,\n          allowlistMarketsChanged,\n          blocklistMarketsChanged,\n          oldEquity: currentConfig.enabled,\n          newEquity: validatedEquity,\n          oldAllowlistMarkets: currentConfig.allowlistMarkets,\n          newAllowlistMarkets: validatedAllowlistMarkets,\n          oldBlocklistMarkets: currentConfig.blocklistMarkets,\n          newBlocklistMarkets: validatedBlocklistMarkets,\n          source: 'remote',\n        },\n      );\n\n      // Update internal state (sticky remote - never downgrade)\n      context.setHip3Config({\n        enabled: validatedEquity,\n        allowlistMarkets: validatedAllowlistMarkets\n          ? [...validatedAllowlistMarkets]\n          : undefined,\n        blocklistMarkets: validatedBlocklistMarkets\n          ? [...validatedBlocklistMarkets]\n          : undefined,\n        source: 'remote',\n      });\n\n      // Increment version to trigger ConnectionManager reconnection and cache clearing\n      const newVersion = context.incrementHip3ConfigVersion();\n\n      this.#deps.debugLogger.log(\n        'PerpsController: Incremented hip3ConfigVersion to trigger reconnection',\n        {\n          newVersion,\n          newHip3Enabled: validatedEquity ?? currentConfig.enabled,\n          newHip3AllowlistMarkets:\n            validatedAllowlistMarkets ?? currentConfig.allowlistMarkets,\n          newHip3BlocklistMarkets:\n            validatedBlocklistMarkets ?? currentConfig.blocklistMarkets,\n        },\n      );\n\n      // Note: ConnectionManager will handle:\n      // 1. Detecting hip3ConfigVersion change via Redux monitoring\n      // 2. Clearing all StreamManager caches\n      // 3. Calling reconnectWithNewContext() -> initializeProviders()\n      // 4. Provider reinitialization will read the new HIP-3 config below\n    }\n  }\n\n  /**\n   * Respond to RemoteFeatureFlagController state changes\n   * Refreshes user eligibility based on geo-blocked regions defined in remote feature flag.\n   * Uses fallback configuration when remote feature flag is undefined.\n   * Note: Initial eligibility is set in the constructor if fallback regions are provided.\n   *\n   * @param options - Configuration object\n   * @param options.remoteFeatureFlagControllerState - Remote feature flag state\n   * @param options.context - ServiceContext providing callbacks\n   */\n  refreshEligibility(options: {\n    remoteFeatureFlagControllerState: PerpsRemoteFeatureFlagState;\n    context: ServiceContext;\n  }): void {\n    const { remoteFeatureFlagControllerState, context } = options;\n\n    const perpsGeoBlockedRegionsFeatureFlag =\n      // NOTE: Do not use perpsPerpTradingGeoBlockedCountries as it is deprecated.\n      remoteFeatureFlagControllerState.remoteFeatureFlags\n        ?.perpsPerpTradingGeoBlockedCountriesV2;\n\n    const remoteBlockedRegions = (\n      perpsGeoBlockedRegionsFeatureFlag as { blockedRegions?: string[] }\n    )?.blockedRegions;\n\n    if (Array.isArray(remoteBlockedRegions)) {\n      this.setBlockedRegions({\n        list: remoteBlockedRegions,\n        source: 'remote',\n        context,\n      });\n    }\n\n    // Also check for HIP-3 config changes\n    this.refreshHip3Config({ remoteFeatureFlagControllerState, context });\n  }\n\n  /**\n   * Set blocked region list with \"never downgrade\" pattern enforcement\n   * Updates the blocked region list and triggers eligibility refresh.\n   * Implements \"sticky remote\": once remote regions are set, never downgrade to fallback.\n   *\n   * @param options - Configuration object\n   * @param options.list - Array of blocked region codes\n   * @param options.source - Source of the list ('remote' or 'fallback')\n   * @param options.context - ServiceContext providing callbacks\n   */\n  setBlockedRegions(options: {\n    list: string[];\n    source: 'remote' | 'fallback';\n    context: ServiceContext;\n  }): void {\n    const { list, source, context } = options;\n\n    if (\n      !context.getBlockedRegionList ||\n      !context.setBlockedRegionList ||\n      !context.refreshEligibility\n    ) {\n      throw new Error(\n        'Required blocked region callbacks not available in ServiceContext',\n      );\n    }\n\n    const currentList = context.getBlockedRegionList();\n\n    // Never downgrade from remote to fallback\n    if (source === 'fallback' && currentList.source === 'remote') {\n      return;\n    }\n\n    if (Array.isArray(list)) {\n      context.setBlockedRegionList(list, source);\n    }\n\n    context.refreshEligibility().catch((error) => {\n      this.#deps.logger.error(\n        ensureError(error, 'FeatureFlagConfigurationService.setBlockedRegions'),\n        {\n          tags: { feature: PERPS_CONSTANTS.FeatureName },\n          context: {\n            name: 'FeatureFlagConfigurationService.setBlockedRegions',\n            data: { source },\n          },\n        },\n      );\n    });\n  }\n}\n"]}
+{"version":3,"file":"FeatureFlagConfigurationService.js","sourceRoot":"","sources":["../../src/services/FeatureFlagConfigurationService.ts"],"names":[],"mappings":"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","sourcesContent":["import { hasProperty } from '@metamask/utils';\n\nimport { PERPS_CONSTANTS } from '../constants/perpsConfig.js';\nimport { isVersionGatedFeatureFlag } from '../types/index.js';\nimport type {\n  PerpsPlatformDependencies,\n  PerpsRemoteFeatureFlagState,\n} from '../types/index.js';\nimport { ensureError } from '../utils/errorUtils.js';\nimport { validateMarketPattern } from '../utils/marketUtils.js';\nimport {\n  parseCommaSeparatedString,\n  stripQuotes,\n} from '../utils/stringParseUtils.js';\nimport type { ServiceContext } from './ServiceContext.js';\n\n/**\n * FeatureFlagConfigurationService\n *\n * Handles HIP-3 configuration and geo-blocking configuration from remote feature flags.\n * Implements \"sticky remote\" pattern: once remote config is loaded, never downgrade to fallback.\n * Orchestrates validation, change detection, and version management for feature flag updates.\n *\n * Responsibilities:\n * - Remote feature flag validation and parsing\n * - HIP-3 configuration management (equity, allowlist, blocklist)\n * - Geo-blocking configuration from remote flags\n * - Change detection and version management\n * - \"Sticky remote\" pattern enforcement (never downgrade)\n *\n * Instance-based service with constructor injection of platform dependencies.\n */\nexport class FeatureFlagConfigurationService {\n  readonly #deps: PerpsPlatformDependencies;\n\n  /**\n   * Invalid (fieldName, pattern) pairs already reported, so a malformed remote\n   * flag is logged once per service lifetime instead of on every state change.\n   */\n  readonly #reportedInvalidPatterns = new Set<string>();\n\n  /**\n   * Create a new FeatureFlagConfigurationService instance\n   *\n   * @param deps - Platform dependencies for logging, metrics, etc.\n   */\n  constructor(deps: PerpsPlatformDependencies) {\n    this.#deps = deps;\n  }\n\n  /**\n   * Validate and parse market list from remote feature flags\n   * Handles both string (comma-separated) and array formats from LaunchDarkly\n   *\n   * @param remoteValue - The raw value from remote feature flags (string or array).\n   * @param fieldName - The name of the field being validated (for logging).\n   * @param currentValue - The current local market list as fallback reference.\n   * @returns The validated market list, or undefined if validation fails.\n   */\n  #validateMarketList(\n    remoteValue: unknown,\n    fieldName: string,\n    currentValue: string[],\n  ): string[] | undefined {\n    this.#deps.debugLogger.log(\n      `PerpsController: HIP-3 ${fieldName} validation`,\n      {\n        remoteValue,\n        type: typeof remoteValue,\n        isArray: Array.isArray(remoteValue),\n      },\n    );\n\n    // LaunchDarkly returns comma-separated strings for list values\n    // Values may have literal quotes (e.g., '\"xyz\"') due to JSON encoding quirks\n    if (typeof remoteValue === 'string') {\n      const parsed = this.#filterValidPatterns(\n        parseCommaSeparatedString(remoteValue).map(stripQuotes),\n        fieldName,\n      );\n\n      if (parsed.length > 0) {\n        this.#deps.debugLogger.log(\n          `PerpsController: HIP-3 ${fieldName} validated from string`,\n          { validatedMarkets: parsed },\n        );\n        return parsed;\n      }\n\n      this.#deps.debugLogger.log(\n        `PerpsController: HIP-3 ${fieldName} string was empty after parsing`,\n        { fallbackValue: currentValue },\n      );\n      return undefined;\n    }\n\n    // Fallback: Validate array of non-empty strings\n    if (\n      Array.isArray(remoteValue) &&\n      remoteValue.every((item) => typeof item === 'string' && item.length > 0)\n    ) {\n      const validatedMarkets = this.#filterValidPatterns(\n        (remoteValue as string[])\n          .map((market) => stripQuotes(market.trim()))\n          .filter((market) => market.length > 0),\n        fieldName,\n      );\n\n      if (validatedMarkets.length > 0) {\n        this.#deps.debugLogger.log(\n          `PerpsController: HIP-3 ${fieldName} validated from array`,\n          { validatedMarkets },\n        );\n        return validatedMarkets;\n      }\n\n      this.#deps.debugLogger.log(\n        `PerpsController: HIP-3 ${fieldName} array was empty after filtering`,\n        { fallbackValue: currentValue },\n      );\n      return undefined;\n    }\n\n    this.#deps.debugLogger.log(\n      `PerpsController: HIP-3 ${fieldName} validation FAILED - falling back to local config`,\n      {\n        reason: Array.isArray(remoteValue)\n          ? 'Array contains non-string or empty values'\n          : 'Invalid type (expected string or array)',\n        fallbackValue: currentValue,\n      },\n    );\n    return undefined;\n  }\n\n  /**\n   * Filter out patterns that fail market pattern validation.\n   * Invalid patterns are dropped instead of propagated downstream, and each\n   * distinct (fieldName, pattern) pair is logged at most once.\n   *\n   * @param patterns - The array of market patterns to validate.\n   * @param fieldName - The name of the field being validated (for logging).\n   * @returns The filtered array containing only valid market patterns.\n   */\n  #filterValidPatterns(patterns: string[], fieldName: string): string[] {\n    return patterns.filter((pattern) => {\n      try {\n        validateMarketPattern(pattern);\n        return true;\n      } catch (error) {\n        const reportKey = JSON.stringify([fieldName, pattern]);\n        if (!this.#reportedInvalidPatterns.has(reportKey)) {\n          this.#reportedInvalidPatterns.add(reportKey);\n          this.#deps.logger.error(\n            ensureError(\n              error,\n              `FeatureFlagConfigurationService.filterValidPatterns`,\n            ),\n            {\n              tags: { feature: PERPS_CONSTANTS.FeatureName },\n              context: {\n                name: 'FeatureFlagConfigurationService.filterValidPatterns',\n                data: { fieldName, pattern },\n              },\n            },\n          );\n        }\n        return false;\n      }\n    });\n  }\n\n  /**\n   * Check if arrays have different values (order-independent comparison)\n   *\n   * @param a - The first string array to compare.\n   * @param b - The second string array to compare.\n   * @returns True if the arrays contain different values.\n   */\n  #arraysHaveDifferentValues(a: string[], b: string[]): boolean {\n    return (\n      JSON.stringify(\n        [...a].sort((itemA, itemB) => itemA.localeCompare(itemB)),\n      ) !==\n      JSON.stringify([...b].sort((itemA, itemB) => itemA.localeCompare(itemB)))\n    );\n  }\n\n  /**\n   * Refresh HIP-3 configuration when remote feature flags change.\n   * This method extracts HIP-3 settings from remote flags, validates them,\n   * and updates internal state if they differ from current values.\n   * When config changes, increments hip3ConfigVersion to trigger ConnectionManager reconnection.\n   *\n   * Follows the \"sticky remote\" pattern: once remote config is loaded, never downgrade to fallback.\n   *\n   * @param options - Configuration object\n   * @param options.remoteFeatureFlagControllerState - Remote feature flag state\n   * @param options.context - ServiceContext providing state access callbacks\n   */\n  refreshHip3Config(options: {\n    remoteFeatureFlagControllerState: PerpsRemoteFeatureFlagState;\n    context: ServiceContext;\n  }): void {\n    const { remoteFeatureFlagControllerState, context } = options;\n\n    if (\n      !context.getHip3Config ||\n      !context.setHip3Config ||\n      !context.incrementHip3ConfigVersion\n    ) {\n      throw new Error(\n        'Required HIP-3 callbacks not available in ServiceContext',\n      );\n    }\n\n    const remoteFlags = remoteFeatureFlagControllerState.remoteFeatureFlags;\n    const currentConfig = context.getHip3Config();\n\n    // Extract and validate remote HIP-3 equity enabled flag\n    const equityFlag = remoteFlags?.perpsHip3Enabled;\n    // Use type guard to validate before calling - validatedVersionGatedFeatureFlag also\n    // handles invalid flags internally, but proper typing requires the guard\n    const validatedEquity = isVersionGatedFeatureFlag(equityFlag)\n      ? this.#deps.featureFlags.validateVersionGated(equityFlag)\n      : undefined;\n\n    this.#deps.debugLogger.log(\n      'PerpsController: HIP-3 equity flag validation',\n      {\n        equityFlag,\n        validatedEquity,\n        willUse: validatedEquity === undefined ? 'fallback' : 'remote',\n      },\n    );\n\n    // Extract and validate remote HIP-3 market lists\n    const validatedAllowlistMarkets = hasProperty(\n      remoteFlags,\n      'perpsHip3AllowlistMarkets',\n    )\n      ? this.#validateMarketList(\n          remoteFlags.perpsHip3AllowlistMarkets,\n          'allowlistMarkets',\n          currentConfig.allowlistMarkets,\n        )\n      : undefined;\n\n    const validatedBlocklistMarkets = hasProperty(\n      remoteFlags,\n      'perpsHip3BlocklistMarkets',\n    )\n      ? this.#validateMarketList(\n          remoteFlags.perpsHip3BlocklistMarkets,\n          'blocklistMarkets',\n          currentConfig.blocklistMarkets,\n        )\n      : undefined;\n\n    // Detect changes (only if we have valid remote values)\n    const equityChanged =\n      validatedEquity !== undefined &&\n      validatedEquity !== currentConfig.enabled;\n    const allowlistMarketsChanged =\n      validatedAllowlistMarkets !== undefined &&\n      this.#arraysHaveDifferentValues(\n        validatedAllowlistMarkets,\n        currentConfig.allowlistMarkets,\n      );\n    const blocklistMarketsChanged =\n      validatedBlocklistMarkets !== undefined &&\n      this.#arraysHaveDifferentValues(\n        validatedBlocklistMarkets,\n        currentConfig.blocklistMarkets,\n      );\n\n    if (equityChanged || allowlistMarketsChanged || blocklistMarketsChanged) {\n      this.#deps.debugLogger.log(\n        'PerpsController: HIP-3 config changed via remote feature flags',\n        {\n          equityChanged,\n          allowlistMarketsChanged,\n          blocklistMarketsChanged,\n          oldEquity: currentConfig.enabled,\n          newEquity: validatedEquity,\n          oldAllowlistMarkets: currentConfig.allowlistMarkets,\n          newAllowlistMarkets: validatedAllowlistMarkets,\n          oldBlocklistMarkets: currentConfig.blocklistMarkets,\n          newBlocklistMarkets: validatedBlocklistMarkets,\n          source: 'remote',\n        },\n      );\n\n      // Update internal state (sticky remote - never downgrade)\n      context.setHip3Config({\n        enabled: validatedEquity,\n        allowlistMarkets: validatedAllowlistMarkets\n          ? [...validatedAllowlistMarkets]\n          : undefined,\n        blocklistMarkets: validatedBlocklistMarkets\n          ? [...validatedBlocklistMarkets]\n          : undefined,\n        source: 'remote',\n      });\n\n      // Increment version to trigger ConnectionManager reconnection and cache clearing\n      const newVersion = context.incrementHip3ConfigVersion();\n\n      this.#deps.debugLogger.log(\n        'PerpsController: Incremented hip3ConfigVersion to trigger reconnection',\n        {\n          newVersion,\n          newHip3Enabled: validatedEquity ?? currentConfig.enabled,\n          newHip3AllowlistMarkets:\n            validatedAllowlistMarkets ?? currentConfig.allowlistMarkets,\n          newHip3BlocklistMarkets:\n            validatedBlocklistMarkets ?? currentConfig.blocklistMarkets,\n        },\n      );\n\n      // Note: ConnectionManager will handle:\n      // 1. Detecting hip3ConfigVersion change via Redux monitoring\n      // 2. Clearing all StreamManager caches\n      // 3. Calling reconnectWithNewContext() -> initializeProviders()\n      // 4. Provider reinitialization will read the new HIP-3 config below\n    }\n  }\n\n  /**\n   * Respond to RemoteFeatureFlagController state changes\n   * Refreshes user eligibility based on geo-blocked regions defined in remote feature flag.\n   * Uses fallback configuration when remote feature flag is undefined.\n   * Note: Initial eligibility is set in the constructor if fallback regions are provided.\n   *\n   * @param options - Configuration object\n   * @param options.remoteFeatureFlagControllerState - Remote feature flag state\n   * @param options.context - ServiceContext providing callbacks\n   */\n  refreshEligibility(options: {\n    remoteFeatureFlagControllerState: PerpsRemoteFeatureFlagState;\n    context: ServiceContext;\n  }): void {\n    const { remoteFeatureFlagControllerState, context } = options;\n\n    const perpsGeoBlockedRegionsFeatureFlag =\n      // NOTE: Do not use perpsPerpTradingGeoBlockedCountries as it is deprecated.\n      remoteFeatureFlagControllerState.remoteFeatureFlags\n        ?.perpsPerpTradingGeoBlockedCountriesV2;\n\n    const remoteBlockedRegions = (\n      perpsGeoBlockedRegionsFeatureFlag as { blockedRegions?: string[] }\n    )?.blockedRegions;\n\n    if (Array.isArray(remoteBlockedRegions)) {\n      this.setBlockedRegions({\n        list: remoteBlockedRegions,\n        source: 'remote',\n        context,\n      });\n    }\n\n    // Also check for HIP-3 config changes\n    this.refreshHip3Config({ remoteFeatureFlagControllerState, context });\n  }\n\n  /**\n   * Set blocked region list with \"never downgrade\" pattern enforcement\n   * Updates the blocked region list and triggers eligibility refresh.\n   * Implements \"sticky remote\": once remote regions are set, never downgrade to fallback.\n   *\n   * @param options - Configuration object\n   * @param options.list - Array of blocked region codes\n   * @param options.source - Source of the list ('remote' or 'fallback')\n   * @param options.context - ServiceContext providing callbacks\n   */\n  setBlockedRegions(options: {\n    list: string[];\n    source: 'remote' | 'fallback';\n    context: ServiceContext;\n  }): void {\n    const { list, source, context } = options;\n\n    if (\n      !context.getBlockedRegionList ||\n      !context.setBlockedRegionList ||\n      !context.refreshEligibility\n    ) {\n      throw new Error(\n        'Required blocked region callbacks not available in ServiceContext',\n      );\n    }\n\n    const currentList = context.getBlockedRegionList();\n\n    // Never downgrade from remote to fallback\n    if (source === 'fallback' && currentList.source === 'remote') {\n      return;\n    }\n\n    if (Array.isArray(list)) {\n      context.setBlockedRegionList(list, source);\n    }\n\n    context.refreshEligibility().catch((error) => {\n      this.#deps.logger.error(\n        ensureError(error, 'FeatureFlagConfigurationService.setBlockedRegions'),\n        {\n          tags: { feature: PERPS_CONSTANTS.FeatureName },\n          context: {\n            name: 'FeatureFlagConfigurationService.setBlockedRegions',\n            data: { source },\n          },\n        },\n      );\n    });\n  }\n}\n"]}

package/dist/services/HyperLiquidSubscriptionService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HyperLiquidSubscriptionService.d.ts","sourceRoot":"","sources":["../../src/services/HyperLiquidSubscriptionService.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"HyperLiquidSubscriptionService.d.ts","sourceRoot":"","sources":["../../src/services/HyperLiquidSubscriptionService.ts"],"names":[],"mappings":"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"}

package/dist/services/HyperLiquidSubscriptionService.js

@@ -4,7 +4,7 @@ import { HYPERLIQUID_CONFIG } from '../constants/hyperLiquidConfig.js';
 import { TP_SL_CONFIG, ABSTRACTION_MODE_REFRESH_THROTTLE_MS, } from '../constants/perpsConfig.js';
 import { hyperLiquidModeFoldsSpot } from '../types/hyperliquid-types.js';
 import { WebSocketConnectionState } from '../types/index.js';
-import { addSpotBalanceToAccountState, calculateWeightedReturnOnEquity, } from '../utils/accountUtils.js';
+import { addSpotBalanceToAccountState, calculateWeightedReturnOnEquity, sumCrossMarginSummaries, } from '../utils/accountUtils.js';
 import { PERPS_ERROR_ACTION, PERPS_ERROR_COMPONENT, PERPS_ERROR_OPERATION, createPerpsErrorContext, } from '../utils/errorContext.js';
 import { ensureError } from '../utils/errorUtils.js';
 import { adaptPositionFromSDK, adaptOrderFromSDK, adaptAccountStateFromSDK, buildHyperLiquidFillId, parseAssetName, } from '../utils/hyperLiquidAdapter.js';
@@ -595,7 +595,11 @@ export class HyperLiquidSubscriptionService {
             .join('|');
     }
     #hashAccountState(account) {
-        return `${account.spendableBalance}:${account.withdrawableBalance}:${account.totalBalance}:${account.marginUsed}:${account.unrealizedPnl}`;
+        const summary = account.crossMarginSummary;
+        const summaryHash = summary
+            ? `${summary.accountValue}:${summary.maintenanceMargin}:${summary.marginUsed}:${summary.notional}`
+            : 'none';
+        return `${account.spendableBalance}:${account.withdrawableBalance}:${account.totalBalance}:${account.marginUsed}:${account.unrealizedPnl}:${summaryHash}`;
     }
     // Cache hashes to avoid recomputation
     #cachedPositionsHash = '';
@@ -898,10 +902,13 @@ export class HyperLiquidSubscriptionService {
         });
         // Use first DEX's account state as base and override aggregated values
         const firstDexAccount = this.#dexAccountCache.values().next().value ?? {};
+        const { crossMarginSummary: _firstDexSummary, ...firstDexBase } = firstDexAccount;
+        const crossMarginSummary = sumCrossMarginSummaries(Array.from(this.#dexAccountCache.values()));
         // Calculate weighted returnOnEquity across all DEXs
         const returnOnEquity = calculateWeightedReturnOnEquity(accountStatesForROE);
         return addSpotBalanceToAccountState({
-            ...firstDexAccount,
+            ...firstDexBase,
+            ...(crossMarginSummary ? { crossMarginSummary } : {}),
             spendableBalance: totalSpendableBalance.toString(),
             withdrawableBalance: totalWithdrawableBalance.toString(),
             totalBalance: totalBalance.toString(),