weights.mdx

title	weights
description	Validator weight rows as `{validator_uid: {miner_uid: fraction}}`, each row summing to 1.

{/* GENERATED by scripts/generate.py from the SDK registries — do not edit. */}

The chain stores max-upscaled u16 values whose absolute scale carries no meaning — consensus only uses within-row proportions — so rows are normalized to fractions here. On commit-reveal subnets a validator's row updates only when its timelocked commit reveals (see timelocked_weight_commits for what is pending).

Category: Weights & bonds

Parameters

Parameter	Type	Description
netuid	integer	Subnet whose weight matrix to fetch.
mechid	integer	Mechanism index within the subnet; 0 (the default) on ordinary subnets.

CLI

btcli query weights --netuid <integer> --mechid <integer> --json

Python

Namespace method (autocomplete, signature help):

import bittensor as bt

sub = bt.Subtensor()
result = sub.weights.weights(netuid=1, mechid=1)

Or dispatch by name, as an agent would:

result = sub.read("weights", netuid=1, mechid=1)

Async is the same surface awaited: async with bt.Subtensor() as client:.

On-chain implementation

• Storage SubtensorModule.Weights

Every file is browsable under /code exactly as built into the runtime.