 Michal Kucharczyk
|
f910a15c1c
|
GenesisConfig presets for runtime (#2714)
The runtime now can provide a number of predefined presets of
`RuntimeGenesisConfig` struct. This presets are intended to be used in
different deployments, e.g.: `local`, `staging`, etc, and should be
included into the corresponding chain-specs.
Having `GenesisConfig` presets in runtime allows to fully decouple node
from runtime types (the problem is described in #1984).
**Summary of changes:**
- The `GenesisBuilder` API was adjusted to enable this functionality
(and provide better naming - #150):
```rust
fn preset_names() -> Vec<PresetId>;
fn get_preset(id: Option<PresetId>) -> Option<serde_json::Value>;
//`None` means default
fn build_state(value: serde_json::Value);
pub struct PresetId(Vec<u8>);
```
- **Breaking change**: Old `create_default_config` method was removed,
`build_config` was renamed to `build_state`. As a consequence a node
won't be able to interact with genesis config for older runtimes. The
cleanup was made for sake of API simplicity. Also IMO maintaining
compatibility with old API is not so crucial.
- Reference implementation was provided for `substrate-test-runtime` and
`rococo` runtimes. For rococo new
[`genesis_configs_presets`](https://github.com/paritytech/polkadot-sdk/blob/3b41d66b97c5ff0ec4a1989da5ffd8b9f3f588e3/polkadot/runtime/rococo/src/genesis_config_presets.rs#L530)
module was added and is used in `GenesisBuilder`
[_presets-related_](https://github.com/paritytech/polkadot-sdk/blob/3b41d66b97c5ff0ec4a1989da5ffd8b9f3f588e3/polkadot/runtime/rococo/src/lib.rs#L2462-L2485)
methods.
- The `chain-spec-builder` util was also improved and allows to
([_doc_](https://github.com/paritytech/polkadot-sdk/blob/3b41d66b97c5ff0ec4a1989da5ffd8b9f3f588e3/substrate/bin/utils/chain-spec-builder/src/lib.rs#L19)):
- list presets provided by given runtime (`list-presets`),
- display preset or default config provided by the runtime
(`display-preset`),
- build chain-spec using named preset (`create ... named-preset`),
- The `ChainSpecBuilder` is extended with
[`with_genesis_config_preset_name`](https://github.com/paritytech/polkadot-sdk/blob/3b41d66b97c5ff0ec4a1989da5ffd8b9f3f588e3/substrate/client/chain-spec/src/chain_spec.rs#L447)
method which allows to build chain-spec using named preset provided by
the runtime. Sample usage on the node side
[here](https://github.com/paritytech/polkadot-sdk/blob/2caffaae803e08a3d5b46c860e8016da023ff4ce/polkadot/node/service/src/chain_spec.rs#L404).
Implementation of #1984.
fixes: #150
part of: #25
---------
Co-authored-by: Sebastian Kunert <skunert49@gmail.com>
Co-authored-by: Kian Paimani <5588131+kianenigma@users.noreply.github.com>
Co-authored-by: Oliver Tale-Yazdi <oliver.tale-yazdi@parity.io>
|
2024-04-04 18:30:54 +00:00 |
|
|
Michal Kucharczyk
|
53cbda1de6
|
test-runtime: GenesisBuilder runtime API impl + tests (#14310)
* test-runtime: GenesisBuilder runtime API impl + tests
This PR provides implementation of `GenesisBuilder` API for `substrate-test-runtime`, can be considered as reference imiplementation for other runtimes.
The `GenesisBuilder` implementation is gated by `gensis-config` feature.
Tested scenarios:
- default `GenesisConfig` to JSON blob,
- deserialization of `GenesisConfig` from custom JSON, and storing its keys into the Storage (genesis storage creation).
- creation of genesis storage using partial JSON definition,
- checking if invalid/renamed JSON files causes the runtime to panic,
* missing file added
* client: GenesisBuilder helper added
* feature renamed: genesis-config -> genesis-builder
* Update Cargo.toml
* Update Cargo.toml
* Update Cargo.toml
* Update Cargo.toml
* redundant function removed
* genesis builder helper: introduced RuntimeGenesisBuild
* test-runtime: get rid of unused T
* redundant bound removed
* helper: use GenesisBuild again
* tests adjusted for on_genesis
* test-runtime: support for BuildGenesisConfig
* helper: BuildGenesisConfig support
* Update client/genesis-builder/src/lib.rs
Co-authored-by: Davide Galassi <davxy@datawok.net>
* Update test-utils/runtime/src/test_json/readme.md
Co-authored-by: Davide Galassi <davxy@datawok.net>
* Update test-utils/runtime/src/test_json/readme.md
Co-authored-by: Davide Galassi <davxy@datawok.net>
* Update test-utils/runtime/src/genesismap.rs
Co-authored-by: Davide Galassi <davxy@datawok.net>
* jsons are now human-friendly
* fix
* improvements
* jsons fixed
* helper: no_defaults added
* test-runtime: no_defaults added
* test-runtime: patching fn removed
* helper: patching fn removed
* helper: moved to frame_support
* test-runtime: fixes
* Cargo.lock updated
* fmt + naming
* test-runtime: WasmExecutor used
* helper / test-runtime: struct removed
* test-runtime: merge fixes
* Cargo.lock + test-utils/runtime/Cargo.toml updated
* doc fixed
* client/rpc: test fixed (new rt api)
* client/rpc-spec-v2: test fix
* doc fix
* test-runtime: disable-genesis-builder feature
* fix
* fix
* ".git/.scripts/commands/fmt/fmt.sh"
* test-runtime: rerun added to build script
---------
Co-authored-by: Davide Galassi <davxy@datawok.net>
Co-authored-by: parity-processbot <>
|
2023-07-24 16:12:52 +00:00 |
|