Skip to content

Release v4.11.0 #971

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
gummy789j merged 26 commits into from
Aug 5, 2026
Merged

Release v4.11.0 #971

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
26 commits
Select commit Hold shift + click to select a range
e28bc9f
Merge pull request #970 from tronprotocol/develop
gummy789j Aug 5, 2026
243876b
feat(ts): add multisig permission management
Jul 23, 2026
d12c6f7
feat(ts): add local multisig signing workflow
Jul 23, 2026
e84edec
feat(ts): add TronLink multisig collaboration
Jul 23, 2026
fdee0a9
feat(ts): add GasFree transfer workflow
Jul 23, 2026
34ac350
feat(ts): add account lifecycle commands
Jul 23, 2026
7a5245c
feat(ts): add secure recipient contacts
Jul 23, 2026
c35c07f
feat(ts): add local address utilities
Jul 23, 2026
8943820
feat(ts): add terminal receive QR
Jul 23, 2026
080c351
fix(ts): expose v0.1.2 commands in help
Jul 23, 2026
9d29343
fix(ts): parse numeric transaction options
Jul 23, 2026
55b18e5
fix(ts): accept unsigned multisig weight defaults
Jul 23, 2026
73cb951
refactor(ts): separate TRON signing and multisig workflows
gummy789j Jul 28, 2026
9064d5c
docs(ts): document v0.3.0 commands and prepare 4.11.0
gummy789j Jul 28, 2026
b972bce
fix(ts): use accurate TRON operation labels
gummy789j Jul 28, 2026
1a68798
fix(ts): correct positional parsing, tx sign defaults, and fee rendering
gummy789j Aug 2, 2026
b850324
fix(ts): keep machine values out of text, and unblock the permission …
gummy789j Aug 3, 2026
0f140d1
fix(ts): address PR #963 review findings
gummy789j Aug 3, 2026
9ec3659
refactor(ts): break the type-only import cycles, enforce boundaries a…
gummy789j Aug 3, 2026
b0ef809
fix(ts): make tx multisig --create match the real TronLink protocol
gummy789j Aug 3, 2026
15c2ac8
fix(ts): make help state the constraints the runtime enforces
gummy789j Aug 3, 2026
0323bc0
fix wallet CLI regression cases
gummy789j Aug 4, 2026
7623865
fix(ts): decode the numeric protobuf enums TronLink returns
gummy789j Aug 4, 2026
b952052
fix(ts): refuse an under-threshold direct submit before it reaches th…
gummy789j Aug 4, 2026
f9b0ca1
doc: update
gummy789j Aug 5, 2026
895be1e
Merge pull request #963 from tronprotocol/feat/ts-v4.11.0
gummy789j Aug 5, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
32 changes: 16 additions & 16 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,15 +1,15 @@
<h1 align="center">wallet-cli</h1>

<h4 align="center">
A command-line wallet for the TRON network — interactive in Java, agent-first in TypeScript
A command-line wallet for the <a href="https://tron.network">TRON network</a> — interactive in Java, agent-first in TypeScript
</h4>

<p align="center">
<a href="https://github.com/tronprotocol/wallet-cli/issues"><img src="https://img.shields.io/github/issues/tronprotocol/wallet-cli.svg"></a>
<a href="https://github.com/tronprotocol/wallet-cli/pulls"><img src="https://img.shields.io/github/issues-pr/tronprotocol/wallet-cli.svg"></a>
<a href="https://github.com/tronprotocol/wallet-cli/graphs/contributors"><img src="https://img.shields.io/github/contributors/tronprotocol/wallet-cli.svg"></a>
<a href="https://www.npmjs.com/package/@tron-walletcli/wallet-cli"><img src="https://img.shields.io/npm/v/@tron-walletcli/wallet-cli.svg"></a>
<a href="LICENSE"><img src="https://img.shields.io/github/license/tronprotocol/wallet-cli.svg"></a>
<a href="https://github.com/tronprotocol/wallet-cli/blob/master/LICENSE"><img src="https://img.shields.io/github/license/tronprotocol/wallet-cli.svg"></a>
</p>

This repository holds **two independent implementations** that share the same purpose but target different users:
Expand All @@ -21,19 +21,19 @@ Both manage the same kind of wallet on the same networks — your address is ide

## At a glance

| | [**Java**](java/README.md) — the original | [**TypeScript**](ts/README.md) — 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](https://github.com/tronprotocol/trident) SDK. | [Node.js](https://nodejs.org) **20+**. |
| **Install** | `git clone` + `./gradlew build` (see [Setup](java/README.md#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`](ts/docs/machine-interface.md)) + fixed exit codes (`0`/`1`/`2`). |
| **Config / networks** | `config.conf` (net type + full node), or `SwitchNetwork` at runtime. Mainnet · Nile · Shasta · custom. | `--network` flag / `config` command. `tron:mainnet` · `tron:nile` · `tron:shasta`. |
| **Signing** | Software keystore · Ledger. | Encrypted local keystore · Ledger. Secrets never via argv/env. |
| **Feature scope** | **The full surface** — plus GasFree gas-less transfers, TRC10 token issuance, on-chain DEX & governance/proposals, and TronLink multi-sig. | **Core wallet ops** — HD wallets, TRX/TRC20/TRC10 transfers, staking & delegation, voting & rewards, contract call/deploy, 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](java/README.md) | [ts/README.md](ts/README.md) |
| | [**Java**](java/README.md) — the original | [**TypeScript**](ts/README.md) — 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](https://github.com/tronprotocol/trident) SDK. | [Node.js](https://nodejs.org) **20+**. |
| **Install** | `git clone` + `./gradlew build` (see [Setup](java/README.md#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`](ts/docs/machine-interface.md)) + fixed exit codes (`0`/`1`/`2`). |
| **Config / networks** | `config.conf` (net type + full node), or `SwitchNetwork` at runtime. Mainnet · Nile · Shasta · custom. | `--network` flag / `config` command. `tron:mainnet` · `tron:nile` · `tron:shasta`. |
| **Signing** | Software keystore · Ledger. | Encrypted local keystore · Ledger. Secrets never via argv/env. |
| **Feature scope** | **The full surface** — everything in the TypeScript column, plus TRC10 token issuance and on-chain DEX & governance/proposals. | **Core wallet ops** — HD wallets, TRX/TRC20/TRC10 transfers, staking & delegation, voting & rewards, contract call/deploy, 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](java/README.md) | [ts/README.md](ts/README.md) |

## Java — get a taste

Expand Down Expand Up @@ -72,5 +72,5 @@ Every command has a reference page, and the JSON contract, exit codes, and agent
## Which should I use?

- **Scripting, CI, or building an AI agent?** → the [TypeScript version](ts/README.md) — the JSON envelope and deterministic exit codes exist for exactly this.
- **Working interactively and want the complete TRON toolkit** — GasFree, TRC10 issuance, on-chain DEX/governance, or multi-sig? → the [Java version](java/README.md).
- **Working interactively and want the complete TRON toolkit** — TRC10 issuance, or on-chain DEX/governance/proposals? → the [Java version](java/README.md).
- **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).
Loading
Loading