BalanceWithdrawalError
Error Re-added v101 → v120, v121 → v127, v133 → v141, v142 → v150, v151 → v212, v216 → v219, v233 → v315, v320 → current 7.13An error occurred while withdrawing balance.
Why This Error Exists
This is a low-level error from the balance withdrawal mechanism. It occurs when an operation that needs to deduct TAO from your account fails for balance-related reasons. The underlying cause is usually insufficient free balance, but could also be locked funds, reserved amounts, or existential deposit issues.
Deep Dive
SubtensorModule operations that move TAO (staking, registration fees, swap costs) call the Balances pallet internally. If Balances.withdraw fails, this error bubbles up. System.Account.free is your spendable balance. Balances.Locks shows locked amounts (staking, vesting). Balances.Reserves shows reserved amounts.
Debugging Example
You call some operation that requires 100 TAO. Error: BalanceWithdrawalError. Query System.Account(your_coldkey) - free: 50 TAO, reserved: 0, frozen: 30 TAO. Free balance (50) < required (100). Solution: Transfer 50+ TAO to your coldkey first.
Prevention Tips
- Always verify free_balance > required_amount before operations
- Account for all fees: operation cost + transaction fee + existential deposit buffer
- Check Balances.Locks if balance looks sufficient but operations still fail
From Chain Metadata
The caller is trying to add stake, but for some reason the requested amount could not be withdrawn from the coldkey account.
What This Means
An error occurred while withdrawing balance.
Common Causes
- Underlying balance operation failed
- Insufficient funds or locked balance
How to Fix
- Check your free balance
- Verify no locks prevent withdrawal
Storage to Check
Thrown By
Version History
Runtime Info
- Pallet Index
- 7
- Error Index
- 13
- Error Code
- 7.13
- Runtime Version
- v393