https://github.com/polytope-labs/sc-simnode

Fork your substrate live chain state and run all kinds of simulation tests on the runtime.
https://github.com/polytope-labs/sc-simnode

blockchain parachain parachains polkadot runtime rust substrate testing wasm

Last synced: 17 days ago
JSON representation

Fork your substrate live chain state and run all kinds of simulation tests on the runtime.

• Host: GitHub
• URL: https://github.com/polytope-labs/sc-simnode
• Owner: polytope-labs
• License: apache-2.0
• Created: 2021-12-17T01:24:41.000Z (about 3 years ago)
• Default Branch: master
• Last Pushed: 2023-08-19T05:39:37.000Z (over 1 year ago)
• Last Synced: 2024-04-16T06:46:44.160Z (9 months ago)
• Topics: blockchain, parachain, parachains, polkadot, runtime, rust, substrate, testing, wasm
• Language: Rust
• Homepage:
• Size: 2.56 MB
• Stars: 45
• Watchers: 3
• Forks: 10
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-dot - Simnode - Simulation Testing Framework for Parachains and Standalone Substrate Based (Libraries / Multisig Wallets)

README

        
# sc-simnode ![Unit Tests](https://github.com/polytope-labs/sc-simnode/actions/workflows/ci.yml/badge.svg) [![Telegram: YourGroup](https://img.shields.io/badge/-Telegram-blue?style=flat-square&logo=Telegram&logoColor=white&link=https://t.me/YourGroup)](https://t.me/sc_simnode) [![Discord: YourServer](https://img.shields.io/badge/-Discord-7289DA?style=flat-square&logo=Discord&logoColor=white&link=https://discord.gg/YourServer)](https://discord.gg/2vbPnFwg8h) ![Crates.io Version](https://img.shields.io/crates/v/sc-simnode)

![alt text](./assets/neo.webp)

> I'm trying to free your mind, Neo. But I can only show you the door. You're the one that has to walk through it.




This library exists to allow substrate developers to:

 - [x] Test complex pallets that require a full runtime, not a mocked runtime.

 - [x] Test a combination of both onchain & offchain components (eg offchain workers)

 - [x] Fork your live chain state and execute transactions from any origin.

 - [x] Simulate runtime upgrades & migrations.

## Documentation

Installation and integration guides can be found in the [book](https://simnode.polytope.technology). Example integrations are provided for runtimes of all different kinds:

- [x] [Standalone Chain](/examples/aura), AURA leader election, GRANDPA consensus.

- [X] [Standalone Chain](/examples/babe), BABE leader election, GRANDPA consensus.

- [X] [Parachain](/examples/parachain), AURA leader election, Polkadot Consensus.

## Releases

`sc-simnode` exclusively follows the official [paritytech/polkadot-sdk](https://github.com/paritytech/polkadot-sdk/releases) stable releases. Therefore new versions of this crate will be published as a new major release for the minor version of the corresponding polkadot-sdk stable release.

E.g [`polkadot-stable2409`](https://github.com/paritytech/polkadot-sdk/tree/polkadot-stable2409) corresponds to the [`polkadot-sdk-v1.160`](https://github.com/paritytech/polkadot-sdk/releases/tag/polkadot-v1.16.0) tag, which is supported by the `v16.0.0` version of this crate. Subsequent stable releases will see a major version bump in this crate.

## License

This library is licensed under the Apache 2.0 License, Copyright (c) 2023 Polytope Labs.