Queries

weights

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

View as Markdown

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

ParameterTypeDescription
netuidintegerSubnet whose weight matrix to fetch.
mechidintegerMechanism index within the subnet; 0 (the default) on ordinary subnets.

CLI

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

Python

import bittensor as sub

async with sub.Client("finney") as client:
    result = await client.read("weights", netuid=1, mechid=1)