tronprotocol · gummy789j · Aug 17, 2026 · Aug 7, 2026 · Aug 10, 2026 · Aug 10, 2026
diff --git a/README.md b/README.md
@@ -14,10 +14,10 @@
 
 This repository holds **two independent implementations** that share the same purpose but target different users:
 
-- **[Java](java/README.md)** — the original, full-featured reference CLI. An interactive prompt (REPL) for people who want the complete TRON feature surface.
+- **[Java](java/README.md)** — the original, full-featured reference CLI. An interactive prompt (REPL) you drive by hand.
 - **[TypeScript](ts/README.md)** — an agent-first rewrite for automation. Standard subcommands with a stable JSON envelope, built for scripts, CI, and AI agents.
 
-Both manage the same kind of wallet on the same networks — your address is identical regardless of which you use. They differ in how you install and drive them, and in how much of TRON they cover. Pick one and read its own README for depth; this page gives you the basics of each so you can choose.
+Both manage the same kind of wallet on the same networks — your address is identical regardless of which you use. They cover the same TRON feature surface and differ in how you install and drive them. Pick one and read its own README for depth; this page gives you the basics of each so you can choose.
 
 ## At a glance
 
@@ -31,7 +31,7 @@ Both manage the same kind of wallet on the same networks — your address is ide
 | **Output for scripts** | Human-readable text.                                                                                                           | Stable JSON via `-o json` ([`wallet-cli.result.v1`](ts/docs/machine-interface.md)) + fixed exit codes (`0`/`1`/`2`).                                                                                                                                        |
 | **Config / networks**  | `config.conf` (net type + full node), or `SwitchNetwork` at runtime. Mainnet · Nile · Shasta · custom.                         | `--network` flag / `config` command. `tron:mainnet` · `tron:nile` · `tron:shasta`.                                                                                                                                                                          |
 | **Signing**            | Software keystore · Ledger.                                                                                                    | Encrypted local keystore · Ledger. Secrets never via argv/env.                                                                                                                                                                                              |
-| **Feature scope**      | **The full surface** — everything in the TypeScript column, plus TRC10 token issuance and on-chain DEX & governance/proposals. | **Core wallet ops** — HD wallets, TRX/TRC20/TRC10 transfers, staking & delegation, voting & rewards, contract call/deploy, multi-sig, GasFree transfers, message signing, and on-chain queries. |
+| **Feature scope**      | **The full surface** — wallets and transfers, staking, voting and rewards, governance, contracts, TRC10, and the on-chain exchange. | **The full surface** — HD wallets, TRX/TRC20/TRC10 transfers, staking & delegation, voting & rewards, governance proposals & super-representative operation, contract call/deploy/governance, TRC10 issuance, the on-chain Bancor exchange, multi-sig, GasFree transfers, message signing, and on-chain queries. |
 | **Best for**           | People at a terminal who want every TRON capability.                                                                           | Scripting, CI pipelines, and AI agents.                                                                                                                                                                                                                     |
 | **Full docs**          | [java/README.md](java/README.md)                                                                                               | [ts/README.md](ts/README.md)                                                                                                                                                                                                                                |
 
