Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/uptest-sc/uptest
"curl" for substrate runtime upgrade testing
https://github.com/uptest-sc/uptest
Last synced: 3 months ago
JSON representation
"curl" for substrate runtime upgrade testing
- Host: GitHub
- URL: https://github.com/uptest-sc/uptest
- Owner: uptest-sc
- Created: 2022-10-09T13:31:57.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2023-12-13T01:11:33.000Z (7 months ago)
- Last Synced: 2024-03-25T13:06:40.359Z (3 months ago)
- Language: Rust
- Homepage:
- Size: 382 KB
- Stars: 7
- Watchers: 2
- Forks: 4
- Open Issues: 18
-
Metadata Files:
- Readme: README.md
Lists
- awesome-substrate - Uptest Runtime upgrade tool - Uptest command line client and libuptest Rust library are two tools used for debugging storage changes and runtime upgrades. (Tools)
README
# Uptest
Substrate r*U*ntime u*P*grade *TEST*ing library
[](https://crates.io/crates/libuptest)
[](https://docs.rs/libuptest)
[](https://opensource.org/licenses/MIT)
Funded by:
### Documentation:
[https://uptest-sc.github.io/](https://uptest-sc.github.io/)
[https://docs.rs/libuptest/0.1.2/libuptest/](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 *UP*grade *TEST*ing 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](usage_future.md) for more details
### Got a feature you want us to add on the roadmap?
[Submit a github issue](https://github.com/uptest-sc/uptest/issues/new)
### 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:
```shell
$ sh run_example.sh
```
#### Get metadata version:
```rust
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:
```shell
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:
[https://uptest-sc.github.io/](https://uptest-sc.github.io/)
## 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