Overview
To integrate your Tron wallet with Dynamic, you’ll need to follow these steps: For general information about custom wallet connectors, see our Integrate your Wallet guide.1
Create a TronWallet Adapter
Dynamic uses the TronWallet Adapter standard, which provides a unified interface for Tron wallets. Your first step is to create a TronWallet Adapter that implements the adapter interface.For complete implementation details, refer to the TronWallet Adapter documentation.
TronWallet Adapter Documentation
The TronWallet Adapter project provides comprehensive documentation for creating adapters:- TronWallet Adapter Docs - Complete guide to creating TronWallet Adapters
- TronWallet Adapter GitHub - Source code and examples
- Adapter Interface - Specification for adapter implementation
Key Requirements
Your TronWallet Adapter must implement theAdapter interface from @tronweb3/tronwallet-abstract-adapter, which includes:name- The name of your walleticon- Wallet icon URLurl- Wallet website URLreadyState- Connection readiness stateconnect()- Establishes connection to the walletdisconnect()- Disconnects from the walletsignMessage()- Signs messages for authenticationsignTransaction()- Signs transactionsnetwork()- Gets the current networkwallet- The wallet provider instance (e.g.,window.tronWeb)
Example Adapter Structure
Your TronWallet Adapter
2
Create a Dynamic Connector
Once you have a TronWallet Adapter, you need to create a Dynamic connector that extends
TronWalletAdapterConnector.Connector Structure
Your connector should extendTronWalletAdapterConnector and provide your adapter:YourTronConnector Implementation
Registering Your Adapter
If you want your adapter to be automatically detected, you can add it to the adapter registry. However, for custom connectors, you can also create them directly:Using Your Custom Connector
3
Test Your Integration
Before submitting, thoroughly test your integration:
- Connection Testing - Verify wallet connects and disconnects properly
- Address Retrieval - Ensure addresses are returned correctly
- Message Signing - Test message signing with
signMessageV2 - Transaction Testing - Test TRX and TRC20 token transfers
- Network Switching - Verify network detection and switching
- Error Handling - Verify proper error handling for all methods
Testing Checklist
- Wallet connects successfully
- Wallet address is retrieved correctly
- Messages can be signed and verified
- TRX transfers work on mainnet and testnets
- TRC20 token transfers work correctly
- Network detection works (mainnet, Shasta, Nile)
- Error cases are handled gracefully
- Wallet disconnects cleanly
4
Submit Your Connector
Once your implementation is complete and tested:
- Submit your connector following the Custom Wallet Connectors process
- Fill out the submission form to get allowlisted
- Our team will review and integrate your connector
Submission Requirements
- Working TronWallet Adapter implementation
- Dynamic connector extending
TronWalletAdapterConnector - Test coverage for all wallet operations
- Documentation for your wallet integration
Supported Networks
| Network | Chain ID | Description | Block Explorer |
|---|---|---|---|
| Tron Mainnet | 728126428 | Production network | Tronscan |
| Shasta Testnet | 728126429 | Test network | Shasta Tronscan |
| Nile Testnet | 728126430 | Test network | Nile Tronscan |
TronWallet Adapter Interface
The TronWallet Adapter interface is defined in@tronweb3/tronwallet-abstract-adapter. Key methods include:
TronWallet Adapter Interface
Resources
- TronWallet Adapter Docs - Official TronWallet Adapter documentation
- TronWallet Adapter GitHub - Source code and examples
- TronWeb Documentation - TronWeb API reference
- Dynamic Custom Wallet Connectors - General guide for custom connectors
- Tron Network - Official Tron network website
Need Help?
If you need assistance integrating your Tron wallet:- Check the TronWallet Adapter documentation for adapter implementation details
- Review existing adapter implementations in the TronWallet Adapter repository
- Join our Discord community for support