diff --git a/.claude/settings.json b/.claude/settings.json
new file mode 100644
index 00000000..cb16113f
--- /dev/null
+++ b/.claude/settings.json
@@ -0,0 +1,22 @@
+{
+  "hooks": {
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "if git diff --quiet HEAD -- 'src/' 'build.gradle' '*.java' 2>/dev/null; then echo 'No code changes, skipping tests.'; exit 0; fi && ./gradlew test 2>&1 || true",
+            "timeout": 300,
+            "statusMessage": "Running unit tests..."
+          },
+          {
+            "type": "command",
+            "command": "if git diff --quiet HEAD -- 'src/' 'build.gradle' '*.java' 2>/dev/null; then echo 'No code changes, skipping QA.'; exit 0; fi && ./qa/run.sh verify",
+            "timeout": 600,
+            "statusMessage": "Running full QA verification..."
+          }
+        ]
+      }
+    ]
+  }
+}
diff --git a/.gitignore b/.gitignore
index 54175c1f..769170b5 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,3 +1,4 @@
+.claude/settings.local.json 
 .DS_Store
 build
 out
@@ -11,4 +12,15 @@ src/gen
 tools
 src/main/resources/static/js/tronjs/tron-protoc.js
 logs
+docs
 FileTest
+
+# Wallet keystore files created at runtime
+Wallet/
+Mnemonic/
+wallet_data/
+
+# QA runtime output
+qa/results/
+qa/report.txt
+
diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 00000000..1bd604cd
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,114 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Build & Run
+
+```bash
+# Build the project (generates protobuf sources into src/main/gen/)
+./gradlew build
+
+# Build fat JAR (output: build/libs/wallet-cli.jar)
+./gradlew shadowJar
+
+# Run in REPL 交互模式 (human-friendly, interactive prompts)
+./gradlew run
+# Or after building: java -jar build/libs/wallet-cli.jar
+
+# Run in standard CLI mode (non-interactive, scriptable)
+java -jar build/libs/wallet-cli.jar --network nile get-account --address TXyz...
+java -jar build/libs/wallet-cli.jar --output json --network nile get-account --address TXyz...
+
+# Run tests
+./gradlew test
+
+# Run a single test class
+./gradlew test --tests "org.tron.keystore.StringUtilsTest"
+
+# Clean (also removes src/main/gen/)
+./gradlew clean
+```
+
+Java 8 source/target compatibility. Protobuf sources are in `src/main/protos/` and generate into `src/main/gen/` — this directory is git-tracked but rebuilt on `clean`.
+
+## QA Verification
+
+The `qa/` directory contains shell-based parity tests that compare interactive REPL output vs standard CLI (text and JSON modes). Requires a funded Nile testnet account.
+
+```bash
+# Run QA verification (needs TRON_TEST_APIKEY env var for private key)
+TRON_TEST_APIKEY=<nile-private-key> bash qa/run.sh verify
+
+# QA config is in qa/config.sh; test commands are in qa/commands/*.sh
+# MASTER_PASSWORD env var is used for keystore auto-login (default: testpassword123A)
+```
+
+## Architecture
+
+This is a **TRON blockchain CLI wallet** built on the [Trident SDK](https://github.com/tronprotocol/trident). It communicates with TRON nodes via gRPC.
+
+### Two CLI Modes
+
+1. **REPL 交互模式** (human-friendly) — `Client` class with JCommander `@Parameters` inner classes. Entry point: `org.tron.walletcli.Client`. Features tab completion, interactive prompts, and conversational output. This is the largest file (~4700 lines). Best for manual exploration and day-to-day wallet management by humans.
+2. **Standard CLI 模式** (AI-agent-friendly) — `StandardCliRunner` with `CommandRegistry`/`CommandDefinition` pattern in `org.tron.walletcli.cli.*`. Supports `--output json`, `--network`, `--quiet` flags. Commands are registered in `cli/commands/` classes (e.g., `WalletCommands`, `TransactionCommands`, `QueryCommands`). Designed for automation: deterministic exit codes, structured JSON output, no interactive prompts, and env-var-based authentication — ideal for AI agents, scripts, and CI/CD pipelines.
+
+The standard CLI suppresses all stray stdout/stderr in JSON mode to ensure machine-parseable output. Authentication is automatic via `MASTER_PASSWORD` env var + keystore files in `Wallet/`.
+
+### Request Flow
+
+```
+# Standard CLI mode:
+User Input → GlobalOptions → StandardCliRunner → CommandRegistry → CommandHandler → WalletApiWrapper → WalletApi → Trident SDK → gRPC → TRON Node
+
+# Interactive REPL mode:
+User Input → Client (JCommander) → WalletApiWrapper → WalletApi → Trident SDK → gRPC → TRON Node
+```
+
+### Key Classes
+
+- **`org.tron.walletcli.Client`** — Legacy REPL entry point and CLI command dispatcher. Each command is a JCommander `@Parameters` inner class.
+- **`org.tron.walletcli.cli.StandardCliRunner`** — New standard CLI executor. Handles network init, auto-authentication, JSON stream suppression, and command dispatch.
+- **`org.tron.walletcli.cli.CommandRegistry`** — Maps command names/aliases to `CommandDefinition` instances. Supports fuzzy suggestion on typos.
+- **`org.tron.walletcli.cli.CommandDefinition`** — Immutable command metadata (name, aliases, options, handler). Built via fluent `Builder` API.
+- **`org.tron.walletcli.cli.OutputFormatter`** — Formats output as text or JSON. In JSON mode, wraps results in `{"success":true,"data":...}` envelope.
+- **`org.tron.walletcli.WalletApiWrapper`** — Orchestration layer between CLI and core wallet logic. Handles transaction construction, signing, and broadcasting.
+- **`org.tron.walletserver.WalletApi`** — Core wallet operations: account management, transaction creation, proposals, asset operations. Delegates gRPC calls to Trident.
+- **`org.tron.walletcli.ApiClientFactory`** — Creates gRPC client instances for different networks (mainnet, Nile testnet, Shasta testnet, custom).
+
+### Adding a New Standard CLI Command
+
+1. Create or extend a class in `cli/commands/` (e.g., `TransactionCommands.java`)
+2. Build a `CommandDefinition` via `CommandDefinition.builder()` with name, aliases, options, and handler
+3. Register it in the appropriate `register(CommandRegistry)` method
+4. The handler receives `(ParsedOptions, WalletApiWrapper, OutputFormatter)` — use `formatter.success()/error()` for output
+
+### Package Organization
+
+| Package | Purpose |
+|---------|---------|
+| `walletcli` | CLI entry points, API wrapper |
+| `walletcli.cli` | Standard CLI framework: registry, definitions, options, formatter |
+| `walletcli.cli.commands` | Standard CLI command implementations by domain |
+| `walletserver` | Core wallet API and gRPC communication |
+| `common` | Crypto utilities, encoding, enums, shared helpers |
+| `core` | Configuration, data converters, DAOs, exceptions, managers |
+| `keystore` | Wallet file encryption/decryption, key management |
+| `ledger` | Ledger hardware wallet integration via HID |
+| `mnemonic` | BIP39 mnemonic seed phrase support |
+| `multi` | Multi-signature transaction handling |
+| `gasfree` | GasFree transaction API (transfer tokens without gas) |
+
+### Configuration
+
+- **Network config:** `src/main/resources/config.conf` (HOCON format via Typesafe Config)
+- **Logging:** `src/main/resources/logback.xml` (Logback, INFO level console + rolling file)
+- **Lombok:** `lombok.config` — uses `logger` as the log field name (not the default `log`)
+
+### Key Frameworks & Libraries
+
+- **Trident SDK 0.10.0** — All gRPC API calls to TRON nodes
+- **JCommander 1.82** — CLI argument parsing (REPL 交互模式)
+- **JLine 3.25.0** — Interactive terminal/readline
+- **BouncyCastle** — Cryptographic operations
+- **Protobuf 3.25.5 / gRPC 1.60.0** — Protocol definitions and transport
+- **Lombok** — `@Getter`, `@Setter`, `@Slf4j` etc. (annotation processing)
diff --git a/build.gradle b/build.gradle
index ff2c8514..46ff8992 100644
--- a/build.gradle
+++ b/build.gradle
@@ -146,3 +146,10 @@ shadowJar {
     version = null
     mergeServiceFiles() //  https://github.com/grpc/grpc-java/issues/10853
 }
+
+task qaRun(type: JavaExec) {
+    classpath = sourceSets.main.runtimeClasspath
+    mainClass = 'org.tron.qa.QARunner'
+    args = project.hasProperty('qaArgs') ? project.property('qaArgs').split(' ') : ['list']
+    standardInput = System.in
+}
diff --git a/qa/commands/query_commands.sh b/qa/commands/query_commands.sh
new file mode 100755
index 00000000..368bb3e0
--- /dev/null
+++ b/qa/commands/query_commands.sh
@@ -0,0 +1,328 @@
+#!/bin/bash
+# Query command test definitions — ALL query commands
+# Each command is tested for: --help, text output, JSON output, text/JSON parity
+
+_filter() {
+  grep -v "^User defined config file" | grep -v "^Authenticated with" || true
+}
+
+_run() {
+  java -jar "$WALLET_JAR" --network "$NETWORK" "$@" 2>/dev/null | _filter
+}
+
+_run_auth() {
+  local method="$1"; shift
+  # Wallet is pre-imported via _import_wallet; auto-login uses MASTER_PASSWORD
+  java -jar "$WALLET_JAR" --network "$NETWORK" "$@" 2>/dev/null | _filter
+}
+
+_recent_blocks_json() {
+  _run --output json get-block-by-latest-num --count 10
+}
+
+_extract_recent_blockid() {
+  local recent_json="$1"
+  echo "$recent_json" | grep -o '"blockid": "[^"]*"' | head -1 | awk -F'"' '{print $4}' || true
+}
+
+_extract_recent_txid() {
+  local recent_json="$1"
+  echo "$recent_json" | grep -o '"txid": "[^"]*"' | head -1 | awk -F'"' '{print $4}' || true
+}
+
+# Test --help for a command
+_test_help() {
+  local cmd="$1"
+  if ! _qa_case_enabled "${cmd}-help"; then
+    return
+  fi
+  echo -n "  $cmd --help... "
+  local out
+  out=$(java -jar "$WALLET_JAR" "$cmd" --help 2>/dev/null) || true
+  if [ -n "$out" ]; then
+    echo "PASS" > "$RESULTS_DIR/${cmd}-help.result"; echo "PASS"
+  else
+    echo "FAIL" > "$RESULTS_DIR/${cmd}-help.result"; echo "FAIL"
+  fi
+}
+
+# Test command with auth: text + json + parity
+_test_auth_full() {
+  local method="$1" prefix="$2" cmd="$3"; shift 3
+  if ! _qa_case_enabled "${prefix}_${cmd}"; then
+    return
+  fi
+  echo -n "  $cmd ($prefix)... "
+  local text_out json_out result
+  text_out=$(_run_auth "$method" "$cmd" "$@") || true
+  json_out=$(_run_auth "$method" --output json "$cmd" "$@") || true
+  echo "$text_out" > "$RESULTS_DIR/${prefix}_${cmd}_text.out"
+  echo "$json_out" > "$RESULTS_DIR/${prefix}_${cmd}_json.out"
+  result=$(check_json_text_parity "$cmd" "$text_out" "$json_out")
+  echo "$result" > "$RESULTS_DIR/${prefix}_${cmd}.result"
+  echo "$result"
+}
+
+# Test command without auth: text + json + parity
+_test_noauth_full() {
+  local prefix="$1" cmd="$2"; shift 2
+  if ! _qa_case_enabled "${prefix}_${cmd}"; then
+    return
+  fi
+  echo -n "  $cmd ($prefix)... "
+  local text_out json_out result
+  text_out=$(_run "$cmd" "$@") || true
+  json_out=$(_run --output json "$cmd" "$@") || true
+  echo "$text_out" > "$RESULTS_DIR/${prefix}_${cmd}_text.out"
+  echo "$json_out" > "$RESULTS_DIR/${prefix}_${cmd}_json.out"
+  result=$(check_json_text_parity "$cmd" "$text_out" "$json_out")
+  echo "$result" > "$RESULTS_DIR/${prefix}_${cmd}.result"
+  echo "$result"
+}
+
+# Test command without auth: text only (for commands whose JSON mode is not meaningful)
+_test_noauth_text() {
+  local prefix="$1" cmd="$2"; shift 2
+  if ! _qa_case_enabled "${prefix}_${cmd}"; then
+    return
+  fi
+  echo -n "  $cmd ($prefix, text)... "
+  local text_out
+  text_out=$(_run "$cmd" "$@") || true
+  echo "$text_out" > "$RESULTS_DIR/${prefix}_${cmd}_text.out"
+  if [ -n "$text_out" ]; then
+    echo "PASS" > "$RESULTS_DIR/${prefix}_${cmd}.result"; echo "PASS"
+  else
+    echo "FAIL: empty output" > "$RESULTS_DIR/${prefix}_${cmd}.result"; echo "FAIL"
+  fi
+}
+
+# Test no-crash: command may return empty but should not error
+_test_no_crash() {
+  local prefix="$1" cmd="$2"; shift 2
+  if ! _qa_case_enabled "${prefix}_${cmd}"; then
+    return
+  fi
+  echo -n "  $cmd ($prefix)... "
+  local out
+  out=$(_run "$cmd" "$@" 2>&1) || true
+  echo "PASS" > "$RESULTS_DIR/${prefix}_${cmd}.result"; echo "PASS (no crash)"
+}
+
+run_query_tests() {
+  local auth_method="$1"
+  local prefix="${auth_method}"
+
+  # Get own address for parameterized queries
+  local my_addr
+  my_addr=$(_run_auth "$auth_method" get-address | grep "address = " | awk '{print $NF}')
+
+  # ===========================================================
+  # Help verification for ALL query commands
+  # ===========================================================
+  echo "  --- Help verification (query commands) ---"
+  _test_help "get-address"
+  _test_help "get-balance"
+  _test_help "get-usdt-balance"
+  _test_help "current-network"
+  _test_help "get-block"
+  _test_help "get-block-by-id"
+  _test_help "get-block-by-id-or-num"
+  _test_help "get-block-by-latest-num"
+  _test_help "get-block-by-limit-next"
+  _test_help "get-transaction-by-id"
+  _test_help "get-transaction-info-by-id"
+  _test_help "get-transaction-count-by-block-num"
+  _test_help "get-account"
+  _test_help "get-account-by-id"
+  _test_help "get-account-net"
+  _test_help "get-account-resource"
+  _test_help "get-asset-issue-by-account"
+  _test_help "get-asset-issue-by-id"
+  _test_help "get-asset-issue-by-name"
+  _test_help "get-asset-issue-list-by-name"
+  _test_help "get-chain-parameters"
+  _test_help "get-bandwidth-prices"
+  _test_help "get-energy-prices"
+  _test_help "get-memo-fee"
+  _test_help "get-next-maintenance-time"
+  _test_help "get-contract"
+  _test_help "get-contract-info"
+  _test_help "get-delegated-resource"
+  _test_help "get-delegated-resource-v2"
+  _test_help "get-delegated-resource-account-index"
+  _test_help "get-delegated-resource-account-index-v2"
+  _test_help "get-can-delegated-max-size"
+  _test_help "get-available-unfreeze-count"
+  _test_help "get-can-withdraw-unfreeze-amount"
+  _test_help "get-brokerage"
+  _test_help "get-reward"
+  _test_help "list-nodes"
+  _test_help "list-witnesses"
+  _test_help "list-asset-issue"
+  _test_help "list-asset-issue-paginated"
+  _test_help "list-proposals"
+  _test_help "list-proposals-paginated"
+  _test_help "get-proposal"
+  _test_help "list-exchanges"
+  _test_help "list-exchanges-paginated"
+  _test_help "get-exchange"
+  _test_help "get-market-order-by-account"
+  _test_help "get-market-order-by-id"
+  _test_help "get-market-order-list-by-pair"
+  _test_help "get-market-pair-list"
+  _test_help "get-market-price-by-pair"
+  _test_help "gas-free-info"
+  _test_help "gas-free-trace"
+
+  echo ""
+  echo "  --- Query execution (text + JSON) ---"
+
+  # ===========================================================
+  # Auth-required, no params
+  # ===========================================================
+  _test_auth_full "$auth_method" "$prefix" "get-address"
+  _test_auth_full "$auth_method" "$prefix" "get-balance"
+  _test_auth_full "$auth_method" "$prefix" "get-usdt-balance"
+
+  # ===========================================================
+  # No-auth, no params — text + JSON
+  # ===========================================================
+  _test_noauth_full "$prefix" "current-network"
+  _test_noauth_full "$prefix" "get-block"
+  _test_noauth_full "$prefix" "get-chain-parameters"
+  _test_noauth_full "$prefix" "get-bandwidth-prices"
+  _test_noauth_full "$prefix" "get-energy-prices"
+  _test_noauth_full "$prefix" "get-memo-fee"
+  _test_noauth_full "$prefix" "get-next-maintenance-time"
+  _test_noauth_full "$prefix" "list-nodes"
+  _test_noauth_full "$prefix" "list-witnesses"
+  _test_noauth_full "$prefix" "list-asset-issue"
+  _test_noauth_full "$prefix" "list-proposals"
+  _test_noauth_full "$prefix" "list-exchanges"
+  _test_noauth_full "$prefix" "get-market-pair-list"
+
+  # ===========================================================
+  # Address-parameterized queries — text + JSON
+  # ===========================================================
+  if [ -n "$my_addr" ]; then
+    _test_noauth_full "$prefix" "get-account" --address "$my_addr"
+    _test_noauth_full "$prefix" "get-account-net" --address "$my_addr"
+    _test_noauth_full "$prefix" "get-account-resource" --address "$my_addr"
+    _test_noauth_full "$prefix" "get-delegated-resource-account-index" --address "$my_addr"
+    _test_noauth_full "$prefix" "get-delegated-resource-account-index-v2" --address "$my_addr"
+    _test_noauth_full "$prefix" "get-can-delegated-max-size" --owner "$my_addr" --type 0
+    _test_noauth_full "$prefix" "get-available-unfreeze-count" --address "$my_addr"
+    _test_noauth_full "$prefix" "get-can-withdraw-unfreeze-amount" --address "$my_addr"
+    _test_noauth_full "$prefix" "get-brokerage" --address "$my_addr"
+    _test_noauth_full "$prefix" "get-reward" --address "$my_addr"
+    _test_noauth_full "$prefix" "get-market-order-by-account" --address "$my_addr"
+    _test_noauth_full "$prefix" "get-asset-issue-by-account" --address "$my_addr"
+    _test_noauth_full "$prefix" "get-delegated-resource" --from "$my_addr" --to "$my_addr"
+    _test_noauth_full "$prefix" "get-delegated-resource-v2" --from "$my_addr" --to "$my_addr"
+  fi
+
+  # ===========================================================
+  # Block-based queries — text + JSON
+  # ===========================================================
+  _test_noauth_full "$prefix" "get-block-by-latest-num" --count 2
+  _test_noauth_full "$prefix" "get-block-by-limit-next" --start 1 --end 3
+  _test_noauth_full "$prefix" "get-transaction-count-by-block-num" --number 1
+  _test_noauth_full "$prefix" "get-block-by-id-or-num" --value 1
+
+  # get-block-by-id: need a block hash
+  if _qa_case_enabled "${prefix}_get-block-by-id"; then
+  echo -n "  get-block-by-id ($prefix)... "
+  local recent_blocks_json block_id
+  recent_blocks_json=$(_recent_blocks_json) || true
+  block_id=$(_extract_recent_blockid "$recent_blocks_json")
+  if [ -n "$block_id" ]; then
+    local bid_text bid_json
+    bid_text=$(_run get-block-by-id --id "$block_id") || true
+    bid_json=$(_run --output json get-block-by-id --id "$block_id") || true
+    echo "$bid_text" > "$RESULTS_DIR/${prefix}_get-block-by-id_text.out"
+    echo "$bid_json" > "$RESULTS_DIR/${prefix}_get-block-by-id_json.out"
+    if [ -n "$bid_text" ]; then
+      echo "PASS" > "$RESULTS_DIR/${prefix}_get-block-by-id.result"; echo "PASS"
+    else
+      echo "FAIL" > "$RESULTS_DIR/${prefix}_get-block-by-id.result"; echo "FAIL"
+    fi
+  else
+    echo "SKIP: no blockid available from get-block-by-latest-num --count 10" > "$RESULTS_DIR/${prefix}_get-block-by-id.result"
+    echo "SKIP"
+  fi
+  fi
+
+  # get-transaction-by-id / get-transaction-info-by-id
+  if _qa_case_enabled "${prefix}_get-transaction-by-id" || _qa_case_enabled "${prefix}_get-transaction-info-by-id"; then
+  echo -n "  get-transaction-by-id ($prefix)... "
+  local recent_blocks_json tx_id
+  recent_blocks_json=$(_recent_blocks_json) || true
+  tx_id=$(_extract_recent_txid "$recent_blocks_json")
+  if [ -n "$tx_id" ]; then
+    local tx_text tx_json
+    tx_text=$(_run get-transaction-by-id --id "$tx_id") || true
+    tx_json=$(_run --output json get-transaction-by-id --id "$tx_id") || true
+    echo "$tx_text" > "$RESULTS_DIR/${prefix}_get-transaction-by-id_text.out"
+    echo "$tx_json" > "$RESULTS_DIR/${prefix}_get-transaction-by-id_json.out"
+    if [ -n "$tx_text" ]; then
+      echo "PASS" > "$RESULTS_DIR/${prefix}_get-transaction-by-id.result"; echo "PASS"
+    else
+      echo "FAIL" > "$RESULTS_DIR/${prefix}_get-transaction-by-id.result"; echo "FAIL"
+    fi
+
+    echo -n "  get-transaction-info-by-id ($prefix)... "
+    local txi_text txi_json
+    txi_text=$(_run get-transaction-info-by-id --id "$tx_id") || true
+    txi_json=$(_run --output json get-transaction-info-by-id --id "$tx_id") || true
+    echo "$txi_text" > "$RESULTS_DIR/${prefix}_get-transaction-info-by-id_text.out"
+    echo "$txi_json" > "$RESULTS_DIR/${prefix}_get-transaction-info-by-id_json.out"
+    if [ -n "$txi_text" ]; then
+      echo "PASS" > "$RESULTS_DIR/${prefix}_get-transaction-info-by-id.result"; echo "PASS"
+    else
+      echo "FAIL" > "$RESULTS_DIR/${prefix}_get-transaction-info-by-id.result"; echo "FAIL"
+    fi
+  else
+    if _qa_case_enabled "${prefix}_get-transaction-by-id"; then
+      echo "SKIP: no txid available from get-block-by-latest-num --count 10" > "$RESULTS_DIR/${prefix}_get-transaction-by-id.result"
+    fi
+    if _qa_case_enabled "${prefix}_get-transaction-info-by-id"; then
+      echo "SKIP: no txid available from get-block-by-latest-num --count 10" > "$RESULTS_DIR/${prefix}_get-transaction-info-by-id.result"
+    fi
+    echo "SKIP"
+  fi
+  fi
+
+  # ===========================================================
+  # ID-based queries — text + JSON
+  # ===========================================================
+  _test_noauth_full "$prefix" "get-account-by-id" --id "testid"
+  _test_noauth_full "$prefix" "get-asset-issue-by-id" --id "1000001"
+  _test_noauth_full "$prefix" "get-asset-issue-by-name" --name "TRX"
+  _test_noauth_full "$prefix" "get-asset-issue-list-by-name" --name "TRX"
+
+  # Paginated queries — text + JSON
+  _test_noauth_full "$prefix" "list-asset-issue-paginated" --offset 0 --limit 5
+  _test_noauth_full "$prefix" "list-proposals-paginated" --offset 0 --limit 5
+  _test_noauth_full "$prefix" "list-exchanges-paginated" --offset 0 --limit 5
+
+  # Contract queries — text + JSON
+  local usdt_nile="TXYZopYRdj2D9XRtbG411XZZ3kM5VkAeBf"
+  _test_noauth_full "$prefix" "get-contract" --address "$usdt_nile"
+  _test_noauth_full "$prefix" "get-contract-info" --address "$usdt_nile"
+
+  # Market queries — text + JSON
+  _test_noauth_full "$prefix" "get-market-order-list-by-pair" --sell-token "_" --buy-token "1000001"
+  _test_noauth_full "$prefix" "get-market-price-by-pair" --sell-token "_" --buy-token "1000001"
+  _test_noauth_full "$prefix" "get-market-order-by-id" --id "0000000000000000000000000000000000000000000000000000000000000001"
+
+  # Proposal / Exchange by ID — text + JSON
+  _test_noauth_full "$prefix" "get-proposal" --id "1"
+  _test_noauth_full "$prefix" "get-exchange" --id "1"
+
+  # GasFree queries
+  if [ -n "$my_addr" ]; then
+    _test_auth_full "$auth_method" "$prefix" "gas-free-info" --address "$my_addr"
+    _test_auth_full "$auth_method" "$prefix" "gas-free-trace" --address "$my_addr"
+  fi
+}
diff --git a/qa/commands/transaction_commands.sh b/qa/commands/transaction_commands.sh
new file mode 100755
index 00000000..8d6384f2
--- /dev/null
+++ b/qa/commands/transaction_commands.sh
@@ -0,0 +1,565 @@
+#!/bin/bash
+# Transaction, staking, witness, proposal, exchange, contract command tests
+# Covers ALL mutation commands with real on-chain execution or help verification
+
+_tx_filter() {
+  grep -v "^User defined config file" | grep -v "^Authenticated with" || true
+}
+
+_tx_run() {
+  # Wallet is pre-imported; auto-login uses MASTER_PASSWORD
+  java -jar "$WALLET_JAR" --network "$NETWORK" "$@" 2>/dev/null | _tx_filter
+}
+
+_tx_run_json() {
+  java -jar "$WALLET_JAR" --network "$NETWORK" --output json "$@" 2>/dev/null | _tx_filter
+}
+
+_tx_run_mnemonic() {
+  _import_wallet "mnemonic" > /dev/null 2>&1
+  java -jar "$WALLET_JAR" --network "$NETWORK" "$@" 2>/dev/null | _tx_filter
+  _import_wallet "private-key" > /dev/null 2>&1
+}
+
+_get_address() {
+  local method="$1"
+  if [ "$method" = "mnemonic" ] && [ -n "${MNEMONIC:-}" ]; then
+    _import_wallet "mnemonic" > /dev/null 2>&1
+    local addr
+    addr=$(java -jar "$WALLET_JAR" --network "$NETWORK" get-address 2>/dev/null | _tx_filter | grep "address = " | awk '{print $NF}')
+    _import_wallet "private-key" > /dev/null 2>&1
+    echo "$addr"
+  else
+    java -jar "$WALLET_JAR" --network "$NETWORK" get-address 2>/dev/null | _tx_filter | grep "address = " | awk '{print $NF}'
+  fi
+}
+
+_get_balance_sun() {
+  _tx_run get-balance | grep "Balance = " | awk '{print $3}'
+}
+
+_wait_for_balance_decrease() {
+  local before_balance="$1"
+  local attempts="${2:-5}"
+  local sleep_secs="${3:-3}"
+  local current_balance=""
+  local i
+
+  for ((i=1; i<=attempts; i++)); do
+    current_balance=$(_get_balance_sun)
+    if [ -n "$before_balance" ] && [ -n "$current_balance" ] && [ "$current_balance" -lt "$before_balance" ]; then
+      echo "$current_balance"
+      return 0
+    fi
+    if [ "$i" -lt "$attempts" ]; then
+      sleep "$sleep_secs"
+    fi
+  done
+
+  echo "$current_balance"
+  return 1
+}
+
+_get_account_resource() {
+  local address="$1"
+  _tx_run get-account-resource --address "$address"
+}
+
+_json_success_true() {
+  local json_input="$1"
+  echo "$json_input" | python3 -c "import sys, json; d=json.load(sys.stdin); assert d.get('success') is True; assert 'data' in d" 2>/dev/null
+}
+
+_json_field() {
+  local json_input="$1"
+  local field_path="$2"
+  echo "$json_input" | python3 -c "import sys, json; d=json.load(sys.stdin); v=d; path=sys.argv[1].split('.'); 
+for p in path:
+    v=v.get(p) if isinstance(v, dict) else None
+    if v is None:
+        break
+print(v if v is not None else '')" "$field_path" 2>/dev/null
+}
+
+_wait_for_transaction_info() {
+  local txid="$1"
+  local attempts="${2:-5}"
+  local sleep_secs="${3:-3}"
+  local out=""
+  local i
+
+  if [ -z "$txid" ]; then
+    return 1
+  fi
+
+  for ((i=1; i<=attempts; i++)); do
+    out=$(_tx_run get-transaction-info-by-id --id "$txid") || true
+    if [ -n "$out" ] && ! echo "$out" | grep -qi "^Error:"; then
+      echo "$out"
+      return 0
+    fi
+    if [ "$i" -lt "$attempts" ]; then
+      sleep "$sleep_secs"
+    fi
+  done
+
+  return 1
+}
+
+# Test on-chain tx: text mode, check for "successful"
+_test_tx_text() {
+  local label="$1"; shift
+  if ! _qa_case_enabled "${label}-text"; then
+    return 2
+  fi
+  echo -n "  $label (text)... "
+  local out
+  out=$(_tx_run "$@") || true
+  echo "$out" > "$RESULTS_DIR/${label}-text.out"
+  if echo "$out" | grep -qi "successful"; then
+    echo "PASS" > "$RESULTS_DIR/${label}-text.result"; echo "PASS"
+    return 0
+  else
+    local short_err
+    short_err=$(echo "$out" | grep -iE "failed|error|Warning" | head -1)
+    echo "FAIL: ${short_err:-no successful msg}" > "$RESULTS_DIR/${label}-text.result"; echo "FAIL"
+    return 1
+  fi
+}
+
+# Test on-chain tx: json mode, check for "success"
+_test_tx_json() {
+  local label="$1"; shift
+  if ! _qa_case_enabled "${label}-json"; then
+    return 2
+  fi
+  echo -n "  $label (json)... "
+  local out
+  out=$(_tx_run_json "$@") || true
+  echo "$out" > "$RESULTS_DIR/${label}-json.out"
+  if _json_success_true "$out"; then
+    echo "PASS" > "$RESULTS_DIR/${label}-json.result"; echo "PASS"
+    return 0
+  else
+    local short_err
+    short_err=$(echo "$out" | grep -iE "failed|error" | head -1)
+    echo "FAIL: ${short_err:-no success field}" > "$RESULTS_DIR/${label}-json.result"; echo "FAIL"
+    return 1
+  fi
+}
+
+# Test --help for a command
+_test_help() {
+  local cmd="$1"
+  if ! _qa_case_enabled "${cmd}-help"; then
+    return
+  fi
+  echo -n "  $cmd --help... "
+  local out
+  out=$(java -jar "$WALLET_JAR" "$cmd" --help 2>/dev/null) || true
+  if [ -n "$out" ]; then
+    echo "PASS" > "$RESULTS_DIR/${cmd}-help.result"; echo "PASS"
+  else
+    echo "FAIL" > "$RESULTS_DIR/${cmd}-help.result"; echo "FAIL"
+  fi
+}
+
+# Expected-error verification: run text+JSON, accept error output as valid
+# Passes if both text and JSON produce non-empty output and JSON is valid
+_test_tx_error_full() {
+  local cmd="$1"; shift
+  if ! _qa_case_enabled "$cmd"; then
+    return
+  fi
+  echo -n "  $cmd (error-verify)... "
+  local text_out json_out
+  text_out=$(_tx_run "$cmd" "$@" 2>&1) || true
+  json_out=$(_tx_run_json "$cmd" "$@" 2>&1) || true
+  echo "$text_out" > "$RESULTS_DIR/${cmd}_text.out"
+  echo "$json_out" > "$RESULTS_DIR/${cmd}_json.out"
+  result=$(check_json_text_parity "$cmd" "$text_out" "$json_out")
+  echo "$result" > "$RESULTS_DIR/${cmd}.result"
+  echo "$result"
+}
+
+run_transaction_tests() {
+  local my_addr target_addr
+  my_addr=$(_get_address "private-key")
+
+  if [ -z "$my_addr" ]; then
+    echo "  ERROR: Cannot get own address. Skipping transaction tests."
+    return
+  fi
+
+  # Determine target address for transfers
+  if [ -n "${MNEMONIC:-}" ]; then
+    target_addr=$(_get_address "mnemonic")
+  fi
+  if [ -z "$target_addr" ]; then
+    target_addr="TNPeeaaFB7K9cmo4uQpcU32zGK8G1NYqeL"
+  fi
+
+  echo "  PK account:  $my_addr"
+  echo "  Target addr: $target_addr"
+  echo ""
+
+  # ============================================================
+  # Help verification for ALL mutation commands
+  # ============================================================
+  echo "  --- Help verification (all commands) ---"
+  _test_help "send-coin"
+  _test_help "transfer-asset"
+  _test_help "transfer-usdt"
+  _test_help "participate-asset-issue"
+  _test_help "asset-issue"
+  _test_help "create-account"
+  _test_help "update-account"
+  _test_help "set-account-id"
+  _test_help "update-asset"
+  _test_help "broadcast-transaction"
+  _test_help "add-transaction-sign"
+  _test_help "update-account-permission"
+  _test_help "tronlink-multi-sign"
+  _test_help "gas-free-transfer"
+  _test_help "deploy-contract"
+  _test_help "trigger-contract"
+  _test_help "trigger-constant-contract"
+  _test_help "estimate-energy"
+  _test_help "clear-contract-abi"
+  _test_help "update-setting"
+  _test_help "update-energy-limit"
+  _test_help "freeze-balance"
+  _test_help "freeze-balance-v2"
+  _test_help "unfreeze-balance"
+  _test_help "unfreeze-balance-v2"
+  _test_help "withdraw-expire-unfreeze"
+  _test_help "delegate-resource"
+  _test_help "undelegate-resource"
+  _test_help "cancel-all-unfreeze-v2"
+  _test_help "withdraw-balance"
+  _test_help "unfreeze-asset"
+  _test_help "create-witness"
+  _test_help "update-witness"
+  _test_help "vote-witness"
+  _test_help "update-brokerage"
+  _test_help "create-proposal"
+  _test_help "approve-proposal"
+  _test_help "delete-proposal"
+  _test_help "exchange-create"
+  _test_help "exchange-inject"
+  _test_help "exchange-withdraw"
+  _test_help "exchange-transaction"
+  _test_help "market-sell-asset"
+  _test_help "market-cancel-order"
+
+  # ============================================================
+  # On-chain transaction tests (Nile)
+  # ============================================================
+  echo ""
+  echo "  --- On-chain transaction tests (Nile) ---"
+
+  # --- send-coin ---
+  local balance_before
+  local send_coin_text_ok=1 send_coin_json_ok=1
+  local send_coin_txid=""
+  balance_before=$(_get_balance_sun)
+  if _qa_case_enabled "send-coin-balance" && ! _qa_case_enabled "send-coin-text" && ! _qa_case_enabled "send-coin-json"; then
+    local send_coin_side_effect_out
+    send_coin_side_effect_out=$(_tx_run_json send-coin --to "$target_addr" --amount 1) || true
+    echo "$send_coin_side_effect_out" > "$RESULTS_DIR/send-coin-balance_tx_json.out"
+    if _json_success_true "$send_coin_side_effect_out"; then
+      send_coin_text_ok=1
+      send_coin_json_ok=1
+      send_coin_txid=$(_json_field "$send_coin_side_effect_out" "data.txid")
+    else
+      send_coin_text_ok=0
+      send_coin_json_ok=0
+    fi
+  else
+    _test_tx_text "send-coin" send-coin --to "$target_addr" --amount 1 || send_coin_text_ok=0
+    _test_tx_json "send-coin" send-coin --to "$target_addr" --amount 1 || send_coin_json_ok=0
+    if [ -f "$RESULTS_DIR/send-coin-json.out" ]; then
+      send_coin_txid=$(_json_field "$(cat "$RESULTS_DIR/send-coin-json.out")" "data.txid")
+    fi
+  fi
+  sleep 4
+  if _qa_case_enabled "send-coin-balance"; then
+    echo -n "  send-coin balance check... "
+    if [ "$send_coin_text_ok" -eq 0 ] && [ "$send_coin_json_ok" -eq 0 ]; then
+      echo "SKIP: send-coin transaction did not succeed, side-effect not checked" > "$RESULTS_DIR/send-coin-balance.result"
+      echo "SKIP"
+    else
+      local balance_after
+      balance_after=$(_wait_for_balance_decrease "$balance_before" 5 3)
+      if [ -n "$balance_before" ] && [ -n "$balance_after" ] && [ "$balance_after" -lt "$balance_before" ]; then
+        echo "PASS (side-effect verified: before=${balance_before}, after=${balance_after})" > "$RESULTS_DIR/send-coin-balance.result"
+        echo "PASS (side-effect verified)"
+      elif _wait_for_transaction_info "$send_coin_txid" 5 3 > "$RESULTS_DIR/send-coin-balance_tx_info.out"; then
+        echo "PASS (txid verified: ${send_coin_txid})" > "$RESULTS_DIR/send-coin-balance.result"
+        echo "PASS (txid verified)"
+      else
+        echo "FAIL: balance did not decrease and tx receipt was not observed after successful send-coin (txid=${send_coin_txid:-none}, before=${balance_before}, after=${balance_after})" > "$RESULTS_DIR/send-coin-balance.result"
+        echo "FAIL"
+      fi
+    fi
+  fi
+
+  # --- send-coin with mnemonic ---
+  if [ -n "${MNEMONIC:-}" ] && [ -n "$target_addr" ]; then
+    if _qa_case_enabled "send-coin-mnemonic"; then
+    echo -n "  send-coin (mnemonic)... "
+    local mn_out
+    mn_out=$(_tx_run_mnemonic send-coin --to "$my_addr" --amount 1) || true
+    echo "$mn_out" > "$RESULTS_DIR/send-coin-mnemonic.out"
+    if echo "$mn_out" | grep -qi "successful"; then
+      echo "PASS" > "$RESULTS_DIR/send-coin-mnemonic.result"; echo "PASS"
+    else
+      echo "FAIL" > "$RESULTS_DIR/send-coin-mnemonic.result"; echo "FAIL"
+    fi
+    sleep 3
+    fi
+  fi
+
+  # --- freeze-balance-v2 (1 TRX for ENERGY) ---
+  local resource_before
+  resource_before=$(_get_account_resource "$my_addr")
+  _test_tx_text "freeze-v2-energy" freeze-balance-v2 --amount 1000000 --resource 1
+  _test_tx_json "freeze-v2-energy" freeze-balance-v2 --amount 1000000 --resource 1
+  sleep 4
+
+  # --- get-account-resource after freeze ---
+  local res_out
+  if _qa_case_enabled "post-freeze-resource"; then
+    echo -n "  get-account-resource (post-freeze)... "
+    res_out=$(_tx_run get-account-resource --address "$my_addr") || true
+    echo "$res_out" > "$RESULTS_DIR/post-freeze-resource.out"
+    if [ -n "$resource_before" ] && [ -n "$res_out" ] && [ "$resource_before" != "$res_out" ]; then
+      echo "PASS (side-effect verified)" > "$RESULTS_DIR/post-freeze-resource.result"; echo "PASS"
+    else
+      echo "FAIL: account resource output did not change" > "$RESULTS_DIR/post-freeze-resource.result"; echo "FAIL"
+    fi
+  else
+    res_out=$(_tx_run get-account-resource --address "$my_addr") || true
+  fi
+
+  # --- unfreeze-balance-v2 (1 TRX ENERGY) ---
+  _test_tx_text "unfreeze-v2-energy" unfreeze-balance-v2 --amount 1000000 --resource 1
+  _test_tx_json "unfreeze-v2-energy" unfreeze-balance-v2 --amount 1000000 --resource 1
+  sleep 4
+  if _qa_case_enabled "post-unfreeze-resource"; then
+    echo -n "  get-account-resource (post-unfreeze)... "
+    local res_after_unfreeze
+    res_after_unfreeze=$(_tx_run get-account-resource --address "$my_addr") || true
+    echo "$res_after_unfreeze" > "$RESULTS_DIR/post-unfreeze-resource.out"
+    if [ -n "$res_out" ] && [ -n "$res_after_unfreeze" ] && [ "$res_out" != "$res_after_unfreeze" ]; then
+      echo "PASS (side-effect verified)" > "$RESULTS_DIR/post-unfreeze-resource.result"; echo "PASS"
+    else
+      echo "FAIL: account resource output did not change after unfreeze" > "$RESULTS_DIR/post-unfreeze-resource.result"; echo "FAIL"
+    fi
+  fi
+  sleep 4
+
+  # --- freeze-balance-v2 (1 TRX for BANDWIDTH) ---
+  _test_tx_text "freeze-v2-bandwidth" freeze-balance-v2 --amount 1000000 --resource 0
+  sleep 4
+
+  # --- unfreeze-balance-v2 (1 TRX BANDWIDTH) ---
+  _test_tx_text "unfreeze-v2-bandwidth" unfreeze-balance-v2 --amount 1000000 --resource 0
+  sleep 4
+
+  # --- withdraw-expire-unfreeze ---
+  if _qa_case_enabled "withdraw-expire-unfreeze"; then
+    echo -n "  withdraw-expire-unfreeze... "
+    local weu_out
+    weu_out=$(_tx_run withdraw-expire-unfreeze) || true
+    echo "$weu_out" > "$RESULTS_DIR/withdraw-expire-unfreeze.out"
+    echo "PASS (smoke)" > "$RESULTS_DIR/withdraw-expire-unfreeze.result"; echo "PASS (smoke)"
+  fi
+
+  # --- cancel-all-unfreeze-v2 ---
+  if _qa_case_enabled "cancel-all-unfreeze-v2"; then
+    echo -n "  cancel-all-unfreeze-v2... "
+    local cau_out
+    cau_out=$(_tx_run cancel-all-unfreeze-v2) || true
+    echo "$cau_out" > "$RESULTS_DIR/cancel-all-unfreeze-v2.out"
+    echo "PASS (smoke)" > "$RESULTS_DIR/cancel-all-unfreeze-v2.result"; echo "PASS (smoke)"
+  fi
+
+  # --- trigger-constant-contract (USDT balanceOf, read-only) ---
+  local usdt_nile="TXYZopYRdj2D9XRtbG411XZZ3kM5VkAeBf"
+  if _qa_case_enabled "trigger-constant-contract"; then
+    echo -n "  trigger-constant-contract (USDT balanceOf)... "
+    local tcc_out
+    tcc_out=$(_tx_run trigger-constant-contract \
+      --contract "$usdt_nile" \
+      --method "balanceOf(address)" \
+      --params "\"$my_addr\"") || true
+    echo "$tcc_out" > "$RESULTS_DIR/trigger-constant-contract.out"
+    if [ -n "$tcc_out" ]; then
+      echo "PASS" > "$RESULTS_DIR/trigger-constant-contract.result"; echo "PASS"
+    else
+      echo "FAIL" > "$RESULTS_DIR/trigger-constant-contract.result"; echo "FAIL"
+    fi
+  fi
+
+  # --- transfer-usdt (send 1 USDT unit to target) ---
+  _test_tx_text "transfer-usdt" transfer-usdt --to "$target_addr" --amount 1
+  _test_tx_json "transfer-usdt" transfer-usdt --to "$target_addr" --amount 1
+  sleep 4
+
+  # --- trigger-contract (USDT approve, real on-chain write) ---
+  _test_tx_text "trigger-contract" trigger-contract \
+    --contract "$usdt_nile" \
+    --method "approve(address,uint256)" \
+    --params "\"$target_addr\",0" \
+    --fee-limit 100000000
+  _test_tx_json "trigger-contract" trigger-contract \
+    --contract "$usdt_nile" \
+    --method "approve(address,uint256)" \
+    --params "\"$target_addr\",0" \
+    --fee-limit 100000000
+  sleep 4
+
+  # --- deploy-contract (minimal storage contract on Nile) ---
+  # Solidity: contract Store { uint256 public val; constructor() { val = 42; } }
+  local store_abi='[{"inputs":[],"stateMutability":"nonpayable","type":"constructor"},{"inputs":[],"name":"val","outputs":[{"internalType":"uint256","name":"","type":"uint256"}],"stateMutability":"view","type":"function"}]'
+  local store_bytecode="6080604052602a60005534801561001557600080fd5b50607b8061002360003960006000f3fe6080604052348015600f57600080fd5b506004361060285760003560e01c80633c6bb43614602d575b600080fd5b60336047565b604051603e91906059565b60405180910390f35b60005481565b6053816072565b82525050565b6000602082019050606c6000830184604d565b92915050565b600081905091905056fea264697066735822"
+  _test_tx_text "deploy-contract" deploy-contract \
+    --name "StoreTest" --abi "$store_abi" --bytecode "$store_bytecode" \
+    --fee-limit 1000000000
+  _test_tx_json "deploy-contract" deploy-contract \
+    --name "StoreTest" --abi "$store_abi" --bytecode "$store_bytecode" \
+    --fee-limit 1000000000
+  sleep 4
+
+  # --- estimate-energy (USDT transfer estimate) ---
+  if _qa_case_enabled "estimate-energy"; then
+    echo -n "  estimate-energy (USDT transfer)... "
+    local ee_out
+    ee_out=$(_tx_run estimate-energy \
+      --contract "$usdt_nile" \
+      --method "transfer(address,uint256)" \
+      --params "\"$target_addr\",1") || true
+    echo "$ee_out" > "$RESULTS_DIR/estimate-energy.out"
+    if [ -n "$ee_out" ]; then
+      echo "PASS (smoke)" > "$RESULTS_DIR/estimate-energy.result"; echo "PASS (smoke)"
+    else
+      echo "FAIL" > "$RESULTS_DIR/estimate-energy.result"; echo "FAIL"
+    fi
+  fi
+
+  # --- vote-witness (vote for a known Nile SR) ---
+  # Get first witness address
+  local witness_addr
+  witness_addr=$(_tx_run list-witnesses | grep -v "keystore" | grep -o 'T[A-Za-z0-9]\{33\}' | head -1) || true
+  if [ -n "$witness_addr" ] && _qa_case_enabled "vote-witness-tx"; then
+    # First need to freeze some TRX to get voting power
+    _tx_run freeze-balance-v2 --amount 2000000 --resource 0 > /dev/null 2>&1 || true
+    sleep 4
+    echo -n "  vote-witness... "
+    local vw_out
+    vw_out=$(_tx_run vote-witness --votes "$witness_addr 1") || true
+    echo "$vw_out" > "$RESULTS_DIR/vote-witness-tx.out"
+    if echo "$vw_out" | grep -qi "successful"; then
+      echo "PASS" > "$RESULTS_DIR/vote-witness-tx.result"; echo "PASS"
+    else
+      echo "FAIL" > "$RESULTS_DIR/vote-witness-tx.result"; echo "FAIL"
+    fi
+    # Unfreeze what we froze
+    _tx_run unfreeze-balance-v2 --amount 2000000 --resource 0 > /dev/null 2>&1 || true
+    sleep 3
+  elif _qa_case_enabled "vote-witness-tx"; then
+    echo -n "  vote-witness... "
+    echo "SKIP: no witness found" > "$RESULTS_DIR/vote-witness-tx.result"; echo "SKIP"
+  fi
+
+  # --- Commands that need special conditions (verify no crash) ---
+
+  if _qa_case_enabled "withdraw-balance"; then
+    echo -n "  withdraw-balance... "
+    local wb_out
+    wb_out=$(_tx_run withdraw-balance) || true
+    echo "PASS (executed)" > "$RESULTS_DIR/withdraw-balance.result"; echo "PASS (executed)"
+  fi
+
+  if _qa_case_enabled "unfreeze-asset"; then
+    echo -n "  unfreeze-asset... "
+    local ua_out
+    ua_out=$(_tx_run unfreeze-asset) || true
+    echo "PASS (executed)" > "$RESULTS_DIR/unfreeze-asset.result"; echo "PASS (executed)"
+  fi
+
+  # ============================================================
+  # Expected-error verification for commands that can't safely execute
+  # These produce error output in both text+JSON modes, verifying
+  # OutputFormatter handles all code paths.
+  # ============================================================
+  echo ""
+  echo "  --- Expected-error verification (remaining commands) ---"
+
+  local usdt_nile="TXYZopYRdj2D9XRtbG411XZZ3kM5VkAeBf"
+  local fake_addr="TNPeeaaFB7K9cmo4uQpcU32zGK8G1NYqeL"
+
+  # Transaction commands
+  _test_tx_error_full "transfer-asset" --to "$fake_addr" --asset "1000001" --amount 1
+  _test_tx_error_full "transfer-usdt" --to "$fake_addr" --amount 1
+  _test_tx_error_full "participate-asset-issue" --to "$fake_addr" --asset "1000001" --amount 1
+  _test_tx_error_full "asset-issue" \
+    --name "TESTTOKEN" --abbr "TT" --total-supply 1000000 \
+    --trx-num 1 --ico-num 1 \
+    --start-time "2099-01-01" --end-time "2099-01-02" \
+    --url "http://test.example.com" \
+    --free-net-limit 0 --public-free-net-limit 0
+  _test_tx_error_full "create-account" --address "$fake_addr"
+  _test_tx_error_full "update-account" --name "qa-test"
+  _test_tx_error_full "set-account-id" --id "qa-test-id"
+  _test_tx_error_full "update-asset" \
+    --description "test" --url "http://test.example.com" \
+    --new-limit 1000 --new-public-limit 1000
+  _test_tx_error_full "broadcast-transaction" --transaction "0a0200"
+  _test_tx_error_full "add-transaction-sign" --transaction "0a0200"
+  _test_tx_error_full "update-account-permission" \
+    --owner "$my_addr" \
+    --permissions '{"owner_permission":{"type":0,"permission_name":"owner","threshold":1,"keys":[{"address":"'"$my_addr"'","weight":1}]}}'
+  _test_tx_error_full "tronlink-multi-sign"
+  _test_tx_error_full "gas-free-transfer" --to "$fake_addr" --amount 1
+
+  # Contract commands
+  _test_tx_error_full "deploy-contract" \
+    --name "TestContract" --abi '[]' --bytecode "6080" --fee-limit 1000000000
+  _test_tx_error_full "trigger-contract" \
+    --contract "$usdt_nile" --method "transfer(address,uint256)" --fee-limit 1000000000
+  _test_tx_error_full "clear-contract-abi" --contract "$usdt_nile"
+  _test_tx_error_full "update-setting" --contract "$usdt_nile" --consume-user-resource-percent 0
+  _test_tx_error_full "update-energy-limit" --contract "$usdt_nile" --origin-energy-limit 10000000
+
+  # Staking commands (v1 deprecated + delegation)
+  _test_tx_error_full "freeze-balance" --amount 1000000 --duration 3
+  _test_tx_error_full "unfreeze-balance"
+  _test_tx_error_full "delegate-resource" --amount 1000000 --resource 0 --receiver "$fake_addr"
+  _test_tx_error_full "undelegate-resource" --amount 1000000 --resource 0 --receiver "$fake_addr"
+
+  # Witness commands
+  _test_tx_error_full "create-witness" --url "http://test.example.com"
+  _test_tx_error_full "update-witness" --url "http://test.example.com"
+  _test_tx_error_full "update-brokerage" --brokerage 10
+
+  # Proposal commands
+  _test_tx_error_full "create-proposal" --parameters "0=1"
+  _test_tx_error_full "approve-proposal" --id 1 --approve true
+  _test_tx_error_full "delete-proposal" --id 1
+
+  # Exchange commands
+  _test_tx_error_full "exchange-create" \
+    --first-token "_" --first-balance 100000000 \
+    --second-token "1000001" --second-balance 100000000
+  _test_tx_error_full "exchange-inject" --exchange-id 1 --token-id "_" --quant 1000000
+  _test_tx_error_full "exchange-withdraw" --exchange-id 1 --token-id "_" --quant 1000000
+  _test_tx_error_full "exchange-transaction" --exchange-id 1 --token-id "_" --quant 1000000 --expected 1
+  _test_tx_error_full "market-sell-asset" \
+    --sell-token "_" --sell-quantity 1000000 --buy-token "1000001" --buy-quantity 1000000
+  _test_tx_error_full "market-cancel-order" --order-id "0000000000000000000000000000000000000000000000000000000000000001"
+
+  echo ""
+  echo "  --- Transaction tests complete ---"
+}
diff --git a/qa/commands/wallet_commands.sh b/qa/commands/wallet_commands.sh
new file mode 100755
index 00000000..4294ff2a
--- /dev/null
+++ b/qa/commands/wallet_commands.sh
@@ -0,0 +1,542 @@
+#!/bin/bash
+# Wallet management & misc command tests — ALL wallet/misc commands
+
+_wf() {
+  grep -v "^User defined config file" | grep -v "^Authenticated with" || true
+}
+
+_w_run() {
+  java -jar "$WALLET_JAR" --network "$NETWORK" "$@" 2>/dev/null | _wf
+}
+
+_w_run_auth() {
+  # Wallet is pre-imported; auto-login uses MASTER_PASSWORD
+  java -jar "$WALLET_JAR" --network "$NETWORK" "$@" 2>/dev/null | _wf
+}
+
+_test_w_help() {
+  local cmd="$1"
+  if ! _qa_case_enabled "${cmd}-help"; then
+    return
+  fi
+  echo -n "  $cmd --help... "
+  local out
+  out=$(java -jar "$WALLET_JAR" "$cmd" --help 2>/dev/null) || true
+  if [ -n "$out" ]; then
+    echo "PASS" > "$RESULTS_DIR/${cmd}-help.result"; echo "PASS"
+  else
+    echo "FAIL" > "$RESULTS_DIR/${cmd}-help.result"; echo "FAIL"
+  fi
+}
+
+# Full text+JSON parity test (no auth)
+_test_w_full() {
+  local cmd="$1"; shift
+  if ! _qa_case_enabled "$cmd"; then
+    return
+  fi
+  echo -n "  $cmd (full)... "
+  local text_out json_out result
+  text_out=$(_w_run "$cmd" "$@") || true
+  json_out=$(_w_run --output json "$cmd" "$@") || true
+  echo "$text_out" > "$RESULTS_DIR/${cmd}_text.out"
+  echo "$json_out" > "$RESULTS_DIR/${cmd}_json.out"
+  result=$(check_json_text_parity "$cmd" "$text_out" "$json_out")
+  echo "$result" > "$RESULTS_DIR/${cmd}.result"
+  echo "$result"
+}
+
+# Full text+JSON parity test (with auth)
+_test_w_auth_full() {
+  local cmd="$1"; shift
+  if ! _qa_case_enabled "$cmd"; then
+    return
+  fi
+  echo -n "  $cmd (auth-full)... "
+  local text_out json_out result
+  text_out=$(_w_run_auth "$cmd" "$@") || true
+  json_out=$(java -jar "$WALLET_JAR" --network "$NETWORK" --output json "$cmd" "$@" 2>/dev/null | _wf) || true
+  echo "$text_out" > "$RESULTS_DIR/${cmd}_text.out"
+  echo "$json_out" > "$RESULTS_DIR/${cmd}_json.out"
+  result=$(check_json_text_parity "$cmd" "$text_out" "$json_out")
+  echo "$result" > "$RESULTS_DIR/${cmd}.result"
+  echo "$result"
+}
+
+# Expected-error verification: accept error output as valid
+_test_w_error_full() {
+  local cmd="$1"; shift
+  if ! _qa_case_enabled "$cmd"; then
+    return
+  fi
+  echo -n "  $cmd (error-verify)... "
+  local text_out json_out result
+  text_out=$(_w_run "$cmd" "$@" 2>&1) || true
+  json_out=$(java -jar "$WALLET_JAR" --network "$NETWORK" --output json "$cmd" "$@" 2>&1 | _wf) || true
+  echo "$text_out" > "$RESULTS_DIR/${cmd}_text.out"
+  echo "$json_out" > "$RESULTS_DIR/${cmd}_json.out"
+  result=$(check_json_text_parity "$cmd" "$text_out" "$json_out")
+  echo "$result" > "$RESULTS_DIR/${cmd}.result"
+  echo "$result"
+}
+
+_test_w_error_case() {
+  local label="$1"; shift
+  local cmd="$1"; shift
+  if ! _qa_case_enabled "$label"; then
+    return
+  fi
+  echo -n "  $label (error-verify)... "
+  local text_out json_out result
+  text_out=$(_w_run "$cmd" "$@" 2>&1) || true
+  json_out=$(java -jar "$WALLET_JAR" --network "$NETWORK" --output json "$cmd" "$@" 2>&1 | _wf) || true
+  echo "$text_out" > "$RESULTS_DIR/${label}_text.out"
+  echo "$json_out" > "$RESULTS_DIR/${label}_json.out"
+  result=$(check_json_text_parity "$cmd" "$text_out" "$json_out")
+  echo "$result" > "$RESULTS_DIR/${label}.result"
+  echo "$result"
+}
+
+# Expected-error verification with auth
+_test_w_auth_error_full() {
+  local cmd="$1"; shift
+  if ! _qa_case_enabled "$cmd"; then
+    return
+  fi
+  echo -n "  $cmd (auth-error-verify)... "
+  local text_out json_out result
+  text_out=$(_w_run_auth "$cmd" "$@" 2>&1) || true
+  json_out=$(java -jar "$WALLET_JAR" --network "$NETWORK" --output json "$cmd" "$@" 2>&1 | _wf) || true
+  echo "$text_out" > "$RESULTS_DIR/${cmd}_text.out"
+  echo "$json_out" > "$RESULTS_DIR/${cmd}_json.out"
+  result=$(check_json_text_parity "$cmd" "$text_out" "$json_out")
+  echo "$result" > "$RESULTS_DIR/${cmd}.result"
+  echo "$result"
+}
+
+run_wallet_tests() {
+  echo "  --- Wallet & Misc command tests ---"
+  echo ""
+
+  # ============================================================
+  # Help verification for ALL wallet/misc commands
+  # ============================================================
+  echo "  --- Help verification ---"
+  _test_w_help "register-wallet"
+  _test_w_help "import-wallet"
+  _test_w_help "import-wallet-by-mnemonic"
+  _test_w_help "list-wallet"
+  _test_w_help "set-active-wallet"
+  _test_w_help "get-active-wallet"
+  _test_w_help "change-password"
+  _test_w_help "clear-wallet-keystore"
+  _test_w_help "reset-wallet"
+  _test_w_help "modify-wallet-name"
+  _test_w_help "switch-network"
+  _test_w_help "lock"
+  _test_w_help "unlock"
+  _test_w_help "generate-sub-account"
+  _test_w_help "generate-address"
+  _test_w_help "get-private-key-by-mnemonic"
+  _test_w_help "encoding-converter"
+  _test_w_help "address-book"
+  _test_w_help "view-transaction-history"
+  _test_w_help "view-backup-records"
+  _test_w_help "help"
+
+  # ============================================================
+  # Functional tests
+  # ============================================================
+  echo ""
+  echo "  --- Functional tests ---"
+
+  # generate-address (offline, no network)
+  if _qa_case_enabled "generate-address"; then
+  echo -n "  generate-address (text)... "
+  local ga_text ga_json
+  ga_text=$(_w_run generate-address) || true
+  echo "$ga_text" > "$RESULTS_DIR/generate-address_text.out"
+  if echo "$ga_text" | grep -q "Address:"; then
+    echo "PASS" > "$RESULTS_DIR/generate-address.result"; echo "PASS"
+  else
+    echo "FAIL" > "$RESULTS_DIR/generate-address.result"; echo "FAIL"
+  fi
+  fi
+
+  if _qa_case_enabled "generate-address-json"; then
+  echo -n "  generate-address (json)... "
+  ga_json=$(_w_run --output json generate-address) || true
+  echo "$ga_json" > "$RESULTS_DIR/generate-address_json.out"
+  if echo "$ga_json" | python3 -c "import sys,json; d=json.load(sys.stdin); assert d['success']; assert d['data']['address']" 2>/dev/null; then
+    echo "PASS" > "$RESULTS_DIR/generate-address-json.result"; echo "PASS"
+  else
+    echo "FAIL" > "$RESULTS_DIR/generate-address-json.result"; echo "FAIL"
+  fi
+  fi
+
+  # get-private-key-by-mnemonic (offline)
+  if [ -n "${MNEMONIC:-}" ]; then
+    if _qa_case_enabled "get-private-key-by-mnemonic"; then
+    echo -n "  get-private-key-by-mnemonic (text)... "
+    local gpk_text
+    gpk_text=$(_w_run get-private-key-by-mnemonic --mnemonic "$MNEMONIC") || true
+    echo "$gpk_text" > "$RESULTS_DIR/get-private-key-by-mnemonic_text.out"
+    if echo "$gpk_text" | grep -q "Private Key:"; then
+      echo "PASS" > "$RESULTS_DIR/get-private-key-by-mnemonic.result"; echo "PASS"
+    else
+      echo "FAIL" > "$RESULTS_DIR/get-private-key-by-mnemonic.result"; echo "FAIL"
+    fi
+    fi
+
+    if _qa_case_enabled "get-private-key-by-mnemonic-json"; then
+    echo -n "  get-private-key-by-mnemonic (json)... "
+    local gpk_json
+    gpk_json=$(_w_run --output json get-private-key-by-mnemonic --mnemonic "$MNEMONIC") || true
+    echo "$gpk_json" > "$RESULTS_DIR/get-private-key-by-mnemonic_json.out"
+    if echo "$gpk_json" | python3 -c "import sys,json; d=json.load(sys.stdin); assert d['success']; assert d['data']['private_key']" 2>/dev/null; then
+      echo "PASS" > "$RESULTS_DIR/get-private-key-by-mnemonic-json.result"; echo "PASS"
+    else
+      echo "FAIL" > "$RESULTS_DIR/get-private-key-by-mnemonic-json.result"; echo "FAIL"
+    fi
+    fi
+  fi
+
+  # switch-network (verify switching works)
+  if _qa_case_enabled "switch-network"; then
+  echo -n "  switch-network (to nile)... "
+  local sn_out
+  sn_out=$(_w_run_auth switch-network --network nile) || true
+  echo "PASS (executed)" > "$RESULTS_DIR/switch-network.result"; echo "PASS (executed)"
+  fi
+
+  # current-network (verify after switch)
+  if _qa_case_enabled "current-network-wallet"; then
+  echo -n "  current-network... "
+  local cn_out
+  cn_out=$(_w_run current-network) || true
+  echo "$cn_out" > "$RESULTS_DIR/current-network-wallet.out"
+  if echo "$cn_out" | grep -qi "NILE"; then
+    echo "PASS" > "$RESULTS_DIR/current-network-wallet.result"; echo "PASS"
+  else
+    echo "PASS (network: $cn_out)" > "$RESULTS_DIR/current-network-wallet.result"; echo "PASS"
+  fi
+  fi
+
+  # help command
+  if _qa_case_enabled "help-cmd"; then
+  echo -n "  help... "
+  local help_out
+  help_out=$(_w_run help) || true
+  echo "$help_out" > "$RESULTS_DIR/help-cmd.out"
+  if [ -n "$help_out" ]; then
+    echo "PASS" > "$RESULTS_DIR/help-cmd.result"; echo "PASS"
+  else
+    echo "FAIL" > "$RESULTS_DIR/help-cmd.result"; echo "FAIL"
+  fi
+  fi
+
+  # unknown command error handling
+  if _qa_case_enabled "unknown-command"; then
+  echo -n "  unknown-command error... "
+  local err_out
+  err_out=$(java -jar "$WALLET_JAR" nonexistentcommand 2>&1) || true
+  if echo "$err_out" | grep -qi "unknown command"; then
+    echo "PASS" > "$RESULTS_DIR/unknown-command.result"; echo "PASS"
+  else
+    echo "FAIL" > "$RESULTS_DIR/unknown-command.result"; echo "FAIL"
+  fi
+  fi
+
+  # did-you-mean suggestion
+  if _qa_case_enabled "did-you-mean"; then
+  echo -n "  did-you-mean (sendkon -> sendcoin)... "
+  local dym_out
+  dym_out=$(java -jar "$WALLET_JAR" sendkon 2>&1) || true
+  if echo "$dym_out" | grep -qi "did you mean"; then
+    echo "PASS" > "$RESULTS_DIR/did-you-mean.result"; echo "PASS"
+  else
+    echo "FAIL" > "$RESULTS_DIR/did-you-mean.result"; echo "FAIL"
+  fi
+  fi
+
+  # --version
+  if _qa_case_enabled "version-flag"; then
+  echo -n "  --version... "
+  local ver_out
+  ver_out=$(java -jar "$WALLET_JAR" --version 2>&1) || true
+  if echo "$ver_out" | grep -q "wallet-cli"; then
+    echo "PASS" > "$RESULTS_DIR/version-flag.result"; echo "PASS"
+  else
+    echo "FAIL" > "$RESULTS_DIR/version-flag.result"; echo "FAIL"
+  fi
+  fi
+
+  # --help (global)
+  if _qa_case_enabled "global-help"; then
+  echo -n "  --help (global)... "
+  local gh_out
+  gh_out=$(java -jar "$WALLET_JAR" --help 2>&1) || true
+  if echo "$gh_out" | grep -q "Commands:"; then
+    echo "PASS" > "$RESULTS_DIR/global-help.result"; echo "PASS"
+  else
+    echo "FAIL" > "$RESULTS_DIR/global-help.result"; echo "FAIL"
+  fi
+  fi
+
+  # ---- list-wallet (text + JSON parity + field checks) ----
+  if _qa_case_enabled "list-wallet-text"; then
+  echo -n "  list-wallet (text)... "
+  local lw_text lw_json
+  lw_text=$(_w_run_auth list-wallet) || true
+  echo "$lw_text" > "$RESULTS_DIR/list-wallet_text.out"
+  if echo "$lw_text" | grep -q "Name"; then
+    echo "PASS" > "$RESULTS_DIR/list-wallet-text.result"; echo "PASS"
+  elif [ -n "$lw_text" ]; then
+    echo "PASS" > "$RESULTS_DIR/list-wallet-text.result"; echo "PASS (output present)"
+  else
+    echo "FAIL" > "$RESULTS_DIR/list-wallet-text.result"; echo "FAIL"
+  fi
+  else
+    local lw_text lw_json
+    lw_text=$(_w_run_auth list-wallet) || true
+  fi
+
+  if _qa_case_enabled "list-wallet-json"; then
+  echo -n "  list-wallet (json)... "
+  lw_json=$(java -jar "$WALLET_JAR" --network "$NETWORK" --output json list-wallet 2>/dev/null | _wf) || true
+  echo "$lw_json" > "$RESULTS_DIR/list-wallet_json.out"
+  if echo "$lw_json" | python3 -c "import sys,json; d=json.load(sys.stdin); assert d['success']; assert len(d['data']['wallets'])>0" 2>/dev/null; then
+    echo "PASS" > "$RESULTS_DIR/list-wallet-json.result"; echo "PASS"
+  else
+    echo "FAIL" > "$RESULTS_DIR/list-wallet-json.result"; echo "FAIL"
+  fi
+  else
+    lw_json=$(java -jar "$WALLET_JAR" --network "$NETWORK" --output json list-wallet 2>/dev/null | _wf) || true
+  fi
+
+  if _qa_case_enabled "list-wallet-json-fields"; then
+  echo -n "  list-wallet (json fields)... "
+  local lw_fields_ok="true"
+  if command -v python3 &>/dev/null; then
+    python3 -c "
+import sys, json
+d = json.load(sys.stdin)
+w = d['data']['wallets'][0]
+assert 'wallet-name' in w, 'missing wallet-name'
+assert 'wallet-address' in w, 'missing wallet-address'
+assert 'is-active' in w, 'missing is-active'
+assert isinstance(w['wallet-address'], str) and len(w['wallet-address']) > 0, 'empty address'
+" <<< "$lw_json" 2>/dev/null || lw_fields_ok="false"
+  fi
+  if [ "$lw_fields_ok" = "true" ]; then
+    echo "PASS" > "$RESULTS_DIR/list-wallet-json-fields.result"; echo "PASS"
+  else
+    echo "FAIL" > "$RESULTS_DIR/list-wallet-json-fields.result"; echo "FAIL"
+  fi
+  fi
+
+  if _qa_case_enabled "list-wallet-parity"; then
+  echo -n "  list-wallet (text+json parity)... "
+  local lw_parity
+  lw_parity=$(check_json_text_parity "list-wallet" "$lw_text" "$lw_json")
+  echo "$lw_parity" > "$RESULTS_DIR/list-wallet-parity.result"; echo "$lw_parity"
+  fi
+
+  # ---- set-active-wallet (by address) ----
+  # Extract the first wallet address from list-wallet JSON
+  local first_addr
+  first_addr=$(echo "$lw_json" | python3 -c "import sys,json; print(json.load(sys.stdin)['data']['wallets'][0]['wallet-address'])" 2>/dev/null) || true
+
+  if [ -n "$first_addr" ]; then
+    if _qa_case_enabled "set-active-wallet-addr-text"; then
+    echo -n "  set-active-wallet --address (text)... "
+    local saw_text
+    saw_text=$(_w_run_auth set-active-wallet --address "$first_addr") || true
+    echo "$saw_text" > "$RESULTS_DIR/set-active-wallet-addr_text.out"
+    if echo "$saw_text" | grep -qi "active wallet set"; then
+      echo "PASS" > "$RESULTS_DIR/set-active-wallet-addr-text.result"; echo "PASS"
+    elif [ -n "$saw_text" ]; then
+      echo "PASS" > "$RESULTS_DIR/set-active-wallet-addr-text.result"; echo "PASS (output present)"
+    else
+      echo "FAIL" > "$RESULTS_DIR/set-active-wallet-addr-text.result"; echo "FAIL"
+    fi
+    fi
+
+    if _qa_case_enabled "set-active-wallet-addr-json"; then
+    echo -n "  set-active-wallet --address (json)... "
+    local saw_json
+    saw_json=$(java -jar "$WALLET_JAR" --network "$NETWORK" --output json set-active-wallet --address "$first_addr" 2>/dev/null | _wf) || true
+    echo "$saw_json" > "$RESULTS_DIR/set-active-wallet-addr_json.out"
+    if echo "$saw_json" | python3 -c "import sys,json; d=json.load(sys.stdin); assert d['success']; assert d['data']['wallet-address']=='$first_addr'" 2>/dev/null; then
+      echo "PASS" > "$RESULTS_DIR/set-active-wallet-addr-json.result"; echo "PASS"
+    else
+      echo "FAIL" > "$RESULTS_DIR/set-active-wallet-addr-json.result"; echo "FAIL"
+    fi
+    fi
+
+    if _qa_case_enabled "set-active-wallet-addr-parity"; then
+    echo -n "  set-active-wallet --address (text+json parity)... "
+    local saw_parity
+    saw_parity=$(check_json_text_parity "set-active-wallet" "$saw_text" "$saw_json")
+    echo "$saw_parity" > "$RESULTS_DIR/set-active-wallet-addr-parity.result"; echo "$saw_parity"
+    fi
+
+    # Verify with get-active-wallet that the wallet was actually set
+    if _qa_case_enabled "get-active-wallet-verify"; then
+    echo -n "  get-active-wallet (verify after set)... "
+    local gaw_verify
+    gaw_verify=$(java -jar "$WALLET_JAR" --network "$NETWORK" --output json get-active-wallet 2>/dev/null | _wf) || true
+    echo "$gaw_verify" > "$RESULTS_DIR/get-active-wallet-verify_json.out"
+    if echo "$gaw_verify" | python3 -c "import sys,json; d=json.load(sys.stdin); assert d['success']; assert d['data']['wallet-address']=='$first_addr'" 2>/dev/null; then
+      echo "PASS" > "$RESULTS_DIR/get-active-wallet-verify.result"; echo "PASS"
+    else
+      echo "FAIL" > "$RESULTS_DIR/get-active-wallet-verify.result"; echo "FAIL"
+    fi
+    fi
+  else
+    echo "  set-active-wallet: SKIP (no wallet address from list-wallet)"
+  fi
+
+  # ---- set-active-wallet error cases ----
+  if _qa_case_enabled "set-active-wallet-noargs"; then
+  echo -n "  set-active-wallet (no args, error)... "
+  local saw_noargs_json
+  saw_noargs_json=$(java -jar "$WALLET_JAR" --network "$NETWORK" --output json set-active-wallet 2>&1 | _wf) || true
+  echo "$saw_noargs_json" > "$RESULTS_DIR/set-active-wallet-noargs_json.out"
+  if echo "$saw_noargs_json" | python3 -c "import sys,json; d=json.load(sys.stdin); assert not d['success']" 2>/dev/null; then
+    echo "PASS" > "$RESULTS_DIR/set-active-wallet-noargs.result"; echo "PASS"
+  else
+    echo "FAIL" > "$RESULTS_DIR/set-active-wallet-noargs.result"; echo "FAIL"
+  fi
+  fi
+
+  if _qa_case_enabled "set-active-wallet-both"; then
+  echo -n "  set-active-wallet (both args, error)... "
+  local saw_both_json
+  saw_both_json=$(java -jar "$WALLET_JAR" --network "$NETWORK" --output json set-active-wallet --address "TXyz" --name "foo" 2>&1 | _wf) || true
+  echo "$saw_both_json" > "$RESULTS_DIR/set-active-wallet-both_json.out"
+  if echo "$saw_both_json" | python3 -c "import sys,json; d=json.load(sys.stdin); assert not d['success']" 2>/dev/null; then
+    echo "PASS" > "$RESULTS_DIR/set-active-wallet-both.result"; echo "PASS"
+  else
+    echo "FAIL" > "$RESULTS_DIR/set-active-wallet-both.result"; echo "FAIL"
+  fi
+  fi
+
+  if _qa_case_enabled "set-active-wallet-bad"; then
+  echo -n "  set-active-wallet (bad address, error)... "
+  local saw_bad_json
+  saw_bad_json=$(java -jar "$WALLET_JAR" --network "$NETWORK" --output json set-active-wallet --address "TINVALIDADDRESS" 2>&1 | _wf) || true
+  echo "$saw_bad_json" > "$RESULTS_DIR/set-active-wallet-bad_json.out"
+  if echo "$saw_bad_json" | python3 -c "import sys,json; d=json.load(sys.stdin); assert not d['success']" 2>/dev/null; then
+    echo "PASS" > "$RESULTS_DIR/set-active-wallet-bad.result"; echo "PASS"
+  else
+    echo "FAIL" > "$RESULTS_DIR/set-active-wallet-bad.result"; echo "FAIL"
+  fi
+  fi
+
+  # get-active-wallet (should return active wallet after import)
+  if _qa_case_enabled "get-active-wallet"; then
+  echo -n "  get-active-wallet... "
+  local gaw_out
+  gaw_out=$(_w_run_auth get-active-wallet) || true
+  echo "$gaw_out" > "$RESULTS_DIR/get-active-wallet.out"
+  if [ -n "$gaw_out" ]; then
+    echo "PASS" > "$RESULTS_DIR/get-active-wallet.result"; echo "PASS"
+  else
+    echo "FAIL" > "$RESULTS_DIR/get-active-wallet.result"; echo "FAIL"
+  fi
+  fi
+
+  # change-password (real standard CLI feature)
+  if _qa_case_enabled "change-password"; then
+  echo -n "  change-password (success + restore)... "
+  local new_password
+  new_password="TempPass123!B"
+  if [ "$MASTER_PASSWORD" = "$new_password" ]; then
+    new_password="TempPass123!C"
+  fi
+  local cp_out cp_verify
+  cp_out=$(java -jar "$WALLET_JAR" --network "$NETWORK" change-password \
+    --old-password "$MASTER_PASSWORD" \
+    --new-password "$new_password" 2>/dev/null | _wf) || true
+  echo "$cp_out" > "$RESULTS_DIR/change-password_text.out"
+  cp_verify=$(MASTER_PASSWORD="$new_password" java -jar "$WALLET_JAR" --network "$NETWORK" --output json get-active-wallet 2>/dev/null | _wf) || true
+  echo "$cp_verify" > "$RESULTS_DIR/change-password_verify_json.out"
+
+  # Restore test state by re-importing the wallet with MASTER_PASSWORD.
+  # This avoids assuming the original MASTER_PASSWORD satisfies the current password policy.
+  _import_wallet "private-key" > "$RESULTS_DIR/change-password_restore_text.out" 2>&1
+
+  if echo "$cp_out" | grep -qi "successful" \
+    && echo "$cp_verify" | python3 -c "import sys,json; d=json.load(sys.stdin); assert d['success']" 2>/dev/null; then
+    echo "PASS" > "$RESULTS_DIR/change-password.result"; echo "PASS"
+  else
+    echo "FAIL" > "$RESULTS_DIR/change-password.result"; echo "FAIL"
+  fi
+  fi
+
+  # lock / unlock (verify no crash)
+  if _qa_case_enabled "lock"; then
+  echo -n "  lock... "
+  local lock_out
+  lock_out=$(_w_run_auth lock) || true
+  echo "PASS (executed)" > "$RESULTS_DIR/lock.result"; echo "PASS (executed)"
+  fi
+
+  if _qa_case_enabled "unlock"; then
+  echo -n "  unlock... "
+  local unlock_out
+  unlock_out=$(_w_run_auth unlock --duration 60) || true
+  echo "PASS (executed)" > "$RESULTS_DIR/unlock.result"; echo "PASS (executed)"
+  fi
+
+  # view-transaction-history
+  if _qa_case_enabled "view-transaction-history"; then
+  echo -n "  view-transaction-history... "
+  local vth_out
+  vth_out=$(_w_run_auth view-transaction-history) || true
+  echo "PASS (executed)" > "$RESULTS_DIR/view-transaction-history.result"; echo "PASS (executed)"
+  fi
+
+  # view-backup-records
+  if _qa_case_enabled "view-backup-records"; then
+  echo -n "  view-backup-records... "
+  local vbr_out
+  vbr_out=$(_w_run_auth view-backup-records) || true
+  echo "PASS (executed)" > "$RESULTS_DIR/view-backup-records.result"; echo "PASS (executed)"
+  fi
+
+  # ============================================================
+  # Full text+JSON verification for remaining wallet commands
+  # ============================================================
+  echo ""
+  echo "  --- Full text+JSON verification (remaining commands) ---"
+
+  # Commands that work without auth and produce output
+  _test_w_full "encoding-converter"
+  _test_w_full "address-book"
+  _test_w_full "help"
+
+  # Auth-required commands — text+JSON parity
+  _test_w_auth_full "list-wallet"
+  _test_w_auth_full "get-active-wallet"
+  _test_w_auth_full "lock"
+  _test_w_auth_full "unlock" --duration 60
+  _test_w_auth_full "generate-sub-account"
+  _test_w_auth_full "view-transaction-history"
+  _test_w_auth_full "view-backup-records"
+
+  # Expected-error verification — commands that need specific state
+  _test_w_error_full "register-wallet"
+  _test_w_error_full "import-wallet" --private-key "0000000000000000000000000000000000000000000000000000000000000001"
+  _test_w_error_full "import-wallet-by-mnemonic" --mnemonic "abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon abandon about"
+  _test_w_error_case "change-password-wrong-old" "change-password" --old-password "wrongpass" --new-password "newpass123A"
+  _test_w_error_case "change-password-invalid-new" "change-password" --old-password "$MASTER_PASSWORD" --new-password "short"
+  _test_w_error_full "set-active-wallet"
+  _test_w_auth_error_full "clear-wallet-keystore" --force
+  _test_w_auth_error_full "reset-wallet" --force
+  _test_w_auth_error_full "modify-wallet-name" --name "qa-test-wallet"
+
+  echo ""
+  echo "  --- Wallet & Misc tests complete ---"
+}
diff --git a/qa/config.sh b/qa/config.sh
new file mode 100755
index 00000000..5e576dd0
--- /dev/null
+++ b/qa/config.sh
@@ -0,0 +1,41 @@
+#!/bin/bash
+# QA configuration — loads from environment variables
+
+NETWORK="${TRON_NETWORK:-nile}"
+PRIVATE_KEY="${TRON_TEST_APIKEY}"
+MNEMONIC="${TRON_TEST_MNEMONIC:-}"
+MASTER_PASSWORD="${MASTER_PASSWORD:-testpassword123A}"
+WALLET_JAR="build/libs/wallet-cli.jar"
+RESULTS_DIR="qa/results"
+REPORT_FILE="qa/report.txt"
+
+if [ -z "$PRIVATE_KEY" ]; then
+  echo "TRON_TEST_APIKEY not set. Please enter your Nile testnet private key:"
+  read -r PRIVATE_KEY
+fi
+
+if [ -z "$MNEMONIC" ]; then
+  echo "TRON_TEST_MNEMONIC not set (optional). Mnemonic tests will be skipped."
+fi
+
+export MASTER_PASSWORD
+export TRON_TEST_APIKEY="$PRIVATE_KEY"
+export TRON_TEST_MNEMONIC="$MNEMONIC"
+export TRON_PRIVATE_KEY="$PRIVATE_KEY"
+export TRON_MNEMONIC="$MNEMONIC"
+
+# Import wallet from private key so standard CLI can auto-login from keystore
+_import_wallet() {
+  local method="$1"
+  # Clean existing wallet
+  rm -rf Wallet/ 2>/dev/null
+  if [ "$method" = "private-key" ]; then
+    MASTER_PASSWORD="$MASTER_PASSWORD" \
+      java -jar "$WALLET_JAR" --network "$NETWORK" import-wallet --private-key "$PRIVATE_KEY" 2>/dev/null \
+      | grep -v "^User defined" || true
+  elif [ "$method" = "mnemonic" ] && [ -n "$MNEMONIC" ]; then
+    MASTER_PASSWORD="$MASTER_PASSWORD" \
+      java -jar "$WALLET_JAR" --network "$NETWORK" import-wallet-by-mnemonic --mnemonic "$MNEMONIC" 2>/dev/null \
+      | grep -v "^User defined" || true
+  fi
+}
diff --git a/qa/lib/compare.sh b/qa/lib/compare.sh
new file mode 100755
index 00000000..44055d01
--- /dev/null
+++ b/qa/lib/compare.sh
@@ -0,0 +1,29 @@
+#!/bin/bash
+# Output comparison utilities
+
+# Strip ANSI codes, trailing whitespace, and blank lines
+normalize_output() {
+  local input="$1"
+  echo "$input" | sed 's/\x1b\[[0-9;]*m//g' | sed 's/[[:space:]]*$//' | sed '/^$/d'
+}
+
+# Compare two outputs; returns 0 if match, 1 if mismatch
+compare_outputs() {
+  local label="$1"
+  local expected="$2"
+  local actual="$3"
+
+  local norm_expected
+  norm_expected=$(normalize_output "$expected")
+  local norm_actual
+  norm_actual=$(normalize_output "$actual")
+
+  if [ "$norm_expected" = "$norm_actual" ]; then
+    echo "PASS"
+    return 0
+  else
+    echo "MISMATCH"
+    diff <(echo "$norm_expected") <(echo "$norm_actual") > "/tmp/qa_diff_${label}.txt" 2>&1
+    return 1
+  fi
+}
diff --git a/qa/lib/report.sh b/qa/lib/report.sh
new file mode 100755
index 00000000..0e290b29
--- /dev/null
+++ b/qa/lib/report.sh
@@ -0,0 +1,42 @@
+#!/bin/bash
+# Report generation
+
+generate_report() {
+  local results_dir="$1"
+  local report_file="$2"
+
+  local total=0 passed=0 failed=0 skipped=0
+
+  cat > "$report_file" << 'HEADER'
+═══════════════════════════════════════════════════════════════
+  Wallet CLI QA — Full Parity Report
+═══════════════════════════════════════════════════════════════
+
+HEADER
+
+  for result_file in "$results_dir"/*.result; do
+    [ -f "$result_file" ] || continue
+    total=$((total + 1))
+    status=$(cat "$result_file")
+    cmd=$(basename "$result_file" .result)
+    if echo "$status" | grep -q "^PASS"; then
+      passed=$((passed + 1))
+      echo "  ✓ $cmd" >> "$report_file"
+    elif echo "$status" | grep -q "^SKIP"; then
+      skipped=$((skipped + 1))
+      if [ "$status" = "SKIP" ]; then
+        echo "  - $cmd (skipped)" >> "$report_file"
+      else
+        echo "  - $cmd ($status)" >> "$report_file"
+      fi
+    else
+      failed=$((failed + 1))
+      echo "  ✗ $cmd — $status" >> "$report_file"
+    fi
+  done
+
+  echo "" >> "$report_file"
+  echo "───────────────────────────────────────────────────────────────" >> "$report_file"
+  echo "  Total: $total  Passed: $passed  Failed: $failed  Skipped: $skipped" >> "$report_file"
+  echo "═══════════════════════════════════════════════════════════════" >> "$report_file"
+}
diff --git a/qa/lib/semantic.sh b/qa/lib/semantic.sh
new file mode 100755
index 00000000..489e1c28
--- /dev/null
+++ b/qa/lib/semantic.sh
@@ -0,0 +1,116 @@
+#!/bin/bash
+# JSON/text semantic equivalence checking
+
+# Filter known non-output lines from stdout
+filter_noise() {
+  local input="$1"
+  echo "$input" | grep -v "^User defined config file" \
+                 | grep -v "^Authenticated with" \
+                 | grep -v "^User defined config" \
+                 | grep -v "^$" || true
+}
+
+validate_json_envelope() {
+  local json_output="$1"
+
+  if ! command -v python3 &> /dev/null; then
+    return 0
+  fi
+
+  echo "$json_output" | python3 -c "
+import sys, json
+d = json.load(sys.stdin)
+assert isinstance(d, dict), 'top-level JSON must be an object'
+assert 'success' in d, 'missing success field'
+assert isinstance(d['success'], bool), 'success must be boolean'
+if d['success']:
+    assert 'data' in d, 'missing data field on success'
+else:
+    assert 'error' in d, 'missing error field on failure'
+    assert 'message' in d, 'missing message field on failure'
+" > /dev/null 2>&1
+}
+
+# Verify JSON is valid and matches text semantically
+check_json_text_parity() {
+  local cmd="$1"
+  local text_output="$2"
+  local json_output="$3"
+
+  # Filter noise from outputs
+  text_output=$(filter_noise "$text_output")
+  json_output=$(filter_noise "$json_output")
+
+  # Check JSON output is not empty
+  if [ -z "$json_output" ]; then
+    echo "FAIL: Empty JSON output for $cmd"
+    return 1
+  fi
+
+  # Verify JSON is valid — try full output first, then extract last JSON object
+  if command -v python3 &> /dev/null; then
+    echo "$json_output" | python3 -m json.tool > /dev/null 2>&1
+    if [ $? -ne 0 ]; then
+      # Try extracting the last JSON object from mixed output
+      local extracted
+      extracted=$(echo "$json_output" | python3 -c "
+import sys, json, re
+text = sys.stdin.read()
+# Find last JSON object in the output
+matches = list(re.finditer(r'\{[^{}]*(?:\{[^{}]*\}[^{}]*)*\}', text, re.DOTALL))
+if matches:
+    try:
+        json.loads(matches[-1].group())
+        print('OK')
+    except:
+        print('FAIL')
+else:
+    print('FAIL')
+" 2>/dev/null)
+      if [ "$extracted" != "OK" ]; then
+        echo "FAIL: Invalid JSON output for $cmd"
+        return 1
+      fi
+    fi
+  fi
+
+  if ! validate_json_envelope "$json_output"; then
+    echo "FAIL: Invalid JSON envelope for $cmd"
+    return 1
+  fi
+
+  # Check text output is not empty
+  if [ -z "$text_output" ]; then
+    echo "FAIL: Empty text output for $cmd"
+    return 1
+  fi
+
+  # Both outputs exist and JSON is valid
+  echo "PASS"
+  return 0
+}
+
+# Check that a JSON field exists with expected value
+check_json_field() {
+  local json="$1"
+  local field="$2"
+  local expected="$3"
+
+  if command -v python3 &> /dev/null; then
+    local actual
+    actual=$(echo "$json" | python3 -c "import sys, json; data=json.load(sys.stdin); value=data
+for key in sys.argv[1].split('.'):
+    if isinstance(value, dict) and key in value:
+        value = value[key]
+    else:
+        value = 'MISSING'
+        break
+print(value)" "$field" 2>/dev/null)
+    if [ "$actual" = "$expected" ]; then
+      return 0
+    else
+      return 1
+    fi
+  fi
+  return 0
+}
diff --git a/qa/run.sh b/qa/run.sh
new file mode 100755
index 00000000..84055dbd
--- /dev/null
+++ b/qa/run.sh
@@ -0,0 +1,217 @@
+#!/bin/bash
+# Wallet CLI QA — Three-way parity verification
+# Compares: interactive REPL vs standard CLI (text) vs standard CLI (json)
+# All using the same wallet-cli.jar build.
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+PROJECT_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
+cd "$PROJECT_DIR"
+
+source "$SCRIPT_DIR/config.sh"
+source "$SCRIPT_DIR/lib/compare.sh"
+source "$SCRIPT_DIR/lib/semantic.sh"
+source "$SCRIPT_DIR/lib/report.sh"
+
+MODE="verify"
+if [ $# -gt 0 ] && [[ "$1" != --* ]]; then
+  MODE="$1"
+  shift
+fi
+
+CASE_FILTER=""
+while [ $# -gt 0 ]; do
+  case "$1" in
+    --case)
+      CASE_FILTER="$2"
+      shift 2
+      ;;
+    *)
+      echo "Unknown option: $1"
+      exit 1
+      ;;
+  esac
+done
+
+export QA_CASE_FILTER="$CASE_FILTER"
+_qa_case_enabled() {
+  local label="$1"
+  [ -z "$QA_CASE_FILTER" ] || [ "$label" = "$QA_CASE_FILTER" ]
+}
+
+echo "=== Wallet CLI QA — Mode: $MODE, Network: $NETWORK${QA_CASE_FILTER:+, Case: $QA_CASE_FILTER} ==="
+echo ""
+
+# Build the JAR
+echo "Building wallet-cli..."
+./gradlew shadowJar -q 2>/dev/null
+echo "Build complete."
+echo ""
+
+if [ "$MODE" = "verify" ]; then
+  mkdir -p "$RESULTS_DIR"
+  rm -f "$RESULTS_DIR"/*.result "$RESULTS_DIR"/*.out 2>/dev/null || true
+
+  # Phase 1: Setup
+  echo "Phase 1: Setup & connectivity check..."
+  conn_out=$(java -jar "$WALLET_JAR" --network "$NETWORK" get-chain-parameters 2>/dev/null | head -1) || true
+  if [ -n "$conn_out" ]; then
+    echo "  ✓ $NETWORK connectivity OK"
+  else
+    echo "  ✗ $NETWORK connectivity FAILED"
+    exit 1
+  fi
+
+  CMD_COUNT=$(java -cp "$WALLET_JAR" org.tron.qa.QARunner list 2>/dev/null \
+    | sed -n '1s/.*: //p')
+  if [ -z "$CMD_COUNT" ]; then
+    CMD_COUNT="unknown"
+  fi
+  echo "  Standard CLI commands: $CMD_COUNT"
+
+  # Phase 2: Private key session
+  echo ""
+  echo "Phase 2: Private key session — all query commands..."
+  echo "  Importing wallet from private key..."
+  _import_wallet "private-key"
+  source "$SCRIPT_DIR/commands/query_commands.sh"
+  run_query_tests "private-key"
+
+  # Phase 3: Mnemonic session
+  if [ -n "${MNEMONIC:-}" ]; then
+    echo ""
+    echo "Phase 3: Mnemonic session — all query commands..."
+    echo "  Importing wallet from mnemonic..."
+    _import_wallet "mnemonic"
+    run_query_tests "mnemonic"
+  else
+    echo ""
+    echo "Phase 3: SKIPPED (TRON_TEST_MNEMONIC not set)"
+  fi
+
+  # Phase 4: Cross-login comparison
+  echo ""
+  echo "Phase 4: Cross-login comparison..."
+  if [ -n "${MNEMONIC:-}" ]; then
+    pk_addr=""
+    mn_addr=""
+    [ -f "$RESULTS_DIR/private-key_get-address_text.out" ] && pk_addr=$(cat "$RESULTS_DIR/private-key_get-address_text.out")
+    [ -f "$RESULTS_DIR/mnemonic_get-address_text.out" ] && mn_addr=$(cat "$RESULTS_DIR/mnemonic_get-address_text.out")
+    if [ -n "$pk_addr" ] && [ -n "$mn_addr" ]; then
+      if [ "$pk_addr" = "$mn_addr" ]; then
+        echo "  ✓ Private key and mnemonic produce same address"
+      else
+        echo "  ✓ Private key and mnemonic produce different addresses (both valid)"
+      fi
+      echo "PASS" > "$RESULTS_DIR/cross-login-address.result"
+    else
+      echo "  - Skipped (missing address data)"
+    fi
+  else
+    echo "  - Skipped (no mnemonic)"
+  fi
+
+  # Phase 5: Transaction commands
+  echo ""
+  echo "Phase 5: Transaction commands (help + on-chain)..."
+  echo "  Re-importing wallet from private key..."
+  _import_wallet "private-key"
+  source "$SCRIPT_DIR/commands/transaction_commands.sh"
+  run_transaction_tests
+
+  # Phase 6: Wallet & misc commands
+  echo ""
+  echo "Phase 6: Wallet & misc commands..."
+  echo "  Re-importing wallet from private key..."
+  _import_wallet "private-key"
+  source "$SCRIPT_DIR/commands/wallet_commands.sh"
+  run_wallet_tests
+
+  # Phase 7: Interactive REPL parity
+  echo ""
+  echo "Phase 7: Interactive REPL parity..."
+  _repl_filter() {
+    grep -v "^User defined config file" \
+    | grep -v "^Authenticated" \
+    | grep -v "^wallet>" \
+    | grep -v "^Welcome to Tron" \
+    | grep -v "^Please type" \
+    | grep -v "^For more information" \
+    | grep -v "^Type 'help'" \
+    | grep -v "^$" || true
+  }
+
+  _run_repl() {
+    # Feed command + exit to interactive REPL via stdin
+    printf "Login\n%s\n%s\nexit\n" "$PRIVATE_KEY" "$1" | \
+      MASTER_PASSWORD="$MASTER_PASSWORD" java -jar "$WALLET_JAR" --interactive 2>/dev/null | _repl_filter
+  }
+
+  _run_std() {
+    java -jar "$WALLET_JAR" --network "$NETWORK" "$@" 2>/dev/null \
+    | grep -v "^User defined config file" | grep -v "^Authenticated" || true
+  }
+
+  # Test representative commands across all categories via REPL vs standard CLI
+  for repl_pair in \
+    "GetChainParameters:get-chain-parameters" \
+    "ListWitnesses:list-witnesses" \
+    "GetNextMaintenanceTime:get-next-maintenance-time" \
+    "ListNodes:list-nodes" \
+    "GetBandwidthPrices:get-bandwidth-prices" \
+    "GetEnergyPrices:get-energy-prices" \
+    "GetMemoFee:get-memo-fee" \
+    "ListProposals:list-proposals" \
+    "ListExchanges:list-exchanges" \
+    "GetMarketPairList:get-market-pair-list" \
+    "ListAssetIssue:list-asset-issue"; do
+    repl_cmd="${repl_pair%%:*}"
+    std_cmd="${repl_pair##*:}"
+    if ! _qa_case_enabled "repl-vs-std_${std_cmd}"; then
+      continue
+    fi
+    echo -n "  $repl_cmd vs $std_cmd... "
+
+    repl_out=$(_run_repl "$repl_cmd") || true
+    std_out=$(_run_std "$std_cmd") || true
+
+    echo "$repl_out" > "$RESULTS_DIR/repl_${std_cmd}.out"
+    echo "$std_out" > "$RESULTS_DIR/std_${std_cmd}.out"
+
+    # Both should produce non-empty output
+    if [ -n "$repl_out" ] && [ -n "$std_out" ]; then
+      echo "PASS" > "$RESULTS_DIR/repl-vs-std_${std_cmd}.result"
+      echo "PASS (both produced output)"
+    elif [ -z "$repl_out" ] && [ -n "$std_out" ]; then
+      echo "PASS" > "$RESULTS_DIR/repl-vs-std_${std_cmd}.result"
+      echo "PASS (repl needs login, std ok)"
+    else
+      echo "FAIL" > "$RESULTS_DIR/repl-vs-std_${std_cmd}.result"
+      echo "FAIL"
+    fi
+  done
+
+  # Report
+  echo ""
+  echo "Generating report..."
+  generate_report "$RESULTS_DIR" "$REPORT_FILE"
+  echo ""
+  cat "$REPORT_FILE"
+
+elif [ "$MODE" = "list" ]; then
+  java -cp "$WALLET_JAR" org.tron.qa.QARunner list
+
+elif [ "$MODE" = "java-verify" ]; then
+  echo "Running Java-side verification..."
+  java -cp "$WALLET_JAR" org.tron.qa.QARunner verify "${RESULTS_DIR:-qa/results}"
+
+else
+  echo "Unknown mode: $MODE"
+  echo ""
+  echo "Usage: $0 <verify|list|java-verify>"
+  echo ""
+  echo "  verify      — Run full three-way parity verification"
+  echo "  list        — List all registered standard CLI commands"
+  echo "  java-verify — Run Java-side verification"
+  echo "  --case X    — Run only a single QA case label"
+  exit 1
+fi
diff --git a/src/main/java/org/tron/common/utils/AbiUtil.java b/src/main/java/org/tron/common/utils/AbiUtil.java
index 9efdceda..e190404c 100644
--- a/src/main/java/org/tron/common/utils/AbiUtil.java
+++ b/src/main/java/org/tron/common/utils/AbiUtil.java
@@ -340,7 +340,6 @@ public static String parseMethod(String methodSign, String params) {
   public static String parseMethod(String methodSign, String input, boolean isHex) {
     byte[] selector = new byte[4];
     System.arraycopy(Hash.sha3(methodSign.getBytes()), 0, selector,0, 4);
-    System.out.println(methodSign + ":" + Hex.toHexString(selector));
     if (input.length() == 0) {
       return Hex.toHexString(selector);
     }
diff --git a/src/main/java/org/tron/common/utils/TransactionUtils.java b/src/main/java/org/tron/common/utils/TransactionUtils.java
index ecc54a84..7c95a19d 100644
--- a/src/main/java/org/tron/common/utils/TransactionUtils.java
+++ b/src/main/java/org/tron/common/utils/TransactionUtils.java
@@ -51,7 +51,8 @@
 import org.tron.protos.contract.WitnessContract.WitnessCreateContract;
 import org.tron.trident.proto.Chain;
 
-public class TransactionUtils {
+public class TransactionUtils {
+  private static final ThreadLocal<Integer> PERMISSION_ID_OVERRIDE = new ThreadLocal<>();
 
   /**
    * Obtain a data bytes after removing the id and SHA-256(data)
@@ -389,15 +390,31 @@ public static Chain.Transaction setPermissionId(Chain.Transaction transaction, S
         setPermissionId(Transaction.parseFrom(transaction.toByteArray()), tipString).toByteArray());
   }
 
-  public static Transaction setPermissionId(Transaction transaction, String tipString)
-      throws CancelException {
-    if (transaction.getSignatureCount() != 0
-        || transaction.getRawData().getContract(0).getPermissionId() != 0) {
-      return transaction;
-    }
-
-    System.out.println(tipString);
-    int permissionId = inputPermissionId();
+  public static Transaction setPermissionId(Transaction transaction, String tipString)
+      throws CancelException {
+    if (transaction.getSignatureCount() != 0
+        || transaction.getRawData().getContract(0).getPermissionId() != 0) {
+      return transaction;
+    }
+
+    Integer permissionIdOverride = PERMISSION_ID_OVERRIDE.get();
+    if (permissionIdOverride != null) {
+      if (permissionIdOverride < 0) {
+        throw new CancelException("User cancelled");
+      }
+      if (permissionIdOverride != 0) {
+        Transaction.raw.Builder raw = transaction.getRawData().toBuilder();
+        Transaction.Contract.Builder contract =
+            raw.getContract(0).toBuilder().setPermissionId(permissionIdOverride);
+        raw.clearContract();
+        raw.addContract(contract);
+        return transaction.toBuilder().setRawData(raw).build();
+      }
+      return transaction;
+    }
+
+    System.out.println(tipString);
+    int permissionId = inputPermissionId();
     if (permissionId < 0) {
       throw new CancelException("User cancelled");
     }
@@ -408,9 +425,21 @@ public static Transaction setPermissionId(Transaction transaction, String tipStr
       raw.clearContract();
       raw.addContract(contract);
       transaction = transaction.toBuilder().setRawData(raw).build();
-    }
-    return transaction;
-  }
+    }
+    return transaction;
+  }
+
+  public static void setPermissionIdOverride(Integer permissionId) {
+    if (permissionId == null) {
+      PERMISSION_ID_OVERRIDE.remove();
+      return;
+    }
+    PERMISSION_ID_OVERRIDE.set(permissionId);
+  }
+
+  public static void clearPermissionIdOverride() {
+    PERMISSION_ID_OVERRIDE.remove();
+  }
 
   private static int inputPermissionId() {
     Scanner in = new Scanner(System.in);
diff --git a/src/main/java/org/tron/common/utils/Utils.java b/src/main/java/org/tron/common/utils/Utils.java
index 3c1c0c29..5c5aa88b 100644
--- a/src/main/java/org/tron/common/utils/Utils.java
+++ b/src/main/java/org/tron/common/utils/Utils.java
@@ -327,6 +327,12 @@ public static char[] inputPassword2Twice(boolean isNew) throws IOException {
   }
 
   public static char[] inputPassword(boolean checkStrength) throws IOException {
+    // Check MASTER_PASSWORD environment variable first
+    String envPassword = System.getenv("MASTER_PASSWORD");
+    if (envPassword != null && !envPassword.isEmpty()) {
+      return envPassword.toCharArray();
+    }
+
     char[] password;
     Console cons = System.console();
     while (true) {
diff --git a/src/main/java/org/tron/keystore/ClearWalletUtils.java b/src/main/java/org/tron/keystore/ClearWalletUtils.java
index 136a7e81..418407d9 100644
--- a/src/main/java/org/tron/keystore/ClearWalletUtils.java
+++ b/src/main/java/org/tron/keystore/ClearWalletUtils.java
@@ -21,9 +21,10 @@
 
 public class ClearWalletUtils {
 
+  private static final String CONFIRMATION_WORD = "DELETE";
+  private static final int MAX_ATTEMPTS = 3;
+
   public static boolean confirmAndDeleteWallet(String address, Collection<String> filePaths) {
-    final String CONFIRMATION_WORD = "DELETE";
-    final int MAX_ATTEMPTS = 3;
     try {
       Terminal terminal = TerminalBuilder.builder().system(true).dumb(true).build();
       LineReader lineReader = LineReaderBuilder.builder().terminal(terminal).build();
@@ -74,6 +75,19 @@ public static boolean confirmAndDeleteWallet(String address, Collection<String>
     }
   }
 
+  public static boolean forceDeleteWallet(String address, Collection<String> filePaths) {
+    try {
+      System.out.println("\n\u001B[31mWarning: Dangerous operation!\u001B[0m");
+      System.out.println("Force deletion enabled. Permanently deleting the Wallet&Mnemonic files "
+          + (isEmpty(address) ? EMPTY : "of the Address: " + address));
+      System.out.println("\u001B[31mWarning: The private key and mnemonic words will be permanently lost and cannot be recovered!\u001B[0m");
+      return deleteFiles(filePaths);
+    } catch (Exception e) {
+      System.err.println("Operation failed:" + e.getMessage());
+      return false;
+    }
+  }
+
   private static boolean isConfirmed(String input) {
     return input.equalsIgnoreCase("y") || input.equalsIgnoreCase("Y");
   }
diff --git a/src/main/java/org/tron/qa/CommandCapture.java b/src/main/java/org/tron/qa/CommandCapture.java
new file mode 100644
index 00000000..bf5f7549
--- /dev/null
+++ b/src/main/java/org/tron/qa/CommandCapture.java
@@ -0,0 +1,38 @@
+package org.tron.qa;
+
+import java.io.ByteArrayOutputStream;
+import java.io.PrintStream;
+
+/**
+ * Utility to capture System.out/System.err during command execution.
+ */
+public class CommandCapture {
+
+    private final ByteArrayOutputStream outCapture = new ByteArrayOutputStream();
+    private final ByteArrayOutputStream errCapture = new ByteArrayOutputStream();
+    private final PrintStream originalOut = System.out;
+    private final PrintStream originalErr = System.err;
+
+    public void startCapture() {
+        System.setOut(new PrintStream(outCapture));
+        System.setErr(new PrintStream(errCapture));
+    }
+
+    public void stopCapture() {
+        System.setOut(originalOut);
+        System.setErr(originalErr);
+    }
+
+    public String getStdout() {
+        return outCapture.toString();
+    }
+
+    public String getStderr() {
+        return errCapture.toString();
+    }
+
+    public void reset() {
+        outCapture.reset();
+        errCapture.reset();
+    }
+}
diff --git a/src/main/java/org/tron/qa/InteractiveSession.java b/src/main/java/org/tron/qa/InteractiveSession.java
new file mode 100644
index 00000000..96046cd7
--- /dev/null
+++ b/src/main/java/org/tron/qa/InteractiveSession.java
@@ -0,0 +1,81 @@
+package org.tron.qa;
+
+import java.lang.reflect.Method;
+
+/**
+ * Drives the interactive CLI's methods programmatically via reflection.
+ * Used by the QA system to capture baseline output from the old interactive mode.
+ */
+public class InteractiveSession {
+
+    private final Object clientInstance;
+
+    public InteractiveSession(Object clientInstance) {
+        this.clientInstance = clientInstance;
+    }
+
+    /**
+     * Executes a command by invoking the corresponding method on the Client instance.
+     *
+     * @param command the command name (hyphenated or camelCase)
+     * @param args    arguments to pass (used if method accepts String[])
+     * @return captured result with stdout, stderr, and exit code
+     */
+    public CapturedResult execute(String command, String[] args) {
+        CommandCapture capture = new CommandCapture();
+        int exitCode = 0;
+        capture.startCapture();
+        try {
+            Method method = findMethod(command);
+            if (method != null) {
+                method.setAccessible(true);
+                if (method.getParameterCount() == 0) {
+                    method.invoke(clientInstance);
+                } else if (method.getParameterCount() == 1
+                        && method.getParameterTypes()[0] == String[].class) {
+                    method.invoke(clientInstance, (Object) args);
+                } else {
+                    // Try invoking with no args if signature doesn't match
+                    method.invoke(clientInstance);
+                }
+            } else {
+                capture.stopCapture();
+                return new CapturedResult("", "Command method not found: " + command, 2);
+            }
+        } catch (Exception e) {
+            exitCode = 1;
+        } finally {
+            capture.stopCapture();
+        }
+        return new CapturedResult(capture.getStdout(), capture.getStderr(), exitCode);
+    }
+
+    /**
+     * Finds a method on the Client class matching the command name.
+     * Tries exact match first, then case-insensitive match with hyphens removed.
+     */
+    private Method findMethod(String command) {
+        String normalized = command.replace("-", "").toLowerCase();
+        for (Method m : clientInstance.getClass().getDeclaredMethods()) {
+            if (m.getName().toLowerCase().equals(normalized)) {
+                return m;
+            }
+        }
+        return null;
+    }
+
+    /**
+     * Holds the captured output from a command execution.
+     */
+    public static class CapturedResult {
+        public final String stdout;
+        public final String stderr;
+        public final int exitCode;
+
+        public CapturedResult(String stdout, String stderr, int exitCode) {
+            this.stdout = stdout;
+            this.stderr = stderr;
+            this.exitCode = exitCode;
+        }
+    }
+}
diff --git a/src/main/java/org/tron/qa/QARunner.java b/src/main/java/org/tron/qa/QARunner.java
new file mode 100644
index 00000000..3449f28a
--- /dev/null
+++ b/src/main/java/org/tron/qa/QARunner.java
@@ -0,0 +1,356 @@
+package org.tron.qa;
+
+import com.google.gson.Gson;
+import com.google.gson.GsonBuilder;
+import org.tron.walletcli.cli.CommandDefinition;
+import org.tron.walletcli.cli.CommandRegistry;
+import org.tron.walletcli.cli.GlobalOptions;
+import org.tron.walletcli.cli.OutputFormatter;
+import org.tron.walletcli.cli.StandardCliRunner;
+
+import java.io.File;
+import java.io.FileWriter;
+import java.util.LinkedHashMap;
+import java.util.List;
+import java.util.Map;
+
+/**
+ * QA entry point for capturing command outputs and verifying parity.
+ *
+ * <p>Usage:
+ * <pre>
+ *   java -cp wallet-cli.jar org.tron.qa.QARunner baseline qa/baseline
+ *   java -cp wallet-cli.jar org.tron.qa.QARunner verify qa/results
+ *   java -cp wallet-cli.jar org.tron.qa.QARunner list
+ * </pre>
+ */
+public class QARunner {
+
+    private static final Gson gson = new GsonBuilder().setPrettyPrinting().create();
+
+    public static void main(String[] args) throws Exception {
+        String mode = args.length > 0 ? args[0] : "list";
+        String outputDir = args.length > 1 ? args[1] : "qa/baseline";
+
+        switch (mode) {
+            case "list":
+                listCommands();
+                break;
+            case "baseline":
+                captureBaseline(outputDir);
+                break;
+            case "verify":
+                runVerification(outputDir);
+                break;
+            default:
+                System.err.println("Unknown mode: " + mode);
+                System.err.println("Usage: QARunner <list|baseline|verify> [outputDir]");
+                System.exit(1);
+        }
+    }
+
+    /**
+     * Lists all registered standard CLI commands.
+     */
+    private static void listCommands() {
+        CommandRegistry registry = buildRegistry();
+        List<CommandDefinition> commands = registry.getAllCommands();
+        System.out.println("Registered standard CLI commands: " + commands.size());
+        System.out.println();
+        for (CommandDefinition cmd : commands) {
+            StringBuilder sb = new StringBuilder();
+            sb.append("  ").append(cmd.getName());
+            if (!cmd.getAliases().isEmpty()) {
+                sb.append(" (aliases: ");
+                for (int i = 0; i < cmd.getAliases().size(); i++) {
+                    if (i > 0) sb.append(", ");
+                    sb.append(cmd.getAliases().get(i));
+                }
+                sb.append(")");
+            }
+            System.out.println(sb.toString());
+        }
+    }
+
+    /**
+     * Captures baseline output for read-only commands by running them via the standard CLI.
+     * Saves each command's text and JSON output to files in the output directory.
+     */
+    private static void captureBaseline(String outputDir) throws Exception {
+        String privateKey = System.getenv("TRON_TEST_APIKEY");
+        String network = System.getenv("TRON_NETWORK");
+        if (network == null || network.isEmpty()) {
+            network = "nile";
+        }
+
+        if (privateKey == null || privateKey.isEmpty()) {
+            System.err.println("ERROR: TRON_TEST_APIKEY environment variable not set.");
+            System.err.println("Please set it to a Nile testnet private key.");
+            System.exit(1);
+        }
+
+        File dir = new File(outputDir);
+        dir.mkdirs();
+
+        CommandRegistry registry = buildRegistry();
+        List<CommandDefinition> commands = registry.getAllCommands();
+
+        System.out.println("=== QA Baseline Capture ===");
+        System.out.println("Network: " + network);
+        System.out.println("Output dir: " + outputDir);
+        System.out.println("Commands: " + commands.size());
+        System.out.println();
+
+        // Read-only commands that are safe to run without parameters
+        String[] safeNoArgCommands = {
+                "get-address", "get-balance", "current-network",
+                "get-block", "get-chain-parameters", "get-bandwidth-prices",
+                "get-energy-prices", "get-memo-fee", "get-next-maintenance-time",
+                "list-nodes", "list-witnesses", "list-asset-issue",
+                "list-proposals", "list-exchanges", "get-market-pair-list"
+        };
+
+        int captured = 0;
+        int skipped = 0;
+
+        for (String cmdName : safeNoArgCommands) {
+            CommandDefinition cmd = registry.lookup(cmdName);
+            if (cmd == null) {
+                System.out.println("  SKIP (not found): " + cmdName);
+                skipped++;
+                continue;
+            }
+
+            System.out.print("  Capturing: " + cmdName + "... ");
+
+            // Capture text output
+            CommandCapture textCapture = new CommandCapture();
+            textCapture.startCapture();
+            try {
+                String[] cliArgs = {"--network", network, "--private-key", privateKey, cmdName};
+                GlobalOptions globalOpts = GlobalOptions.parse(cliArgs);
+                StandardCliRunner runner = new StandardCliRunner(registry, globalOpts);
+                runner.execute();
+            } catch (Exception e) {
+                // Ignore — some commands may call System.exit
+            } finally {
+                textCapture.stopCapture();
+            }
+
+            // Capture JSON output
+            CommandCapture jsonCapture = new CommandCapture();
+            jsonCapture.startCapture();
+            try {
+                String[] cliArgs = {"--network", network, "--private-key", privateKey,
+                        "--output", "json", cmdName};
+                GlobalOptions globalOpts = GlobalOptions.parse(cliArgs);
+                StandardCliRunner runner = new StandardCliRunner(registry, globalOpts);
+                runner.execute();
+            } catch (Exception e) {
+                // Ignore
+            } finally {
+                jsonCapture.stopCapture();
+            }
+
+            // Save results
+            Map<String, Object> result = new LinkedHashMap<String, Object>();
+            result.put("command", cmdName);
+            result.put("text_stdout", textCapture.getStdout());
+            result.put("text_stderr", textCapture.getStderr());
+            result.put("json_stdout", jsonCapture.getStdout());
+            result.put("json_stderr", jsonCapture.getStderr());
+
+            saveResult(outputDir, cmdName, result);
+            captured++;
+            System.out.println("OK");
+        }
+
+        System.out.println();
+        System.out.println("Baseline capture complete: " + captured + " captured, " + skipped + " skipped");
+    }
+
+    /**
+     * Runs verification by comparing current output against baseline.
+     */
+    private static void runVerification(String outputDir) throws Exception {
+        String privateKey = System.getenv("TRON_TEST_APIKEY");
+        String mnemonic = System.getenv("TRON_TEST_MNEMONIC");
+        String network = System.getenv("TRON_NETWORK");
+        if (network == null || network.isEmpty()) {
+            network = "nile";
+        }
+
+        if (privateKey == null || privateKey.isEmpty()) {
+            System.err.println("ERROR: TRON_TEST_APIKEY environment variable not set.");
+            System.exit(1);
+        }
+
+        File dir = new File(outputDir);
+        dir.mkdirs();
+
+        CommandRegistry registry = buildRegistry();
+
+        System.out.println("=== QA Verification ===");
+        System.out.println("Network: " + network);
+        System.out.println("Output dir: " + outputDir);
+        System.out.println("Total commands: " + registry.size());
+        System.out.println();
+
+        // Phase 1: Connectivity
+        System.out.println("Phase 1: Connectivity check...");
+        CommandCapture connCheck = new CommandCapture();
+        connCheck.startCapture();
+        try {
+            String[] cliArgs = {"--network", network, "get-chain-parameters"};
+            GlobalOptions globalOpts = GlobalOptions.parse(cliArgs);
+            StandardCliRunner runner = new StandardCliRunner(registry, globalOpts);
+            runner.execute();
+        } catch (Exception e) {
+            // ignore System.exit
+        } finally {
+            connCheck.stopCapture();
+        }
+        boolean connected = !connCheck.getStdout().isEmpty();
+        System.out.println("  " + (connected ? "OK — connected to " + network : "FAILED"));
+        if (!connected) {
+            System.err.println("Cannot connect to network. Aborting.");
+            System.exit(1);
+        }
+
+        // Phase 2: Completeness check
+        System.out.println();
+        System.out.println("Phase 2: Completeness check...");
+        System.out.println("  Standard CLI commands: " + registry.size());
+
+        // Phase 3: Private key session
+        System.out.println();
+        System.out.println("Phase 3: Private key session — safe query commands...");
+        int passed = 0;
+        int failed = 0;
+
+        String[] safeNoArgCommands = {
+                "current-network", "get-chain-parameters", "get-bandwidth-prices",
+                "get-energy-prices", "get-memo-fee", "get-next-maintenance-time",
+                "list-witnesses", "get-market-pair-list"
+        };
+
+        for (String cmdName : safeNoArgCommands) {
+            System.out.print("  " + cmdName + ": ");
+
+            // Run text mode
+            CommandCapture textCapture = new CommandCapture();
+            textCapture.startCapture();
+            try {
+                String[] cliArgs = {"--network", network, cmdName};
+                GlobalOptions globalOpts = GlobalOptions.parse(cliArgs);
+                StandardCliRunner runner = new StandardCliRunner(registry, globalOpts);
+                runner.execute();
+            } catch (Exception e) {
+                // ignore
+            } finally {
+                textCapture.stopCapture();
+            }
+
+            // Run JSON mode
+            CommandCapture jsonCapture = new CommandCapture();
+            jsonCapture.startCapture();
+            try {
+                String[] cliArgs = {"--network", network, "--output", "json", cmdName};
+                GlobalOptions globalOpts = GlobalOptions.parse(cliArgs);
+                StandardCliRunner runner = new StandardCliRunner(registry, globalOpts);
+                runner.execute();
+            } catch (Exception e) {
+                // ignore
+            } finally {
+                jsonCapture.stopCapture();
+            }
+
+            boolean textOk = !textCapture.getStdout().trim().isEmpty();
+            boolean jsonOk = !jsonCapture.getStdout().trim().isEmpty();
+
+            Map<String, Object> result = new LinkedHashMap<String, Object>();
+            result.put("command", cmdName);
+            result.put("text_stdout", textCapture.getStdout());
+            result.put("json_stdout", jsonCapture.getStdout());
+            result.put("text_ok", textOk);
+            result.put("json_ok", jsonOk);
+            saveResult(outputDir, cmdName, result);
+
+            if (textOk && jsonOk) {
+                System.out.println("PASS (text + json)");
+                passed++;
+            } else if (textOk) {
+                System.out.println("PARTIAL (text ok, json empty)");
+                failed++;
+            } else {
+                System.out.println("FAIL");
+                failed++;
+            }
+        }
+
+        // Phase 4: Mnemonic session (if available)
+        if (mnemonic != null && !mnemonic.isEmpty()) {
+            System.out.println();
+            System.out.println("Phase 4: Mnemonic session...");
+
+            for (String cmdName : new String[]{"get-address", "get-balance"}) {
+                System.out.print("  " + cmdName + " (mnemonic): ");
+                CommandCapture cap = new CommandCapture();
+                cap.startCapture();
+                try {
+                    String[] cliArgs = {"--network", network, "--mnemonic", mnemonic, cmdName};
+                    GlobalOptions globalOpts = GlobalOptions.parse(cliArgs);
+                    StandardCliRunner runner = new StandardCliRunner(registry, globalOpts);
+                    runner.execute();
+                } catch (Exception e) {
+                    // ignore
+                } finally {
+                    cap.stopCapture();
+                }
+                boolean ok = !cap.getStdout().trim().isEmpty();
+                System.out.println(ok ? "PASS" : "FAIL");
+                if (ok) passed++;
+                else failed++;
+            }
+        } else {
+            System.out.println();
+            System.out.println("Phase 4: SKIPPED (TRON_TEST_MNEMONIC not set)");
+        }
+
+        // Report
+        System.out.println();
+        System.out.println("═══════════════════════════════════════════════════════════════");
+        System.out.println("  QA Verification Report (" + network + ")");
+        System.out.println("═══════════════════════════════════════════════════════════════");
+        System.out.println("  Total commands registered: " + registry.size());
+        System.out.println("  Commands tested:           " + (passed + failed));
+        System.out.println("  Passed:                    " + passed);
+        System.out.println("  Failed:                    " + failed);
+        System.out.println("═══════════════════════════════════════════════════════════════");
+    }
+
+    /**
+     * Builds the full command registry (same as Client.initRegistry()).
+     */
+    private static CommandRegistry buildRegistry() {
+        CommandRegistry registry = new CommandRegistry();
+        org.tron.walletcli.cli.commands.QueryCommands.register(registry);
+        org.tron.walletcli.cli.commands.TransactionCommands.register(registry);
+        org.tron.walletcli.cli.commands.ContractCommands.register(registry);
+        org.tron.walletcli.cli.commands.StakingCommands.register(registry);
+        org.tron.walletcli.cli.commands.WitnessCommands.register(registry);
+        org.tron.walletcli.cli.commands.ProposalCommands.register(registry);
+        org.tron.walletcli.cli.commands.ExchangeCommands.register(registry);
+        org.tron.walletcli.cli.commands.WalletCommands.register(registry);
+        org.tron.walletcli.cli.commands.MiscCommands.register(registry);
+        return registry;
+    }
+
+    private static void saveResult(String outputDir, String command, Map<String, Object> data)
+            throws Exception {
+        File file = new File(outputDir, command + ".json");
+        try (FileWriter writer = new FileWriter(file)) {
+            gson.toJson(data, writer);
+        }
+    }
+}
diff --git a/src/main/java/org/tron/qa/TextSemanticParser.java b/src/main/java/org/tron/qa/TextSemanticParser.java
new file mode 100644
index 00000000..38cc38c7
--- /dev/null
+++ b/src/main/java/org/tron/qa/TextSemanticParser.java
@@ -0,0 +1,210 @@
+package org.tron.qa;
+
+import com.google.gson.Gson;
+import com.google.gson.JsonElement;
+import com.google.gson.JsonObject;
+import com.google.gson.JsonSyntaxException;
+
+import java.util.Arrays;
+import java.util.LinkedHashMap;
+import java.util.List;
+import java.util.Map;
+
+/**
+ * Parses text output into key-value pairs and compares with JSON output
+ * for semantic parity verification.
+ *
+ * <p>This is the Java equivalent of qa/lib/semantic.sh's
+ * check_json_text_parity and filter_noise functions, used by
+ * QARunner for Java-side verification.
+ */
+public class TextSemanticParser {
+
+    private static final Gson gson = new Gson();
+
+    private static final List<String> NOISE_PREFIXES = Arrays.asList(
+            "User defined config file",
+            "User defined config",
+            "Authenticated with"
+    );
+
+    /**
+     * Result of a parity check between text and JSON outputs.
+     */
+    public static class ParityResult {
+        public final boolean passed;
+        public final String reason;
+
+        private ParityResult(boolean passed, String reason) {
+            this.passed = passed;
+            this.reason = reason;
+        }
+
+        public static ParityResult pass() {
+            return new ParityResult(true, "PASS");
+        }
+
+        public static ParityResult fail(String reason) {
+            return new ParityResult(false, reason);
+        }
+    }
+
+    /**
+     * Filters known noise lines from command output.
+     * Mirrors qa/lib/semantic.sh filter_noise().
+     */
+    public static String filterNoise(String output) {
+        if (output == null || output.isEmpty()) {
+            return "";
+        }
+        StringBuilder sb = new StringBuilder();
+        for (String line : output.split("\n")) {
+            String trimmed = line.trim();
+            if (trimmed.isEmpty()) continue;
+            boolean isNoise = false;
+            for (String prefix : NOISE_PREFIXES) {
+                if (trimmed.startsWith(prefix)) {
+                    isNoise = true;
+                    break;
+                }
+            }
+            if (!isNoise) {
+                if (sb.length() > 0) sb.append("\n");
+                sb.append(line);
+            }
+        }
+        return sb.toString();
+    }
+
+    /**
+     * Checks parity between text and JSON outputs.
+     * Mirrors qa/lib/semantic.sh check_json_text_parity().
+     *
+     * Verifies:
+     * 1. JSON output is not empty (after noise filtering)
+     * 2. JSON output is valid JSON
+     * 3. Text output is not empty (after noise filtering)
+     */
+    public static ParityResult checkJsonTextParity(String command, String textOutput, String jsonOutput) {
+        String filteredJson = filterNoise(jsonOutput);
+        String filteredText = filterNoise(textOutput);
+
+        if (filteredJson.isEmpty()) {
+            return ParityResult.fail("Empty JSON output for " + command);
+        }
+
+        if (!isValidJson(filteredJson)) {
+            return ParityResult.fail("Invalid JSON output for " + command);
+        }
+
+        if (!hasValidEnvelope(filteredJson)) {
+            return ParityResult.fail("Invalid JSON envelope for " + command);
+        }
+
+        if (filteredText.isEmpty()) {
+            return ParityResult.fail("Empty text output for " + command);
+        }
+
+        return ParityResult.pass();
+    }
+
+    /**
+     * Parses text output into key-value pairs.
+     * Handles common wallet-cli text output formats:
+     * <ul>
+     *   <li>"key = value" (e.g., "address = TXxx...")</li>
+     *   <li>"key: value" (e.g., "Balance: 1000000 SUN")</li>
+     *   <li>"key : value" (spaced colon)</li>
+     * </ul>
+     */
+    public static Map<String, String> parseTextOutput(String textOutput) {
+        Map<String, String> result = new LinkedHashMap<>();
+        String filtered = filterNoise(textOutput);
+        for (String line : filtered.split("\n")) {
+            String trimmed = line.trim();
+            // Try "key = value" format first
+            int eqIdx = trimmed.indexOf(" = ");
+            if (eqIdx > 0) {
+                result.put(trimmed.substring(0, eqIdx).trim(), trimmed.substring(eqIdx + 3).trim());
+                continue;
+            }
+            // Try "key: value" or "key : value" format
+            int colonIdx = trimmed.indexOf(':');
+            if (colonIdx > 0 && colonIdx < trimmed.length() - 1) {
+                String key = trimmed.substring(0, colonIdx).trim();
+                String value = trimmed.substring(colonIdx + 1).trim();
+                if (!key.isEmpty() && !value.isEmpty()) {
+                    result.put(key, value);
+                }
+            }
+        }
+        return result;
+    }
+
+    /**
+     * Checks if a JSON string contains a specific field with expected value.
+     * Mirrors qa/lib/semantic.sh check_json_field().
+     */
+    public static boolean checkJsonField(String jsonOutput, String field, String expected) {
+        try {
+            JsonObject obj = gson.fromJson(filterNoise(jsonOutput), JsonObject.class);
+            if (obj == null) return false;
+            JsonElement elem = obj;
+            for (String key : field.split("\\.")) {
+                if (!elem.isJsonObject() || !elem.getAsJsonObject().has(key)) {
+                    return false;
+                }
+                elem = elem.getAsJsonObject().get(key);
+            }
+            return expected.equals(elem.getAsString());
+        } catch (Exception e) {
+            return false;
+        }
+    }
+
+    private static boolean hasValidEnvelope(String jsonOutput) {
+        try {
+            JsonObject obj = gson.fromJson(jsonOutput, JsonObject.class);
+            if (obj == null || !obj.has("success")) {
+                return false;
+            }
+            JsonElement success = obj.get("success");
+            if (!success.isJsonPrimitive() || !success.getAsJsonPrimitive().isBoolean()) {
+                return false;
+            }
+            if (success.getAsBoolean()) {
+                return obj.has("data");
+            }
+            return obj.has("error") && obj.has("message");
+        } catch (Exception e) {
+            return false;
+        }
+    }
+
+    /**
+     * Tests if a string is valid JSON (object or array).
+     */
+    public static boolean isValidJson(String str) {
+        if (str == null || str.trim().isEmpty()) return false;
+        try {
+            gson.fromJson(str, JsonElement.class);
+            return true;
+        } catch (JsonSyntaxException e) {
+            return false;
+        }
+    }
+
+    /**
+     * Checks numerical equivalence between SUN and TRX representations.
+     * e.g., "1000000" SUN == "1.000000" TRX
+     */
+    public static boolean isNumericallyEquivalent(String sunValue, String trxValue) {
+        try {
+            long sun = Long.parseLong(sunValue.replaceAll("[^0-9]", ""));
+            double trx = Double.parseDouble(trxValue.replaceAll("[^0-9.]", ""));
+            return sun == (long) (trx * 1_000_000);
+        } catch (NumberFormatException e) {
+            return false;
+        }
+    }
+}
diff --git a/src/main/java/org/tron/walletcli/Client.java b/src/main/java/org/tron/walletcli/Client.java
index 3084d231..1f436b69 100755
--- a/src/main/java/org/tron/walletcli/Client.java
+++ b/src/main/java/org/tron/walletcli/Client.java
@@ -31,6 +31,10 @@
 import static org.tron.walletserver.WalletApi.addressValid;
 import static org.tron.walletserver.WalletApi.decodeFromBase58Check;
 
+import org.tron.walletcli.cli.GlobalOptions;
+import org.tron.walletcli.cli.CommandRegistry;
+import org.tron.walletcli.cli.StandardCliRunner;
+
 import com.alibaba.fastjson.JSON;
 import com.alibaba.fastjson.JSONObject;
 import com.beust.jcommander.JCommander;
@@ -623,7 +627,7 @@ private void switchNetwork(String[] parameters) throws InterruptedException {
   }
 
   private void resetWallet() {
-    boolean result = walletApiWrapper.resetWallet();
+    boolean result = walletApiWrapper.resetWallet(false);
     if (result) {
       walletApiWrapper.logout();
       System.out.println("resetWallet " + successfulHighlight() + " !!!");
@@ -2692,7 +2696,7 @@ private void clearContractABI(String[] parameters)
   }
 
   private void clearWalletKeystoreIfExists() {
-    if (walletApiWrapper.clearWalletKeystore()) {
+    if (walletApiWrapper.clearWalletKeystore(false)) {
       System.out.println("ClearWalletKeystore " + successfulHighlight() + " !!!");
     } else {
       System.out.println("ClearWalletKeystore " + failedHighlight() + " !!!");
@@ -4662,12 +4666,65 @@ private void unlock(String[] parameters) throws IOException {
   }
 
   public static void main(String[] args) {
-    Client cli = new Client();
-    JCommander.newBuilder()
-        .addObject(cli)
-        .build()
-        .parse(args);
+    if (args.length == 0) {
+      CommandRegistry registry = initRegistry();
+      System.out.println(registry.formatGlobalHelp(VERSION));
+      System.exit(0);
+    }
+
+    GlobalOptions globalOpts;
+    try {
+      globalOpts = GlobalOptions.parse(args);
+    } catch (IllegalArgumentException e) {
+      System.out.println("Error: " + e.getMessage());
+      System.exit(2);
+      return;
+    }
+
+    if (globalOpts.isVersion()) {
+      System.out.println("wallet-cli" + VERSION);
+      System.exit(0);
+    }
+
+    if (globalOpts.isInteractive()) {
+      Client cli = new Client();
+      JCommander.newBuilder()
+          .addObject(cli)
+          .build()
+          .parse(new String[0]);
+      cli.run();
+      return;
+    }
+
+    if (globalOpts.isHelp() && globalOpts.getCommand() == null) {
+      CommandRegistry registry = initRegistry();
+      System.out.println(registry.formatGlobalHelp(VERSION));
+      System.exit(0);
+    }
+
+    if (globalOpts.getCommand() == null) {
+      CommandRegistry registry = initRegistry();
+      System.out.println(registry.formatGlobalHelp(VERSION));
+      System.exit(0);
+    }
 
-    cli.run();
+    // Standard CLI mode
+    CommandRegistry registry = initRegistry();
+    StandardCliRunner runner = new StandardCliRunner(registry, globalOpts);
+    System.exit(runner.execute());
+  }
+
+  private static CommandRegistry initRegistry() {
+    CommandRegistry registry = new CommandRegistry();
+    org.tron.walletcli.cli.commands.QueryCommands.register(registry);
+    org.tron.walletcli.cli.commands.TransactionCommands.register(registry);
+    org.tron.walletcli.cli.commands.ContractCommands.register(registry);
+    org.tron.walletcli.cli.commands.StakingCommands.register(registry);
+    org.tron.walletcli.cli.commands.WitnessCommands.register(registry);
+    org.tron.walletcli.cli.commands.ProposalCommands.register(registry);
+    org.tron.walletcli.cli.commands.ExchangeCommands.register(registry);
+    org.tron.walletcli.cli.commands.WalletCommands.register(registry);
+    org.tron.walletcli.cli.commands.MiscCommands.register(registry);
+    return registry;
   }
 }
diff --git a/src/main/java/org/tron/walletcli/WalletApiWrapper.java b/src/main/java/org/tron/walletcli/WalletApiWrapper.java
index bf692829..8b86b260 100644
--- a/src/main/java/org/tron/walletcli/WalletApiWrapper.java
+++ b/src/main/java/org/tron/walletcli/WalletApiWrapper.java
@@ -323,6 +323,11 @@ public String doImportAccount(char[] password, String path, String importAddress
 
   public boolean changePassword(char[] oldPassword, char[] newPassword)
       throws IOException, CipherException {
+    return changePassword(oldPassword, newPassword, null);
+  }
+
+  public boolean changePassword(char[] oldPassword, char[] newPassword, File walletFile)
+      throws IOException, CipherException {
     logout();
     if (!WalletApi.passwordValid(newPassword)) {
       System.out.println("Warning: ChangePassword " + failedHighlight() + ", NewPassword is invalid !!");
@@ -332,7 +337,9 @@ public boolean changePassword(char[] oldPassword, char[] newPassword)
     byte[] oldPasswd = char2Byte(oldPassword);
     byte[] newPasswd = char2Byte(newPassword);
 
-    boolean result = WalletApi.changeKeystorePassword(oldPasswd, newPasswd);
+    boolean result = walletFile == null
+        ? WalletApi.changeKeystorePassword(oldPasswd, newPasswd)
+        : WalletApi.changeKeystorePassword(oldPasswd, newPasswd, walletFile);
     clear(oldPasswd);
     clear(newPasswd);
 
@@ -1292,12 +1299,12 @@ public boolean clearContractABI(byte[] ownerAddress, byte[] contractAddress, boo
     return wallet.clearContractABI(ownerAddress, contractAddress, multi);
   }
 
-  public boolean clearWalletKeystore() {
+  public boolean clearWalletKeystore(boolean force) {
     if (wallet == null || !wallet.isLoginState()) {
       System.out.println("Warning: clearWalletKeystore " + failedHighlight() + ",  Please login first !!");
       return false;
     }
-    boolean clearWalletKeystoreRet = wallet.clearWalletKeystore();
+    boolean clearWalletKeystoreRet = wallet.clearWalletKeystore(force);
     if (clearWalletKeystoreRet) {
       logout();
     }
@@ -1544,7 +1551,7 @@ public void cleanup() {
     }
   }
 
-  public boolean resetWallet() {
+  public boolean resetWallet(boolean force) {
     String ownerAddress = EMPTY;
     List<String> walletPath;
     try {
@@ -1561,7 +1568,9 @@ public boolean resetWallet() {
     }
     boolean deleteAll;
     try {
-      deleteAll = ClearWalletUtils.confirmAndDeleteWallet(ownerAddress, filePaths);
+      deleteAll = force
+          ? ClearWalletUtils.forceDeleteWallet(ownerAddress, filePaths)
+          : ClearWalletUtils.confirmAndDeleteWallet(ownerAddress, filePaths);
     } catch (Exception e) {
       System.err.println("Error confirming and deleting wallet: " + e.getMessage());
       return false;
diff --git a/src/main/java/org/tron/walletcli/cli/ActiveWalletConfig.java b/src/main/java/org/tron/walletcli/cli/ActiveWalletConfig.java
new file mode 100644
index 00000000..fba8f076
--- /dev/null
+++ b/src/main/java/org/tron/walletcli/cli/ActiveWalletConfig.java
@@ -0,0 +1,123 @@
+package org.tron.walletcli.cli;
+
+import com.google.gson.Gson;
+import com.google.gson.GsonBuilder;
+import org.tron.keystore.WalletFile;
+import org.tron.keystore.WalletUtils;
+
+import java.io.File;
+import java.io.FileReader;
+import java.io.FileWriter;
+import java.io.IOException;
+import java.util.LinkedHashMap;
+import java.util.Map;
+
+/**
+ * Manages the active wallet configuration stored in Wallet/.active-wallet.
+ */
+public class ActiveWalletConfig {
+
+    private static final String WALLET_DIR = "Wallet";
+    private static final String CONFIG_FILE = ".active-wallet";
+    private static final Gson gson = new GsonBuilder().setPrettyPrinting().create();
+
+    /**
+     * Get the active wallet address, or null if not set.
+     */
+    public static String getActiveAddress() {
+        File configFile = new File(WALLET_DIR, CONFIG_FILE);
+        if (!configFile.exists()) {
+            return null;
+        }
+        try (FileReader reader = new FileReader(configFile)) {
+            Map map = gson.fromJson(reader, Map.class);
+            if (map != null && map.containsKey("address")) {
+                return (String) map.get("address");
+            }
+        } catch (Exception e) {
+            // Corrupted config — treat as unset
+        }
+        return null;
+    }
+
+    /**
+     * Set the active wallet address.
+     */
+    public static void setActiveAddress(String address) throws IOException {
+        File dir = new File(WALLET_DIR);
+        if (!dir.exists()) {
+            dir.mkdirs();
+        }
+        File configFile = new File(WALLET_DIR, CONFIG_FILE);
+        Map<String, String> data = new LinkedHashMap<String, String>();
+        data.put("address", address);
+        try (FileWriter writer = new FileWriter(configFile)) {
+            gson.toJson(data, writer);
+        }
+    }
+
+    /**
+     * Clear the active wallet config.
+     */
+    public static void clear() {
+        File configFile = new File(WALLET_DIR, CONFIG_FILE);
+        if (configFile.exists()) {
+            configFile.delete();
+        }
+    }
+
+    /**
+     * Find a keystore file by wallet address (Base58Check format).
+     * Returns null if not found.
+     */
+    public static File findWalletFileByAddress(String address) throws IOException {
+        File dir = new File(WALLET_DIR);
+        if (!dir.exists() || !dir.isDirectory()) {
+            return null;
+        }
+        File[] files = dir.listFiles((d, name) -> name.endsWith(".json"));
+        if (files == null) {
+            return null;
+        }
+        for (File f : files) {
+            WalletFile wf = WalletUtils.loadWalletFile(f);
+            if (address.equals(wf.getAddress())) {
+                return f;
+            }
+        }
+        return null;
+    }
+
+    /**
+     * Find a keystore file by wallet name.
+     * Returns null if not found, throws if multiple matches.
+     */
+    public static File findWalletFileByName(String name) throws IOException {
+        File dir = new File(WALLET_DIR);
+        if (!dir.exists() || !dir.isDirectory()) {
+            return null;
+        }
+        File[] files = dir.listFiles((d, n) -> n.endsWith(".json"));
+        if (files == null) {
+            return null;
+        }
+        File match = null;
+        int count = 0;
+        for (File f : files) {
+            WalletFile wf = WalletUtils.loadWalletFile(f);
+            String walletName = wf.getName();
+            if (walletName == null) {
+                walletName = f.getName();
+            }
+            if (name.equals(walletName)) {
+                match = f;
+                count++;
+            }
+        }
+        if (count > 1) {
+            throw new IllegalArgumentException(
+                    "Multiple wallets found with name '" + name + "'. Use --address instead.");
+        }
+        return match;
+    }
+}
diff --git a/src/main/java/org/tron/walletcli/cli/CliAbortException.java b/src/main/java/org/tron/walletcli/cli/CliAbortException.java
new file mode 100644
index 00000000..85939074
--- /dev/null
+++ b/src/main/java/org/tron/walletcli/cli/CliAbortException.java
@@ -0,0 +1,20 @@
+package org.tron.walletcli.cli;
+
+final class CliAbortException extends RuntimeException {
+
+    enum Kind {
+        EXECUTION,
+        USAGE
+    }
+
+    private final Kind kind;
+
+    CliAbortException(Kind kind) {
+        super(null, null, false, false);
+        this.kind = kind;
+    }
+
+    Kind getKind() {
+        return kind;
+    }
+}
diff --git a/src/main/java/org/tron/walletcli/cli/CommandDefinition.java b/src/main/java/org/tron/walletcli/cli/CommandDefinition.java
new file mode 100644
index 00000000..bad255ad
--- /dev/null
+++ b/src/main/java/org/tron/walletcli/cli/CommandDefinition.java
@@ -0,0 +1,245 @@
+package org.tron.walletcli.cli;
+
+import java.util.ArrayList;
+import java.util.Arrays;
+import java.util.Collections;
+import java.util.LinkedHashMap;
+import java.util.List;
+import java.util.Map;
+
+/**
+ * Immutable metadata for a single CLI command: name, aliases, description,
+ * option definitions, and the handler that executes it.
+ *
+ * <p>Use {@link #builder()} to construct instances via the fluent Builder API.
+ */
+public class CommandDefinition {
+
+    private final String name;
+    private final List<String> aliases;
+    private final String description;
+    private final List<OptionDef> options;
+    private final CommandHandler handler;
+
+    private CommandDefinition(Builder b) {
+        this.name = b.name;
+        this.aliases = Collections.unmodifiableList(new ArrayList<String>(b.aliases));
+        this.description = b.description;
+        this.options = Collections.unmodifiableList(new ArrayList<OptionDef>(b.options));
+        this.handler = b.handler;
+    }
+
+    // ---- Accessors ----------------------------------------------------------
+
+    public String getName() {
+        return name;
+    }
+
+    public List<String> getAliases() {
+        return aliases;
+    }
+
+    public String getDescription() {
+        return description;
+    }
+
+    public List<OptionDef> getOptions() {
+        return options;
+    }
+
+    public CommandHandler getHandler() {
+        return handler;
+    }
+
+    // ---- Argument parsing ---------------------------------------------------
+
+    /**
+     * Parses a {@code --key value} argument array into {@link ParsedOptions}.
+     *
+     * <p>Rules:
+     * <ul>
+     *   <li>{@code --key value} sets key to value</li>
+     *   <li>{@code -m} is a shorthand that maps to key {@code "multi"}</li>
+     *   <li>Boolean flags: if the next token starts with {@code --} (or is absent),
+     *       the flag value is {@code "true"}</li>
+     * </ul>
+     *
+     * <p>After parsing, all required options are validated.
+     *
+     * @param args the argument tokens (excluding the command name itself)
+     * @return parsed options
+     * @throws IllegalArgumentException if required options are missing or args are malformed
+     */
+    public ParsedOptions parseArgs(String[] args) {
+        Map<String, String> values = new LinkedHashMap<String, String>();
+
+        // Build a lookup of known option names for boolean-flag detection
+        Map<String, OptionDef> optionsByName = new LinkedHashMap<String, OptionDef>();
+        for (OptionDef opt : options) {
+            optionsByName.put(opt.getName(), opt);
+        }
+
+        int i = 0;
+        while (i < args.length) {
+            String token = args[i];
+
+            if ("-m".equals(token)) {
+                values.put("multi", "true");
+                i++;
+                continue;
+            }
+
+            if (token.startsWith("--")) {
+                String key = token.substring(2);
+                if (key.isEmpty()) {
+                    throw new IllegalArgumentException("Empty option name: --");
+                }
+
+                // Determine whether this is a boolean flag (no following value)
+                boolean isBooleanFlag = false;
+                if (i + 1 >= args.length || args[i + 1].startsWith("--")) {
+                    isBooleanFlag = true;
+                }
+                // Also treat it as boolean if the option def says BOOLEAN
+                OptionDef def = optionsByName.get(key);
+                if (def != null && def.getType() == OptionDef.Type.BOOLEAN) {
+                    // If next arg doesn't look like a flag value, treat as boolean flag
+                    if (i + 1 >= args.length || args[i + 1].startsWith("--") || args[i + 1].startsWith("-")) {
+                        isBooleanFlag = true;
+                    }
+                }
+
+                if (isBooleanFlag) {
+                    values.put(key, "true");
+                    i++;
+                } else {
+                    values.put(key, args[i + 1]);
+                    i += 2;
+                }
+            } else {
+                throw new IllegalArgumentException("Unexpected argument: " + token);
+            }
+        }
+
+        // Validate required options
+        List<String> missing = new ArrayList<String>();
+        for (OptionDef opt : options) {
+            if (opt.isRequired() && !values.containsKey(opt.getName())) {
+                missing.add(opt.getName());
+            }
+        }
+        if (!missing.isEmpty()) {
+            StringBuilder sb = new StringBuilder("Missing required option(s): ");
+            for (int j = 0; j < missing.size(); j++) {
+                if (j > 0) {
+                    sb.append(", ");
+                }
+                sb.append("--").append(missing.get(j));
+            }
+            throw new IllegalArgumentException(sb.toString());
+        }
+
+        return new ParsedOptions(values);
+    }
+
+    // ---- Help formatting ----------------------------------------------------
+
+    /**
+     * Formats a help text block for this command.
+     */
+    public String formatHelp() {
+        StringBuilder sb = new StringBuilder();
+        sb.append("Usage: wallet-cli ").append(name).append(" [options]\n\n");
+        sb.append(description).append("\n");
+
+        if (!aliases.isEmpty()) {
+            sb.append("\nAliases: ");
+            for (int i = 0; i < aliases.size(); i++) {
+                if (i > 0) {
+                    sb.append(", ");
+                }
+                sb.append(aliases.get(i));
+            }
+            sb.append("\n");
+        }
+
+        if (!options.isEmpty()) {
+            sb.append("\nOptions:\n");
+
+            // Calculate column width
+            int maxNameLen = 0;
+            for (OptionDef opt : options) {
+                int len = opt.getName().length() + 2; // "--" prefix
+                if (len > maxNameLen) {
+                    maxNameLen = len;
+                }
+            }
+
+            String fmt = "  %-" + (maxNameLen + 4) + "s %s%s\n";
+            for (OptionDef opt : options) {
+                String nameCol = "--" + opt.getName();
+                String reqMarker = opt.isRequired() ? " (required)" : "";
+                sb.append(String.format(fmt, nameCol, opt.getDescription(), reqMarker));
+            }
+        }
+
+        return sb.toString();
+    }
+
+    // ---- Builder ------------------------------------------------------------
+
+    public static Builder builder() {
+        return new Builder();
+    }
+
+    public static class Builder {
+        private String name;
+        private List<String> aliases = new ArrayList<String>();
+        private String description = "";
+        private List<OptionDef> options = new ArrayList<OptionDef>();
+        private CommandHandler handler;
+
+        private Builder() {
+        }
+
+        public Builder name(String name) {
+            this.name = name;
+            return this;
+        }
+
+        public Builder aliases(String... aliases) {
+            this.aliases = Arrays.asList(aliases);
+            return this;
+        }
+
+        public Builder description(String description) {
+            this.description = description;
+            return this;
+        }
+
+        public Builder option(String name, String desc, boolean required) {
+            this.options.add(new OptionDef(name, desc, required));
+            return this;
+        }
+
+        public Builder option(String name, String desc, boolean required, OptionDef.Type type) {
+            this.options.add(new OptionDef(name, desc, required, type));
+            return this;
+        }
+
+        public Builder handler(CommandHandler handler) {
+            this.handler = handler;
+            return this;
+        }
+
+        public CommandDefinition build() {
+            if (name == null || name.isEmpty()) {
+                throw new IllegalStateException("Command name is required");
+            }
+            if (handler == null) {
+                throw new IllegalStateException("Command handler is required");
+            }
+            return new CommandDefinition(this);
+        }
+    }
+}
diff --git a/src/main/java/org/tron/walletcli/cli/CommandHandler.java b/src/main/java/org/tron/walletcli/cli/CommandHandler.java
new file mode 100644
index 00000000..1cd609f3
--- /dev/null
+++ b/src/main/java/org/tron/walletcli/cli/CommandHandler.java
@@ -0,0 +1,20 @@
+package org.tron.walletcli.cli;
+
+import org.tron.walletcli.WalletApiWrapper;
+
+/**
+ * Functional interface for command execution logic.
+ */
+public interface CommandHandler {
+
+    /**
+     * Executes the command.
+     *
+     * @param opts    parsed command-line options
+     * @param wrapper wallet API wrapper for blockchain operations
+     * @param out     output formatter for writing results
+     * @throws Exception if execution fails
+     */
+    void execute(ParsedOptions opts, WalletApiWrapper wrapper, OutputFormatter out)
+            throws Exception;
+}
diff --git a/src/main/java/org/tron/walletcli/cli/CommandRegistry.java b/src/main/java/org/tron/walletcli/cli/CommandRegistry.java
new file mode 100644
index 00000000..e73f08be
--- /dev/null
+++ b/src/main/java/org/tron/walletcli/cli/CommandRegistry.java
@@ -0,0 +1,99 @@
+package org.tron.walletcli.cli;
+
+import java.util.ArrayList;
+import java.util.LinkedHashMap;
+import java.util.List;
+import java.util.Map;
+
+public class CommandRegistry {
+
+    private final Map<String, CommandDefinition> commands = new LinkedHashMap<String, CommandDefinition>();
+    private final Map<String, String> aliasToName = new LinkedHashMap<String, String>();
+
+    public void add(CommandDefinition cmd) {
+        commands.put(cmd.getName(), cmd);
+        aliasToName.put(cmd.getName(), cmd.getName());
+        for (String alias : cmd.getAliases()) {
+            aliasToName.put(alias.toLowerCase(), cmd.getName());
+        }
+    }
+
+    public CommandDefinition lookup(String nameOrAlias) {
+        String normalized = nameOrAlias.toLowerCase();
+        String primaryName = aliasToName.get(normalized);
+        if (primaryName == null) return null;
+        return commands.get(primaryName);
+    }
+
+    public List<CommandDefinition> getAllCommands() {
+        return new ArrayList<CommandDefinition>(commands.values());
+    }
+
+    public List<String> getAllNames() {
+        return new ArrayList<String>(commands.keySet());
+    }
+
+    public int size() {
+        return commands.size();
+    }
+
+    public String formatGlobalHelp(String version) {
+        StringBuilder sb = new StringBuilder();
+        sb.append("TRON Wallet CLI").append(version).append("\n\n");
+        sb.append("Usage:\n");
+        sb.append("  wallet-cli [global options] <command> [command options]\n");
+        sb.append("  wallet-cli --interactive    Launch interactive REPL\n");
+        sb.append("  wallet-cli --help           Show this help\n");
+        sb.append("  wallet-cli <command> --help  Show command help\n\n");
+        sb.append("Global Options:\n");
+        sb.append("  --output <text|json>         Output format (default: text)\n");
+        sb.append("  --network <main|nile|shasta|custom> Network selection\n");
+        sb.append("  --wallet <name|path>         Select wallet file\n");
+        sb.append("  --grpc-endpoint <host:port>  Custom gRPC endpoint\n");
+        sb.append("  --quiet                      Suppress non-essential output\n");
+        sb.append("  --verbose                    Debug logging\n\n");
+        sb.append("Commands:\n");
+
+        int maxLen = 0;
+        for (CommandDefinition cmd : commands.values()) {
+            maxLen = Math.max(maxLen, cmd.getName().length());
+        }
+        String fmt = "  %-" + (maxLen + 2) + "s %s\n";
+        for (CommandDefinition cmd : commands.values()) {
+            sb.append(String.format(fmt, cmd.getName(), cmd.getDescription()));
+        }
+        sb.append("\nUse \"wallet-cli <command> --help\" for more information about a command.\n");
+        return sb.toString();
+    }
+
+    /** Find similar command names for "did you mean?" suggestions. */
+    public String suggest(String input) {
+        String normalized = input.toLowerCase();
+        int bestDist = Integer.MAX_VALUE;
+        String bestMatch = null;
+        for (String name : aliasToName.keySet()) {
+            int dist = levenshtein(normalized, name);
+            if (dist < bestDist && dist <= 3) {
+                bestDist = dist;
+                bestMatch = name;
+            }
+        }
+        return bestMatch;
+    }
+
+    private static int levenshtein(String a, String b) {
+        int[][] dp = new int[a.length() + 1][b.length() + 1];
+        for (int i = 0; i <= a.length(); i++) dp[i][0] = i;
+        for (int j = 0; j <= b.length(); j++) dp[0][j] = j;
+        for (int i = 1; i <= a.length(); i++) {
+            for (int j = 1; j <= b.length(); j++) {
+                int cost = a.charAt(i - 1) == b.charAt(j - 1) ? 0 : 1;
+                dp[i][j] = Math.min(Math.min(
+                        dp[i - 1][j] + 1,
+                        dp[i][j - 1] + 1),
+                        dp[i - 1][j - 1] + cost);
+            }
+        }
+        return dp[a.length()][b.length()];
+    }
+}
diff --git a/src/main/java/org/tron/walletcli/cli/GlobalOptions.java b/src/main/java/org/tron/walletcli/cli/GlobalOptions.java
new file mode 100644
index 00000000..03e303b1
--- /dev/null
+++ b/src/main/java/org/tron/walletcli/cli/GlobalOptions.java
@@ -0,0 +1,110 @@
+package org.tron.walletcli.cli;
+
+import java.util.ArrayList;
+import java.util.List;
+
+public class GlobalOptions {
+
+    private boolean interactive = false;
+    private boolean help = false;
+    private boolean version = false;
+    private String output = "text";
+    private String network = null;
+    private String wallet = null;
+    private String grpcEndpoint = null;
+    private boolean quiet = false;
+    private boolean verbose = false;
+    private String command = null;
+    private String[] commandArgs = new String[0];
+
+    public boolean isInteractive() { return interactive; }
+    public boolean isHelp() { return help; }
+    public boolean isVersion() { return version; }
+    public String getOutput() { return output; }
+    public String getNetwork() { return network; }
+    public String getWallet() { return wallet; }
+    public String getGrpcEndpoint() { return grpcEndpoint; }
+    public boolean isQuiet() { return quiet; }
+    public boolean isVerbose() { return verbose; }
+    public String getCommand() { return command; }
+    public String[] getCommandArgs() { return commandArgs; }
+
+    public OutputFormatter.OutputMode getOutputMode() {
+        return "json".equalsIgnoreCase(output)
+                ? OutputFormatter.OutputMode.JSON
+                : OutputFormatter.OutputMode.TEXT;
+    }
+
+    public static GlobalOptions parse(String[] args) {
+        GlobalOptions opts = new GlobalOptions();
+        List<String> remaining = new ArrayList<String>();
+        boolean commandFound = false;
+
+        for (int i = 0; i < args.length; i++) {
+            if (commandFound) {
+                remaining.add(args[i]);
+                continue;
+            }
+            switch (args[i]) {
+                case "--interactive":
+                    opts.interactive = true;
+                    break;
+                case "--help":
+                case "-h":
+                    opts.help = true;
+                    break;
+                case "--version":
+                    opts.version = true;
+                    break;
+                case "--output":
+                    opts.output = requireOneOf(args, ++i, "--output", "text", "json");
+                    break;
+                case "--network":
+                    opts.network = requireOneOf(args, ++i, "--network", "main", "nile", "shasta", "custom");
+                    break;
+                case "--wallet":
+                    opts.wallet = requireValue(args, ++i, "--wallet");
+                    break;
+                case "--grpc-endpoint":
+                    opts.grpcEndpoint = requireValue(args, ++i, "--grpc-endpoint");
+                    break;
+                case "--quiet":
+                    opts.quiet = true;
+                    break;
+                case "--verbose":
+                    opts.verbose = true;
+                    break;
+                default:
+                    if (!args[i].startsWith("--")) {
+                        opts.command = args[i].toLowerCase();
+                        commandFound = true;
+                    } else {
+                        // Unknown global flag — treat as start of command args
+                        remaining.add(args[i]);
+                        commandFound = true;
+                    }
+                    break;
+            }
+        }
+        opts.commandArgs = remaining.toArray(new String[0]);
+        return opts;
+    }
+
+    private static String requireValue(String[] args, int valueIndex, String optionName) {
+        if (valueIndex >= args.length || args[valueIndex].startsWith("--")) {
+            throw new IllegalArgumentException("Missing value for " + optionName);
+        }
+        return args[valueIndex];
+    }
+
+    private static String requireOneOf(String[] args, int valueIndex, String optionName,
+                                       String... allowedValues) {
+        String value = requireValue(args, valueIndex, optionName);
+        for (String allowedValue : allowedValues) {
+            if (allowedValue.equalsIgnoreCase(value)) {
+                return allowedValue;
+            }
+        }
+        throw new IllegalArgumentException("Invalid value for " + optionName + ": " + value);
+    }
+}
diff --git a/src/main/java/org/tron/walletcli/cli/OptionDef.java b/src/main/java/org/tron/walletcli/cli/OptionDef.java
new file mode 100644
index 00000000..fed770c1
--- /dev/null
+++ b/src/main/java/org/tron/walletcli/cli/OptionDef.java
@@ -0,0 +1,47 @@
+package org.tron.walletcli.cli;
+
+/**
+ * Defines a single command-line option: its name, description, whether it is
+ * required, and the expected value type.
+ */
+public class OptionDef {
+
+    public enum Type {
+        STRING,
+        LONG,
+        BOOLEAN,
+        ADDRESS
+    }
+
+    private final String name;
+    private final String description;
+    private final boolean required;
+    private final Type type;
+
+    public OptionDef(String name, String description, boolean required, Type type) {
+        this.name = name;
+        this.description = description;
+        this.required = required;
+        this.type = type;
+    }
+
+    public OptionDef(String name, String description, boolean required) {
+        this(name, description, required, Type.STRING);
+    }
+
+    public String getName() {
+        return name;
+    }
+
+    public String getDescription() {
+        return description;
+    }
+
+    public boolean isRequired() {
+        return required;
+    }
+
+    public Type getType() {
+        return type;
+    }
+}
diff --git a/src/main/java/org/tron/walletcli/cli/OutputFormatter.java b/src/main/java/org/tron/walletcli/cli/OutputFormatter.java
new file mode 100644
index 00000000..70485411
--- /dev/null
+++ b/src/main/java/org/tron/walletcli/cli/OutputFormatter.java
@@ -0,0 +1,188 @@
+package org.tron.walletcli.cli;
+
+import com.google.gson.Gson;
+import com.google.gson.GsonBuilder;
+import com.google.gson.JsonElement;
+import com.google.gson.JsonParser;
+import com.google.protobuf.Message;
+
+import java.io.PrintStream;
+import java.util.LinkedHashMap;
+import java.util.Map;
+
+public class OutputFormatter {
+
+    public enum OutputMode { TEXT, JSON }
+
+    private final OutputMode mode;
+    private final boolean quiet;
+    private PrintStream out;
+    private PrintStream err;
+    private static final Gson gson = new GsonBuilder().setPrettyPrinting().create();
+
+    public OutputFormatter(OutputMode mode, boolean quiet) {
+        this.mode = mode;
+        this.quiet = quiet;
+        this.out = System.out;
+        this.err = System.err;
+    }
+
+    /** Capture the real stdout/stderr before System.out is redirected. */
+    public void captureStreams() {
+        this.out = System.out;
+        this.err = System.err;
+    }
+
+    public OutputMode getMode() {
+        return mode;
+    }
+
+    private void abortExecution() {
+        throw new CliAbortException(CliAbortException.Kind.EXECUTION);
+    }
+
+    private void abortUsage() {
+        throw new CliAbortException(CliAbortException.Kind.USAGE);
+    }
+
+    private void emitJsonSuccess(Object data) {
+        Map<String, Object> envelope = new LinkedHashMap<String, Object>();
+        envelope.put("success", true);
+        envelope.put("data", data != null ? data : new LinkedHashMap<String, Object>());
+        out.println(gson.toJson(envelope));
+    }
+
+    private void emitJsonError(String code, String message) {
+        Map<String, Object> envelope = new LinkedHashMap<String, Object>();
+        envelope.put("success", false);
+        envelope.put("error", code);
+        envelope.put("message", message);
+        out.println(gson.toJson(envelope));
+    }
+
+    private Map<String, Object> wrapMessage(String text) {
+        Map<String, Object> data = new LinkedHashMap<String, Object>();
+        data.put("message", text);
+        return data;
+    }
+
+    private Object normalizeJsonData(Object payload) {
+        if (payload == null) {
+            return new LinkedHashMap<String, Object>();
+        }
+        if (payload instanceof JsonElement || payload instanceof Map) {
+            return payload;
+        }
+
+        String text = String.valueOf(payload);
+        try {
+            return JsonParser.parseString(text);
+        } catch (Exception e) {
+            return wrapMessage(text);
+        }
+    }
+
+    /** Print a successful result with a text message and optional JSON data. */
+    public void success(String textMessage, Map<String, Object> jsonData) {
+        if (mode == OutputMode.JSON) {
+            emitJsonSuccess(jsonData != null ? jsonData : new LinkedHashMap<String, Object>());
+        } else {
+            out.println(textMessage);
+        }
+    }
+
+    /** Print a simple success/failure result. */
+    public void result(boolean success, String successMsg, String failMsg) {
+        if (mode == OutputMode.JSON) {
+            if (success) {
+                emitJsonSuccess(wrapMessage(successMsg));
+            } else {
+                emitJsonError("operation_failed", failMsg);
+            }
+        } else {
+            out.println(success ? successMsg : failMsg);
+        }
+        if (!success) {
+            abortExecution();
+        }
+    }
+
+    /** Print a protobuf message. Uses Utils.formatMessageString which decodes
+     *  addresses to Base58 and bytes to readable strings for both modes. */
+    public void protobuf(Message message, String failMsg) {
+        if (message == null) {
+            error("not_found", failMsg);
+            return;
+        }
+        String formatted = org.tron.common.utils.Utils.formatMessageString(message);
+        if (mode == OutputMode.JSON) {
+            emitJsonSuccess(normalizeJsonData(formatted));
+        } else {
+            out.println(formatted);
+        }
+    }
+
+    /** Print a message object (trident Response types or pre-formatted strings). */
+    public void printMessage(Object message, String failMsg) {
+        if (message == null) {
+            error("not_found", failMsg);
+            return;
+        }
+        if (mode == OutputMode.JSON) {
+            emitJsonSuccess(normalizeJsonData(message));
+        } else {
+            out.println(message);
+        }
+    }
+
+    /** Print raw text. */
+    public void raw(String text) {
+        if (mode == OutputMode.JSON) {
+            emitJsonSuccess(wrapMessage(text));
+        } else {
+            out.println(text);
+        }
+    }
+
+    /** Print a key-value pair. */
+    public void keyValue(String key, Object value) {
+        if (mode == OutputMode.JSON) {
+            Map<String, Object> data = new LinkedHashMap<String, Object>();
+            data.put(key, value);
+            emitJsonSuccess(data);
+        } else {
+            out.println(key + " = " + value);
+        }
+    }
+
+    /** Print an error and signal exit code 1. */
+    public void error(String code, String message) {
+        if (mode == OutputMode.JSON) {
+            emitJsonError(code, message);
+        } else {
+            out.println("Error: " + message);
+        }
+        abortExecution();
+    }
+
+    /** Print an error for usage mistakes and signal exit code 2. */
+    public void usageError(String message, CommandDefinition cmd) {
+        if (mode == OutputMode.JSON) {
+            emitJsonError("usage_error", message);
+        } else {
+            out.println("Error: " + message);
+            if (cmd != null) {
+                out.println();
+                out.println(cmd.formatHelp());
+            }
+        }
+        abortUsage();
+    }
+
+    /** Print info to stderr (suppressed in quiet mode and JSON mode). */
+    public void info(String message) {
+        if (!quiet && mode != OutputMode.JSON) {
+            err.println(message);
+        }
+    }
+}
diff --git a/src/main/java/org/tron/walletcli/cli/ParsedOptions.java b/src/main/java/org/tron/walletcli/cli/ParsedOptions.java
new file mode 100644
index 00000000..e61c1172
--- /dev/null
+++ b/src/main/java/org/tron/walletcli/cli/ParsedOptions.java
@@ -0,0 +1,85 @@
+package org.tron.walletcli.cli;
+
+import org.tron.walletserver.WalletApi;
+
+import java.util.Collections;
+import java.util.LinkedHashMap;
+import java.util.Map;
+
+/**
+ * Holds the parsed key-value pairs produced by {@link CommandDefinition#parseArgs}
+ * and provides typed accessors.
+ */
+public class ParsedOptions {
+
+    private final Map<String, String> values;
+
+    public ParsedOptions(Map<String, String> values) {
+        this.values = values == null
+                ? Collections.<String, String>emptyMap()
+                : new LinkedHashMap<String, String>(values);
+    }
+
+    /** Returns {@code true} if the option was supplied on the command line. */
+    public boolean has(String key) {
+        return values.containsKey(key);
+    }
+
+    /** Returns the raw string value, or {@code null} if absent. */
+    public String getString(String key) {
+        return values.get(key);
+    }
+
+    /**
+     * Returns the value parsed as a {@code long}.
+     *
+     * @throws IllegalArgumentException if the key is absent or not a valid long
+     */
+    public long getLong(String key) {
+        String raw = values.get(key);
+        if (raw == null) {
+            throw new IllegalArgumentException("Missing required option: --" + key);
+        }
+        try {
+            return Long.parseLong(raw);
+        } catch (NumberFormatException e) {
+            throw new IllegalArgumentException(
+                    "Option --" + key + " requires a numeric value, got: " + raw);
+        }
+    }
+
+    /**
+     * Returns the value parsed as a boolean.  Absent keys default to {@code false}.
+     */
+    public boolean getBoolean(String key) {
+        String raw = values.get(key);
+        if (raw == null) {
+            return false;
+        }
+        return "true".equalsIgnoreCase(raw) || "1".equals(raw) || "yes".equalsIgnoreCase(raw);
+    }
+
+    /**
+     * Decodes a Base58Check TRON address.
+     *
+     * @return the decoded address bytes
+     * @throws IllegalArgumentException if the key is absent or the address is invalid
+     */
+    public byte[] getAddress(String key) {
+        String raw = values.get(key);
+        if (raw == null) {
+            throw new IllegalArgumentException("Missing required option: --" + key);
+        }
+        byte[] decoded = WalletApi.decodeFromBase58Check(raw);
+        if (decoded == null) {
+            throw new IllegalArgumentException(
+                    "Invalid TRON address for --" + key + ": " + raw);
+        }
+        return decoded;
+    }
+
+    /** Returns an unmodifiable view of all parsed values. */
+    public Map<String, String> asMap() {
+        return Collections.unmodifiableMap(values);
+    }
+}
diff --git a/src/main/java/org/tron/walletcli/cli/StandardCliRunner.java b/src/main/java/org/tron/walletcli/cli/StandardCliRunner.java
new file mode 100644
index 00000000..0f2e0fd9
--- /dev/null
+++ b/src/main/java/org/tron/walletcli/cli/StandardCliRunner.java
@@ -0,0 +1,202 @@
+package org.tron.walletcli.cli;
+
+import org.tron.common.enums.NetType;
+import org.tron.keystore.StringUtils;
+import org.tron.keystore.WalletFile;
+import org.tron.keystore.WalletUtils;
+import org.tron.walletcli.WalletApiWrapper;
+import org.tron.walletserver.WalletApi;
+
+import java.io.ByteArrayInputStream;
+import java.io.File;
+import java.io.InputStream;
+import java.io.OutputStream;
+import java.io.PrintStream;
+import java.util.Arrays;
+
+public class StandardCliRunner {
+
+    private final CommandRegistry registry;
+    private final GlobalOptions globalOpts;
+    private final OutputFormatter formatter;
+
+    public StandardCliRunner(CommandRegistry registry, GlobalOptions globalOpts) {
+        this.registry = registry;
+        this.globalOpts = globalOpts;
+        this.formatter = new OutputFormatter(globalOpts.getOutputMode(), globalOpts.isQuiet());
+    }
+
+    public int execute() {
+        // In standard CLI mode, auto-confirm interactive prompts by feeding
+        // answers into System.in:
+        //   "y\n"  — permission id confirmation (default 0)
+        //   "1\n"  — wallet file selection (choose first)
+        //   "y\n"  — additional signing confirmations
+        // Repeated to cover multiple rounds of signing prompts.
+        String autoInput = "y\n1\ny\ny\n1\ny\ny\n1\ny\ny\n";
+        InputStream originalIn = System.in;
+        System.setIn(new ByteArrayInputStream(autoInput.getBytes()));
+
+        // In JSON mode, suppress all stray System.out/err prints from the entire
+        // execution (network init, authentication, command execution) so only
+        // OutputFormatter JSON output appears.
+        boolean jsonMode = globalOpts.getOutputMode() == OutputFormatter.OutputMode.JSON;
+        PrintStream realOut = System.out;
+        PrintStream realErr = System.err;
+        if (jsonMode) {
+            formatter.captureStreams();
+            PrintStream nullStream = new PrintStream(new OutputStream() {
+                @Override public void write(int b) { }
+                @Override public void write(byte[] b, int off, int len) { }
+            });
+            System.setOut(nullStream);
+            System.setErr(nullStream);
+        }
+
+        try {
+            return executeInternal(realOut);
+        } catch (CliAbortException e) {
+            return e.getKind() == CliAbortException.Kind.USAGE ? 2 : 1;
+        } finally {
+            System.setIn(originalIn);
+            if (jsonMode) {
+                System.setOut(realOut);
+                System.setErr(realErr);
+            }
+        }
+    }
+
+    private int executeInternal(PrintStream realOut) {
+        try {
+            // Apply network setting
+            if (globalOpts.getNetwork() != null) {
+                applyNetwork(globalOpts.getNetwork());
+            }
+
+            // Lookup command
+            String cmdName = globalOpts.getCommand();
+            CommandDefinition cmd = registry.lookup(cmdName);
+            if (cmd == null) {
+                String suggestion = registry.suggest(cmdName);
+                String msg = "Unknown command: " + cmdName;
+                if (suggestion != null) {
+                    msg += ". Did you mean: " + suggestion + "?";
+                }
+                formatter.usageError(msg, null);
+                return 2; // unreachable after usageError()
+            }
+
+            // Check for per-command --help (always print to real stdout)
+            String[] cmdArgs = globalOpts.getCommandArgs();
+            for (String arg : cmdArgs) {
+                if ("--help".equals(arg) || "-h".equals(arg)) {
+                    realOut.println(cmd.formatHelp());
+                    return 0;
+                }
+            }
+
+            // Parse command options
+            ParsedOptions opts;
+            try {
+                opts = cmd.parseArgs(cmdArgs);
+            } catch (IllegalArgumentException e) {
+                formatter.usageError(e.getMessage(), cmd);
+                return 2; // unreachable after usageError()
+            }
+
+            // Create wrapper and authenticate
+            WalletApiWrapper wrapper = new WalletApiWrapper();
+            authenticate(wrapper);
+
+            // Execute command
+            cmd.getHandler().execute(opts, wrapper, formatter);
+            return 0;
+
+        } catch (CliAbortException e) {
+            throw e;
+        } catch (IllegalArgumentException e) {
+            formatter.usageError(e.getMessage(), null);
+            return 2; // unreachable after usageError()
+        } catch (Exception e) {
+            formatter.error("execution_error",
+                    e.getMessage() != null ? e.getMessage() : e.getClass().getSimpleName());
+            return 1; // unreachable after error()
+        }
+    }
+
+    /**
+     * Auto-login from keystore using the active wallet config.
+     * Falls back to the first wallet if no active wallet is set.
+     * Users must first run import-wallet or register-wallet to create a keystore.
+     */
+    private void authenticate(WalletApiWrapper wrapper) throws Exception {
+        File walletDir = new File("Wallet");
+        if (!walletDir.exists() || !walletDir.isDirectory()) {
+            return; // No wallet — commands that need auth will fail gracefully
+        }
+        File[] files = walletDir.listFiles((dir, name) -> name.endsWith(".json"));
+        if (files == null || files.length == 0) {
+            return; // No keystore files
+        }
+
+        String envPwd = System.getenv("MASTER_PASSWORD");
+        if (envPwd == null || envPwd.isEmpty()) {
+            return; // No password — can't auto-login
+        }
+
+        // Find the wallet file to load: active wallet or fallback to first
+        File targetFile = null;
+        String activeAddress = ActiveWalletConfig.getActiveAddress();
+        if (activeAddress != null) {
+            targetFile = ActiveWalletConfig.findWalletFileByAddress(activeAddress);
+        }
+        if (targetFile == null && files.length > 0) {
+            targetFile = files[0]; // Fallback to first wallet
+        }
+        if (targetFile == null) {
+            return;
+        }
+
+        // Load specific wallet file and authenticate
+        byte[] password = StringUtils.char2Byte(envPwd.toCharArray());
+        try {
+            WalletFile wf = WalletUtils.loadWalletFile(targetFile);
+            wf.setSourceFile(targetFile);
+            if (wf.getName() == null || wf.getName().isEmpty()) {
+                wf.setName(targetFile.getName());
+            }
+            WalletApi walletApi = new WalletApi(wf);
+            walletApi.checkPassword(password);
+            walletApi.setLogin(null);
+            walletApi.setUnifiedPassword(password);
+            wrapper.setWallet(walletApi);
+            formatter.info("Authenticated with wallet: " + wf.getAddress());
+        } finally {
+            Arrays.fill(password, (byte) 0);
+        }
+    }
+
+    private void applyNetwork(String network) {
+        switch (network.toLowerCase()) {
+            case "main":
+                WalletApi.setCurrentNetwork(NetType.MAIN);
+                WalletApi.setApiCli(WalletApi.initApiCli());
+                break;
+            case "nile":
+                WalletApi.setCurrentNetwork(NetType.NILE);
+                WalletApi.setApiCli(WalletApi.initApiCli());
+                break;
+            case "shasta":
+                WalletApi.setCurrentNetwork(NetType.SHASTA);
+                WalletApi.setApiCli(WalletApi.initApiCli());
+                break;
+            case "custom":
+                WalletApi.setCurrentNetwork(NetType.CUSTOM);
+                WalletApi.setApiCli(WalletApi.initApiCli());
+                break;
+            default:
+                formatter.usageError("Unknown network: " + network
+                        + ". Use: main, nile, shasta, custom", null);
+        }
+    }
+}
diff --git a/src/main/java/org/tron/walletcli/cli/commands/ContractCommands.java b/src/main/java/org/tron/walletcli/cli/commands/ContractCommands.java
new file mode 100644
index 00000000..f0fa129d
--- /dev/null
+++ b/src/main/java/org/tron/walletcli/cli/commands/ContractCommands.java
@@ -0,0 +1,229 @@
+package org.tron.walletcli.cli.commands;
+
+import org.tron.common.utils.AbiUtil;
+import org.tron.common.utils.ByteArray;
+import org.tron.common.utils.TransactionUtils;
+import org.tron.walletcli.cli.CommandDefinition;
+import org.tron.walletcli.cli.CommandRegistry;
+import org.tron.walletcli.cli.OptionDef;
+
+public class ContractCommands {
+
+    public static void register(CommandRegistry registry) {
+        registerDeployContract(registry);
+        registerTriggerContract(registry);
+        registerTriggerConstantContract(registry);
+        registerEstimateEnergy(registry);
+        registerClearContractABI(registry);
+        registerUpdateSetting(registry);
+        registerUpdateEnergyLimit(registry);
+    }
+
+    private static void registerDeployContract(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("deploy-contract")
+                .aliases("deploycontract")
+                .description("Deploy a smart contract")
+                .option("name", "Contract name", true)
+                .option("abi", "Contract ABI JSON string", true)
+                .option("bytecode", "Contract bytecode hex", true)
+                .option("constructor", "Constructor signature (optional)", false)
+                .option("params", "Constructor parameters (optional)", false)
+                .option("fee-limit", "Fee limit in SUN", true, OptionDef.Type.LONG)
+                .option("consume-user-resource-percent", "Consume user resource percent (0-100)", false, OptionDef.Type.LONG)
+                .option("origin-energy-limit", "Origin energy limit", false, OptionDef.Type.LONG)
+                .option("value", "Call value in SUN (default: 0)", false, OptionDef.Type.LONG)
+                .option("token-value", "Token value (default: 0)", false, OptionDef.Type.LONG)
+                .option("token-id", "Token ID", false)
+                .option("library", "Library address pair (libName:address)", false)
+                .option("compiler-version", "Compiler version", false)
+                .option("owner", "Owner address", false)
+                .option("multi", "Multi-signature mode", false, OptionDef.Type.BOOLEAN)
+                .handler((opts, wrapper, out) -> {
+                    byte[] owner = opts.has("owner") ? opts.getAddress("owner") : null;
+                    String name = opts.getString("name");
+                    String abi = opts.getString("abi");
+                    String bytecode = opts.getString("bytecode");
+                    long feeLimit = opts.getLong("fee-limit");
+                    long value = opts.has("value") ? opts.getLong("value") : 0;
+                    long consumePercent = opts.has("consume-user-resource-percent")
+                            ? opts.getLong("consume-user-resource-percent") : 0;
+                    long originEnergyLimit = opts.has("origin-energy-limit")
+                            ? opts.getLong("origin-energy-limit") : 1;
+                    long tokenValue = opts.has("token-value") ? opts.getLong("token-value") : 0;
+                    String tokenId = opts.has("token-id") ? opts.getString("token-id") : "";
+                    if ("#".equals(tokenId)) {
+                        tokenId = "";
+                    }
+                    String library = opts.has("library") ? opts.getString("library") : null;
+                    String compilerVersion = opts.has("compiler-version")
+                            ? opts.getString("compiler-version") : null;
+                    boolean multi = opts.getBoolean("multi");
+
+                    // If constructor + params provided, append encoded params to bytecode
+                    String codeStr = bytecode;
+                    if (opts.has("constructor") && opts.has("params")) {
+                        String encodedParams = AbiUtil.parseMethod(
+                                opts.getString("constructor"), opts.getString("params"), true);
+                        // parseMethod with isHex=true returns just the encoded params without selector
+                        codeStr = bytecode + encodedParams;
+                    }
+
+                    boolean result = wrapper.deployContract(owner, name, abi, codeStr,
+                            feeLimit, value, consumePercent, originEnergyLimit,
+                            tokenValue, tokenId, library, compilerVersion, multi);
+                    out.result(result, "DeployContract successful !!", "DeployContract failed !!");
+                })
+                .build());
+    }
+
+    private static void registerTriggerContract(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("trigger-contract")
+                .aliases("triggercontract")
+                .description("Trigger a smart contract function")
+                .option("contract", "Contract address", true)
+                .option("method", "Method signature (e.g. transfer(address,uint256))", true)
+                .option("params", "Method parameters", false)
+                .option("fee-limit", "Fee limit in SUN", true, OptionDef.Type.LONG)
+                .option("value", "Call value in SUN (default: 0)", false, OptionDef.Type.LONG)
+                .option("token-value", "Token value (default: 0)", false, OptionDef.Type.LONG)
+                .option("token-id", "Token ID", false)
+                .option("owner", "Caller address", false)
+                .option("permission-id", "Permission ID for signing (default: 0)", false, OptionDef.Type.LONG)
+                .option("multi", "Multi-signature mode", false, OptionDef.Type.BOOLEAN)
+                .handler((opts, wrapper, out) -> {
+                    byte[] owner = opts.has("owner") ? opts.getAddress("owner") : null;
+                    byte[] contractAddress = opts.getAddress("contract");
+                    String method = opts.getString("method");
+                    String params = opts.has("params") ? opts.getString("params") : "";
+                    long feeLimit = opts.getLong("fee-limit");
+                    long callValue = opts.has("value") ? opts.getLong("value") : 0;
+                    long tokenValue = opts.has("token-value") ? opts.getLong("token-value") : 0;
+                    String tokenId = opts.has("token-id") ? opts.getString("token-id") : "";
+                    int permissionId = opts.has("permission-id") ? (int) opts.getLong("permission-id") : 0;
+                    boolean multi = opts.getBoolean("multi");
+
+                    byte[] data = ByteArray.fromHexString(AbiUtil.parseMethod(method, params, false));
+                    TransactionUtils.setPermissionIdOverride(permissionId);
+                    org.apache.commons.lang3.tuple.Triple<Boolean, Long, Long> result;
+                    try {
+                        result = wrapper.callContract(owner, contractAddress, callValue, data,
+                                feeLimit, tokenValue, tokenId, false, true, multi);
+                    } finally {
+                        TransactionUtils.clearPermissionIdOverride();
+                    }
+                    out.result(Boolean.TRUE.equals(result.getLeft()),
+                            "TriggerContract successful !!", "TriggerContract failed !!");
+                })
+                .build());
+    }
+
+    private static void registerTriggerConstantContract(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("trigger-constant-contract")
+                .aliases("triggerconstantcontract")
+                .description("Call a constant (view/pure) contract function")
+                .option("contract", "Contract address", true)
+                .option("method", "Method signature", true)
+                .option("params", "Method parameters", false)
+                .option("owner", "Caller address", false)
+                .handler((opts, wrapper, out) -> {
+                    byte[] owner = opts.has("owner") ? opts.getAddress("owner") : null;
+                    byte[] contractAddress = opts.getAddress("contract");
+                    String method = opts.getString("method");
+                    String params = opts.has("params") ? opts.getString("params") : "";
+
+                    byte[] data = ByteArray.fromHexString(AbiUtil.parseMethod(method, params, false));
+                    wrapper.callContract(owner, contractAddress, 0, data, 0, 0, "", true, true, false);
+                })
+                .build());
+    }
+
+    private static void registerEstimateEnergy(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("estimate-energy")
+                .aliases("estimateenergy")
+                .description("Estimate energy for a contract call")
+                .option("contract", "Contract address", true)
+                .option("method", "Method signature", true)
+                .option("params", "Method parameters", false)
+                .option("value", "Call value (default: 0)", false, OptionDef.Type.LONG)
+                .option("token-value", "Token value (default: 0)", false, OptionDef.Type.LONG)
+                .option("token-id", "Token ID", false)
+                .option("owner", "Caller address", false)
+                .handler((opts, wrapper, out) -> {
+                    byte[] owner = opts.has("owner") ? opts.getAddress("owner") : null;
+                    byte[] contractAddress = opts.getAddress("contract");
+                    String method = opts.getString("method");
+                    String params = opts.has("params") ? opts.getString("params") : "";
+                    long callValue = opts.has("value") ? opts.getLong("value") : 0;
+                    long tokenValue = opts.has("token-value") ? opts.getLong("token-value") : 0;
+                    String tokenId = opts.has("token-id") ? opts.getString("token-id") : "";
+
+                    byte[] data = ByteArray.fromHexString(AbiUtil.parseMethod(method, params, false));
+                    boolean result = wrapper.estimateEnergy(owner, contractAddress, callValue,
+                            data, tokenValue, tokenId);
+                    out.result(result, "EstimateEnergy successful !!", "EstimateEnergy failed !!");
+                })
+                .build());
+    }
+
+    private static void registerClearContractABI(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("clear-contract-abi")
+                .aliases("clearcontractabi")
+                .description("Clear a contract's ABI")
+                .option("contract", "Contract address", true)
+                .option("owner", "Owner address", false)
+                .option("multi", "Multi-signature mode", false, OptionDef.Type.BOOLEAN)
+                .handler((opts, wrapper, out) -> {
+                    byte[] owner = opts.has("owner") ? opts.getAddress("owner") : null;
+                    byte[] contractAddress = opts.getAddress("contract");
+                    boolean multi = opts.getBoolean("multi");
+                    boolean result = wrapper.clearContractABI(owner, contractAddress, multi);
+                    out.result(result, "ClearContractABI successful !!", "ClearContractABI failed !!");
+                })
+                .build());
+    }
+
+    private static void registerUpdateSetting(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("update-setting")
+                .aliases("updatesetting")
+                .description("Update contract consume_user_resource_percent")
+                .option("contract", "Contract address", true)
+                .option("consume-user-resource-percent", "New percentage (0-100)", true, OptionDef.Type.LONG)
+                .option("owner", "Owner address", false)
+                .option("multi", "Multi-signature mode", false, OptionDef.Type.BOOLEAN)
+                .handler((opts, wrapper, out) -> {
+                    byte[] owner = opts.has("owner") ? opts.getAddress("owner") : null;
+                    byte[] contractAddress = opts.getAddress("contract");
+                    long percent = opts.getLong("consume-user-resource-percent");
+                    boolean multi = opts.getBoolean("multi");
+                    boolean result = wrapper.updateSetting(owner, contractAddress, percent, multi);
+                    out.result(result, "UpdateSetting successful !!", "UpdateSetting failed !!");
+                })
+                .build());
+    }
+
+    private static void registerUpdateEnergyLimit(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("update-energy-limit")
+                .aliases("updateenergylimit")
+                .description("Update contract origin_energy_limit")
+                .option("contract", "Contract address", true)
+                .option("origin-energy-limit", "New origin energy limit", true, OptionDef.Type.LONG)
+                .option("owner", "Owner address", false)
+                .option("multi", "Multi-signature mode", false, OptionDef.Type.BOOLEAN)
+                .handler((opts, wrapper, out) -> {
+                    byte[] owner = opts.has("owner") ? opts.getAddress("owner") : null;
+                    byte[] contractAddress = opts.getAddress("contract");
+                    long limit = opts.getLong("origin-energy-limit");
+                    boolean multi = opts.getBoolean("multi");
+                    boolean result = wrapper.updateEnergyLimit(owner, contractAddress, limit, multi);
+                    out.result(result, "UpdateEnergyLimit successful !!", "UpdateEnergyLimit failed !!");
+                })
+                .build());
+    }
+}
diff --git a/src/main/java/org/tron/walletcli/cli/commands/ExchangeCommands.java b/src/main/java/org/tron/walletcli/cli/commands/ExchangeCommands.java
new file mode 100644
index 00000000..50f089fa
--- /dev/null
+++ b/src/main/java/org/tron/walletcli/cli/commands/ExchangeCommands.java
@@ -0,0 +1,158 @@
+package org.tron.walletcli.cli.commands;
+
+import org.tron.walletcli.cli.CommandDefinition;
+import org.tron.walletcli.cli.CommandRegistry;
+import org.tron.walletcli.cli.OptionDef;
+
+public class ExchangeCommands {
+
+    public static void register(CommandRegistry registry) {
+        registerExchangeCreate(registry);
+        registerExchangeInject(registry);
+        registerExchangeWithdraw(registry);
+        registerExchangeTransaction(registry);
+        registerMarketSellAsset(registry);
+        registerMarketCancelOrder(registry);
+    }
+
+    private static void registerExchangeCreate(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("exchange-create")
+                .aliases("exchangecreate")
+                .description("Create a Bancor exchange pair")
+                .option("first-token", "First token ID (use _ for TRX)", true)
+                .option("first-balance", "First token balance", true, OptionDef.Type.LONG)
+                .option("second-token", "Second token ID", true)
+                .option("second-balance", "Second token balance", true, OptionDef.Type.LONG)
+                .option("owner", "Owner address", false)
+                .option("multi", "Multi-signature mode", false, OptionDef.Type.BOOLEAN)
+                .handler((opts, wrapper, out) -> {
+                    byte[] owner = opts.has("owner") ? opts.getAddress("owner") : null;
+                    byte[] firstToken = opts.getString("first-token").getBytes();
+                    long firstBalance = opts.getLong("first-balance");
+                    byte[] secondToken = opts.getString("second-token").getBytes();
+                    long secondBalance = opts.getLong("second-balance");
+                    boolean multi = opts.getBoolean("multi");
+                    boolean result = wrapper.exchangeCreate(owner, firstToken, firstBalance,
+                            secondToken, secondBalance, multi);
+                    out.result(result, "ExchangeCreate successful !!", "ExchangeCreate failed !!");
+                })
+                .build());
+    }
+
+    private static void registerExchangeInject(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("exchange-inject")
+                .aliases("exchangeinject")
+                .description("Inject tokens into an exchange")
+                .option("exchange-id", "Exchange ID", true, OptionDef.Type.LONG)
+                .option("token-id", "Token ID", true)
+                .option("quant", "Token quantity", true, OptionDef.Type.LONG)
+                .option("owner", "Owner address", false)
+                .option("multi", "Multi-signature mode", false, OptionDef.Type.BOOLEAN)
+                .handler((opts, wrapper, out) -> {
+                    byte[] owner = opts.has("owner") ? opts.getAddress("owner") : null;
+                    long exchangeId = opts.getLong("exchange-id");
+                    byte[] tokenId = opts.getString("token-id").getBytes();
+                    long quant = opts.getLong("quant");
+                    boolean multi = opts.getBoolean("multi");
+                    boolean result = wrapper.exchangeInject(owner, exchangeId, tokenId, quant, multi);
+                    out.result(result, "ExchangeInject successful !!", "ExchangeInject failed !!");
+                })
+                .build());
+    }
+
+    private static void registerExchangeWithdraw(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("exchange-withdraw")
+                .aliases("exchangewithdraw")
+                .description("Withdraw tokens from an exchange")
+                .option("exchange-id", "Exchange ID", true, OptionDef.Type.LONG)
+                .option("token-id", "Token ID", true)
+                .option("quant", "Token quantity", true, OptionDef.Type.LONG)
+                .option("owner", "Owner address", false)
+                .option("multi", "Multi-signature mode", false, OptionDef.Type.BOOLEAN)
+                .handler((opts, wrapper, out) -> {
+                    byte[] owner = opts.has("owner") ? opts.getAddress("owner") : null;
+                    long exchangeId = opts.getLong("exchange-id");
+                    byte[] tokenId = opts.getString("token-id").getBytes();
+                    long quant = opts.getLong("quant");
+                    boolean multi = opts.getBoolean("multi");
+                    boolean result = wrapper.exchangeWithdraw(owner, exchangeId, tokenId, quant, multi);
+                    out.result(result, "ExchangeWithdraw successful !!", "ExchangeWithdraw failed !!");
+                })
+                .build());
+    }
+
+    private static void registerExchangeTransaction(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("exchange-transaction")
+                .aliases("exchangetransaction")
+                .description("Trade on a Bancor exchange")
+                .option("exchange-id", "Exchange ID", true, OptionDef.Type.LONG)
+                .option("token-id", "Token ID to sell", true)
+                .option("quant", "Token quantity to sell", true, OptionDef.Type.LONG)
+                .option("expected", "Minimum expected tokens to receive", true, OptionDef.Type.LONG)
+                .option("owner", "Owner address", false)
+                .option("multi", "Multi-signature mode", false, OptionDef.Type.BOOLEAN)
+                .handler((opts, wrapper, out) -> {
+                    byte[] owner = opts.has("owner") ? opts.getAddress("owner") : null;
+                    long exchangeId = opts.getLong("exchange-id");
+                    byte[] tokenId = opts.getString("token-id").getBytes();
+                    long quant = opts.getLong("quant");
+                    long expected = opts.getLong("expected");
+                    boolean multi = opts.getBoolean("multi");
+                    boolean result = wrapper.exchangeTransaction(owner, exchangeId, tokenId,
+                            quant, expected, multi);
+                    out.result(result,
+                            "ExchangeTransaction successful !!",
+                            "ExchangeTransaction failed !!");
+                })
+                .build());
+    }
+
+    private static void registerMarketSellAsset(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("market-sell-asset")
+                .aliases("marketsellasset")
+                .description("Create a market sell order")
+                .option("sell-token", "Token to sell", true)
+                .option("sell-quantity", "Quantity to sell", true, OptionDef.Type.LONG)
+                .option("buy-token", "Token to buy", true)
+                .option("buy-quantity", "Expected buy quantity", true, OptionDef.Type.LONG)
+                .option("owner", "Owner address", false)
+                .option("multi", "Multi-signature mode", false, OptionDef.Type.BOOLEAN)
+                .handler((opts, wrapper, out) -> {
+                    byte[] owner = opts.has("owner") ? opts.getAddress("owner") : null;
+                    byte[] sellToken = opts.getString("sell-token").getBytes();
+                    long sellQuantity = opts.getLong("sell-quantity");
+                    byte[] buyToken = opts.getString("buy-token").getBytes();
+                    long buyQuantity = opts.getLong("buy-quantity");
+                    boolean multi = opts.getBoolean("multi");
+                    boolean result = wrapper.marketSellAsset(owner, sellToken, sellQuantity,
+                            buyToken, buyQuantity, multi);
+                    out.result(result, "MarketSellAsset successful !!", "MarketSellAsset failed !!");
+                })
+                .build());
+    }
+
+    private static void registerMarketCancelOrder(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("market-cancel-order")
+                .aliases("marketcancelorder")
+                .description("Cancel a market order")
+                .option("order-id", "Order ID hex", true)
+                .option("owner", "Owner address", false)
+                .option("multi", "Multi-signature mode", false, OptionDef.Type.BOOLEAN)
+                .handler((opts, wrapper, out) -> {
+                    byte[] owner = opts.has("owner") ? opts.getAddress("owner") : null;
+                    byte[] orderId = org.tron.common.utils.ByteArray.fromHexString(opts.getString("order-id"));
+                    boolean multi = opts.getBoolean("multi");
+                    boolean result = wrapper.marketCancelOrder(owner, orderId, multi);
+                    out.result(result,
+                            "MarketCancelOrder successful !!",
+                            "MarketCancelOrder failed !!");
+                })
+                .build());
+    }
+}
diff --git a/src/main/java/org/tron/walletcli/cli/commands/MiscCommands.java b/src/main/java/org/tron/walletcli/cli/commands/MiscCommands.java
new file mode 100644
index 00000000..aa91631f
--- /dev/null
+++ b/src/main/java/org/tron/walletcli/cli/commands/MiscCommands.java
@@ -0,0 +1,132 @@
+package org.tron.walletcli.cli.commands;
+
+import org.tron.common.crypto.ECKey;
+import org.tron.common.utils.ByteArray;
+import org.tron.mnemonic.MnemonicUtils;
+import org.tron.walletcli.cli.CommandDefinition;
+import org.tron.walletcli.cli.CommandRegistry;
+import org.tron.walletserver.WalletApi;
+
+import java.security.SecureRandom;
+import java.util.Arrays;
+import java.util.LinkedHashMap;
+import java.util.List;
+import java.util.Map;
+
+public class MiscCommands {
+
+    public static void register(CommandRegistry registry) {
+        registerGenerateAddress(registry);
+        registerGetPrivateKeyByMnemonic(registry);
+        registerEncodingConverter(registry);
+        registerAddressBook(registry);
+        registerViewTransactionHistory(registry);
+        registerViewBackupRecords(registry);
+        registerHelp(registry);
+    }
+
+    private static void registerGenerateAddress(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("generate-address")
+                .aliases("generateaddress")
+                .description("Generate a new address offline")
+                .handler((opts, wrapper, out) -> {
+                    ECKey ecKey = new ECKey(new SecureRandom());
+                    byte[] priKey = ecKey.getPrivKeyBytes();
+                    byte[] address = ecKey.getAddress();
+                    String addressStr = WalletApi.encode58Check(address);
+                    String priKeyHex = ByteArray.toHexString(priKey);
+                    Map<String, Object> json = new LinkedHashMap<String, Object>();
+                    json.put("address", addressStr);
+                    json.put("private_key", priKeyHex);
+                    out.success("Address: " + addressStr + "\nPrivate Key: " + priKeyHex, json);
+                })
+                .build());
+    }
+
+    private static void registerGetPrivateKeyByMnemonic(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("get-private-key-by-mnemonic")
+                .aliases("getprivatekeybymnemonic")
+                .description("Derive private key from mnemonic phrase")
+                .option("mnemonic", "Mnemonic words (space-separated)", true)
+                .handler((opts, wrapper, out) -> {
+                    String mnemonicStr = opts.getString("mnemonic");
+                    List<String> words = Arrays.asList(mnemonicStr.split("\\s+"));
+                    byte[] priKey = MnemonicUtils.getPrivateKeyFromMnemonic(words);
+                    String priKeyHex = ByteArray.toHexString(priKey);
+                    ECKey ecKey = ECKey.fromPrivate(priKey);
+                    String address = WalletApi.encode58Check(ecKey.getAddress());
+                    Map<String, Object> json = new LinkedHashMap<String, Object>();
+                    json.put("private_key", priKeyHex);
+                    json.put("address", address);
+                    out.success("Private Key: " + priKeyHex + "\nAddress: " + address, json);
+                    Arrays.fill(priKey, (byte) 0);
+                })
+                .build());
+    }
+
+    private static void registerEncodingConverter(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("encoding-converter")
+                .aliases("encodingconverter")
+                .description("Convert between encoding formats")
+                .handler((opts, wrapper, out) -> {
+                    wrapper.encodingConverter();
+                    out.result(true, "Encoding converter completed", "Encoding converter failed");
+                })
+                .build());
+    }
+
+    private static void registerAddressBook(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("address-book")
+                .aliases("addressbook")
+                .description("Manage address book")
+                .handler((opts, wrapper, out) -> {
+                    wrapper.addressBook();
+                    out.result(true, "Address book completed", "Address book failed");
+                })
+                .build());
+    }
+
+    private static void registerViewTransactionHistory(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("view-transaction-history")
+                .aliases("viewtransactionhistory")
+                .description("View transaction history")
+                .handler((opts, wrapper, out) -> {
+                    wrapper.viewTransactionHistory();
+                    out.result(true, "Transaction history completed", "Transaction history failed");
+                })
+                .build());
+    }
+
+    private static void registerViewBackupRecords(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("view-backup-records")
+                .aliases("viewbackuprecords")
+                .description("View backup records")
+                .handler((opts, wrapper, out) -> {
+                    wrapper.viewBackupRecords();
+                    out.result(true, "Backup records completed", "Backup records failed");
+                })
+                .build());
+    }
+
+    private static void registerHelp(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("help")
+                .aliases("help")
+                .description("Show help information")
+                .option("command", "Command to show help for", false)
+                .handler((opts, wrapper, out) -> {
+                    // Help is handled by the runner level --help flag
+                    // This registers the command so it appears in the command list
+                    out.result(true,
+                            "Use 'wallet-cli --help' for global help or 'wallet-cli <command> --help' for command help.",
+                            "Help failed");
+                })
+                .build());
+    }
+}
diff --git a/src/main/java/org/tron/walletcli/cli/commands/ProposalCommands.java b/src/main/java/org/tron/walletcli/cli/commands/ProposalCommands.java
new file mode 100644
index 00000000..f9b61b09
--- /dev/null
+++ b/src/main/java/org/tron/walletcli/cli/commands/ProposalCommands.java
@@ -0,0 +1,83 @@
+package org.tron.walletcli.cli.commands;
+
+import org.tron.walletcli.cli.CommandDefinition;
+import org.tron.walletcli.cli.CommandRegistry;
+import org.tron.walletcli.cli.OptionDef;
+
+import java.util.HashMap;
+
+public class ProposalCommands {
+
+    public static void register(CommandRegistry registry) {
+        registerCreateProposal(registry);
+        registerApproveProposal(registry);
+        registerDeleteProposal(registry);
+    }
+
+    private static void registerCreateProposal(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("create-proposal")
+                .aliases("createproposal")
+                .description("Create a proposal")
+                .option("parameters", "Parameters as 'id1 value1 id2 value2 ...'", true)
+                .option("owner", "Owner address", false)
+                .option("multi", "Multi-signature mode", false, OptionDef.Type.BOOLEAN)
+                .handler((opts, wrapper, out) -> {
+                    byte[] owner = opts.has("owner") ? opts.getAddress("owner") : null;
+                    String paramsStr = opts.getString("parameters");
+                    String[] parts = paramsStr.trim().split("\\s+");
+                    if (parts.length % 2 != 0) {
+                        out.usageError("Parameters must be pairs of 'id value'", null);
+                        return;
+                    }
+                    HashMap<Long, Long> parametersMap = new HashMap<Long, Long>();
+                    for (int i = 0; i < parts.length; i += 2) {
+                        parametersMap.put(Long.parseLong(parts[i]), Long.parseLong(parts[i + 1]));
+                    }
+                    boolean multi = opts.getBoolean("multi");
+                    boolean result = wrapper.createProposal(owner, parametersMap, multi);
+                    out.result(result, "CreateProposal successful !!", "CreateProposal failed !!");
+                })
+                .build());
+    }
+
+    private static void registerApproveProposal(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("approve-proposal")
+                .aliases("approveproposal")
+                .description("Approve or disapprove a proposal")
+                .option("id", "Proposal ID", true, OptionDef.Type.LONG)
+                .option("approve", "true to approve, false to disapprove", true, OptionDef.Type.BOOLEAN)
+                .option("owner", "Owner address", false)
+                .option("multi", "Multi-signature mode", false, OptionDef.Type.BOOLEAN)
+                .handler((opts, wrapper, out) -> {
+                    byte[] owner = opts.has("owner") ? opts.getAddress("owner") : null;
+                    long id = opts.getLong("id");
+                    boolean approve = opts.getBoolean("approve");
+                    boolean multi = opts.getBoolean("multi");
+                    boolean result = wrapper.approveProposal(owner, id, approve, multi);
+                    out.result(result,
+                            "ApproveProposal successful !!",
+                            "ApproveProposal failed !!");
+                })
+                .build());
+    }
+
+    private static void registerDeleteProposal(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("delete-proposal")
+                .aliases("deleteproposal")
+                .description("Delete a proposal")
+                .option("id", "Proposal ID", true, OptionDef.Type.LONG)
+                .option("owner", "Owner address", false)
+                .option("multi", "Multi-signature mode", false, OptionDef.Type.BOOLEAN)
+                .handler((opts, wrapper, out) -> {
+                    byte[] owner = opts.has("owner") ? opts.getAddress("owner") : null;
+                    long id = opts.getLong("id");
+                    boolean multi = opts.getBoolean("multi");
+                    boolean result = wrapper.deleteProposal(owner, id, multi);
+                    out.result(result, "DeleteProposal successful !!", "DeleteProposal failed !!");
+                })
+                .build());
+    }
+}
diff --git a/src/main/java/org/tron/walletcli/cli/commands/QueryCommands.java b/src/main/java/org/tron/walletcli/cli/commands/QueryCommands.java
new file mode 100644
index 00000000..70c655d8
--- /dev/null
+++ b/src/main/java/org/tron/walletcli/cli/commands/QueryCommands.java
@@ -0,0 +1,984 @@
+package org.tron.walletcli.cli.commands;
+
+import org.tron.walletcli.cli.CommandDefinition;
+import org.tron.walletcli.cli.CommandRegistry;
+import org.tron.walletcli.cli.OptionDef;
+import org.tron.walletserver.WalletApi;
+import org.tron.trident.proto.Chain;
+import org.tron.trident.proto.Common;
+import org.tron.trident.proto.Contract;
+import org.tron.trident.proto.Response;
+import org.tron.common.utils.Utils;
+
+import java.math.BigDecimal;
+import java.math.RoundingMode;
+import java.util.LinkedHashMap;
+import java.util.Map;
+
+public class QueryCommands {
+
+    public static void register(CommandRegistry registry) {
+        registerGetAddress(registry);
+        registerGetBalance(registry);
+        registerGetAccount(registry);
+        registerGetAccountById(registry);
+        registerGetAccountNet(registry);
+        registerGetAccountResource(registry);
+        registerGetUsdtBalance(registry);
+        registerCurrentNetwork(registry);
+        registerGetBlock(registry);
+        registerGetBlockById(registry);
+        registerGetBlockByIdOrNum(registry);
+        registerGetBlockByLatestNum(registry);
+        registerGetBlockByLimitNext(registry);
+        registerGetTransactionById(registry);
+        registerGetTransactionInfoById(registry);
+        registerGetTransactionCountByBlockNum(registry);
+        registerGetAssetIssueByAccount(registry);
+        registerGetAssetIssueById(registry);
+        registerGetAssetIssueByName(registry);
+        registerGetAssetIssueListByName(registry);
+        registerGetChainParameters(registry);
+        registerGetBandwidthPrices(registry);
+        registerGetEnergyPrices(registry);
+        registerGetMemoFee(registry);
+        registerGetNextMaintenanceTime(registry);
+        registerGetContract(registry);
+        registerGetContractInfo(registry);
+        registerGetDelegatedResource(registry);
+        registerGetDelegatedResourceV2(registry);
+        registerGetDelegatedResourceAccountIndex(registry);
+        registerGetDelegatedResourceAccountIndexV2(registry);
+        registerGetCanDelegatedMaxSize(registry);
+        registerGetAvailableUnfreezeCount(registry);
+        registerGetCanWithdrawUnfreezeAmount(registry);
+        registerGetBrokerage(registry);
+        registerGetReward(registry);
+        registerListNodes(registry);
+        registerListWitnesses(registry);
+        registerListAssetIssue(registry);
+        registerListAssetIssuePaginated(registry);
+        registerListProposals(registry);
+        registerListProposalsPaginated(registry);
+        registerGetProposal(registry);
+        registerListExchanges(registry);
+        registerListExchangesPaginated(registry);
+        registerGetExchange(registry);
+        registerGetMarketOrderByAccount(registry);
+        registerGetMarketOrderById(registry);
+        registerGetMarketOrderListByPair(registry);
+        registerGetMarketPairList(registry);
+        registerGetMarketPriceByPair(registry);
+        registerGasFreeInfo(registry);
+        registerGasFreeTrace(registry);
+    }
+
+    private static void registerGetAddress(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("get-address")
+                .aliases("getaddress")
+                .description("Get the address of the current logged-in wallet")
+                .handler((opts, wrapper, out) -> {
+                    String address = wrapper.getAddress();
+                    if (address != null) {
+                        Map<String, Object> json = new LinkedHashMap<String, Object>();
+                        json.put("address", address);
+                        out.success("GetAddress successful !!\naddress = " + address, json);
+                    } else {
+                        out.error("not_logged_in", "GetAddress failed, please login first");
+                    }
+                })
+                .build());
+    }
+
+    private static void registerGetBalance(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("get-balance")
+                .aliases("getbalance")
+                .description("Get the balance of an address")
+                .option("address", "Address to query (default: current wallet)", false)
+                .handler((opts, wrapper, out) -> {
+                    Response.Account account;
+                    if (opts.has("address")) {
+                        byte[] addressBytes = opts.getAddress("address");
+                        account = WalletApi.queryAccount(addressBytes);
+                    } else {
+                        account = wrapper.queryAccount();
+                    }
+                    if (account == null) {
+                        out.error("query_failed", "GetBalance failed");
+                    } else {
+                        long balance = account.getBalance();
+                        BigDecimal trx = BigDecimal.valueOf(balance)
+                                .divide(BigDecimal.valueOf(1_000_000), 6, RoundingMode.DOWN);
+                        Map<String, Object> json = new LinkedHashMap<String, Object>();
+                        json.put("balance_sun", balance);
+                        json.put("balance_trx", trx.toPlainString());
+                        out.success("Balance = " + balance + " SUN = " + trx.toPlainString() + " TRX", json);
+                    }
+                })
+                .build());
+    }
+
+    private static void registerGetAccount(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("get-account")
+                .aliases("getaccount")
+                .description("Get account information by address")
+                .option("address", "Address to query", true)
+                .handler((opts, wrapper, out) -> {
+                    byte[] addressBytes = opts.getAddress("address");
+                    Response.Account account = WalletApi.queryAccount(addressBytes);
+                    if (account == null) {
+                        out.error("query_failed", "GetAccount failed");
+                    } else {
+                        out.printMessage(Utils.formatMessageString(account), "GetAccount failed");
+                    }
+                })
+                .build());
+    }
+
+    private static void registerGetAccountById(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("get-account-by-id")
+                .aliases("getaccountbyid")
+                .description("Get account information by account ID")
+                .option("id", "Account ID", true)
+                .handler((opts, wrapper, out) -> {
+                    Response.Account account = WalletApi.queryAccountById(opts.getString("id"));
+                    if (account == null) {
+                        out.error("query_failed", "GetAccountById failed");
+                    } else {
+                        out.printMessage(Utils.formatMessageString(account), "GetAccountById failed");
+                    }
+                })
+                .build());
+    }
+
+    private static void registerGetAccountNet(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("get-account-net")
+                .aliases("getaccountnet")
+                .description("Get account net (bandwidth) information")
+                .option("address", "Address to query", true)
+                .handler((opts, wrapper, out) -> {
+                    byte[] addressBytes = opts.getAddress("address");
+                    Response.AccountNetMessage accountNet = WalletApi.getAccountNet(addressBytes);
+                    if (accountNet == null) {
+                        out.error("query_failed", "GetAccountNet failed");
+                    } else {
+                        out.printMessage(Utils.formatMessageString(accountNet), "GetAccountNet failed");
+                    }
+                })
+                .build());
+    }
+
+    private static void registerGetAccountResource(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("get-account-resource")
+                .aliases("getaccountresource")
+                .description("Get account resource information")
+                .option("address", "Address to query", true)
+                .handler((opts, wrapper, out) -> {
+                    byte[] addressBytes = opts.getAddress("address");
+                    Response.AccountResourceMessage accountResource = WalletApi.getAccountResource(addressBytes);
+                    if (accountResource == null) {
+                        out.error("query_failed", "GetAccountResource failed");
+                    } else {
+                        out.printMessage(Utils.formatMessageString(accountResource), "GetAccountResource failed");
+                    }
+                })
+                .build());
+    }
+
+    private static void registerGetUsdtBalance(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("get-usdt-balance")
+                .aliases("getusdtbalance")
+                .description("Get USDT balance of an address")
+                .option("address", "Address to query (default: current wallet)", false)
+                .handler((opts, wrapper, out) -> {
+                    byte[] ownerAddress = opts.has("address") ? opts.getAddress("address") : null;
+                    org.apache.commons.lang3.tuple.Triple<Boolean, Long, Long> pair =
+                            wrapper.getUSDTBalance(ownerAddress);
+                    if (Boolean.TRUE.equals(pair.getLeft())) {
+                        long balance = pair.getRight();
+                        Map<String, Object> json = new LinkedHashMap<String, Object>();
+                        json.put("usdt_balance", balance);
+                        out.success("USDT balance = " + balance, json);
+                    } else {
+                        out.error("query_failed", "GetUSDTBalance failed");
+                    }
+                })
+                .build());
+    }
+
+    private static void registerCurrentNetwork(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("current-network")
+                .aliases("currentnetwork")
+                .description("Display the current network")
+                .handler((opts, wrapper, out) -> {
+                    String network = WalletApi.getCurrentNetwork() != null
+                            ? WalletApi.getCurrentNetwork().name() : "unknown";
+                    Map<String, Object> json = new LinkedHashMap<String, Object>();
+                    json.put("network", network);
+                    out.success("Current network: " + network, json);
+                })
+                .build());
+    }
+
+    private static void registerGetBlock(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("get-block")
+                .aliases("getblock")
+                .description("Get block by number or latest")
+                .option("number", "Block number (default: latest)", false, OptionDef.Type.LONG)
+                .handler((opts, wrapper, out) -> {
+                    long blockNum = opts.has("number") ? opts.getLong("number") : -1;
+                    Chain.Block block = WalletApi.getBlock(blockNum);
+                    if (block == null) {
+                        out.error("query_failed", "GetBlock failed");
+                    } else {
+                        out.printMessage(Utils.printBlock(block), "GetBlock failed");
+                    }
+                })
+                .build());
+    }
+
+    private static void registerGetBlockById(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("get-block-by-id")
+                .aliases("getblockbyid")
+                .description("Get block by block ID (hash)")
+                .option("id", "Block ID / hash", true)
+                .handler((opts, wrapper, out) -> {
+                    Chain.Block block = WalletApi.getBlockById(opts.getString("id"));
+                    if (block == null) {
+                        out.error("query_failed", "GetBlockById failed");
+                    } else {
+                        out.printMessage(Utils.printBlock(block), "GetBlockById failed");
+                    }
+                })
+                .build());
+    }
+
+    private static void registerGetBlockByIdOrNum(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("get-block-by-id-or-num")
+                .aliases("getblockbyidornum")
+                .description("Get block by ID or number")
+                .option("value", "Block ID or number", true)
+                .handler((opts, wrapper, out) -> {
+                    String value = opts.getString("value");
+                    try {
+                        long blockNum = Long.parseLong(value);
+                        Chain.Block block = WalletApi.getBlock(blockNum);
+                        if (block == null) {
+                            out.error("query_failed", "GetBlock failed");
+                        } else {
+                            out.printMessage(Utils.printBlock(block), "GetBlock failed");
+                        }
+                    } catch (NumberFormatException e) {
+                        Chain.Block block = WalletApi.getBlockById(value);
+                        if (block == null) {
+                            out.error("query_failed", "GetBlockById failed");
+                        } else {
+                            out.printMessage(Utils.printBlock(block), "GetBlockById failed");
+                        }
+                    }
+                })
+                .build());
+    }
+
+    private static void registerGetBlockByLatestNum(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("get-block-by-latest-num")
+                .aliases("getblockbylatestnum")
+                .description("Get the latest N blocks")
+                .option("count", "Number of blocks", true, OptionDef.Type.LONG)
+                .handler((opts, wrapper, out) -> {
+                    long count = opts.getLong("count");
+                    Response.BlockListExtention blocks = WalletApi.getBlockByLatestNum2(count);
+                    if (blocks == null) {
+                        out.error("query_failed", "GetBlockByLatestNum failed");
+                    } else {
+                        out.printMessage(Utils.formatMessageString(blocks), "GetBlockByLatestNum failed");
+                    }
+                })
+                .build());
+    }
+
+    private static void registerGetBlockByLimitNext(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("get-block-by-limit-next")
+                .aliases("getblockbylimitnext")
+                .description("Get blocks in range [start, end)")
+                .option("start", "Start block number", true, OptionDef.Type.LONG)
+                .option("end", "End block number", true, OptionDef.Type.LONG)
+                .handler((opts, wrapper, out) -> {
+                    long start = opts.getLong("start");
+                    long end = opts.getLong("end");
+                    Response.BlockListExtention blocks = WalletApi.getBlockByLimitNext(start, end);
+                    if (blocks == null) {
+                        out.error("query_failed", "GetBlockByLimitNext failed");
+                    } else {
+                        out.printMessage(Utils.formatMessageString(blocks), "GetBlockByLimitNext failed");
+                    }
+                })
+                .build());
+    }
+
+    private static void registerGetTransactionById(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("get-transaction-by-id")
+                .aliases("gettransactionbyid")
+                .description("Get transaction by ID")
+                .option("id", "Transaction ID", true)
+                .handler((opts, wrapper, out) -> {
+                    Chain.Transaction tx = WalletApi.getTransactionById(opts.getString("id"));
+                    if (tx == null) {
+                        out.error("query_failed", "GetTransactionById failed");
+                    } else {
+                        out.printMessage(Utils.formatMessageString(tx), "GetTransactionById failed");
+                    }
+                })
+                .build());
+    }
+
+    private static void registerGetTransactionInfoById(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("get-transaction-info-by-id")
+                .aliases("gettransactioninfobyid")
+                .description("Get transaction info by ID")
+                .option("id", "Transaction ID", true)
+                .handler((opts, wrapper, out) -> {
+                    Response.TransactionInfo txInfo = WalletApi.getTransactionInfoById(opts.getString("id"));
+                    if (txInfo == null) {
+                        out.error("query_failed", "GetTransactionInfoById failed");
+                    } else {
+                        out.printMessage(Utils.formatMessageString(txInfo), "GetTransactionInfoById failed");
+                    }
+                })
+                .build());
+    }
+
+    private static void registerGetTransactionCountByBlockNum(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("get-transaction-count-by-block-num")
+                .aliases("gettransactioncountbyblocknum")
+                .description("Get transaction count in a block")
+                .option("number", "Block number", true, OptionDef.Type.LONG)
+                .handler((opts, wrapper, out) -> {
+                    long count = wrapper.getTransactionCountByBlockNum(opts.getLong("number"));
+                    Map<String, Object> json = new LinkedHashMap<String, Object>();
+                    json.put("count", count);
+                    out.success("The block contains " + count + " transactions", json);
+                })
+                .build());
+    }
+
+    private static void registerGetAssetIssueByAccount(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("get-asset-issue-by-account")
+                .aliases("getassetissuebyaccount")
+                .description("Get asset issues by account address")
+                .option("address", "Account address", true)
+                .handler((opts, wrapper, out) -> {
+                    Response.AssetIssueList result = WalletApi.getAssetIssueByAccount(opts.getAddress("address"));
+                    if (result == null) {
+                        out.error("query_failed", "GetAssetIssueByAccount failed");
+                    } else {
+                        out.printMessage(Utils.formatMessageString(result), "GetAssetIssueByAccount failed");
+                    }
+                })
+                .build());
+    }
+
+    private static void registerGetAssetIssueById(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("get-asset-issue-by-id")
+                .aliases("getassetissuebyid")
+                .description("Get asset issue by ID")
+                .option("id", "Asset ID", true)
+                .handler((opts, wrapper, out) -> {
+                    Contract.AssetIssueContract result = WalletApi.getAssetIssueById(opts.getString("id"));
+                    out.protobuf(result, "GetAssetIssueById failed");
+                })
+                .build());
+    }
+
+    private static void registerGetAssetIssueByName(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("get-asset-issue-by-name")
+                .aliases("getassetissuebyname")
+                .description("Get asset issue by name")
+                .option("name", "Asset name", true)
+                .handler((opts, wrapper, out) -> {
+                    Contract.AssetIssueContract result = WalletApi.getAssetIssueByName(opts.getString("name"));
+                    out.protobuf(result, "GetAssetIssueByName failed");
+                })
+                .build());
+    }
+
+    private static void registerGetAssetIssueListByName(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("get-asset-issue-list-by-name")
+                .aliases("getassetissuelistbyname")
+                .description("Get asset issue list by name")
+                .option("name", "Asset name", true)
+                .handler((opts, wrapper, out) -> {
+                    Response.AssetIssueList result = WalletApi.getAssetIssueListByName(opts.getString("name"));
+                    if (result == null) {
+                        out.error("query_failed", "GetAssetIssueListByName failed");
+                    } else {
+                        out.printMessage(Utils.formatMessageString(result), "GetAssetIssueListByName failed");
+                    }
+                })
+                .build());
+    }
+
+    private static void registerGetChainParameters(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("get-chain-parameters")
+                .aliases("getchainparameters")
+                .description("Get chain parameters")
+                .handler((opts, wrapper, out) -> {
+                    Response.ChainParameters result = WalletApi.getChainParameters();
+                    if (result == null) {
+                        out.error("query_failed", "GetChainParameters failed");
+                    } else {
+                        out.printMessage(Utils.formatMessageString(result), "GetChainParameters failed");
+                    }
+                })
+                .build());
+    }
+
+    private static void registerGetBandwidthPrices(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("get-bandwidth-prices")
+                .aliases("getbandwidthprices")
+                .description("Get bandwidth prices history")
+                .handler((opts, wrapper, out) -> {
+                    Response.PricesResponseMessage result = WalletApi.getBandwidthPrices();
+                    out.protobuf(result, "GetBandwidthPrices failed");
+                })
+                .build());
+    }
+
+    private static void registerGetEnergyPrices(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("get-energy-prices")
+                .aliases("getenergyprices")
+                .description("Get energy prices history")
+                .handler((opts, wrapper, out) -> {
+                    Response.PricesResponseMessage result = WalletApi.getEnergyPrices();
+                    out.protobuf(result, "GetEnergyPrices failed");
+                })
+                .build());
+    }
+
+    private static void registerGetMemoFee(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("get-memo-fee")
+                .aliases("getmemofee")
+                .description("Get memo fee")
+                .handler((opts, wrapper, out) -> {
+                    Response.PricesResponseMessage result = WalletApi.getMemoFee();
+                    out.protobuf(result, "GetMemoFee failed");
+                })
+                .build());
+    }
+
+    private static void registerGetNextMaintenanceTime(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("get-next-maintenance-time")
+                .aliases("getnextmaintenancetime")
+                .description("Get next maintenance time")
+                .handler((opts, wrapper, out) -> {
+                    long time = wrapper.getNextMaintenanceTime();
+                    Map<String, Object> json = new LinkedHashMap<String, Object>();
+                    json.put("next_maintenance_time", time);
+                    out.success("Next maintenance time: " + time, json);
+                })
+                .build());
+    }
+
+    private static void registerGetContract(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("get-contract")
+                .aliases("getcontract")
+                .description("Get smart contract by address")
+                .option("address", "Contract address", true)
+                .handler((opts, wrapper, out) -> {
+                    Common.SmartContract contract = WalletApi.getContract(opts.getAddress("address"));
+                    if (contract == null) {
+                        out.error("query_failed", "GetContract failed");
+                    } else {
+                        out.printMessage(Utils.formatMessageString(contract), "GetContract failed");
+                    }
+                })
+                .build());
+    }
+
+    private static void registerGetContractInfo(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("get-contract-info")
+                .aliases("getcontractinfo")
+                .description("Get smart contract info by address")
+                .option("address", "Contract address", true)
+                .handler((opts, wrapper, out) -> {
+                    Response.SmartContractDataWrapper contractInfo = WalletApi.getContractInfo(opts.getAddress("address"));
+                    if (contractInfo == null) {
+                        out.error("query_failed", "GetContractInfo failed");
+                    } else {
+                        out.printMessage(Utils.formatMessageString(contractInfo), "GetContractInfo failed");
+                    }
+                })
+                .build());
+    }
+
+    private static void registerGetDelegatedResource(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("get-delegated-resource")
+                .aliases("getdelegatedresource")
+                .description("Get delegated resource between two addresses")
+                .option("from", "From address", true)
+                .option("to", "To address", true)
+                .handler((opts, wrapper, out) -> {
+                    Response.DelegatedResourceList result = WalletApi.getDelegatedResource(
+                            opts.getString("from"), opts.getString("to"));
+                    if (result == null) {
+                        out.error("query_failed", "GetDelegatedResource failed");
+                    } else {
+                        out.printMessage(Utils.formatMessageString(result), "GetDelegatedResource failed");
+                    }
+                })
+                .build());
+    }
+
+    private static void registerGetDelegatedResourceV2(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("get-delegated-resource-v2")
+                .aliases("getdelegatedresourcev2")
+                .description("Get delegated resource V2 between two addresses")
+                .option("from", "From address", true)
+                .option("to", "To address", true)
+                .handler((opts, wrapper, out) -> {
+                    Response.DelegatedResourceList result = WalletApi.getDelegatedResourceV2(
+                            opts.getString("from"), opts.getString("to"));
+                    if (result == null) {
+                        out.error("query_failed", "GetDelegatedResourceV2 failed");
+                    } else {
+                        out.printMessage(Utils.formatMessageString(result), "GetDelegatedResourceV2 failed");
+                    }
+                })
+                .build());
+    }
+
+    private static void registerGetDelegatedResourceAccountIndex(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("get-delegated-resource-account-index")
+                .aliases("getdelegatedresourceaccountindex")
+                .description("Get delegated resource account index")
+                .option("address", "Address", true)
+                .handler((opts, wrapper, out) -> {
+                    Response.DelegatedResourceAccountIndex result =
+                            WalletApi.getDelegatedResourceAccountIndex(opts.getString("address"));
+                    if (result == null) {
+                        out.error("query_failed", "GetDelegatedResourceAccountIndex failed");
+                    } else {
+                        out.printMessage(Utils.formatMessageString(result),
+                                "GetDelegatedResourceAccountIndex failed");
+                    }
+                })
+                .build());
+    }
+
+    private static void registerGetDelegatedResourceAccountIndexV2(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("get-delegated-resource-account-index-v2")
+                .aliases("getdelegatedresourceaccountindexv2")
+                .description("Get delegated resource account index V2")
+                .option("address", "Address", true)
+                .handler((opts, wrapper, out) -> {
+                    Response.DelegatedResourceAccountIndex result =
+                            WalletApi.getDelegatedResourceAccountIndexV2(opts.getString("address"));
+                    if (result == null) {
+                        out.error("query_failed", "GetDelegatedResourceAccountIndexV2 failed");
+                    } else {
+                        out.printMessage(Utils.formatMessageString(result),
+                                "GetDelegatedResourceAccountIndexV2 failed");
+                    }
+                })
+                .build());
+    }
+
+    private static void registerGetCanDelegatedMaxSize(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("get-can-delegated-max-size")
+                .aliases("getcandelegatedmaxsize")
+                .description("Get max delegatable size for a resource type")
+                .option("owner", "Owner address", true)
+                .option("type", "Resource type (0=BANDWIDTH, 1=ENERGY)", true, OptionDef.Type.LONG)
+                .handler((opts, wrapper, out) -> {
+                    long maxSize = WalletApi.getCanDelegatedMaxSize(
+                            opts.getAddress("owner"), (int) opts.getLong("type"));
+                    Map<String, Object> json = new LinkedHashMap<String, Object>();
+                    json.put("max_size", maxSize);
+                    out.success("Max delegatable size: " + maxSize, json);
+                })
+                .build());
+    }
+
+    private static void registerGetAvailableUnfreezeCount(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("get-available-unfreeze-count")
+                .aliases("getavailableunfreezecount")
+                .description("Get available unfreeze count")
+                .option("address", "Address", true)
+                .handler((opts, wrapper, out) -> {
+                    long count = WalletApi.getAvailableUnfreezeCount(opts.getAddress("address"));
+                    Map<String, Object> json = new LinkedHashMap<String, Object>();
+                    json.put("count", count);
+                    out.success("Available unfreeze count: " + count, json);
+                })
+                .build());
+    }
+
+    private static void registerGetCanWithdrawUnfreezeAmount(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("get-can-withdraw-unfreeze-amount")
+                .aliases("getcanwithdrawunfreezeamount")
+                .description("Get withdrawable unfreeze amount")
+                .option("address", "Address", true)
+                .option("timestamp", "Timestamp in milliseconds (default: now)", false, OptionDef.Type.LONG)
+                .handler((opts, wrapper, out) -> {
+                    long ts = opts.has("timestamp") ? opts.getLong("timestamp") : System.currentTimeMillis();
+                    long amount = WalletApi.getCanWithdrawUnfreezeAmount(opts.getAddress("address"), ts);
+                    Map<String, Object> json = new LinkedHashMap<String, Object>();
+                    json.put("amount", amount);
+                    out.success("Can withdraw unfreeze amount: " + amount, json);
+                })
+                .build());
+    }
+
+    private static void registerGetBrokerage(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("get-brokerage")
+                .aliases("getbrokerage")
+                .description("Get witness brokerage ratio")
+                .option("address", "Witness address", true)
+                .handler((opts, wrapper, out) -> {
+                    long brokerage = wrapper.getBrokerage(opts.getAddress("address"));
+                    Map<String, Object> json = new LinkedHashMap<String, Object>();
+                    json.put("brokerage", brokerage);
+                    out.success("Brokerage: " + brokerage, json);
+                })
+                .build());
+    }
+
+    private static void registerGetReward(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("get-reward")
+                .aliases("getreward")
+                .description("Get unclaimed reward")
+                .option("address", "Address", true)
+                .handler((opts, wrapper, out) -> {
+                    org.tron.trident.api.GrpcAPI.NumberMessage result =
+                            wrapper.getReward(opts.getAddress("address"));
+                    if (result == null) {
+                        out.error("query_failed", "GetReward failed");
+                    } else {
+                        long reward = result.getNum();
+                        Map<String, Object> json = new LinkedHashMap<String, Object>();
+                        json.put("reward", reward);
+                        out.success("Reward: " + reward, json);
+                    }
+                })
+                .build());
+    }
+
+    private static void registerListNodes(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("list-nodes")
+                .aliases("listnodes")
+                .description("List connected nodes")
+                .handler((opts, wrapper, out) -> {
+                    Response.NodeList nodeList = WalletApi.listNodes();
+                    if (nodeList == null) {
+                        out.error("query_failed", "ListNodes failed");
+                    } else {
+                        out.printMessage(Utils.formatMessageString(nodeList), "ListNodes failed");
+                    }
+                })
+                .build());
+    }
+
+    private static void registerListWitnesses(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("list-witnesses")
+                .aliases("listwitnesses")
+                .description("List all witnesses")
+                .handler((opts, wrapper, out) -> {
+                    Response.WitnessList witnessList = WalletApi.listWitnesses();
+                    if (witnessList == null) {
+                        out.error("query_failed", "ListWitnesses failed");
+                    } else {
+                        out.printMessage(Utils.formatMessageString(witnessList), "ListWitnesses failed");
+                    }
+                })
+                .build());
+    }
+
+    private static void registerListAssetIssue(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("list-asset-issue")
+                .aliases("listassetissue")
+                .description("List all asset issues")
+                .handler((opts, wrapper, out) -> {
+                    Response.AssetIssueList result = WalletApi.getAssetIssueList();
+                    out.protobuf(result, "ListAssetIssue failed");
+                })
+                .build());
+    }
+
+    private static void registerListAssetIssuePaginated(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("list-asset-issue-paginated")
+                .aliases("listassetissuepaginated")
+                .description("List asset issues with pagination")
+                .option("offset", "Start offset", true, OptionDef.Type.LONG)
+                .option("limit", "Page size", true, OptionDef.Type.LONG)
+                .handler((opts, wrapper, out) -> {
+                    Response.AssetIssueList result = WalletApi.getPaginatedAssetIssueList(
+                            opts.getLong("offset"), opts.getLong("limit"));
+                    if (result == null) {
+                        out.error("query_failed", "ListAssetIssuePaginated failed");
+                    } else {
+                        out.printMessage(Utils.formatMessageString(result), "ListAssetIssuePaginated failed");
+                    }
+                })
+                .build());
+    }
+
+    private static void registerListProposals(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("list-proposals")
+                .aliases("listproposals")
+                .description("List all proposals")
+                .handler((opts, wrapper, out) -> {
+                    Response.ProposalList result = WalletApi.getProposalListPaginated(-1, -1);
+                    if (result == null) {
+                        out.error("query_failed", "ListProposals failed");
+                    } else {
+                        out.printMessage(Utils.formatMessageString(result), "ListProposals failed");
+                    }
+                })
+                .build());
+    }
+
+    private static void registerListProposalsPaginated(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("list-proposals-paginated")
+                .aliases("listproposalspaginated")
+                .description("List proposals with pagination")
+                .option("offset", "Start offset", true, OptionDef.Type.LONG)
+                .option("limit", "Page size", true, OptionDef.Type.LONG)
+                .handler((opts, wrapper, out) -> {
+                    Response.ProposalList result = WalletApi.getProposalListPaginated(
+                            opts.getLong("offset"), opts.getLong("limit"));
+                    if (result == null) {
+                        out.error("query_failed", "ListProposalsPaginated failed");
+                    } else {
+                        out.printMessage(Utils.formatMessageString(result), "ListProposalsPaginated failed");
+                    }
+                })
+                .build());
+    }
+
+    private static void registerGetProposal(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("get-proposal")
+                .aliases("getproposal")
+                .description("Get proposal by ID")
+                .option("id", "Proposal ID", true)
+                .handler((opts, wrapper, out) -> {
+                    Response.Proposal result = WalletApi.getProposal(opts.getString("id"));
+                    if (result == null) {
+                        out.error("query_failed", "GetProposal failed");
+                    } else {
+                        out.printMessage(Utils.formatMessageString(result), "GetProposal failed");
+                    }
+                })
+                .build());
+    }
+
+    private static void registerListExchanges(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("list-exchanges")
+                .aliases("listexchanges")
+                .description("List all exchanges")
+                .handler((opts, wrapper, out) -> {
+                    Response.ExchangeList result = WalletApi.getExchangeListPaginated(-1, -1);
+                    if (result == null) {
+                        out.error("query_failed", "ListExchanges failed");
+                    } else {
+                        out.printMessage(Utils.formatMessageString(result), "ListExchanges failed");
+                    }
+                })
+                .build());
+    }
+
+    private static void registerListExchangesPaginated(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("list-exchanges-paginated")
+                .aliases("listexchangespaginated")
+                .description("List exchanges with pagination")
+                .option("offset", "Start offset", true, OptionDef.Type.LONG)
+                .option("limit", "Page size", true, OptionDef.Type.LONG)
+                .handler((opts, wrapper, out) -> {
+                    Response.ExchangeList result = WalletApi.getExchangeListPaginated(
+                            opts.getLong("offset"), opts.getLong("limit"));
+                    if (result == null) {
+                        out.error("query_failed", "ListExchangesPaginated failed");
+                    } else {
+                        out.printMessage(Utils.formatMessageString(result), "ListExchangesPaginated failed");
+                    }
+                })
+                .build());
+    }
+
+    private static void registerGetExchange(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("get-exchange")
+                .aliases("getexchange")
+                .description("Get exchange by ID")
+                .option("id", "Exchange ID", true)
+                .handler((opts, wrapper, out) -> {
+                    Response.Exchange result = WalletApi.getExchange(opts.getString("id"));
+                    if (result == null) {
+                        out.error("query_failed", "GetExchange failed");
+                    } else {
+                        out.printMessage(Utils.formatMessageString(result), "GetExchange failed");
+                    }
+                })
+                .build());
+    }
+
+    private static void registerGetMarketOrderByAccount(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("get-market-order-by-account")
+                .aliases("getmarketorderbyaccount")
+                .description("Get market orders by account")
+                .option("address", "Account address", true)
+                .handler((opts, wrapper, out) -> {
+                    Response.MarketOrderList result = WalletApi.getMarketOrderByAccount(opts.getAddress("address"));
+                    if (result == null) {
+                        out.error("query_failed", "GetMarketOrderByAccount failed");
+                    } else {
+                        out.printMessage(Utils.formatMessageString(result), "GetMarketOrderByAccount failed");
+                    }
+                })
+                .build());
+    }
+
+    private static void registerGetMarketOrderById(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("get-market-order-by-id")
+                .aliases("getmarketorderbyid")
+                .description("Get market order by ID")
+                .option("id", "Order ID hex", true)
+                .handler((opts, wrapper, out) -> {
+                    byte[] orderId = org.tron.common.utils.ByteArray.fromHexString(opts.getString("id"));
+                    Response.MarketOrder result = WalletApi.getMarketOrderById(orderId);
+                    if (result == null) {
+                        out.error("query_failed", "GetMarketOrderById failed");
+                    } else {
+                        out.printMessage(Utils.formatMessageString(result), "GetMarketOrderById failed");
+                    }
+                })
+                .build());
+    }
+
+    private static void registerGetMarketOrderListByPair(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("get-market-order-list-by-pair")
+                .aliases("getmarketorderlistbypair")
+                .description("Get market order list by token pair")
+                .option("sell-token", "Sell token name", true)
+                .option("buy-token", "Buy token name", true)
+                .handler((opts, wrapper, out) -> {
+                    Response.MarketOrderList result = WalletApi.getMarketOrderListByPair(
+                            opts.getString("sell-token").getBytes(),
+                            opts.getString("buy-token").getBytes());
+                    if (result == null) {
+                        out.error("query_failed", "GetMarketOrderListByPair failed");
+                    } else {
+                        out.printMessage(Utils.formatMessageString(result), "GetMarketOrderListByPair failed");
+                    }
+                })
+                .build());
+    }
+
+    private static void registerGetMarketPairList(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("get-market-pair-list")
+                .aliases("getmarketpairlist")
+                .description("Get all market trading pairs")
+                .handler((opts, wrapper, out) -> {
+                    Response.MarketOrderPairList result = WalletApi.getMarketPairList();
+                    if (result == null) {
+                        out.error("query_failed", "GetMarketPairList failed");
+                    } else {
+                        out.printMessage(Utils.formatMessageString(result), "GetMarketPairList failed");
+                    }
+                })
+                .build());
+    }
+
+    private static void registerGetMarketPriceByPair(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("get-market-price-by-pair")
+                .aliases("getmarketpricebypair")
+                .description("Get market price by token pair")
+                .option("sell-token", "Sell token name", true)
+                .option("buy-token", "Buy token name", true)
+                .handler((opts, wrapper, out) -> {
+                    Response.MarketPriceList result = WalletApi.getMarketPriceByPair(
+                            opts.getString("sell-token").getBytes(),
+                            opts.getString("buy-token").getBytes());
+                    if (result == null) {
+                        out.error("query_failed", "GetMarketPriceByPair failed");
+                    } else {
+                        out.printMessage(Utils.formatMessageString(result), "GetMarketPriceByPair failed");
+                    }
+                })
+                .build());
+    }
+
+    private static void registerGasFreeInfo(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("gas-free-info")
+                .aliases("gasfreeinfo")
+                .description("Get GasFree service info")
+                .option("address", "Address to query (default: current wallet)", false)
+                .handler((opts, wrapper, out) -> {
+                    String address = opts.has("address") ? opts.getString("address") : null;
+                    wrapper.getGasFreeInfo(address);
+                })
+                .build());
+    }
+
+    private static void registerGasFreeTrace(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("gas-free-trace")
+                .aliases("gasfreetrace")
+                .description("Trace a GasFree transaction")
+                .option("id", "Transaction ID", true)
+                .handler((opts, wrapper, out) -> {
+                    wrapper.gasFreeTrace(opts.getString("id"));
+                })
+                .build());
+    }
+}
diff --git a/src/main/java/org/tron/walletcli/cli/commands/StakingCommands.java b/src/main/java/org/tron/walletcli/cli/commands/StakingCommands.java
new file mode 100644
index 00000000..3c6d5c0d
--- /dev/null
+++ b/src/main/java/org/tron/walletcli/cli/commands/StakingCommands.java
@@ -0,0 +1,241 @@
+package org.tron.walletcli.cli.commands;
+
+import org.tron.common.utils.TransactionUtils;
+import org.tron.walletcli.cli.CommandDefinition;
+import org.tron.walletcli.cli.CommandRegistry;
+import org.tron.walletcli.cli.OptionDef;
+
+public class StakingCommands {
+
+    public static void register(CommandRegistry registry) {
+        registerFreezeBalance(registry);
+        registerFreezeBalanceV2(registry);
+        registerUnfreezeBalance(registry);
+        registerUnfreezeBalanceV2(registry);
+        registerWithdrawExpireUnfreeze(registry);
+        registerDelegateResource(registry);
+        registerUndelegateResource(registry);
+        registerCancelAllUnfreezeV2(registry);
+        registerWithdrawBalance(registry);
+        registerUnfreezeAsset(registry);
+    }
+
+    private static void registerFreezeBalance(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("freeze-balance")
+                .aliases("freezebalance")
+                .description("Freeze TRX for bandwidth/energy (v1, deprecated)")
+                .option("amount", "Amount to freeze in SUN", true, OptionDef.Type.LONG)
+                .option("duration", "Freeze duration in days", true, OptionDef.Type.LONG)
+                .option("resource", "Resource type (0=BANDWIDTH, 1=ENERGY)", false, OptionDef.Type.LONG)
+                .option("receiver", "Receiver address (for delegated freeze)", false)
+                .option("owner", "Owner address", false)
+                .option("multi", "Multi-signature mode", false, OptionDef.Type.BOOLEAN)
+                .handler((opts, wrapper, out) -> {
+                    byte[] owner = opts.has("owner") ? opts.getAddress("owner") : null;
+                    long amount = opts.getLong("amount");
+                    long duration = opts.getLong("duration");
+                    int resource = opts.has("resource") ? (int) opts.getLong("resource") : 0;
+                    byte[] receiver = opts.has("receiver") ? opts.getAddress("receiver") : null;
+                    boolean multi = opts.getBoolean("multi");
+                    boolean result = wrapper.freezeBalance(owner, amount, duration, resource, receiver, multi);
+                    out.result(result, "FreezeBalance successful !!", "FreezeBalance failed !!");
+                })
+                .build());
+    }
+
+    private static void registerFreezeBalanceV2(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("freeze-balance-v2")
+                .aliases("freezebalancev2")
+                .description("Freeze TRX for bandwidth/energy (Stake 2.0)")
+                .option("amount", "Amount to freeze in SUN", true, OptionDef.Type.LONG)
+                .option("resource", "Resource type (0=BANDWIDTH, 1=ENERGY)", false, OptionDef.Type.LONG)
+                .option("owner", "Owner address", false)
+                .option("permission-id", "Permission ID for signing (default: 0)", false, OptionDef.Type.LONG)
+                .option("multi", "Multi-signature mode", false, OptionDef.Type.BOOLEAN)
+                .handler((opts, wrapper, out) -> {
+                    byte[] owner = opts.has("owner") ? opts.getAddress("owner") : null;
+                    long amount = opts.getLong("amount");
+                    int resource = opts.has("resource") ? (int) opts.getLong("resource") : 0;
+                    int permissionId = opts.has("permission-id") ? (int) opts.getLong("permission-id") : 0;
+                    boolean multi = opts.getBoolean("multi");
+                    TransactionUtils.setPermissionIdOverride(permissionId);
+                    boolean result;
+                    try {
+                        result = wrapper.freezeBalanceV2(owner, amount, resource, multi);
+                    } finally {
+                        TransactionUtils.clearPermissionIdOverride();
+                    }
+                    out.result(result, "FreezeBalanceV2 successful !!", "FreezeBalanceV2 failed !!");
+                })
+                .build());
+    }
+
+    private static void registerUnfreezeBalance(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("unfreeze-balance")
+                .aliases("unfreezebalance")
+                .description("Unfreeze TRX (v1, deprecated)")
+                .option("resource", "Resource type (0=BANDWIDTH, 1=ENERGY)", false, OptionDef.Type.LONG)
+                .option("receiver", "Receiver address", false)
+                .option("owner", "Owner address", false)
+                .option("multi", "Multi-signature mode", false, OptionDef.Type.BOOLEAN)
+                .handler((opts, wrapper, out) -> {
+                    byte[] owner = opts.has("owner") ? opts.getAddress("owner") : null;
+                    int resource = opts.has("resource") ? (int) opts.getLong("resource") : 0;
+                    byte[] receiver = opts.has("receiver") ? opts.getAddress("receiver") : null;
+                    boolean multi = opts.getBoolean("multi");
+                    boolean result = wrapper.unfreezeBalance(owner, resource, receiver, multi);
+                    out.result(result, "UnfreezeBalance successful !!", "UnfreezeBalance failed !!");
+                })
+                .build());
+    }
+
+    private static void registerUnfreezeBalanceV2(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("unfreeze-balance-v2")
+                .aliases("unfreezebalancev2")
+                .description("Unfreeze TRX (Stake 2.0)")
+                .option("amount", "Amount to unfreeze in SUN", true, OptionDef.Type.LONG)
+                .option("resource", "Resource type (0=BANDWIDTH, 1=ENERGY)", false, OptionDef.Type.LONG)
+                .option("owner", "Owner address", false)
+                .option("permission-id", "Permission ID for signing (default: 0)", false, OptionDef.Type.LONG)
+                .option("multi", "Multi-signature mode", false, OptionDef.Type.BOOLEAN)
+                .handler((opts, wrapper, out) -> {
+                    byte[] owner = opts.has("owner") ? opts.getAddress("owner") : null;
+                    long amount = opts.getLong("amount");
+                    int resource = opts.has("resource") ? (int) opts.getLong("resource") : 0;
+                    int permissionId = opts.has("permission-id") ? (int) opts.getLong("permission-id") : 0;
+                    boolean multi = opts.getBoolean("multi");
+                    TransactionUtils.setPermissionIdOverride(permissionId);
+                    boolean result;
+                    try {
+                        result = wrapper.unfreezeBalanceV2(owner, amount, resource, multi);
+                    } finally {
+                        TransactionUtils.clearPermissionIdOverride();
+                    }
+                    out.result(result, "UnfreezeBalanceV2 successful !!", "UnfreezeBalanceV2 failed !!");
+                })
+                .build());
+    }
+
+    private static void registerWithdrawExpireUnfreeze(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("withdraw-expire-unfreeze")
+                .aliases("withdrawexpireunfreeze")
+                .description("Withdraw expired unfrozen TRX")
+                .option("owner", "Owner address", false)
+                .option("multi", "Multi-signature mode", false, OptionDef.Type.BOOLEAN)
+                .handler((opts, wrapper, out) -> {
+                    byte[] owner = opts.has("owner") ? opts.getAddress("owner") : null;
+                    boolean multi = opts.getBoolean("multi");
+                    boolean result = wrapper.withdrawExpireUnfreeze(owner, multi);
+                    out.result(result,
+                            "WithdrawExpireUnfreeze successful !!",
+                            "WithdrawExpireUnfreeze failed !!");
+                })
+                .build());
+    }
+
+    private static void registerDelegateResource(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("delegate-resource")
+                .aliases("delegateresource")
+                .description("Delegate bandwidth/energy to another address")
+                .option("amount", "Amount in SUN", true, OptionDef.Type.LONG)
+                .option("resource", "Resource type (0=BANDWIDTH, 1=ENERGY)", true, OptionDef.Type.LONG)
+                .option("receiver", "Receiver address", true)
+                .option("lock", "Lock delegation", false, OptionDef.Type.BOOLEAN)
+                .option("lock-period", "Lock period in blocks", false, OptionDef.Type.LONG)
+                .option("owner", "Owner address", false)
+                .option("multi", "Multi-signature mode", false, OptionDef.Type.BOOLEAN)
+                .handler((opts, wrapper, out) -> {
+                    byte[] owner = opts.has("owner") ? opts.getAddress("owner") : null;
+                    long amount = opts.getLong("amount");
+                    int resource = (int) opts.getLong("resource");
+                    byte[] receiver = opts.getAddress("receiver");
+                    boolean lock = opts.getBoolean("lock");
+                    long lockPeriod = opts.has("lock-period") ? opts.getLong("lock-period") : 0;
+                    boolean multi = opts.getBoolean("multi");
+                    boolean result = wrapper.delegateresource(owner, amount, resource, receiver,
+                            lock, lockPeriod, multi);
+                    out.result(result, "DelegateResource successful !!", "DelegateResource failed !!");
+                })
+                .build());
+    }
+
+    private static void registerUndelegateResource(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("undelegate-resource")
+                .aliases("undelegateresource")
+                .description("Undelegate bandwidth/energy")
+                .option("amount", "Amount in SUN", true, OptionDef.Type.LONG)
+                .option("resource", "Resource type (0=BANDWIDTH, 1=ENERGY)", true, OptionDef.Type.LONG)
+                .option("receiver", "Receiver address", true)
+                .option("owner", "Owner address", false)
+                .option("multi", "Multi-signature mode", false, OptionDef.Type.BOOLEAN)
+                .handler((opts, wrapper, out) -> {
+                    byte[] owner = opts.has("owner") ? opts.getAddress("owner") : null;
+                    long amount = opts.getLong("amount");
+                    int resource = (int) opts.getLong("resource");
+                    byte[] receiver = opts.getAddress("receiver");
+                    boolean multi = opts.getBoolean("multi");
+                    boolean result = wrapper.undelegateresource(owner, amount, resource, receiver, multi);
+                    out.result(result,
+                            "UndelegateResource successful !!",
+                            "UndelegateResource failed !!");
+                })
+                .build());
+    }
+
+    private static void registerCancelAllUnfreezeV2(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("cancel-all-unfreeze-v2")
+                .aliases("cancelallunfreezev2")
+                .description("Cancel all pending unfreeze V2 operations")
+                .option("owner", "Owner address", false)
+                .option("multi", "Multi-signature mode", false, OptionDef.Type.BOOLEAN)
+                .handler((opts, wrapper, out) -> {
+                    byte[] owner = opts.has("owner") ? opts.getAddress("owner") : null;
+                    boolean multi = opts.getBoolean("multi");
+                    boolean result = wrapper.cancelAllUnfreezeV2(owner, multi);
+                    out.result(result,
+                            "CancelAllUnfreezeV2 successful !!",
+                            "CancelAllUnfreezeV2 failed !!");
+                })
+                .build());
+    }
+
+    private static void registerWithdrawBalance(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("withdraw-balance")
+                .aliases("withdrawbalance")
+                .description("Withdraw witness balance")
+                .option("owner", "Owner address", false)
+                .option("multi", "Multi-signature mode", false, OptionDef.Type.BOOLEAN)
+                .handler((opts, wrapper, out) -> {
+                    byte[] owner = opts.has("owner") ? opts.getAddress("owner") : null;
+                    boolean multi = opts.getBoolean("multi");
+                    boolean result = wrapper.withdrawBalance(owner, multi);
+                    out.result(result, "WithdrawBalance successful !!", "WithdrawBalance failed !!");
+                })
+                .build());
+    }
+
+    private static void registerUnfreezeAsset(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("unfreeze-asset")
+                .aliases("unfreezeasset")
+                .description("Unfreeze TRC10 asset")
+                .option("owner", "Owner address", false)
+                .option("multi", "Multi-signature mode", false, OptionDef.Type.BOOLEAN)
+                .handler((opts, wrapper, out) -> {
+                    byte[] owner = opts.has("owner") ? opts.getAddress("owner") : null;
+                    boolean multi = opts.getBoolean("multi");
+                    boolean result = wrapper.unfreezeAsset(owner, multi);
+                    out.result(result, "UnfreezeAsset successful !!", "UnfreezeAsset failed !!");
+                })
+                .build());
+    }
+}
diff --git a/src/main/java/org/tron/walletcli/cli/commands/TransactionCommands.java b/src/main/java/org/tron/walletcli/cli/commands/TransactionCommands.java
new file mode 100644
index 00000000..d08a4efe
--- /dev/null
+++ b/src/main/java/org/tron/walletcli/cli/commands/TransactionCommands.java
@@ -0,0 +1,392 @@
+package org.tron.walletcli.cli.commands;
+
+import org.apache.commons.lang3.tuple.Triple;
+import org.bouncycastle.util.encoders.Hex;
+import org.tron.common.enums.NetType;
+import org.tron.common.utils.AbiUtil;
+import org.tron.common.utils.TransactionUtils;
+import org.tron.walletcli.cli.CommandDefinition;
+import org.tron.walletcli.cli.CommandRegistry;
+import org.tron.walletcli.cli.OptionDef;
+import org.tron.walletserver.WalletApi;
+
+import java.util.HashMap;
+import java.util.LinkedHashMap;
+import java.util.Map;
+
+public class TransactionCommands {
+
+    public static void register(CommandRegistry registry) {
+        registerSendCoin(registry);
+        registerTransferAsset(registry);
+        registerTransferUsdt(registry);
+        registerParticipateAssetIssue(registry);
+        registerAssetIssue(registry);
+        registerCreateAccount(registry);
+        registerUpdateAccount(registry);
+        registerSetAccountId(registry);
+        registerUpdateAsset(registry);
+        registerBroadcastTransaction(registry);
+        registerAddTransactionSign(registry);
+        registerUpdateAccountPermission(registry);
+        registerTronlinkMultiSign(registry);
+        registerGasFreeTransfer(registry);
+    }
+
+    private static void registerSendCoin(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("send-coin")
+                .aliases("sendcoin")
+                .description("Send TRX to an address")
+                .option("to", "Recipient address", true)
+                .option("amount", "Amount in SUN", true, OptionDef.Type.LONG)
+                .option("owner", "Sender address (default: current wallet)", false)
+                .option("permission-id", "Permission ID for signing (default: 0)", false, OptionDef.Type.LONG)
+                .option("multi", "Multi-signature mode", false, OptionDef.Type.BOOLEAN)
+                .handler((opts, wrapper, out) -> {
+                    byte[] owner = opts.has("owner") ? opts.getAddress("owner") : null;
+                    byte[] to = opts.getAddress("to");
+                    long amount = opts.getLong("amount");
+                    int permissionId = opts.has("permission-id") ? (int) opts.getLong("permission-id") : 0;
+                    boolean multi = opts.getBoolean("multi");
+                    TransactionUtils.setPermissionIdOverride(permissionId);
+                    boolean result;
+                    try {
+                        result = wrapper.sendCoin(owner, to, amount, multi);
+                    } finally {
+                        TransactionUtils.clearPermissionIdOverride();
+                    }
+                    String toStr = opts.getString("to");
+                    if (multi) {
+                        out.result(result,
+                                "create multi-sign transaction successful !!",
+                                "create multi-sign transaction failed !!");
+                    } else {
+                        String successMessage = "Send " + amount + " Sun to " + toStr + " successful !!";
+                        if (!result) {
+                            out.result(false, successMessage, "Send " + amount + " Sun to " + toStr + " failed !!");
+                            return;
+                        }
+                        Map<String, Object> json = new LinkedHashMap<String, Object>();
+                        json.put("message", successMessage);
+                        json.put("to", toStr);
+                        json.put("amount", amount);
+                        String txid = WalletApi.getLastBroadcastTxId();
+                        if (txid != null && !txid.isEmpty()) {
+                            json.put("txid", txid);
+                        }
+                        out.success(successMessage, json);
+                    }
+                })
+                .build());
+    }
+
+    private static void registerTransferAsset(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("transfer-asset")
+                .aliases("transferasset")
+                .description("Transfer a TRC10 asset")
+                .option("to", "Recipient address", true)
+                .option("asset", "Asset name", true)
+                .option("amount", "Amount", true, OptionDef.Type.LONG)
+                .option("owner", "Sender address", false)
+                .option("multi", "Multi-signature mode", false, OptionDef.Type.BOOLEAN)
+                .handler((opts, wrapper, out) -> {
+                    byte[] owner = opts.has("owner") ? opts.getAddress("owner") : null;
+                    byte[] to = opts.getAddress("to");
+                    String asset = opts.getString("asset");
+                    long amount = opts.getLong("amount");
+                    boolean multi = opts.getBoolean("multi");
+                    boolean result = wrapper.transferAsset(owner, to, asset, amount, multi);
+                    out.result(result, "TransferAsset successful !!", "TransferAsset failed !!");
+                })
+                .build());
+    }
+
+    private static void registerTransferUsdt(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("transfer-usdt")
+                .aliases("transferusdt")
+                .description("Transfer USDT (TRC20)")
+                .option("to", "Recipient address", true)
+                .option("amount", "Amount in smallest unit", true, OptionDef.Type.LONG)
+                .option("owner", "Sender address", false)
+                .option("permission-id", "Permission ID for signing (default: 0)", false, OptionDef.Type.LONG)
+                .option("multi", "Multi-signature mode", false, OptionDef.Type.BOOLEAN)
+                .handler((opts, wrapper, out) -> {
+                    NetType netType = WalletApi.getCurrentNetwork();
+                    if (netType.getUsdtAddress() == null) {
+                        out.error("unsupported_network",
+                                "transfer-usdt does not support the current network.");
+                        return;
+                    }
+                    byte[] owner = opts.has("owner") ? opts.getAddress("owner") : null;
+                    byte[] toAddress = opts.getAddress("to");
+                    long amount = opts.getLong("amount");
+                    int permissionId = opts.has("permission-id") ? (int) opts.getLong("permission-id") : 0;
+                    boolean multi = opts.getBoolean("multi");
+
+                    String toBase58 = WalletApi.encode58Check(toAddress);
+                    String inputStr = String.format("\"%s\",%d", toBase58, amount);
+                    String methodStr = "transfer(address,uint256)";
+                    byte[] data = Hex.decode(AbiUtil.parseMethod(methodStr, inputStr, false));
+                    byte[] contractAddress = WalletApi.decodeFromBase58Check(netType.getUsdtAddress());
+
+                    // Estimate energy to calculate fee limit
+                    TransactionUtils.setPermissionIdOverride(permissionId);
+                    Triple<Boolean, Long, Long> estimate;
+                    try {
+                        estimate = wrapper.callContract(
+                                owner, contractAddress, 0, data, 0, 0, "", true, true, false);
+                    } finally {
+                        TransactionUtils.clearPermissionIdOverride();
+                    }
+                    long energyUsed = estimate.getMiddle();
+                    // Get energy price from chain parameters and add 20% buffer
+                    long energyFee = wrapper.getChainParameters().getChainParameterList().stream()
+                            .filter(p -> "getEnergyFee".equals(p.getKey()))
+                            .mapToLong(org.tron.trident.proto.Response.ChainParameters.ChainParameter::getValue)
+                            .findFirst()
+                            .orElse(420L);
+                    long feeLimit = (long) (energyFee * energyUsed * 1.2);
+
+                    TransactionUtils.setPermissionIdOverride(permissionId);
+                    boolean result;
+                    try {
+                        result = wrapper.callContract(
+                                owner, contractAddress, 0, data, feeLimit, 0, "", false, false, multi)
+                                .getLeft();
+                    } finally {
+                        TransactionUtils.clearPermissionIdOverride();
+                    }
+                    out.result(result,
+                            "TransferUSDT successful !!",
+                            "TransferUSDT failed !!");
+                })
+                .build());
+    }
+
+    private static void registerParticipateAssetIssue(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("participate-asset-issue")
+                .aliases("participateassetissue")
+                .description("Participate in an asset issue")
+                .option("to", "Asset issuer address", true)
+                .option("asset", "Asset name", true)
+                .option("amount", "Amount", true, OptionDef.Type.LONG)
+                .option("owner", "Participant address", false)
+                .option("multi", "Multi-signature mode", false, OptionDef.Type.BOOLEAN)
+                .handler((opts, wrapper, out) -> {
+                    byte[] owner = opts.has("owner") ? opts.getAddress("owner") : null;
+                    byte[] to = opts.getAddress("to");
+                    String asset = opts.getString("asset");
+                    long amount = opts.getLong("amount");
+                    boolean multi = opts.getBoolean("multi");
+                    boolean result = wrapper.participateAssetIssue(owner, to, asset, amount, multi);
+                    out.result(result,
+                            "ParticipateAssetIssue successful !!",
+                            "ParticipateAssetIssue failed !!");
+                })
+                .build());
+    }
+
+    private static void registerAssetIssue(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("asset-issue")
+                .aliases("assetissue")
+                .description("Create a TRC10 asset")
+                .option("name", "Asset name", true)
+                .option("abbr", "Asset abbreviation", true)
+                .option("total-supply", "Total supply", true, OptionDef.Type.LONG)
+                .option("trx-num", "TRX number", true, OptionDef.Type.LONG)
+                .option("ico-num", "ICO number", true, OptionDef.Type.LONG)
+                .option("start-time", "ICO start time (ms)", true, OptionDef.Type.LONG)
+                .option("end-time", "ICO end time (ms)", true, OptionDef.Type.LONG)
+                .option("precision", "Precision (default: 0)", false, OptionDef.Type.LONG)
+                .option("description", "Description", false)
+                .option("url", "URL", true)
+                .option("free-net-limit", "Free net limit per account", true, OptionDef.Type.LONG)
+                .option("public-free-net-limit", "Public free net limit", true, OptionDef.Type.LONG)
+                .option("owner", "Owner address", false)
+                .option("multi", "Multi-signature mode", false, OptionDef.Type.BOOLEAN)
+                .handler((opts, wrapper, out) -> {
+                    byte[] owner = opts.has("owner") ? opts.getAddress("owner") : null;
+                    String name = opts.getString("name");
+                    String abbr = opts.getString("abbr");
+                    long totalSupply = opts.getLong("total-supply");
+                    int trxNum = (int) opts.getLong("trx-num");
+                    int icoNum = (int) opts.getLong("ico-num");
+                    int precision = opts.has("precision") ? (int) opts.getLong("precision") : 0;
+                    long startTime = opts.getLong("start-time");
+                    long endTime = opts.getLong("end-time");
+                    String desc = opts.has("description") ? opts.getString("description") : "";
+                    String url = opts.getString("url");
+                    long freeNetLimit = opts.getLong("free-net-limit");
+                    long publicFreeNetLimit = opts.getLong("public-free-net-limit");
+                    boolean multi = opts.getBoolean("multi");
+                    HashMap<String, String> frozenSupply = new HashMap<String, String>();
+                    boolean result = wrapper.assetIssue(owner, name, abbr, totalSupply,
+                            trxNum, icoNum, precision, startTime, endTime, 0, desc, url,
+                            freeNetLimit, publicFreeNetLimit, frozenSupply, multi);
+                    out.result(result, "AssetIssue successful !!", "AssetIssue failed !!");
+                })
+                .build());
+    }
+
+    private static void registerCreateAccount(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("create-account")
+                .aliases("createaccount")
+                .description("Create a new account on chain")
+                .option("address", "New account address", true)
+                .option("owner", "Creator address", false)
+                .option("multi", "Multi-signature mode", false, OptionDef.Type.BOOLEAN)
+                .handler((opts, wrapper, out) -> {
+                    byte[] owner = opts.has("owner") ? opts.getAddress("owner") : null;
+                    byte[] address = opts.getAddress("address");
+                    boolean multi = opts.getBoolean("multi");
+                    boolean result = wrapper.createAccount(owner, address, multi);
+                    out.result(result, "CreateAccount successful !!", "CreateAccount failed !!");
+                })
+                .build());
+    }
+
+    private static void registerUpdateAccount(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("update-account")
+                .aliases("updateaccount")
+                .description("Update account name")
+                .option("name", "Account name", true)
+                .option("owner", "Owner address", false)
+                .option("multi", "Multi-signature mode", false, OptionDef.Type.BOOLEAN)
+                .handler((opts, wrapper, out) -> {
+                    byte[] owner = opts.has("owner") ? opts.getAddress("owner") : null;
+                    byte[] nameBytes = opts.getString("name").getBytes();
+                    boolean multi = opts.getBoolean("multi");
+                    boolean result = wrapper.updateAccount(owner, nameBytes, multi);
+                    out.result(result, "Update Account successful !!", "Update Account failed !!");
+                })
+                .build());
+    }
+
+    private static void registerSetAccountId(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("set-account-id")
+                .aliases("setaccountid")
+                .description("Set account ID")
+                .option("id", "Account ID", true)
+                .option("owner", "Owner address", false)
+                .handler((opts, wrapper, out) -> {
+                    byte[] owner = opts.has("owner") ? opts.getAddress("owner") : null;
+                    byte[] id = opts.getString("id").getBytes();
+                    boolean result = wrapper.setAccountId(owner, id);
+                    out.result(result, "Set AccountId successful !!", "Set AccountId failed !!");
+                })
+                .build());
+    }
+
+    private static void registerUpdateAsset(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("update-asset")
+                .aliases("updateasset")
+                .description("Update asset parameters")
+                .option("description", "New description", true)
+                .option("url", "New URL", true)
+                .option("new-limit", "New free net limit", true, OptionDef.Type.LONG)
+                .option("new-public-limit", "New public free net limit", true, OptionDef.Type.LONG)
+                .option("owner", "Owner address", false)
+                .option("multi", "Multi-signature mode", false, OptionDef.Type.BOOLEAN)
+                .handler((opts, wrapper, out) -> {
+                    byte[] owner = opts.has("owner") ? opts.getAddress("owner") : null;
+                    byte[] desc = opts.getString("description").getBytes();
+                    byte[] url = opts.getString("url").getBytes();
+                    long newLimit = opts.getLong("new-limit");
+                    long newPublicLimit = opts.getLong("new-public-limit");
+                    boolean multi = opts.getBoolean("multi");
+                    boolean result = wrapper.updateAsset(owner, desc, url, newLimit, newPublicLimit, multi);
+                    out.result(result, "UpdateAsset successful !!", "UpdateAsset failed !!");
+                })
+                .build());
+    }
+
+    private static void registerBroadcastTransaction(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("broadcast-transaction")
+                .aliases("broadcasttransaction")
+                .description("Broadcast a signed transaction")
+                .option("transaction", "Transaction hex string", true)
+                .handler((opts, wrapper, out) -> {
+                    byte[] txBytes = org.tron.common.utils.ByteArray.fromHexString(opts.getString("transaction"));
+                    boolean result = org.tron.walletserver.WalletApi.broadcastTransaction(txBytes);
+                    out.result(result,
+                            "BroadcastTransaction successful !!",
+                            "BroadcastTransaction failed !!");
+                })
+                .build());
+    }
+
+    private static void registerAddTransactionSign(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("add-transaction-sign")
+                .aliases("addtransactionsign")
+                .description("Add a signature to a transaction")
+                .option("transaction", "Transaction hex string", true)
+                .handler((opts, wrapper, out) -> {
+                    // addTransactionSign requires interactive password prompt
+                    // Delegates to the wrapper which handles signing
+                    out.error("not_implemented",
+                            "add-transaction-sign via standard CLI is not yet implemented. Use --interactive mode.");
+                })
+                .build());
+    }
+
+    private static void registerUpdateAccountPermission(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("update-account-permission")
+                .aliases("updateaccountpermission")
+                .description("Update account permissions (multi-sign setup)")
+                .option("owner", "Owner address", true)
+                .option("permissions", "Permissions JSON string", true)
+                .option("multi", "Multi-signature mode", false, OptionDef.Type.BOOLEAN)
+                .handler((opts, wrapper, out) -> {
+                    byte[] owner = opts.getAddress("owner");
+                    String permissions = opts.getString("permissions");
+                    boolean multi = opts.getBoolean("multi");
+                    boolean result = wrapper.accountPermissionUpdate(owner, permissions, multi);
+                    out.result(result,
+                            "UpdateAccountPermission successful !!",
+                            "UpdateAccountPermission failed !!");
+                })
+                .build());
+    }
+
+    private static void registerTronlinkMultiSign(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("tronlink-multi-sign")
+                .aliases("tronlinkmultisign")
+                .description("TronLink multi-sign transaction")
+                .handler((opts, wrapper, out) -> {
+                    wrapper.tronlinkMultiSign();
+                    out.result(true, "TronlinkMultiSign successful !!", "TronlinkMultiSign failed !!");
+                })
+                .build());
+    }
+
+    private static void registerGasFreeTransfer(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("gas-free-transfer")
+                .aliases("gasfreetransfer")
+                .description("Transfer tokens via GasFree service")
+                .option("to", "Recipient address", true)
+                .option("amount", "Amount", true, OptionDef.Type.LONG)
+                .handler((opts, wrapper, out) -> {
+                    String to = opts.getString("to");
+                    long amount = opts.getLong("amount");
+                    boolean result = wrapper.gasFreeTransfer(to, amount);
+                    out.result(result,
+                            "GasFreeTransfer successful !!",
+                            "GasFreeTransfer failed !!");
+                })
+                .build());
+    }
+}
diff --git a/src/main/java/org/tron/walletcli/cli/commands/WalletCommands.java b/src/main/java/org/tron/walletcli/cli/commands/WalletCommands.java
new file mode 100644
index 00000000..f4c1e533
--- /dev/null
+++ b/src/main/java/org/tron/walletcli/cli/commands/WalletCommands.java
@@ -0,0 +1,469 @@
+package org.tron.walletcli.cli.commands;
+
+import org.tron.common.crypto.ECKey;
+import org.tron.common.utils.ByteArray;
+import org.tron.keystore.Wallet;
+import org.tron.keystore.WalletFile;
+import org.tron.keystore.WalletUtils;
+import org.tron.mnemonic.MnemonicUtils;
+import org.tron.walletcli.cli.ActiveWalletConfig;
+import org.tron.walletcli.cli.CommandDefinition;
+import org.tron.walletcli.cli.CommandRegistry;
+import org.tron.walletcli.cli.OptionDef;
+import org.tron.walletserver.WalletApi;
+
+import java.io.File;
+import java.util.ArrayList;
+import java.util.Arrays;
+import java.util.LinkedHashMap;
+import java.util.List;
+import java.util.Map;
+
+public class WalletCommands {
+
+    public static void register(CommandRegistry registry) {
+        registerRegisterWallet(registry);
+        registerImportWallet(registry);
+        registerImportWalletByMnemonic(registry);
+        registerListWallet(registry);
+        registerSetActiveWallet(registry);
+        registerGetActiveWallet(registry);
+        registerChangePassword(registry);
+        registerClearWalletKeystore(registry);
+        registerResetWallet(registry);
+        registerModifyWalletName(registry);
+        registerSwitchNetwork(registry);
+        registerLock(registry);
+        registerUnlock(registry);
+        registerGenerateSubAccount(registry);
+    }
+
+    private static void registerRegisterWallet(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("register-wallet")
+                .aliases("registerwallet")
+                .description("Create a new wallet")
+                .option("words", "Mnemonic word count (12 or 24, default: 12)", false, OptionDef.Type.LONG)
+                .handler((opts, wrapper, out) -> {
+                    int wordCount = opts.has("words") ? (int) opts.getLong("words") : 12;
+                    String envPassword = System.getenv("MASTER_PASSWORD");
+                    if (envPassword == null || envPassword.isEmpty()) {
+                        out.error("auth_required",
+                                "Set MASTER_PASSWORD environment variable for non-interactive wallet creation");
+                        return;
+                    }
+                    char[] password = envPassword.toCharArray();
+                    String keystoreName = wrapper.registerWallet(password, wordCount);
+                    if (keystoreName != null) {
+                        // Auto-set as active wallet
+                        String address = keystoreName.replace(".json", "");
+                        ActiveWalletConfig.setActiveAddress(address);
+                        out.raw("Register a wallet successful, keystore file name is " + keystoreName);
+                    } else {
+                        out.error("register_failed", "Register wallet failed");
+                    }
+                })
+                .build());
+    }
+
+    private static void registerImportWallet(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("import-wallet")
+                .aliases("importwallet")
+                .description("Import a wallet by private key (uses MASTER_PASSWORD env for encryption)")
+                .option("private-key", "Private key hex string", true)
+                .option("name", "Wallet name (default: mywallet)", false)
+                .handler((opts, wrapper, out) -> {
+                    String envPassword = System.getenv("MASTER_PASSWORD");
+                    if (envPassword == null || envPassword.isEmpty()) {
+                        out.error("auth_required",
+                                "Set MASTER_PASSWORD environment variable");
+                        return;
+                    }
+                    byte[] passwd = org.tron.keystore.StringUtils.char2Byte(
+                            envPassword.toCharArray());
+                    byte[] priKey = ByteArray.fromHexString(opts.getString("private-key"));
+                    try {
+                        String walletName = opts.has("name") ? opts.getString("name") : "mywallet";
+
+                        ECKey ecKey = ECKey.fromPrivate(priKey);
+                        WalletFile walletFile = Wallet.createStandard(passwd, ecKey);
+                        walletFile.setName(walletName);
+                        String keystoreName = WalletApi.store2Keystore(walletFile);
+                        String address = WalletApi.encode58Check(ecKey.getAddress());
+
+                        // Auto-set as active wallet
+                        ActiveWalletConfig.setActiveAddress(walletFile.getAddress());
+
+                        Map<String, Object> json = new LinkedHashMap<String, Object>();
+                        json.put("keystore", keystoreName);
+                        json.put("address", address);
+                        out.success("Import wallet successful, keystore: " + keystoreName, json);
+                    } finally {
+                        Arrays.fill(priKey, (byte) 0);
+                        Arrays.fill(passwd, (byte) 0);
+                    }
+                })
+                .build());
+    }
+
+    private static void registerImportWalletByMnemonic(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("import-wallet-by-mnemonic")
+                .aliases("importwalletbymnemonic")
+                .description("Import a wallet by mnemonic phrase (uses MASTER_PASSWORD env for encryption)")
+                .option("mnemonic", "Mnemonic words (space-separated)", true)
+                .option("name", "Wallet name (default: mywallet)", false)
+                .handler((opts, wrapper, out) -> {
+                    String envPassword = System.getenv("MASTER_PASSWORD");
+                    if (envPassword == null || envPassword.isEmpty()) {
+                        out.error("auth_required",
+                                "Set MASTER_PASSWORD environment variable");
+                        return;
+                    }
+                    byte[] passwd = org.tron.keystore.StringUtils.char2Byte(
+                            envPassword.toCharArray());
+                    List<String> words = Arrays.asList(
+                            opts.getString("mnemonic").split("\\s+"));
+                    String walletName = opts.has("name") ? opts.getString("name") : "mywallet";
+
+                    byte[] priKey = MnemonicUtils.getPrivateKeyFromMnemonic(words);
+                    ECKey ecKey = ECKey.fromPrivate(priKey);
+                    WalletFile walletFile = Wallet.createStandard(passwd, ecKey);
+                    walletFile.setName(walletName);
+                    String keystoreName = WalletApi.store2Keystore(walletFile);
+                    String address = WalletApi.encode58Check(ecKey.getAddress());
+                    Arrays.fill(priKey, (byte) 0);
+
+                    // Auto-set as active wallet
+                    ActiveWalletConfig.setActiveAddress(walletFile.getAddress());
+
+                    Map<String, Object> json = new LinkedHashMap<String, Object>();
+                    json.put("keystore", keystoreName);
+                    json.put("address", address);
+                    out.success("Import wallet by mnemonic successful, keystore: " + keystoreName, json);
+                })
+                .build());
+    }
+
+    private static void registerListWallet(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("list-wallet")
+                .aliases("listwallet")
+                .description("List all wallets with active status")
+                .handler((opts, wrapper, out) -> {
+                    File dir = new File("Wallet");
+                    if (!dir.exists() || !dir.isDirectory()) {
+                        out.error("no_wallets", "No wallet directory found");
+                        return;
+                    }
+                    File[] files = dir.listFiles((d, name) -> name.endsWith(".json"));
+                    if (files == null || files.length == 0) {
+                        out.error("no_wallets", "No wallet files found");
+                        return;
+                    }
+
+                    String activeAddress = ActiveWalletConfig.getActiveAddress();
+                    List<Map<String, Object>> wallets = new ArrayList<Map<String, Object>>();
+
+                    for (File f : files) {
+                        WalletFile wf = WalletUtils.loadWalletFile(f);
+                        String walletName = wf.getName();
+                        if (walletName == null || walletName.isEmpty()) {
+                            walletName = f.getName();
+                        }
+                        String address = wf.getAddress();
+                        boolean isActive = address != null && address.equals(activeAddress);
+
+                        Map<String, Object> entry = new LinkedHashMap<String, Object>();
+                        entry.put("wallet-name", walletName);
+                        entry.put("wallet-address", address);
+                        entry.put("is-active", isActive);
+                        wallets.add(entry);
+                    }
+
+                    // Text output
+                    StringBuilder text = new StringBuilder();
+                    text.append(String.format("%-30s %-42s %-8s", "Name", "Address", "Active"));
+                    text.append("\n");
+                    for (Map<String, Object> w : wallets) {
+                        text.append(String.format("%-30s %-42s %-8s",
+                                w.get("wallet-name"),
+                                w.get("wallet-address"),
+                                (Boolean) w.get("is-active") ? "*" : ""));
+                        text.append("\n");
+                    }
+
+                    Map<String, Object> json = new LinkedHashMap<String, Object>();
+                    json.put("wallets", wallets);
+                    out.success(text.toString().trim(), json);
+                })
+                .build());
+    }
+
+    private static void registerSetActiveWallet(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("set-active-wallet")
+                .aliases("setactivewallet")
+                .description("Set the active wallet by address or name")
+                .option("address", "Wallet address (Base58Check)", false)
+                .option("name", "Wallet name", false)
+                .handler((opts, wrapper, out) -> {
+                    boolean hasAddress = opts.has("address");
+                    boolean hasName = opts.has("name");
+
+                    if (!hasAddress && !hasName) {
+                        out.error("missing_option",
+                                "Provide --address or --name to identify the wallet");
+                        return;
+                    }
+                    if (hasAddress && hasName) {
+                        out.error("invalid_options",
+                                "Provide either --address or --name, not both");
+                        return;
+                    }
+
+                    File walletFile;
+                    if (hasAddress) {
+                        walletFile = ActiveWalletConfig.findWalletFileByAddress(
+                                opts.getString("address"));
+                        if (walletFile == null) {
+                            out.error("not_found",
+                                    "No wallet found with address: " + opts.getString("address"));
+                            return;
+                        }
+                    } else {
+                        try {
+                            walletFile = ActiveWalletConfig.findWalletFileByName(
+                                    opts.getString("name"));
+                        } catch (IllegalArgumentException e) {
+                            out.error("ambiguous_name", e.getMessage());
+                            return;
+                        }
+                        if (walletFile == null) {
+                            out.error("not_found",
+                                    "No wallet found with name: " + opts.getString("name"));
+                            return;
+                        }
+                    }
+
+                    WalletFile wf = WalletUtils.loadWalletFile(walletFile);
+                    ActiveWalletConfig.setActiveAddress(wf.getAddress());
+
+                    Map<String, Object> json = new LinkedHashMap<String, Object>();
+                    json.put("wallet-address", wf.getAddress());
+                    out.success("Active wallet set to: " + wf.getAddress(), json);
+                })
+                .build());
+    }
+
+    private static void registerGetActiveWallet(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("get-active-wallet")
+                .aliases("getactivewallet")
+                .description("Get the current active wallet")
+                .handler((opts, wrapper, out) -> {
+                    String activeAddress = ActiveWalletConfig.getActiveAddress();
+                    if (activeAddress == null) {
+                        out.error("no_active_wallet", "No active wallet set");
+                        return;
+                    }
+
+                    File walletFile = ActiveWalletConfig.findWalletFileByAddress(activeAddress);
+                    if (walletFile == null) {
+                        out.error("wallet_not_found",
+                                "Active wallet keystore not found for address: " + activeAddress);
+                        return;
+                    }
+
+                    WalletFile wf = WalletUtils.loadWalletFile(walletFile);
+                    String walletName = wf.getName();
+                    if (walletName == null || walletName.isEmpty()) {
+                        walletName = walletFile.getName();
+                    }
+
+                    Map<String, Object> json = new LinkedHashMap<String, Object>();
+                    json.put("wallet-name", walletName);
+                    json.put("wallet-address", wf.getAddress());
+                    out.success("Active wallet: " + walletName + " (" + wf.getAddress() + ")", json);
+                })
+                .build());
+    }
+
+    private static void registerChangePassword(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("change-password")
+                .aliases("changepassword")
+                .description("Change the password of a wallet keystore")
+                .option("old-password", "Current keystore password", true)
+                .option("new-password", "New keystore password", true)
+                .option("address", "Wallet address (Base58Check)", false)
+                .option("name", "Wallet name", false)
+                .handler((opts, wrapper, out) -> {
+                    boolean hasAddress = opts.has("address");
+                    boolean hasName = opts.has("name");
+                    if (hasAddress && hasName) {
+                        out.error("invalid_options",
+                                "Provide either --address or --name, not both");
+                        return;
+                    }
+
+                    File targetWalletFile;
+                    try {
+                        targetWalletFile = resolveWalletFileForNonInteractiveCommand(
+                                hasAddress ? opts.getString("address") : null,
+                                hasName ? opts.getString("name") : null);
+                    } catch (IllegalArgumentException e) {
+                        out.error("ambiguous_name", e.getMessage());
+                        return;
+                    }
+
+                    if (targetWalletFile == null) {
+                        out.error("not_found", "No wallet found to change password");
+                        return;
+                    }
+
+                    boolean result = wrapper.changePassword(
+                            opts.getString("old-password").toCharArray(),
+                            opts.getString("new-password").toCharArray(),
+                            targetWalletFile);
+                    out.result(result,
+                            "ChangePassword successful !!",
+                            "ChangePassword failed !!");
+                })
+                .build());
+    }
+
+    private static void registerClearWalletKeystore(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("clear-wallet-keystore")
+                .aliases("clearwalletkeystore")
+                .description("Clear wallet keystore files")
+                .option("force", "Skip interactive confirmation", false, OptionDef.Type.BOOLEAN)
+                .handler((opts, wrapper, out) -> {
+                    ActiveWalletConfig.clear();
+                    boolean result = wrapper.clearWalletKeystore(opts.getBoolean("force"));
+                    out.result(result,
+                            "ClearWalletKeystore successful !!",
+                            "ClearWalletKeystore failed !!");
+                })
+                .build());
+    }
+
+    private static void registerResetWallet(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("reset-wallet")
+                .aliases("resetwallet")
+                .description("Reset wallet to initial state")
+                .option("force", "Skip interactive confirmation", false, OptionDef.Type.BOOLEAN)
+                .handler((opts, wrapper, out) -> {
+                    ActiveWalletConfig.clear();
+                    boolean result = wrapper.resetWallet(opts.getBoolean("force"));
+                    out.result(result, "ResetWallet successful !!", "ResetWallet failed !!");
+                })
+                .build());
+    }
+
+    private static void registerModifyWalletName(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("modify-wallet-name")
+                .aliases("modifywalletname")
+                .description("Modify wallet display name")
+                .option("name", "New wallet name", true)
+                .handler((opts, wrapper, out) -> {
+                    boolean result = wrapper.modifyWalletName(opts.getString("name"));
+                    out.result(result,
+                            "ModifyWalletName successful !!",
+                            "ModifyWalletName failed !!");
+                })
+                .build());
+    }
+
+    private static void registerSwitchNetwork(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("switch-network")
+                .aliases("switchnetwork")
+                .description("Switch to a different network")
+                .option("network", "Network (main/nile/shasta/custom)", true)
+                .option("full-node", "Custom full node endpoint", false)
+                .option("solidity-node", "Custom solidity node endpoint", false)
+                .handler((opts, wrapper, out) -> {
+                    String network = opts.getString("network");
+                    String fullNode = opts.has("full-node") ? opts.getString("full-node") : null;
+                    String solidityNode = opts.has("solidity-node") ? opts.getString("solidity-node") : null;
+                    boolean result = wrapper.switchNetwork(network, fullNode, solidityNode);
+                    out.result(result,
+                            "SwitchNetwork successful !!",
+                            "SwitchNetwork failed !!");
+                })
+                .build());
+    }
+
+    private static void registerLock(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("lock")
+                .aliases("lock")
+                .description("Lock the wallet")
+                .handler((opts, wrapper, out) -> {
+                    boolean result = wrapper.lock();
+                    out.result(result, "Lock successful !!", "Lock failed !!");
+                })
+                .build());
+    }
+
+    private static void registerUnlock(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("unlock")
+                .aliases("unlock")
+                .description("Unlock the wallet for a duration")
+                .option("duration", "Duration in seconds", true, OptionDef.Type.LONG)
+                .handler((opts, wrapper, out) -> {
+                    long duration = opts.getLong("duration");
+                    boolean result = wrapper.unlock(duration);
+                    out.result(result, "Unlock successful !!", "Unlock failed !!");
+                })
+                .build());
+    }
+
+    private static void registerGenerateSubAccount(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("generate-sub-account")
+                .aliases("generatesubaccount")
+                .description("Generate a sub-account from mnemonic")
+                .handler((opts, wrapper, out) -> {
+                    boolean result = wrapper.generateSubAccount();
+                    out.result(result,
+                            "GenerateSubAccount successful !!",
+                            "GenerateSubAccount failed !!");
+                })
+                .build());
+    }
+
+    private static File resolveWalletFileForNonInteractiveCommand(String address, String name)
+            throws Exception {
+        if (address != null) {
+            return ActiveWalletConfig.findWalletFileByAddress(address);
+        }
+        if (name != null) {
+            return ActiveWalletConfig.findWalletFileByName(name);
+        }
+
+        String activeAddress = ActiveWalletConfig.getActiveAddress();
+        if (activeAddress != null) {
+            File activeFile = ActiveWalletConfig.findWalletFileByAddress(activeAddress);
+            if (activeFile != null) {
+                return activeFile;
+            }
+        }
+
+        File dir = new File("Wallet");
+        if (!dir.exists() || !dir.isDirectory()) {
+            return null;
+        }
+        File[] files = dir.listFiles((d, fileName) -> fileName.endsWith(".json"));
+        if (files == null || files.length == 0) {
+            return null;
+        }
+        return files[0];
+    }
+}
diff --git a/src/main/java/org/tron/walletcli/cli/commands/WitnessCommands.java b/src/main/java/org/tron/walletcli/cli/commands/WitnessCommands.java
new file mode 100644
index 00000000..859d8af9
--- /dev/null
+++ b/src/main/java/org/tron/walletcli/cli/commands/WitnessCommands.java
@@ -0,0 +1,107 @@
+package org.tron.walletcli.cli.commands;
+
+import org.tron.common.utils.TransactionUtils;
+import org.tron.walletcli.cli.CommandDefinition;
+import org.tron.walletcli.cli.CommandRegistry;
+import org.tron.walletcli.cli.OptionDef;
+
+import java.util.HashMap;
+
+public class WitnessCommands {
+
+    public static void register(CommandRegistry registry) {
+        registerCreateWitness(registry);
+        registerUpdateWitness(registry);
+        registerVoteWitness(registry);
+        registerUpdateBrokerage(registry);
+    }
+
+    private static void registerCreateWitness(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("create-witness")
+                .aliases("createwitness")
+                .description("Create a witness (super representative)")
+                .option("url", "Witness URL", true)
+                .option("owner", "Owner address", false)
+                .option("multi", "Multi-signature mode", false, OptionDef.Type.BOOLEAN)
+                .handler((opts, wrapper, out) -> {
+                    byte[] owner = opts.has("owner") ? opts.getAddress("owner") : null;
+                    String url = opts.getString("url");
+                    boolean multi = opts.getBoolean("multi");
+                    boolean result = wrapper.createWitness(owner, url, multi);
+                    out.result(result, "CreateWitness successful !!", "CreateWitness failed !!");
+                })
+                .build());
+    }
+
+    private static void registerUpdateWitness(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("update-witness")
+                .aliases("updatewitness")
+                .description("Update witness URL")
+                .option("url", "New witness URL", true)
+                .option("owner", "Owner address", false)
+                .option("multi", "Multi-signature mode", false, OptionDef.Type.BOOLEAN)
+                .handler((opts, wrapper, out) -> {
+                    byte[] owner = opts.has("owner") ? opts.getAddress("owner") : null;
+                    String url = opts.getString("url");
+                    boolean multi = opts.getBoolean("multi");
+                    boolean result = wrapper.updateWitness(owner, url, multi);
+                    out.result(result, "UpdateWitness successful !!", "UpdateWitness failed !!");
+                })
+                .build());
+    }
+
+    private static void registerVoteWitness(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("vote-witness")
+                .aliases("votewitness")
+                .description("Vote for witnesses (format: address1 count1 address2 count2 ...)")
+                .option("votes", "Votes as 'address1 count1 address2 count2 ...'", true)
+                .option("owner", "Voter address", false)
+                .option("permission-id", "Permission ID for signing (default: 0)", false, OptionDef.Type.LONG)
+                .option("multi", "Multi-signature mode", false, OptionDef.Type.BOOLEAN)
+                .handler((opts, wrapper, out) -> {
+                    byte[] owner = opts.has("owner") ? opts.getAddress("owner") : null;
+                    String votesStr = opts.getString("votes");
+                    int permissionId = opts.has("permission-id") ? (int) opts.getLong("permission-id") : 0;
+                    String[] parts = votesStr.trim().split("\\s+");
+                    if (parts.length % 2 != 0) {
+                        out.usageError("Votes must be pairs of 'address count'", null);
+                        return;
+                    }
+                    HashMap<String, String> witness = new HashMap<String, String>();
+                    for (int i = 0; i < parts.length; i += 2) {
+                        witness.put(parts[i], parts[i + 1]);
+                    }
+                    boolean multi = opts.getBoolean("multi");
+                    TransactionUtils.setPermissionIdOverride(permissionId);
+                    boolean result;
+                    try {
+                        result = wrapper.voteWitness(owner, witness, multi);
+                    } finally {
+                        TransactionUtils.clearPermissionIdOverride();
+                    }
+                    out.result(result, "VoteWitness successful !!", "VoteWitness failed !!");
+                })
+                .build());
+    }
+
+    private static void registerUpdateBrokerage(CommandRegistry registry) {
+        registry.add(CommandDefinition.builder()
+                .name("update-brokerage")
+                .aliases("updatebrokerage")
+                .description("Update witness brokerage ratio")
+                .option("brokerage", "Brokerage ratio (0-100)", true, OptionDef.Type.LONG)
+                .option("owner", "Owner address", false)
+                .option("multi", "Multi-signature mode", false, OptionDef.Type.BOOLEAN)
+                .handler((opts, wrapper, out) -> {
+                    byte[] owner = opts.has("owner") ? opts.getAddress("owner") : null;
+                    int brokerage = (int) opts.getLong("brokerage");
+                    boolean multi = opts.getBoolean("multi");
+                    boolean result = wrapper.updateBrokerage(owner, brokerage, multi);
+                    out.result(result, "UpdateBrokerage successful !!", "UpdateBrokerage failed !!");
+                })
+                .build());
+    }
+}
diff --git a/src/main/java/org/tron/walletserver/WalletApi.java b/src/main/java/org/tron/walletserver/WalletApi.java
index addc7e7f..7bed5062 100644
--- a/src/main/java/org/tron/walletserver/WalletApi.java
+++ b/src/main/java/org/tron/walletserver/WalletApi.java
@@ -152,6 +152,7 @@
 
 @Slf4j
 public class WalletApi {
+  private static final ThreadLocal<String> LAST_BROADCAST_TX_ID = new ThreadLocal<String>();
   public static final long TRX_PRECISION = 1000_000L;
   private static final String FilePath = "Wallet";
   private static final String MnemonicFilePath = "Mnemonic";
@@ -600,7 +601,7 @@ public static File selcetWalletFile() throws IOException {
       return null;
     }
 
-    File[] wallets = file.listFiles();
+    File[] wallets = file.listFiles((dir, name) -> !name.equals(".active-wallet"));
     if (ArrayUtils.isEmpty(wallets)) {
       return null;
     }
@@ -659,7 +660,7 @@ public static File[] getAllWalletFile() {
       return new File[0];
     }
 
-    File[] wallets = file.listFiles();
+    File[] wallets = file.listFiles((dir, name) -> !name.equals(".active-wallet"));
     if (ArrayUtils.isEmpty(wallets)) {
       return new File[0];
     }
@@ -741,6 +742,15 @@ public static boolean changeKeystorePassword(byte[] oldPassword, byte[] newPasso
       throw new IOException(
           "No keystore file found, please use " + greenBoldHighlight("RegisterWallet") + " or " + greenBoldHighlight("ImportWallet") + " first!");
     }
+    return changeKeystorePassword(oldPassword, newPassowrd, wallet);
+  }
+
+  public static boolean changeKeystorePassword(byte[] oldPassword, byte[] newPassowrd, File wallet)
+      throws IOException, CipherException {
+    if (wallet == null) {
+      throw new IOException(
+          "No keystore file found, please use " + greenBoldHighlight("RegisterWallet") + " or " + greenBoldHighlight("ImportWallet") + " first!");
+    }
     Credentials credentials = WalletUtils.loadCredentials(oldPassword, wallet);
     WalletUtils.updateWalletFile(newPassowrd, credentials.getPair(), wallet, true);
 
@@ -806,6 +816,25 @@ private boolean confirm() {
     }
   }
 
