feat: batch sell token select

[infiniteflower]

Description

Adds the Batch Sell entry point and token selection flow for Unified Swaps. Users can select up to five same-network, non-zero-balance source tokens, excluding configured destination stablecoins, then hand them off to the quote flow.

This also adds the single-token high-rate alert path, Batch Sell Redux handoff state, network/value sorting, wallet-style token row price data, empty state handling, and focused unit coverage for the new flow.

This is hidden behind the env var MM_BATCH_SELL_ENABLED.

Changelog

CHANGELOG entry: Added Batch Sell token selection for selling up to five same-network tokens.

Related issues

Refs: SWAPS-4437

Manual testing steps

Feature: Batch Sell token selection

  Background:
    Given I am logged into MetaMask Mobile
    And Batch Sell is enabled

  Scenario: user opens Batch Sell from wallet actions
    Given I am on the wallet home screen

    When user opens the trade wallet actions menu
    And user taps "Batch Sell"
    Then the Batch Sell token selection screen should open
    And the subtitle should state that up to 5 tokens can be selected
    And the subtitle should state that all tokens must be on the same network

  Scenario: user selects multiple tokens for Batch Sell
    Given I am on the Batch Sell token selection screen
    And I have non-zero-balance tokens on a supported network

    When user selects between 2 and 5 tokens on the selected network
    Then the primary button should show "Continue with (N) tokens"

    When user taps the primary button
    Then the quote selector screen should open for the selected Batch Sell tokens

  Scenario: user changes networks and sorting
    Given I am on the Batch Sell token selection screen
    And multiple supported networks have sellable tokens

    When user selects a network pill
    Then the token list should show only non-zero-balance tokens from that network

    When user taps the Balance sort header
    Then the token list should reverse fiat balance sort direction

  Scenario: user has no sellable tokens
    Given I am on the Batch Sell token selection screen
    And I have no non-zero-balance tokens on any supported Batch Sell network

    Then the no sellable assets empty state should be shown
    And the "Explore tokens" button should be available

    When user taps "Explore tokens"
    Then the in-app Explore feed should open

  Scenario: user selects exactly one token
    Given I am on the Batch Sell token selection screen
    And exactly one token is selected

    When user taps "Continue with (1) token"
    Then the high rate alert modal should open

    When user taps "Yes, swap"
    Then the regular Unified Swap flow should open
    And the selected source token and configured destination stablecoin should be prefilled

Screenshots/Recordings

Before

N/A - not captured in this generated draft.

After

Screen.Recording.2026-05-06.at.6.12.55.PM.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

Medium Risk
Adds a new Batch Sell entry point, navigation routes, and Redux handoff state, plus modifies shared token list UI (TokenSelectorItem) and token-balance filtering; regressions could affect token selection display/behavior and bridge/swaps navigation.

Overview
Introduces a new Batch Sell token selection screen in Bridge, allowing users to pick up to 5 same-network tokens (filtered to supported chains, non-zero balances, and excluding configured destination stablecoins), with network pills, balance sort toggling, and an empty state that links to Explore tokens.

Adds a single-token high-rate alert bottom sheet (HighRateAlertModal) that redirects users to the standard swaps flow, and wires multi-token selections to the quote flow via new bridge-slice state (batchSellSourceTokens) and selectors.

Extends TokenSelectorItem with optional secondaryRowContent, configurable balance text props, and flags to disable selected-row styling and network badges (used by the new Batch Sell rows showing fiat price + 24h % change), and gates the wallet entry point behind MM_BATCH_SELL_ENABLED / BATCH_SELL_ENABLED.

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

[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/​assets-controller@​6.3.0 ⏵ 6.4.0	+1		+1	+1
	npm/​@​metamask/​bridge-controller@​71.0.0 ⏵ 71.1.1	+1		+1	+1

View full report

[georgewrmarshall]

UI LGTM!

[github-actions]

🔍 Smart E2E Test Selection

• Selected E2E tags: SmokeAccounts, SmokeConfirmations, SmokeIdentity, SmokeNetworkAbstractions, SmokeNetworkExpansion, SmokeSwap, SmokeStake, SmokeWalletPlatform, SmokeMoney, SmokePerps, SmokeMultiChainAPI, SmokePredictions, SmokeSeedlessOnboarding, SmokeBrowser, SmokeSnaps
• Selected Performance tags: @PerformanceAccountList, @PerformanceOnboarding, @PerformanceLogin, @PerformanceSwaps, @PerformanceLaunch, @PerformanceAssetLoading, @PerformancePredict, @PerformancePreps
• 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:
Hard rule (controller-version-update): @MetaMask controller package version updated in package.json: @metamask/bridge-controller. Running all tests.

View GitHub Actions results

[sonarqubecloud]

Quality Gate passed

Issues
3 New issues
0 Accepted issues

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

See analysis details on SonarQube Cloud