Subnet Emission Enabled
Subnet emission enabled is a per-subnet hyperparameter, listed in the documentation as
SubnetEmissionEnabled, that controls whether a subnet receives pool-side emission injection each
epoch. The reference describes it as a boolean defaulting to true, settable only by root sudo rather
than by subnet owners
(Subnet Hyperparameters).
What It Controls
When the flag is true, the subnet receives its pool-side injection on each epoch. When set to false, the subnet receives no alpha-in, tao-in, or chain-buy injections, and that subnet’s emission share is redistributed to the remaining enabled subnets instead (Subnet Hyperparameters, Emission).
Crucially, the toggle does not stop every reward flow. The documentation notes that alpha-out, owner cut, root proportion, and validator and server emissions continue regardless of this flag, so turning it off halts the pool-side injections specifically rather than freezing all subnet activity (Subnet Hyperparameters, Emission).
That scoping is what makes it a targeted control rather than a full shutdown. The injection side of a subnet’s economy can be paused while the consensus-driven distribution side keeps operating on the metagraph (Subnet Hyperparameters, Yuma Consensus).
Why It Matters
The reference frames this flag as an emergency governance tool. It exists to temporarily halt emissions to a subnet that is exhibiting problematic behavior without fully dissolving the subnet, so the network can intervene reversibly rather than tearing the subnet down (Subnet Hyperparameters).
Because the share from a disabled subnet is redistributed to enabled subnets, the setting also has a network-wide effect: disabling one subnet’s injection shifts that portion of pool-side emission toward the rest (Subnet Hyperparameters, Bittensor Networks).
Documented Type, Default, and Setter
The Subnet Hyperparameters
reference lists SubnetEmissionEnabled as a per-subnet boolean defaulting to true. It is changed
through the adminUtils.sudoSetSubnetEmissionEnabled(netuid, enabled) extrinsic and is root sudo
only, explicitly not settable by subnet owners. The reference lists no btcli setter for this
parameter. A change emits the adminUtils.SubnetEmissionEnabledSet on-chain event
(Subnet Hyperparameters).
Because each subnet carries its own value as per-netuid state, the flag on one netuid can differ from the documented default and from another subnet’s value (Subnet Hyperparameters).
Reading the Live Value for netuid 1
Subnet emission enabled is per-subnet chain state, so any live claim is tied to a specific netuid.
For the documented example netuid 1 on Finney mainnet, readers can verify the live flag with
btcli subnet hyperparameters --netuid 1 --network finney, which prints that subnet’s
hyperparameter table including this Boolean row
(Subnet Hyperparameters: View hyperparameters).
The infobox uses netuid 1 only as an example label; other subnets expose their own values
(Bittensor Networks).
Distinction from Subnet Is Active
Subnet is active reports whether a subnet’s emission path has started after the owner start call. Subnet emission enabled is the separate root-governance toggle that can halt pool-side injection on an already-active subnet without dissolving it (Subnet Hyperparameters, Emission).
- Subnet is active — whether the subnet’s emissions have started.
- Subnet emission enabled — whether pool-side injection runs each epoch on an active subnet.
Distinction from Owner Cut
Owner cut is the share of subnet alpha emissions paid to the subnet owner as stake. Subnet emission enabled is the toggle for pool-side injection, and owner cut is among the flows the documentation says continue even when the toggle is off (Subnet Hyperparameters).
- Subnet emission enabled — on/off switch for a subnet’s pool-side injection.
- Owner cut — owner’s share of alpha emissions, which continues regardless of the toggle.
Distinction from Owner Cut Enabled
Subnet emission enabled is the root-governed switch for whether a subnet receives pool-side injection at all. Owner cut enabled is the subnet-owner switch for whether the owner’s reserved share of emissions is distributed, so one controls subnet-level injection while the other controls a single payout branch inside the distribution that follows (Subnet Hyperparameters, Emission).
Turning subnet emission enabled off stops alpha-in, tao-in, and chain-buy injections for that netuid, while turning owner cut enabled off leaves those injections running and only suppresses the owner’s cut (Subnet Hyperparameters, Emission).
- Subnet emission enabled — root-controlled switch for subnet-level pool-side injection.
- Owner cut enabled — owner-controlled switch for distributing only the owner’s reserved share.