Queries

commit-burn

Live decayed channel burn price and its stored configuration.

View as Markdown

burn is the price a commitment would pay now, or None when the burn is disabled/unconfigured. The runtime API returns no record when disabled, so this read also inspects CommitBurnConfig to show enabled and the other parameters. Direct storage readers should not treat stored burn as live: decay is lazy; this read's price_is_decayed marks the runtime quote.

Category: Identity & commitments

Parameters

ParameterTypeDescription
netuidintegerSubnet whose commitment channel to inspect.
mechidintegerMechanism whose channel to inspect.
channelintegerIndependent commitment channel index (0..255).

CLI

btcli query commit-burn --netuid <integer> --mechid <integer> --channel <integer> --json

Python

Namespace method (autocomplete, signature help):

import bittensor as bt

sub = bt.Subtensor()
result = sub.identity.commit_burn(netuid=1, mechid=1, channel=1)

Or dispatch by name, as an agent would:

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

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