ValidatorPermit

Storage Map v101 → v411 Changed in v411

Queried by: validatorsminersdelegatorsdevelopersanalytics

The Big Picture

Not everyone can be a validator. ValidatorPermit determines who can set weights and participate in consensus as a validator. Without a permit, you're a miner only - you receive weights but can't set them.

Why This Matters

Can this neuron validate? ValidatorPermit answers definitively. If false, they can't set weights and earn dividends. If true, they're a validator.

Example Scenario

Query ValidatorPermit(netuid=1, uid=5) returns true. UID 5 on subnet 1 can set weights and participate as a validator. Query for UID 47 returns false - they're a miner only.

Common Questions

How do you get a validator permit?: Based on stake. Top MaxAllowedValidators by stake on the subnet get permits. Permits are dynamic - gain enough stake and you get one, lose stake and you might lose it.
Can miners become validators?: Yes, if they accumulate enough stake to enter the top MaxAllowedValidators. The same neuron can transition between roles based on stake.
What if I have a permit but don't set weights?: You might lose dividends and could eventually lose your permit to more active validators. Permits come with responsibility.

Use Cases

Check if a neuron can act as validator
Verify validator status before delegating
Build validator-only listings
Debug weight-setting failures
Research validator distribution on subnet

From Chain Metadata

MAP ( netuid ) --> validator_permit

Purpose & Usage

Purpose

Track validator authorization - only neurons with permits can set weights.

Common Query Patterns

Query by netuid-uid
Check validator eligibility
Build validator listings

Part of: Yuma Consensus

Query Keys

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

Stored Value

Vec<bool> Vec

validator_permit (Vec<bool>)

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

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

On-Chain Activity

Write Frequency

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

100K–1M estimated writes

#38 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