# commit-burn (/docs/query/commit-burn)

`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 [#parameters]

| Parameter | Type    | Description                                    |
| --------- | ------- | ---------------------------------------------- |
| `netuid`  | integer | Subnet whose commitment channel to inspect.    |
| `mechid`  | integer | Mechanism whose channel to inspect.            |
| `channel` | integer | Independent commitment channel index (0..255). |

## CLI [#cli]

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

## Python [#python]

Namespace method (autocomplete, signature help):

```python
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:

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

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