3 releases
0.1.4 | Dec 13, 2023 |
---|---|
0.1.1 | Jul 10, 2023 |
0.1.0 | Oct 9, 2022 |
#25 in #upgrade
2.5MB
40K
SLoC
Uptest
Substrate rUntime uPgrade TESTing library
Funded by:
Documentation:
https://uptest-sc.github.io/
https://docs.rs/libuptest/0.1.2/libuptest/
Latest release:
0.1.2
Uptest
Uptest aims to be an easy stand alone library for testing runtime upgrades before they are deployed.
Use libuptest to execute extrensic test before and after the upgrade is pushed
substrate runtime UPgrade TESTing suit
With uptest you can:
- Easily query changes mades to types, storagemaps etc..
- Quickly get started with writing extrinsic tests with libuptest, let the library handle the execution logic before and after the runtime upgrade takes place
- More lightweight standalone version, rust code is not reliant on the main substrate repo
- Utilize a standalone rust library to build out your integration tests
- Filter output based on pallet, to get a detailed change log
- Schedule tests to execute before and/or after a runtime upgrade takes place, developers does not need to spend any extra time, tracking the state and execution flow of the runtime upgrade with polkadot.js typescript
- no kitchensink-runtime needed
See future usage_future.md for more details
Got a feature you want us to add on the roadmap?
To be avaliable with cargo in the near future:
https://crates.io/crates/uptest
Check out future planned features here:
https://github.com/users/uptest-sc/projects/1/views/1
Examples
Run examples:
$ sh run_examples.sh
Compile examples:
$ cargo build --release --examples -p uptest-examples
Get metadata version:
use libuptest::jsonrpseeclient::JsonrpseeClient;
use libuptest::ws_mod::get_metadata_version;
println!("Connecting to Edgeware");
let dial_edg: JsonrpseeClient = JsonrpseeClient::edgeware_default_url().unwrap();//.unwrap();//.unwrap();
let edg_version: u8 = get_metadata_version(dial_edg).await?;
println!("Connected to chain: {:?} and got metadata version: {:?}", "Edgeware", edg_version);
cargo run -p uptest-examples --example metadata_version
Get all pallet's storagevalues and storage maps:
cargo run -p uptest-examples --example get_pallet_storagemaps_storagevalues
Default connection endpoints:
The rpcclient comes with 5 different "default" chain endpoints:
- with_default_url -> ws://127.0.0.1:9944
- edgeware_default_url -> wss://edgeware.jelliedowl.net:443
- polkadot_default_url -> wss://polkadot-rpc-tn.dwellir.com:443
- kusama_default_url -> wss://kusama-rpc-tn.dwellir.com:443
- sora_default_url -> wss://ws.mof.sora.org:443
Examples and Documentation:
Runtime Migrations links:
https://github.com/apopiak/substrate-migrations
https://substrate-developer-hub.github.io/docs/en/knowledgebase/runtime/upgrades
https://docs.substrate.io/reference/how-to-guides/parachains/runtime-upgrade/
https://github.com/paritytech/substrate/issues?q=label%3AE1-runtimemigration%20
https://wiki.polkadot.network/docs/learn-runtime-upgrades
Dependencies
~28–40MB
~730K SLoC