feat: enable butter for TRON

[NeOMakinG]

Description

This task activates TRON blockchain support for the existing Butter swapper integration, enabling users to swap tokens to and from the TRON chain using the ButterSwap protocol. Butter is already integrated as a swapper in the ShapeShift platform supporting EVM chains, Bitcoin, and Solana. This implementation extends that support to include TRON by adding the necessary chain ID mappings, native token address handling, chain validation updates, and TRON-specific transaction building/fee methods.

Issue (if applicable)

closes #11214

Risk

Low

High Risk PRs Require 2 approvals

What protocols, transaction types, wallets or contract interactions might be affected by this PR?

Testing

• Swap from any chains to TRX using Butter
• Try to swap TRX to a TRC20
• Cross TRC20 swaps
• TRC20 to TRX
• Verify balance is updated
• Verify all statuses are updated in the action center

Engineering

Operations

• 🏁 My feature is behind a flag and doesn't require operations testing (yet)

Screenshots (if applicable)

https://jam.dev/c/476682f3-bffa-4af2-8549-8474fd511422

Summary by CodeRabbit

• New Features
  • Added Tron blockchain support to ButterSwap swapper, enabling trading on the Tron network including transaction execution, fee calculation, quote generation, rate calculation, status tracking, and route resolution.

_{✏️ Tip: You can customize this high-level summary in your review settings.}

[coderabbitai]

📝 Walkthrough

Walkthrough

This pull request adds Tron blockchain support to ButterSwap swapper. Changes include importing and exporting Tron transaction utilities, extending chain validation logic to include Tron, adding Tron chain ID mappings, implementing Tron transaction status checking with contractRet-based logic, and extending destination address resolution for Tron transactions.

Changes

Cohort / File(s)	Summary
ButterSwap API Exports packages/swapper/src/swappers/ButterSwap/ButterSwap.ts, packages/swapper/src/swappers/ButterSwap/endpoints.ts	Exposes Tron transaction execution and fee/quote helpers (executeTronTransaction, getTronTransactionFees, getUnsignedTronTransaction) in public API alongside existing EVM and Solana handlers.
Chain Validation & Routing packages/swapper/src/swappers/ButterSwap/swapperApi/getTradeQuote.ts, packages/swapper/src/swappers/ButterSwap/swapperApi/getTradeRate.ts, packages/swapper/src/swappers/ButterSwap/xhr.ts	Extends unsupported chain checks and routing logic to explicitly permit and handle Tron (tronChainId) chain assets. Adds TRON native address constant for proper route resolution.
Trade Status Handling packages/swapper/src/swappers/ButterSwap/swapperApi/checkTradeStatus.ts	Adds Tron-specific transaction status determination using adapter.httpProvider.getTransaction() and evaluates contractRet field (SUCCESS/REVERT with confirmation count) for status resolution.
Chain ID Mappings packages/swapper/src/swappers/ButterSwap/utils/helpers.ts	Maps ButterSwap chain identifier 728126428 to KnownChainIds.TronMainnet in BUTTERSWAP_CHAIN_ID_TO_CHAIN_ID mapping.
Transaction Utilities packages/swapper/src/tron-utils/getUnsignedTronTransaction.ts	Extends destination address (to) fallback chain to include butterSwapTransactionMetadata?.to alongside existing relayTransactionMetadata and nearIntentsSpecific sources.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Possibly related PRs

• feat: support tron #11217: Adds Tron support and modifies the same swapper transaction paths and utilities (executeTronTransaction, getUnsignedTronTransaction, getTronTransactionFees, tronChainId mappings).
• fix: implement proper TRON getTransaction and fix Sun.io status checking #11283: Modifies Tron transaction fetching/status logic using adapter.httpProvider.getTransaction and contractRet-based confirmation checks.
• feat: enable butter same chain swaps #10202: Modifies the same ButterSwap swapper files (checkTradeStatus, getTradeQuote, getTradeRate, xhr) with overlapping chain-handling logic changes.

Suggested reviewers

• gomesalexandre
• 0xApotheosis

Poem

🐇 A whisper in the swap so fine,
Tron joins the ButterSwap design,
With chains now mapped and routes so bright,
Transaction fees take gentle flight! 🦋✨

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title 'feat: enable butter for TRON' clearly and concisely describes the main change: adding TRON blockchain support to the Butter swapper, which aligns with all the code changes in the changeset.
Linked Issues check	✅ Passed	The pull request successfully addresses issue #11214 by implementing ButterSwap support for TRON, including chain ID mappings, native token handling, chain validation, and transaction fee utilities.
Out of Scope Changes check	✅ Passed	All changes are directly related to adding TRON support to ButterSwap: chain mappings, native address handling, chain validation updates, and transaction/fee utilities. No unrelated modifications detected.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing touches

• 📝 Generate docstrings

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch auto-claude/009-we-are-supporting-butter-as-a-swapper-but-we-didn-

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[coderabbitai]

Actionable comments posted: 1

🤖 Fix all issues with AI agents

In `@packages/swapper/src/swappers/ButterSwap/swapperApi/checkTradeStatus.ts`:
- Around line 63-71: The current logic in checkTradeStatus (variables:
contractRet, tx.confirmations, TxStatus) leaves many confirmed TRON transactions
with non‑'SUCCESS' contractRet as Pending; change the branching so that if
tx.confirmations > 0 then any contractRet !== 'SUCCESS' is set to
TxStatus.Failed (only 'SUCCESS' => TxStatus.Confirmed), and keep the existing
behavior for unconfirmed TXs where contractRet === 'REVERT' maps to
TxStatus.Failed otherwise TxStatus.Pending; update the ternary/if logic
accordingly to use these checks.

[premiumjibles]

Looks good and was able to get quotes across a variety of pairs I tired. Tested ETH on arb -> TRX https://jam.dev/c/64a0536a-e48b-49a4-bed9-1dfd12b5ea7f

Was unable to test TRX -> TRC tokens due to limited funds without doing a million dust transactions. Will leave that to release testing