Bonds

Storage Map v101 → v411 Changed in v411

Bond values between neurons.

Queried by: validatorsminersanalyticsdevelopers

The Big Picture

Bonds represent accumulated 'investment' from validators in miners. When a validator consistently gives weight to a miner, bonds accumulate. Bonds affect dividend distribution - validators earn dividends proportional to their bonds. It's a moving average of historical weight relationships that creates stickiness and rewards long-term commitment.

Why This Matters

Bonds explain why validator dividends aren't just based on current weights. A validator who has supported a miner for a long time has accumulated bonds and earns more when that miner does well.

Example Scenario

Query Bonds(netuid=1, uid=5) returns [(12, 0.15), (47, 0.08), ...]. Validator UID 5 has a 15% bond with miner 12 and 8% with miner 47. These bonds affect dividend calculations.

Common Questions

How do bonds accumulate?: Bonds grow when validators give weight to miners, smoothed by BondsMovingAverage parameter. It's like a weighted moving average of historical weight relationships.
Why do bonds matter for dividends?: Dividends are distributed based on bonds, not just current weights. This rewards validators who consistently support good miners over time.
Can bonds decrease?: Yes, if a validator stops weighting a miner or weights them less, bonds decay over time according to the moving average.

Use Cases

Understand validator-miner economic relationships
Analyze network topology and dependencies
Debug consensus mechanism behavior
Research bond accumulation dynamics
Build bond visualization tools

From Chain Metadata

DMAP ( netuid, uid ) --> bonds

Purpose & Usage

Purpose

Track validator-miner bond relationships - accumulated investment from validators to miners.

Common Query Patterns

Query by netuid-uid for a validator's bond portfolio
Analyze bond distribution across miners
Track bond evolution over time

Part of: Yuma Consensus Liquid Alpha

Query Keys

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

Stored Value

Vec<(u16, u16)> Vec

bonds (Vec<(u16, u16)>)

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 Bonds storage
const netuid = 1;
const uid = 0;

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

On-Chain Activity

Write Source Runtime Hook

Modified by runtime hooks (e.g., epoch transitions), not directly by user extrinsics

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

v293–v296 · runtime versions skipped on chain (never deployed)

v297 block 6,067,943 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