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 combined 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 a json representation of the default RuntimeGenesisConfig provided by the runtime.

Calls GenesisBuilder::create_default_config in the runtime.

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

Builds RuntimeGenesisConfig from given json blob 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 RuntimeGenesisConfig.

This function generates the RuntimeGenesisConfig for the runtime by applying a provided JSON patch. The patch modifies the default RuntimeGenesisConfig allowing customization of the specific keys. The resulting RuntimeGenesisConfig 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 RuntimeGenesisConfig 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 RuntimeGenesisConfig.
3. Keys in the default configuration that have null values in the patch will be removed from the resulting RuntimeGenesisConfig. This is helpful for changing enum variant value.

Please note that the patch may contain full RuntimeGenesisConfig.

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.