Skip to content

docs(test): document the scenario-based fuzz engine in rustdoc - #193

Merged
Arvolear merged 1 commit into
BlockstreamResearch:devfrom
schoen:docs/rustdoc-fuzz
Nov 5, 2026
Merged

Arvolear merged 1 commit into
BlockstreamResearch:devfrom
schoen:docs/rustdoc-fuzz

Conversation

@schoen

@schoen schoen commented Oct 29, 2026

Copy link
Copy Markdown
Contributor

Add a module overview of simplex::fuzz: how a Scenario describes the transaction and its programs, what the engine does with each case, and the findings a run can fail with.

Document Expect's variants, the engine's public fields and builder methods, what run panics on, how witness requirements are violated on purpose, and the undocumented getters of FuzzCase and FuzzProgram. Correct mutations(), which mutates half of the cases that don't violate a requirement, not half of all cases.

  • This PR suggests a bug fix and I've added the necessary tests.
  • This PR introduces a new feature and I've discussed the update in an Issue or with the team.
  • This PR is just a minor change like a typo fix.

@schoen
schoen requested a review from Arvolear as a code owner October 29, 2026 00:10
@Arvolear
Arvolear deleted the branch BlockstreamResearch:dev October 30, 2026 16:28
@Arvolear Arvolear closed this Oct 30, 2026
@Arvolear Arvolear reopened this Oct 30, 2026
Add a module overview of `simplex::fuzz`: how a `Scenario` describes
the transaction and its programs, what the engine does with each case,
and the findings a run can fail with.

Document `Expect`'s variants, the engine's public fields and builder
methods, what `run` panics on, how witness requirements are violated
on purpose, and the undocumented getters of `FuzzCase` and
`FuzzProgram`. Correct `mutations()`, which mutates half of the cases
that don't violate a requirement, not half of all cases.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@schoen
schoen force-pushed the docs/rustdoc-fuzz branch from f3ff9c5 to d1540fb Compare November 2, 2026 21:57

@Arvolear Arvolear left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM!

@Arvolear
Arvolear merged commit f64ab87 into BlockstreamResearch:dev Nov 5, 2026
9 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants