Skip to content

Update README with Kani proofs #356

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: main
Choose a base branch
from

Conversation

MatiasVara
Copy link
Contributor

@MatiasVara MatiasVara commented Jul 29, 2025

Summary of the PR

Update README with existing Kani proofs. This PR is regarding the addition of the first proof at #338. I am not sure if the README shall mention the existing PRs because that will force people to keep it update. At the same time, it may be useful for users to know which requirements from the specification are proved to be conform to.

Requirements

Before submitting your PR, please make sure you addressed the following
requirements:

  • All commits in this PR have Signed-Off-By trailers (with
    git commit -s), and the commit message has max 60 characters for the
    summary and max 75 characters for each description line.
  • All added/changed functionality has a corresponding unit/integration
    test.
  • All added/changed public-facing functionality has entries in the "Upcoming
    Release" section of CHANGELOG.md (if no such section exists, please create one).
  • Any newly added unsafe code is properly documented.

Update README with existing Kani proofs.

Signed-off-by: Matias Ezequiel Vara Larsen <[email protected]>
@epilys epilys force-pushed the update_readme_with_kani branch from 443f5a9 to 6f4a290 Compare July 29, 2025 10:00
Copy link
Member

@stefano-garzarella stefano-garzarella left a comment

Choose a reason for hiding this comment

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

Thanks for that!

Please add Closes: #353

Comment on lines +115 to +117
conformance proofs:

* Conformance to 2.7.7.2 section
Copy link
Member

Choose a reason for hiding this comment

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

I'm not sure it's a good idea to keep a list of proofs, just because I'm pretty sure we will forget to update xD.

Copy link
Member

Choose a reason for hiding this comment

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

Also it's not immediately obvious what "2.7.7.2 section" refers to- even with a link to the specification it is still incomplete information. I suggest adding a link to the Rust module maybe?

conformance proofs:

* Conformance to 2.7.7.2 section

Copy link
Member

Choose a reason for hiding this comment

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

What about adding instructions on how to run it locally?

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.

3 participants