wallet-cli witness

Register and operate a super representative (SR) candidacy.

Registering turns an ordinary account into an SR candidate — it can be voted for (vote cast), and if its votes put it in the top 27 it produces blocks. Candidacy is also what unlocks governance: only a registered witness can create or approve proposals.

The chain stores very little about a candidate: the owner address and a single url — the info page shown next to the SR in explorers — which is the only field this group can change. Everything else about an SR (rank, votes, block production) is a consequence of votes, not a setting.

The one economic knob is brokerage: the share of block rewards the SR keeps, with the remainder distributed to its voters. It defaults to 20 %.

Registration burns a fee (currently ≈ 9,999 TRX) and cannot be undone.

TRON only. Every command in this group implements a TRON protocol feature with no EVM counterpart; on an EVM network they fail with family_mismatch before any node call.

Synopsis

wallet-cli witness COMMAND

Subcommands

Command	Page	Description
witness create	create.md	Register the account as an SR candidate
witness update	update.md	Change the candidate info page URL
witness set-brokerage	set-brokerage.md	Set the share of block rewards the SR keeps

Candidates, their votes, and their brokerage are read with vote list — which shows the 27 elected SRs by default, so a candidate outside that set needs vote list --candidates.

See also

proposal · vote list · reward balance

---