The Bittensor wallet

Wallet Structure

Bittensor has its own blockchain powered by Polkadot Substrate. Each Bittensor wallet contains two keys, the hot key and the cold key. These keys are crucial and must be carefully handled:

  1. Cold Key is used to store, transfer, and stake tokens. It is "cold" because it is not loaded into the miner and remains encrypted on the device.

  2. Hot key is used by the miner to subscribe and set weights. It is "hot" because it is loaded into the running software (which can be insecure). It does not have permission to move funds.

Each coldkey can be associated with multiple hotkeys. This means you can have multiple miners for the same wallet.

Steps to creating a wallet

Generate a default wallet by running the following command and following the instructions:

$ bittensor-cli new_coldkey --wallet.name <your wallet name>

NOTE: It is VERY important that you save the mnemonic of this cold key in case you lose your password.

Generate a new hotkey for this wallet by running:

$ bittensor-cli new_hotkey --wallet.name <your wallet name> --wallet.hotkey <your hotkey name>

NOTE: It is VERY important that you save the mnemonic of this hot key in case you wish to regenerate it.

Congratulations! You now have a wallet set up!

Wallet operations

Checking your wallet balance:

$ bittensor-cli overview --wallet.name <your wallet name> --subtensor.network kusanagi --wallet.hotkey <your hotkey name>

Staking tao from your coldkey to your hotkey

$ bittensor-cli stake --wallet.name <your wallet name> --amount <amount of tao to stake> --uid <the UID of your miner>

Unstaking tao from your hotkey to your coldkey (wallet)

$ bittensor-cli unstake --wallet.name <your wallet name> --amount <amount of tao to stake> --uid <the UID of your miner>

Regenerate cold key

$ bittensor-cli regen_coldkey --wallet.name <your wallet name>

Regenerate hotkey

$ bittensor-cli regen_hotkey --wallet.name <your wallet name> --wallet.hotkey <your hotkey name>