Skip to content

tetherto/wdk-wallet-tron

Repository files navigation

@tetherto/wdk-wallet-tron

npm version npm downloads license docs

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

A simple and secure package to manage BIP-44 wallets for the TRON blockchain. 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.

About

WDK module to manage BIP-44 wallets for the Tron blockchain.

Topics

Resources

License

Stars

0 stars

Watchers

4 watching

Forks

Packages

 
 
 

Contributors