fix(bridge): preserve Unified SwapBridge funnel metrics (#9986)

## Summary
- Add `has_sufficient_funds` to Unified SwapBridge Quotes Received
metrics for
[SWAPS-4977](https://consensyssoftware.atlassian.net/browse/SWAPS-4977).
- Preserve explicit slippage intent and normalized slippage limits
across quote, submission, and history metrics for
[SWAPS-4979](https://consensyssoftware.atlassian.net/browse/SWAPS-4979).
- Support client fallbacks for incomplete quote USD and token-symbol
data, while preserving Quick Buy and Batch Sell legacy behavior.

## Test plan
- [x] `yarn workspace @metamask/bridge-controller test --coverage=false
--runInBand --testPathPatterns=src/utils/metrics/properties.test.ts`
- [x] `yarn workspace @metamask/bridge-status-controller test
--coverage=false --runInBand
--testPathPatterns=src/utils/metrics.test.ts`
- [x] Bridge status-controller tests and Batch Sell tests
- [x] Core typecheck and targeted ESLint
- [x] Prettier and `git diff --check`


[SWAPS-4977]:
https://consensyssoftware.atlassian.net/browse/SWAPS-4977?atlOrigin=eyJpIjoiNWRkNTljNzYxNjVmNDY3MDlhMDU5Y2ZhYzA5YTRkZjUiLCJwIjoiZ2l0aHViLWNvbS1KU1cifQ
[SWAPS-4979]:
https://consensyssoftware.atlassian.net/browse/SWAPS-4979?atlOrigin=eyJpIjoiNWRkNTljNzYxNjVmNDY3MDlhMDU5Y2ZhYzA5YTRkZjUiLCJwIjoiZ2l0aHViLWNvbS1KU1cifQ

<!-- CURSOR_SUMMARY -->
---

> [!NOTE]
> **Low Risk**
> Analytics and metrics payload changes only; no transaction or auth
logic. Snapshot/test updates reflect corrected slippage and
custom_slippage semantics.
> 
> **Overview**
> Fixes **Unified SwapBridge** analytics so quote-through-completion
events carry consistent balance and slippage fields.
> 
> **Quotes Received** now includes **`has_sufficient_funds`** (from the
quote request’s insufficient-balance flag). **`slippage_limit`** is
always a number (**`0`** means auto when no explicit limit), including
on request metadata and in **`getQuotesReceivedProperties`**, which also
accepts optional client fallbacks for slippage, **`custom_slippage`**,
USD amount, and token symbols when quote data is incomplete.
> 
> **Bridge status** threads **`quotesReceivedContext`** into
submit/pre-confirmation metrics, persists **`customSlippage`** on
history, and prefers that (with Batch Sell / Quick Buy legacy inference)
when rebuilding **`custom_slippage`** and **`slippage_limit`** after
submission instead of inferring only from quote slippage.
> 
> <sup>Reviewed by [Cursor Bugbot](https://cursor.com/bugbot) for commit
b915d67. Bugbot is set up for automated
code reviews on this repo. Configure
[here](https://www.cursor.com/dashboard/bugbot).</sup>
<!-- /CURSOR_SUMMARY -->

Author: bfullam

packages/bridge-controller/CHANGELOG.md

@@ -11,6 +11,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - Bump `@metamask/remote-feature-flag-controller` from `^6.0.0` to `^6.1.0` ([#9980](https://github.com/MetaMask/core/pull/9980))
 
+### Fixed
+
+- Include sufficient-funds and normalized slippage properties in Unified SwapBridge quote metrics ([#9986](https://github.com/MetaMask/core/pull/9986))
+
 ## [80.0.0]
 
 ### Added

packages/bridge-controller/src/__snapshots__/bridge-controller.test.ts.snap

@@ -136,7 +136,7 @@ exports[`BridgeController trackUnifiedSwapBridgeEvent bridge-status-controller c
       "quotes_count": 0,
       "quotes_list": [],
       "security_warnings": [],
-      "slippage_limit": undefined,
+      "slippage_limit": 0,
       "source_transaction": "PENDING",
       "stx_enabled": false,
       "swap_type": "crosschain",
@@ -262,7 +262,7 @@ exports[`BridgeController trackUnifiedSwapBridgeEvent client-side calls should t
       "price_impact": 6,
       "quotes_count": 0,
       "quotes_list": [],
-      "slippage_limit": undefined,
+      "slippage_limit": 0,
       "stx_enabled": false,
       "swap_type": "crosschain",
       "token_address_destination": null,
@@ -296,7 +296,7 @@ exports[`BridgeController trackUnifiedSwapBridgeEvent client-side calls should t
       "price_impact": 6,
       "quotes_count": 0,
       "quotes_list": [],
-      "slippage_limit": undefined,
+      "slippage_limit": 0,
       "sort_order": "cost_ascending",
       "stx_enabled": false,
       "swap_type": "crosschain",
@@ -408,7 +408,7 @@ exports[`BridgeController trackUnifiedSwapBridgeEvent client-side calls should t
       "input_primary_denomination": "token_amount",
       "is_hardware_wallet": false,
       "location": "Unknown",
-      "slippage_limit": undefined,
+      "slippage_limit": 0,
       "swap_type": "crosschain",
       "token_address_destination": null,
       "token_address_source": "eip155:1/slip44:60",
@@ -443,7 +443,7 @@ exports[`BridgeController trackUnifiedSwapBridgeEvent client-side calls should t
       "quoted_time_minutes": 10,
       "quotes_count": 0,
       "quotes_list": [],
-      "slippage_limit": undefined,
+      "slippage_limit": 0,
       "swap_type": "crosschain",
       "token_address_destination": null,
       "token_address_source": "eip155:1/slip44:60",
@@ -480,6 +480,7 @@ exports[`BridgeController trackUnifiedSwapBridgeEvent client-side calls should t
       "gas_included": false,
       "gas_included_7702": false,
       "has_gas_included_quote": false,
+      "has_sufficient_funds": true,
       "initial_load_time_all_quotes": 0,
       "input_primary_denomination": "token_amount",
       "is_hardware_wallet": false,
@@ -490,7 +491,7 @@ exports[`BridgeController trackUnifiedSwapBridgeEvent client-side calls should t
       "quotes_count": 0,
       "quotes_list": [],
       "refresh_count": 0,
-      "slippage_limit": undefined,
+      "slippage_limit": 0,
       "swap_type": "crosschain",
       "token_address_destination": null,
       "token_address_source": "eip155:1/slip44:60",
@@ -588,6 +589,7 @@ exports[`BridgeController updateBridgeQuoteRequestParams should only poll once i
       "gas_included": false,
       "gas_included_7702": false,
       "has_gas_included_quote": false,
+      "has_sufficient_funds": false,
       "initial_load_time_all_quotes": 11000,
       "input_primary_denomination": "token_amount",
       "is_hardware_wallet": false,

packages/bridge-controller/src/bridge-controller.ts

@@ -1212,7 +1212,7 @@ export class BridgeController extends StaticIntervalPollingController<BridgePoll
     );
 
     return {
-      slippage_limit: quoteRequest.slippage,
+      slippage_limit: quoteRequest.slippage ?? 0,
       swap_type: getSwapTypeFromQuote(quoteRequest),
       custom_slippage: isCustomSlippage(quoteRequest.slippage),
       account_hardware_type: accountHardwareType,
@@ -1361,6 +1361,7 @@ export class BridgeController extends StaticIntervalPollingController<BridgePoll
           ...this.#getRequestMetadata(),
           ...this.#getQuoteFetchData(),
           refresh_count: this.state.quotesRefreshCount,
+          has_sufficient_funds: !quoteRequest.insufficientBal,
           ...inputPrimaryDenominationProperties,
           ...baseProperties,
         };

packages/bridge-controller/src/utils/metrics/properties.test.ts

@@ -436,6 +436,7 @@ describe('properties', () => {
           "price_impact": 0,
           "provider": "bridge1_bridge1",
           "quoted_time_minutes": 1,
+          "slippage_limit": 0,
           "token_symbol_destination": "USDC",
           "token_symbol_source": "ETH",
           "usd_amount_source": 0,
@@ -445,13 +446,76 @@ describe('properties', () => {
           "warnings": [],
         }
       `);
+
+      const quoteWithSlippage = {
+        ...mockQuoteResponseV2,
+        quote: {
+          ...mockQuoteResponseV2.quote,
+          slippage: 0.5,
+        },
+      };
+
+      expect(
+        getQuotesReceivedProperties(
+          quoteWithSlippage,
+          [],
+          true,
+          undefined,
+          undefined,
+          undefined,
+          { slippage_limit: 3.5 },
+        ).slippage_limit,
+      ).toBe(3.5);
+      expect(
+        getQuotesReceivedProperties(
+          quoteWithSlippage,
+          [],
+          true,
+          undefined,
+          undefined,
+          undefined,
+          { custom_slippage: true, slippage_limit: undefined },
+        ).slippage_limit,
+      ).toBe(0.5);
+      expect(
+        getQuotesReceivedProperties(quoteWithSlippage).slippage_limit,
+      ).toBe(0.5);
     });
 
     it('should return empty source and null destination token symbols when activeQuote is null', () => {
       const result = getQuotesReceivedProperties(null);
 
       expect(result.token_symbol_source).toBe('');
       expect(result.token_symbol_destination).toBeNull();
+      expect(result.slippage_limit).toBe(0);
+    });
+
+    it('should use client fallbacks and explicit slippage context', () => {
+      const result = getQuotesReceivedProperties(
+        null,
+        [],
+        true,
+        undefined,
+        undefined,
+        undefined,
+        {
+          custom_slippage: true,
+          slippage_limit: 3.5,
+          usd_amount_source: 100,
+          token_symbol_source: 'ETH',
+          token_symbol_destination: 'USDC',
+        },
+      );
+
+      expect(result).toStrictEqual(
+        expect.objectContaining({
+          custom_slippage: true,
+          slippage_limit: 3.5,
+          token_symbol_source: 'ETH',
+          token_symbol_destination: 'USDC',
+          usd_amount_source: 100,
+        }),
+      );
     });
 
     it('should derive token symbols from the active quote asset metadata', () => {

packages/bridge-controller/src/utils/metrics/properties.ts

@@ -166,8 +166,28 @@ export const getQuotesReceivedProperties = (
   recommendedQuote?: null | QuoteResponse,
   usdBalanceSource?: number,
   hasSufficientGasForQuote?: boolean | null,
+  options: {
+    // eslint-disable-next-line @typescript-eslint/naming-convention -- analytics property
+    custom_slippage?: boolean;
+    // eslint-disable-next-line @typescript-eslint/naming-convention -- analytics property
+    slippage_limit?: number;
+    // eslint-disable-next-line @typescript-eslint/naming-convention -- analytics property
+    usd_amount_source?: number;
+    // eslint-disable-next-line @typescript-eslint/naming-convention -- analytics property
+    token_symbol_source?: string;
+    // eslint-disable-next-line @typescript-eslint/naming-convention -- analytics property
+    token_symbol_destination?: string | null;
+  } = {},
 ) => {
   const provider = activeQuote ? formatProviderLabel(activeQuote.quote) : '_';
+  const quoteUsdAmountSource = activeQuote?.quote?.src?.usd;
+  const quoteTokenSymbolSource = activeQuote?.quote.src.asset.symbol;
+  const quoteTokenSymbolDestination = activeQuote?.quote.dest.asset.symbol;
+  const usdAmountSource = Number(
+    quoteUsdAmountSource ?? options.usd_amount_source ?? 0,
+  );
+  const slippageLimit =
+    options.slippage_limit ?? activeQuote?.quote?.slippage ?? 0;
   return {
     can_submit: isSubmittable,
     gas_included: Boolean(activeQuote?.quote?.gasIncluded),
@@ -178,20 +198,26 @@ export const getQuotesReceivedProperties = (
     usd_quoted_gas: Number(activeQuote?.quote?.feeData?.network?.[0]?.usd ?? 0),
     usd_quoted_return: Number(activeQuote?.quote?.dest?.usd ?? 0),
     usd_balance_source: usdBalanceSource ?? 0,
-    usd_amount_source: Number(activeQuote?.quote?.src?.usd ?? 0),
+    usd_amount_source: usdAmountSource,
+    slippage_limit: slippageLimit,
     best_quote_provider: recommendedQuote
       ? formatProviderLabel(recommendedQuote.quote)
       : provider,
     provider,
-    token_symbol_source: activeQuote?.quote.src.asset.symbol ?? '',
-    token_symbol_destination: activeQuote?.quote.dest.asset.symbol ?? null,
+    token_symbol_source:
+      quoteTokenSymbolSource ?? options.token_symbol_source ?? '',
+    token_symbol_destination:
+      quoteTokenSymbolDestination ?? options.token_symbol_destination ?? null,
     warnings,
     price_impact: Number(
       activeQuote?.quote.priceData?.priceImpact?.amount ?? 0,
     ),
     ...(hasSufficientGasForQuote !== undefined && {
       has_sufficient_gas_for_quote: hasSufficientGasForQuote,
     }),
+    ...(options.custom_slippage !== undefined && {
+      custom_slippage: options.custom_slippage,
+    }),
     feature_id: activeQuote?.featureId ?? FeatureId.UNIFIED_SWAP_BRIDGE,
   };
 };

packages/bridge-controller/src/utils/metrics/types.ts

@@ -46,7 +46,7 @@ export type AccountHardwareType =
   | null;
 
 export type RequestMetadata = {
-  slippage_limit?: number; // undefined === auto
+  slippage_limit: number; // 0 === auto when no numeric limit is available
   custom_slippage: boolean;
   usd_amount_source: number; // Use quoteResponse when available
   stx_enabled: boolean;
@@ -221,6 +221,7 @@ type RequiredEventContextFromClientBase = {
     token_symbol_source: RequestParams['token_symbol_source'];
     token_symbol_destination: RequestParams['token_symbol_destination'];
     token_security_type_destination: RequestParams['token_security_type_destination'];
+    custom_slippage?: RequestMetadata['custom_slippage'];
   } & InputPrimaryDenominationData;
   [UnifiedSwapBridgeEventName.QuotesReceived]: TradeData &
     Pick<RequestParams, 'token_symbol_source' | 'token_symbol_destination'> &
@@ -232,6 +233,8 @@ type RequiredEventContextFromClientBase = {
       usd_balance_source?: number;
       has_sufficient_gas_for_quote?: boolean | null;
       usd_amount_source: number;
+      custom_slippage?: RequestMetadata['custom_slippage'];
+      slippage_limit?: RequestMetadata['slippage_limit'];
     };
   [UnifiedSwapBridgeEventName.QuotesError]: Pick<
     RequestMetadata,
@@ -401,6 +404,7 @@ export type EventPropertiesFromControllerState = {
     QuoteFetchData &
     TradeData & {
       refresh_count: number; // starts from 0
+      has_sufficient_funds: boolean;
     } & InputPrimaryDenominationData;
   [UnifiedSwapBridgeEventName.QuotesError]: RequestParams &
     RequestMetadata & {

packages/bridge-status-controller/CHANGELOG.md

@@ -7,6 +7,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Fixed
+
+- Preserve explicit slippage intent and normalized slippage limits in post-submission Unified SwapBridge metrics ([#9986](https://github.com/MetaMask/core/pull/9986))
+
 ## [75.3.0]
 
 ### Changed