Keys

Storage Map v101 → v411 Changed in v411

Hotkey at a specific UID on a subnet .

Queried by: minersvalidatorssubnet ownersdevelopersanalytics

The Big Picture

UIDs are the internal identifiers for neurons on a subnet. Keys maps UID→hotkey, while Uids maps hotkey→UID. Together they let you look up neurons in either direction.

Why This Matters

When you see 'UID 47 on subnet 1', this tells you which hotkey that is. Essential for understanding who's who on a subnet.

Example Scenario

Query Keys(netuid=1, uid=47) returns the hotkey address for UID 47 on subnet 1. Now you know which validator or miner that UID represents.

Common Questions

What if the UID doesn't exist?: Returns a default value (zero address). Check SubnetworkN to see valid UID range.

Use Cases

Find which hotkey holds a specific UID
List all registered neurons on a subnet
Map UIDs to addresses for indexing

From Chain Metadata

DMAP ( netuid, uid ) --> hotkey

Purpose & Usage

Purpose

Reverse lookup from UID to hotkey address.

Common Query Patterns

Get hotkey for a UID on a subnet
Iterate all registered hotkeys on a subnet

Part of: Neuron Registration Neuron Pruning

Query Keys

#	Name	Type	Description
1	netuid	u16	Subnet ID (NetUidStorageIndex in source — a remap of NetUid for storage)
2	uid	u16	Neuron UID

Stored Value

AccountId

Hotkey address registered at this UID

Source src/lib.rs:1934-1944

Decoding the value

AccountId (32-byte hex)

Bittensor uses SS58 prefix 42 for both hotkeys and coldkeys. The 32 bytes are sr25519 public keys.

value as `0x${string}` // 32-byte AccountId

Relationships

Modified By

burned_register register root_register swap_hotkey

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

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

On-Chain Activity

Write Frequency

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

100K–1M estimated writes

#27 most written storage item

Write Source User Extrinsics

Modified via user-submitted 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

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