Repository navigation
Notice
Non-mandatory upgrade
This release makes the TypeScript CLI safer for scripts and agents: commands now wait for
confirmation and finish within one time limit, and signing refuses payloads meant for another
network. Several options, error codes and JSON fields change, so check scripts that parse the
output before you upgrade. The Java REPL only carries the version bump, with no behavior change.
New Features
Change
-
Commands wait for confirmation by default. A send, a broadcast or a GasFree transfer now returns when the transaction is confirmed or failed, not when it is submitted. Pass
--no-waitto return right after submission.--wait-timeoutand thewaitTimeoutMsconfig key are removed, and the flag now fails withinvalid_option. (#1046) -
One time limit for the whole command.
--timeout <ms>(default 90 seconds,0for no limit) now covers the whole command, including Ledger approval and waiting for confirmation, but not your typing at a prompt. If time runs out after the transaction was accepted, the command still exits0withstage: "submitted", the txId and a warning. (#1046) -
Safer signing and credentials. Signing now refuses a transaction or typed data that names a different chain from the selected network (
chain_id_mismatch), and every Ledger signature is checked against the account before it is used. TronLink, GasFree, B.AI and network API keys are set only withconfig <key> --api-key-stdin; passing them as arguments fails. (#1046) -
Clear signal when a transaction may have gone through. When a request may have acted although the command failed, the error carries
error.details.outcome: "unknown"and the txId. Check it withtx statusbefore sending again. Rebroadcasting a signed TRON transaction the node already holds returnsalreadyKnown: trueinstead of an error. (#1046) -
sunswap swap: set the minimum you receive.--min-out <base-units>sets the floor directly instead of--slippage. If the route already quotes less, the command stops withslippage_exceededbefore anything is approved, signed or sent. A route quoted at zero output is no longer offered. (#1046)
Bug Fixes
Change
-
tx statusreports TRON results correctly. A mined transaction whose receipt saysDEFAULTis nowconfirmedinstead offailed, and a transaction the node marksFAILEDisfailed. (#1046) -
Errors name the real cause. A wrong combination of options now fails with
invalid_optioninstead ofinvalid_value. Malformed data from a node or a service fails withinvalid_node_responseorprovider_errorinstead of showing zero or empty values, and HTTP 429 from any service isprovider_rate_limited. (#1046) -
Failing transfers stop before they cost a fee.
stake undelegateabove the delegated amount fails withinsufficient_stake, and a TRC20 or ERC20tx sendabove the token balance fails withinsufficient_token_balance. Both checks run before signing, in every mode including--dry-run. (#1046) -
Ambiguous token symbols stop before signing. If
--token USDTmatches no token or more than one token in the book, the command stops and lists the candidates. On EVM,--tokentogether with--contractfails withinvalid_option. (#1046) -
A blocked command says how to unblock it. When another wallet-cli process holds a lock, the error names the lock file and the process that holds it. If no wallet-cli command is running, delete the file. (#1046)
-
Updated dependencies. TronWeb is updated to 6.5.1, which verifies the node's copy of a transaction before multi-signing and checks inputs from a single snapshot. Other dependencies with published advisories are updated as well. (#1046, #1049)
Integrity Check
All jar files available in this release are signed via this GPG key:
- PUB: 1254 F859 D2B1 BD9F 66E7 107D F859 BCB4 4A28 290B
- UID: build@tron.network
From the download listings below you should see links to the downloadable jar files as well as sig signature files. To verify the authenticity of any jar file, grab the jar and sig files with the same prefix name and then execute the verification process: GPG signature verification