PendingChildKeys

Storage Map v216 → v411

Scheduled child key changes awaiting execution.

Queried by: validatorsdevelopersanalytics

The Big Picture

Child key changes don't execute immediately - they're scheduled with a delay for security. PendingChildKeys shows what changes are queued and when they'll take effect.

Why This Matters

Changed your child keys but nothing happened? Changes are pending. This shows what's scheduled and lets you verify or cancel before execution.

Example Scenario

Query PendingChildKeys(parent=hotkey_X, netuid=1) returns scheduled changes - new children, proportion changes, or removals that will execute after the delay period.

Common Questions

Why the delay?: Security. If someone compromises your key and changes child relationships, the delay gives you time to notice and respond.
Can I cancel pending changes?: Typically yes - submit new changes to override pending ones before execution.

Use Cases

Check if you have pending child key changes
Verify scheduled changes before execution
Build child key management dashboards
Monitor for unexpected configuration changes
Track child key relationship updates

From Chain Metadata

DMAP ( netuid, parent ) --> (Vec<(proportion,child)>, cool_down_block)

Purpose & Usage

Purpose

Track pending child key modifications - changes go through a delay for security.

Common Query Patterns

Query pending changes for a parent
Check if child key changes are scheduled
Monitor for upcoming configuration changes

Part of: Child Hotkeys

Query Keys

#	Name	Type	Description
1	netuid netuid raw: key1	u16	Subnet ID
2	parent account raw: key2	AccountId	Parent hotkey AccountId32 (hex -> SS58)

Stored Value

(Vec<(u64, AccountId)>, u64)

.0
pending_children — List of pending (proportion, child) pairs scheduled to take effect after cool_down_block. proportion is a u64 scaled to u64::MAX (sum to u64::MAX = 100%).
.1
cool_down_block — Block number at which the pending child-key set is allowed to be applied. Acts as a rate-limit / dispute window.

Relationships

Modified By

set_children

Related Events

SetChildren SetChildrenScheduled

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 PendingChildKeys storage
const key1 = 0;
const key2 = "5GrwvaEF5zXb26Fz9rcQpDWS57CtERHpNehXCPcNoHGKutQY";

const result = await api.query.SubtensorModule.PendingChildKeys.getValue(key1, key2);
console.log("PendingChildKeys:", result);

On-Chain Activity

Write Frequency

●●●○○○ Low 10K–100K est. writes

10K–100K estimated writes

#47 most written storage item

Write Source User Extrinsics

Modified via user-submitted extrinsics

As of block 7,429,232

Version History

Version:

v216 block 4,510,996 Added

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

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

v273 block 5,659,032 Internal re-bind

v275–v275 · runtime versions skipped on chain (never deployed)

v276 block 5,781,672 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

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 Current

Runtime Info

View Source

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

Back to SubtensorModule Storage