IncentiveAlphaEmittedToMiners

Event Re-added v315 → v315, v320 → v326, v334 → v367, v372 → v377, v385 → current #108

Emitted at end of epoch showing alpha distributed to miners by UID .

Useful for: minersvalidatorssubnet ownersanalyticsdevelopers

The Big Picture

This is THE event for understanding miner economics. At each epoch boundary, validators' weights are aggregated via Yuma Consensus into incentive scores for each miner. Those incentive scores determine how much Alpha each miner earns. This event lists every miner UID and their Alpha reward for that epoch - the definitive record of who earned what.

Why This Matters

As a miner, your income depends on how validators score you. This event shows exactly how much Alpha you earned each epoch. Low rewards? Your responses aren't scoring well. Competitive rewards? You're performing at market rate. This is your paycheck stub.

Example Scenario

You're mining on subnet 1. The epoch ends at block 1,000,000. IncentiveAlphaEmittedToMiners fires with emissions array: [UID 12: 0.5 Alpha, UID 45: 1.2 Alpha, UID 78 (you): 0.8 Alpha, ...]. Your miner at UID 78 earned 0.8 Alpha this epoch. At current rates (~1 Alpha = 1.1 TAO), that's roughly 0.88 TAO for this epoch.

Common Questions

Why did I get less Alpha than other miners?: Your incentive score was lower. This comes from validator weights - if validators gave you lower scores, your share of emissions is smaller. Check your response quality.
How often does this event fire?: Once per epoch per subnet. Check the subnet's Tempo parameter for epoch length - could be every 12 seconds to every few minutes depending on the subnet.
Is this my total reward?: This is your miner incentive reward. If you also have stake, you earn dividends separately. This event specifically tracks the mining/inference portion.

Use Cases

Track miner earnings in real-time at epoch boundaries
Build miner performance dashboards showing per-UID rewards
Analyze emission distribution patterns across subnets
Verify that your miner is receiving expected rewards
Build tax/accounting tools that track income per epoch

How to Use This Event

→ Subscribe to specific subnet to track all miner payouts
→ Filter by your own UID to track personal earnings
→ Aggregate across epochs to build performance history
→ Compare rewards across miners to evaluate competition

From Chain Metadata

End-of-epoch miner incentive alpha by UID

Triggers

Preconditions

Epoch has ended
Subnet has active miners
Miners have non-zero incentive from consensus

Effects

Postconditions

Alpha rewards calculated and distributed
Miner alpha balances increased proportional to incentive

Side Effects

Miners' alpha balances increased
SubnetAlphaOut increased
Affects future Alpha/TAO exchange rates

Event Data

#	Name	Type	Description
0	netuid	u16	Subnet/network identifier (0-65535)
1	emissions	Vec<u64> Vec	emissions (Vec<u64>)

Code Examples

import { ApiPromise, WsProvider } from "@polkadot/api";
import { stringCamelCase } from "@polkadot/util";

const provider = new WsProvider("wss://entrypoint-finney.opentensor.ai:443");
const api = await ApiPromise.create({ provider });

// Subscribe to IncentiveAlphaEmittedToMiners events
api.query.system.events((events) => {
  events
    .filter(({ event }) =>
      event.section === stringCamelCase("SubtensorModule") &&
      event.method === "IncentiveAlphaEmittedToMiners"
    )
    .forEach(({ event }) => {
      console.log("IncentiveAlphaEmittedToMiners:", event.data.toHuman());
    });
});

On-Chain Activity

Emission Frequency

●●●○○○ Active 100K–1M emissions

Regular feature-level activity

#33 most emitted event

As of block 7,429,232

Version History

Version:

v315 block 6,414,634 2 args

v320 block 6,523,566 2 args

v334 block 6,811,690 2 args

v372 block 7,430,358 2 args

v385 block 7,782,670 2 args Current

Runtime Info

View Source

Pallet Index: 7
Event Index: 108
First Version: v315
Current Version: v393

Back to SubtensorModule Events