Dividends

Storage Map v101 → v411 Changed in v411

Dividend scores for neurons on a subnet .

Queried by: validatorsdelegatorsstakersanalytics

The Big Picture

Dividends are what validators earn for their validation work. While miners get incentive, validators get dividends. This score determines the validator's share of emissions, which then gets distributed to their delegators (minus take).

Why This Matters

Thinking about delegating to a validator? Dividends show their earning power. Higher dividends = more emissions = better returns for you (after take).

Example Scenario

Query Dividends(netuid=1, uid=5) returns 0.08 (8% of dividend pool). This validator captures 8% of validator emissions on subnet 1. Strong performance.

Common Questions

How do dividends translate to delegator returns?: Validator earns dividends, keeps their 'take' percentage, distributes rest to delegators proportionally. Your return = (dividends × (1 - take)) × (your_stake / total_validator_stake).
Why do some validators have zero dividends?: They may not have validator permit, may not be setting weights, or may have very low stake. Only active validators with sufficient stake earn dividends.

Use Cases

Check validator dividend earnings
Compare validator profitability for delegation
Build validator ranking by dividends
Calculate expected returns from delegation

From Chain Metadata

MAP ( netuid ) --> dividends

Purpose & Usage

Purpose

Track dividend allocation from staking.

Common Query Patterns

Query by netuid-uid

Part of: Yuma Consensus

Query Keys

#	Name	Type	Description
1	netuid	u16	netuid (u16, hashed key component)

Stored Value

Vec<u16> Vec

dividends (Vec<u16>)

Relationships

Modified By

burned_register register

Related Events

BulkNeuronsRegistered NeuronRegistered

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 Dividends storage
const netuid = 1;

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

On-Chain Activity

Write Frequency

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

100K–1M estimated writes

#35 most written storage item

Write Source Calls + Hooks

Modified by both user extrinsics and runtime hooks

As of block 7,429,232

Version History

Version:

v101 block 1 Added

v120 block 315,568 Internal re-bind

v123 block 720,235 Internal re-bind

v128–v132 · runtime versions skipped on chain (never deployed)

v133 block 1,404,224 Internal re-bind

v136 block 1,756,781 Internal re-bind

v138 block 1,907,363 Internal re-bind

v140 block 1,929,216 Internal re-bind

v146 block 2,848,978 Internal re-bind

v149 block 3,014,339 Internal re-bind

v151 block 3,157,274 Internal re-bind

v154 block 3,308,611 Internal re-bind

v166–v194 · runtime versions skipped on chain (never deployed)

v195 block 3,791,350 Internal re-bind

v202 block 3,848,823 Internal re-bind

v207–v209 · runtime versions skipped on chain (never deployed)

v210 block 4,345,556 Internal re-bind

v213–v215 · runtime versions skipped on chain (never deployed)

v216 block 4,510,996 Internal re-bind

v220–v232 · runtime versions skipped on chain (never deployed)

v233 block 4,920,350 Internal re-bind

v235–v237 · runtime versions skipped on chain (never deployed)

v238 block 4,936,550 Internal re-bind

v241–v243 · runtime versions skipped on chain (never deployed)

v244 block 4,999,897 Internal re-bind

v266–v272 · runtime versions skipped on chain (never deployed)

v273 block 5,659,032 Internal re-bind

v278–v289 · runtime versions skipped on chain (never deployed)

v290 block 5,947,548 Internal re-bind

v307–v314 · runtime versions skipped on chain (never deployed)

v315 block 6,414,634 Internal re-bind

v316–v319 · runtime versions skipped on chain (never deployed)

v320 block 6,523,566 Internal re-bind

v327–v333 · runtime versions skipped on chain (never deployed)

v334 block 6,811,690 Internal re-bind

v353–v360 · runtime versions skipped on chain (never deployed)

v361 block 7,063,679 Internal re-bind

v363–v364 · runtime versions skipped on chain (never deployed)

v365 block 7,135,419 Internal re-bind

v386–v390 · runtime versions skipped on chain (never deployed)

v391 block 7,782,857 Internal re-bind

v394–v400 · runtime versions skipped on chain (never deployed)

v401 block 8,036,576 Internal re-bind

v403–v410 · runtime versions skipped on chain (never deployed)

v411 block 8,283,784 Internal re-bind Current

Runtime Info

View Source

Pallet: SubtensorModule
Storage Kind: Map
First Version: v101
Current Version: v411

Back to SubtensorModule Storage