Expand description
The Forge test runner.
Structsยง
- Contract
Runner - A type that executes all tests of a contract
- Contract
Runner ๐Context - Function
Runner ๐ - Executes a single test function, returning a
TestResult. - Fuzz
Branch ๐Frontier Artifact - Fuzz
Branch ๐Frontier Operands - Fuzz
Branch ๐Frontier Record - Fuzz
Branch ๐Frontier Site - Imported
Fuzz ๐Frontier - Imported
Symbolic ๐Corpus Seeds - Invariant
Campaign ๐Scope - Invariant
Campaign ๐Selection - Invariant
Persisted ๐Failure - Holds data about a persisted invariant failure.
- Replay
Context ๐ - Borrowed context shared by primary-invariant and handler-side replay helpers.
- Replayed
Invariant ๐Sequence - Symbolic
Handler ๐Replay Storage - Symbolic
Sequence ๐Failure
Enumsยง
Constantsยง
Functionsยง
- apply_
symbolic_ ๐storage_ assignments - attach_
imported_ ๐symbolic_ corpus_ seeds - base_
counterexample_ ๐to_ tx - base_
counterexamples_ ๐to_ txes - Converts a persisted counterexample to
BasicTxDetails, settingshow_solidityin place. - count_
runnable_ ๐invariant_ campaign_ anchors - frontier_
filter_ ๐display - frontier_
selector ๐ - function_
matches_ ๐network_ pass - fuzzer_
with_ ๐cases - inline_
config_ ๐for - invariant_
contract_ ๐name - Returns the invariant test contract name without the file path prefix.
- invariant_
failure_ ๐dir - Returns the contract-level invariant failure directory.
- invariant_
failure_ ๐file - Returns the current invariant failure cache path.
- invariant_
handler_ ๐failure_ name - invariant_
suite_ ๐configs_ match - invariant_
suite_ ๐paths - Sets the invariant corpus directory and returns the contract-level failure directory.
- is_
symbolic_ ๐frontier_ opcode - narrow_
generated_ ๐corpus_ root - narrow_
generated_ ๐fuzz_ corpus_ root - narrow_
generated_ ๐invariant_ corpus_ root - parse_
frontier_ ๐selector - parse_
frontier_ ๐selectors - persisted_
call_ ๐sequence - Helper function to load failed call sequence from file. Ignores failure if generated with different invariant settings than the current ones.
- persisted_
invariant_ ๐failure - Loads a persisted invariant failure from the new cache path, falling back to the legacy path.
- record_
handler_ ๐failure_ with_ storage - Persists a handler-side assertion bug with symbolic replay storage.
- record_
invariant_ ๐failure - Helper function to persist invariant failure.
- record_
invariant_ ๐failure_ with_ storage - Helper function to persist invariant failure with symbolic replay storage.
- replay_
persisted_ ๐call_ sequence - Converts a persisted
BaseCounterExamplesequence intoBasicTxDetails(applyingctx.show_solidityin place) and replays it viacheck_sequence. - replay_
persisted_ ๐handler_ failures - Replays persisted handler-side assertion bugs. A file is kept only if the anchor still
asserts at the same
(reverter, selector)site; stale files (anchor no longer asserts, asserts at a different site, or earlier call asserts) are deleted in place. - sanitize_
symbolic_ ๐artifact_ component - select_
invariant_ ๐campaigns - should_
symbolically_ ๐import_ fuzz_ corpus - should_
symbolically_ ๐seed_ fuzz_ corpus - should_
symbolically_ ๐use_ fuzz_ frontiers - symbolic_
artifact_ ๐file_ name - symbolic_
artifact_ ๐handler_ failure_ matches - symbolic_
artifact_ ๐predicate_ failure_ matches - symbolic_
invariant_ ๐counterexample_ calls - symbolic_
invariant_ ๐failure_ site - symbolic_
invariant_ ๐failure_ site_ matches - symbolic_
invariant_ ๐unsupported_ domain_ reason - test_
paths ๐ - Helper function to set test corpus dir and to compose persisted failure paths.
- validate_
single_ ๐call_ symbolic_ replay
Type Aliasesยง
- Handler
Failure ๐Key - Handler
Failure ๐Map - Handler
Failure ๐Storage Key - Symbolic
Handler ๐Storage Map