Skip to content

Ascon examples#573

Merged
julek-wolfssl merged 16 commits into
wolfSSL:masterfrom
helkoulak:ascon-examples
Jun 18, 2026
Merged

Ascon examples#573
julek-wolfssl merged 16 commits into
wolfSSL:masterfrom
helkoulak:ascon-examples

Conversation

@helkoulak

Copy link
Copy Markdown
Contributor

Two examples that show how to use the algorithms Ascon-Hash256 and Ascon-AEAD128

Fix typos

No need to input key size as the size for ascon AEAD algorithm is fixed

Add an example for algorithm Ascon-Hash256

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Pull request overview

This PR adds two new usage examples for Ascon algorithms in the examples repository: one for hashing with Ascon-Hash256 and one for file encryption/decryption with Ascon-AEAD128, along with README/Makefile support so users can build and run them.

Changes:

  • Add hash/Ascon-Hash256.c and document how to run it in hash/README.md.
  • Add a new crypto/ascon/ example (ascon-file-encrypt.c) with a local Makefile and README.md.
  • Link the new Ascon crypto example docs from crypto/README.md.

Reviewed changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated 12 comments.

Show a summary per file
File Description
hash/README.md Documents running the new Ascon hashing example.
hash/Ascon-Hash256.c New Ascon-Hash256 file hashing example program.
crypto/ascon/ascon-file-encrypt.c New Ascon-AEAD128 file encrypt/decrypt example program.
crypto/ascon/README.md Build/run instructions for the Ascon file encryption example.
crypto/ascon/Makefile Builds the Ascon file encryption example.
crypto/README.md Adds a link to the new crypto/ascon documentation.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread crypto/ascon/ascon-file-encrypt.c Outdated
Comment thread crypto/ascon/ascon-file-encrypt.c Outdated
Comment thread crypto/ascon/ascon-file-encrypt.c Outdated
Comment thread crypto/ascon/ascon-file-encrypt.c Outdated
Comment thread crypto/ascon/ascon-file-encrypt.c Outdated
Comment thread crypto/ascon/Makefile Outdated
Comment thread hash/README.md Outdated
Comment thread hash/Ascon-Hash256.c
Comment thread hash/Ascon-Hash256.c Outdated
Comment thread hash/Ascon-Hash256.c Outdated
@helkoulak

Copy link
Copy Markdown
Contributor Author

I will fix those errors ASAP. Thanks.

@helkoulak helkoulak removed their assignment May 5, 2026
@dgarske

dgarske commented May 5, 2026

Copy link
Copy Markdown
Member

Hi @helkoulak thanks for this example. I don't see you setup as a contributor. Please email support at wolfssl dot com and reference this pull request. We will send you an agreement that we need signed. In the email please include your location and a bit more about your project and interest in Ascon and our project. Also if its commercial or open source or academic.

Thanks,
David Garske, wolfSSL

@helkoulak

Copy link
Copy Markdown
Contributor Author

Hi @helkoulak thanks for this example. I don't see you setup as a contributor. Please email support at wolfssl dot com and reference this pull request. We will send you an agreement that we need signed. In the email please include your location and a bit more about your project and interest in Ascon and our project. Also if its commercial or open source or academic.

Thanks, David Garske, wolfSSL

Thank you David for the instructions. I will contact support ASAP.

@dgarske

dgarske commented May 6, 2026

Copy link
Copy Markdown
Member

Contributor agreement on file. Thank you @helkoulak

@dgarske

dgarske commented May 7, 2026

Copy link
Copy Markdown
Member

@julek-wolfssl please review . Merge when you are happy with it.

@julek-wolfssl julek-wolfssl 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.

Please add crypto/ascon/ascon-file-encrypt to .gitignore. Everything looks nice but just needs more error handling.

Comment thread crypto/ascon/ascon-file-encrypt.c Outdated
Comment thread crypto/ascon/ascon-file-encrypt.c Outdated
Comment thread crypto/ascon/ascon-file-encrypt.c Outdated
Comment thread crypto/ascon/ascon-file-encrypt.c Outdated
Comment thread crypto/ascon/ascon-file-encrypt.c Outdated
Comment thread hash/Ascon-Hash256.c Outdated
Comment thread hash/Ascon-Hash256.c Outdated
Comment thread hash/Ascon-Hash256.c Outdated
@helkoulak helkoulak requested a review from julek-wolfssl May 29, 2026 22:07
Comment thread hash/Ascon-Hash256.c Outdated
Comment thread crypto/ascon/ascon-file-encrypt.c Outdated
Comment thread crypto/ascon/ascon-file-encrypt.c Outdated
Comment thread crypto/ascon/ascon-file-encrypt.c Outdated
Comment thread crypto/ascon/ascon-file-encrypt.c Outdated
Comment thread crypto/ascon/ascon-file-encrypt.c Outdated
Comment thread crypto/ascon/README.md Outdated
Comment thread crypto/ascon/ascon-file-encrypt.c Outdated
Comment thread hash/Ascon-Hash256.c Outdated
Comment thread hash/Ascon-Hash256.c Outdated
@dgarske dgarske requested a review from julek-wolfssl June 5, 2026 16:27
@dgarske dgarske assigned wolfSSL-Bot and julek-wolfssl and unassigned helkoulak Jun 5, 2026

@julek-wolfssl julek-wolfssl 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.

Not all comments addressed yet.

@helkoulak helkoulak requested a review from julek-wolfssl June 8, 2026 19:04
…p index, it should be defined as long as well for huge files
Comment thread crypto/ascon/ascon-file-encrypt.c Outdated
Comment thread crypto/ascon/ascon-file-encrypt.c Outdated
Comment thread crypto/ascon/ascon-file-encrypt.c Outdated
Comment thread crypto/ascon/ascon-file-encrypt.c Outdated
@helkoulak helkoulak requested a review from julek-wolfssl June 16, 2026 15:29
Comment thread crypto/ascon/ascon-file-encrypt.c
Comment thread crypto/ascon/ascon-file-encrypt.c Outdated
Comment thread crypto/ascon/ascon-file-encrypt.c Outdated
Comment thread hash/Ascon-Hash256.c Outdated
Comment thread hash/Ascon-Hash256.c Outdated

@julek-wolfssl julek-wolfssl 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.

thank you @helkoulak

@julek-wolfssl julek-wolfssl merged commit 54f85ad into wolfSSL:master Jun 18, 2026
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.

5 participants