Tron Wallets

Recommended: JavaScript SDK with React Hooks

For new React apps, we recommend the JavaScript SDK with React Hooks (@dynamic-labs-sdk/react-hooks) instead of the legacy React SDK documented here. The JS SDK comes with many benefits such as a much smaller bundle size and other optimizations. Use the React quickstart (JavaScript SDK) to get started.

Dynamic offers full Tron wallet support through the @dynamic-labs/tron package, enabling seamless integration with Tron network wallets using the industry-standard TronWallet Adapter. This provides access to 9+ Tron wallets through a single, unified interface.

Installation

First, install the Tron wallet connector package:

npm install @dynamic-labs/tron

Supported Wallets

This package supports the following Tron wallets through TronWallet Adapter:

Wallet	Type	Description
OKX Wallet	Browser Extension	Multi-chain wallet with Tron support
Bitget Wallet	Browser Extension	Formerly BitKeep
TokenPocket	Mobile/Extension	Multi-chain wallet
Trust Wallet	Mobile/Extension	Popular multi-chain wallet

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

Basic Integration

To use Tron wallets in your app, add the Tron wallet connectors to your Dynamic configuration:

React

import { DynamicContextProvider } from '@dynamic-labs/sdk-react-core';
import { TronWalletConnectors } from '@dynamic-labs/tron';

function App() {
  return (
    <DynamicContextProvider
      settings={{
        environmentId: 'your-environment-id',
        walletConnectors: [TronWalletConnectors()],
      }}
    >
      {/* Your app content */}
    </DynamicContextProvider>
  );
}

Check if a wallet is a Tron wallet

The first thing you should do is check if the wallet is a Tron wallet. You can use the isTronWallet helper method for that. That way, TypeScript will know which methods etc. are available to you.

React

import { useDynamicContext } from '@dynamic-labs/sdk-react-core';
import { isTronWallet } from '@dynamic-labs/tron';

const { wallet } = useDynamicContext();

if (!isTronWallet(wallet)) {
  throw new Error('This wallet is not a Tron wallet');
}

Fetch the wallet address

You can get the wallet address using the wallet.address property:

React

const { primaryWallet } = useDynamicContext();

const tronAddress = primaryWallet.address;

Send TRX

To send TRX (the native Tron currency) to another address, use the sendTrx method:

React

import { useDynamicContext } from '@dynamic-labs/sdk-react-core';
import { isTronWallet } from '@dynamic-labs/tron';

const { primaryWallet } = useDynamicContext();

const handleSendTrx = async () => {
  if (!isTronWallet(primaryWallet)) {
    console.error('Not a Tron wallet');
    return;
  }

  try {
    // Send 10 TRX
    const result = await primaryWallet.sendTrx('TRecipientAddress...', 10);
    console.log('Transaction sent:', result.txid);
  } catch (error) {
    console.error('Transaction failed:', error);
  }
};

Send TRC20 Tokens

To send TRC20 tokens (like USDT) to another address, use the sendTrc20 method:

React

import { useDynamicContext } from '@dynamic-labs/sdk-react-core';
import { isTronWallet } from '@dynamic-labs/tron';

const { primaryWallet } = useDynamicContext();

const handleSendTrc20 = async () => {
  if (!isTronWallet(primaryWallet)) {
    console.error('Not a Tron wallet');
    return;
  }

  try {
    // USDT contract address on Tron mainnet
    const usdtContract = 'TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t';
    
    // Send 100 USDT (assuming 6 decimals)
    const result = await primaryWallet.sendTrc20({
      amount: '100',
      toAddress: 'TRecipientAddress...',
      token: {
        address: usdtContract,
        decimals: 6,
      },
    });
    console.log('Transaction sent:', result);
  } catch (error) {
    console.error('Transaction failed:', error);
  }
};

Sign Messages

Tron wallets support message signing for authentication using signMessageV2:

React

import { useDynamicContext } from '@dynamic-labs/sdk-react-core';
import { isTronWallet } from '@dynamic-labs/tron';

const { primaryWallet } = useDynamicContext();

const handleSignMessage = async () => {
  if (!isTronWallet(primaryWallet)) {
    return;
  }

  try {
    const message = 'Hello, Tron!';
    const signature = await primaryWallet.signMessage(message);
    console.log('Signature:', signature);

    // Verify the signature
    const tronWeb = primaryWallet.getTronWeb();
    if (tronWeb) {
      const recoveredAddress = await tronWeb.trx.verifyMessageV2(
        message,
        signature,
      );
      console.log('Verified:', recoveredAddress === primaryWallet.address);
    }
  } catch (error) {
    console.error('Signing failed:', error);
  }
};

Get Balance

To get the TRX balance of an address, use the getBalance method:

React

import { useDynamicContext } from '@dynamic-labs/sdk-react-core';
import { isTronWallet } from '@dynamic-labs/tron';

