Extend WDK

Building Blocks

Discover and install building blocks to extend your WDK integration.

README

@tetherto/wdk-wallet-tron

Note: This package is currently in beta. Please test thoroughly in development environments before using in production.

A TRON wallet module for WDK (Wallet Development Kit) by Tether. This package provides a clean API for creating, managing, and interacting with TRON wallets using BIP-39 seed phrases and TRON-specific derivation paths.

About WDK

This module is part of the WDK (Wallet Development Kit) project, which empowers developers to build secure, non-custodial wallets with unified blockchain access, stateless architecture, and complete user control.

For detailed documentation about the complete WDK ecosystem, visit docs.wdk.tether.io.

Installation

npm install @tetherto/wdk-wallet-tron

Quick Start

import WalletManagerTron from '@tetherto/wdk-wallet-tron'

const seedPhrase = 'abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon about'

const wallet = new WalletManagerTron(seedPhrase, {
  provider: 'https://api.shasta.trongrid.io',
  transferMaxFee: 10_000_000n,
})

const account = await wallet.getAccount(0)
const address = await account.getAddress()
console.log('Address:', address)

wallet.dispose()

Key Capabilities

BIP-44 Derivation Paths: Standard TRON derivation support (m/44'/195')
Multi-Account Management: Derive multiple accounts from a single seed phrase
Native TRX Transactions: Quote and send TRX transfers through a unified wallet API
TRC20 Support: Query balances and transfer TRC20 tokens
Arbitrary Transactions: Send smart contract calls (by contract address and function selector) or any pre-built TronWeb transaction (e.g. staking, voting), with automatic fee quoting
Message Signing: Sign messages and verify signatures with TRON accounts
Fee Estimation: Retrieve current network fee rates and quote transaction costs
Read-Only Accounts: Monitor any TRON address without a private key
Failover Providers: Pass an array of provider URLs to enable automatic round-robin failover
Secure Memory Disposal: Clear private keys from memory when done

Compatibility

TRON Mainnet
TRON Shasta Testnet
TronWeb-compatible providers for balance, transaction, and fee queries

Documentation

Topic	Description	Link
Overview	Module overview and feature summary	Wallet TRON Overview
Usage	End-to-end integration walkthrough	Wallet TRON Usage
Configuration	Provider and transfer configuration	Wallet TRON Configuration
API Reference	Complete class and type reference	Wallet TRON API Reference

Examples

Example	Description
Create Wallet	Initialize a wallet manager and derive TRON accounts from a seed phrase
Manage Accounts	Work with multiple accounts and custom BIP-44 derivation paths
Check Balances	Query native TRX and TRC20 token balances for owned accounts
Read-Only Account	Monitor balances for any TRON address without a private key
Send Transaction	Estimate fees and send native TRX transactions
Token Transfer	Transfer TRC20 tokens and estimate transfer fees
Sign & Verify Message	Sign messages and verify signatures
Fee Management	Retrieve current network fee rates
Memory Management	Securely dispose wallets and clear private keys from memory

For detailed walkthroughs, see the Usage Guide. See all runnable examples in the wdk-examples repository.

Community

Join the WDK Discord to connect with other developers.

Support

For support, please open an issue on GitHub or reach out via email.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.