PendingChildKeys

Storage Map v216 → current

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	key1	u16	key1 (u16)
2	key2	AccountId	key2 (AccountId) (hex -> SS58)

Stored Value

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

Value in RAO (÷10⁹ for TAO)

Relationships

Modified By

set_children

Related Events

SetChildren SetChildrenScheduled

Code Examples

import { ApiPromise, WsProvider } from "@polkadot/api";
import { stringCamelCase } from "@polkadot/util";

const provider = new WsProvider("wss://entrypoint-finney.opentensor.ai:443");
const api = await ApiPromise.create({ provider });

// Query PendingChildKeys storage
const key1 = 0;
const key2 = "5GrwvaEF5zXb26Fz9rcQpDWS57CtERHpNehXCPcNoHGKutQY";

const result = await api.query
  [stringCamelCase("SubtensorModule")]
  [stringCamelCase("PendingChildKeys")](
  key1,
  key2
);

console.log("PendingChildKeys:", result.toHuman());

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

Runtime Info

View Source

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

Back to SubtensorModule Storage