Add fuzz tests

Added fuzzing tests:
- As unit tests using `QuickCheck`
- As `cargo fuzz` tests

Both sets of tests use the same set fuzzing functions, running `cargo fuzz` is just
a lot more intense.

Author: hansieodendaal

Cargo.toml

@@ -22,3 +22,4 @@ thiserror = "1.0.30"
 
 [dev-dependencies]
 hex = "0.4.3"
+quickcheck = "1"

fuzz/.gitignore

@@ -0,0 +1,4 @@
+target
+corpus
+artifacts
+coverage

fuzz/Cargo.lock

@@ -0,0 +1,51 @@
+[package]
+name = "monero-fuzz"
+version = "0.0.0"
+edition = "2021"
+publish = false
+
+[package.metadata]
+cargo-fuzz = true
+
+[dependencies]
+libfuzzer-sys = "0.4"
+
+[dependencies.randomx-rs]
+path = ".."
+
+# Prevent this from interfering with workspaces
+[workspace]
+members = ["."]
+
+[profile.release]
+debug = 1
+
+[[bin]]
+name = "randomx_alloc_cache"
+path = "fuzz_targets/randomx_alloc_cache.rs"
+test = false
+doc = false
+
+[[bin]]
+name = "randomx_create_vm_with_cache_only"
+path = "fuzz_targets/randomx_create_vm_with_cache_only.rs"
+test = false
+doc = false
+
+[[bin]]
+name = "randomx_create_vm_with_cache_and_dataset"
+path = "fuzz_targets/randomx_create_vm_with_cache_and_dataset.rs"
+test = false
+doc = false
+
+[[bin]]
+name = "randomx_vm_calculate_hash_with_cache_only"
+path = "fuzz_targets/randomx_vm_calculate_hash_with_cache_only.rs"
+test = false
+doc = false
+
+[[bin]]
+name = "randomx_vm_calculate_hash_with_cache_and_dataset"
+path = "fuzz_targets/randomx_vm_calculate_hash_with_cache_and_dataset.rs"
+test = false
+doc = false

fuzz/Cargo.toml

@@ -0,0 +1,22 @@
+# Fuzzing randomx-rs
+
+See https://rust-fuzz.github.io/book/cargo-fuzz.html for more information on fuzzing with cargo-fuzz.
+Install `cargo-fuzz` as per [installation instructions](https://rust-fuzz.github.io/book/cargo-fuzz/setup.html).
+
+
+**Note:** Fuzzing is not supported on Windows yet.
+
+To get a list of fuzz targets, from a terminal in the project root, run
+```
+cargo fuzz list
+```
+
+To run a fuzz test, from a terminal in the project root, run
+```
+cargo +nightly fuzz run --release <fuzz_target_name>
+```
+To run fuzz tests involving a cache and dataset, on error `libFuzzer: out-of-memory (malloc(2181038016))`, pass 
+`-- -rss_limit_mb=<ram_upper_limit>` as argument to allow using more than 2 GB of RAM - 3GB recommended.
+```
+cargo +nightly fuzz run --release <fuzz_target_name> -- -rss_limit_mb=3221225472
+```

fuzz/README.md

@@ -0,0 +1,8 @@
+#![no_main]
+
+use libfuzzer_sys::fuzz_target;
+use randomx_rs::test_utils::fuzz_randomx_alloc_cache;
+
+fuzz_target!(|data: &[u8]| {
+    fuzz_randomx_alloc_cache(data.to_vec());
+});

fuzz/fuzz_targets/randomx_alloc_cache.rs

@@ -0,0 +1,8 @@
+#![no_main]
+
+use libfuzzer_sys::fuzz_target;
+use randomx_rs::test_utils::fuzz_randomx_create_vm_with_cache_and_dataset;
+
+fuzz_target!(|data: &[u8]| {
+    fuzz_randomx_create_vm_with_cache_and_dataset(data.to_vec());
+});

fuzz/fuzz_targets/randomx_create_vm_with_cache_and_dataset.rs

@@ -0,0 +1,8 @@
+#![no_main]
+
+use libfuzzer_sys::fuzz_target;
+use randomx_rs::test_utils::fuzz_randomx_create_vm_with_cache_only;
+
+fuzz_target!(|data: &[u8]| {
+    fuzz_randomx_create_vm_with_cache_only(data.to_vec());
+});

fuzz/fuzz_targets/randomx_create_vm_with_cache_only.rs

@@ -0,0 +1,8 @@
+#![no_main]
+
+use libfuzzer_sys::fuzz_target;
+use randomx_rs::test_utils::fuzz_randomx_vm_calculate_hash_with_cache_and_dataset;
+
+fuzz_target!(|data: &[u8]| {
+    fuzz_randomx_vm_calculate_hash_with_cache_and_dataset(data.to_vec());
+});

fuzz/fuzz_targets/randomx_vm_calculate_hash_with_cache_and_dataset.rs

@@ -0,0 +1,8 @@
+#![no_main]
+
+use libfuzzer_sys::fuzz_target;
+use randomx_rs::test_utils::fuzz_randomx_vm_calculate_hash_with_cache_only;
+
+fuzz_target!(|data: &[u8]| {
+    fuzz_randomx_vm_calculate_hash_with_cache_only(data.to_vec());
+});