Imported from ahrav/Gossip-rs (.codex/skills/run-fuzz/SKILL.md). Install upstream with npx skills add ahrav/Gossip-rs --skill run-fuzz. Copyright stays with the author.

Run Fuzz Target

Run fuzz tests against gossip-rs data structures and contract types.

Usage

• /run-fuzz <target> - Run specific fuzz target (default 10,000 runs)
• /run-fuzz <target> <runs> - Run with custom iteration count
• /run-fuzz all - Run all targets briefly (1,000 runs each)
• /run-fuzz list - List available targets

Available Targets

Fuzz targets are distributed across crates:

gossip-contracts (crates/gossip-contracts/fuzz/)

gossip-stdx (crates/gossip-stdx/fuzz/)

Workflow

Run Single Target

cd crates/<crate> && cargo +nightly fuzz run <target> -- -runs=10000

Examples:

cd crates/gossip-stdx && cargo +nightly fuzz run fuzz_byte_slab -- -runs=10000
cd crates/gossip-contracts && cargo +nightly fuzz run fuzz_derivation_chain -- -runs=10000

Run All Targets

# gossip-contracts targets
cd crates/gossip-contracts
for target in fuzz_derivation_chain fuzz_item_identity_key; do
  echo "Running $target..."
  cargo +nightly fuzz run $target -- -runs=1000
done

# gossip-stdx targets
cd ../gossip-stdx
for target in fuzz_byte_slab fuzz_inline_vec fuzz_ring_buffer; do
  echo "Running $target..."
  cargo +nightly fuzz run $target -- -runs=1000
done

Check for Crashes

Crashes are saved to fuzz/artifacts/<target>/ within each crate. To reproduce:

cd crates/<crate>
cargo +nightly fuzz run <target> fuzz/artifacts/<target>/<crash-file>

Prerequisites

• Nightly Rust toolchain: rustup install nightly
• cargo-fuzz: cargo install cargo-fuzz