AlphaDividendsPerSubnet

Storage Map v233 → current

Queried by: validatorsdelegatorsanalytics

The Big Picture

Validators earn dividends for their consensus work. AlphaDividendsPerSubnet records how much each validator earned (in alpha) at the last epoch. Delegators share in these dividends proportional to their stake, minus the validator's take.

Why This Matters

How much did this validator earn? AlphaDividendsPerSubnet shows their alpha earnings. This directly affects delegator returns - more dividends = more to share.

Example Scenario

Query AlphaDividendsPerSubnet(netuid=1, hotkey=validator_X) returns 100000000000 (100B alpha units). This validator earned 100B alpha in dividends at the last epoch.

Common Questions

How does this become delegator earnings?: Validator keeps their 'take' percentage. Remaining dividends go to delegators proportional to stake. Your earnings = (dividends × (1 - take)) × (your stake / total validator stake).
Why alpha instead of TAO?: Dividends are distributed in the subnet's native unit (alpha). Alpha can be converted to TAO via the AMM when unstaking.

Use Cases

Check validator dividend earnings on a subnet
Compare validator performance by dividends
Calculate delegator returns from validator earnings
Build validator profitability dashboards
Research dividend distribution patterns

Purpose & Usage

Purpose

Track dividend allocation at epoch - how much each validator earned in alpha terms.

Common Query Patterns

Query by netuid-hotkey
Calculate validator earnings
Build dividend leaderboards

Query Keys

#	Name	Type	Description
1	key1	u16	key1 (u16)
2	key2	AccountId	key2 (AccountId) (hex -> SS58)

Stored Value

u64

Value in RAO (÷10⁹ for TAO)

RAO -> TAO (/ 10^9)

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 });

// Query AlphaDividendsPerSubnet storage
const key1 = 0;
const key2 = "5GrwvaEF5zXb26Fz9rcQpDWS57CtERHpNehXCPcNoHGKutQY";

const result = await api.query
  [stringCamelCase("SubtensorModule")]
  [stringCamelCase("AlphaDividendsPerSubnet")](
  key1,
  key2
);

console.log("AlphaDividendsPerSubnet:", result.toHuman());

Runtime Info

View Source

Pallet: SubtensorModule
Storage Kind: Map
First Version: v233
Current Version: v393

Back to SubtensorModule Storage