feat(perps): wire Perps Withdraw button to feature-flagged confirmation flow

[dan437]

Description

Adds the full Perps Withdraw "to any token" feature, allowing users to withdraw Perps funds to any supported token via MetaMask Pay and the Relay bridge, instead of only withdrawing native USDC through HyperLiquid's 5-minute bridge.

Changelog

CHANGELOG entry: Added feature-flagged "withdraw to any token" flow for Perps, allowing users to withdraw Perps funds to any supported token via MetaMask Pay

Related issues

Fixes: https://consensyssoftware.atlassian.net/browse/CONF-1121

Manual testing steps

Feature: Perps Withdraw to any token

  Scenario: user withdraws via the new confirmation flow (flag enabled)
    Given the user has a Perps balance
    And the confirmations_pay_post_quote remote flag has overrides.perpsWithdraw.enabled = true
    When user taps "Withdraw" on the Perps home page
    Then the full-screen CustomAmount confirmation UI is shown
    And the available Perps balance is displayed
    And the user can select a receive token via the "Receive as" picker
    And confirming the withdrawal triggers the MetaMask Pay flow

  Scenario: user withdraws via the legacy flow (flag disabled)
    Given the user has a Perps balance
    And the confirmations_pay_post_quote remote flag has overrides.perpsWithdraw.enabled = false or is missing
    When user taps "Withdraw" on the Perps home page
    Then the legacy PerpsWithdrawView is shown

  Scenario: developer triggers Perps withdraw from Developer Options
    Given the user has Developer Options enabled in Settings
    When user navigates to Settings > Developer Options > Perps Withdraw and taps "Withdraw"
    Then the full-screen CustomAmount confirmation UI is shown regardless of feature flag state

  Scenario: perpsWithdraw transaction appears in activity
    Given a perpsWithdraw transaction has been submitted
    When the user views the activity tab
    Then the transaction is listed as "Perps withdraw"
    And tapping it shows the transaction details with title "Withdrawal"

Screenshots/Recordings

Before

N/A

After

N/A

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

Medium Risk
Changes withdraw initiation and transaction-batch creation (including network selection) in a user-funds flow, which can affect confirmations and activity history if the flag/config is wrong.

Overview
Updates Perps withdraw to be feature-flagged: when selectPayQuoteConfig(..., 'perpsWithdraw').enabled is true, the Withdraw button now starts a new confirmation-based flow instead of navigating to the legacy withdraw screen.

Introduces usePerpsWithdrawConfirmation, which navigates to the CustomAmount confirmation UI on the Perps stack and creates a dummy Arbitrum ERC-20 transfer batch typed as TransactionType.perpsWithdraw to drive the MetaMask Pay experience; Developer Options “Perps Withdraw” is rewired to this hook. Tests are updated/added to cover the flag branching, success/error handling, and the new transaction-batch behavior.

^{Written by Cursor Bugbot for commit a80e4b7. This will update automatically on new commits. 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.

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

[michalconsensys]

After initiating the withdraw process, I'd expect this banner to show up also with the withdraw notifications. That does not seem to be the case in this branch

[dan437]

After initiating the withdraw process, I'd expect this banner to show up also with the withdraw notifications. That does not seem to be the case in this branch

Thanks for the catch! We have just discussed this internally and if perp withdraws are way faster now then we don't need to banner, just the toast notifications, for which there is a different PR.

[michalconsensys]

Looks good, just for reference the toast notifications will be added in this PR #28271

[github-actions]

🔍 Smart E2E Test Selection

• Selected E2E tags: SmokePerps, SmokeConfirmations, SmokeWalletPlatform
• Selected Performance tags: None (no tests recommended)
• Risk Level: medium
• AI Confidence: 88%

click to see 🤖 AI reasoning details

E2E Test Selection:
The PR introduces a new Perps withdraw confirmation flow:

1. usePerpsWithdrawConfirmation.ts (NEW): A new hook that creates a perpsWithdraw transaction batch on Arbitrum and navigates to the confirmation UI with a CustomAmount loader. This is a new code path that directly touches the confirmations system.

2. usePerpsHomeActions.ts (MODIFIED): The handleWithdraw function now checks a feature flag (perpsWithdrawConfig.enabled). When enabled, it calls withdrawWithConfirmation() instead of navigating to the legacy withdraw screen. This is a behavioral change to the Perps withdraw flow.

3. confirmations-developer-options.tsx (MODIFIED): Refactored to use the new shared usePerpsWithdrawConfirmation hook (code deduplication from inline useAddPerpsTransactionBatch). This is a developer-only component but validates the hook works correctly.

Tag selection rationale:

• SmokePerps: Directly affected - the withdraw flow is changed with a new confirmation-based path behind a feature flag. The Add Funds/withdraw flows are core to Perps testing.
• SmokeConfirmations: The new withdraw flow navigates to the confirmation UI with a CustomAmount loader and creates a perpsWithdraw transaction type. The confirmation system is directly involved in the new flow.
• SmokeWalletPlatform: Per tag description, Perps is a section inside the Trending tab. Changes to Perps flows (including withdraw) affect Trending. Also required when selecting SmokePerps per the tag dependency rules.

SmokeTrade was considered but not selected as the changes are specifically to the Perps withdraw confirmation flow, not the broader trade/swap/bridge flows. The SmokePerps + SmokeConfirmations + SmokeWalletPlatform combination provides adequate coverage.

Performance Test Selection:
The changes are functional/behavioral (new hook, feature flag gating for withdraw flow) rather than rendering or data loading performance changes. No list rendering, animation, or startup changes are present. Performance tests are not warranted.

View GitHub Actions results

[github-actions]

⚠️ E2E Fixture Validation — Structural changes detected

Category	Count
New keys	46
Missing keys	0
Type mismatches	0
Value mismatches	12 (informational)

The committed fixture schema is out of date. To update, comment:

@metamaskbot update-mobile-fixture

View full details | Download diff report

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

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

See analysis details on SonarQube Cloud