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; the source column links the on-chain storage declaration.
| Hyperparameter | Unit | Owner-settable | What it controls | Source |
|---|---|---|---|---|
rho | integer | yes | trust curve steepness | Rho |
kappa | fraction (u16, 65535 = 1.0) | root only | consensus majority-stake threshold | Kappa |
immunity_period | blocks (12s) | yes | prune-immunity window for new neurons | ImmunityPeriod |
min_allowed_weights | integer | yes | minimum weights per submission | MinAllowedWeights |
max_weights_limit | fraction (u16, 65535 = 1.0) | root only | cap on a single miner's weight | MaxWeightsLimit |
tempo | blocks (12s) | yes | blocks per consensus epoch | Tempo |
min_difficulty | PoW difficulty (u64) | root only | PoW registration difficulty floor | MinDifficulty |
max_difficulty | PoW difficulty (u64) | yes | PoW registration difficulty ceiling | MaxDifficulty |
difficulty | PoW difficulty (u64) | root only | current PoW registration difficulty | Difficulty |
weights_version | integer | yes | minimum version key for set_weights | WeightsVersionKey |
weights_rate_limit | blocks (12s) | root only | wait between weight submissions | WeightsSetRateLimit |
adjustment_interval | blocks (12s) | root only | difficulty/burn adjustment cadence | AdjustmentInterval |
activity_cutoff | blocks (12s) | root only | no-weights window before inactive | ActivityCutoff |
activity_cutoff_factor | integer | yes | activity cutoff, per-mille of tempo | ActivityCutoffFactorMilli |
registration_allowed | flag | root only | new neuron registrations allowed | NetworkRegistrationAllowed |
network_pow_registration_allowed | flag | yes | PoW registration toggle | NetworkPowRegistrationAllowed |
target_regs_per_interval | integer | root only | registration-rate controller target | TargetRegistrationsPerInterval |
min_burn | TAO amount in rao | yes | burned-registration cost floor | MinBurn |
max_burn | TAO amount in rao | yes | burned-registration cost ceiling | MaxBurn |
bonds_moving_avg | fraction (1,000,000 = 1.0) | yes | bonds EMA smoothing factor | BondsMovingAverage |
max_regs_per_block | integer | root only | per-block registration cap | MaxRegistrationsPerBlock |
serving_rate_limit | blocks (12s) | yes | cooldown between axon serve calls | ServingRateLimit |
max_validators | integer | root only | top-stake validator permit cap | MaxAllowedValidators |
adjustment_alpha | fraction (u64, u64::MAX = 1.0) | yes | difficulty/burn adjust smoothing | AdjustmentAlpha |
commit_reveal_period | epochs (tempos) | yes | weight commit-to-reveal delay | RevealPeriodEpochs |
commit_reveal_weights_enabled | flag | yes | commit-reveal weights toggle | CommitRevealWeightsEnabled |
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) | LiquidAlphaOn |
bonds_penalty | fraction (u16, 65535 = 1.0) | yes | penalty on out-of-consensus bonds | BondsPenalty |
alpha_sigmoid_steepness | integer | yes | liquid-alpha sigmoid steepness | AlphaSigmoidSteepness |
min_childkey_take | fraction (u16, 65535 = 1.0) | yes | floor for childkey take | MinChildkeyTakePerSubnet |
owner_immune_neuron_limit | integer | yes | owner-designated prune-immune UIDs | ImmuneOwnerUidsLimit |
max_allowed_uids | integer | yes | neuron slot capacity before pruning | MaxAllowedUids |
burn_increase_mult | multiplier (U64F64 bits / 2^64) | yes | burn cost bump per registration | BurnIncreaseMult |
burn_half_life | blocks (12s) | yes | burn cost decay half-life | BurnHalfLife |
collateral_lock_share | fraction (u16, 65535 = 1.0) | yes | registration price share locked | CollateralLockShare |
collateral_drain_ratio | multiplier (U64F64 bits / 2^64) | yes | collateral released per α earned | CollateralDrainRatio |
yuma3_enabled | flag | yes | yuma3 consensus variant toggle | Yuma3On |
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 | SubnetEmissionEnabled |
user_liquidity_enabled | flag | root only | legacy user-LP flag (always false) | — |
bonds_reset_enabled | flag | yes | bonds reset on metadata commit | BondsResetOn |
transfers_enabled | flag | yes | stake transfers between coldkeys | TransferToggle |
owner_cut_enabled | flag | yes | owner emission cut toggle | OwnerCutEnabled |
owner_cut_auto_lock_enabled | flag | yes | auto-lock the owner's emission cut | OwnerCutAutoLockEnabled |