Hotkeys (Bittensor)

The operational key used by miners, validators, and subnet actors to register, submit weights, and perform day-to-day on-chain actions.

A hotkey is the operational key in the Bittensor wallet model. It is used by participants to perform routine on-chain actions for roles like miners and validators (Hotkey).

What It Represents

A Bittensor wallet pairs one coldkey with one or more hotkeys. The coldkey controls TAO and stake; hotkeys handle operational roles such as mining, validation, subnet registration, and weight submission (Wallets, Glossary: Hotkey, Glossary: Coldkey).

A hotkey is not always required. The wallet documentation states that to hold a balance, delegate stake, or create a subnet you only need a coldkey, and that a hotkey is needed only when you want to validate or mine in a subnet, so an account that never mines or validates does not have to create one (Wallets).

Hotkeys are designed for online infrastructure. They should not hold funds; if compromised, the coldkey can rotate or revoke authority with btcli wallet swap_hotkey when custody practices keep the coldkey protected. The glossary also notes that a hotkey can be encrypted or unencrypted and is unencrypted by default, so optional hotkey encryption is a local hardening step rather than a separate wallet role (Coldkey and hotkey workstation security, Glossary: Hotkey, Glossary: Encrypting the Hotkey).

Hotkey examples from one network environment should not be read as representing production operational behavior on another (Bittensor Networks).

Distinction from Register

Register attaches subnet identity to a hotkey by granting a UID slot when entry succeeds. A hotkey is the operational key that carries that identity after registration (Glossary: Register, Glossary: Hotkey, Glossary: UID Slot).

  • Register — subnet entry action that assigns a UID slot to a hotkey.
  • Hotkey — operational key that holds that subnet identity after entry.

Distinction from Weight Vector

A weight vector is one validator’s submitted evaluation signals. Hotkey vocabulary names the operational key that signs those submissions (Glossary: Weight Vector, Glossary: Hotkey).

  • Hotkey — operational signing key for subnet validator actions.
  • Weight vector — submitted evaluation signals signed through that key.

Distinction from UID

A UID names the subnet slot identity assigned to a registered hotkey. Hotkey names the operational key that occupies that slot after registration (Glossary: UID, Glossary: Hotkey).

  • Hotkey — operational key that holds one UID slot within a subnet.
  • UID — subnet slot identity assigned to a registered hotkey after entry.

Distinction from Coldkeys

Hotkeys and coldkeys form a two-tier key model. The hotkey performs operational subnet roles; the coldkey holds TAO and stake and signs financial operations (Glossary: Hotkey, Glossary: Coldkey).

  • Hotkey — operational signing authority for subnet roles and routine network actions.
  • Coldkey — custody anchor for TAO, stake, and financial operations.

Distinction from Wallets

A wallet is the overall cryptographic identity formed by coldkey and hotkey pairs. A hotkey is the operational key within that wallet used for day-to-day network activities (Wallets, Coldkeys and Hotkeys, Glossary: Hotkey).

  • Wallet — the full coldkey-and-hotkey identity structure.
  • Hotkey — the operational key layer inside that wallet.

Distinction from Hotkey Swap

Hotkey swap is the rotation procedure that moves subnet participation from a compromised or aging hotkey to a fresh replacement hotkey owned by the same coldkey (Coldkey and Hotkey Workstation Security).

  • Hotkey — the operational key material used for subnet work.
  • Hotkey swap — the rotation procedure that replaces that key under the same coldkey.

Distinction from Coldkey Swap

Coldkey swap re-homes hotkey ownership to a new coldkey along with balances and subnet registrations without resetting registered positions (Rotate or Swap your Coldkey, Glossary: Hotkey).

  • Hotkey — operational signing layer under coldkey ownership.
  • Coldkey swap — ownership-layer migration that re-homes associated hotkeys.

Distinction from Encrypting the Hotkey

Encrypting the hotkey is password protection for the hotkey keyfile at rest. It does not change what the hotkey can authorize once unlocked (Glossary: Encrypting the Hotkey).

  • Hotkey — the operational key and its subnet-facing role.
  • Encrypting the hotkey — password protection for the hotkey keyfile at rest.

Distinction from Seed Phrase Security

Seed phrase security covers practices for protecting recovery phrases that can regenerate keys, including a hotkey’s own recovery phrase (Handle your Seed Phrase/Mnemonic Securely).

  • Hotkey — the operational key used for subnet participation.
  • Seed phrase security — practices for protecting recovery material that can regenerate keys.

Distinction from Yuma Consensus

Hotkeys name the operational keys validators and miners use to participate in subnet work and weight submission. Yuma Consensus converts those weight submissions into emission shares (Glossary: Hotkey, Yuma Consensus).

  • Hotkeys — operational keys for subnet participation.
  • Yuma Consensus — on-chain settlement that turns validator weights into emission shares.

Reader Boundary

Hotkeys should not be read as fund-custody keys, wallet creation tutorials, or validator recommendations. The term names operational signing authority under a coldkey for subnet roles and routine network actions (Glossary: Hotkey).

Further Reading

Topics WalletsOperations