set_retry_named

Call v151 → current #7

Configure retry behavior for a named scheduled task.

View calls on chain

Click items to navigate. Pan and zoom to explore.

Used by: developersanalytics

The Big Picture

Ergonomic retry configuration for named tasks using task name instead of (block, index).

Use Cases

  • Add retry logic to named operations
  • Configure resilience by name

From Chain Metadata

Set a retry configuration for a named task so that, in case its scheduled run fails, it will be retried after `period` blocks, for a total amount of `retries` retries or until it succeeds. Tasks which need to be scheduled for a retry are still subject to weight metering and agenda space, same as a regular task. If a periodic task fails, it will be scheduled normally while the task is retrying. Tasks scheduled as a result of a retry for a periodic task are unnamed, non-periodic clones of the original task. Their retry configuration will be derived from the original task's configuration, but will have a lower value for `remaining` than the original `total_retries`.

Input Parameters

#NameTypeDescription
0
id
[u8; 32] [32] TaskNameid ([u8; 32])
1
retries
u8 retries (u8)
2
period
u32 BlockNumberFor<T>period: Block number

Permissions

Origin
Unknown
Required Role

Permission data inferred from metadata. May be incomplete.

Requirements

  • Named task exists in Lookup
  • Period at least 1 block

Effects

Events Emitted

Storage Modified

Postconditions

  • RetryConfig set for the task

Side Effects

  • Emits RetrySet event
  • Uses task name for lookup

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

// Build set_retry_named call (typed, named args)
const id = "0x0000000000000000000000000000000000000000000000000000000000000000";
const retries = 0;
const period = 0;

const tx = api.tx.Scheduler.set_retry_named({
  id,
  retries,
  period,
});

Runtime Info

Pallet Index
15
Call Index
7
First Version
v151
Current Version
v411