Skip to content

Commit b6fc687

Browse files
MichaelTrestmanMichael Trestman
andauthored
fix validator docs/ remove pre-dtao script (#531)
* wip * wip * wip * wip --------- Co-authored-by: Michael Trestman <[email protected]>
1 parent ccc201a commit b6fc687

File tree

1 file changed

+15
-56
lines changed

1 file changed

+15
-56
lines changed

docs/validators/index.md

Lines changed: 15 additions & 56 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,6 @@ import useBaseUrl from '@docusaurus/useBaseUrl';
77

88
# Validating in Bittensor
99

10-
## Choosing a subnet
1110

1211
All mining and validating in Bittensor occurs within a subnet. Each subnet independently produces the digital commodities that are its purpose, each subnet creator defining a different *incentive mechanism* for validators to use in judging miners' work. The validator's work is to apply this incentive mechanism to miners, using it to score their performance, and then to submit these weights to the Bittensor blockchain. It is validators scores of miners' performance that determines the proportion of the subnet's emissions allocated to each miner, according to the Yuma Consensus algorithm. See [Emissions](../emissions.md).
1312

@@ -19,88 +18,48 @@ Each subnet may have distinct hardware requirements, but this [minimum requireme
1918
Validating is not supported on Windows.
2019
:::
2120

22-
### Requirements for active validation
21+
## Requirements for validation
2322

24-
To have a **validator permit** in a given subnet, allowing you to submit miner evaluations using the [`set_weights`](pathname:///python-api/html/autoapi/bittensor/core/extrinsics/set_weights/index.html) function, you must meet the following requirements:
23+
To have a **validator permit** in a given subnet and be listed as `active`, allowing you to submit miner evaluations using the [`set_weights`](pathname:///python-api/html/autoapi/bittensor/core/extrinsics/set_weights/index.html) function, you must meet the following requirements:
2524

2625
- Your hotkey must be registered, granting you a UID on the subnet
27-
- You must at least 1000 TAO staked to your hotkey
28-
- You must be one of the top 64 validators in the subnet, ranked by stake.
26+
- You must have a stake weight on the subnet of least 1000, including stake delegated to your hotkey from other wallets' coldkeys. A validator's stake weight in a subnet equals their alpha stake plus their TAO stake times the `tao_weight` parameter (current value: 0.18):
2927

30-
## Validator registration
31-
32-
To participate as a validator, you must first register your keys with the subnet in order to receive a UID on that subnet.
28+
$$
3329

34-
:::tip No need to create a subnet
35-
You **do not** have to create a subnet to validate on the Bittensor network. Most validators work on established subnets.
36-
:::
37-
<!-- what determines the registration cost for a subnet??? is it burned, recycled, or locked??? this all needs a fact check... -->
38-
39-
Registration has a cost in TAO. When you secure a UID slot in a subnet on the main chain, this TAO is sunk cost. Nevertheless, you can be a subnet miner in as many subnets as you can afford and expect to be successful.
30+
\text{Validator stake weight} = \alpha + 0.18 \times \tau
4031

41-
A subnet can have a maximum of 64 subnet validator UIDs and 192 subnet miner UIDs (256 total) in subnets other than Subnet 1.
32+
$$
33+
- You must be one of the top 64 validators in the subnet, ranked by stake weight.
4234

43-
Upon registration, your hotkey, which is part of your wallet, becomes the holder of the UID slot. **The terms "account" and "hotkey" are used synonymously.**
35+
## Validator registration
4436

45-
:::tip Ownership belongs to a hotkey
46-
When you delegate your TAO to a subnet validator, you attach your delegated TAO to that validator’s hotkey. See [Delegation](../staking-and-delegation/delegation.md).
37+
To participate as a validator, you must first register your keys with the subnet in order to receive a UID on that subnet.
4738

48-
A hotkey can hold multiple UIDs across **separate** subnets. However, within one subnet, each UID must have a unique hotkey.
49-
:::
39+
A subnet can have a maximum of 64 active subnet validator UIDs and 192 subnet miner UIDs (256 total).
5040

51-
Run the following command on your terminal, replacing `<your_preferred_netuid>`, `<my_coldkey>`, `<my_hotkey>`.
52-
`<your_preferred_netuid>` is the `netuid` of your preferred subnet.
41+
Upon registration, your hotkey, which is part of your wallet, becomes the holder of the UID slot.
5342

54-
```bash
55-
btcli subnet register --netuid <your_preferred_netuid> --wallet.name <my_coldkey> --wallet.hotkey <my_hotkey>
56-
```
5743

58-
For example, for subnet 1 (netuid of 1):
5944
```bash
60-
btcli subnet register --netuid 1 --wallet.name test-coldkey --wallet.hotkey test-hotkey
45+
btcli subnet register --netuid <desired netuid> --wallet.name <wallet name> --hotkey <your hotkey>
6146
```
6247

63-
6448
## Acquiring stake
6549

66-
A validator's consensus weight and emissions depend on the stake attached to their hotkey.
50+
A validator's consensus weight and emissions depend on their hotkey's stake weight. You can stake your own TAO to your validator hotkey, or advertise your hotkey to others and seek stake. Any wallet's coldkey can stake to any hotkey, subsequently receiving emissions from that stake.
6751

6852
:::tip Delegation
6953
See [StakingDelegation](../staking-and-delegation/delegation.md)
7054
:::
7155

72-
Stake can be acquired in two ways:
73-
74-
### Stake your own TAO
56+
### Add stake
7557

76-
You can do this by staking your own TAO funds to your hotkey, which holds the UID in the subnet where you want to validate.
7758

7859
```bash
7960
# Stake funds to your hotkey account within the subnet.
80-
btcli stake add --wallet.name <my_coldkey> --wallet.hotkey <my_hotkey>
61+
btcli stake add --wallet.name <wallet name> --wallet.hotkey <your validating hotkey>
8162
```
82-
Example:
83-
```bash
84-
btcli stake add --wallet.name test-coldkey --wallet.hotkey test-hotkey
85-
```
86-
87-
### Attract delegated stake
88-
89-
You can also increase your stake by attracting delegated stake from nominators. For this, you must first nominate your hotkey as a delegate and then advertise this hotkey. The nominators can then delegate their TAO to your hotkey.
90-
91-
```bash
92-
# Nominate your hotkey as a delegate
93-
btcli root nominate --wallet.name <my_coldkey> --wallet.hotkey <my_hotkey>
94-
```
95-
Example:
96-
```bash
97-
btcli root nominate --wallet.name test-coldkey --wallet.hotkey test-hotkey
98-
```
99-
100-
:::tip See also
101-
See [Becoming a delegate](../staking-and-delegation/delegation.md#becoming-a-delegate) for specific steps.
102-
:::
103-
10463

10564
### Calculate TAO required
10665

0 commit comments

Comments
 (0)