Description

This PR disables the app's auto-lock mechanism while users are in the Ramps unified buy v2 flow.

Reason for change: When users minimize the app to check personal details, verify their identity, or complete payment information with external providers during the Ramps flow, they get locked out after the configured timeout, forcing them to re-authenticate and disrupting their purchase journey.

Solution: Temporarily disable auto-lock by stopping the AppState listener in LockManagerService when entering the Ramps flow, and re-enable it when exiting. This follows the exact same pattern used by the Card onboarding flow.

Technical implementation: The TokenListRoutes component is the root navigator for all Ramps v2 screens. A useEffect hook calls LockManagerService.stopListening() on mount and LockManagerService.startListening() on unmount, ensuring the entire flow (token selection, build quote, checkout webview, KYC screens, order completion) is covered.

Changelog

CHANGELOG entry: Improved Ramps buy flow by preventing auto-lock during checkout

Related issues

Refs: TRAM-3300

Manual testing steps

Feature: Auto-lock disabled during Ramps unified buy v2 flow

  Scenario: Auto-lock is disabled when entering Ramps flow from token selection
    Given the user has auto-lock set to "After 5 seconds" in Settings
    And the user is on the wallet home screen

    When the user navigates to Ramps token selection
    And the user backgrounds the app
    And waits for 10 seconds
    And the user foregrounds the app
    Then the user should return to the Ramps token selection screen
    And the app should NOT show the lock screen

  Scenario: Auto-lock is disabled when entering Ramps flow from token details
    Given the user has auto-lock set to "After 5 seconds" in Settings
    And the user is viewing a token's details page

    When the user presses "Buy" to enter the Ramps flow
    And the user backgrounds the app during checkout
    And waits for 10 seconds
    And the user foregrounds the app
    Then the user should return to the Ramps checkout screen
    And the app should NOT show the lock screen

  Scenario: Auto-lock is re-enabled after exiting Ramps flow
    Given the user was in the Ramps flow (auto-lock disabled)
    And the user exits the flow by pressing back

    When the user backgrounds the app
    And waits for 6 seconds
    And the user foregrounds the app
    Then the app should show the lock screen

  Scenario: Auto-lock works normally on non-Ramps screens
    Given the user has auto-lock set to "After 5 seconds" in Settings
    And the user is on the wallet home screen or swap screen

    When the user backgrounds the app
    And waits for 6 seconds
    And the user foregrounds the app
    Then the app should show the lock screen

Screenshots/Recordings

Before

After

Pre-merge author checklist

• I've followed MetaMask Contributor Docs and MetaMask Mobile Coding Standards.
• 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 format if applicable
• I've applied the right labels on the PR (see labeling guidelines). 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.