Get Started

This guide explains how to install the package, create a wallet, and get your first account.

1. Install the Package

Prerequisites

Node.js: version 18 or higher.
npm: usually comes with Node.js.

Install @tetherto/wdk-wallet-tron

npm install @tetherto/wdk-wallet-tron

You can create a new wallet instance using the WalletManagerTron constructor with a BIP-39 seed phrase or a raw 16–64-byte BIP-32 master seed (Uint8Array), plus a Tron RPC provider. This example uses a seed phrase:

Create Tron Wallet

import WalletManagerTron, { WalletAccountTron, WalletAccountReadOnlyTron } from '@tetherto/wdk-wallet-tron'

const seedPhrase = 'your twelve word seed phrase here'

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

Secure the Seed: You must securely store the seed phrase or raw seed bytes you use. If the seed is lost, the user will permanently lose access to their funds.

3. Get Your First Account

You can retrieve an account at a given index using wallet.getAccount():

Get Account

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

4. (optional) Convert to Read-Only

You can convert an owned account to a read-only account using account.toReadOnlyAccount():

Convert to Read-Only

const readOnlyAccount = await account.toReadOnlyAccount()

All Tron addresses start with T and are 34 characters long.

Next Steps

With your wallet ready, learn how to manage multiple accounts.