MinerBurned

Storage Map v421 → v490 · 1 shape change

Fraction of the last epoch miner incentive withheld from miners because it was assigned to owner hotkeys.

Explore chain
Queried by: subnet ownersminersanalytics

The Big Picture

Yuma can assign incentive to a UID the owner controls, but the coinbase refuses to pay it. This is the per-epoch ratio of refused incentive, a direct read on owner self-dealing pressure.

Use Cases

  • Measure how much of a subnet incentive is being pointed at owner-controlled miners
  • Reconcile epoch alpha movements

From Chain Metadata

MAP ( netuid ) --> miner_burned | Proportion (0..1) of this tempo's miner (incentive) emission that was withheld from miners during emission distribution because the recipient hotkey is owned by the subnet owner (immune key). Counts emission that is either recycled or burned, so the value is independent of the subnet's RecycleOrBurn configuration.

Purpose & Usage

Purpose

Record, per subnet and per epoch, what share of incentive went to hotkeys owned by the subnet owner and was recycled or burned instead of paid.

Common Query Patterns

  • Query by netuid
  • Overwritten every epoch

Notes

  • Written once per epoch in distribute_dividends_and_incentives (run_coinbase.rs L798-L802 at da06f033, v452) as withheld_incentive / total_incentive. Counts both the Recycle and Burn branches of RecycleOrBurn so the figure does not depend on that setting.
Part of: Subnet Emission SharesEpoch Processing

Migration Notes

v424 v432 Breaking

key type changed from u16 to NetUid

Update decoders: SCALE encoding is positional, so any signature change (added, removed, or type-changed fields, or storage shape changes) shifts byte offsets and existing decoders will misparse this item. Re-derive types from the new metadata.

Query Keys

#NameTypeDescription
1
netuid
NetUid u16netuid (NetUid, hashed key component)

Stored Value

miner_burned (FixedU128)

Default Value

0 0x00000000000000000000000000000000

Absent keys read as this value — querying a key that has never been written returns this default, not an error or empty result.

Decoding the value

substrate-fixed U96F32 (Q96.32), stored as u128 bits

Proportion in 0..1. Metadata names the type FixedU128, which here is substrate_fixed::FixedU128<U32>, the same U96F32 the runtime writes; divide the bits by 2^32.

Number(value as bigint) / 2 ** 32

Code Examples

import { createClient, Binary } from "polkadot-api";
import { getWsProvider } from "polkadot-api/ws";
import { sub } from "@polkadot-api/descriptors"; // generated by: npx papi add sub -w wss://entrypoint-finney.opentensor.ai:443

const client = createClient(getWsProvider("wss://entrypoint-finney.opentensor.ai:443"));
const api = client.getTypedApi(sub);

// Query MinerBurned storage
const netuid = 1;

const result = await api.query.SubtensorModule.MinerBurned.getValue(netuid);
console.log("MinerBurned:", result);

On-Chain Activity

Write Frequency
●●●●○○ Medium 100K–1M est. writes

100K to 1M writes

#174 most written storage item

Write Source Calls + Hooks

Modified by both user extrinsics and runtime hooks

As of block 9,385,000

Version History

v421 block 8,466,530 Added
v425–v431 · runtime versions skipped on chain (never deployed)
v432 block 8,636,190 Shape changed Current
  • key : u16 → NetUid

Runtime Info

View Source
Pallet
SubtensorModule
Storage Kind
Map
First Version
v421
Current Version
v490