OwnerHyperparamRateLimitSet

Event v320 → current #43

Emitted when subnet owner hyperparameter rate limit is changed.

View events on chain
Useful for: subnet ownersvalidatorsminersanalytics

The Big Picture

Subnet owners can adjust hyperparameters (tempo, difficulty, etc.), but they're rate limited to prevent constant changes that destabilize the subnet. This parameter controls how long owners must wait between hyperparameter changes. Longer limits mean more stable but slower-evolving subnets; shorter limits allow faster iteration.

Why This Matters

As a subnet owner, this limits how quickly you can iterate on parameters. As a participant, it protects you from constant parameter churn. Understanding the limit helps everyone plan around when changes can and can't happen.

Example Scenario

Subnet owners could change parameters every 100 blocks. To increase stability, the limit is increased to 1000 blocks. OwnerHyperparamRateLimitSet fires. Owners now wait 1000 blocks between hyperparameter changes - more predictable environment for participants.

Common Questions

Does this apply to all hyperparameters?
Typically yes, but some parameters might have their own limits. Check if specific parameters have override rate limits.
Can I make emergency changes faster?
Usually no - rate limits are enforced. For emergencies, you'd need admin/sudo intervention, which has its own rules and freeze windows.
What happens if I try to change before the limit?
Your transaction fails. You must wait for the rate limit to pass before your next hyperparameter change is accepted.

Use Cases

  • Track how often subnet owners can change parameters
  • Plan hyperparameter adjustment timelines
  • Monitor subnet stability policies
  • Build subnet management tools

How to Use This Event

  • Monitor rate limits affecting your subnet management
  • Track stability policies across the network
  • Build subnet configuration planning tools

From Chain Metadata

setting the owner hyperparameter rate limit in epochs

Triggers

Preconditions

  • Caller has admin/sudo privileges

Effects

Postconditions

  • Rate limit for owner param changes updated

Side Effects

  • Subnet owners must wait between param changes

Event Data

#NameTypeDescription
0
arg0
u16 Event field #0 (u16)

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 OwnerHyperparamRateLimitSet events
api.query.system.events((events) => {
  events
    .filter(({ event }) =>
      event.section === stringCamelCase("SubtensorModule") &&
      event.method === "OwnerHyperparamRateLimitSet"
    )
    .forEach(({ event }) => {
      console.log("OwnerHyperparamRateLimitSet:", event.data.toHuman());
    });
});

Runtime Info

View Source
Pallet Index
7
Event Index
43
First Version
v320
Current Version
v393