sudo_set_bonds_penalty

Call v233 → v277, v290 → current #60

Sets the bonds penalty parameter for a subnet .

View calls on chain

Click items to navigate. Pan and zoom to explore.

Used by: subnet owners

The Big Picture

Penalties discourage validators from frequently changing their miner preferences. Promotes stability.

Use Cases

  • Tuning bond incentives
  • Discouraging bond manipulation

From Chain Metadata

The extrinsic sets the bonds penalty for a subnet. It is only callable by the root account or subnet owner. The extrinsic will call the Subtensor pallet to set the bonds penalty.

Input Parameters

#NameTypeDescription
0
netuid
u16 NetUidnetuid: Subnet ID (u16, 0-65535)
1
bonds_penalty
u16 bonds_penalty (u16)

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

  • BondsPenalty updated

Side Effects

  • Affects penalty for bond violations

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_bonds_penalty call (typed, named args)
const netuid = 1;
const bonds_penalty = 0;

const tx = api.tx.AdminUtils.sudo_set_bonds_penalty({
  netuid,
  bonds_penalty,
});

Version History

v233 block 4,920,350 2 args
v290 block 5,947,548 2 args Current

Runtime Info

View Source
Pallet Index
19
Call Index
60
First Version
v233
Current Version
v411