const { primaryWallet } = useDynamicContext();

const checkBalance = async () => {
  if (!isTronWallet(primaryWallet)) {
    return;
  }

  try {
    // Get balance in SUN (smallest unit, 1 TRX = 1,000,000 SUN)
    const balanceInSun = await primaryWallet.getBalance();
    const balanceInTrx = balanceInSun ? Number(balanceInSun) / 1_000_000 : 0;
    console.log('Balance (in TRX):', balanceInTrx);
  } catch (error) {
    console.error('Failed to get balance:', error);
  }
};

Get Token Balance

To get the balance of a TRC20 token, use the getTokenBalance method:

React

import { useDynamicContext } from '@dynamic-labs/sdk-react-core';
import { isTronWallet } from '@dynamic-labs/tron';

const { primaryWallet } = useDynamicContext();

const getUSDTBalance = async () => {
  if (!isTronWallet(primaryWallet)) {
    return;
  }

  // USDT contract address on Tron mainnet
  const usdtContract = 'TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t';

  try {
    const balance = await primaryWallet.getTokenBalance(usdtContract);
    // Balance is returned in the smallest unit (6 decimals for USDT)
    const balanceInTokens = balance / 1_000_000;
    console.log('USDT Balance:', balanceInTokens);
  } catch (error) {
    console.error('Failed to get token balance:', error);
  }
};

Access TronWeb

You can get direct access to the TronWeb instance for advanced operations:

React

import { useDynamicContext } from '@dynamic-labs/sdk-react-core';
import { isTronWallet } from '@dynamic-labs/tron';

const { primaryWallet } = useDynamicContext();

const getTronWebInstance = () => {
  if (!isTronWallet(primaryWallet)) return null;

  const tronWeb = primaryWallet.getTronWeb();
  return tronWeb;
};

const checkBalance = async () => {
  const tronWeb = getTronWebInstance();
  if (!tronWeb) return;

  const balance = await tronWeb.trx.getBalance(primaryWallet.address);
  console.log('Balance (in SUN):', balance);
  console.log('Balance (in TRX):', balance / 1_000_000);
};

Get Network Details

To get information about the current network, use the getNetworkDetails method:

React

import { useDynamicContext } from '@dynamic-labs/sdk-react-core';
import { isTronWallet } from '@dynamic-labs/tron';

const { primaryWallet } = useDynamicContext();

const getNetworkInfo = async () => {
  if (!isTronWallet(primaryWallet)) {
    return;
  }

  const network = await primaryWallet.getNetworkDetails();
  console.log('Chain ID:', network.chainId);
  console.log('Network Name:', network.name);
};

API Reference

Core Methods

getAddress(): Promise<string> - Get the wallet address
getNetwork(): Promise<string | number | undefined> - Get current network
signMessage(message: string | Uint8Array): Promise<string> - Sign a message
getBalance(address?: string): Promise<string | undefined> - Get TRX balance (in SUN)
sendTrx(to: string, amount: number, options?: { from?: string }): Promise<BroadcastReturn> - Send TRX
sendTrc20(params): Promise<string | undefined> - Send TRC20 tokens
getTokenBalance(tokenId: string, address?: string): Promise<number> - Get TRC20 token balance
getNetworkDetails(): Promise<{ chainId: string; name: string }> - Get network info
getTronWeb(): TronWeb | undefined - Get TronWeb instance

Type Definitions

TronWallet - The main wallet class for Tron wallets
isTronWallet - Type guard to check if a wallet is a Tron wallet

Resources

TronWallet Adapter Docs: https://walletadapter.org/docs/
TronWeb Docs: https://developers.tron.network/docs
Tron Network: https://tron.network

Implementation Guides

SDK Reference

Recommended: JavaScript SDK with React Hooks

Installation

Supported Wallets

Supported Networks

Basic Integration

Check if a wallet is a Tron wallet

Fetch the wallet address

Send TRX

Send TRC20 Tokens

Sign Messages

Get Balance

Get Token Balance

Access TronWeb

Get Network Details

API Reference

Core Methods

Type Definitions

Resources

Recommended: JavaScript SDK with React Hooks

​Installation

​Supported Wallets

​Supported Networks

​Basic Integration

​Check if a wallet is a Tron wallet

​Fetch the wallet address

​Send TRX

​Send TRC20 Tokens

​Sign Messages

​Get Balance

​Get Token Balance

​Access TronWeb

​Get Network Details

​API Reference

​Core Methods

​Type Definitions

​Resources

Installation

Supported Wallets

Supported Networks

Basic Integration

Check if a wallet is a Tron wallet

Fetch the wallet address

Send TRX

Send TRC20 Tokens

Sign Messages

Get Balance

Get Token Balance

Access TronWeb

Get Network Details

API Reference

Core Methods

Type Definitions

Resources