schedule_named
Call v133 → v148, v149 → current #2Schedule a named task for future execution with a unique identifier.
View calls on chainCall Workflow
This diagram shows the call execution flow: starting with schedule_named, passing through validation
(signature, nonce, mortality, fee payment), then pre-dispatch checks, followed by dispatch which emits events: Scheduled and modifies storage: Agenda, Lookup, and finally post-dispatch where ExtrinsicSuccess is emitted and fees are settled.
Press enter or space to select a node. You can then use the arrow keys to move the node around. Press delete to remove it and escape to cancel.
Press enter or space to select an edge. You can then press delete to remove it or escape to cancel.
Click items to navigate. Pan and zoom to explore.
Used by: developersanalytics
The Big Picture
Named scheduling adds an identifier making it easier to cancel or query tasks.
Use Cases
- Schedule operations that may need cancellation by name
- Create identifiable tasks
From Chain Metadata
See [`Pallet::schedule_named`].
Input Parameters
| # | Name | Type | Description |
|---|---|---|---|
| 0 | id | [u8; 32] [32] TaskName | id ([u8; 32]) |
| 1 | when | u32 BlockNumberFor<T> | when: Block number |
| 2 | maybe_periodic | Option Option<schedule::Period<BlockNumberFor<T>>> | maybe_periodic (Option) |
| 3 | priority | u8 schedule::Priority | priority (u8) |
| 4 | call | RuntimeCall Box<<T as Config>::RuntimeCall> | call (RuntimeCall) |
Permissions
Origin
Unknown
Required Role
Permission data inferred from metadata. May be incomplete.
Requirements
- Caller has permission
- Target block in future
- Name not in use
Effects
Code Examples
// ----------------------------------------------------------------------
// HEADS UP: 1 arg below has a complex type with no usable default.
// Look for `undefined as any` and replace it with real value
// before running — the snippet compiles, but will fail at runtime as-is.
// ----------------------------------------------------------------------
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);
// Build schedule_named call (typed, named args)
const id = "0x0000000000000000000000000000000000000000000000000000000000000000";
const when = 0;
const maybe_periodic = undefined;
const priority = 0;
const call = undefined as any /* RuntimeCall — replace with real value */;
const tx = api.tx.Scheduler.schedule_named({
id,
when,
maybe_periodic,
priority,
call,
});Version History
v133 block 1,404,224 5 args
v149 block 3,014,339 5 args Current
Runtime Info
- Pallet Index
- 15
- Call Index
- 2
- First Version
- v133
- Current Version
- v411