https://github.com/uptest-sc/uptest

"curl" for substrate runtime upgrade testing
https://github.com/uptest-sc/uptest

Last synced: about 1 month 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 (about 2 years ago)
• Default Branch: main
• Last Pushed: 2023-12-13T01:11:33.000Z (almost 1 year ago)
• Last Synced: 2024-03-25T13:06:40.359Z (9 months ago)
• Language: Rust
• Homepage:
• Size: 382 KB
• Stars: 7
• Watchers: 2
• Forks: 4
• Open Issues: 18
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

• 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)
• 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

[![Crates.io LibUptest](https://img.shields.io/crates/v/libuptest.svg)](https://crates.io/crates/libuptest)

[![Docs.rs Libuptest](https://img.shields.io/docsrs/libuptest/0.1.4)](https://docs.rs/libuptest)

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)   

Funded by:  

![Polkadot Treasury](polkadot-treasury-logo.svg)

### 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