Toggle Transfer
Toggle transfer is a per-subnet hyperparameter, listed in the documentation as ToggleTransfer,
that allows or disallows transferring stake between
coldkeys on a subnet. The
Subnet Hyperparameters reference
lists it as the control that allows or disallows transfer of stake between coldkeys.
What It Controls
The hyperparameter gates whether a subnet’s staked alpha can move from one coldkey to another. When it is enabled, holders can transfer their staked position between coldkeys; when it is disabled, that transfer path is closed for the subnet (Glossary: Stake).
It governs only the coldkey-to-coldkey transfer permission. It does not set fees, define how staking or unstaking works, or change how emissions are calculated; those belong to other parts of the staking and consensus systems (Subnet Hyperparameters).
Because the permission is per subnet, the same coldkey can hold staked alpha on multiple netuids while transfer is blocked on one and permitted on another. Disabling toggle transfer on a netuid closes only that subnet’s coldkey-to-coldkey stake transfer path; it does not change permission on other subnets or the separate paths for moving stake between hotkeys (Subnet Hyperparameters, Glossary: Stake, Glossary: Coldkey).
Documented Type, Default, and Setter
The Subnet Hyperparameters
reference lists ToggleTransfer as a Boolean with a default of True, so stake transfer between
coldkeys is permitted by default. Because each subnet carries its own hyperparameters, the
permission is defined per subnet and applies only within that subnet.
The setter name does not match the parameter name. While the hyperparameter is ToggleTransfer and
the underlying extrinsic is sudo_set_toggle_transfer, the btcli command uses a third label:
btcli sudo set --param transfers_enabled. The reference marks the permission required to set it as
subnet owner, so a subnet owner can open or close transfer for their own subnet
(Subnet Hyperparameters).
In the documented btcli sudo set form the value and target subnet are supplied explicitly, as in
btcli sudo set --param transfers_enabled --value <true|false> --netuid <netuid>, so the switch is
flipped for one netuid at a time rather than network-wide
(Subnet Hyperparameters).
The value in force is per-subnet chain state and can differ from the documented default, so whether
transfer is currently allowed should be read for the subnet in question rather than assumed. For the
documented example netuid 1 on Finney mainnet it can be read with
btcli subnet hyperparameters --netuid 1 --network finney, keeping the permission claim
reproducible against a parseable netuid
(Subnet Hyperparameters: View hyperparameters).
Distinction from Transfer
A transfer sends free TAO from one wallet address to another. Toggle transfer is the per-subnet
ToggleTransfer hyperparameter that allows or disallows transferring a staked position between
coldkeys on that subnet
(Glossary: Transfer,
Glossary: Stake,
Subnet Hyperparameters).
- Transfer — sends free TAO from one wallet address to another.
- Toggle transfer — subnet permission for coldkey-to-coldkey stake transfer.
Distinction from Transferring Stake
Transferring stake is the action of moving a staked position between coldkeys, while toggle transfer is the per-subnet switch that determines whether that action is permitted at all (Glossary: Coldkey, Subnet Hyperparameters).
- Transferring stake — the operation of moving a staked position between coldkeys.
- Toggle transfer — the subnet permission that allows or blocks that operation.
Distinction from Moving Stake
Moving stake generally refers to relocating a staked position between hotkeys or subnets, while toggle transfer specifically governs coldkey-to-coldkey transfer permission on a subnet. The toggle is about who may hold the stake, not which hotkey or subnet it backs (Glossary: Stake).
- Moving stake — relocating delegation between hotkeys or subnets.
- Toggle transfer — coldkey-to-coldkey transfer permission on one subnet.
Distinction from Coldkey Swap
Toggle transfer and coldkey swap both involve coldkeys but do different things. Toggle transfer is a per-subnet permission that allows or blocks moving a staked position from one coldkey to another on that subnet. Coldkey swap is an identity migration that moves all of a coldkey’s hotkeys to a new coldkey address without removing their existing stake or registrations. One gates whether a single staked position may change coldkey on a subnet; the other migrates an entire coldkey identity (Coldkey Swap, Subnet Hyperparameters).
- Toggle transfer — permission for coldkey-to-coldkey stake transfer on one subnet.
- Coldkey swap — identity migration for an entire coldkey.
Distinction from Coldkey
Toggle transfer governs whether a staked position may move from one coldkey to another on a subnet. The coldkey is the custody key that holds that position (Glossary: Coldkey, Subnet Hyperparameters).
- Toggle transfer — permission switch for coldkey-to-coldkey stake transfer.
- Coldkey — custody key that holds the staked position.
Chain Reads for netuid 1
Readers can verify live hyperparameter values for the documented example netuid with
btcli subnet hyperparameters --netuid 1 --network finney
(Subnet Hyperparameters: View hyperparameters).
That read path keeps live hyperparameter claims tied to a parseable netuid.
Per-Subnet Live Value Boundary
Toggle transfer is per-subnet chain state. On one netuid it allows or blocks moving a staked position from one coldkey to another on that subnet only, but the live permission can differ from the documented default and from the setting on another netuid (Subnet Hyperparameters, Glossary: Stake).
This article’s infobox uses netuid 1 as an example label when reading one subnet’s hyperparameter row on Finney mainnet. That example helps readers verify one table; it is not proof that every subnet exposes the same live permission (Bittensor Networks).
Toggle transfer governs custody permission for staked alpha; Yuma Consensus still converts validator weights into emission shares after evaluation completes (Yuma Consensus).
- Toggle transfer — permission switch for coldkey-to-coldkey stake transfer on a subnet.
- Per-subnet boundary — live value is chain state on one netuid.
Distinction from Yuma Consensus
Toggle transfer is a per-subnet hyperparameter that allows or blocks coldkey-to-coldkey transfer of staked alpha on that subnet. Yuma Consensus is the separate on-chain process that converts submitted validator weights into emission shares after evaluation completes (Subnet Hyperparameters, Glossary: Stake, Yuma Consensus, Emission).
-
Toggle transfer — permission switch for coldkey-to-coldkey stake transfer.
-
Yuma Consensus — on-chain weight aggregation that settles emissions.
-
Permission boundary — answers whether transfer is allowed, not transfer cost or emission effects (Glossary: Stake).
-
Subnet owner control — the switch lets a subnet owner open or close coldkey-to-coldkey transfer on that subnet (Subnet Hyperparameters).
Reader Boundary
Toggle transfer is a per-subnet permission concept. It does not quote live hyperparameter values, describe transfer steps, or forecast fees or emissions effects. Readers should check current subnet hyperparameters and staking documentation for operational detail (Subnet Hyperparameters, Glossary: Stake).