feat: add share button and share sheet to Token Details page

[salimtb]

add share button and share sheet to Token Details page

Description

Changelog

CHANGELOG entry: add share button and share sheet to Token Details page

Related issues

Fixes:

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

Share.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.

Performance checks (if applicable)

• I've tested on Android
  • Ideally on a mid-range device; emulator is acceptable
• I've tested with a power user scenario
  • Use these power-user SRPs to import wallets with many accounts and tokens
• I've instrumented key operations with Sentry traces for production performance metrics
  • See trace() for usage and addToken for an example

For performance guidelines and tooling, see the Performance Guide.

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
User-facing share and analytics only; no auth, payments, or sensitive data handling beyond existing token route params.

Overview
Adds a share action on Token Details so users can share a MetaMask deep link to the current asset.

TokenDetailsInlineHeader now accepts optional onSharePress and shows a share icon alongside the price-alert control (same ambient-color gating as other header actions). TokenDetails wires handleShare: it no-ops if CAIP-19 assetId cannot be resolved, otherwise opens the native share sheet with https://link.metamask.io/asset?assetId=… (encoded), uses { url } on iOS and { message } on Android, and emits TOKEN_DETAILS_SHARED with chain, symbol, and address.

Analytics registers the new event in MetaMetrics.events. Tests cover share URL encoding, Android vs iOS payloads, analytics, header visibility, plus expanded TokenDetails coverage for close/open tracking, CTAs, disclaimer, and non-EVM rendering.

^{Reviewed by Cursor Bugbot for commit 0f471cb. Bugbot is set up for automated code reviews on this repo. Configure here.}

[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.

[metamask-ci]

PR template — items to address before "Ready for review"

Warnings — informational, address before merging:

• Description section is empty. Describe what changed and why.
• Related issues section is empty. Add Fixes: #123 / Closes: <URL> / Refs: <Jira key>, or write a short rationale after the colon.
• Manual testing steps still contain template content (the Gherkin example title or a [...] placeholder). Replace with real steps, or write N/A — <reason>.
• Pre-merge author checklist has unchecked items (e.g. "I've followed MetaMask Contributor Docs and MetaMask Mobile Coding Standards."). Every box must be consciously checked — see docs/readme/ready-for-review.md.

See docs/readme/ready-for-review.md for the full Definition of Ready for Review.

[socket-security]

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

👍 No dependency changes detected in pull request

[cursor]

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

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, have a team admin enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 4cf3892. Configure here.}

[github-actions]

🔍 Smart E2E Test Selection

• Selected E2E tags: SmokeWalletPlatform
• Selected Performance tags: None (no tests recommended)
• Risk Level: medium
• AI Confidence: 72%

click to see 🤖 AI reasoning details

E2E Test Selection:
The PR adds a "Share" button to the Token Details screen (TokenDetailsInlineHeader) and a new analytics event (TOKEN_DETAILS_SHARED). The changes are:

1. MetaMetrics.events.ts: Purely additive - adds TOKEN_DETAILS_SHARED enum value and event generator. No existing events are modified.

2. TokenDetails.tsx: Adds handleShare callback using React Native's Share API to share a deep link URL with CAIP-19 asset ID. Passes onSharePress to TokenDetailsInlineHeader.

3. TokenDetailsInlineHeader.tsx: Adds onSharePress prop and renders a new Share ButtonIcon alongside the existing price alert button. Layout changed from single endButtonHitArea to a new endButtons container wrapping both buttons.

4. Test files: Unit tests for the new functionality.

Tag selection reasoning: The Token Details screen is accessed from the token list in the wallet home. SmokeWalletPlatform covers core wallet platform features including token-related flows. No dedicated E2E tests exist for TokenDetails share functionality, but SmokeWalletPlatform tests exercise the wallet home and token list which leads to TokenDetails. The layout change in TokenDetailsInlineHeader (wrapping buttons in a new endButtons container) could potentially affect existing price alert button rendering, warranting regression testing of the wallet platform flows.

No other tags are needed as this change is isolated to the Token Details component and doesn't affect confirmations, swaps, network management, accounts, or other feature areas.

Performance Test Selection:
The changes add a Share button to the Token Details screen and a new analytics event. These changes do not affect any performance-sensitive code paths such as app launch, login, onboarding, asset loading, swap flows, or account list rendering. No performance test files were modified. The Share API call is user-initiated and not part of any measured performance scenario.

View GitHub Actions results

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

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

See analysis details on SonarQube Cloud

[juanmigdr]

LGTM, I have seent his in prod in some links, wondering if this is going to be the case for this link...

[salimtb]

LGTM, I have seent his in prod in some links, wondering if this is going to be the case for this link...

i think we do this for all deeplinks actually , but worth reconsidering this indeed

[gauthierpetetin]

No release label on PR. Adding release label release-8.1.0 on PR, as PR was added to branch 8.1.0 when release was cut.