sentri-dynamic-core 0.4.1

Sentri: chain-agnostic dynamic/coverage-guided invariant fuzzing engine (execution backend, call-sequence generation, shrinking, invariant oracles).
Documentation
  • Coverage
  • 100%
    44 out of 44 items documented0 out of 44 items with examples
  • Size
  • Source code size: 89.1 kB This is the summed size of all the files inside the crates.io package for this release.
  • Documentation size: 888.7 kB This is the summed size of all files generated by rustdoc for all configured targets
  • Ø build duration
  • this release: 10s Average build duration of successful builds.
  • all releases: 10s Average build duration of successful builds in releases after 2024-10-23.
  • Links
  • Homepage
  • Emmyhack/Truent
    4 3 14
  • crates.io
  • Dependencies
  • Versions
  • Owners
  • geekstrancend

sentri-dynamic-core

Chain-agnostic dynamic/coverage-guided invariant fuzzing engine.

This crate contains no VM. It only knows how to:

  • generate random call sequences against a described function surface (FunctionSpec), biased toward edge values (0, 1, u256::MAX, …) the way property fuzzers like Foundry/Echidna do,
  • drive an ExecutionBackend (deploy/call/snapshot/revert — implemented once per chain),
  • check Invariants after every call (MonotonicInvariant, ConservationInvariant),
  • and shrink a failing sequence to a minimal reproduction via delta-debugging.

Chain-specific execution lives in its own crate — see sentri-dynamic-evm for the revm-backed implementation for real Solidity bytecode. This crate's own test suite proves the engine logic (generation, execution, shrinking, invariant checking) correct against an in-memory mock, so it never depends on a real VM to be verified.

Adding a new invariant

Implement Invariant (name, check, optionally reset for anything that remembers state across calls) — see MonotonicInvariant for a stateful example and ConservationInvariant for a stateless one.

Adding a new chain backend

Implement ExecutionBackend (call, snapshot, revert_to) against that chain's execution environment. sentri-dynamic-evm's RevmBackend is the reference implementation.