release: 7.72.0 (#27990)

# 🚀 v7.72.0 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
- [x] Accounts
- [x] Assets
- [x] Bots Team
- [x] Card
- [x] Confirmations
- [x] Core Platform
- [x] Design System
- [x] Earn
- [x] Engagement
- [x] Mobile Platform
- [x] Mobile UX
- [x] Money Movement
- [x] Networks
- [x] Onboarding
- [x] Perps
- [x] Predict
- [x] Product Safety
- [x] Rewards
- [x] Social & AI
- [x] Swaps and Bridge
- [x] team-network-enablement
- [x] team-ramp
- [x] Transactions
- [x] Wallet Integrations

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: chloeYue

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

@@ -89,10 +89,10 @@ Step 5 → Iterate (fix → lint → run) until green
 
 Documentation is split by **action**. Open only the reference that matches what you are doing.
 
-| Action                                        | File                                                       | When to open it                                                                                   |
-| --------------------------------------------- | ---------------------------------------------------------- | ------------------------------------------------------------------------------------------------- |
-| **Writing or updating a spec**                | [references/writing-tests.md](references/writing-tests.md) | New spec file, spec structure, FixtureBuilder patterns, smoke/regression templates.               |
-| **Page Objects and selectors**                | [references/page-objects.md](references/page-objects.md)   | Create or update POM classes, selector/testId conventions, Matchers/Gestures/Assertions API.      |
-| **API and feature flag mocking**              | [references/mocking.md](references/mocking.md)             | testSpecificMock, setupRemoteFeatureFlagsMock, setupMockRequest, shared mock files.               |
+| Action                                        | File                                                                | When to open it                                                                                                    |
+| --------------------------------------------- | ------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
+| **Writing or updating a spec**                | [references/writing-tests.md](references/writing-tests.md)          | New spec file, spec structure, FixtureBuilder patterns, smoke/regression templates.                                |
+| **Page Objects and selectors**                | [references/page-objects.md](references/page-objects.md)            | Create or update POM classes, selector/testId conventions, Matchers/Gestures/Assertions API.                       |
+| **API and feature flag mocking**              | [references/mocking.md](references/mocking.md)                      | testSpecificMock, setupRemoteFeatureFlagsMock, setupMockRequest, shared mock files.                                |
 | **MetaMetrics / analytics expectations**      | [tests/docs/analytics-e2e.md](../../../tests/docs/analytics-e2e.md) | `analyticsExpectations` on `withFixtures`, declarative checks, presets in `tests/helpers/analytics/expectations/`. |
-| **Running tests, debugging, fixing failures** | [references/running-tests.md](references/running-tests.md) | Build check, detox run commands, lint/tsc, common failures table, retry patterns, iteration loop. |
+| **Running tests, debugging, fixing failures** | [references/running-tests.md](references/running-tests.md)          | Build check, detox run commands, lint/tsc, common failures table, retry patterns, iteration loop.                  |

.agents/skills/repo-skill-authoring/SKILL.md

@@ -0,0 +1,137 @@
+---
+name: repo-skill-authoring
+description: Create and update repo-local skills that follow the MetaMask Mobile standard. Use for new repo-local skills, skill entrypoints, or harness shims in this repository.
+---
+
+# Repo Skill Authoring
+
+Canonical guidance for creating and updating repo-local skills in MetaMask Mobile.
+
+## Purpose
+
+Use this standard when the repo needs a reusable agent workflow with stable instructions, validation, or harness shims.
+
+Do not create a skill when one of these is enough:
+
+- `AGENTS.md` or a narrow `tests/AGENTS.md` pointer
+- Existing product or engineering docs in `docs/`
+- A one-off prompt that does not need to be reused
+
+Create a skill when the work is repeated, fragile, or benefits from a shared workflow across agents.
+
+## When To Use This vs Native Skill Creator
+
+Use the native or harness-provided `skill-creator` guidance for general skill design principles or when creating a skill outside this repository.
+
+Use `repo-skill-authoring` for any MetaMask Mobile repo-local skill that should live in `.agents/skills/`, `.claude/`, or other repo-owned harness folders.
+
+If both apply, use native `skill-creator` for general design guidance, and use this skill as the source of truth for repository-specific structure, naming, and entrypoints.
+
+## Harness Entrypoints
+
+Use these entrypoints:
+
+- Codex skill entrypoint: `.agents/skills/repo-skill-authoring/SKILL.md` (`$repo-skill-authoring`)
+- Claude skill entrypoint: `.claude/skills/repo-skill-authoring/SKILL.md`
+
+## Repo Skill Shape
+
+Required shape for a repo-local skill:
+
+```text
+.agents/skills/<skill-name>/SKILL.md
+.agents/skills/<skill-name>/agents/openai.yaml
+```
+
+Optional shape, when the workflow needs it:
+
+```text
+.agents/skills/<skill-name>/scripts/
+.agents/skills/<skill-name>/references/
+.agents/skills/<skill-name>/assets/
+.claude/skills/<skill-name>/SKILL.md
+```
+
+Keep `.agents/skills/<name>/SKILL.md` as the single source of truth. Any harness-specific shim should point directly to it.
+
+## Naming And Trigger Rules
+
+- Skill folder names use lowercase letters, digits, and hyphens only.
+- The folder name and `SKILL.md` frontmatter `name` must match exactly.
+- The Codex `description` must say what the skill does and when to use it.
+- Prefer names that describe the reusable workflow, not the implementation detail.
+- Keep the skill focused on repo-local conventions that are not already handled by generic guidance.
+
+## Agent Execution Standard
+
+For agent implementation and review tasks, follow this workflow:
+
+1. Define the user/problem shape.
+   - Write down the jobs the skill should handle.
+   - Prefer concrete trigger phrases and in-scope task examples.
+2. Split the content deliberately.
+   - Put the canonical workflow, conventions, and examples in this `SKILL.md`.
+   - Add `scripts/` only when deterministic validation or repeated logic is worth the maintenance cost.
+   - Add `references/` only when detailed content should be loaded on demand instead of sitting in the skill body.
+3. Add the skill entrypoint.
+   - Include frontmatter `name` and `description`.
+   - Keep this file readable by both agents and humans.
+4. Add the minimum harness shims required.
+   - Add `.claude/skills/<name>/SKILL.md` when Claude needs a pointer.
+   - Point every shim directly back to `.agents/skills/<name>/SKILL.md`.
+5. Sanity check the result.
+   - Confirm the skill and any shims all point to the same workflow.
+
+Authoring principle:
+
+- Keep the repo skill as the canonical artifact. Avoid extra pointer layers unless they materially improve discovery or ergonomics.
+
+Required agent response sections:
+
+1. `Implementation Checklist`
+2. `Files To Add Or Modify`
+3. `Validation`
+4. `Assumptions`
+
+## Minimal Examples
+
+### Canonical Repo Skill
+
+```md
+---
+name: topic
+description: Create and update the repo-local topic workflow. Use for new skill content or harness shims in this repository.
+---
+
+# Topic
+
+## Purpose
+
+Explain when this repo-local skill is needed and when existing repo docs are enough.
+
+## Agent Execution Standard
+
+1. Discover current implementation.
+2. Apply repo-specific workflow.
+3. Confirm any shims stay aligned.
+```
+
+### Claude Skill Shim
+
+```md
+---
+name: topic
+summary: Create or update the repo-local topic workflow.
+---
+
+Follow `.agents/skills/topic/SKILL.md`.
+```
+
+### agents/openai.yaml
+
+```yaml
+interface:
+  display_name: 'Topic'
+  short_description: 'Create and validate the repo-local topic workflow.'
+  default_prompt: 'Use $topic to create or update the canonical repo-local topic workflow.'
+```

.agents/skills/repo-skill-authoring/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Repo Skill Authoring"
+  short_description: "Create and validate repo-local skills."
+  default_prompt: "Use $repo-skill-authoring to create or update the canonical repo-local skill and any necessary harness shims."

.android.env.example

@@ -2,3 +2,5 @@ export MM_FOX_CODE="EXAMPLE_FOX_CODE"
 export MM_BRANCH_KEY_TEST=
 export MM_BRANCH_KEY_LIVE=
 export METAMASK_BUILD_TYPE=
+export MM_BRAZE_API_KEY_ANDROID=
+export MM_BRAZE_SDK_ENDPOINT="sdk.iad-07.braze.com"

.claude/skills/repo-skill-authoring/SKILL.md

@@ -0,0 +1,6 @@
+---
+name: repo-skill-authoring
+summary: Create or update repo-local skills using the repository standard.
+---
+
+Follow `.agents/skills/repo-skill-authoring/SKILL.md`.

.cursor/rules/unit-testing-guidelines.mdc

@@ -234,6 +234,66 @@ See [PR #25548](https://github.com/MetaMask/metamask-mobile/pull/25548) for refa
 - **Mock all external dependencies** including APIs, services, hooks
 - **Use realistic mock data** that reflects real usage
 
+### Theme Mocking Rules
+
+- **Prefer shared `mockTheme` from `app/util/theme`** instead of hard-coded color literals in tests.
+- **Never hardcode design token hex values** in assertions or theme mocks (enforced by `@metamask/design-tokens/color-no-hex`).
+- **Avoid local hex color objects** for `useTheme`, `useStyles`, or tailwind mock color functions.
+- **If a test only needs a specific theme field**, derive it from `mockTheme` (or spread `mockTheme` and override minimally).
+
+```ts
+// ✅ CORRECT: use shared mockTheme for useTheme mocks
+import { mockTheme } from '../../util/theme';
+
+jest.mock('../../util/theme', () => ({
+  useTheme: () => mockTheme,
+}));
+```
+
+```ts
+// ✅ CORRECT: return { styles, theme } for useStyles mocks
+import { mockTheme } from '../../util/theme';
+
+jest.mock('../../../../../component-library/hooks', () => ({
+  useStyles: jest.fn((styleFn, vars) => ({
+    styles: styleFn({ theme: mockTheme, vars }),
+    theme: mockTheme,
+  })),
+}));
+```
+
+```ts
+// ✅ CORRECT: mock useTailwind with the right shape
+jest.mock('@metamask/design-system-twrnc-preset', () => ({
+  useTailwind: () => ({
+    // Most components only need tw.style(...)
+    style: jest.fn(() => ({})),
+  }),
+}));
+```
+
+```ts
+// ✅ ALSO CORRECT: match real useTailwind() return type (callable function + helpers)
+import { mockTheme } from '../../util/theme';
+
+jest.mock('@metamask/design-system-twrnc-preset', () => ({
+  useTailwind: () => {
+    const tw = () => ({});
+    tw.style = jest.fn(() => ({}));
+    return tw;
+  },
+}));
+```
+
+```ts
+// ❌ AVOID: local hex color mocks
+const mockColors = {
+  text: { default: '#000000' },
+  background: { default: '#FFFFFF' },
+  border: { muted: '#E5E7EB' },
+};
+```
+
 ```ts
 // ✅ CORRECT
 import { apiService } from '../services/api';

.eslintrc.js

@@ -181,12 +181,67 @@ module.exports = {
     },
     {
       files: [
+        // @MetaMask/card
         'app/components/UI/Card/**/*.{js,jsx,ts,tsx}',
+        // @MetaMask/core-platform
         'app/components/Snaps/**/*.{js,jsx,ts,tsx}',
+        // @MetaMask/predict
         'app/components/UI/Predict/**/*.{js,jsx,ts,tsx}',
+        // @MetaMask/ramp
         'app/components/UI/Ramp/**/*.{js,jsx,ts,tsx}',
+        // @MetaMask/rewards
         'app/components/UI/Rewards/**/*.{js,jsx,ts,tsx}',
+        // @MetaMask/perps
         'app/components/UI/Perps/**/*.{js,jsx,ts,tsx}',
+        // @MetaMask/metamask-earn
+        'app/components/UI/Earn/**/*.{js,jsx,ts,tsx}',
+        'app/components/UI/Stake/**/*.{js,jsx,ts,tsx}',
+        // @MetaMask/metamask-assets
+        'app/components/UI/Assets/**/*.{js,jsx,ts,tsx}',
+        'app/components/UI/Tokens/**/*.{js,jsx,ts,tsx}',
+        'app/components/UI/AssetOverview/**/*.{js,jsx,ts,tsx}',
+        'app/components/UI/Collectibles/**/*.{js,jsx,ts,tsx}',
+        'app/components/UI/CollectibleContractElement/**/*.{js,jsx,ts,tsx}',
+        'app/components/UI/CollectibleContractInformation/**/*.{js,jsx,ts,tsx}',
+        'app/components/UI/CollectibleContractOverview/**/*.{js,jsx,ts,tsx}',
+        'app/components/UI/CollectibleContracts/**/*.{js,jsx,ts,tsx}',
+        'app/components/UI/CollectibleDetectionModal/**/*.{js,jsx,ts,tsx}',
+        'app/components/UI/CollectibleMedia/**/*.{js,jsx,ts,tsx}',
+        'app/components/UI/CollectibleModal/**/*.{js,jsx,ts,tsx}',
+        'app/components/UI/CollectibleOverview/**/*.{js,jsx,ts,tsx}',
+        'app/components/UI/ConfirmAddAsset/**/*.{js,jsx,ts,tsx}',
+        'app/components/UI/DeFiPositions/**/*.{js,jsx,ts,tsx}',
+        'app/components/UI/TokenDetails/**/*.{js,jsx,ts,tsx}',
+        'app/components/Views/AddAsset/**/*.{js,jsx,ts,tsx}',
+        'app/components/Views/Asset/**/*.{js,jsx,ts,tsx}',
+        'app/components/Views/AssetDetails/**/*.{js,jsx,ts,tsx}',
+        'app/components/Views/AssetHideConfirmation/**/*.{js,jsx,ts,tsx}',
+        'app/components/Views/AssetOptions/**/*.{js,jsx,ts,tsx}',
+        'app/components/Views/Collectible/**/*.{js,jsx,ts,tsx}',
+        'app/components/Views/CollectibleView/**/*.{js,jsx,ts,tsx}',
+        'app/components/Views/DetectedTokens/**/*.{js,jsx,ts,tsx}',
+        'app/components/Views/NFTAutoDetectionModal/**/*.{js,jsx,ts,tsx}',
+        'app/components/Views/NftDetails/**/*.{js,jsx,ts,tsx}',
+        // @MetaMask/mobile-core-ux
+        'app/components/Views/AccountActions/**/*.{js,jsx,ts,tsx}',
+        'app/components/Views/AccountSelector/**/*.{js,jsx,ts,tsx}',
+        'app/components/Views/AccountsMenu/**/*.{js,jsx,ts,tsx}',
+        'app/components/Views/AddressQRCode/**/*.{js,jsx,ts,tsx}',
+        'app/components/Views/EditAccountName/**/*.{js,jsx,ts,tsx}',
+        'app/components/Views/LockScreen/**/*.{js,jsx,ts,tsx}',
+        'app/components/Views/Login/**/*.{js,jsx,ts,tsx}',
+        'app/components/Views/MultichainTransactionsView/**/*.{js,jsx,ts,tsx}',
+        'app/components/Views/NetworkConnect/**/*.{js,jsx,ts,tsx}',
+        'app/components/Views/NetworkSelector/**/*.{js,jsx,ts,tsx}',
+        'app/components/Views/QRAccountDisplay/**/*.{js,jsx,ts,tsx}',
+        'app/components/Views/QRScanner/**/*.{js,jsx,ts,tsx}',
+        'app/components/Views/Settings/**/*.{js,jsx,ts,tsx}',
+        'app/components/Views/TermsAndConditions/**/*.{js,jsx,ts,tsx}',
+        'app/components/Views/UnifiedTransactionsView/**/*.{js,jsx,ts,tsx}',
+        'app/components/UI/MultichainTransactionListItem/**/*.{js,jsx,ts,tsx}',
+        'app/components/UI/TransactionActionModal/**/*.{js,jsx,ts,tsx}',
+        'app/components/UI/TransactionElement/**/*.{js,jsx,ts,tsx}',
+        'app/components/UI/Transactions/**/*.{js,jsx,ts,tsx}',
       ],
       rules: {
         '@metamask/design-tokens/color-no-hex': 'error',

.github/CODEOWNERS

@@ -154,6 +154,8 @@ app/core/Engine/messengers/earn-controller-messenger @MetaMask/metamask-earn
 app/selectors/earnController         @MetaMask/metamask-earn
 **/Earn/**                           @MetaMask/metamask-earn
 **/earn/**                           @MetaMask/metamask-earn
+**/Money/**                          @MetaMask/metamask-earn
+**/money/**                          @MetaMask/metamask-earn
 
 # Rewards Team
 app/core/Engine/controllers/rewards-controller @MetaMask/rewards
@@ -164,6 +166,7 @@ app/selectors/featureFlagController/rewards @MetaMask/rewards
 **/rewards/**                        @MetaMask/rewards
 
 # Perps Team
+scripts/perps/agentic/teams/perps/   @MetaMask/perps
 app/components/UI/Perps/             @MetaMask/perps
 app/components/UI/WalletAction/*perps* @MetaMask/perps
 app/core/Engine/controllers/perps-controller @MetaMask/perps
@@ -187,6 +190,7 @@ app/core/DeeplinkManager/handlers/legacy/handlePredictUrl.ts  @MetaMask/predict
 app/components/hooks/useIsOriginalNativeTokenSymbol @MetaMask/metamask-assets
 app/components/hooks/useTokenBalancesController @MetaMask/metamask-assets
 app/components/hooks/useTokenBalance.tsx @MetaMask/metamask-assets
+app/components/hooks/useTokensData @MetaMask/metamask-assets
 app/components/hooks/useSafeChains.ts @MetaMask/metamask-assets
 app/components/UI/Assets @MetaMask/metamask-assets
 app/components/UI/AssetOverview @MetaMask/metamask-assets