NetworkTxRateLimitExceeded

Error v151 → v212, v216 → v219, v233 → v315, v320 → v393, v401 → current 7.33

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 Shape modified
v233 block 4,920,350 Shape modified
v320 block 6,523,566 Shape modified
v401 block 8,036,576 Shape modified Current

Runtime Info

Pallet Index
7
Error Index
33
Error Code
7.33
Runtime Version
v411