schedule_named

Call v133 → 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

Schedule a named task.

Input Parameters

#NameTypeDescription
0
id
[u8; 32] [32]id ([u8; 32])
1
when
u32 when (u32)
2
maybe_periodic
Option maybe_periodic (Option)
3
priority
u8 priority (u8)
4
call
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

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 });

// Build schedule_named call
const id = 0;
const when = 0;
const maybe_periodic = 0 as any /* Option */;
const priority = 0;
const call = 0 as any /* RuntimeCall */;

const call = api.tx[stringCamelCase("Scheduler")][stringCamelCase("schedule_named")](
  id,
  when,
  maybe_periodic,
  priority,
  call
);

Runtime Info

Pallet Index
15
Call Index
2
First Version
v133
Current Version
v393