NotEnoughBalanceToStake

Error Re-added v101 → v120, v121 → v127, v133 → v141, v142 → v150, v151 → v212, v216 → v219, v233 → v315, v320 → current 7.12

Your coldkey doesn't have enough free TAO to complete the staking operation.

Encountered by: stakersdelegatorswallets

Why This Error Exists

This is the most common staking error. Before stake can be added, the chain verifies you actually have the TAO you're trying to stake. Free balance is what's available - it excludes locked/reserved amounts. You also need extra for transaction fees.

Deep Dive

Your balance has components: free, reserved, locked. Only free balance can be staked. When you stake, the TAO leaves your free balance and becomes stake on the hotkey. This error means free_balance < stake_amount + fees.

Debugging Example

You have 100 TAO total but 30 TAO is locked in a vesting schedule. Free balance is 70 TAO. You try to stake 75 TAO. Error: NotEnoughBalanceToStake. Solution: stake <= 69 TAO (leaving ~1 TAO for fees).

Prevention Tips

  • Always check free balance before staking
  • Leave a buffer for transaction fees
  • Account for existential deposit requirements

From Chain Metadata

The caller is requesting adding more stake than there exists in the coldkey account. See: "[add_stake()]"

What This Means

Your coldkey doesn't have enough free TAO to complete the staking operation.

Common Causes

  • Trying to stake more TAO than your available balance
  • Not accounting for transaction fees (existential deposit)
  • Balance is locked in other stakes or reserves

How to Fix

  • Check your free balance with System.Account query
  • Ensure stake_amount + fees < free_balance
  • Check Balances.Locks to see if funds are locked elsewhere

Storage to Check

System.Account (removed)Balances.Locks (removed)SubtensorModule.TotalColdkeyStake

Thrown By

Version History

v101 block 1 Added
v121 block 518,345 Re-added
v133 block 1,404,224 Re-added
v142 block 2,543,779 Re-added
v151 block 3,157,274 Re-added
v216 block 4,510,996 Re-added
v233 block 4,920,350 Re-added
v320 block 6,523,566 Re-added Current

Runtime Info

Pallet Index
7
Error Index
12
Error Code
7.12
Runtime Version
v393