sudo_set_subnet_emission_enabled

Call v411 → current New #94

Enables or disables pool-side emission for a subnet (alpha_in, tao_in, excess_tao chain-buy paths).

View calls on chain

Click items to navigate. Pan and zoom to explore.

Used by: subnet ownersanalyticsdevelopers

The Big Picture

This is a surgical pause: the subnet's share of emission is still computed, but the pool side (chain buys and injections) is turned off. Useful for subnet maintenance without disrupting the share-allocation accounting.

Use Cases

  • Pause pool-side emission on a subnet without removing it
  • Restart emission on a previously-paused subnet

From Chain Metadata

Enables or disables subnet pool-side emission for a subnet. This does not remove the subnet from emission share calculation and does not change `alpha_out`, owner cut, root proportion, pending server emission, or pending validator emission. It only zeros the pool-side `alpha_in`, `tao_in`, and `excess_tao` chain-buy paths.

Part of: Subnet Emission Control

Input Parameters

#NameTypeDescription
0
netuid
u16 NetUidSubnet whose pool-side emission switch is being toggled
1
enabled
bool Whether pool-side emission paths (chain buys, pool injections, excess_tao) are active for this subnet

Permissions

Origin
Root
Required Role

Permission data inferred from metadata. May be incomplete.

Requirements

  • Caller is root

Effects

Postconditions

  • SubnetEmissionEnabled[netuid] updated

Side Effects

  • SubnetEmissionEnabledSet event emitted
  • When disabled, pool injections and chain buys go to zero for the subnet
  • Does not remove the subnet from emission share calculation, owner cut, root proportion, or pending server/validator emission

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_subnet_emission_enabled call (typed, named args)
const netuid = 1;
const enabled = true;

const tx = api.tx.AdminUtils.sudo_set_subnet_emission_enabled({
  netuid,
  enabled,
});

Runtime Info

View Source
Pallet Index
19
Call Index
94
First Version
v411
Current Version
v411