chore(runway): cherry-pick feat(predict): remove CLOB v1 support and migrate to pUSD (#29819)

- feat(predict): remove CLOB v1 support and migrate to pUSD cp-7.76.0
(#29451)

## **Description**

This PR removes legacy Predict Polymarket CLOB v1 support and completes
the pUSD migration in Predict-owned code.

It includes:
- CLOB v2 as the unconditional Polymarket protocol path.
- Removal of CLOB v1 protocol selection, order codec branches, and v1
Safe helper wrappers.
- pUSD as the canonical Predict trading, fee, deposit, withdraw,
reward-fee, and claim gas top-up token.
- Legacy Safe USDC.e retained only as temporary hidden sweep state.
- Legacy USDC.e → pUSD sweep preflight for deposit, withdraw, trade, and
claim operations.
- Displayed Predict balance as total recoverable Predict funds (`pUSD +
legacy USDC.e`).
- In-memory cache to stop refetching legacy USDC.e balance for a Safe
after a zero balance is observed.

Stack note: this PR is stacked on the confirmations-only pUSD PR so the
diff stays limited to Predict-owned files.

## **Changelog**

CHANGELOG entry: Updated Predict to use pUSD and the Polymarket CLOB v2
protocol.

## **Related issues**

Fixes:
[PRED-851](https://consensyssoftware.atlassian.net/browse/PRED-851) ,
[PRED-852](https://consensyssoftware.atlassian.net/browse/PRED-852)

## **Manual testing steps**

```gherkin
Feature: Predict pUSD migration

  Scenario: user with pUSD places a Predict trade
    Given the user has a funded Predict Safe with pUSD
    When the user places a Predict trade
    Then the order is submitted through the CLOB v2 path
    And pUSD is used for trading and fee authorization

  Scenario: legacy user performs their first Predict operation
    Given the user has legacy USDC.e in their Predict Safe
    When the user deposits, withdraws, trades, or claims
    Then the Safe preflight wraps legacy USDC.e into pUSD before the main operation
```

## **Screenshots/Recordings**

### **Before**

N/A — code-only protocol migration PR; no screenshots captured.

### **After**

N/A — code-only protocol migration PR; no screenshots captured.

## **Testing**

- `yarn lint:tsc`
- `yarn jest

app/components/UI/Predict/providers/polymarket/protocol/definitions.test.ts

app/components/UI/Predict/providers/polymarket/protocol/orderCodec.test.ts

app/components/UI/Predict/providers/polymarket/protocol/transport.test.ts

app/components/UI/Predict/providers/polymarket/preflight/v2AllowanceRequirements.test.ts

app/components/UI/Predict/providers/polymarket/preflight/withdraw.test.ts

app/components/UI/Predict/providers/polymarket/preflight/workflows.test.ts

app/components/UI/Predict/providers/polymarket/PolymarketProvider.test.ts
app/components/UI/Predict/controllers/PredictController.test.ts
app/components/UI/Predict/hooks/usePredictBalanceTokenFilter.test.ts
app/components/UI/Predict/hooks/usePredictRewards.test.ts

app/components/UI/Predict/views/PredictBuyWithAnyToken/components/PredictPayWithRow/PredictPayWithRow.test.tsx
--runInBand --forceExit`

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

#### 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](https://consensyssoftware.atlassian.net/wiki/spaces/TL1/pages/edit-v2/401401446401?draftShareId=9d77e1e1-4bdc-4be1-9ebb-ccd916988d93)
to import wallets with many accounts and tokens
- [ ] I've instrumented key operations with Sentry traces for production
performance metrics
- See [`trace()`](/app/util/trace.ts) for usage and

[`addToken`](/app/components/Views/AddAsset/components/AddCustomToken/AddCustomToken.tsx#L274)
for an example

For performance guidelines and tooling, see the [Performance

Guide](https://consensyssoftware.atlassian.net/wiki/spaces/TL1/pages/400085549067/Performance+Guide+for+Engineers).

## **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**
> Updates on-chain token identifiers/addresses used for Predict gas fee
and rewards calculations, which could impact transactions if
misconfigured. Changes are localized to Predict hooks/controller and
accompanying tests.
> 
> **Overview**
> Predict now consistently references the **pUSD / CLOB v2 collateral**
across Predict-owned code: `PredictController` uses
`MATIC_CONTRACTS_V2.collateral` as the `gasFeeToken` for claim/withdraw
`addTransactionBatch`, `usePredictBalanceTokenFilter` displays the
Predict balance row using the `POLYGON_PUSD` token (icon + symbol), and
`usePredictRewards` estimates points using `POLYGON_PUSD_CAIP_ASSET_ID`.
> 
> Cleans up account-state handling by removing `hasAllowances`
expectations/tests and updating `usePredictAccountState` docs to reflect
the slimmer `AccountState` shape.
> 
> <sup>Reviewed by [Cursor Bugbot](https://cursor.com/bugbot) for commit
7dfda61. Bugbot is set up for automated
code reviews on this repo. Configure
[here](https://www.cursor.com/dashboard/bugbot).</sup>
<!-- /CURSOR_SUMMARY -->

[PRED-851]:

https://consensyssoftware.atlassian.net/browse/PRED-851?atlOrigin=eyJpIjoiNWRkNTljNzYxNjVmNDY3MDlhMDU5Y2ZhYzA5YTRkZjUiLCJwIjoiZ2l0aHViLWNvbS1KU1cifQ

---------

Co-authored-by: Caainã Jeronimo <caainaje@gmail.com>
[bf54b9b](bf54b9b)

[PRED-851]:
https://consensyssoftware.atlassian.net/browse/PRED-851?atlOrigin=eyJpIjoiNWRkNTljNzYxNjVmNDY3MDlhMDU5Y2ZhYzA5YTRkZjUiLCJwIjoiZ2l0aHViLWNvbS1KU1cifQ

Co-authored-by: Luis Taniça <matallui@gmail.com>
Co-authored-by: Caainã Jeronimo <caainaje@gmail.com>

Author: 3 people

app/components/UI/Predict/controllers/PredictController.test.ts

@@ -5721,7 +5721,6 @@ describe('PredictController', () => {
       const mockAccountState = {
         address: '0xProxyAddress' as `0x${string}`,
         isDeployed: true,
-        hasAllowances: true,
         balance: 100.5,
       };
 

app/components/UI/Predict/controllers/PredictController.ts

@@ -57,7 +57,7 @@ import { GEO_BLOCKED_COUNTRIES } from '../constants/geoblock';
 import { PREDICT_BALANCE_PLACEHOLDER_ADDRESS } from '../constants/transactions';
 import { PolymarketProvider } from '../providers/polymarket/PolymarketProvider';
 import {
-  MATIC_CONTRACTS,
+  MATIC_CONTRACTS_V2,
   POLYMARKET_PROVIDER_ID,
 } from '../providers/polymarket/constants';
 import { Signer } from '../providers/types';
@@ -1453,7 +1453,7 @@ export class PredictController extends BaseController<
         disableHook: true,
         disableSequential: true,
         // Temporarily breaking abstraction, can instead be abstracted via provider.
-        gasFeeToken: MATIC_CONTRACTS.collateral as Hex,
+        gasFeeToken: MATIC_CONTRACTS_V2.collateral as Hex,
         transactions,
       });
 
@@ -2564,7 +2564,7 @@ export class PredictController extends BaseController<
         disableSequential: true,
         requireApproval: true,
         // Temporarily breaking abstraction, can instead be abstracted via provider.
-        gasFeeToken: MATIC_CONTRACTS.collateral as Hex,
+        gasFeeToken: MATIC_CONTRACTS_V2.collateral as Hex,
         transactions: [transaction],
       });
 

app/components/UI/Predict/hooks/usePredictAccountState.test.ts

@@ -63,7 +63,6 @@ describe('usePredictAccountState', () => {
   const mockAccountState = {
     address: '0x1234567890abcdef1234567890abcdef12345678',
     isDeployed: true,
-    hasAllowances: true,
   };
 
   beforeEach(() => {
@@ -117,7 +116,6 @@ describe('usePredictAccountState', () => {
       expect(mockGetAccountState).toHaveBeenCalledWith({});
       expect(result.current.data?.address).toEqual(mockAccountState.address);
       expect(result.current.data?.isDeployed).toBe(true);
-      expect(result.current.data?.hasAllowances).toBe(true);
       expect(result.current.error).toBeNull();
     });
 
@@ -215,24 +213,6 @@ describe('usePredictAccountState', () => {
       expect(result.current.data?.isDeployed).toBe(false);
     });
 
-    it('returns hasAllowances as false when account lacks allowances', async () => {
-      const { Wrapper } = createWrapper();
-      mockGetAccountState.mockResolvedValue({
-        ...mockAccountState,
-        hasAllowances: false,
-      });
-
-      const { result } = renderHook(() => usePredictAccountState(), {
-        wrapper: Wrapper,
-      });
-
-      await waitFor(() => {
-        expect(result.current.data).toBeDefined();
-      });
-
-      expect(result.current.data?.hasAllowances).toBe(false);
-    });
-
     it('has undefined data when query is disabled', () => {
       const { Wrapper } = createWrapper();
       const { result } = renderHook(

app/components/UI/Predict/hooks/usePredictAccountState.ts

@@ -15,7 +15,7 @@ interface UsePredictAccountStateOptions {
 }
 
 /**
- * Fetches the Predict account state (address, deployment status, allowances).
+ * Fetches the Predict account state (address and deployment status).
  */
 export function usePredictAccountState(
   options: UsePredictAccountStateOptions = {},

app/components/UI/Predict/hooks/usePredictBalanceTokenFilter.test.ts

@@ -52,10 +52,6 @@ jest.mock('../../../Views/confirmations/utils/transaction', () => ({
   hasTransactionType: jest.fn(),
 }));
 
-jest.mock('../../../../util/networks', () => ({
-  getNetworkImageSource: jest.fn(() => 'polygon-network-badge'),
-}));
-
 const mockHasTransactionType = hasTransactionType as jest.MockedFunction<
   typeof hasTransactionType
 >;
@@ -85,7 +81,7 @@ describe('usePredictBalanceTokenFilter', () => {
     mockPredictBalance = 100;
     mockTransactionMeta = null;
     mockHasTransactionType.mockReturnValue(false);
-    mockUseSelector.mockReturnValue({ image: 'usdce-token-image' });
+    mockUseSelector.mockReturnValue({ image: 'pusd-token-image' });
     mockNavigate.mockReset();
   });
 
@@ -165,19 +161,19 @@ describe('usePredictBalanceTokenFilter', () => {
     expect((filteredTokens[0] as HighlightedItem).fiat).toBe('$42.50');
   });
 
-  it('shows name_description as USDC.e on the Predict balance row', () => {
+  it('shows name_description as pUSD on the Predict balance row', () => {
     mockHasTransactionType.mockReturnValue(true);
     const tokens = [createMockToken()];
 
     const { result } = renderHook(() => usePredictBalanceTokenFilter());
     const filteredTokens = result.current(tokens);
 
     expect((filteredTokens[0] as HighlightedItem).name_description).toBe(
-      'USDC.e',
+      'pUSD',
     );
   });
 
-  it('uses empty string for icon when usdceToken is null', () => {
+  it('uses empty string for icon when pusdToken is null', () => {
     mockHasTransactionType.mockReturnValue(true);
     mockUseSelector.mockReturnValue(null);
     const tokens = [createMockToken()];

app/components/UI/Predict/hooks/usePredictBalanceTokenFilter.ts

@@ -1,12 +1,14 @@
+import { TransactionType } from '@metamask/transaction-controller';
 import { BigNumber } from 'bignumber.js';
 import { useCallback } from 'react';
 import { useNavigation } from '@react-navigation/native';
 import { useSelector } from 'react-redux';
+import { strings } from '../../../../../locales/i18n';
+import Routes from '../../../../constants/navigation/Routes';
 import { RootState } from '../../../../reducers';
 import { selectSingleTokenByAddressAndChainId } from '../../../../selectors/tokensController';
 import useFiatFormatter from '../../SimulationDetails/FiatDisplay/useFiatFormatter';
-import { POLYGON_USDCE } from '../../../Views/confirmations/constants/predict';
-import { TransactionType } from '@metamask/transaction-controller';
+import { POLYGON_PUSD } from '../../../Views/confirmations/constants/predict';
 import { useTransactionMetadataRequest } from '../../../Views/confirmations/hooks/transactions/useTransactionMetadataRequest';
 import {
   AssetType,
@@ -17,8 +19,6 @@ import { hasTransactionType } from '../../../Views/confirmations/utils/transacti
 import { PREDICT_BALANCE_CHAIN_ID } from '../constants/transactions';
 import { usePredictBalance } from './usePredictBalance';
 import { usePredictPaymentToken } from './usePredictPaymentToken';
-import { strings } from '../../../../../locales/i18n';
-import Routes from '../../../../constants/navigation/Routes';
 
 export function usePredictBalanceTokenFilter(
   forceEnabled = false,
@@ -29,10 +29,10 @@ export function usePredictBalanceTokenFilter(
   const { isPredictBalanceSelected } = usePredictPaymentToken();
   const { data: predictBalance = 0 } = usePredictBalance();
   const formatFiat = useFiatFormatter({ currency: 'usd' });
-  const usdceToken = useSelector((state: RootState) =>
+  const pusdToken = useSelector((state: RootState) =>
     selectSingleTokenByAddressAndChainId(
       state,
-      POLYGON_USDCE.address,
+      POLYGON_PUSD.address,
       PREDICT_BALANCE_CHAIN_ID,
     ),
   );
@@ -60,9 +60,9 @@ export function usePredictBalanceTokenFilter(
 
       const predictBalanceHighlightedItem: HighlightedItem = {
         position: 'in_asset_list',
-        icon: usdceToken?.image ?? '',
+        icon: pusdToken?.image ?? '',
         name: strings('predict.payment.predict_balance'),
-        name_description: POLYGON_USDCE.symbol,
+        name_description: POLYGON_PUSD.symbol,
         fiat: balanceFormatted,
         isSelected: isPredictBalanceSelected,
         action: onSelect ?? (() => undefined),
@@ -90,7 +90,7 @@ export function usePredictBalanceTokenFilter(
       isPredictBalanceSelected,
       predictBalance,
       formatFiat,
-      usdceToken,
+      pusdToken,
       handleAddFunds,
       onSelect,
     ],

app/components/UI/Predict/hooks/usePredictRewards.test.ts

@@ -7,7 +7,7 @@ import Logger from '../../../../util/Logger';
 import { getFormattedAddressFromInternalAccount } from '../../../../core/Multichain/utils';
 import {
   POLYGON_MAINNET_CAIP_CHAIN_ID,
-  POLYGON_USDC_CAIP_ASSET_ID,
+  POLYGON_PUSD_CAIP_ASSET_ID,
 } from '../providers/polymarket/constants';
 
 jest.mock('react-redux', () => ({
@@ -47,8 +47,8 @@ jest.mock('../constants/errors', () => ({
 
 jest.mock('../providers/polymarket/constants', () => ({
   POLYGON_MAINNET_CAIP_CHAIN_ID: 'eip155:137',
-  POLYGON_USDC_CAIP_ASSET_ID:
-    'eip155:137/erc20:0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174',
+  POLYGON_PUSD_CAIP_ASSET_ID:
+    'eip155:137/erc20:0xC011a7E12a19f7B1f670d46F03B03f3342E82DFB',
   COLLATERAL_TOKEN_DECIMALS: 6,
 }));
 
@@ -185,7 +185,7 @@ describe('usePredictRewards', () => {
           activityContext: {
             predictContext: {
               feeAsset: {
-                id: POLYGON_USDC_CAIP_ASSET_ID,
+                id: POLYGON_PUSD_CAIP_ASSET_ID,
                 amount: expect.any(String),
               },
             },

app/components/UI/Predict/hooks/usePredictRewards.ts

@@ -17,7 +17,7 @@ import { selectSelectedInternalAccountByScope } from '../../../../selectors/mult
 import { getFormattedAddressFromInternalAccount } from '../../../../core/Multichain/utils';
 import {
   POLYGON_MAINNET_CAIP_CHAIN_ID,
-  POLYGON_USDC_CAIP_ASSET_ID,
+  POLYGON_PUSD_CAIP_ASSET_ID,
   COLLATERAL_TOKEN_DECIMALS,
 } from '../providers/polymarket/constants';
 import { parseUnits } from 'ethers/lib/utils';
@@ -186,9 +186,9 @@ export const usePredictRewards = (
       }
 
       // Prepare fee asset
-      // Convert USD amount to atomic units (6 decimals for USDC)
+      // Convert USD amount to atomic units (6 decimals for pUSD)
       const feeAsset: EstimateAssetDto = {
-        id: POLYGON_USDC_CAIP_ASSET_ID,
+        id: POLYGON_PUSD_CAIP_ASSET_ID,
         amount: parseUnits(
           totalFeeAmountUsd.toString(),
           COLLATERAL_TOKEN_DECIMALS,