Skip to content

Add Readme #4

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 7 commits into
base: main
Choose a base branch
from

Conversation

jschneider-bensch
Copy link

This PR provides a README.md for mlkem-rust-libcrux.

It tries to follow the proposed structure from pq-code-package/tsc#151

  • [ ] Does this PR change the input/output behaviour of a cryptographic algorithm (i.e., does it change known answer test values)? (If so, a version bump will be required from x.y.z to x.(y+1).0.)

Signed-off-by: Jonas Schneider-Bensch <[email protected]>
Signed-off-by: Jonas Schneider-Bensch <[email protected]>
Signed-off-by: Jonas Schneider-Bensch <[email protected]>
Signed-off-by: Jonas Schneider-Bensch <[email protected]>
Signed-off-by: Jonas Schneider-Bensch <[email protected]>
Signed-off-by: Jonas Schneider-Bensch <[email protected]>
Signed-off-by: Jonas Schneider-Bensch <[email protected]>
@jschneider-bensch jschneider-bensch marked this pull request as ready for review June 30, 2025 11:50
@jschneider-bensch jschneider-bensch requested a review from a team as a code owner June 30, 2025 11:50
@franziskuskiefer franziskuskiefer self-requested a review June 30, 2025 12:01
Copy link
Contributor

@franziskuskiefer franziskuskiefer left a comment

Choose a reason for hiding this comment

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

Thanks, lgtm with a few nits.

in your project directory, or add

```
libcrux-ml-kem = "0.0.2"
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
libcrux-ml-kem = "0.0.2"
libcrux-ml-kem = "0.0.3"

APIs follow the general structure of the ML-KEM APIs.
- `check-secret-independence`: All operations on ring elements in the
portable implementation use the integer types of the
`libcrux-secrets` crate under the hood. That crate allows checking a
Copy link
Contributor

Choose a reason for hiding this comment

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

Shall we link the secrets crate here?

Suggested change
`libcrux-secrets` crate under the hood. That crate allows checking a
[`libcrux-secrets`](https://crates.io/crates/libcrux-secrets) crate under the hood. That crate allows checking a

- `check-secret-independence`: All operations on ring elements in the
portable implementation use the integer types of the
`libcrux-secrets` crate under the hood. That crate allows checking a
program operating on these types for secret indepence at compile
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
program operating on these types for secret indepence at compile
program operating on these types for secret independence at compile

Comment on lines +117 to +118
values are not used in operations that are known to be
non-constant time. While the implementation of constant time
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
values are not used in operations that are known to be
non-constant time. While the implementation of constant time
values are not used in operations that are known to have
data-dependent execution time. While the implementation of constant time

Comment on lines +146 to +147
## FAQ
TBD
Copy link
Contributor

Choose a reason for hiding this comment

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

I can't really think of anything here right now. Let's just drop it for now and add it when we have content.

Suggested change
## FAQ
TBD

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