release: 7.76.0

.agents/skills/e2e-test/SKILL.md

@@ -66,7 +66,7 @@ Do not read the full reference files until the decision tree or workflow sends y
 5. **Never use `TestHelpers.delay()`** — use `Assertions.*` which has auto-retry
 6. **Use `FixtureBuilder` for state** — do not set state through UI interactions
 7. **Selectors live in `*.testIds.ts`** (co-located) or `tests/selectors/` (legacy)
-8. **Tag correctly** — Use the tag that matches your feature and test type. Options include `SmokeE2E`, `SmokeTrade`, `SmokePredictions`, `SmokePerps`, `SmokeConfirmations`, `RegressionTrade`, `RegressionWallet`, etc. Check **`tests/tags.js`** for the full list and descriptions, and **existing specs in the same feature folder** to see which tag they use.
+8. **Tag correctly** — Use the tag that matches your feature and test type. Options include `SmokeE2E`, `SmokeSwap`, `SmokeStake`, `SmokeMoney`, `SmokePredictions`, `SmokePerps`, `SmokeConfirmations`, `RegressionTrade`, `RegressionWallet`, etc. Check **`tests/tags.js`** for the full list and descriptions, and **existing specs in the same feature folder** to see which tag they use.
 9. **Descriptive test names** — no 'should' prefix (e.g., `'opens market details'`)
 10. **Fix lint/tsc before running** — never run with known errors
 

.agents/skills/e2e-test/references/writing-tests.md

@@ -2,12 +2,12 @@
 
 ## Spec File Location
 
-| Test Type  | Directory                                   | Tag                                                                                    |
-| ---------- | ------------------------------------------- | -------------------------------------------------------------------------------------- |
-| Smoke      | `tests/smoke/<feature>/<name>.spec.ts`      | `SmokeE2E`, `SmokeTrade`, `SmokePredictions`, `SmokePerps`, `SmokeConfirmations`, etc. |
-| Regression | `tests/regression/<feature>/<name>.spec.ts` | `RegressionTrade`, `RegressionWallet`, etc.                                            |
+| Test Type  | Directory                                   | Tag                                                                                                               |
+| ---------- | ------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- |
+| Smoke      | `tests/smoke/<feature>/<name>.spec.ts`      | `SmokeE2E`, `SmokeSwap`, `SmokeStake`, `SmokeMoney`, `SmokePredictions`, `SmokePerps`, `SmokeConfirmations`, etc. |
+| Regression | `tests/regression/<feature>/<name>.spec.ts` | `RegressionTrade`, `RegressionWallet`, etc.                                                                       |
 
-Import tags from `tests/tags.ts`. Check **`tests/tags.js`** for the full list and descriptions. Use the same tag as **existing specs in that feature folder** (e.g. `tests/smoke/predict/` uses `SmokeTrade`).
+Import tags from `tests/tags.ts`. Check **`tests/tags.js`** for the full list and descriptions. Use the same tag as **existing specs in that feature folder** (e.g. `tests/smoke/swap/` uses `SmokeSwap`, `tests/smoke/stake/` uses `SmokeStake`, `tests/smoke/card/` and `tests/smoke/ramps/` use `SmokeMoney`).
 
 ## Minimal Smoke Spec
 

.depcheckrc.yml

@@ -134,6 +134,8 @@ ignores:
   - '@types/react-test-renderer'
   # runtime for dependecies using Nitro Modules (@metamask/native-utils)
   - 'react-native-nitro-modules'
+  # Jest `jest.mock('react-native-worklets', …, { virtual: true })` in testSetup only; not a root dependency
+  - 'react-native-worklets'
 
   # Used in Yarn plugin for preview builds
   - '@yarnpkg/core'

.e2e.env.example

@@ -22,6 +22,12 @@ export PREBUILT_IOS_APP_PATH='build/MetaMask.app'
 export PREBUILT_ANDROID_APK_PATH='build/MetaMask.apk'
 export PREBUILT_ANDROID_TEST_APK_PATH='build/MetaMask-Test.apk'
 
+# Playwright local emulator (EmulatorProvider): when use.app.buildPath is set, global setup
+# normally runs adb / simctl uninstall+install. Set to true to skip that (e.g. faster iteration).
+# true | 1 | yes = skip reinstall. false | 0 | no | unset = reinstall (default).
+# export SKIP_APP_REINSTALL=true
+export SKIP_APP_REINSTALL=false
+
 export TEST_SRP_1=
 export TEST_SRP_2=
 export TEST_SRP_3=

.eslintrc.js

