27 releases (11 breaking)

0.12.0 Jan 9, 2025
0.10.0 Nov 7, 2024
0.8.0 Jul 15, 2024
0.6.1 Mar 12, 2024
0.1.20 Feb 1, 2022

#3 in #python-wheel

Download history 1198/week @ 2024-12-01 2735/week @ 2024-12-08 1703/week @ 2024-12-15 697/week @ 2024-12-22 3203/week @ 2024-12-29 6482/week @ 2025-01-05 4726/week @ 2025-01-12 5591/week @ 2025-01-19 5196/week @ 2025-01-26 5176/week @ 2025-02-02 4567/week @ 2025-02-09 4625/week @ 2025-02-16 6272/week @ 2025-02-23 5648/week @ 2025-03-02 4631/week @ 2025-03-09 4358/week @ 2025-03-16

21,415 downloads per month
Used in 32 crates (27 directly)

Apache-2.0

1MB
8K SLoC

Rust implementation of clvm.

The cargo workspace includes an rlib crate, for use with rust or other applications, and a python wheel.

The python wheel is in wheel. The npm package is in wasm.

Tests

In order to run the unit tests, run:

cargo test

Fuzzing

The fuzzing infrastructure for clvm_rs uses cargo-fuzz.

Documentation for setting up fuzzing in rust can be found here.

To generate an initial corpus (for the run_program fuzzer), run:

cd tools
cargo run generate-fuzz-corpus

To get started, run:

cargo fuzz run fuzz_run_program --jobs=32 -- -rss_limit_mb=4096

But with whatever number of jobs works best for you.

If you find issues in clvm_rs please use our bug bounty program.

Build Wheel

The clvm_rs wheel has python bindings for the rust implementation of clvm.

Use maturin to build the python interface. First, install into current virtualenv with

$ pip install maturin

While in the wheel directory, build clvm_rs into the current virtualenv with

$ maturin develop --release

On UNIX-based platforms, you may get a speed boost on sha256 operations by building with OpenSSL.

$ maturin develop --release --features=openssl

To build the wheel, do

$ maturin build --release

or

$ maturin build --release --features=openssl

Dependencies

~12MB
~306K SLoC