Stylus Test Helpers

Testing in Stylus is limited today. While developing OpenZeppelin Contracts for Stylus we created a few helpers to test our contracts, and we've decided to open source them and publish them as a separate crate for the community, at least until a more comprehensive testing framework is available.

This crate is a work in progress, and we'll be adding more features and improving the ergonomics as we go. We encourage projects that find this useful to contribute by opening issues and pull requests.

Motsu (持つ) - Unit Testing for Stylus

This crate enables unit-testing for Stylus contracts. It abstracts away the machinery necessary for writing tests behind a #[motsu::test] procedural macro.

motsu means "[to hold]" in Japanese -- we hold a stylus in our hand.

Usage

Add motsu to your project's dependencies:

[dev-dependencies]
motsu = "0.7.0"

[dependencies]
stylus-sdk = { version = "=0.8.3", default-features = false, features = [
  "mini-alloc",
] }

Important: When using motsu, the stylus-sdk must be configured without the default hostio-caching feature to prevent conflicts. E.g., you can use stylus-sdk with mini-alloc feature without including defaults as shown above.

Contribute

If you're interested in contributing, please check our contribution guidelines.

Security

Refer to our Security Policy for more details.