Errors/Chain errors

StakeUnavailable

Only free stake can move — wait out conviction locks or drain miner collateral, then retry; check locked vs free with `btcli stake list`

View as Markdown

An unstake or same-subnet stake transfer would dip into stake that is still reserved: the requested alpha exceeds the coldkey's free balance on that subnet after subtracting conviction Lock and any miner registration collateral locked against hotkeys the coldkey owns. Check Lock and MinerCollateral for the netuid; only total stake minus those reservations can move.

Declared by the SubtensorModule pallet; it classifies to the semantic code insufficient_balance.

Declared at pallets/subtensor/src/macros/errors.rs#L175.

Remediation

Only free stake can move — wait out conviction locks or drain miner collateral, then retry; check locked vs free with btcli stake list

The same explanation is available in the terminal: btcli explain StakeUnavailable.