feat: v4.13.0 (evm support & java standardCLI deprecate)

CLAUDE.md

@@ -33,9 +33,10 @@ npm run depcruise      # dependency-cruiser — enforces the architecture rules
 
 ### Architecture (hexagonal / ports & adapters)
 
-Dependencies point inward. The source of truth is
-`ts/docs/typescript-wallet-cli-architecture-source-of-truth.md` — read it before changing
-boundaries, ports, command routing, or the JSON contract. `depcruise` enforces these rules in CI.
+Dependencies point inward, and the table below is the rule — read it before changing boundaries,
+ports, or command routing. `depcruise` enforces it in CI (`ts/.dependency-cruiser.cjs`).
+`ts/docs/machine-interface.md` is the source of truth for the JSON contract (envelope, exit codes,
+stdout/stderr discipline).
 
 | Area (`ts/src/…`) | Role | May depend on | Must NOT depend on |
 |---|---|---|---|
@@ -73,14 +74,10 @@ Key points:
 # Build fat JAR (output: build/libs/wallet-cli.jar)
 ./gradlew shadowJar
 
-# Run in REPL 交互模式 (human-friendly, interactive prompts)
+# Run the interactive shell (the only way to run it)
 ./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
 
@@ -93,74 +90,46 @@ java -jar build/libs/wallet-cli.jar --output json --network nile get-account --a
 
 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_PRIVATE_KEY env var for private key)
-TRON_TEST_PRIVATE_KEY=<nile-private-key> bash qa/run.sh verify
+## End-to-end coverage
 
-# 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)
-```
+There is none, and there never was: the `qa/` harness that used to live here
+only ever drove the standard CLI, which was removed in v4.13.0. `./gradlew build`
+passing does **not** mean the interactive shell still works — changes that touch
+shared helpers must be walked through by hand against a funded Nile account.
 
 ## 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 (~4900 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.
+### One CLI Mode
 
-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/`.
+**REPL 交互模式** — `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 (~4800 lines).
 
-### Standard CLI Contract
-
-Before changing parser behavior, auth flow, JSON output, command success/failure semantics, or `qa/` expectations for
-the standard CLI, read:
-
-- `java/docs/standard-cli-contract-spec.md`
-
-Treat that file as the source of truth for the standard CLI contract unless the repository owner explicitly decides to
-revise it.
+The shell is started one way only: a bare `java -jar wallet-cli.jar`. The entry point recognises
+`--version` and `--help` and nothing else; any other argument prints a one-line pointer to the
+TypeScript CLI on stderr and exits 2. Non-interactive, scriptable and CI use belongs to `ts/`
+(npm `@tron-walletcli/wallet-cli`).
 
 ### 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.Client`** — REPL entry point and command dispatcher. Each command is a JCommander `@Parameters` inner class.
 - **`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 |
+| `walletcli` | REPL entry point, API wrapper |
 | `walletserver` | Core wallet API and gRPC communication |
 | `common` | Crypto utilities, encoding, enums, shared helpers |
 | `core` | Configuration, data converters, DAOs, exceptions, managers |

java/.gitignore

@@ -18,10 +18,4 @@ Wallet/
 Mnemonic/
 wallet_data/
 
-# QA runtime output
-qa/results/
-qa/runtime/
-qa/report.txt
-qa/.verify.lock/
-
 docs/superpowers

java/build.gradle

@@ -150,19 +150,3 @@ shadowJar {
     version = null
     mergeServiceFiles() //  https://github.com/grpc/grpc-java/issues/10853
 }
-
-task qaJar(type: Jar, dependsOn: [shadowJar, testClasses]) {
-    from zipTree(shadowJar.archiveFile)
-    from sourceSets.test.output
-    archiveBaseName.set('wallet-cli-qa')
-    archiveClassifier.set('')
-    archiveVersion.set('')
-    duplicatesStrategy = DuplicatesStrategy.EXCLUDE
-}
-
-task qaRun(type: JavaExec) {
-    classpath = sourceSets.test.runtimeClasspath
-    mainClass = 'org.tron.qa.QARunner'
-    args = project.hasProperty('qaArgs') ? project.property('qaArgs').split(' ') : ['list']
-    standardInput = System.in
-}