Skip to content

Conversation

@metamaskbot
Copy link
Collaborator

@metamaskbot metamaskbot commented Dec 24, 2025

🚀 v7.61.5 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


Note

Release bump to 7.61.5

  • Updates versionName/versionCode in Android, MARKETING_VERSION/CURRENT_PROJECT_VERSION in iOS, Bitrise env vars, package.json, and CHANGELOG.md

Deeplink robustness and security

  • Enforces that external transactions cannot use INTERNAL_ORIGINS in handleMetaMaskDeeplink.ts and connectWithWC.ts
  • Minor refactor to consistently use channelId local variable in deeplink handling

Transaction auto-sign flow

  • In RootRPCMethodsUI, only auto-signs for hardware accounts (ledger or qr); early return for others; maintains Ledger handoff to confirmation flow

Written by Cursor Bugbot for commit 8eec71f. This will update automatically on new commits. Configure here.

@github-actions
Copy link
Contributor

CLA Signature Action: All authors have signed the CLA. You may need to manually re-run the blocking PR check if it doesn't pass in a few minutes.

@metamaskbot metamaskbot added the team-bots Bot team (for MetaMask Bot, Runway Bot, etc.) label Dec 24, 2025
@socket-security
Copy link

socket-security bot commented Dec 24, 2025

No dependency changes detected. Learn more about Socket for GitHub.

👍 No dependency changes detected in pull request

@metamaskbot metamaskbot added the release-7.61.5 Issue or pull request that will be included in release 7.61.5 label Dec 24, 2025
tommasini and others added 2 commits December 24, 2025 04:07
<!--
Please submit this PR as a draft initially.
Do not mark it as "Ready for review" until the template has been
completely filled out, and PR status checks have passed at least once.
-->

## **Description**
More robust deeplinking
<!--
Write a short description of the changes included in this pull request,
also include relevant motivation and context. Have in mind the following
questions:
1. What is the reason for the change?
2. What is the improvement/solution?
-->

## **Changelog**

<!--
If this PR is not End-User-Facing and should not show up in the
CHANGELOG, you can choose to either:
1. Write `CHANGELOG entry: null`
2. Label with `no-changelog`

If this PR is End-User-Facing, please write a short User-Facing
description in the past tense like:
`CHANGELOG entry: Added a new tab for users to see their NFTs`
`CHANGELOG entry: Fixed a bug that was causing some NFTs to flicker`

(This helps the Release Engineer do their job more quickly and
accurately)
-->

CHANGELOG entry:

## **Related issues**

Fixes:

## **Manual testing steps**

```gherkin
Feature: my feature name

  Scenario: user [verb for user action]
    Given [describe expected initial app state]

    When user [verb for user action]
    Then [describe expected outcome]
```

## **Screenshots/Recordings**

<!-- If applicable, add screenshots and/or recordings to visualize the
before and after of your change. -->

### **Before**

<!-- [screenshots/recordings] -->

### **After**

<!-- [screenshots/recordings] -->

## **Pre-merge author checklist**

