Queries

coldkey-lock

Lock state for a coldkey on a subnet, or None if no lock exists.

View as Markdown

locked_alpha is denominated in the subnet's alpha and rolled forward (decayed) to the current block; is_perpetual locks do not decay.

Category: Locks & conviction

Parameters

ParameterTypeDescription
coldkey_ss58stringColdkey whose lock to read.
netuidintegerSubnet to query.

CLI

btcli query coldkey-lock --coldkey <ss58|name> --netuid <integer> --json

Python

Namespace method (autocomplete, signature help):

import bittensor as bt

sub = bt.Subtensor()
result = sub.locks.coldkey_lock(coldkey_ss58="5F...", netuid=1)

Or dispatch by name, as an agent would:

result = sub.read("coldkey_lock", coldkey_ss58="5F...", 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.