feat: add NFT detection to wallet balance refresh (MetaMask#27272)

<!--
Please submit this PR as a draft initially.
Do not mark it as "Ready for review" until the template has been
completely filled out, and PR status checks have passed at least once.
-->

## **Description**
include nfts on manual refresh

<!--
Write a short description of the changes included in this pull request,
also include relevant motivation and context. Have in mind the following
questions:
1. What is the reason for the change?
2. What is the improvement/solution?
-->

## **Changelog**

<!--
If this PR is not End-User-Facing and should not show up in the
CHANGELOG, you can choose to either:
1. Write `CHANGELOG entry: null`
2. Label with `no-changelog`

If this PR is End-User-Facing, please write a short User-Facing
description in the past tense like:
`CHANGELOG entry: Added a new tab for users to see their NFTs`
`CHANGELOG entry: Fixed a bug that was causing some NFTs to flicker`

(This helps the Release Engineer do their job more quickly and
accurately)
-->

CHANGELOG entry: include nfts on manual refresh


## **Related issues**

Fixes:

## **Manual testing steps**

```gherkin
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**

<!-- If applicable, add screenshots and/or recordings to visualize the
before and after of your change. -->

### **Before**

<!-- [screenshots/recordings] -->



https://github.com/user-attachments/assets/e4e47867-490d-40a9-b22c-8dd9b6ff5239



### **After**

<!-- [screenshots/recordings] -->



https://github.com/user-attachments/assets/ad697185-85a5-4902-80c5-f819516d66fb



## **Pre-merge author checklist**

- [ ] I've followed [MetaMask Contributor
Docs](https://github.com/MetaMask/contributor-docs) and [MetaMask Mobile
Coding
Standards](https://github.com/MetaMask/metamask-mobile/blob/main/.github/guidelines/CODING_GUIDELINES.md).
- [ ] 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](https://jsdoc.app/) format
if applicable
- [ ] I've applied the right labels on the PR (see [labeling
guidelines](https://github.com/MetaMask/metamask-mobile/blob/main/.github/guidelines/LABELING_GUIDELINES.md)).
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.

<!-- CURSOR_SUMMARY -->
---

> [!NOTE]
> **Medium Risk**
> Adds an extra network/data-fetch operation to the balance refresh
path, which could affect refresh latency and controller load if the
gating conditions are misconfigured.
> 
> **Overview**
> Manual wallet refresh now optionally triggers NFT discovery by
invoking `NftDetectionController.detectNfts` (with `firstPageOnly:
true`) alongside existing token/balance/rate refresh work.
> 
> NFT detection is gated behind both the homepage sections v1 feature
flag and the user’s NFT detection preference (`selectUseNftDetection`),
and tests were expanded to cover the new call and gating behavior.
> 
> <sup>Written by [Cursor
Bugbot](https://cursor.com/dashboard?tab=bugbot) for commit
accdd10. This will update automatically
on new commits. Configure
[here](https://cursor.com/dashboard?tab=bugbot).</sup>
<!-- /CURSOR_SUMMARY -->

Author: salimtb

app/components/Views/Wallet/hooks/useBalanceRefresh.test.ts

@@ -38,6 +38,10 @@ jest.mock('../../../../selectors/networkEnablementController', () => ({
   selectEVMEnabledNetworks: jest.fn(() => []),
 }));
 
+jest.mock('../../../../selectors/preferencesController', () => ({
+  selectUseNftDetection: jest.fn(() => true),
+}));
+
 jest.mock('../../../../core/Engine', () => ({
   context: {
     AccountTrackerController: {
@@ -52,6 +56,9 @@ jest.mock('../../../../core/Engine', () => ({
     TokenBalancesController: {
       updateBalances: jest.fn(() => Promise.resolve()),
     },
+    NftDetectionController: {
+      detectNfts: jest.fn(() => Promise.resolve()),
+    },
   },
 }));
 
@@ -64,6 +71,18 @@ describe('useBalanceRefresh', () => {
   beforeEach(() => {
     jest.clearAllMocks();
     mockPopularEvmNetworks = ['0x1', '0x89'];
+    const { selectHomepageSectionsV1Enabled } = jest.requireMock(
+      '../../../../selectors/featureFlagController/homepage',
+    );
+    const { selectEVMEnabledNetworks } = jest.requireMock(
+      '../../../../selectors/networkEnablementController',
+    );
+    const { selectUseNftDetection } = jest.requireMock(
+      '../../../../selectors/preferencesController',
+    );
+    (selectHomepageSectionsV1Enabled as jest.Mock).mockReturnValue(true);
+    (selectEVMEnabledNetworks as jest.Mock).mockReturnValue([]);
+    (selectUseNftDetection as jest.Mock).mockReturnValue(true);
     (
       Engine.context.AccountTrackerController.refresh as jest.Mock
     ).mockResolvedValue(undefined);
@@ -76,6 +95,9 @@ describe('useBalanceRefresh', () => {
     (
       Engine.context.TokenBalancesController.updateBalances as jest.Mock
     ).mockResolvedValue(undefined);
+    (
+      Engine.context.NftDetectionController.detectNfts as jest.Mock
+    ).mockResolvedValue(undefined);
   });
 
   it('returns refreshBalance, handleRefresh, and refreshing', () => {
@@ -125,6 +147,58 @@ describe('useBalanceRefresh', () => {
     ).toHaveBeenCalledWith({ chainIds: ['0x1', '0x89'] });
   });
 
+  describe('NftDetectionController', () => {
+    it('calls detectNfts with popular chain IDs and firstPageOnly when sections v1 is enabled', async () => {
+      const { result } = renderHook(() => useBalanceRefresh());
+
+      await act(async () => {
+        await result.current.refreshBalance();
+      });
+
+      expect(
+        Engine.context.NftDetectionController.detectNfts,
+      ).toHaveBeenCalledWith(['0x1', '0x89'], { firstPageOnly: true });
+    });
+
+    it('does not call detectNfts when sections v1 is disabled', async () => {
+      const { selectHomepageSectionsV1Enabled } = jest.requireMock(
+        '../../../../selectors/featureFlagController/homepage',
+      );
+      const { selectEVMEnabledNetworks } = jest.requireMock(
+        '../../../../selectors/networkEnablementController',
+      );
+      (selectHomepageSectionsV1Enabled as jest.Mock).mockReturnValue(false);
+      (selectEVMEnabledNetworks as jest.Mock).mockReturnValue(['0x1']);
+
+      const { result } = renderHook(() => useBalanceRefresh());
+
+      await act(async () => {
+        await result.current.refreshBalance();
+      });
+
+      expect(
+        Engine.context.NftDetectionController.detectNfts,
+      ).not.toHaveBeenCalled();
+    });
+
+    it('does not call detectNfts when user has disabled NFT detection in settings', async () => {
+      const { selectUseNftDetection } = jest.requireMock(
+        '../../../../selectors/preferencesController',
+      );
+      (selectUseNftDetection as jest.Mock).mockReturnValue(false);
+
+      const { result } = renderHook(() => useBalanceRefresh());
+
+      await act(async () => {
+        await result.current.refreshBalance();
+      });
+
+      expect(
+        Engine.context.NftDetectionController.detectNfts,
+      ).not.toHaveBeenCalled();
+    });
+  });
+
   it('calls CurrencyRateController.updateExchangeRate with native currencies', async () => {
     const { result } = renderHook(() => useBalanceRefresh());
 

app/components/Views/Wallet/hooks/useBalanceRefresh.ts

@@ -9,6 +9,7 @@ import {
 import { useNetworkEnablement } from '../../../hooks/useNetworkEnablement/useNetworkEnablement';
 import { selectHomepageSectionsV1Enabled } from '../../../../selectors/featureFlagController/homepage';
 import { selectEVMEnabledNetworks } from '../../../../selectors/networkEnablementController';
+import { selectUseNftDetection } from '../../../../selectors/preferencesController';
 
 const REFRESH_TIMEOUT_MS = 5000;
 const REFRESH_TIMEOUT_ERROR_MESSAGE = 'Balance refresh timed out';
@@ -32,6 +33,8 @@ export const useBalanceRefresh = () => {
     selectHomepageSectionsV1Enabled,
   );
 
+  const isNftDetectionEnabled = useSelector(selectUseNftDetection);
+
   const evmEnabledChainIds = useSelector(selectEVMEnabledNetworks);
 
   const evmNetworkConfigurations = useSelector(
@@ -62,6 +65,7 @@ export const useBalanceRefresh = () => {
       CurrencyRateController,
       TokenBalancesController,
       TokenDetectionController,
+      NftDetectionController,
     } = Engine.context;
     const networkClientIds = Object.values(evmNetworkConfigurationsFiltered)
       .map(
@@ -81,6 +85,13 @@ export const useBalanceRefresh = () => {
           TokenBalancesController.updateBalances({
             chainIds: evmChainIdsForRefresh,
           }),
+          ...(isHomepageSectionsV1Enabled && isNftDetectionEnabled
+            ? [
+                NftDetectionController.detectNfts(evmChainIdsForRefresh, {
+                  firstPageOnly: true,
+                }),
+              ]
+            : []),
         ]),
         new Promise((_, reject) =>
           setTimeout(
@@ -101,6 +112,8 @@ export const useBalanceRefresh = () => {
     evmNetworkConfigurationsFiltered,
     evmChainIdsForRefresh,
     nativeCurrencies,
+    isHomepageSectionsV1Enabled,
+    isNftDetectionEnabled,
   ]);
 
   const handleRefresh = useCallback(async () => {