pharpend/Vanillae
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

wip keccak docs

Browse Source
This commit is contained in:
pharpend
2023-03-31 23:42:56 -06:00
parent ace8668b47
commit 5d02fb0865
1 changed files with 13 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/kek/README.md
+13 -6
View File
@@ -2,11 +2,16 @@
![I can't make a diagram for this one, fellas.[^sponge]](./sponge.jpg) ![I can't make a diagram for this one, fellas.[^sponge]](./sponge.jpg)
Keccak is a hashing algorithm used for the SHA-3 standard. [The Keccak is a hashing algorithm used for the SHA-3 standard. [The NIST
standard][nist-standard] is semi-readable math clownery. Hashing algorithms by standard][nist-standard] is semi-readable math clownery. Hashing algorithms by
nature have to be complicated and somewhat obfuscated. But, at the end of the nature have to be complicated and somewhat obfuscated, so this is kind of par
day, all Keccak does is take in some input bits, process them in a for the course.
deterministic way, and hand you output bits.
I found [this lecture][german-lecture] and the [accompanying
notes][german-lecture-notes] indispensable when writing kek.
At the end of the day, all Keccak does is take in some input bits, process them
in a deterministic way, and hand you output bits.
The goal of this document is just to explain what the processing steps are as The goal of this document is just to explain what the processing steps are as
straightforwardly as possible. straightforwardly as possible.
@@ -22,8 +27,8 @@ special cases of Keccak.
#### References #### References
1. [Helpful lecture](https://www.youtube.com/watch?v=JWskjzgiIa4) 1. [Helpful lecture][german-lecture]
2. [Notes for that lecture](https://www.crypto-textbook.com/download/Understanding-Cryptography-Keccak.pdf) 2. [Notes for that lecture][german-lecture-notes]
3. [NIST standard][nist-standard] (btw: the double bar notation means "concatenate") 3. [NIST standard][nist-standard] (btw: the double bar notation means "concatenate")
4. [SHA-3 Wikipedia](https://en.wikipedia.org/wiki/SHA-3) 4. [SHA-3 Wikipedia](https://en.wikipedia.org/wiki/SHA-3)
@@ -275,5 +280,7 @@ keccak(Capacity = _c, Message, OutputBitLength) ->
The padding part is kind of dumb. `absorb/4` and `squeeze/3` both call The padding part is kind of dumb. `absorb/4` and `squeeze/3` both call
`inner_keccak/1`, which like I said is where all the real bit-churning happens. `inner_keccak/1`, which like I said is where all the real bit-churning happens.
[german-lecture]: https://www.youtube.com/watch?v=JWskjzgiIa4
[german-lecture-notes]: https://www.crypto-textbook.com/download/Understanding-Cryptography-Keccak.pdf
[nist-standard]: https://nvlpubs.nist.gov/nistpubs/FIPS/NIST.FIPS.202.pdf [nist-standard]: https://nvlpubs.nist.gov/nistpubs/FIPS/NIST.FIPS.202.pdf
[^sponge]: Source for photo: https://www.flickr.com/photos/30478819@N08/46410395345 [^sponge]: Source for photo: https://www.flickr.com/photos/30478819@N08/46410395345