NetworkTxRateLimitExceeded

Error Re-added v151 → v212, v216 → v219, v233 → v315, v320 → current 7.32

Network creation is rate limited and you're creating too fast.

Encountered by: subnet ownersdevelopers

Why This Error Exists

Subnet creation is rate-limited to prevent rapid-fire subnet creation that could destabilize the network. This gives the network time to adjust to new subnets and prevents gaming through quick create-dissolve cycles. The limit is network-wide, not per-coldkey.

Deep Dive

NetworkRateLimit specifies the minimum blocks between ANY subnet creations network-wide. NetworkLastRegistered stores the block of the most recent subnet creation. If current_block - NetworkLastRegistered < NetworkRateLimit, new creations fail. This is a global cooldown, so even if YOU haven't created a subnet recently, someone else might have.

Debugging Example

You call register_network(...). Error: NetworkTxRateLimitExceeded. Query NetworkLastRegistered - returns block 1,000,000. Query NetworkRateLimit - returns 14,400 blocks (~48 hrs). Current block is 1,010,000. Need to wait until block 1,014,400. That's 4,400 more blocks (~15 hours).

Prevention Tips

  • Check NetworkLastRegistered + NetworkRateLimit before attempting subnet creation
  • Be prepared to retry if someone else creates a subnet just before you
  • Monitor the network for recent subnet creations if timing is critical

From Chain Metadata

A transactor exceeded the rate limit for add network transaction.

What This Means

Network creation is rate limited and you're creating too fast.

Common Causes

  • Created a network too recently
  • Must wait between network creations

How to Fix

  • Wait for NetworkRateLimit blocks to pass
  • Check SubtensorModule.NetworkLastRegistered for timing

Storage to Check

Thrown By

Version History

v151 block 3,157,274 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
32
Error Code
7.32
Runtime Version
v393