PendingChange

Storage Plain v101 → current

Scheduled authority set change waiting to be applied.

Queried by: validatorsdevelopers

The Big Picture

When the validator set is about to change (at session boundaries or forced), this storage contains the pending change details: new authorities, when it activates, and the delay. Usually None between session changes.

Use Cases

Check if an authority set change is scheduled
Prepare validators for upcoming set transitions
Monitor forced change announcements

From Chain Metadata

Pending change: (signaled at, scheduled change).

Purpose & Usage

Purpose

Holds details of upcoming GRANDPA validator set transitions.

Common Query Patterns

Single value query (None if no pending change)

Stored Value

StoredPendingChange

value (StoredPendingChange)

Default Value

None (absent keys return no value)

Optional storage: querying a key that has never been written returns no value (None) — do not assume a zero default.

Relationships

Modified By

note_stalled

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 PendingChange storage (no keys - plain value)
const result = await api.query.Grandpa.PendingChange.getValue();
console.log("PendingChange:", result);

Runtime Info

Pallet: Grandpa
Storage Kind: Plain
First Version: v101
Current Version: v472

Back to Grandpa Storage