sudo_set_max_burn

Call v138 → v277, v290 → v298, v301 → v385, v391 → current #23

Sets the maximum burn amount for registration on a subnet .

View calls on chain

Click items to navigate. Pan and zoom to explore.

Used by: subnet owners

The Big Picture

Caps how expensive burn registration can become during demand spikes. Keeps subnets accessible.

Use Cases

  • Capping registration costs
  • Preventing prohibitive burn requirements

From Chain Metadata

The extrinsic sets the maximum burn for a subnet. It is only callable by root and subnet owner. The extrinsic will call the Subtensor pallet to set the maximum burn.

Input Parameters

#NameTypeDescription
0
netuid
u16 NetUidnetuid: Subnet ID (u16, 0-65535)
1
max_burn
u64 TaoBalancemax_burn: TAO amount in RAO (÷10⁹ for TAO) (RAO -> TAO (/ 10^9))

Permissions

Origin
Root
Required Role

Permission data inferred from metadata. May be incomplete.

Requirements

  • Caller is root or subnet owner
  • Subnet exists

Effects

Storage Modified

Postconditions

  • MaxBurn updated

Side Effects

  • Burn registration cannot cost more than this

Code Examples

import { createClient, Binary } from "polkadot-api";
import { getWsProvider } from "polkadot-api/ws";
import { sub } from "@polkadot-api/descriptors"; // generated by: npx papi add sub -w wss://entrypoint-finney.opentensor.ai:443

const client = createClient(getWsProvider("wss://entrypoint-finney.opentensor.ai:443"));
const api = client.getTypedApi(sub);

// Build sudo_set_max_burn call (typed, named args)
const netuid = 1;
const max_burn = 0n;

const tx = api.tx.AdminUtils.sudo_set_max_burn({
  netuid,
  max_burn,
});

Version History

v138 block 1,907,363 2 args
v290 block 5,947,548 2 args
v301 block 6,205,194 2 args
v391 block 7,782,857 2 args Current

Runtime Info

View Source
Pallet Index
19
Call Index
23
First Version
v138
Current Version
v411