feat: add new domain deeplinks

[frankvonhoven]

Description

This is to prepare for adding new public universal links to the app to be triggered by a new domain.
This adds 3 routes: home, swap, and ramp (buy) for the new domain

There are currently blockers for making this functional in the app - 5/21/25

Related issues

• Fixes Deeplink to Home #15225
• Fixes Deeplinking - Swap #14628

Manual testing steps

1. Run the app on this branch with a expo development build from Bitrise
2. Click on each of these links in the Notes app or Slack these links to yourself

Home

https://metamask.app.link/home

Ramp - Buy

https://link-test.metamask.io/buy-crypto?chainId=59144&address=0x176211869cA2b568f2A7D4EE941E073a821EE1ff&amount=100

Swap

https://link-test.metamask.io/swap?from=eip155:1/erc20:0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48&to=eip155:1/erc20:0xdAC17F958D2ee523a2206206994597C13D831ec7&value=0x38d7ea4c68000
3. App should open to the appropriate screen

Screenshots/Recordings

/home

deeplink-home.mp4

/swap

deeplink-swap.mp4

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.

[github-actions]

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.

[sethkfman]

Provided a few pieces of specific feedback. You are also missing unit testing.

[codecov-commenter]

Codecov Report

Attention: Patch coverage is 12.82051% with 34 lines in your changes missing coverage. Please review.

Project coverage is 69.21%. Comparing base (e095d11) to head (0d758d5).
Report is 1 commits behind head on main.

Files with missing lines	Patch %	Lines
app/core/DeeplinkManager/Handlers/handleSwapUrl.ts	4.76%	20 Missing ⚠️
...eeplinkManager/ParseManager/handleUniversalLink.ts	21.42%	10 Missing and 1 partial ⚠️
app/core/DeeplinkManager/DeeplinkManager.ts	0.00%	3 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main   #15467      +/-   ##
==========================================
- Coverage   69.25%   69.21%   -0.05%     
==========================================
  Files        2434     2435       +1     
  Lines       52417    52452      +35     
  Branches     7930     7937       +7     
==========================================
+ Hits        36304    36306       +2     
- Misses      13786    13818      +32     
- Partials     2327     2328       +1     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[Copilot]

Pull Request Overview

Adds support for a new public deeplink domain (link.metamask.io and link-test.metamask.io) by updating platform configs, routing constants, and deeplink handling logic for the home, swap, and ramp screens.

• Add new universal link domains in iOS entitlements and plist, plus Android manifest intent filters
• Introduce AppConstants for the new hosts and extend ACTIONS enum with HOME and SWAP
• Implement new handling in handleUniversalLink, add handleSwapUrl handler, and cover with tests

Reviewed Changes

Copilot reviewed 12 out of 12 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
ios/MetaMask/MetaMaskDebug.entitlements	Whitelist new applinks domains for debug builds
ios/MetaMask/MetaMask.entitlements	Whitelist new applinks domains for production builds
ios/MetaMask/MetaMask-Flask-Info.plist	Add new branch universal link domains
ios/MetaMask/Info.plist	Add new branch universal link domains
android/app/src/main/AndroidManifest.xml	Add intent filters for new universal link domains
app/core/AppConstants.ts	Define MM_IO_UNIVERSAL_LINK_HOST and MM_IO_UNIVERSAL_LINK_TEST_HOST
app/constants/deeplinks.ts	Add HOME and SWAP to ACTIONS and PREFIXES
app/core/DeeplinkManager/ParseManager/handleUniversalLink.ts	Extend logic to route /home, /swap, and /buy-crypto on new domains
app/core/DeeplinkManager/ParseManager/handleUniversalLink.test.ts	Add tests for new domain actions
app/core/DeeplinkManager/Handlers/handleSwapUrl.ts	New handler to parse swap query params and navigate accordingly
app/core/DeeplinkManager/Handlers/handleSwapUrl.test.ts	Unit tests for swap URL handler
app/core/DeeplinkManager/DeeplinkManager.ts	Add _handleOpenHome and _handleSwap methods

[NicolasMassart]

Unit tests names are not matching our guidelines.

[NicolasMassart]

I love it now!

[sonarqubecloud]

Quality Gate passed

Issues
7 New issues
0 Accepted issues

Measures
0 Security Hotspots
87.1% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud