schedule_named

Call v133 → v148, v149 → current #2

Schedule a named task for future execution with a unique identifier.

View calls on chain

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

#NameTypeDescription
0
id
[u8; 32] [32] TaskNameid ([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::Prioritypriority (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

Events Emitted

Storage Modified

Postconditions

  • Call added to Agenda
  • Name registered in Lookup storage

Side Effects

  • Lookup entry created
  • Deposit may be reserved

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