release: 7.63.1 (#25572)

# 🚀 v7.63.1 Testing & Release Quality Process

Hi Team,  
As part of our new **MetaMask Release Quality Process**, here’s a quick
overview of the key processes, testing strategies, and milestones to
ensure a smooth and high-quality deployment.

---

## 📋 Key Processes

### Testing Strategy
- **Developer Teams:**  
Conduct regression and exploratory testing for your functional areas,
including automated and manual tests for critical workflows.
- **QA Team:**  
Focus on exploratory testing across the wallet, prioritize high-impact
areas, and triage any Sentry errors found during testing.
- **Customer Success Team:**  
Validate new functionalities and provide feedback to support release
monitoring.

### GitHub Signoff
- Each team must **sign off on the Release Candidate (RC)** via GitHub
by the end of the validation timeline (**Tuesday EOD PT**).
- Ensure all tests outlined in the Testing Plan are executed, and any
identified issues are addressed.

### Issue Resolution
- **Resolve all Release Blockers** (Sev0 and Sev1) by **Tuesday EOD
PT**.
- For unresolved blockers, PRs may be reverted, or feature flags
disabled to maintain release quality and timelines.

### Cherry-Picking Criteria
- Only **critical fixes** meeting outlined criteria will be
cherry-picked.
- Developers must ensure these fixes are thoroughly reviewed, tested,
and merged by **Tuesday EOD PT**.

---

## 🗓️ Timeline and Milestones

1. **Today (Friday):** Begin Release Candidate validation.  
2. **Tuesday EOD PT:** Finalize RC with all fixes and cherry-picks.  
3. **Wednesday:** Buffer day for final checks.  
4. **Thursday:** Submit release to app stores and begin rollout to 1% of
users.
5. **Monday:** Scale deployment to 10%.  
6. **Tuesday:** Full rollout to 100%.

---

## ✅ Signoff Checklist

Each team is responsible for signing off via GitHub. Use the checkbox
below to track signoff completion:

# Team sign-off checklist
- [ ] Mobile Platform

This process is a major step forward in ensuring release stability and
quality. Let’s stay aligned and make this release a success! 🚀

Feel free to reach out if you have questions or need clarification. 

Many thanks in advance

# Reference
- Testing plan sheet -
https://docs.google.com/spreadsheets/d/1tsoodlAlyvEUpkkcNcbZ4PM9HuC9cEM80RZeoVv5OCQ/edit?gid=404070372#gid=404070372

Author: joaoloureirop

CHANGELOG.md

@@ -7,6 +7,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [7.63.1]
+
+### Fixed
+
+- fix: Android ANR bug (#25596)
+- fix(analytics): cp-7.63.1 correct capitalization in Deep link event name (#25599)
+- feat(perps): sdk reconnect on native socket event (#25022) (#25573)
+
 ## [7.63.0]
 
 ### Added
@@ -10202,7 +10210,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - [#957](https://github.com/MetaMask/metamask-mobile/pull/957): fix timeouts (#957)
 - [#954](https://github.com/MetaMask/metamask-mobile/pull/954): Bugfix: onboarding navigation (#954)
 
-[Unreleased]: https://github.com/MetaMask/metamask-mobile/compare/v7.63.0...HEAD
+[Unreleased]: https://github.com/MetaMask/metamask-mobile/compare/v7.63.1...HEAD
+[7.63.1]: https://github.com/MetaMask/metamask-mobile/compare/v7.63.0...v7.63.1
 [7.63.0]: https://github.com/MetaMask/metamask-mobile/compare/v7.62.2...v7.63.0
 [7.62.2]: https://github.com/MetaMask/metamask-mobile/compare/v7.62.1...v7.62.2
 [7.62.1]: https://github.com/MetaMask/metamask-mobile/compare/v7.62.0...v7.62.1

android/app/build.gradle

@@ -187,8 +187,8 @@ android {
         applicationId "io.metamask"
         minSdkVersion rootProject.ext.minSdkVersion
         targetSdkVersion rootProject.ext.targetSdkVersion
-        versionName "7.63.0"
-        versionCode 3604
+        versionName "7.63.1"
+        versionCode 3625
         testBuildType System.getProperty('testBuildType', 'debug')
         testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
         manifestPlaceholders.MM_BRANCH_KEY_TEST = "$System.env.MM_BRANCH_KEY_TEST"

android/app/src/main/AndroidManifest.xml

@@ -184,5 +184,12 @@
 				android:resource="@xml/filepaths"
 			/>
 		</provider>
+
+		<!-- Disable Notifee's BlockStateBroadcastReceiver to prevent crash during cold start -->
+		<!-- This receiver tries to access React Native before it's initialized -->
+		<receiver
+			android:name="app.notifee.core.BlockStateBroadcastReceiver"
+			android:enabled="false"
+			tools:node="remove" />
 	</application>
 </manifest>

app/components/Nav/App/App.tsx

@@ -36,6 +36,9 @@ import ModalConfirmation from '../../../component-library/components/Modals/Moda
 import Toast, {
   ToastContext,
 } from '../../../component-library/components/Toast';
+import PerpsWebSocketHealthToast, {
+  WebSocketHealthToastProvider,
+} from '../../UI/Perps/components/PerpsWebSocketHealthToast';
 import AccountSelector from '../../../components/Views/AccountSelector';
 import AddressSelector from '../../../components/Views/AddressSelector';
 import { TokenSortBottomSheet } from '../../UI/Tokens/TokenSortBottomSheet/TokenSortBottomSheet';
@@ -1276,11 +1279,12 @@ const App: React.FC = () => {
   }, []);
 
   return (
-    <>
+    <WebSocketHealthToastProvider>
       <AppFlow />
       <Toast ref={toastRef} />
+      <PerpsWebSocketHealthToast />
       <ProfilerManager />
-    </>
+    </WebSocketHealthToastProvider>
   );
 };
 

app/components/UI/DeepLinkModal/DeepLinkModal.test.tsx

@@ -143,7 +143,7 @@ describe('DeepLinkModal', () => {
           }),
           build: jest.fn().mockImplementation(function (this: MockBuilder) {
             return {
-              name: 'Deep link Used',
+              name: 'Deep Link Used',
               properties: {
                 route: 'invalid',
                 was_app_installed: true,

app/components/UI/Perps/Perps.testIds.ts

@@ -675,3 +675,12 @@ export const PerpsOrderBookTableSelectorsIDs = {
 export const PerpsOrderBookDepthChartSelectorsIDs = {
   CONTAINER: 'perps-order-book-depth-chart',
 } as const;
+
+// ========================================
+// PERPS WEBSOCKET HEALTH TOAST SELECTORS
+// ========================================
+
+export const PerpsWebSocketHealthToastSelectorsIDs = {
+  TOAST: 'perps-websocket-health-toast',
+  RETRY_BUTTON: 'perps-websocket-health-toast-retry-button',
+} as const;

app/components/UI/Perps/__mocks__/providerMocks.ts

@@ -52,6 +52,10 @@ export const createMockHyperLiquidProvider =
       subscribeToOrders: jest.fn(),
       subscribeToAccount: jest.fn(),
       setUserFeeDiscount: jest.fn(),
+      // WebSocket connection state methods
+      getWebSocketConnectionState: jest.fn(),
+      subscribeToConnectionState: jest.fn().mockReturnValue(() => undefined),
+      reconnect: jest.fn().mockResolvedValue(undefined),
     }) as unknown as jest.Mocked<HyperLiquidProvider>;
 
 export const createMockOrderResult = () => ({

app/components/UI/Perps/components/PerpsStreamBridge.tsx

@@ -1,12 +1,16 @@
 import React from 'react';
 import { usePerpsWithdrawStatus } from '../hooks/usePerpsWithdrawStatus';
 import { usePerpsDepositStatus } from '../hooks/usePerpsDepositStatus';
+import { useWebSocketHealthToast } from '../hooks/useWebSocketHealthToast';
 
 /**
  * PerpsStreamBridge - Bridges stream context to global hooks.
  *
  * This component acts as a bridge, allowing hooks to access the PerpsStream context
  * by being rendered inside both PerpsConnectionProvider and PerpsStreamProvider.
+ *
+ * The WebSocket health toast is rendered at the App level via WebSocketHealthToastProvider
+ * and PerpsWebSocketHealthToast to ensure it appears on top of all other content.
  */
 const PerpsStreamBridge: React.FC = () => {
   // Enable withdrawal status monitoring and toasts
@@ -15,7 +19,9 @@ const PerpsStreamBridge: React.FC = () => {
   // Enable deposit status monitoring and toasts
   usePerpsDepositStatus();
 
-  // This component doesn't render anything
+  // Enable WebSocket health monitoring (toast is rendered at App level)
+  useWebSocketHealthToast();
+
   return null;
 };