feat: Swaps tron integration (#6862)

## Explanation

Adds support for bridging and swapping tokens on the Tron blockchain.

**What Changed**
- Bridge and swap controllers now recognize and handle Tron transactions
- Non-evm token approvals are now supported
- Tron transactions are processed through the same snap-based flow as
Solana and Bitcoin

**Technical Notes**
Tron transactions have a different format (raw_data_hex) than EVM
chains, so this PR adds the necessary type guards and data extraction
utilities to handle them properly.

<!--
Thanks for your contribution! Take a moment to answer these questions so
that reviewers have the information they need to properly understand
your changes:

* What is the current state of things and why does it need to change?
* What is the solution your changes offer and how does it work?
* Are there any changes whose purpose might not obvious to those
unfamiliar with the domain?
* If your primary goal was to update one package but you found you had
to update another one along the way, why did you do so?
* If you had to upgrade a dependency, why did you do so?
-->

## References

<!--
Are there any issues that this pull request is tied to?
Are there other links that reviewers should consult to understand these
changes better?
Are there client or consumer pull requests to adopt any breaking
changes?

For example:

* Fixes #12345
* Related to #67890
-->

## Checklist

- [ ] I've updated the test suite for new or updated code as appropriate
- [ ] I've updated documentation (JSDoc, Markdown, etc.) for new or
updated code as appropriate
- [ ] I've communicated my changes to consumers by [updating changelogs
for packages I've
changed](https://github.com/MetaMask/core/tree/main/docs/contributing.md#updating-changelogs),
highlighting breaking changes as necessary
- [ ] I've prepared draft pull requests for clients and consumer
packages to resolve any breaking changes


<!-- CURSOR_SUMMARY -->
---

> [!NOTE]
> Adds Tron bridging/swapping with snap-based flow (incl. approvals),
expanding types/validators, CAIP/chain utils, fee calc, and tests.
> 
> - **Bridge Controller**:
> - Add Tron chain support: `TrxScope.Mainnet`, `ChainId.TRON`, native
`TRX` token, and include in `ALLOWED_BRIDGE_CHAIN_IDS` and symbol maps.
> - Extend types/validators: introduce `TronTradeData`, allow
`approval`/`trade` to be Tron; widen `QuoteResponse` generics.
> - Utilities: add `isTronChainId`, include Tron in `isNonEvmChainId`;
CAIP formatters handle Tron; new `trade-utils` (`Trade`, `isTronTrade`,
`extractTradeData` hex→base64); fee calc adds Tron snap options.
> - Public API: export new trade utils; update selectors/types exports
accordingly.
> - Tests/SSE snapshots updated to cover Tron fields (`raw_data_hex`)
and flows.
> - **Bridge Status Controller**:
> - Support Tron submit flow (swap/bridge) with optional Tron approvals
via unified Snap `signAndSendTransaction`; pass Tron-specific request
options.
> - Generalize non‑EVM handling to `Trade`; update tx meta building and
client request helpers.
>   - Add extensive tests for Tron approval, swap, and bridge cases.
> - **Transaction Pay Controller**:
> - Adjust batch tx construction to handle multichain approvals (type
casts); update changelog.
> - **Changelogs**: note Tron bridging/swapping support in affected
packages.
> 
> <sup>Written by [Cursor
Bugbot](https://cursor.com/dashboard?tab=bugbot) for commit
2c81337. This will update automatically
on new commits. Configure
[here](https://cursor.com/dashboard?tab=bugbot).</sup>
<!-- /CURSOR_SUMMARY -->

---------

Co-authored-by: OGPoyraz <[email protected]>

Author: bfullam

packages/bridge-controller/CHANGELOG.md

@@ -7,6 +7,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Added
+
+- Added support for bridging and swapping tokens on the Tron blockchain ([#6862](https://github.com/MetaMask/core/pull/6862))
+
 ## [60.0.0]
 
 ### Changed

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

@@ -18,6 +18,7 @@ Array [
         "lifi|trade.gasLimit",
         "lifi|trade.unsignedPsbtBase64",
         "lifi|trade.inputsToSign",
+        "lifi|trade.raw_data_hex",
       ],
       "refresh_count": 1,
       "token_address_destination": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp/token:123d1",

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

@@ -656,6 +656,7 @@ describe('BridgeController SSE', function () {
           "lifi|trade.gasLimit",
           "lifi|trade.unsignedPsbtBase64",
           "lifi|trade.inputsToSign",
+          "lifi|trade.raw_data_hex",
         ],
       ]
     `);

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

@@ -1,5 +1,5 @@
 import { AddressZero } from '@ethersproject/constants';
-import { BtcScope, SolScope } from '@metamask/keyring-api';
+import { BtcScope, SolScope, TrxScope } from '@metamask/keyring-api';
 import type { Hex } from '@metamask/utils';
 
 import { CHAIN_IDS } from './chains';
@@ -22,6 +22,7 @@ export const ALLOWED_BRIDGE_CHAIN_IDS = [
   CHAIN_IDS.MONAD,
   SolScope.Mainnet,
   BtcScope.Mainnet,
+  TrxScope.Mainnet,
 ] as const;
 
 export type AllowedBridgeChainIds = (typeof ALLOWED_BRIDGE_CHAIN_IDS)[number];

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

@@ -1,4 +1,4 @@
-import { BtcScope, SolScope } from '@metamask/keyring-api';
+import { BtcScope, SolScope, TrxScope } from '@metamask/keyring-api';
 
 import type { AllowedBridgeChainIds } from './bridge';
 import { CHAIN_IDS } from './chains';
@@ -54,6 +54,7 @@ const CURRENCY_SYMBOLS = {
   SOL: 'SOL',
   SEI: 'SEI',
   BTC: 'BTC',
+  TRX: 'TRX',
   MON: 'MON',
 } as const;
 
@@ -157,6 +158,14 @@ const SEI_SWAPS_TOKEN_OBJECT = {
   iconUrl: '',
 } as const;
 
+const TRX_SWAPS_TOKEN_OBJECT = {
+  symbol: CURRENCY_SYMBOLS.TRX,
+  name: 'Tron',
+  address: DEFAULT_TOKEN_ADDRESS,
+  decimals: 6,
+  iconUrl: '',
+} as const;
+
 const MONAD_SWAPS_TOKEN_OBJECT = {
   symbol: CURRENCY_SYMBOLS.MON,
   name: 'Mon',
@@ -185,6 +194,7 @@ export const SWAPS_CHAINID_DEFAULT_TOKEN_MAP = {
   [SolScope.Mainnet]: SOLANA_SWAPS_TOKEN_OBJECT,
   [SolScope.Devnet]: SOLANA_SWAPS_TOKEN_OBJECT,
   [BtcScope.Mainnet]: BTC_SWAPS_TOKEN_OBJECT,
+  [TrxScope.Mainnet]: TRX_SWAPS_TOKEN_OBJECT,
 } as const;
 
 export type SupportedSwapsNativeCurrencySymbols =
@@ -208,5 +218,6 @@ export const SYMBOL_TO_SLIP44_MAP: Record<
   AVAX: 'slip44:9000',
   TESTETH: 'slip44:60',
   SEI: 'slip44:19000118',
+  TRX: 'slip44:195',
   MON: 'slip44:268435779',
 };

packages/bridge-controller/src/index.ts

@@ -41,6 +41,7 @@ export type {
   FeeData,
   TxData,
   BitcoinTradeData,
+  TronTradeData,
   BridgeControllerState,
   BridgeControllerAction,
   BridgeControllerActions,
@@ -131,6 +132,13 @@ export {
   formatAddressToAssetId,
 } from './utils/caip-formatters';
 
+export {
+  extractTradeData,
+  isBitcoinTrade,
+  isTronTrade,
+  type Trade,
+} from './utils/trade-utils';
+
 export {
   selectBridgeQuotes,
   selectDefaultSlippagePercentage,

packages/bridge-controller/src/types.ts

@@ -37,6 +37,7 @@ import type {
   QuoteResponseSchema,
   QuoteSchema,
   StepSchema,
+  TronTradeDataSchema,
   TxDataSchema,
 } from './utils/validators';
 
@@ -251,16 +252,21 @@ export type Quote = Infer<typeof QuoteSchema>;
 export type TxData = Infer<typeof TxDataSchema>;
 
 export type BitcoinTradeData = Infer<typeof BitcoinTradeDataSchema>;
+
+export type TronTradeData = Infer<typeof TronTradeDataSchema>;
 /**
  * This is the type for the quote response from the bridge-api
  * TxDataType can be overriden to be a string when the quote is non-evm
+ * ApprovalType can be overriden when you know the specific approval type (e.g., TxData for EVM-only contexts)
  */
-export type QuoteResponse<TxDataType = TxData | string | BitcoinTradeData> =
-  Infer<typeof QuoteResponseSchema> & {
-    trade: TxDataType;
-    approval?: TxData;
-    featureId?: FeatureId;
-  };
+export type QuoteResponse<
+  TxDataType = TxData | string | BitcoinTradeData | TronTradeData,
+  ApprovalType = TxData | TronTradeData,
+> = Infer<typeof QuoteResponseSchema> & {
+  trade: TxDataType;
+  approval?: ApprovalType;
+  featureId?: FeatureId;
+};
 
 export enum ChainId {
   ETH = 1,
@@ -274,6 +280,7 @@ export enum ChainId {
   LINEA = 59144,
   SOLANA = 1151111081099710,
   BTC = 20000000000001,
+  TRON = 728126428,
 }
 
 export type FeatureFlagsPlatformConfig = Infer<typeof PlatformConfigSchema>;

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

@@ -1,6 +1,6 @@
 import { AddressZero } from '@ethersproject/constants';
 import { Contract } from '@ethersproject/contracts';
-import { BtcScope, SolScope } from '@metamask/keyring-api';
+import { BtcScope, SolScope, TrxScope } from '@metamask/keyring-api';
 import { abiERC20 } from '@metamask/metamask-eth-abis';
 import type { CaipAssetType, CaipChainId } from '@metamask/utils';
 import { isCaipChainId, isStrictHexString, type Hex } from '@metamask/utils';
@@ -192,22 +192,33 @@ export const isBitcoinChainId = (
   return chainId.toString() === ChainId.BTC.toString();
 };
 
+export const isTronChainId = (chainId: Hex | number | CaipChainId | string) => {
+  if (isCaipChainId(chainId)) {
+    return chainId === TrxScope.Mainnet.toString();
+  }
+  return chainId.toString() === ChainId.TRON.toString();
+};
+
 /**
  * Checks if a chain ID represents a non-EVM blockchain supported by swaps
- * Currently supports Solana and Bitcoin
+ * Currently supports Solana, Bitcoin and Tron
  *
  * @param chainId - The chain ID to check
  * @returns True if the chain is a supported non-EVM chain, false otherwise
  */
 export const isNonEvmChainId = (
   chainId: GenericQuoteRequest['srcChainId'],
 ): boolean => {
-  return isSolanaChainId(chainId) || isBitcoinChainId(chainId);
+  return (
+    isSolanaChainId(chainId) ||
+    isBitcoinChainId(chainId) ||
+    isTronChainId(chainId)
+  );
 };
 
 export const isEvmQuoteResponse = (
   quoteResponse: QuoteResponse,
-): quoteResponse is QuoteResponse<TxData> => {
+): quoteResponse is QuoteResponse<TxData, TxData> => {
   return !isNonEvmChainId(quoteResponse.quote.srcChainId);
 };
 

packages/bridge-controller/src/utils/caip-formatters.test.ts

@@ -1,5 +1,5 @@
 import { AddressZero } from '@ethersproject/constants';
-import { BtcScope, SolScope } from '@metamask/keyring-api';
+import { BtcScope, SolScope, TrxScope } from '@metamask/keyring-api';
 
 import {
   formatChainIdToCaip,
@@ -36,6 +36,11 @@ describe('CAIP Formatters', () => {
       expect(formatChainIdToCaip('20000000000001')).toBe(BtcScope.Mainnet);
     });
 
+    it('should convert Tron chainId to TrxScope.Mainnet', () => {
+      expect(formatChainIdToCaip(ChainId.TRON)).toBe(TrxScope.Mainnet);
+      expect(formatChainIdToCaip(TrxScope.Mainnet)).toBe(TrxScope.Mainnet);
+    });
+
     it('should convert number to CAIP format', () => {
       expect(formatChainIdToCaip(1)).toBe('eip155:1');
     });
@@ -59,6 +64,10 @@ describe('CAIP Formatters', () => {
       expect(formatChainIdToDec('20000000000001')).toBe(20000000000001);
     });
 
+    it('should handle Tron mainnet', () => {
+      expect(formatChainIdToDec(TrxScope.Mainnet)).toBe(ChainId.TRON);
+    });
+
     it('should parse CAIP chainId to decimal', () => {
       expect(formatChainIdToDec('eip155:1')).toBe(1);
     });

packages/bridge-controller/src/utils/caip-formatters.ts

@@ -1,7 +1,7 @@
 import { getAddress } from '@ethersproject/address';
 import { AddressZero } from '@ethersproject/constants';
 import { convertHexToDecimal } from '@metamask/controller-utils';
-import { BtcScope, SolScope } from '@metamask/keyring-api';
+import { BtcScope, SolScope, TrxScope } from '@metamask/keyring-api';
 import { toEvmCaipChainId } from '@metamask/multichain-network-controller';
 import type { CaipAssetType } from '@metamask/utils';
 import {
@@ -21,6 +21,7 @@ import {
   isBitcoinChainId,
   isNativeAddress,
   isSolanaChainId,
+  isTronChainId,
 } from './bridge';
 import type { GenericQuoteRequest } from '../types';
 import { ChainId } from '../types';
@@ -46,6 +47,9 @@ export const formatChainIdToCaip = (
   if (isBitcoinChainId(chainId)) {
     return BtcScope.Mainnet;
   }
+  if (isTronChainId(chainId)) {
+    return TrxScope.Mainnet;
+  }
   return toEvmCaipChainId(numberToHex(Number(chainId)));
 };
 
@@ -67,6 +71,9 @@ export const formatChainIdToDec = (
   if (chainId === BtcScope.Mainnet) {
     return ChainId.BTC;
   }
+  if (chainId === TrxScope.Mainnet) {
+    return ChainId.TRON;
+  }
   if (isCaipChainId(chainId)) {
     return Number(chainId.split(':').at(-1));
   }