Skip to content

wallet-cli-4.16.0

Latest

Choose a tag to compare

@gummy789j gummy789j released this 10 Nov 08:51
f631bf8

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

  1. 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-wait to return right after submission. --wait-timeout and the waitTimeoutMs config key are removed, and the flag now fails with invalid_option. (#1046)

  2. One time limit for the whole command. --timeout <ms> (default 90 seconds, 0 for 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 exits 0 with stage: "submitted", the txId and a warning. (#1046)

  3. 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 with config <key> --api-key-stdin; passing them as arguments fails. (#1046)

  4. 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 with tx status before sending again. Rebroadcasting a signed TRON transaction the node already holds returns alreadyKnown: true instead of an error. (#1046)

  5. 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 with slippage_exceeded before anything is approved, signed or sent. A route quoted at zero output is no longer offered. (#1046)

Bug Fixes

Change

  1. tx status reports TRON results correctly. A mined transaction whose receipt says DEFAULT is now confirmed instead of failed, and a transaction the node marks FAILED is failed. (#1046)

  2. Errors name the real cause. A wrong combination of options now fails with invalid_option instead of invalid_value. Malformed data from a node or a service fails with invalid_node_response or provider_error instead of showing zero or empty values, and HTTP 429 from any service is provider_rate_limited. (#1046)

  3. Failing transfers stop before they cost a fee. stake undelegate above the delegated amount fails with insufficient_stake, and a TRC20 or ERC20 tx send above the token balance fails with insufficient_token_balance. Both checks run before signing, in every mode including --dry-run. (#1046)

  4. Ambiguous token symbols stop before signing. If --token USDT matches no token or more than one token in the book, the command stops and lists the candidates. On EVM, --token together with --contract fails with invalid_option. (#1046)

  5. 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)

  6. 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:

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