Hyperparameters

owner_immune_neuron_limit

How many of the subnet owner's own neurons are permanently immune from pruning.

View as Markdown

owner_immune_neuron_limit is the number of neurons registered under the subnet owner's coldkey that can never be pruned, regardless of emission or age. Owners use it to keep their own validator or infrastructure hotkeys safe on a full subnet; everyone else cares because each owner-immune UID is one slot removed from the competition.

How it works

get_immune_owner_tuples (pallets/subtensor/src/subnets/registration.rs) collects all of the owner coldkey's hotkeys that hold a UID, sorts them by registration block (earliest first, so older keys keep priority), and truncates the list to owner_immune_neuron_limit. The subnet owner hotkey itself is inserted at the front of the list if it holds a UID. Both get_neuron_to_prune and trim_to_max_allowed_uids skip these UIDs entirely — unlike immunity_period immunity, this protection never expires and has no emission-based fallback.

The limit must stay between 1 and 10 (set_owner_immune_neuron_limit in pallets/subtensor/src/utils/misc.rs rejects anything outside MinImmuneOwnerUidsLimit..MaxImmuneOwnerUidsLimit with InvalidValue). The default is 1: just the owner's primary hotkey.

UID lifecycle playground

A subnet's slot grid, shaded by emission. When it is full, registering prunes the lowest-emission prunable uid. I = inside immunity_period, O = owner-immune, dashed outline = next prune target. Pruning falls back onto immune uids when 2 or fewer non-immune uids remain (chain default: 10). Focused on owner_immune_neuron_limit: O marks the owner hotkeys inside the limit (never pruned, oldest registrations first); o marks owner hotkeys beyond it, which compete like everyone else.

0O
1
2
3
4
5o
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29I
30I
31I

Press a register button to add a neuron.

Filled / capacity

32 / 32

Immune (new)

3

Within immunity_period

Owner-immune

1 / 1

Never pruned

Next pruned

uid 29

Lowest emission, prunable

32 slots
6 regs
1

Reading and setting

btcli sudo get --netuid N --name owner_immune_neuron_limit

The value is a plain integer between 1 and 10:

btcli sudo set --netuid N --name owner_immune_neuron_limit --value 3

immunity_period, max_allowed_uids, serving_rate_limit