@@ -49,7 +49,7 @@ $ java -jar wallet-cli.jar        # opens the interactive prompt
 > GetBalance                      # TRX balance
 ```
 
-Full setup (config.conf, connecting to a node), the complete A–Z command list, and features like GasFree and multi-sig live in **[java/README.md](java/README.md)** — jump to [Setup](java/README.md#setup), [Quickstart](java/README.md#quickstart), [Commands](java/README.md#commands), or [GasFree](java/README.md#gasfree).
+Full setup (config.conf, connecting to a node), the complete A–Z command list, and features like GasFree and multi-sig live in **[java/README.md](java/README.md)** — jump to [Setup](java/README.md#setup), [Quickstart](java/README.md#quickstart), [Commands](java/README.md#commands), or [GasFree](java/README.md#contracts-gasfree--chain-data).
 
 ## TypeScript — get a taste
 
@@ -72,5 +72,5 @@ Every command has a reference page, and the JSON contract, exit codes, and agent
 ## Which should I use?
 
 - **Scripting, CI, or building an AI agent?** → the [TypeScript version](ts/README.md) — the JSON envelope and deterministic exit codes exist for exactly this.
-- **Working interactively and want the complete TRON toolkit** — TRC10 issuance, or on-chain DEX/governance/proposals? → the [Java version](java/README.md).
+- **Working interactively** — one long-running session at a `>` prompt, with the wallet unlocked once for the whole session? → the [Java version](java/README.md).
 - **Just sending TRX/tokens or staking from your own machine?** → either works; the TypeScript CLI is the lighter install (`npm install -g`, no build step).
diff --git a/java/docs/commands/index.md b/java/docs/commands/index.md
@@ -45,7 +45,7 @@ Type any command in the interactive wallet to see its built-in usage tips.
 | CreateProposal | [proposals.md#createproposal](proposals.md#createproposal) |
 | CreateWitness | [vote-reward.md#createwitness](vote-reward.md#createwitness) |
 | CurrentNetwork | [network.md#currentnetwork](network.md#currentnetwork) |
-| DelegateResource | [stake-v2.md#delegateresource-undelegateresource](stake-v2.md#delegateresource-undelegateresource) |
+| DelegateResource | [stake-v2.md#delegateresource](stake-v2.md#delegateresource) |
 | DeleteProposal | [proposals.md#deleteproposal](proposals.md#deleteproposal) |
 | DeployConstantContract | [contract.md#deployconstantcontract](contract.md#deployconstantcontract) |
 | DeployContract | [contract.md#deploycontract](contract.md#deploycontract) |
@@ -58,7 +58,7 @@ Type any command in the interactive wallet to see its built-in usage tips.
 | ExportWalletKeystore | [wallet.md#exportwalletkeystore](wallet.md#exportwalletkeystore) |
 | ExportWalletMnemonic | [wallet.md#exportwalletmnemonic](wallet.md#exportwalletmnemonic) |
 | FreezeBalance | [stake-v1-legacy.md#how-to-freezeunfreeze-balance](stake-v1-legacy.md#how-to-freezeunfreeze-balance) |
-| FreezeBalanceV2 | [stake-v2.md#freezebalancev2-unfreezebalancev2](stake-v2.md#freezebalancev2-unfreezebalancev2) |
+| FreezeBalanceV2 | [stake-v2.md#freezebalancev2](stake-v2.md#freezebalancev2) |
 | GasFreeInfo | [gasfree.md#gasfreeinfo](gasfree.md#gasfreeinfo) |
 | GasFreeTrace | [gasfree.md#gasfreetrace](gasfree.md#gasfreetrace) |
 | GasFreeTransfer | [gasfree.md#gasfreetransfer](gasfree.md#gasfreetransfer) |
@@ -145,17 +145,17 @@ Type any command in the interactive wallet to see its built-in usage tips.
 | TriggerConstantContract | [contract.md#triggerconstantcontract](contract.md#triggerconstantcontract) |
 | TriggerContract | [contract.md#triggercontract](contract.md#triggercontract) |
 | TronlinkMultiSign | [multisig.md#tronlinkmultisign](multisig.md#tronlinkmultisign) |
-| UnDelegateResource | [stake-v2.md#delegateresource-undelegateresource](stake-v2.md#delegateresource-undelegateresource) |
+| UnDelegateResource | [stake-v2.md#undelegateresource](stake-v2.md#undelegateresource) |
 | UnfreezeAsset | [transfer-trc10.md#unfreezeasset](transfer-trc10.md#unfreezeasset) |
 | UnfreezeBalance | [stake-v1-legacy.md#unfreezebalance-undelegate](stake-v1-legacy.md#unfreezebalance-undelegate) |
-| UnfreezeBalanceV2 | [stake-v2.md#freezebalancev2-unfreezebalancev2](stake-v2.md#freezebalancev2-unfreezebalancev2) |
+| UnfreezeBalanceV2 | [stake-v2.md#unfreezebalancev2](stake-v2.md#unfreezebalancev2) |
 | Unlock | [wallet.md#unlock](wallet.md#unlock) |
 | UpdateAccount | [account.md#updateaccount](account.md#updateaccount) |
 | UpdateAccountPermission | [multisig.md#updateaccountpermission](multisig.md#updateaccountpermission) |
 | UpdateAsset | [transfer-trc10.md#updateasset](transfer-trc10.md#updateasset) |
 | UpdateBrokerage | [vote-reward.md#updatebrokerage](vote-reward.md#updatebrokerage) |
-| UpdateEnergyLimit | [contract.md#updateenergylimit-updatesetting](contract.md#updateenergylimit-updatesetting) |
-| UpdateSetting | [contract.md#updateenergylimit-updatesetting](contract.md#updateenergylimit-updatesetting) |
+| UpdateEnergyLimit | [contract.md#updateenergylimit--updatesetting](contract.md#updateenergylimit--updatesetting) |
+| UpdateSetting | [contract.md#updateenergylimit--updatesetting](contract.md#updateenergylimit--updatesetting) |
 | UpdateWitness | [vote-reward.md#updatewitness](vote-reward.md#updatewitness) |
 | ViewBackupRecords | [account.md#viewbackuprecords](account.md#viewbackuprecords) |
 | ViewTransactionHistory | [account.md#viewtransactionhistory](account.md#viewtransactionhistory) |

diff --git a/java/src/main/java/org/tron/common/utils/Utils.java b/java/src/main/java/org/tron/common/utils/Utils.java
@@ -138,7 +138,7 @@ public class Utils {
 
   public static final int MIN_LENGTH = 2;
   public static final int MAX_LENGTH = 14;
-  public static final String VERSION = " v4.11.0";
+  public static final String VERSION = " v4.12.0";
   public static final String TRANSFER_METHOD_ID = "a9059cbb";
 
   private static SecureRandom random = new SecureRandom();

diff --git a/ts/.dependency-cruiser.cjs b/ts/.dependency-cruiser.cjs
@@ -30,7 +30,8 @@ module.exports = {
     {
       name: "inbound-does-not-know-outbound",
       severity: "error",
-      comment: "CLI adapters call application ports/use-cases; bootstrap/composition supplies outbound implementations",
+      comment:
+        "CLI adapters call application ports/use-cases; bootstrap/composition supplies outbound implementations",
       from: { path: "^src/adapters/inbound/", pathNot: "\\.test\\.ts$" },
       to: { path: "^src/(adapters/outbound|bootstrap)/" },
     },

diff --git a/ts/.gitignore b/ts/.gitignore
@@ -4,4 +4,7 @@ dist/
 .wallet-cli/
 .env
 .private/
-docs/superpowers
+docs/superpowers
+docs/qa
+docs/adr
+CONTEXT.md
diff --git a/ts/.prettierignore b/ts/.prettierignore
@@ -0,0 +1,8 @@
+node_modules/
+dist/
+.wallet-cli/
+.private/
+package-lock.json
+
+# hand-authored prose: tables and wrapping are deliberate, Prettier reflows them
+*.md
diff --git a/ts/.prettierrc.json b/ts/.prettierrc.json
@@ -0,0 +1,3 @@
+{
+  "printWidth": 100
+}