@@ -467,17 +467,32 @@ module.exports = {
     },
     {
       files: ['app/**/*.{ts,tsx}'],
-      excludedFiles: ['app/controllers/perps/**/*.{ts,tsx}'],
+      excludedFiles: [
+        'app/controllers/perps/**/*.{ts,tsx}',
+        'app/util/haptics/**/*.{ts,tsx}',
+      ],
       rules: {
         'no-restricted-imports': [
           'error',
           {
+            paths: [
+              {
+                name: 'expo-haptics',
+                message:
+                  'Import from app/util/haptics instead of expo-haptics directly.',
+              },
+            ],
             patterns: [
               {
                 group: ['**/controllers/perps', '**/controllers/perps/**'],
                 message:
                   'Use @metamask/perps-controller instead of relative imports into app/controllers/perps/.',
               },
+              {
+                group: ['expo-haptics/*'],
+                message:
+                  'Import from app/util/haptics instead of expo-haptics directly.',
+              },
             ],
           },
         ],

.github/CODEOWNERS

@@ -336,7 +336,7 @@ tests/websocket/                                                @MetaMask/qa
 # QA Team - CI
 .github/actions/smart-e2e-selection/                            @MetaMask/qa
 .github/workflows/ai-pr-risk-analysis.yml                       @MetaMask/qa
-.github/workflows/needs-e2e-build.yml                           @MetaMask/qa
+.github/workflows/auto-label-not-ready-for-e2e.yml              @MetaMask/qa
 .github/workflows/run-e2e-workflow.yml                          @MetaMask/qa
 .github/workflows/run-e2e-api-specs.yml                         @MetaMask/qa
 .github/workflows/run-e2e-regression-tests-android.yml          @MetaMask/qa

.github/actions/setup-e2e-env/action.yml

@@ -113,56 +113,126 @@ runs:
         distribution: ${{ inputs.jdk-distribution }}
 
     - name: Install required emulator dependencies
-      if: ${{ inputs.platform == 'android' && runner.os == 'Linux' }}
+      if: ${{ inputs.platform == 'android' && inputs.setup-simulator == 'true' && runner.os == 'Linux' }}
+      uses: nick-fields/retry@ce71cc2ab81d554ebbe88c79ab5975992d79ba08 #v3.0.2
+      with:
+        timeout_minutes: 3
+        max_attempts: 3
+        retry_wait_seconds: 30
+        on_retry_command: sudo apt-get clean
+        command: |
+          set -euo pipefail
+          sudo apt-get -o DPkg::Lock::Timeout=120 update
+          sudo apt-get -o DPkg::Lock::Timeout=120 install -y \
+            libpulse0 \
+            libglu1-mesa \
+            libnss3 \
+            libxss1
+          echo "✅ Linux dependencies installed successfully"
+
+    ## Android System Image Setup (only when simulator/emulator is needed)
+
+    # Prepare SDK directories for cache restore
+    - name: Prepare Android SDK directories for cache
+      if: ${{ inputs.platform == 'android' && inputs.setup-simulator == 'true' }}
+      env:
+        CACHE_PATH: /opt/android-sdk/system-images/android-${{ inputs.android-api-level }}/${{ inputs.android-tag }}/${{ inputs.android-abi }}
       run: |
-        sudo apt-get update
-        sudo apt-get install -y \
-          libpulse0 \
-          libglu1-mesa \
-          libnss3 \
-          libxss1
-
-        echo "✅ Linux dependencies installed successfully"
+        set -euo pipefail
+        sudo mkdir -p "$CACHE_PATH" /opt/android-sdk/.temp
+        sudo chown -R "$(id -u):$(id -g)" "$CACHE_PATH" /opt/android-sdk/.temp
       shell: bash
 
-    ## Android SDK Setup (SDK pre-installed in container)
+    # Restore exact system image from cache
+    - name: Restore Android system image from cache
+      if: ${{ inputs.platform == 'android' && inputs.setup-simulator == 'true' }}
+      id: android-system-image-cache
+      uses: actions/cache/restore@v4
+      with:
+        path: /opt/android-sdk/system-images/android-${{ inputs.android-api-level }}/${{ inputs.android-tag }}/${{ inputs.android-abi }}
+        key: android-system-image-v1-${{ runner.os }}-api${{ inputs.android-api-level }}-${{ inputs.android-tag }}-${{ inputs.android-abi }}
 
-    - name: Install additional Android SDK components if needed
-      if: ${{ inputs.platform == 'android' && (inputs.android-api-level != '34' || inputs.android-abi != 'x86_64') }}
+    # Install the requested system image with retry and cleanup
+    - name: Prepare Android system image
+      if: ${{ inputs.platform == 'android' && inputs.setup-simulator == 'true' }}
+      id: prepare-android-system-image
       env:
         ANDROID_API_LEVEL: ${{ inputs.android-api-level }}
+        ANDROID_TAG: ${{ inputs.android-tag }}
         ANDROID_ABI: ${{ inputs.android-abi }}
       run: |
-        IMAGE="system-images;android-$ANDROID_API_LEVEL;google_apis;$ANDROID_ABI"
-        echo "Installing additional system image: $IMAGE"
-        echo "y" | "/opt/android-sdk/cmdline-tools/latest/bin/sdkmanager" "$IMAGE"
+        set -euo pipefail
+        SDKMANAGER="/opt/android-sdk/cmdline-tools/latest/bin/sdkmanager"
+        IMAGE_PACKAGE="system-images;android-$ANDROID_API_LEVEL;$ANDROID_TAG;$ANDROID_ABI"
+        IMAGE_DIR="/opt/android-sdk/system-images/android-$ANDROID_API_LEVEL/$ANDROID_TAG/$ANDROID_ABI"
+
+        if [ -f "$IMAGE_DIR/package.xml" ] || [ -f "$IMAGE_DIR/source.properties" ]; then
+          echo "System image already installed: $IMAGE_PACKAGE"
+          echo "image-package=$IMAGE_PACKAGE" >> "$GITHUB_OUTPUT"
+          exit 0
+        fi
+
+        for attempt in 1 2 3; do
+          echo "Installing system image (attempt $attempt/3): $IMAGE_PACKAGE"
+          if echo "y" | "$SDKMANAGER" "$IMAGE_PACKAGE" 2>&1; then
+            if [ -f "$IMAGE_DIR/package.xml" ] || [ -f "$IMAGE_DIR/source.properties" ]; then
+              echo "image-package=$IMAGE_PACKAGE" >> "$GITHUB_OUTPUT"
+              exit 0
+            fi
+          else
+            find /opt/android-sdk/.temp -type f -name '*.zip' -exec unzip -t {} \; || true
+          fi
+          rm -rf "$IMAGE_DIR"
+          find /opt/android-sdk/.temp -mindepth 1 -maxdepth 1 -exec rm -rf -- {} + || true
+          sleep 10
+        done
+
+        echo "::error::Failed to install Android system image: $IMAGE_PACKAGE"
+        exit 1
       shell: bash
 
-    ## Launch AVD
+    # Save system image cache (only on trusted refs, only if no cache hit)
+    - name: Save Android system image to cache
+      if: >-
+        ${{
+          inputs.platform == 'android' &&
+          inputs.setup-simulator == 'true' &&
+          steps.android-system-image-cache.outputs.cache-hit != 'true' &&
+          github.event_name != 'pull_request' &&
+          github.event_name != 'pull_request_target' &&
+          github.event_name != 'merge_group' &&
+          github.ref == 'refs/heads/main'
+        }}
+      uses: actions/cache/save@v4
+      with:
+        path: /opt/android-sdk/system-images/android-${{ inputs.android-api-level }}/${{ inputs.android-tag }}/${{ inputs.android-abi }}
+        key: android-system-image-v1-${{ runner.os }}-api${{ inputs.android-api-level }}-${{ inputs.android-tag }}-${{ inputs.android-abi }}
+
+    ## Launch AVD (only when simulator/emulator is needed)
 
     - name: Set ANDROID_AVD_HOME for downstream steps
-      if: ${{ inputs.platform == 'android'}}
+      if: ${{ inputs.platform == 'android' && inputs.setup-simulator == 'true' }}
       shell: bash
       run: |
         echo "ANDROID_AVD_HOME=$HOME/.android/avd" >> "$GITHUB_ENV"
         mkdir -p "$HOME/.android/avd"
 
     - name: Create Android Virtual Device (AVD)
-      if: ${{ inputs.platform == 'android'}}
+      if: ${{ inputs.platform == 'android' && inputs.setup-simulator == 'true' }}
       env:
-        ANDROID_API_LEVEL: ${{ inputs.android-api-level }}
         ANDROID_TAG: ${{ inputs.android-tag }}
         ANDROID_ABI: ${{ inputs.android-abi }}
         ANDROID_AVD_NAME: ${{ inputs.android-avd-name }}
         ANDROID_DEVICE: ${{ inputs.android-device }}
         ANDROID_SDCARD_SIZE: ${{ inputs.android-sdcard-size }}
+        IMAGE_PACKAGE: ${{ steps.prepare-android-system-image.outputs.image-package }}
       run: |
-        IMAGE="system-images;android-$ANDROID_API_LEVEL;$ANDROID_TAG;$ANDROID_ABI"
-        echo "Creating AVD with image: $IMAGE"
+        set -euo pipefail
+        echo "Creating AVD with image: $IMAGE_PACKAGE"
         "/opt/android-sdk/cmdline-tools/latest/bin/avdmanager" --verbose create avd \
           --force \
           --name "$ANDROID_AVD_NAME" \
-          --package "$IMAGE" \
+          --package "$IMAGE_PACKAGE" \
           --device "$ANDROID_DEVICE" \
           --tag "$ANDROID_TAG" \
           --abi "$ANDROID_ABI" \
@@ -220,6 +290,7 @@ runs:
         timeout_minutes: 15
         max_attempts: 3
         retry_wait_seconds: 30
+        on_retry_command: echo "⚠️ yarn install failed — likely a transient network issue on the self-hosted runner. Retrying..."
         command: yarn install --immutable
       env:
         NODE_OPTIONS: --max-old-space-size=4096