feat: use account API v4 transactions

[n3ps]

Description

• Replaces confirmed EVM Activity transactions with data from accounts v4 API via React Query
• Adds infinite pagination for confirmed EVM history
• Keep local pending EVM transactions and existing non-EVM activity unchanged

Note: Due to the API requesting a bearer token, there is a current bottleneck in that token retrieval, in particular in AuthenticationController.getPrimaryEntropySourceId

Changelog

CHANGELOG entry: feat: use accounts API v4 for transactions

Related issues

Fixes:

Manual testing steps

Feature: Accounts API v4 Transactions

  Scenario: user views EVM activity
    Given the wallet has EVM confirmed on-chain activity

    When user visits the Activity tab
    Then confirmed onchain transactions returned by the Accounts v4 API is displayed on screen.

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
Moderate risk because it rewires the Activity/UnifiedTransactionsView data source and filtering/deduping logic, which can change what transactions appear and when pagination/refresh occurs.

Overview
Confirmed EVM Activity now comes from the Accounts v4 API via a new React Query useTransactionsQuery hook, while local pending EVM transactions continue to come from controller state and are merged/deduped with the API results.

Adds a small transformation layer (helpers/adapters + helpers/transformations) to normalize API responses into TransactionMeta-compatible view models, filter out unwanted items (e.g. spam/incoming transfers/zero-value self-sends), and handle bridge-history matching/deduping (including case-insensitive hash matching).

Updates UnifiedTransactionsView to support infinite scrolling pagination (prefetch near the end of confirmed EVM items), show initial/next-page loading indicators, and refresh both local polling and the query. Related selector additions (selectLocalTransactions, selectRequiredTransactionHashes/Ids) support filtering required child txs and nonce/hash collisions, and tests/smoke mocks were updated accordingly.

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

[codecov-commenter]

Codecov Report

❌ Patch coverage is 12.42604% with 148 lines in your changes missing coverage. Please review.
✅ Project coverage is 44.44%. Comparing base (4e11714) to head (04b18d4).

Files with missing lines	Patch %	Lines
...s/Views/UnifiedTransactionsView/helpers/mappers.ts	15.47%	71 Missing ⚠️
...nifiedTransactionsView/UnifiedTransactionsView.tsx	2.43%	40 Missing ⚠️
app/selectors/transactionController.ts	14.28%	12 Missing ⚠️
...ectors/multichainAccounts/accountTreeController.ts	15.38%	11 Missing ⚠️
...fiedTransactionsView/hooks/useTransactionsQuery.ts	12.50%	7 Missing ⚠️
app/core/apiClient.ts	14.28%	6 Missing ⚠️
app/selectors/networkEnablementController/index.ts	50.00%	1 Missing ⚠️

Additional details and impacted files

@@             Coverage Diff             @@
##             main   #29536       +/-   ##
===========================================
- Coverage   82.16%   44.44%   -37.73%     
===========================================
  Files        5176     5179        +3     
  Lines      137275   137376      +101     
  Branches    31024    31052       +28     
===========================================
- Hits       112795    61055    -51740     
- Misses      16840    70626    +53786     
+ Partials     7640     5695     -1945     

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

[vinnyhoward]

Very clean. LGTM!

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

[github-actions]

🔍 Smart E2E Test Selection

• Selected E2E tags: SmokeWalletPlatform, SmokeSwap, SmokeStake, SmokeConfirmations, SmokeNetworkExpansion
• Selected Performance tags: @PerformanceAssetLoading
• Risk Level: high
• AI Confidence: 82%

click to see 🤖 AI reasoning details

E2E Test Selection:

This PR introduces a major architectural change to the transaction history/activity view (UnifiedTransactionsView), switching from local Redux state to an API-based infinite query system using @tanstack/react-query and a new v4 accounts API endpoint.

Primary impact - SmokeWalletPlatform:

• The incoming-transactions.spec.ts test is directly modified to use the new v4 API endpoint (/v4/multiaccount/transactions instead of v1). One test is skipped (privacyMode).
• The UnifiedTransactionsView (transaction history/activity tab) is significantly refactored with pagination, infinite scroll, and new loading states.
• The TransactionElement component has a race condition fix and new pending state rendering.
• Badge positioning changes in MultichainTransactionListItem and MultichainBridgeTransactionListItem.
• New apiClient.ts using AuthenticationController bearer token.
• New selectors in transactionController.ts for local transaction management.

SmokeSwap selected because:

• Bridge transaction history display is affected (useBridgeTxHistoryData.ts changes for hash-based fallback matching)
• The MultichainBridgeTransactionListItem badge changes affect bridge transaction display
• Swap/bridge activity appears in the transaction history view that was refactored
• Per tag description: "also select SmokeConfirmations" when selecting SmokeSwap

SmokeStake selected because:

• Stake transactions appear in the activity/transaction history view that was refactored
• Per tag description: "also select SmokeConfirmations" when selecting SmokeStake

SmokeConfirmations selected because:

• Required as dependent tag when SmokeSwap and SmokeStake are selected
• Transaction confirmations feed into the transaction history view

SmokeNetworkExpansion selected because:

• Non-EVM (Solana, Bitcoin) transactions are part of the UnifiedTransactionsView merge logic (mergeTransactionsByTime)
• The MultichainTransactionListItem badge changes affect non-EVM transaction display
• The TransactionKind.NonEvm path in the refactored view handles Solana/Bitcoin transactions

The changes do NOT directly affect: account management (SmokeAccounts), identity/sync (SmokeIdentity), network management UI (SmokeNetworkAbstractions), browser (SmokeBrowser), Snaps (SmokeSnaps), card/ramps (SmokeMoney), perps (SmokePerps), predictions (SmokePredictions), multi-chain API sessions (SmokeMultiChainAPI), or seedless onboarding (SmokeSeedlessOnboarding).

Performance Test Selection:
The UnifiedTransactionsView has been significantly refactored to use API-based infinite pagination instead of local Redux state. This introduces network requests, @tanstack/react-query infinite queries, and new loading states that could impact the performance of the activity/transaction history tab. The @PerformanceAssetLoading tag covers token list rendering and balance/portfolio loading which is closely related to the transaction history display. The pagination and infinite scroll implementation could affect rendering performance when loading large transaction histories.

View GitHub Actions results

[sonarqubecloud]

Quality Gate passed

Issues
1 New issue
0 Accepted issues

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

See analysis details on SonarQube Cloud