tronprotocol/wallet-cli

README

wallet-cli

A command-line wallet for TRON and selected EVM networks — interactive in Java, agent-first in TypeScript

This repository holds two independent implementations that share the same purpose but target different users:

Java — the original, full-featured reference CLI. An interactive prompt (REPL) you drive by hand.
TypeScript — an agent-first rewrite for automation. Standard subcommands with a stable JSON envelope, built for scripts, CI, and AI agents.

Both manage TRON wallets, but they are independent implementations rather than interchangeable account stores. Do not assume every derived account has the same address across implementations: check the recorded BIP44 path when migrating. The TypeScript implementation additionally supports selected EVM networks.

At a glance

	Java — the original	TypeScript — agent-first rewrite
What it is	The mature, full-feature reference CLI.	A newer rewrite focused on programmatic integration.
Runtime	JVM — built with Gradle, run as a `.jar`. Uses the Trident SDK.	Node.js 20+.
Install	`git clone` + `cd wallet-cli/java && ./gradlew build` (see Setup)	`npm install -g @tron-walletcli/wallet-cli`
How you drive it	An interactive prompt only — start it, then type commands at `>`.	One-shot subcommands — `wallet-cli <command>` from your shell. Interactive prompts only for secret input.
Command style	PascalCase verbs: `RegisterWallet`, `SendCoin`, `GetBalance`. Amounts in SUN (1 TRX = 1,000,000 SUN).	Noun-verb subcommands: `create`, `tx send`, `account balance`, with `--flags`.
Output for scripts	Human-readable text.	Stable JSON via `-o json` (`wallet-cli.result.v1`) + fixed exit codes (`0`/`1`/`2`).
Config / networks	`config.conf` endpoints, or `SwitchNetwork` at runtime. Mainnet · Nile · Shasta · custom.	`--network` flag / `config` command. Three TRON networks plus Ethereum, Sepolia, BNB Smart Chain, Base, and their testnets.
Signing	Software keystore · Ledger.	Encrypted local keystore · Ledger. Secrets enter via stdin/TTY, never argv or dedicated secret environment variables.
Feature scope	The full surface — wallets and transfers, staking, voting and rewards, governance, contracts, TRC10, and the on-chain exchange.	The full surface — HD wallets, TRX/TRC20/TRC10 transfers, staking & delegation, voting & rewards, governance proposals & super-representative operation, contract call/deploy/governance, TRC10 issuance, the on-chain Bancor exchange, SunSwap swaps & liquidity, SunPump trading & launches, multi-sig, GasFree transfers, message signing, and on-chain queries.
Best for	People at a terminal who want every TRON capability.	Scripting, CI pipelines, and AI agents.
Full docs	java/README.md	ts/README.md

Java — get a taste

Interactive only. Build it, start the prompt, then type commands:

$ git clone https://github.com/tronprotocol/wallet-cli.git
$ cd wallet-cli/java && ./gradlew build && cd build/libs
$ java -jar wallet-cli.jar        # opens the interactive prompt
> RegisterWallet                  # prompts twice for the password, then for mnemonic length
> Login                           # unlock it
> GetAddress                      # your TRON address
> GetBalance                      # TRX balance

Full setup (config.conf, connecting to a node), the complete A–Z command list, and features like GasFree and multi-sig live in java/README.md — jump to Setup, Quickstart, Commands, or GasFree.

TypeScript — get a taste

Install from npm, then run subcommands directly from your shell:

$ npm install -g @tron-walletcli/wallet-cli
$ wallet-cli create --label main               # prompts for a master password
$ wallet-cli account balance --network tron:3448148188
$ wallet-cli account balance -o json           # one wallet-cli.result.v1 JSON frame

Every command has a reference page, and the JSON contract, exit codes, and agent integration are documented in depth. Start at ts/README.md, then:

Getting started — create a wallet and send your first transaction
Command reference — every command, A–Z
Machine interface — JSON envelope, exit codes, script safety

Which should I use?

Scripting, CI, or building an AI agent? → the TypeScript version — the JSON envelope and deterministic exit codes exist for exactly this.
Working interactively — one long-running session at a > prompt, with the wallet unlocked once for the whole session? → the Java version.
Just sending TRX/tokens or staking from your own machine? → either works; the TypeScript CLI is the lighter install (npm install -g, no build step).