test-tube is a generic library for building testing environments for CosmWasm smart contracts. It allows you to test your smart contract logic against the actual Cosmos SDK chain's logic, which is written in Go, using Rust. This eliminates the need to write Go code or learn Go in order to test your smart contracts against the Cosmos SDK.
This repo contains [neutron-test-tube] which uses a delta of osmosis-test-tube to enable testing against neutron.
Additionally, this repo contains test-tube-ntrn the flavour of test-tube compatible with Neutron core chain.
- Test your CosmWasm smart contracts using Rust without the need to write Go code or learn Go
- Test against the actual Cosmos SDK chain's logic
- Build testing environments for any Cosmos SDK-based chain
Please checkout the documentation in the neutron-test-tube package:
You might want to just use cw-multi-test if your contract does not interact with chain's custom module.
cw-multi-test is faster since it does not need to run the chain code or build and upload .wasm file, but it does not test your contract against the actual chain's logic and rely on simulation which only some basic modules are implemented.
So if your contract just interact with common modules like Bank, Staking, and Distribution, cw-multi-test is enough. But if it's interacting with custom modules, you should use test-tube.
We welcome contributions to neutron-test-tube! If you find a bug or have an idea for a new feature, please open an issue or submit a pull request.
The crates in this repository are licensed under either of the following licenses, at your discretion.
Apache License Version 2.0 (LICENSE-APACHE or apache.org license link)
MIT license (LICENSE-MIT or opensource.org license link)
Unless you explicitly state otherwise, any contribution submitted for inclusion in this library by you shall be dual licensed as above (as defined in the Apache v2 License), without any additional terms or conditions.