Skip to main content
SUBMIT A PRSUBMIT AN ISSUElast edit: Jul 13, 2026

Subtensor Standard Errors

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

Related:

info

The following outline of subtensor errors is provided for high-level reference and is not exhaustive. For a complete specification of all available errors, see the Subtensor API reference.

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.

UnableToRecoverPublicKey​

Public key cannot be recovered.

InvalidRecoveredPublicKey​

Recovered public key is invalid.

HotKeySwapOnSubnetIntervalNotPassed​

Attempting a hotkey swap on subnet too frequently.

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.

InsufficientBalance​

The caller does not have enough balance for the operation.

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).

IncorrectCommitRevealVersion​

Incorrect commit-reveal version.

RevealPeriodTooLarge​

Reveal period is too large.

RevealPeriodTooSmall​

Reveal period is too small.

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.

StakingOperationRateLimitExceeded​

Attempting staking operations too frequently.

AddStakeBurnRateLimitExceeded​

The stake burn operation has exceeded its rate limit. Try again in the next tempo.

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.

Subnet Leasing Errors​

InvalidLeaseBeneficiary​

Invalid lease beneficiary to register the leased network.

LeaseCannotEndInThePast​

Lease cannot end in the past.

LeaseNetuidNotFound​

Couldn't find the lease netuid.

LeaseDoesNotExist​

Lease does not exist.

LeaseHasNoEndBlock​

Lease has no end block.

LeaseHasNotEnded​

Lease has not ended.

Overflow​

An overflow occurred.

BeneficiaryDoesNotOwnHotkey​

Beneficiary does not own hotkey.

ExpectedBeneficiaryOrigin​

Expected beneficiary origin.

Proxy Errors​

TooMany​

There are too many proxies registered or too many announcements pending.

NotFound​

Proxy registration not found.

NotProxy​

Sender is not a proxy of the account to be proxied.

Duplicate​

Proxy or relationship already exists.

Unproxyable​

A call which is incompatible with the proxy type's filter was attempted.

NoPermission​

Call may not be made by proxy because it may escalate its privileges.

Unannounced​

Announcement was made too recently or does not exist.

NoSelfProxy​

Account cannot add self as proxy.

AnnouncementDepositInvariantViolated​

Invariant violated: deposit recomputation returned None after updating announcements.

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.

ColdkeySwapAnnounced​

A coldkey swap has been announced for this account.

ColdkeySwapDisputed​

A coldkey swap for this account is under dispute.

ColdkeySwapAnnouncementNotFound​

Coldkey swap announcement not found

ColdkeySwapTooEarly​

Coldkey swap too early.

ColdkeySwapReannouncedTooEarly​

Coldkey swap reannounced too early.

AnnouncedColdkeyHashDoesNotMatch​

The announced coldkey hash does not match the new coldkey hash.

ColdkeySwapAlreadyDisputed​

Coldkey swap already disputed.

InvalidIdentity​

Invalid identity.

ActivityCutoffTooLow​

Activity cutoff is too low.

AdminActionProhibitedDuringWeightsWindow​

Admin operation is prohibited during the protected weights window.

CallDisabled​

Call is disabled.

SubtokenDisabled​

SubToken disabled.

SameNetuid​

Invalid netuid duplication.

SymbolDoesNotExist​

Symbol does not exist.

SymbolAlreadyInUse​

Symbol already in use.

BadOrigin​

Wallet not authorized. Ensure that the account has the correct root or subnet owner permissions.

InvalidValue​

Generic error for out-of-range parameter value

Deprecated​

Deprecated call.