Skip to content
Blog

Conviction locks: how a subnet can change owners

On Bittensor, you can lock alpha you have staked on a subnet. Locked alpha stays staked and keeps earning, but you cannot unstake it, and as long as it stays locked it builds conviction toward a hotkey you choose. Conviction is what moves a subnet’s ownership: once a subnet is a year old, a hotkey with enough conviction of its own takes it over.

This guide covers what a lock is, how conviction builds, the exact rule for a change of owner, what it means for alpha holders and for subnet owners, and how to lock and follow the race in Taoswap.

  • A floor under your stake. A lock sets an amount of alpha that must stay staked on the subnet. It applies to all your alpha there, whichever validators hold it, and you can still unstake anything above it. The locked part cannot be swapped back to TAO or moved to another subnet.
  • Your alpha keeps earning. Locking moves nothing: your alpha stays staked where it is and keeps its staking rewards. You give up liquidity, not rewards.
  • One lock per subnet, toward one hotkey. Your coldkey holds at most one lock on each subnet, and its conviction goes to the hotkey you choose. That hotkey need not hold your stake: you can stake with your validator and back the subnet’s owner.
  • Alpha you already hold. A lock commits alpha already staked on the subnet, up to all of it. It buys nothing.

Conviction is a score counted in alpha. You cannot spend it or sell it: it measures how much alpha has stood behind a hotkey, and for how long. A hotkey’s conviction is the sum of the conviction of every lock toward it.

Every block, a lock’s conviction closes the same share of its gap to the alpha locked: it moves fast while the gap is wide, then slower as the gap narrows. The rest depends on the lock:

Lock Alpha locked Conviction
Perpetual Stays the same Climbs toward the amount locked: halfway after one maturity half-life, three quarters after two, never past it
Decaying Halves every unlock half-life, and what it frees can be unstaked again Rises for a while, then fades with the lock, without reaching the amount first locked
Toward the owner’s hotkey Either of the above Equals the alpha locked, at once and at all times

Both half-lives are set for the whole network. Taoswap reads them from the chain and gives their current values in the tooltip of the Lock type column, on a subnet’s Conviction tab.

Two more rules:

  • Adding to a lock raises the amount locked, and your conviction keeps growing from where it is toward the new amount. You add toward the hotkey the lock already backs.
  • Moving a lock to another hotkey keeps the alpha locked, but its conviction starts again from zero, unless both hotkeys have the same owner.

A new lock decays unless you make it perpetual.

  • Decaying runs off by itself. Its alpha frees up gradually, and its conviction fades with it unless you add to the lock.
  • Perpetual keeps your alpha locked at full weight, so its conviction keeps growing toward the amount locked. It never runs off by itself: the alpha stays locked until you switch the lock to decaying, and only then starts to free up, at the decaying pace.

The chain checks each subnet at the end of every one of its epochs, the regular round in which the subnet pays out its emissions. It hands the subnet to a new owner when all of these hold:

  1. The subnet registered at least a year ago.
  2. The hotkey with the most conviction on the subnet belongs to a coldkey other than the owner’s.
  3. That hotkey’s own conviction is more than 18% of the subnet’s eligible alpha.
  4. That hotkey has an owner on chain, and is registered on the subnet or can be: the chain registers it if needed.

Eligible alpha is the subnet’s alpha held outside its pool, minus the alpha the protocol owns and the alpha burned. The 18% is measured on the leading hotkey alone: locks toward any other hotkey, the owner’s included, add nothing to it. To push a challenger past it, its backers must all lock toward that one hotkey.

The leading hotkey then becomes the subnet’s owner hotkey, and the coldkey that owns it becomes the subnet’s owner: it receives the owner’s share of the subnet’s emissions and controls the subnet’s settings. From then on, locks toward the new owner’s hotkey count in full, as owner locks do.

A lock costs you liquidity, and any subnet you hold can change hands:

  • Your liquidity. Locked alpha cannot be sold or moved to another subnet. A decaying lock gives it back slowly, a perpetual one only after you switch it. If the price falls, only the unlocked part can leave.
  • Changing your mind. Moving a lock to a hotkey with another owner starts its conviction from zero.
  • The subnet’s control. Once a subnet is a year old, it changes hands at the first epoch where an outsider leads the race and clears the threshold. Its new owner takes the owner’s share of emissions and sets the subnet’s rules. On the subnets you hold, watch who leads.

