NetworkRateLimitSet

Event Re-added v133 → v133, v134 → v135, v136 → v141, v142 → v148, v149 → v165, v195 → v219, v233 → v247, v252 → v265, v273 → v277, v290 → v315, v320 → v326, v334 → current #56

Emitted when network rate limit is changed.

View events on chain

Useful for: subnet ownersdevelopersanalytics

The Big Picture

Subnet creation is rate limited to prevent spam and ensure orderly growth. This parameter controls how many blocks must pass between subnet creations (network-wide). Lower limits allow faster ecosystem expansion; higher limits slow subnet proliferation.

Why This Matters

If you're racing to create a subnet, the rate limit affects when you can act. After someone else creates a subnet, you must wait for the limit to pass before the next creation is allowed. Understanding this helps you time your subnet launch.

Example Scenario

Subnet creation rate limit was 100 blocks. To slow ecosystem expansion, it's increased to 1000 blocks. NetworkRateLimitSet fires. Now after any subnet creation, the next creation must wait ~1000 blocks. Less frequent subnet launches, more controlled growth.

Common Questions

Is this per-user or network-wide?: Network-wide. If anyone creates a subnet, EVERYONE waits for the limit. It's not your personal rate limit - it's the network's rate limit.
What if I try during the rate limit period?: Your transaction fails. You must wait until the limit passes after the last subnet creation.
How do I know when the rate limit resets?: Track when the last subnet was created and add the rate limit. When current_block >= last_creation_block + rate_limit, you can create.

Use Cases

Track subnet creation frequency limits
Plan subnet launch timing
Monitor network growth policies
Build subnet opportunity tracking tools

How to Use This Event

→ Track rate limits for subnet creation timing
→ Monitor network growth governance
→ Build creation opportunity tracking tools

From Chain Metadata

the network creation rate limit is set.

Triggers

Preconditions

Caller has admin/sudo privileges

May fail with

NetworkDoesNotExist SubNetworkDoesNotExist RootNetworkDoesNotExist NetworkExist HotKeyNotRegisteredInNetwork EmissionValuesDoesNotMatchNetworks DidNotPassConnectedNetworkRequirement NetworkTxRateLimitExceeded IncorrectNetworkVersionKey AllNetworksInImmunity CanNotSetRootNetworkWeights

Effects

Postconditions

NetworkRateLimit updated

Side Effects

Affects how often new subnets can be created

Event Data

#	Name	Type	Description
0	arg0	u64	Event field #0 (u64)

Code Examples

import { ApiPromise, WsProvider } from "@polkadot/api";
import { stringCamelCase } from "@polkadot/util";

const provider = new WsProvider("wss://entrypoint-finney.opentensor.ai:443");
const api = await ApiPromise.create({ provider });

// Subscribe to NetworkRateLimitSet events
api.query.system.events((events) => {
  events
    .filter(({ event }) =>
      event.section === stringCamelCase("SubtensorModule") &&
      event.method === "NetworkRateLimitSet"
    )
    .forEach(({ event }) => {
      console.log("NetworkRateLimitSet:", event.data.toHuman());
    });
});

Version History

Version:

v133 block 1,404,224 1 args

v134 block 1,455,498 1 args

v136 block 1,756,781 1 args

v142 block 2,543,779 1 args

v149 block 3,014,339 1 args

v195 block 3,791,350 1 args

v233 block 4,920,350 1 args

v252 block 5,163,656 1 args

v273 block 5,659,032 1 args

v290 block 5,947,548 1 args

v320 block 6,523,566 1 args

v334 block 6,811,690 1 args Current

Runtime Info

View Source

Pallet Index: 7
Event Index: 56
First Version: v133
Current Version: v393

Back to SubtensorModule Events