Skip to main content
SUBMIT A PRSUBMIT AN ISSUElast edit: May 21, 2025

Subtensor Standard Errors

This page documents the standard errors that can arise from Subtensor, the blockchain underlying the Bittensor network.

Related:

Network and Subnet Errors​

SubNetworkDoesNotExist​

The specified subnet does not exist.

RootNetworkDoesNotExist​

The root network does not exist.

SubnetNotExists​

Trying to perform action on non-existent subnet.

NotRootSubnet​

Netuid does not match for setting root network weights.

CanNotSetRootNetworkWeights​

Cannot set weights for the root network.

RegistrationNotPermittedOnRootSubnet​

Operation is not permitted on the root subnet.

AllNetworksInImmunity​

All subnets are in the immunity period.

MechanismDoesNotExist​

Trying to register a subnet into a mechanism that does not exist.

SubNetRegistrationDisabled​

Registration is disabled for this subnet.

NoNeuronIdAvailable​

No neuron ID is available in the subnet.

Hotkey and Coldkey Errors​

HotKeyNotRegisteredInSubNet​

The hotkey is not registered in the specified subnet.

HotKeyAccountNotExists​

The specified hotkey does not exist.

HotKeyNotRegisteredInNetwork​

The hotkey is not registered in the specified subnet.

NonAssociatedColdKey​

Request made by a coldkey that is not associated with the hotkey account.

HotKeyAlreadyRegisteredInSubNet​

The caller is requesting a redundant registration for a neuron.

NewHotKeyIsSameWithOld​

The new hotkey is the same as old one.

HotKeyAlreadyDelegate​

The hotkey is attempting to become a delegate when already a delegate.

TransactorAccountShouldBeHotKey​

The hotkey is required to be the origin.

NewColdKeyIsHotkey​

New coldkey is hotkey.

ColdKeyAlreadyAssociated​

The coldkey has already been swapped.

ColdkeyIsInArbitration​

The coldkey is in arbitration.

UnableToRecoverPublicKey​

Public key cannot be recovered.

InvalidRecoveredPublicKey​

Recovered public key is invalid.

Stake and Balance Errors​

NotEnoughStake​

The caller does not have enough stake to perform this action.

NotEnoughStakeToWithdraw​

Not enough stake to withdraw.

NotEnoughStakeToSetWeights​

Less than minimum stake required to set weights.

NotEnoughStakeToSetChildkeys​

Parent hotkey doesn't have enough own stake.

NotEnoughBalanceToStake​

Not enough balance in coldkey account.

BalanceWithdrawalError​

Could not withdraw from coldkey account.

ZeroBalanceAfterWithdrawn​

Balance would be zero after withdrawal.

StakeTooLowForRoot​

Hotkey with too little stake attempting to join root subnet.

NotEnoughBalanceToPaySwapHotKey​

Not enough balance to pay swapping hotkey.

NotEnoughBalanceToPaySwapColdKey​

Not enough balance to pay for the swap.

AmountTooLow​

Stake amount is too low.

ZeroMaxStakeAmount​

Zero max stake amount.

CannotUnstakeLock​

Cannot unstake lock amount.

NotEnoughAlphaOutToRecycle​

Not enough AlphaOut to recycle.

CannotBurnOrRecycleOnRootSubnet​

Cannot burn/recycle TAO from root subnet.

InsufficientLiquidity​

Not enough liquidity in the pool.

SlippageTooHigh​

Transaction slippage is above your limit.

TransferDisallowed​

Transfers are disallowed on this subnet.

Weight Setting Errors​

NeuronNoValidatorPermit​

Attempting to set non-self weights without being a permitted validator.

WeightVecNotEqualSize​

Weight keys and values vectors have different sizes.

DuplicateUids​

Attempting to set weights with duplicate UIDs.

UidVecContainInvalidOne​

Attempting to set weight to non-existent UID.

WeightVecLengthIsLow​

Setting weights with fewer elements than allowed.

MaxWeightExceeded​

Weight value exceeds MaxWeightLimit.

SettingWeightsTooFast​

Exceeded rate limit for setting weights.

IncorrectWeightVersionKey​

Incorrect weight version key.

UidsLengthExceedUidsInSubNet​

More UIDs than allowed.

NoWeightsCommitFound​

No commit found for hotkey+netuid combination.

InvalidRevealCommitHashNotMatch​

Committed hash does not match reveal data.

CommitRevealEnabled​

Attempting to call set_weights when commit/reveal is enabled.

CommitRevealDisabled​

Attempting to commit/reveal weights when disabled.

TooManyUnrevealedCommits​

Maximum commit limit reached.

ExpiredWeightCommit​

Attempted to reveal expired weights.

RevealTooEarly​

Attempted to reveal weights too early.

InputLengthsUnequal​

Mismatched vector input lengths in batch reveal.

CommittingWeightsTooFast​

Exceeded rate limit for setting weights.

LiquidAlphaDisabled​

Attempting to set alpha high/low while disabled.

AlphaHighTooLow​

Alpha high value is too low (> 0.8 required).

AlphaLowOutOfRange​

Alpha low value is out of allowed range (0 < alpha_low < 0.8).

Rate Limiting Errors​

ServingRateLimitExceeded​

Rate limit exceeded for axon serve/publish.

NetworkTxRateLimitExceeded​

Rate limit exceeded for add network transaction.

DelegateTxRateLimitExceeded​

Rate limit exceeded for delegate transaction.

HotKeySetTxRateLimitExceeded​

Rate limit exceeded for setting/swapping hotkey.

StakingRateLimitExceeded​

Rate limit exceeded for staking.

TxRateLimitExceeded​

Default transaction rate limit exceeded.

TxChildkeyTakeRateLimitExceeded​

Childkey take rate limit exceeded.

Registration and Network Management​

TooManyRegistrationsThisBlock​

Too many registrations in this block.

TooManyRegistrationsThisInterval​

Too many registration attempts in interval.

CouldNotJoinSenate​

Not able to join the senate.

NotSenateMember​

Not a senate member.

NotSubnetOwner​

Not a subnet owner.

FirstEmissionBlockNumberAlreadySet​

First emission block number already set.

NeedWaitingMoreBlocksToStarCall​

Need to wait for more blocks.

Delegation and Childkey Errors​

DelegateTakeTooLow​

Delegate take is too low.

DelegateTakeTooHigh​

Delegate take is too high.

InvalidChild​

Invalid child for a hotkey.

DuplicateChild​

Duplicate child when setting children.

ProportionOverflow​

Proportion overflow when setting children.

TooManyChildren​

Too many children.

InvalidChildkeyTake​

Childkey take is invalid.

Other Errors​

InvalidIpType​

Invalid IP type (must be IPv4 or IPv6).

InvalidIpAddress​

Invalid IP address.

InvalidPort​

Invalid port.

InvalidWorkBlock​

Invalid PoW hash block.

InvalidDifficulty​

PoW hash block does not meet network difficulty.

InvalidSeal​

PoW hash seal does not match work.

FaucetDisabled​

Faucet is disabled.

SwapAlreadyScheduled​

Swap already scheduled.

FailedToSchedule​

Failed to schedule swap.

InvalidIdentity​

Invalid identity.

ActivityCutoffTooLow​

Activity cutoff is too low.

CallDisabled​

Call is disabled.

SubtokenDisabled​

SubToken disabled.

SameNetuid​

Invalid netuid duplication.