Reasons to lock:

  • Back an owner you trust. A lock toward the owner’s hotkey counts in full at once, and makes it harder for anyone else to lead.
  • Back a challenger. If you would rather see another team run the subnet, lock toward its hotkey: a challenger’s conviction is the sum of its backers’ locks.
  • Commit without losing rewards. If you hold for the long run anyway, a lock keeps your rewards and adds your weight to the side you choose.
  • A year of grace. No subnet changes owners before its first year. Use it to build a lead.
  • Leading is enough. As long as a hotkey of yours has the most conviction, nothing changes, whatever its share.
  • Your hotkey counts in full. Locks toward the owner hotkey, yours and your holders’, count in full at once. Lock your own alpha there, perpetual if its weight must last: a decaying lock loses conviction as its alpha frees up.
  • Rally your holders. Every holder who locks toward your owner hotkey adds to its lead.
  • Lock your share as it arrives. The subnet setting owner_cut_auto_lock_enabled locks the owner’s share of emissions at each epoch, toward the hotkey your lock already backs, or the owner hotkey if you have no lock yet. The Conviction tab then shows its daily pace as Conviction rate.

The owner turns it on with btcli:

Terminal window
btcli sudo set --netuid <netuid> --name owner_cut_auto_lock_enabled --value true

The Conviction locks section of Staking and validators sums up the two lock types. To lock:

  1. Open Subnets and pick a subnet, then open its Conviction tab. Root has none.

  2. Under Ownership takeover, press Click to lock tokens. To back a hotkey from the table, press the lock icon on its row, Lock α to this hotkey. On a subnet with no lock yet, press Lock α.

  3. Connect your wallet if asked. The dialog shows the alpha you can still lock, under Available to lock. If you have none, swap TAO for the subnet’s alpha first.

  4. Under Target hotkey, choose Owner for the subnet owner’s hotkey, King for the hotkey leading the race, or Custom to paste another hotkey.

  5. Enter the Amount to lock, or press MAX.

  6. Choose the Lock type, Decaying or Perpetual. Conviction over time shows what your lock would build.

  7. Tick the acknowledgement, press Lock α, then sign in your wallet.

On a subnet where you already hold a lock, the dialog opens on it, with its Current target, the amount Locked and its Lock type, and its actions: Add locks more toward the same hotkey, Lock type switches between decaying and perpetual, and Move points the lock at another hotkey.

On the Conviction tab:

  • Leader conviction is the leading hotkey’s own conviction, the figure the chain compares with the threshold. 18% threshold is the conviction one hotkey needs, and Threshold reached the leader’s share of it: past 100%, the conviction condition is met.
  • Once the subnet is a year old and its leader clears the threshold, a badge appears: Owner convicted when the owner’s hotkey leads, Takeover imminent when an outsider does: the subnet then changes owners at its next epoch.
  • The table ranks hotkeys by Conviction. Coldkey is the account a takeover would hand the subnet to, and the coldkeys that locked toward each hotkey are listed under it. Amount locked is the alpha behind the conviction, Exit value what that alpha would fetch if sold through the pool, and Lock type reads Perpetual, Decaying or Mixed.

To scan every subnet at once, scroll below the list on the Subnets page to Conviction Takeover. It lists the subnets whose race an outsider leads, the most imminent first, with Threshold met, Time to takeover and Age gate.

  • Conviction takes months to build. Except toward the owner’s hotkey, a lock starts with no conviction.
  • Locks are public. Anyone can see on the Conviction tab who locked how much, toward which hotkey, and of which type.
  • The subnet goes to the hotkey’s owner. A takeover hands the subnet to the coldkey that owns the leading hotkey, never to the coldkeys that locked toward it.
  • Taoswap keeps locked alpha apart. In Portfolio and on the swap form, a badge with a lock shows the amount locked, and Taoswap offers only the rest for a swap.
  • The threshold moves. It follows the subnet’s eligible alpha: issuance raises it, burned alpha lowers it, and stake flows move it both ways.

No. Locked alpha stays staked and keeps earning. What you give up is selling it, or moving it to another subnet, while it is locked.

Not at once. A decaying lock frees its alpha gradually. A perpetual lock frees nothing until you switch it to decaying: open the lock dialog, choose Lock type, then Decaying, and press Update lock type.

If the hotkey I back takes over, do I own part of the subnet?

Section titled “If the hotkey I back takes over, do I own part of the subnet?”

No. The subnet goes to the coldkey that owns that hotkey, shown under Coldkey. Your lock stays yours, and your alpha keeps earning.

Yes, with Move in the lock dialog, then Move lock. The alpha stays locked, and its conviction starts again from zero unless both hotkeys have the same owner.

Bittensor’s conviction guide details every call, with a worked example.