sudo_set_num_root_claims

Call v334 → current #123

Sets number of root claims allowed (admin).

View calls on chain

Click items to navigate. Pan and zoom to explore.

Used by: developerssubnet owners

The Big Picture

Root claiming has costs (transaction overhead, state changes). This parameter controls how many claims can happen - either per account, per period, or total. It's a tuning knob for root economics, balancing validator convenience with network efficiency.

Why This Matters

Too many claims = network overhead and potential spam. Too few = validators can't access earnings when needed. This parameter finds the balance, set by governance based on observed network behavior.

Example Scenario

Root claiming is causing excessive network load. Governance decides to limit claims per account. Admin calls sudo_set_num_root_claims(count=10). Now each account can make at most 10 root claims per period, reducing spam.

Common Questions

Does this affect how much I can claim?
Not the amount - just the frequency or number of claim transactions. Your earned emissions are unaffected; you just might need to batch claims.
What if I need more claims than allowed?
Accumulate emissions and claim larger amounts less often. The total claimable isn't limited, just the number of claim transactions.

Use Cases

  • Tune root claim economics and frequency
  • Prevent claim spam or manipulation
  • Adjust claiming capacity during network scaling
  • Balance claim frequency with network load

From Chain Metadata

Sets root claim number (sudo extrinsic). Zero disables auto-claim.

Input Parameters

#NameTypeDescription
0
new_value
u64 new_value (u64) (RAO -> TAO (/ 10^9))

Permissions

Origin
Unknown
Required Role
Any

Permission data inferred from metadata. May be incomplete.

Requirements

  • Caller has sudo privileges
  • Valid count specified

Effects

Storage Modified

NumRootClaim

Postconditions

  • Root claim limit updated
  • Affects how many times/accounts can claim root

Side Effects

  • Affects root emission claiming frequency or capacity
  • May impact root validator economics

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 });

// Build sudo_set_num_root_claims call
const new_value = 0;

const call = api.tx[stringCamelCase("SubtensorModule")][stringCamelCase("sudo_set_num_root_claims")](
  new_value
);

Runtime Info

View Source
Pallet Index
7
Call Index
123
First Version
v334
Current Version
v393
Back to SubtensorModule Calls