Skip to main content
SUBMIT A PRSUBMIT AN ISSUElast edit: Mar 04, 2025

Senator's Guide to BTCLI

Governance participants (senate members, sudo-level accounts) can propose changes, cast votes, or execute privileged commands that affect the entire network. They must have a coldkey with the relevant governance role (senate membership or sudo privileges).

This page discusses btcli stuff specifically for Senators. For general coverage of BTCLI and permissions stuff, see: Bittensor CLI: Permissions Guide

Senate requirements: In order to participate in the Senate, a coldkey must:

  • Have registered with any subnetwork as a hotkey-coldkey pair.
  • Have nominated themselves as a delegate for anyone to stake their $TAO with.
  • Have a hotkey stake value is greater than 2% of the network's total stake amount, through delegation or self-stake.
  • Have elected to participate in the Senate.

See: Senate.

Commands most relevant to governance:

  • Senate / Proposals (coldkey with senator role):
    • btcli sudo senate
    • btcli sudo proposals
    • btcli sudo senate-vote
    • btcli sudo senate_vote
    • Aliases: btcli su senate, btcli su proposals, etc.
  • Sudo Commands (coldkey with sudo privileges):
    • btcli sudo set, btcli sudo get
    • btcli sudo set-take, btcli sudo get-take
    • btcli sudo set_take, btcli sudo get_take
    • Aliases: btcli su set, btcli su get, etc.

Because these commands can significantly change chain parameters or enact critical changes, they require a fully privileged coldkey in a very secure environment.