- [ ] I’ve followed [MetaMask Contributor
Docs](https://github.com/MetaMask/contributor-docs) and [MetaMask Mobile
Coding
Standards](https://github.com/MetaMask/metamask-mobile/blob/main/.github/guidelines/CODING_GUIDELINES.md).
- [ ] I've completed the PR template to the best of my ability
- [ ] I’ve included tests if applicable
- [ ] I’ve documented my code using [JSDoc](https://jsdoc.app/) format
if applicable
- [ ] I’ve applied the right labels on the PR (see [labeling
guidelines](https://github.com/MetaMask/metamask-mobile/blob/main/.github/guidelines/LABELING_GUIDELINES.md)).
Not required for external contributors.

## **Pre-merge reviewer checklist**

- [ ] I've manually tested the PR (e.g. pull and build branch, run the
app, test code being changed).
- [ ] I confirm that this PR addresses all acceptance criteria described
in the ticket it closes and includes the necessary testing evidence such
as recordings and or screenshots.

<!-- CURSOR_SUMMARY -->
---

> [!NOTE]
> Strengthens deeplink safety by rejecting internal-origin channelIds
for external flows.
> 
> - Adds `INTERNAL_ORIGINS` validation in `connectWithWC` and
`handleMetaMaskDeeplink`; throws on internal-origin `channelId`
> - Refactors to derive `channelId` once and pass it to
`handleConnection`, `handleDeeplink`, and `handleMessage`
> - No other behavior changes intended
> 
> <sup>Written by [Cursor
Bugbot](https://cursor.com/dashboard?tab=bugbot) for commit
925feac. This will update automatically
on new commits. Configure
[here](https://cursor.com/dashboard?tab=bugbot).</sup>
<!-- /CURSOR_SUMMARY -->
Cal-L
Cal-L previously approved these changes Dec 24, 2025
Copy link
Contributor

@Cal-L Cal-L left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@weitingsun weitingsun marked this pull request as ready for review December 24, 2025 18:09
@weitingsun weitingsun requested review from a team as code owners December 24, 2025 18:09
@metamaskbot metamaskbot dismissed Cal-L’s stale review December 24, 2025 18:24

The merge-base changed after approval.

<!--
Please submit this PR as a draft initially.
Do not mark it as "Ready for review" until the template has been
completely filled out, and PR status checks have passed at least once.
-->

## **Description**
Refine hardware signing flow 

## **Changelog**

<!--
If this PR is not End-User-Facing and should not show up in the
CHANGELOG, you can choose to either:
1. Write `CHANGELOG entry: null`
2. Label with `no-changelog`

If this PR is End-User-Facing, please write a short User-Facing
description in the past tense like:
`CHANGELOG entry: Added a new tab for users to see their NFTs`
`CHANGELOG entry: Fixed a bug that was causing some NFTs to flicker`

(This helps the Release Engineer do their job more quickly and
accurately)
-->

CHANGELOG entry:null

## **Related issues**

Fixes:

## **Manual testing steps**

```gherkin
Feature: my feature name

  Scenario: user [verb for user action]
    Given [describe expected initial app state]

    When user [verb for user action]
    Then [describe expected outcome]
```

## **Screenshots/Recordings**

<!-- If applicable, add screenshots and/or recordings to visualize the
before and after of your change. -->

### **Before**

<!-- [screenshots/recordings] -->

### **After**

<!-- [screenshots/recordings] -->

Performing unified swaps and bridge

https://github.com/user-attachments/assets/224ccca4-bf1a-421b-8c35-6e33489755dc


## **Pre-merge author checklist**

- [ ] I’ve followed [MetaMask Contributor
Docs](https://github.com/MetaMask/contributor-docs) and [MetaMask Mobile
Coding
Standards](https://github.com/MetaMask/metamask-mobile/blob/main/.github/guidelines/CODING_GUIDELINES.md).
- [ ] I've completed the PR template to the best of my ability
- [ ] I’ve included tests if applicable
- [ ] I’ve documented my code using [JSDoc](https://jsdoc.app/) format
if applicable
- [ ] I’ve applied the right labels on the PR (see [labeling
guidelines](https://github.com/MetaMask/metamask-mobile/blob/main/.github/guidelines/LABELING_GUIDELINES.md)).
Not required for external contributors.

## **Pre-merge reviewer checklist**

- [ ] I've manually tested the PR (e.g. pull and build branch, run the
app, test code being changed).
- [ ] I confirm that this PR addresses all acceptance criteria described
in the ticket it closes and includes the necessary testing evidence such
as recordings and or screenshots.


<!-- CURSOR_SUMMARY -->
---

> [!NOTE]
> **Hardware signing flow refinement**
> 
> - In `RootRPCMethodsUI.autoSign`, detect `Ledger` and `QR` hardware
accounts and only auto-sign for those; non-hardware accounts return
early
> - Ledger transactions now navigate to the Ledger transaction
confirmation modal; QR accounts proceed via
`Engine.acceptPendingApproval`
> - Notes that unified swaps/bridge no longer use this path; maintains
transaction finish/confirm listeners and swaps metrics handling
> 
> **Changelog updates**
> 
> - Adds `7.61.3`, `7.61.4`, `7.61.5` sections and updates compare links
> 
> <sup>Written by [Cursor
Bugbot](https://cursor.com/dashboard?tab=bugbot) for commit
1761028. This will update automatically
on new commits. Configure
[here](https://cursor.com/dashboard?tab=bugbot).</sup>
<!-- /CURSOR_SUMMARY -->
shouldShowTronReviewButton && renderReviewButton(isReviewButtonDisabled)
///: END:ONLY_INCLUDE_IF
}
{!isTronEnabled && renderReviewButton(isReviewButtonDisabled)}
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Undefined variables crash non-Tron builds

The variables isTronEnabled and isTronNative are only declared inside ONLY_INCLUDE_IF(tron) preprocessor blocks, but they're used outside these blocks at lines 204, 961, and 1075 in EarnInputView.tsx, and lines 198, 209, and 950 in EarnWithdrawInputView.tsx. In non-Tron builds where the preprocessor removes those blocks, accessing these undeclared variables will throw a ReferenceError, crashing the app. The code already has properly-scoped wrapper variables (showTronStakingUI, showTronUnstakingUI) initialized with fallback values that could be used instead.

Additional Locations (2)

Fix in Cursor Fix in Web

isOverMaximum.isOverMaximumEth ||
!isNonZeroAmount ||
(isTronNative ? isTronStakeValidating : isLoadingEarnGasFee) ||
isSubmittingStakeDepositTransaction;
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Tron variables used outside conditional block cause ReferenceError

Variables isTronNative and isTronStakeValidating are declared inside the ONLY_INCLUDE_IF(tron) block (lines 135-148) but are accessed outside conditional blocks at lines 204, 717, and 961. In non-Tron builds, these lines of code remain but the variable declarations are removed by the preprocessor, causing a ReferenceError crash. The pattern used for showTronStakingUI (declared outside, assigned inside) is correct, but this pattern is not followed for these variables.

Additional Locations (2)

Fix in Cursor Fix in Web

}

return percentageOptions;
}, [isTronEnabled, isPreviewVisible, isNonZeroAmount, percentageOptions]);
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Undeclared isTronEnabled variable in withdraw view

The isTronEnabled variable is declared inside ONLY_INCLUDE_IF(tron) (line 87) but used outside at lines 198, 209, and 808. In non-Tron builds, the useMemo at line 197 and useCallback at line 807 will throw a ReferenceError because isTronEnabled is undeclared. Unlike showTronUnstakingUI which is properly declared outside the conditional block, isTronEnabled follows an incorrect pattern.

Additional Locations (1)

Fix in Cursor Fix in Web

@github-actions github-actions bot added size-S and removed size-XL labels Jan 5, 2026
@github-actions
Copy link
Contributor

github-actions bot commented Jan 5, 2026

🔍 Smart E2E Test Selection

  • Selected E2E tags: SmokeAccounts, SmokeCore, SmokeConfirmationsRedesigned, SmokeIdentity, SmokeNetworkAbstractions, SmokeNetworkExpansion, SmokeTrade, SmokeWalletPlatform, SmokeWalletUX, SmokeAssets, SmokeSwaps, SmokeStake, SmokeCard, SmokeNotifications, SmokeRewards, SmokePerps, SmokeRamps, SmokeMultiChainPermissions, SmokeAnalytics, SmokeMultiChainAPI, SmokePredictions
  • Risk Level: high
  • AI Confidence: %
click to see 🤖 AI reasoning details

Fallback: AI analysis did not complete successfully. Running all tests.

View GitHub Actions results

@sonarqubecloud
Copy link

sonarqubecloud bot commented Jan 5, 2026

Quality Gate Failed Quality Gate failed

Failed conditions
41.7% Coverage on New Code (required ≥ 80%)

See analysis details on SonarQube Cloud

@weitingsun weitingsun added the skip-sonar-cloud Only used for bypassing sonar cloud when failures are not relevant to the changes. label Jan 5, 2026
@weitingsun weitingsun merged commit e751553 into stable Jan 5, 2026
158 of 163 checks passed
@github-actions github-actions bot locked and limited conversation to collaborators Jan 5, 2026
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

release-7.61.5 Issue or pull request that will be included in release 7.61.5 size-S skip-sonar-cloud Only used for bypassing sonar cloud when failures are not relevant to the changes. team-bots Bot team (for MetaMask Bot, Runway Bot, etc.)

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants