Owner Cut Auto Lock Enabled
Owner cut auto lock enabled is a per-subnet hyperparameter, listed in the documentation as
OwnerCutAutoLockEnabled, that controls whether the subnet owner’s distributed cut of emissions is
automatically locked rather than received as free stake. The reference documents it as a boolean
defaulting to false
(Subnet Hyperparameters).
What It Controls
The hyperparameter acts on a cut that is already being distributed: it decides how that cut is
handled, not whether the owner receives one. When set to true, the documentation describes the
distributed cut as added to the owner’s conviction lock each epoch, topping up an existing lock or
creating a new one targeting the owner hotkey. When set to false, the same cut is received as free
stake with no auto-locking
(Subnet Hyperparameters,
Conviction and locked stake).
The setting is owner-tunable per subnet, so netuid 1 can keep the default while another netuid enables auto-locking, and the live value is chain state rather than a network constant (Subnet Hyperparameters, Bittensor Networks).
Why It Matters
Because the owner cut is denominated in the subnet’s alpha and credited as stake, auto-locking changes whether that payout immediately adds to liquid alpha stake or enters the conviction-lock path with its unlock schedule. Owners who want every distributed cut to compound under lock can enable the flag; owners who prefer spendable stake can leave it off (Emission, Conviction and locked stake).
The flag only applies when an owner cut is actually being distributed. If owner cut enabled is false, there is no cut for this setting to lock or release (Subnet Hyperparameters).
Documented Type, Default, and Setter
The Subnet Hyperparameters
reference lists OwnerCutAutoLockEnabled as a Bool defaulting to false. It is changed through the
sudo_set_owner_cut_auto_lock_enabled extrinsic, exposed in tooling as
btcli sudo set --param owner_cut_auto_lock_enabled, and the reference marks the permission
required to set it as subnet owner
(Subnet Hyperparameters,
Conviction and locked stake).
OwnerCutAutoLockEnabled is one of the parameters added in the v3 hyperparameter set and is exposed
in the get_subnet_hyperparams_v3 runtime API, so the live boolean for a subnet can be read from
the current hyperparameter table rather than inferred from the default
(Subnet Hyperparameters).
Because each subnet carries its own hyperparameters, the auto-lock flag on one netuid can differ from the documented default and from the setting on another subnet (Subnet Hyperparameters).
Reading the Live Value for netuid 1
Owner cut auto lock 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
OwnerCutAutoLockEnabled value with btcli subnet hyperparameters --netuid 1 --network finney,
which prints the 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 Owner Cut Enabled
Owner cut enabled decides whether the owner receives a cut at all; owner cut auto lock enabled only
takes effect once a cut is being distributed, deciding whether it is auto-locked or received as free
stake. If owner cut enabled is false, there is no distributed cut for this setting to act on
(Subnet Hyperparameters).
- Owner cut enabled — whether the owner cut is distributed at all.
- Owner cut auto lock enabled — whether a distributed cut is auto-locked or free stake.
Distinction from Subnet Owner Take
Subnet owner take describes the proportion of emissions reserved for the owner. Owner cut auto lock enabled does not change that proportion; it only governs the form the distributed amount takes once paid out (Subnet Hyperparameters, Emission).
- Subnet owner take — the size of the owner’s reserved emission share.
- Owner cut auto lock enabled — the form (locked vs free) of the distributed cut.
Distinction from Conviction and Locked Stake
Conviction and locked stake names the time-based commitment mechanism for locking already-staked alpha. Owner cut auto lock enabled is the subnet boolean that routes each distributed owner cut into that lock path or leaves it as free stake (Conviction and locked stake, Subnet Hyperparameters).
- Conviction and locked stake — the lock mechanism and unlock schedule.
- Owner cut auto lock enabled — whether each distributed owner cut uses that path automatically.
Reader Boundary
This page defines the concept at a high level. It does not report whether auto-locking is currently enabled on any particular subnet, the size of the owner cut, or the state of any owner’s conviction lock. Those are live chain state and related settings that should be checked for the relevant netuid. The documented default is false, and the parameter is owner-settable per subnet.