feat: added deeplinking to the NFT screen

[juanmigdr]

Description

The marketing team has asked for a deeplink to the NFTs screen/tab. After researching other components I found two kind of behaviors (taking users to the NFTs tab or taking users to the NFTs screen) and raised the question to the marketing team:

Here is the video I attached them (Sound ON):
https://github.com/user-attachments/assets/f7b563c2-8d54-4e77-8297-662469828a6e

Here is their response:

Therefore we will be navigating to the NFTs screen (not tab) whenever the deeplink is opened

Changelog

CHANGELOG entry: added deeplinking to the NFT screen

Related issues

Fixes: https://consensyssoftware.atlassian.net/browse/ASSETS-2570

Manual testing steps

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

Before

After

Screen.Recording.2026-01-30.at.10.36.25.mov

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.

---

Note

Low Risk
Low risk: adds a new deeplink route and handler that only performs in-app navigation plus analytics route mapping, with tests covering the new handler’s error paths.

Overview
Adds support for the /nft universal link action so marketing links like https://link.metamask.io/nft navigate directly to the NFTs full view.

Wires the new ACTIONS.NFT through handleUniversalLink, the supported-action/type lists, and deep-link analytics route extraction/mapping (no sensitive params extracted). Includes unit tests for handleNftUrl, including fallback navigation to Routes.WALLET.HOME on errors.

^{Written by Cursor Bugbot for commit c77e32b. This will update automatically on new commits. Configure here.}

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

[github-actions]

🔍 Smart E2E Test Selection

• Selected E2E tags: SmokeTrade, SmokeRamps
• Selected Performance tags: None (no tests recommended)
• Risk Level: medium
• AI Confidence: 78%

click to see 🤖 AI reasoning details

E2E Test Selection:
This PR adds a new NFT universal deeplink action and handler, and updates deeplink analytics/mapping. Changes touch the central universal link handler switch and deep link route mapping, which are shared for swap/bridge and on/off-ramp deep links. While the change is additive and targeted, errors in the universal link handler could impact existing deep link flows. Running SmokeTrade (covers swap/bridge deep links) and SmokeRamps (covers buy/sell deep link navigation) provides targeted coverage of the deeplink system without running unrelated suites. No controllers/Engine or shared UI components were modified, and navigation changes are localized to the new NFT route.

Performance Test Selection:
No performance-impacting areas were changed. The update adds URL parsing, route mapping, and a simple navigation to the NFT screen with a fallback. No rendering lists, controller/state management, startup initialization, or heavy data loading paths were modified; thus performance tests are unnecessary.

View GitHub Actions results

[sonarqubecloud]

Quality Gate failed

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

See analysis details on SonarQube Cloud