sudo_set_root_claim_threshold

Call v334 → current #124

Sets threshold for root claims (admin).

View calls on chain

Click items to navigate. Pan and zoom to explore.

Used by: developerssubnet owners

The Big Picture

Claiming tiny amounts (dust) wastes network resources - the transaction cost may exceed the claim value. The threshold sets a minimum: you can't claim until your pending emissions reach this amount. This ensures claims are economically meaningful.

Why This Matters

Every claim transaction costs network resources. If someone claims 0.001 TAO, the overhead exceeds the value. Thresholds ensure claims are worthwhile - accumulate enough before claiming, reducing waste for everyone.

Example Scenario

Validators are claiming tiny dust amounts (0.01 TAO) frequently. Admin sets a floor: sudo_set_root_claim_threshold(threshold=1 TAO). Now you must accumulate at least 1 TAO in pending root emissions before claiming.

Common Questions

What if I never reach the threshold?
Emissions accumulate indefinitely. Small validators will eventually reach it - it just takes longer. There's no expiration on pending emissions.
Can I claim partial amount above threshold?
Typically claim_root claims everything pending. The threshold is just the minimum to initiate a claim, not a per-transaction limit.
What's a reasonable threshold?
Depends on transaction costs. Generally: threshold should be 10-100x typical transaction fee to ensure claims are worthwhile.

Use Cases

  • Prevent dust claims that waste network resources
  • Set minimum meaningful claim amount
  • Reduce claim transaction spam
  • Tune economics for meaningful claim transactions

From Chain Metadata

Sets root claim threshold for subnet (sudo or owner origin).

Input Parameters

#NameTypeDescription
0
netuid
u16 Subnet/network identifier (0-65535)
1
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 threshold amount specified

Effects

Storage Modified

RootClaimableThreshold

Postconditions

  • Threshold updated
  • Affects minimum claimable amount

Side Effects

  • Affects who can claim root emissions
  • Prevents dust claims below threshold

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_root_claim_threshold call
const netuid = 1;
const new_value = 0;

const call = api.tx[stringCamelCase("SubtensorModule")][stringCamelCase("sudo_set_root_claim_threshold")](
  netuid,
  new_value
);

Runtime Info

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