chore: AB test Buy action (QuickBuy vs Swaps) on Top Traders token screen + feed

[zone-live]

Description

Introduces the socialAiTSA901AbtestTopTradersBuyAction A/B test for the Top Traders spot Buy action, to measure conversion of opening the main Swaps view vs. the existing QuickBuy sheet.

• control – Buy opens the existing QuickBuy sheet (current behavior).
• treatment – Buy opens the main Swaps view directly, with the trader's token pre-filled as the destination.

The experiment covers two surfaces:

• Trader position (token) screen – via the new TraderPositionBuyCta.
• Trader feed – via the new FeedSpotBuyAction.

Perps positions are unaffected (they use a separate Trade button that navigates to Perps and never resolves the experiment).

Simulator.Screen.Recording.-.iPhone.17.Pro.-.2026-07-20.at.13.47.58.mov

Changelog

CHANGELOG entry: null

Related issues

Fixes: https://consensyssoftware.atlassian.net/browse/TSA-901

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

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

Medium Risk
Changes the primary buy path for social trading surfaces and routes users into Swaps with pre-filled tokens; mitigated by control parity, QuickBuy fallback, and focus/tab cancellation, but still affects conversion-critical trading UX in production.

Overview
Adds socialAiTSA901AbtestTopTradersBuyAction: control keeps opening QuickBuy; treatment opens the main Swaps flow with the tapped token as the buy destination (follow_trader attribution).

Trader position screen — Buy is handled by TraderPositionBuyCta (replacing inline QuickBuy). Treatment resolves token metadata via useQuickBuySetup, navigates with FollowTradingTokenScreen, waits on slow metadata, falls back to QuickBuy when unresolved, and cancels pending navigation if the screen loses focus. Perps still use Trade only (no experiment exposure).

Trader feed — Spot Trade delegates to FeedSpotBuyAction (ref), mounted only when the feed has at least one spot row. Same A/B behavior with a keyed SwapDestResolver per tap (avoids stale metadata); cancels if the route blurs or the feed tab is inactive.

Also wires swap analytics locations, registers the flag and A/B analytics mapping, and bumps @metamask/bridge-controller to ^77.6.0 for the new event sources.

^{Reviewed by Cursor Bugbot for commit 99c6a25. 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:

• Manual testing steps still contain template content (the Gherkin example title or a [...] placeholder). Replace with real steps, or write N/A — <reason>.
• Screenshots/Recordings section is empty. Add an image/video for user-facing changes, logs/console output for non-user-facing changes, or write N/A if no evidence is applicable.
• 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.

[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 9e3b241. Configure here.}

[socket-security]

Review the following changes in direct dependencies. Learn more about Socket for GitHub.

Diff	Package	Supply Chain Security	Vulnerability	Quality	Maintenance	License
	npm/​@​metamask/​bridge-controller@​77.5.0 ⏵ 77.6.0	+1		+1

View full report

[Cal-L]

Platform LGTM

[github-actions]

🔍 Smart E2E Test Selection

• Selected E2E tags: SmokeAccounts, SmokeConfirmations, SmokeNetworkAbstractions, SmokeNetworkExpansion, SmokeSwap, SmokeStake, SmokeWalletPlatform, SmokeMoney, SmokePerps, SmokeMultiChainAPI, SmokePredictions, SmokeSeedlessOnboarding, SmokeBrowser, SmokeSnaps
• Selected Performance tags: None (no tests recommended)
• Risk Level: high
• AI Confidence: 100%

click to see 🤖 AI reasoning details

E2E Test Selection:
Hard rule (controller-version-update): @MetaMask controller package version updated in package.json: @metamask/bridge-controller. Running all tests.

Performance Test Selection:
No performance-sensitive changes detected. The PR refactors the Social Leaderboard buy flow (component extraction/reorganization), adds A/B test configuration, and bumps the bridge-controller minor version. None of these changes affect app launch, login, onboarding, asset loading, account list rendering, or the measured performance scenarios. The swap navigation changes are additive (new enum values) and don't alter the rendering performance of existing flows. No performance spec files were changed.

View GitHub Actions results

[sonarqubecloud]

Quality Gate passed

Issues
2 New issues
0 Accepted issues

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

See analysis details on SonarQube Cloud