Queries

subnet-collateral

Every `(hotkey, coldkey)` position with standing collateral on a subnet.

View as Markdown

The list validator code reads to enforce a per-machine collateral requirement: each record carries the locked amount, the miner's self-maintained floor, the drain-ratio snapshot, and the hotkey's current uid (None when the hotkey is deregistered but its collateral persists) — ready to join against the metagraph when scoring.

Category: Mining & collateral

Parameters

ParameterTypeDescription
netuidintegerSubnet to query.

CLI

btcli query subnet-collateral --netuid <integer> --json

Python

Namespace method (autocomplete, signature help):

import bittensor as bt

sub = bt.Subtensor()
result = sub.collateral.subnet_collateral(netuid=1)

Or dispatch by name, as an agent would:

result = sub.read("subnet_collateral", netuid=1)

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

On-chain implementation

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