Reality2byte
diff --git a/‎.js.env.example‎
Lines changed: 4 additions & 3 deletions b/‎.js.env.example‎
Lines changed: 4 additions & 3 deletions
diff --git a/‎app/components/UI/Perps/Views/PerpsTabView/PerpsTabView.styles.ts‎
Lines changed: 0 additions & 11 deletions b/‎app/components/UI/Perps/Views/PerpsTabView/PerpsTabView.styles.ts‎
Lines changed: 0 additions & 11 deletions
diff --git a/‎app/components/UI/Perps/controllers/PerpsController.test.ts‎
Lines changed: 292 additions & 2 deletions b/‎app/components/UI/Perps/controllers/PerpsController.test.ts‎
Lines changed: 292 additions & 2 deletions
@@ -162,9 +162,10 @@ export MM_PERPS_ENABLED="true"
 export MM_PERPS_SERVICE_INTERRUPTION_BANNER_ENABLED="false"
 export MM_PERPS_BLOCKED_REGIONS="US,CA-ON,GB,BE"
 export MM_PERPS_GTM_MODAL_ENABLED="true"
-# HIP-3 Feature Flags
-export MM_PERPS_EQUITY_ENABLED="false"
-export MM_PERPS_ENABLED_DEXS=""
+# HIP-3 Feature Flags (remote override with local fallback)
+export MM_PERPS_HIP3_ENABLED="true"
+export MM_PERPS_HIP3_ALLOWLIST_MARKETS=""  # Allowlist: Empty = enable all markets. Examples: "xyz:XYZ100,xyz:TSLA" or "xyz:*,abc:TSLA"
+export MM_PERPS_HIP3_BLOCKLIST_MARKETS=""  # Blocklist: Empty = no blocking. Examples: "BTC,ETH" or "xyz:*"
 
 ## Card
 export MM_CARD_BAANX_API_CLIENT_KEY_DEV=""
@@ -90,17 +90,6 @@ const styleSheet = (params: { theme: Theme }) => {
       marginLeft: 12,
       flex: 1,
     },
-    debugButton: {
-      backgroundColor: colors.warning.default,
-      padding: 8,
-      marginHorizontal: 16,
-      marginVertical: 8,
-      borderRadius: 8,
-      alignItems: 'center',
-    },
-    debugButtonText: {
-      color: colors.text.default,
-    },
   });
 };
 
 