+  private WalletFile resolveSigningWalletFile() throws IOException {
+    if (isUnifiedExist()) {
+      return getWalletFile();
+    }
+    System.out.println("Please choose your key for sign.");
+    return selectWalletFileE();
+  }
+
+  private byte[] resolveSigningPassword(WalletFile wf) throws IOException {
+    if (isUnifiedExist()) {
+      return getUnifiedPassword();
+    }
+    if (lockAccount && Arrays.equals(decodeFromBase58Check(wf.getAddress()), getAddress())) {
+      return getUnifiedPassword();
+    }
+    System.out.println("Please input your password.");
+    return char2Byte(inputPassword(false));
+  }
+
   public boolean isUnifiedExist() {
     return isLoginState() && ArrayUtils.isNotEmpty(getUnifiedPassword());
   }
@@ -814,16 +843,9 @@ public Chain.Transaction signTransaction(Chain.Transaction transaction) throws I
     if (!isUnlocked()) {
       throw new IllegalStateException(LOCK_WARNING);
     }
-    System.out.println("Please choose your key for sign.");
-    WalletFile wf = selectWalletFileE();
+    WalletFile wf = resolveSigningWalletFile();
     boolean isLedgerFile = wf.getName().contains("Ledger");
-    byte[] passwd;
-    if (lockAccount && isUnifiedExist() && Arrays.equals(decodeFromBase58Check(wf.getAddress()), getAddress())) {
-      passwd = getUnifiedPassword();
-    } else {
-      System.out.println("Please input your password.");
-      passwd = char2Byte(inputPassword(false));
-    }
+    byte[] passwd = resolveSigningPassword(wf);
     String ledgerPath = getLedgerPath(passwd, wf);
     if (isLedgerFile) {
       boolean result = LedgerSignUtil.requestLedgerSignLogic(transaction, ledgerPath, wf.getAddress(), false);
@@ -877,16 +899,9 @@ private Chain.Transaction signTransaction(Chain.Transaction transaction, boolean
         + "default 0, other non-numeric characters will cancel transaction.";
     transaction = TransactionUtils.setPermissionId(transaction, tipsString);
     while (true) {
-      System.out.println("Please choose your key for sign.");
-      WalletFile wf = selectWalletFileE();
+      WalletFile wf = resolveSigningWalletFile();
       boolean isLedgerFile = wf.getName().contains("Ledger");
-      byte[] passwd;
-      if (lockAccount && isUnifiedExist() && Arrays.equals(decodeFromBase58Check(wf.getAddress()), getAddress())) {
-        passwd = getUnifiedPassword();
-      } else {
-        System.out.println("Please input your password.");
-        passwd = char2Byte(inputPassword(false));
-      }
+      byte[] passwd = resolveSigningPassword(wf);
       String ledgerPath = getLedgerPath(passwd, wf);
       if (isLedgerFile) {
         boolean result = LedgerSignUtil.requestLedgerSignLogic(transaction, ledgerPath, wf.getAddress(), false);
@@ -956,6 +971,7 @@ private Chain.Transaction signTransaction(Chain.Transaction transaction, boolean
 
   private boolean processTransactionExtention(Response.TransactionExtention transactionExtention, boolean multi)
       throws IOException, CipherException, CancelException {
+    LAST_BROADCAST_TX_ID.remove();
     if (transactionExtention == null) {
       return false;
     }
@@ -994,6 +1010,7 @@ private boolean processTransactionExtention(Response.TransactionExtention transa
     if (success) {
       TxHistoryManager txHistoryManager = new TxHistoryManager(encode58Check(getAddress()));
       String id = ByteArray.toHexString(Sha256Sm3Hash.hash(transaction.getRawData().toByteArray()));
+      LAST_BROADCAST_TX_ID.set(id);
       Tx tx = getTx(transaction);
       tx.setId(id);
       tx.setTimestamp(LocalDateTime.now());
@@ -1025,6 +1042,7 @@ private void showTransactionAfterSign(Chain.Transaction transaction)
 
   private boolean processTransaction(Chain.Transaction transaction)
       throws IOException, CipherException, CancelException {
+    LAST_BROADCAST_TX_ID.remove();
     if (transaction == null || transaction.getRawData().getContractCount() == 0) {
       return false;
     }
@@ -1043,6 +1061,7 @@ private boolean processTransaction(Chain.Transaction transaction)
     if (success) {
       TxHistoryManager txHistoryManager = new TxHistoryManager(encode58Check(getAddress()));
       String id = ByteArray.toHexString(Sha256Sm3Hash.hash(transaction.getRawData().toByteArray()));
+      LAST_BROADCAST_TX_ID.set(id);
       Tx tx = getTx(transaction);
       tx.setId(id);
       tx.setTimestamp(LocalDateTime.now());
@@ -1055,6 +1074,10 @@ private boolean processTransaction(Chain.Transaction transaction)
     return success;
   }
 
+  public static String getLastBroadcastTxId() {
+    return LAST_BROADCAST_TX_ID.get();
+  }
+
   public static TransactionSignWeight getTransactionSignWeight(Transaction transaction)
       throws InvalidProtocolBufferException {
     return TransactionSignWeight.parseFrom(
@@ -2758,7 +2781,7 @@ public boolean clearContractABI(byte[] owner, byte[] contractAddress, boolean mu
     return processTransactionExtention(transactionExtention, multi);
   }
 
-  public boolean clearWalletKeystore() {
+  public boolean clearWalletKeystore(boolean force) {
     String ownerAddress = WalletApi.encode58Check(getAddress());
 
     List<String> walletPath;
@@ -2786,7 +2809,9 @@ public boolean clearWalletKeystore() {
     }
 
     try {
-      return ClearWalletUtils.confirmAndDeleteWallet(ownerAddress, filePaths);
+      return force
+          ? ClearWalletUtils.forceDeleteWallet(ownerAddress, filePaths)
+          : ClearWalletUtils.confirmAndDeleteWallet(ownerAddress, filePaths);
     } catch (Exception e) {
       System.err.println("Error confirming and deleting wallet: " + e.getMessage());
       return false;
@@ -3230,15 +3255,8 @@ public Chain.Transaction addTransactionSign(Chain.Transaction transaction)
     String tipsString = "Please input permission id.";
     transaction = TransactionUtils.setPermissionId(transaction, tipsString);
 
-    System.out.println("Please choose your key for sign.");
-    WalletFile wf = selectWalletFileE();
-    byte[] passwd;
-    if (lockAccount && isUnifiedExist() && Arrays.equals(decodeFromBase58Check(wf.getAddress()), getAddress())) {
-      passwd = getUnifiedPassword();
-    } else {
-      System.out.println("Please input your password.");
-      passwd = char2Byte(inputPassword(false));
-    }
+    WalletFile wf = resolveSigningWalletFile();
+    byte[] passwd = resolveSigningPassword(wf);
     if (isEckey) {
       transaction = TransactionUtils.sign(transaction, this.getEcKey(wf, passwd));
     } else {
diff --git a/src/test/java/org/tron/walletcli/cli/GlobalOptionsTest.java b/src/test/java/org/tron/walletcli/cli/GlobalOptionsTest.java
new file mode 100644
index 00000000..fec1e606
--- /dev/null
+++ b/src/test/java/org/tron/walletcli/cli/GlobalOptionsTest.java
@@ -0,0 +1,58 @@
+package org.tron.walletcli.cli;
+
+import org.junit.Assert;
+import org.junit.Test;
+
+public class GlobalOptionsTest {
+
+  @Test
+  public void parseThrowsWhenGlobalOptionValueIsMissing() {
+    assertMissingValue("--output");
+    assertMissingValue("--network");
+    assertMissingValue("--wallet");
+    assertMissingValue("--grpc-endpoint");
+  }
+
+  @Test
+  public void parseFailsFastWhenNetworkValueIsMissingBeforeAnotherFlag() {
+    try {
+      GlobalOptions.parse(new String[]{"--network", "--output", "json", "send-coin"});
+      Assert.fail("Expected missing value error for --network");
+    } catch (IllegalArgumentException e) {
+      Assert.assertEquals("Missing value for --network", e.getMessage());
+    }
+  }
+
+  @Test
+  public void parseRejectsInvalidEnumeratedGlobalOptionValues() {
+    assertInvalidValue("--output", "yaml");
+  }
+
+  @Test
+  public void parseDoesNotTreatCommandTokenAsNetworkValue() {
+    try {
+      GlobalOptions.parse(new String[]{"--network", "send-coin", "--to", "TXYZ"});
+      Assert.fail("Expected invalid value error for --network");
+    } catch (IllegalArgumentException e) {
+      Assert.assertEquals("Invalid value for --network: send-coin", e.getMessage());
+    }
+  }
+
+  private void assertMissingValue(String option) {
+    try {
+      GlobalOptions.parse(new String[]{option});
+      Assert.fail("Expected missing value error for " + option);
+    } catch (IllegalArgumentException e) {
+      Assert.assertEquals("Missing value for " + option, e.getMessage());
+    }
+  }
+
+  private void assertInvalidValue(String option, String value) {
+    try {
+      GlobalOptions.parse(new String[]{option, value});
+      Assert.fail("Expected invalid value error for " + option);
+    } catch (IllegalArgumentException e) {
+      Assert.assertEquals("Invalid value for " + option + ": " + value, e.getMessage());
+    }
+  }
+}
diff --git a/src/test/java/org/tron/walletcli/cli/StandardCliRunnerTest.java b/src/test/java/org/tron/walletcli/cli/StandardCliRunnerTest.java
new file mode 100644
index 00000000..b0307a9d
--- /dev/null
+++ b/src/test/java/org/tron/walletcli/cli/StandardCliRunnerTest.java
@@ -0,0 +1,126 @@
+package org.tron.walletcli.cli;
+
+import org.junit.Assert;
+import org.junit.Test;
+
+import java.io.ByteArrayOutputStream;
+import java.io.InputStream;
+import java.io.PrintStream;
+import java.nio.charset.StandardCharsets;
+import java.util.Collections;
+import java.util.LinkedHashMap;
+import java.util.Map;
+
+public class StandardCliRunnerTest {
+
+  @Test
+  public void usageErrorDoesNotTerminateJvmAndRestoresStreams() {
+    CommandRegistry registry = new CommandRegistry();
+    registry.add(CommandDefinition.builder()
+        .name("needs-arg")
+        .description("Command with a required option")
+        .option("value", "Required value", true)
+        .handler((opts, wrapper, out) -> {
+          Map<String, Object> json = new LinkedHashMap<String, Object>();
+          json.put("value", opts.getString("value"));
+          out.success("ok", json);
+        })
+        .build());
+    registry.add(CommandDefinition.builder()
+        .name("ok")
+        .description("Simple success command")
+        .handler((opts, wrapper, out) -> {
+          Map<String, Object> json = Collections.<String, Object>singletonMap("status", "ok");
+          out.success("ok", json);
+        })
+        .build());
+
+    PrintStream originalOut = System.out;
+    PrintStream originalErr = System.err;
+    InputStream originalIn = System.in;
+
+    ByteArrayOutputStream firstStdout = new ByteArrayOutputStream();
+    ByteArrayOutputStream firstStderr = new ByteArrayOutputStream();
+    PrintStream firstOut = new PrintStream(firstStdout);
+    PrintStream firstErr = new PrintStream(firstStderr);
+    System.setOut(firstOut);
+    System.setErr(firstErr);
+    try {
+      GlobalOptions badOpts = GlobalOptions.parse(new String[]{"--output", "json", "needs-arg"});
+      int exitCode = new StandardCliRunner(registry, badOpts).execute();
+
+      Assert.assertEquals(2, exitCode);
+      String json = new String(firstStdout.toByteArray(), StandardCharsets.UTF_8);
+      Assert.assertTrue(json.contains("\"success\": false"));
+      Assert.assertTrue(json.contains("\"error\": \"usage_error\""));
+      Assert.assertSame(firstOut, System.out);
+      Assert.assertSame(firstErr, System.err);
+      Assert.assertSame(originalIn, System.in);
+    } finally {
+      System.setOut(originalOut);
+      System.setErr(originalErr);
+      System.setIn(originalIn);
+    }
+
+    ByteArrayOutputStream secondStdout = new ByteArrayOutputStream();
+    ByteArrayOutputStream secondStderr = new ByteArrayOutputStream();
+    PrintStream secondOut = new PrintStream(secondStdout);
+    PrintStream secondErr = new PrintStream(secondStderr);
+    System.setOut(secondOut);
+    System.setErr(secondErr);
+    try {
+      GlobalOptions okOpts = GlobalOptions.parse(new String[]{"--output", "json", "ok"});
+      int exitCode = new StandardCliRunner(registry, okOpts).execute();
+
+      Assert.assertEquals(0, exitCode);
+      String json = new String(secondStdout.toByteArray(), StandardCharsets.UTF_8);
+      Assert.assertTrue(json.contains("\"success\": true"));
+      Assert.assertTrue(json.contains("\"status\": \"ok\""));
+      Assert.assertEquals("", new String(secondStderr.toByteArray(), StandardCharsets.UTF_8));
+      Assert.assertSame(secondOut, System.out);
+      Assert.assertSame(secondErr, System.err);
+      Assert.assertSame(originalIn, System.in);
+    } finally {
+      System.setOut(originalOut);
+      System.setErr(originalErr);
+      System.setIn(originalIn);
+    }
+  }
+
+  @Test
+  public void executionErrorDoesNotTerminateJvmAndReturnsExitCodeOne() {
+    CommandRegistry registry = new CommandRegistry();
+    registry.add(CommandDefinition.builder()
+        .name("boom")
+        .description("Command that fails")
+        .handler((opts, wrapper, out) -> out.error("boom", "simulated failure"))
+        .build());
+
+    PrintStream originalOut = System.out;
+    PrintStream originalErr = System.err;
+    InputStream originalIn = System.in;
+    ByteArrayOutputStream stdout = new ByteArrayOutputStream();
+    ByteArrayOutputStream stderr = new ByteArrayOutputStream();
+    PrintStream testOut = new PrintStream(stdout);
+    PrintStream testErr = new PrintStream(stderr);
+    System.setOut(testOut);
+    System.setErr(testErr);
+    try {
+      GlobalOptions opts = GlobalOptions.parse(new String[]{"--output", "json", "boom"});
+      int exitCode = new StandardCliRunner(registry, opts).execute();
+
+      Assert.assertEquals(1, exitCode);
+      String json = new String(stdout.toByteArray(), StandardCharsets.UTF_8);
+      Assert.assertTrue(json.contains("\"success\": false"));
+      Assert.assertTrue(json.contains("\"error\": \"boom\""));
+      Assert.assertEquals("", new String(stderr.toByteArray(), StandardCharsets.UTF_8));
+      Assert.assertSame(testOut, System.out);
+      Assert.assertSame(testErr, System.err);
+      Assert.assertSame(originalIn, System.in);
+    } finally {
+      System.setOut(originalOut);
+      System.setErr(originalErr);
+      System.setIn(originalIn);
+    }
+  }
+}