request_preimage

Call v133 → current #2

Requests a preimage for use.

View calls on chain

Click items to navigate. Pan and zoom to explore.

Used by: validatorsdevelopers

The Big Picture

Signals governance mechanism needs this.

Use Cases

  • Mark preimage as in-use

From Chain Metadata

Request a preimage be uploaded to the chain without paying any fees or deposits. If the preimage requests has already been provided on-chain, we unreserve any deposit a user may have paid, and take the control of the preimage out of their hands.

Input Parameters

#NameTypeDescription
0
hash
H256 T::Hashhash: Cryptographic hash (32 bytes)

Permissions

Origin
Unknown
Required Role

Permission data inferred from metadata. May be incomplete.

Requirements

  • Hash provided

Effects

Events Emitted

Storage Modified

Postconditions

  • Preimage marked as requested

Side Effects

  • Emits Requested

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 request_preimage call (typed, named args)
const hash = "0x0000000000000000000000000000000000000000000000000000000000000000";

const tx = api.tx.Preimage.request_preimage({
  hash,
});

Runtime Info

Pallet Index
14
Call Index
2
First Version
v133
Current Version
v411