@@ -151,7 +151,7 @@ describe('PerpsController', () => {
   });
 
   describe('constructor', () => {
-    it('should initialize with default state', () => {
+    it('initializes with default state', () => {
       expect(controller.state).toEqual(getDefaultPerpsControllerState());
       expect(controller.state.activeProvider).toBe('hyperliquid');
       expect(controller.state.positions).toEqual([]);
@@ -161,7 +161,7 @@ describe('PerpsController', () => {
       expect(controller.state.isTestnet).toBe(false); // Default to mainnet
     });
 
-    it('should read current RemoteFeatureFlagController state during construction', () => {
+    it('reads current RemoteFeatureFlagController state during construction', () => {
       // Given: A mock messenger that tracks calls
       const mockCall = jest.fn().mockImplementation((action: string) => {
         if (action === 'RemoteFeatureFlagController:getState') {
@@ -374,6 +374,296 @@ describe('PerpsController', () => {
     });
   });
 
+  describe('refreshHip3ConfigOnFeatureFlagChange', () => {
+    describe('allowlist parsing', () => {
+      it('parses comma-separated allowlist string from LaunchDarkly', () => {
+        // Arrange
+        const remoteFlags = {
+          remoteFeatureFlags: {
+            perpsHip3AllowlistMarkets: 'BTC-USD,ETH-USD,SOL-USD',
+          },
+        };
+
+        // Act
+        (controller as any).refreshHip3ConfigOnFeatureFlagChange(remoteFlags);
+
+        // Assert
+        expect((controller as any).hip3AllowlistMarkets).toEqual([
+          'BTC-USD',
+          'ETH-USD',
+          'SOL-USD',
+        ]);
+      });
+
+      it('parses allowlist array format', () => {
+        // Arrange
+        const remoteFlags = {
+          remoteFeatureFlags: {
+            perpsHip3AllowlistMarkets: ['BTC-USD', 'ETH-USD'],
+          },
+        };
+
+        // Act
+        (controller as any).refreshHip3ConfigOnFeatureFlagChange(remoteFlags);
+
+        // Assert
+        expect((controller as any).hip3AllowlistMarkets).toEqual([
+          'BTC-USD',
+          'ETH-USD',
+        ]);
+      });
+
+      it('trims whitespace from allowlist array items', () => {
+        // Arrange
+        const remoteFlags = {
+          remoteFeatureFlags: {
+            perpsHip3AllowlistMarkets: ['  BTC-USD  ', ' ETH-USD'],
+          },
+        };
+
+        // Act
+        (controller as any).refreshHip3ConfigOnFeatureFlagChange(remoteFlags);
+
+        // Assert
+        expect((controller as any).hip3AllowlistMarkets).toEqual([
+          'BTC-USD',
+          'ETH-USD',
+        ]);
+      });
+
+      it('falls back to local config when allowlist format is invalid (non-string array)', () => {
+        // Arrange
+        const initialAllowlist = ['LOCAL-BTC'];
+        (controller as any).hip3AllowlistMarkets = initialAllowlist;
+        const remoteFlags = {
+          remoteFeatureFlags: {
+            perpsHip3AllowlistMarkets: [123, null, 'BTC-USD'],
+          },
+        };
+
+        // Act
+        (controller as any).refreshHip3ConfigOnFeatureFlagChange(remoteFlags);
+
+        // Assert
+        expect((controller as any).hip3AllowlistMarkets).toEqual(
+          initialAllowlist,
+        );
+      });
+
+      it('falls back to local config when allowlist format is invalid (empty string array)', () => {
+        // Arrange
+        const initialAllowlist = ['LOCAL-ETH'];
+        (controller as any).hip3AllowlistMarkets = initialAllowlist;
+        const remoteFlags = {
+          remoteFeatureFlags: {
+            perpsHip3AllowlistMarkets: ['BTC-USD', '', 'ETH-USD'],
+          },
+        };
+
+        // Act
+        (controller as any).refreshHip3ConfigOnFeatureFlagChange(remoteFlags);
+
+        // Assert
+        expect((controller as any).hip3AllowlistMarkets).toEqual(
+          initialAllowlist,
+        );
+      });
+
+      it('falls back to local config when allowlist is empty string after parsing', () => {
+        // Arrange
+        const initialAllowlist = ['LOCAL-SOL'];
+        (controller as any).hip3AllowlistMarkets = initialAllowlist;
+        const remoteFlags = {
+          remoteFeatureFlags: {
+            perpsHip3AllowlistMarkets: '',
+          },
+        };
+
+        // Act
+        (controller as any).refreshHip3ConfigOnFeatureFlagChange(remoteFlags);
+
+        // Assert
+        expect((controller as any).hip3AllowlistMarkets).toEqual(
+          initialAllowlist,
+        );
+      });
+    });
+
+    describe('blocklist parsing', () => {
+      it('parses comma-separated blocklist string from LaunchDarkly', () => {
+        // Arrange
+        const remoteFlags = {
+          remoteFeatureFlags: {
+            perpsHip3BlocklistMarkets: 'SCAM-USD,FAKE-USD',
+          },
+        };
+
+        // Act
+        (controller as any).refreshHip3ConfigOnFeatureFlagChange(remoteFlags);
+
+        // Assert
+        expect((controller as any).hip3BlocklistMarkets).toEqual([
+          'SCAM-USD',
+          'FAKE-USD',
+        ]);
+      });
+
+      it('parses blocklist array format', () => {
+        // Arrange
+        const remoteFlags = {
+          remoteFeatureFlags: {
+            perpsHip3BlocklistMarkets: ['SCAM-USD', 'FAKE-USD'],
+          },
+        };
+
+        // Act
+        (controller as any).refreshHip3ConfigOnFeatureFlagChange(remoteFlags);
+
+        // Assert
+        expect((controller as any).hip3BlocklistMarkets).toEqual([
+          'SCAM-USD',
+          'FAKE-USD',
+        ]);
+      });
+
+      it('trims whitespace from blocklist array items', () => {
+        // Arrange
+        const remoteFlags = {
+          remoteFeatureFlags: {
+            perpsHip3BlocklistMarkets: ['  SCAM-USD  ', ' FAKE-USD'],
+          },
+        };
+
+        // Act
+        (controller as any).refreshHip3ConfigOnFeatureFlagChange(remoteFlags);
+
+        // Assert
+        expect((controller as any).hip3BlocklistMarkets).toEqual([
+          'SCAM-USD',
+          'FAKE-USD',
+        ]);
+      });
+
+      it('falls back to local config when blocklist format is invalid (non-string array)', () => {
+        // Arrange
+        const initialBlocklist = ['LOCAL-SCAM'];
+        (controller as any).hip3BlocklistMarkets = initialBlocklist;
+        const remoteFlags = {
+          remoteFeatureFlags: {
+            perpsHip3BlocklistMarkets: [456, null, 'SCAM-USD'],
+          },
+        };
+
+        // Act
+        (controller as any).refreshHip3ConfigOnFeatureFlagChange(remoteFlags);
+
+        // Assert
+        expect((controller as any).hip3BlocklistMarkets).toEqual(
+          initialBlocklist,
+        );
+      });
+
+      it('falls back to local config when blocklist format is invalid (empty string array)', () => {
+        // Arrange
+        const initialBlocklist = ['LOCAL-FAKE'];
+        (controller as any).hip3BlocklistMarkets = initialBlocklist;
+        const remoteFlags = {
+          remoteFeatureFlags: {
+            perpsHip3BlocklistMarkets: ['SCAM-USD', '', 'FAKE-USD'],
+          },
+        };
+
+        // Act
+        (controller as any).refreshHip3ConfigOnFeatureFlagChange(remoteFlags);
+
+        // Assert
+        expect((controller as any).hip3BlocklistMarkets).toEqual(
+          initialBlocklist,
+        );
+      });
+
+      it('falls back to local config when blocklist is empty string after parsing', () => {
+        // Arrange
+        const initialBlocklist = ['LOCAL-BAD'];
+        (controller as any).hip3BlocklistMarkets = initialBlocklist;
+        const remoteFlags = {
+          remoteFeatureFlags: {
+            perpsHip3BlocklistMarkets: '',
+          },
+        };
+
+        // Act
+        (controller as any).refreshHip3ConfigOnFeatureFlagChange(remoteFlags);
+
+        // Assert
+        expect((controller as any).hip3BlocklistMarkets).toEqual(
+          initialBlocklist,
+        );
+      });
+    });
+
+    describe('config change detection', () => {
+      it('increments hip3ConfigVersion when allowlist changes', () => {
+        // Arrange
+        const initialVersion = controller.state.hip3ConfigVersion;
+        (controller as any).hip3AllowlistMarkets = ['BTC-USD'];
+        const remoteFlags = {
+          remoteFeatureFlags: {
+            perpsHip3AllowlistMarkets: 'ETH-USD,SOL-USD',
+          },
+        };
+
+        // Act
+        (controller as any).refreshHip3ConfigOnFeatureFlagChange(remoteFlags);
+
+        // Assert
+        expect(controller.state.hip3ConfigVersion).toBe(initialVersion + 1);
+        expect((controller as any).hip3AllowlistMarkets).toEqual([
+          'ETH-USD',
+          'SOL-USD',
+        ]);
+      });
+
+      it('increments hip3ConfigVersion when blocklist changes', () => {
+        // Arrange
+        const initialVersion = controller.state.hip3ConfigVersion;
+        (controller as any).hip3BlocklistMarkets = ['OLD-SCAM'];
+        const remoteFlags = {
+          remoteFeatureFlags: {
+            perpsHip3BlocklistMarkets: 'NEW-SCAM,NEW-FAKE',
+          },
+        };
+
+        // Act
+        (controller as any).refreshHip3ConfigOnFeatureFlagChange(remoteFlags);
+
+        // Assert
+        expect(controller.state.hip3ConfigVersion).toBe(initialVersion + 1);
+        expect((controller as any).hip3BlocklistMarkets).toEqual([
+          'NEW-SCAM',
+          'NEW-FAKE',
+        ]);
+      });
+
+      it('does not increment version when config stays the same', () => {
+        // Arrange
+        const initialVersion = controller.state.hip3ConfigVersion;
+        (controller as any).hip3AllowlistMarkets = ['BTC-USD', 'ETH-USD'];
+        const remoteFlags = {
+          remoteFeatureFlags: {
+            perpsHip3AllowlistMarkets: 'ETH-USD,BTC-USD', // Same, just different order
+          },
+        };
+
+        // Act
+        (controller as any).refreshHip3ConfigOnFeatureFlagChange(remoteFlags);
+
+        // Assert
+        expect(controller.state.hip3ConfigVersion).toBe(initialVersion);
+      });
+    });
+  });
+
   describe('getActiveProvider', () => {
     it('should throw error when not initialized', () => {
       // Mock the controller as not initialized