fix: metrics for hardware wallets cp-7.61.0 (MetaMask#22773)

<!--
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**

This PR standardises the metrics for hardware wallets to align with the
extension.

The schemas follow the following 
-
https://www.figma.com/design/9sGBc6mZkQVBKitQzsD0iI/Hardware-Wallet-Metrics?node-id=0-1&p=f&t=Q6IqeowrBX3vu5rF-0

<!--
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: null

## **Related issues**

Fixes:
https://consensyssoftware.atlassian.net/browse/MUL-1241?atlOrigin=eyJpIjoiZTNiNWQzNDEzZGMwNDc0OGFlMTc4YTJmYWJmMzQ5NTMiLCJwIjoiaiJ9

## **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**

N/a no user facing changes.

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

### **Before**

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

### **After**

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

## **Pre-merge author checklist**

- [x] 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).
- [x] I've completed the PR template to the best of my ability
- [x] I’ve included tests if applicable
- [x] I’ve documented my code using [JSDoc](https://jsdoc.app/) format
if applicable
- [x] 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]
> Unifies hardware wallet analytics with new events and properties
across QR and Ledger flows, adds device info/count tracking and
permission/error metrics, plus comprehensive tests and utilities.
> 
> - **Analytics (Hardware Wallets)**:
> - Replace legacy `LEDGER_*`/QR events with unified `HARDWARE_WALLET_*`
events (e.g., `CONNECT_HARDWARE_WALLET`, `HARDWARE_WALLET_ADD_ACCOUNT`,
`HARDWARE_WALLET_ERROR`, `HARDWARE_WALLET_ACCOUNT_SELECTOR_OPEN`,
`HARDWARE_WALLET_CONNECTION_RETRY`, `HARDWARE_WALLET_MARKETING`,
`HARDWARE_WALLET_CONNECT_INSTRUCTIONS`).
> - Add common properties: `device_type`, `device_model` (incl. BLE UUID
mapping), `connected_device_count`, `hd_path`, and detailed error
strings.
> - Track permission requests/results
(`HARDWARE_WALLET_PERMISSION_REQUEST`) and camera/QR scanning errors.
> - Update cancel events to `DAPP_TRANSACTION_CANCELLED` where
applicable.
> - **Flows Updated**:
> - QR: `AnimatedQRScanner`, `ConnectQRHardware` (continue, account
selector, add account, forget device, error),
`ConnectQRHardware/Instruction` (marketing links).
> - Ledger: `LedgerConnect` (instructions, found device, continue/retry,
marketing), `LedgerConnect/Scan` (permission/BT errors with model),
`LedgerConfirmationModal` (errors/cancel), `LedgerSelectAccount`
(account selector open/add/forget/error).
> - Account screens: `AccountConnect` and `AccountPermissions` track HW
connect with device count; `AccountActions` forget-device metrics per
keyring.
>   - Multichain actions: use `ADD_HARDWARE_WALLET` for HW button.
> - **Utilities & Hooks**:
>   - New `getConnectedDevicesCount` (counts connected HW keyrings).
> - New `useLedgerDeviceForAccount` hook for per-account Ledger device
context.
> - New device utilities: `sanitizeDeviceName`,
`ledgerDeviceUUIDToModelName`.
> - **Testing & Mocks**:
> - Extensive test coverage added/updated for all flows; enhanced
`react-native-vision-camera` mock to capture callbacks.
> 
> <sup>Written by [Cursor
Bugbot](https://cursor.com/dashboard?tab=bugbot) for commit
9c9bf99. This will update automatically
on new commits. Configure
[here](https://cursor.com/dashboard?tab=bugbot).</sup>
<!-- /CURSOR_SUMMARY -->

Author: montelaidev

app/__mocks__/react-native-vision-camera.ts

@@ -24,15 +24,53 @@ const mockPermission = {
   requestPermission: jest.fn().mockResolvedValue('granted'),
 };
 
-const mockCodeScanner = {
-  codeTypes: ['qr'],
-  onCodeScanned: jest.fn(),
+let capturedOnCodeScanned:
+  | ((codes: { value: string; type: string }[]) => Promise<void> | void)
+  | null = null;
+let capturedOnError: ((error: Error) => Promise<void> | void) | null = null;
+
+export const resetCapturedCallbacks = () => {
+  capturedOnCodeScanned = null;
+  capturedOnError = null;
 };
 
-const Camera = React.forwardRef(() => null);
+export const getCapturedCallbacks = () => ({
+  onCodeScanned: capturedOnCodeScanned,
+  onError: capturedOnError,
+});
+
+const Camera = React.forwardRef(
+  (
+    props: {
+      onError?: (error: Error) => Promise<void> | void;
+      codeScanner?: {
+        onCodeScanned: (
+          codes: { value: string; type: string }[],
+        ) => Promise<void> | void;
+      };
+    },
+    _ref: unknown,
+  ) => {
+    if (props.onError) {
+      capturedOnError = props.onError;
+    }
+    if (props.codeScanner?.onCodeScanned) {
+      capturedOnCodeScanned = props.codeScanner.onCodeScanned;
+    }
+    return React.createElement('View', { testID: 'camera-mock' });
+  },
+);
 
 const useCameraDevice = jest.fn(() => mockDevice);
 const useCameraPermission = jest.fn(() => mockPermission);
-const useCodeScanner = jest.fn(() => mockCodeScanner);
+const useCodeScanner = jest.fn((config) => {
+  if (config?.onCodeScanned) {
+    capturedOnCodeScanned = config.onCodeScanned;
+  }
+  return {
+    codeTypes: ['qr'],
+    onCodeScanned: config?.onCodeScanned || jest.fn(),
+  };
+});
 
 export { Camera, useCameraDevice, useCameraPermission, useCodeScanner };

app/component-library/components-temp/MultichainAccounts/MultichainAddWalletActions/MultichainAddWalletActions.test.tsx

@@ -6,6 +6,7 @@ import MultichainAddWalletActions from './MultichainAddWalletActions';
 import { MOCK_ACCOUNTS_CONTROLLER_STATE } from '../../../../util/test/accountsControllerTestUtils';
 import { MOCK_KEYRING_CONTROLLER } from '../../../../selectors/keyringController/testUtils';
 import Routes from '../../../../constants/navigation/Routes';
+import { MetaMetricsEvents } from '../../../../core/Analytics';
 
 const mockedNavigate = jest.fn();
 jest.mock('@react-navigation/native', () => {
@@ -18,6 +19,18 @@ jest.mock('@react-navigation/native', () => {
   };
 });
 
+const mockTrackEvent = jest.fn();
+const mockCreateEventBuilder = jest.fn((event) => ({
+  build: jest.fn(() => event),
+}));
+
+jest.mock('../../../../components/hooks/useMetrics', () => ({
+  useMetrics: () => ({
+    trackEvent: mockTrackEvent,
+    createEventBuilder: mockCreateEventBuilder,
+  }),
+}));
+
 const mockInitialState = {
   engine: {
     backgroundState: {
@@ -147,4 +160,78 @@ describe('MultichainAddWalletActions', () => {
     expect(mockedNavigate).toHaveBeenCalledWith(Routes.MULTI_SRP.IMPORT);
     expect(mockProps.onBack).toHaveBeenCalled();
   });
+
+  describe('Analytics', () => {
+    it('tracks event when import wallet button is pressed', () => {
+      renderScreen(
+        () => <MultichainAddWalletActions {...mockProps} />,
+        {
+          name: 'MultichainAddWalletActions',
+        },
+        {
+          state: mockInitialState,
+        },
+      );
+
+      const importWalletButton = screen.getByTestId(
+        AddAccountBottomSheetSelectorsIDs.IMPORT_SRP_BUTTON,
+      );
+      fireEvent.press(importWalletButton);
+
+      expect(mockCreateEventBuilder).toHaveBeenCalledWith(
+        MetaMetricsEvents.IMPORT_SECRET_RECOVERY_PHRASE_CLICKED,
+      );
+      expect(mockTrackEvent).toHaveBeenCalledWith(
+        MetaMetricsEvents.IMPORT_SECRET_RECOVERY_PHRASE_CLICKED,
+      );
+    });
+
+    it('tracks event when import account button is pressed', () => {
+      renderScreen(
+        () => <MultichainAddWalletActions {...mockProps} />,
+        {
+          name: 'MultichainAddWalletActions',
+        },
+        {
+          state: mockInitialState,
+        },
+      );
+
+      const importAccountButton = screen.getByTestId(
+        AddAccountBottomSheetSelectorsIDs.IMPORT_ACCOUNT_BUTTON,
+      );
+      fireEvent.press(importAccountButton);
+
+      expect(mockCreateEventBuilder).toHaveBeenCalledWith(
+        MetaMetricsEvents.ACCOUNTS_IMPORTED_NEW_ACCOUNT,
+      );
+      expect(mockTrackEvent).toHaveBeenCalledWith(
+        MetaMetricsEvents.ACCOUNTS_IMPORTED_NEW_ACCOUNT,
+      );
+    });
+
+    it('tracks event when hardware wallet button is pressed', () => {
+      renderScreen(
+        () => <MultichainAddWalletActions {...mockProps} />,
+        {
+          name: 'MultichainAddWalletActions',
+        },
+        {
+          state: mockInitialState,
+        },
+      );
+
+      const hardwareWalletButton = screen.getByTestId(
+        AddAccountBottomSheetSelectorsIDs.ADD_HARDWARE_WALLET_BUTTON,
+      );
+      fireEvent.press(hardwareWalletButton);
+
+      expect(mockCreateEventBuilder).toHaveBeenCalledWith(
+        MetaMetricsEvents.ADD_HARDWARE_WALLET,
+      );
+      expect(mockTrackEvent).toHaveBeenCalledWith(
+        MetaMetricsEvents.ADD_HARDWARE_WALLET,
+      );
+    });
+  });
 });

app/component-library/components-temp/MultichainAccounts/MultichainAddWalletActions/MultichainAddWalletActions.tsx

@@ -74,7 +74,7 @@ const MultichainAddWalletActions = ({
         iconName: IconName.Usb,
         testID: AddAccountBottomSheetSelectorsIDs.ADD_HARDWARE_WALLET_BUTTON,
         isVisible: true,
-        analyticsEvent: MetaMetricsEvents.CONNECT_HARDWARE_WALLET,
+        analyticsEvent: MetaMetricsEvents.ADD_HARDWARE_WALLET,
         navigationAction: () => {
           navigate(Routes.HW.CONNECT);
           onBack();

app/components/UI/LedgerModals/LedgerConfirmationModal.test.tsx

@@ -19,8 +19,6 @@ import { strings } from '../../../../locales/i18n';
 import { useMetrics } from '../../hooks/useMetrics';
 import { MetaMetricsEvents } from '../../../core/Analytics';
 import { fireEvent } from '@testing-library/react-native';
-import { HardwareDeviceTypes } from '../../../constants/keyringTypes';
-import { MetricsEventBuilder } from '../../../core/Analytics/MetricsEventBuilder';
 
 jest.mock('../../hooks/Ledger/useBluetooth', () => ({
   __esModule: true,
@@ -47,9 +45,29 @@ jest.mock('@react-navigation/native', () => ({
 jest.mock('../../../components/hooks/useMetrics');
 
 const mockTrackEvent = jest.fn();
+const mockCreateEventBuilder = jest.fn();
 
 describe('LedgerConfirmationModal', () => {
   beforeEach(() => {
+    jest.clearAllMocks();
+
+    // Mock event builder chain
+    const mockEventBuilder = {
+      addProperties: jest.fn().mockReturnThis(),
+      addSensitiveProperties: jest.fn().mockReturnThis(),
+      removeProperties: jest.fn().mockReturnThis(),
+      removeSensitiveProperties: jest.fn().mockReturnThis(),
+      setSaveDataRecording: jest.fn().mockReturnThis(),
+      build: jest.fn().mockReturnValue({
+        name: 'test-event',
+        properties: {},
+        sensitiveProperties: {},
+        saveDataRecording: true,
+      }),
+    };
+
+    mockCreateEventBuilder.mockReturnValue(mockEventBuilder);
+
     // Mock hook return value
     (useBluetoothPermissions as jest.Mock).mockReturnValue({
       hasBluetoothPermissions: true,
@@ -71,7 +89,7 @@ describe('LedgerConfirmationModal', () => {
 
     (useMetrics as jest.MockedFn<typeof useMetrics>).mockReturnValue({
       trackEvent: mockTrackEvent,
-      createEventBuilder: MetricsEventBuilder.createEventBuilder,
+      createEventBuilder: mockCreateEventBuilder,
       enable: jest.fn(),
       addTraitsToUser: jest.fn(),
       createDataDeletionTask: jest.fn(),
@@ -143,10 +161,10 @@ describe('LedgerConfirmationModal', () => {
     expect(toJSON()).toMatchSnapshot();
   });
 
-  it('logs LEDGER_HARDWARE_WALLET_ERROR event when the ledger error occurs', async () => {
+  it('logs HARDWARE_WALLET_ERROR event when the ledger error occurs', async () => {
     const onConfirmation = jest.fn();
-
     const ledgerLogicToRun = jest.fn();
+
     (useLedgerBluetooth as jest.Mock).mockReturnValue({
       isSendingLedgerCommands: true,
       isAppLaunchConfirmationNeeded: false,
@@ -166,22 +184,11 @@ describe('LedgerConfirmationModal', () => {
       />,
     );
 
-    // eslint-disable-next-line no-empty-function
-    await act(async () => {});
-
     expect(onConfirmation).not.toHaveBeenCalled();
-
-    expect(mockTrackEvent).toHaveBeenNthCalledWith(
-      1,
-      MetricsEventBuilder.createEventBuilder(
-        MetaMetricsEvents.LEDGER_HARDWARE_WALLET_ERROR,
-      )
-        .addProperties({
-          device_type: HardwareDeviceTypes.LEDGER,
-          error: 'LEDGER_ETH_APP_NOT_INSTALLED',
-        })
-        .build(),
+    expect(mockCreateEventBuilder).toHaveBeenCalledWith(
+      MetaMetricsEvents.HARDWARE_WALLET_ERROR,
     );
+    expect(mockTrackEvent).toHaveBeenCalled();
   });
 
   it('renders SearchingForDeviceStep when not sending ledger commands', () => {
@@ -351,15 +358,14 @@ describe('LedgerConfirmationModal', () => {
       />,
     );
 
-    // eslint-disable-next-line no-empty-function
-    await act(async () => {});
-
     expect(ledgerLogicToRun).toHaveBeenCalledTimes(1);
 
     const retryButton = getByTestId(RETRY_BUTTON);
-    fireEvent.press(retryButton);
 
-    //Retry will run connectLedger again
+    await act(async () => {
+      fireEvent.press(retryButton);
+    });
+
     expect(ledgerLogicToRun).toHaveBeenCalledTimes(2);
   });
 
@@ -380,13 +386,12 @@ describe('LedgerConfirmationModal', () => {
       />,
     );
 
-    // eslint-disable-next-line no-empty-function
-    await act(async () => {});
-
     const retryButton = getByTestId(RETRY_BUTTON);
-    fireEvent.press(retryButton);
 
-    //Retry will run connectLedger again
+    await act(async () => {
+      fireEvent.press(retryButton);
+    });
+
     expect(checkPermissions).toHaveBeenCalledTimes(1);
   });
 
@@ -407,9 +412,6 @@ describe('LedgerConfirmationModal', () => {
       />,
     );
 
-    // eslint-disable-next-line no-empty-function
-    await act(async () => {});
-
     expect(onConfirmation).toHaveBeenCalled();
   });
 

app/components/UI/LedgerModals/LedgerConfirmationModal.tsx

@@ -79,7 +79,7 @@ const LedgerConfirmationModal = ({
       // Handle a super edge case of the user starting a transaction with the device connected
       // After arriving to confirmation the ETH app is not installed anymore this causes a crash.
       trackEvent(
-        createEventBuilder(MetaMetricsEvents.LEDGER_HARDWARE_WALLET_ERROR)
+        createEventBuilder(MetaMetricsEvents.HARDWARE_WALLET_ERROR)
           .addProperties({
             device_type: HardwareDeviceTypes.LEDGER,
             error: 'LEDGER_ETH_APP_NOT_INSTALLED',
@@ -95,9 +95,7 @@ const LedgerConfirmationModal = ({
       onRejection();
     } finally {
       trackEvent(
-        createEventBuilder(
-          MetaMetricsEvents.LEDGER_HARDWARE_TRANSACTION_CANCELLED,
-        )
+        createEventBuilder(MetaMetricsEvents.DAPP_TRANSACTION_CANCELLED)
           .addProperties({
             device_type: HardwareDeviceTypes.LEDGER,
           })
@@ -209,7 +207,7 @@ const LedgerConfirmationModal = ({
       }
       if (ledgerError !== LedgerCommunicationErrors.UserRefusedConfirmation) {
         trackEvent(
-          createEventBuilder(MetaMetricsEvents.LEDGER_HARDWARE_WALLET_ERROR)
+          createEventBuilder(MetaMetricsEvents.HARDWARE_WALLET_ERROR)
             .addProperties({
               device_type: HardwareDeviceTypes.LEDGER,
               error: `${ledgerError}`,
@@ -242,7 +240,7 @@ const LedgerConfirmationModal = ({
       }
       setPermissionErrorShown(true);
       trackEvent(
-        createEventBuilder(MetaMetricsEvents.LEDGER_HARDWARE_WALLET_ERROR)
+        createEventBuilder(MetaMetricsEvents.HARDWARE_WALLET_ERROR)
           .addProperties({
             device_type: HardwareDeviceTypes.LEDGER,
             error: 'LEDGER_BLUETOOTH_PERMISSION_ERR',
@@ -258,7 +256,7 @@ const LedgerConfirmationModal = ({
       });
 
       trackEvent(
-        createEventBuilder(MetaMetricsEvents.LEDGER_HARDWARE_WALLET_ERROR)
+        createEventBuilder(MetaMetricsEvents.HARDWARE_WALLET_ERROR)
           .addProperties({
             device_type: HardwareDeviceTypes.LEDGER,
             error: 'LEDGER_BLUETOOTH_CONNECTION_ERR',