feat: cp-7.60.0 validate source amount in metamask pay (#22758)

## **Description**

Validate the raw source amount in MetaMask Pay after quotes are
retrieved.

Also validate the source network fee using the max raw amount, rather
than the estimated USD value.

## **Changelog**

CHANGELOG entry: null

## **Related issues**

Fixes:
[#6263](MetaMask/MetaMask-planning#6263)
#22722

## **Manual testing steps**

## **Screenshots/Recordings**

### **Before**

### **After**

## **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]
> Validates MetaMask Pay source amounts and max network fees using new
totals fields, consolidates insufficient-fee alerts, updates fee
displays/metrics, and bumps transaction-pay-controller to v7.
> 
> - **Confirmations / Pay**:
> - **Validation & totals**: Use
`totals.fees.sourceNetwork.estimate.usd` for displayed network fees and
validate fees with raw amounts (`sourceAmount.raw` +
`fees.sourceNetwork.max.*`).
> - **Alerts**: Add `AlertKeys.InsufficientPayTokenFees`; fold
native-fee checks into `useInsufficientPayTokenBalanceAlert`; remove
`useInsufficientPayTokenNativeAlert`; update alert metrics mapping and
alert filtering; rename prop to `pendingAmountUsd`.
> - **UI**: `BridgeFeeRow` sums provider + source network estimate +
target network; tooltip network fee uses estimate.
> - **Metrics**: `mm_pay_network_fee_usd` now from
`fees.sourceNetwork.estimate.usd`; strategy/quote metrics unchanged.
> - **Tokens**: `useTokenWithBalance` now exposes `balanceRaw`.
> - **Selectors**: Default `selectTransactionPayTokensByTransactionId`
to `[]`.
> - **I18n**: Update `insufficient_pay_token_balance_fees.message` copy.
> - **Dependencies**: Bump `@metamask/transaction-pay-controller` to
`^7.0.0`.
> - **Tests**: Update/add tests for new fee fields, alerts, metrics, and
token balance raw support.
> 
> <sup>Written by [Cursor
Bugbot](https://cursor.com/dashboard?tab=bugbot) for commit
7a2c188. This will update automatically
on new commits. Configure
[here](https://cursor.com/dashboard?tab=bugbot).</sup>
<!-- /CURSOR_SUMMARY -->

Author: matthewwalsh0

app/components/Views/confirmations/components/rows/bridge-fee-row/bridge-fee-row.test.tsx

@@ -52,7 +52,7 @@ describe('BridgeFeeRow', () => {
     useTransactionTotalsMock.mockReturnValue({
       fees: {
         provider: { usd: '1.00' },
-        sourceNetwork: { usd: '0.20' },
+        sourceNetwork: { estimate: { usd: '0.20' } },
         targetNetwork: { usd: '0.03' },
       },
     } as TransactionPayTotals);

app/components/Views/confirmations/components/rows/bridge-fee-row/bridge-fee-row.tsx

@@ -40,7 +40,7 @@ export function BridgeFeeRow() {
 
     return formatFiat(
       new BigNumber(totals.fees.provider.usd)
-        .plus(totals.fees.sourceNetwork.usd)
+        .plus(totals.fees.sourceNetwork.estimate.usd)
         .plus(totals.fees.targetNetwork.usd),
     );
   }, [totals, formatFiat]);
@@ -133,7 +133,7 @@ function FeesTooltip({
   const networkFeeUsd = useMemo(
     () =>
       formatFiat(
-        new BigNumber(totals.fees.sourceNetwork.usd).plus(
+        new BigNumber(totals.fees.sourceNetwork.estimate.usd).plus(
           totals.fees.targetNetwork.usd,
         ),
       ),

app/components/Views/confirmations/constants/alerts.ts

@@ -6,6 +6,7 @@ export enum AlertKeys {
   InsufficientBalance = 'insufficient_balance',
   InsufficientPayTokenBalance = 'insufficient_pay_token_balance',
   InsufficientPayTokenNative = 'insufficient_pay_token_native',
+  InsufficientPayTokenFees = 'insufficient_pay_token_fees',
   InsufficientPredictBalance = 'insufficient_predict_balance',
   NoPayTokenQuotes = 'no_pay_token_quotes',
   PendingTransaction = 'pending_transaction',

app/components/Views/confirmations/hooks/alerts/useConfirmationAlerts.test.ts

@@ -15,7 +15,6 @@ import { useSignedOrSubmittedAlert } from './useSignedOrSubmittedAlert';
 import { usePendingTransactionAlert } from './usePendingTransactionAlert';
 import { useInsufficientPayTokenBalanceAlert } from './useInsufficientPayTokenBalanceAlert';
 import { useNoPayTokenQuotesAlert } from './useNoPayTokenQuotesAlert';
-import { useInsufficientPayTokenNativeAlert } from './useInsufficientPayTokenNativeAlert';
 import { useInsufficientPredictBalanceAlert } from './useInsufficientPredictBalanceAlert';
 import { useBurnAddressAlert } from './useBurnAddressAlert';
 
@@ -28,7 +27,6 @@ jest.mock('./usePendingTransactionAlert');
 jest.mock('./useBatchedUnusedApprovalsAlert');
 jest.mock('./useInsufficientPayTokenBalanceAlert');
 jest.mock('./useNoPayTokenQuotesAlert');
-jest.mock('./useInsufficientPayTokenNativeAlert');
 jest.mock('./useInsufficientPredictBalanceAlert');
 jest.mock('./useBurnAddressAlert');
 
@@ -118,15 +116,6 @@ describe('useConfirmationAlerts', () => {
     },
   ];
 
-  const mockInsufficientPayTokenNativeAlert: Alert[] = [
-    {
-      key: 'InsufficientPayTokenNativeAlert',
-      title: 'Test Insufficient Pay Token Native Alert',
-      message: ALERT_MESSAGE_MOCK,
-      severity: Severity.Danger,
-    },
-  ];
-
   const mockInsufficientPredictBalanceAlert: Alert[] = [
     {
       key: 'InsufficientPredictBalanceAlert',
@@ -155,7 +144,6 @@ describe('useConfirmationAlerts', () => {
     (useBatchedUnusedApprovalsAlert as jest.Mock).mockReturnValue([]);
     (useInsufficientPayTokenBalanceAlert as jest.Mock).mockReturnValue([]);
     (useNoPayTokenQuotesAlert as jest.Mock).mockReturnValue([]);
-    (useInsufficientPayTokenNativeAlert as jest.Mock).mockReturnValue([]);
     (useInsufficientPredictBalanceAlert as jest.Mock).mockReturnValue([]);
     (useBurnAddressAlert as jest.Mock).mockReturnValue([]);
   });
@@ -219,9 +207,6 @@ describe('useConfirmationAlerts', () => {
     (useNoPayTokenQuotesAlert as jest.Mock).mockReturnValue(
       mockNoPayTokenQuotesAlert,
     );
-    (useInsufficientPayTokenNativeAlert as jest.Mock).mockReturnValue(
-      mockInsufficientPayTokenNativeAlert,
-    );
     (useInsufficientPredictBalanceAlert as jest.Mock).mockReturnValue(
       mockInsufficientPredictBalanceAlert,
     );
@@ -238,7 +223,6 @@ describe('useConfirmationAlerts', () => {
       ...mockSignedOrSubmittedAlert,
       ...mockInsufficientPayTokenBalanceAlert,
       ...mockNoPayTokenQuotesAlert,
-      ...mockInsufficientPayTokenNativeAlert,
       ...mockInsufficientPredictBalanceAlert,
       ...mockBurnAddressAlert,
       ...mockUpgradeAccountAlert,

app/components/Views/confirmations/hooks/alerts/useConfirmationAlerts.ts

@@ -9,7 +9,6 @@ import { Alert } from '../../types/alerts';
 import { useBatchedUnusedApprovalsAlert } from './useBatchedUnusedApprovalsAlert';
 import { useInsufficientPayTokenBalanceAlert } from './useInsufficientPayTokenBalanceAlert';
 import { useNoPayTokenQuotesAlert } from './useNoPayTokenQuotesAlert';
-import { useInsufficientPayTokenNativeAlert } from './useInsufficientPayTokenNativeAlert';
 import { useInsufficientPredictBalanceAlert } from './useInsufficientPredictBalanceAlert';
 import { useBurnAddressAlert } from './useBurnAddressAlert';
 
@@ -27,7 +26,6 @@ function useTransactionAlerts(): Alert[] {
   const insufficientPayTokenBalanceAlert =
     useInsufficientPayTokenBalanceAlert();
   const noPayTokenQuotesAlert = useNoPayTokenQuotesAlert();
-  const insufficientPayTokenNativeAlert = useInsufficientPayTokenNativeAlert();
   const insufficientPredictBalanceAlert = useInsufficientPredictBalanceAlert();
   const burnAddressAlert = useBurnAddressAlert();
 
@@ -39,7 +37,6 @@ function useTransactionAlerts(): Alert[] {
       ...signedOrSubmittedAlert,
       ...insufficientPayTokenBalanceAlert,
       ...noPayTokenQuotesAlert,
-      ...insufficientPayTokenNativeAlert,
       ...insufficientPredictBalanceAlert,
       ...burnAddressAlert,
     ],
@@ -50,7 +47,6 @@ function useTransactionAlerts(): Alert[] {
       signedOrSubmittedAlert,
       insufficientPayTokenBalanceAlert,
       noPayTokenQuotesAlert,
-      insufficientPayTokenNativeAlert,
       insufficientPredictBalanceAlert,
       burnAddressAlert,
     ],