Hyperparameters
Hyperparameters
What each subnet hyperparameter controls, its unit, and how to change it.
Read them with btcli sudo get --netuid N (the subnet_hyperparameters read); the subnet owner changes the owner-settable ones with btcli sudo set (the set_hyperparameter intent). Raw on-chain integers are primary; where a parameter is a fixed-point fraction or a rao amount, the value also accepts the human form with a decimal point. Each parameter has its own explainer page.
| Hyperparameter | Unit | Owner-settable | What it controls |
|---|---|---|---|
rho | integer | yes | trust curve steepness |
kappa | fraction (u16, 65535 = 1.0) | root only | consensus majority-stake threshold |
immunity_period | blocks (12s) | yes | prune-immunity window for new neurons |
min_allowed_weights | integer | yes | minimum weights per submission |
max_weights_limit | fraction (u16, 65535 = 1.0) | root only | cap on a single miner's weight |
tempo | blocks (12s) | yes | blocks per consensus epoch |
min_difficulty | PoW difficulty (u64) | root only | PoW registration difficulty floor |
max_difficulty | PoW difficulty (u64) | yes | PoW registration difficulty ceiling |
difficulty | PoW difficulty (u64) | root only | current PoW registration difficulty |
weights_version | integer | yes | minimum version key for set_weights |
weights_rate_limit | blocks (12s) | root only | wait between weight submissions |
adjustment_interval | blocks (12s) | root only | difficulty/burn adjustment cadence |
activity_cutoff | blocks (12s) | root only | no-weights window before inactive |
activity_cutoff_factor | integer | yes | activity cutoff, per-mille of tempo |
registration_allowed | flag | root only | new neuron registrations allowed |
network_pow_registration_allowed | flag | yes | PoW registration toggle |
target_regs_per_interval | integer | root only | registration-rate controller target |
min_burn | TAO amount in rao | yes | burned-registration cost floor |
max_burn | TAO amount in rao | yes | burned-registration cost ceiling |
bonds_moving_avg | fraction (1,000,000 = 1.0) | yes | bonds EMA smoothing factor |
max_regs_per_block | integer | root only | per-block registration cap |
serving_rate_limit | blocks (12s) | yes | cooldown between axon serve calls |
max_validators | integer | root only | top-stake validator permit cap |
adjustment_alpha | fraction (u64, u64::MAX = 1.0) | yes | difficulty/burn adjust smoothing |
commit_reveal_period | epochs (tempos) | yes | weight commit-to-reveal delay |
commit_reveal_weights_enabled | flag | yes | commit-reveal weights toggle |
alpha_high | fraction (u16, 65535 = 1.0) | yes | liquid-alpha smoothing upper bound |
alpha_low | fraction (u16, 65535 = 1.0) | yes | liquid-alpha smoothing lower bound |
liquid_alpha_enabled | flag | yes | per-weight bonds EMA (liquid alpha) |
bonds_penalty | fraction (u16, 65535 = 1.0) | yes | penalty on out-of-consensus bonds |
alpha_sigmoid_steepness | integer | yes | liquid-alpha sigmoid steepness |
min_childkey_take | fraction (u16, 65535 = 1.0) | yes | floor for childkey take |
owner_immune_neuron_limit | integer | yes | owner-designated prune-immune UIDs |
max_allowed_uids | integer | yes | neuron slot capacity before pruning |
burn_increase_mult | multiplier (U64F64 bits / 2^64) | yes | burn cost bump per registration |
burn_half_life | blocks (12s) | yes | burn cost decay half-life |
yuma3_enabled | flag | yes | yuma3 consensus variant toggle |
yuma_version | integer | root only | epoch consensus variant (2 or 3) |
subnet_is_active | flag | root only | subnet started (staking + emissions) |
subnet_emission_enabled | flag | root only | root switch for TAO emission share |
user_liquidity_enabled | flag | root only | legacy user-LP flag (always false) |
bonds_reset_enabled | flag | yes | bonds reset on metadata commit |
transfers_enabled | flag | yes | stake transfers between coldkeys |
owner_cut_enabled | flag | yes | owner emission cut toggle |
owner_cut_auto_lock_enabled | flag | yes | auto-lock the owner's emission cut |