wallet-cli¶

wallet-cli 是面向 TRON 及部分 EVM 网络的命令行钱包，提供 Java 和 TypeScript 两种实现： Java 版面向交互式使用，TypeScript 版面向脚本和自动化集成。

本仓库包含两套独立实现，目的相同但面向不同的使用者：

Java——最早的完整参考实现，采用交互式命令行（REPL）。
TypeScript——面向自动化的重写版本，采用标准子命令，并提供稳定的 JSON 输出，适合脚本、CI 和 AI 智能体调用。

两者管理同一类钱包，但各自的账户存储并不通用。同一助记词只有第一个账户的地址相同：再往后两者走的 BIP44 路径就不一样了——Java 递增的是地址索引（m/44'/195'/0'/0/i），TypeScript 递增的是 account 层级（m/44'/195'/i'/0/0）。因此在另一个 CLI 中恢复钱包会看到不同的地址，这并不是资金丢失。在两者之间迁移前，请先核对账户所记录的 BIP44 路径。它们支持的 TRON 功能基本一致，主要区别在于安装方式和操作方式——此外 TypeScript 版还支持 EVM 网络（以太坊、BNB Smart Chain 及其测试网）， Java 版则不支持。选定其一后，请阅读对应文档了解详细用法；本页概述两者的特点，帮助你选择。

概览对比¶

	Java——原始实现	TypeScript——面向自动化的重写版
它是什么	成熟、功能完整的参考 CLI。	较新的重写版本，专注于程序化集成。
运行时	JVM——使用 Gradle 构建，以 `.jar` 运行。使用 Trident SDK。	Node.js 20+。
安装	`git clone` + `cd wallet-cli/java && ./gradlew build`（见环境准备）	`npm install -g @tron-walletcli/wallet-cli`
操作方式	交互式命令行——启动后在 `>` 提示符中输入命令。	非交互式子命令——在 shell 中执行 `wallet-cli <command>`。只有一份很短的白名单会出现提示（`create`、各个 `import` 子命令、`backup`、`change-password`、`delete`），其余命令一律直接报错而不询问。
命令风格	PascalCase 动词：`RegisterWallet`、`SendCoin`、`GetBalance`。金额以 SUN 计（1 TRX = 1,000,000 SUN）。	名词—动词子命令：`create`、`tx send`、`account balance`，配合 `--flags`。
面向脚本的输出	供人阅读的文本。	通过 `-o json` 输出稳定 JSON（`wallet-cli.result.v1`），配合固定退出码（`0`/`1`/`2`）。
配置 / 网络	`config.conf` 中的端点，或运行时使用 `SwitchNetwork`。主网 · Nile · Shasta · 自定义。	`--network` 参数 / `config` 命令。使用 CAIP-2 网络 id，并带有简短别名：`tron:728126428`（`tron`）· `tron:3448148188`（`nile`）· `tron:2494104990`（`shasta`）· `eip155:1`（`ethereum`）· `eip155:11155111`（`sepolia`）· `eip155:56`（`bsc`）· `eip155:97`（`bsc-testnet`）。
签名	软件 keystore · Ledger。	加密的本地 keystore · Ledger。敏感信息不会从命令行参数或环境变量读取。
功能范围	钱包与转账、质押、投票与奖励、治理、合约、TRC10，以及链上交易所。	HD 钱包、TRX/TRC20/TRC10 转账、质押与代理、投票与奖励、治理提案与超级代表运营、合约调用/部署/治理、TRC10 发行、链上 Bancor 交易所、多重签名、GasFree 转账、消息签名，以及链上查询。
适用场景	需要交互式操作和完整 TRON 功能的用户。	脚本、CI 流水线和 AI 智能体集成。
完整文档	Java CLI	TypeScript CLI

Java 快速体验¶

Java 版仅支持交互式操作。完成构建并启动命令行后，在提示符中输入命令：

$ git clone https://github.com/tronprotocol/wallet-cli.git
$ cd wallet-cli/java && ./gradlew build && cd build/libs
$ java -jar wallet-cli.jar        # 打开交互式提示符
> RegisterWallet                  # 先两次提示输入密码，再询问助记词长度
> Login                           # 解锁
> GetAddress                      # 你的 TRON 地址
> GetBalance                      # TRX 余额

有关环境准备（config.conf、节点连接）、A–Z 命令列表，以及 GasFree、多重签名等功能的详细说明，请参见 Java CLI；也可以直接跳转到环境准备、快速上手、命令，或 GasFree。

TypeScript 快速体验¶

通过 npm 安装后，可以直接在 shell 中执行子命令：

$ npm install -g @tron-walletcli/wallet-cli
$ wallet-cli create --label main               # 提示设置主密码（master password）
$ wallet-cli account balance --network tron:3448148188
$ wallet-cli account balance -o json           # 输出符合 wallet-cli.result.v1 规范的 JSON

每条命令都有独立的参考页，同时提供 JSON 接口规范、退出码和 AI 智能体调用说明。请从 TypeScript CLI 开始，然后：

快速上手——创建钱包并发送第一笔交易
命令参考——全部命令，A–Z
机器接口——JSON 响应结构、退出码、脚本安全

我该用哪一个？¶

编写脚本、运行 CI 或构建 AI 智能体时，建议使用 TypeScript 版，它提供稳定的 JSON 输出和确定的退出码。
希望在 > 提示符中保持长时间会话，并在整个会话中只解锁一次钱包时，建议使用 Java 版。
只需在本机转账 TRX/token 或进行质押时，两者均可；TypeScript CLI 通过 npm 安装，无需本地构建。