Struct sc_chain_spec::GenesisConfigBuilderRuntimeCaller

pub struct GenesisConfigBuilderRuntimeCaller<'a, EHF = ()>
where
    EHF: HostFunctions,
{ /* private fields */ }

A utility that facilitates calling the GenesisBuilder API from the runtime wasm code blob.

EHF type allows to specify the extended host function required for building runtime’s genesis config. The type will be compbined with default sp_io::SubstrateHostFunctions.

Implementations

impl<'a, EHF> GenesisConfigBuilderRuntimeCaller<'a, EHF>

where EHF: HostFunctions,

pub fn new(code: &'a [u8]) -> Self

Creates new instance using the provided code blob.

This code is later referred to as runtime.

pub fn get_default_config(&self) -> Result<Value, String>

Returns the default GenesisConfig provided by the runtime.

Calls GenesisBuilder::create_default_config in the runtime.

pub fn get_storage_for_config(&self, config: Value) -> Result<Storage, String>

Build the given GenesisConfig and returns the genesis state.

Calls GenesisBuilder::build_config provided by the runtime.

pub fn get_storage_for_patch(&self, patch: Value) -> Result<Storage, String>

Creates the genesis state by patching the default GenesisConfig and applying it.

This function generates the GenesisConfig for the runtime by applying a provided JSON patch. The patch modifies the default GenesisConfig allowing customization of the specific keys. The resulting GenesisConfig is then deserialized from the patched JSON representation and stored in the storage.

If the provided JSON patch is incorrect or the deserialization fails the error will be returned.

The patching process modifies the default GenesisConfig according to the following rules:

1. Existing keys in the default configuration will be overridden by the corresponding values in the patch.
2. If a key exists in the patch but not in the default configuration, it will be added to the resulting GenesisConfig.
3. Keys in the default configuration that have null values in the patch will be removed from the resulting GenesisConfig. This is helpful for changing enum variant value.

Please note that the patch may contain full GenesisConfig.

Trait Implementations

impl<'a, EHF> FetchRuntimeCode for GenesisConfigBuilderRuntimeCaller<'a, EHF>

where EHF: HostFunctions,

fn fetch_runtime_code(&self) -> Option<Cow<'_, [u8]>>

Fetch the runtime :code.