Fixup documentation for tag change
This commit is contained in:
27
Ascon.cry
27
Ascon.cry
@@ -196,7 +196,8 @@ private
|
|||||||
* - P: Plaintext
|
* - P: Plaintext
|
||||||
*
|
*
|
||||||
* Returns:
|
* Returns:
|
||||||
* - Authenticated ciphertext
|
* - Ciphertext
|
||||||
|
* - Tag
|
||||||
*/
|
*/
|
||||||
AEAD128_encrypt :
|
AEAD128_encrypt :
|
||||||
{a, p} (fin a, fin p) =>
|
{a, p} (fin a, fin p) =>
|
||||||
@@ -243,6 +244,7 @@ AEAD128_encrypt K N A P = (C, T)
|
|||||||
* - N: Nonce
|
* - N: Nonce
|
||||||
* - A: Associated data
|
* - A: Associated data
|
||||||
* - C: Ciphertext
|
* - C: Ciphertext
|
||||||
|
* - T: Tag
|
||||||
*
|
*
|
||||||
* Returns:
|
* Returns:
|
||||||
* - Some plaintext on authentication success
|
* - Some plaintext on authentication success
|
||||||
@@ -255,6 +257,25 @@ AEAD128_decrypt K N A C T1 = if T1 == T2 then Some P else None
|
|||||||
where
|
where
|
||||||
(P, T2) = AEAD128_decrypt_raw K N A C
|
(P, T2) = AEAD128_decrypt_raw K N A C
|
||||||
|
|
||||||
|
/** Raw Ascon-AEAD128 decryption algorithm on bitstreams.
|
||||||
|
*
|
||||||
|
* The tag returned by this function should be compared to the
|
||||||
|
* tag on the associated ciphertext to authenticate it.
|
||||||
|
*
|
||||||
|
* Type parameters:
|
||||||
|
* - a: Bit-length of associated data
|
||||||
|
* - p: Bit-length of plaintext
|
||||||
|
*
|
||||||
|
* Parameters:
|
||||||
|
* - K: Key
|
||||||
|
* - N: Nonce
|
||||||
|
* - A: Associated data
|
||||||
|
* - C: Ciphertext
|
||||||
|
*
|
||||||
|
* Returns:
|
||||||
|
* - P: Plaintext
|
||||||
|
* - T: Computed tag
|
||||||
|
*/
|
||||||
AEAD128_decrypt_raw :
|
AEAD128_decrypt_raw :
|
||||||
{a, p} (fin a, fin p) =>
|
{a, p} (fin a, fin p) =>
|
||||||
[128] -> [128] -> [a] -> [p] -> ([p], [128])
|
[128] -> [128] -> [a] -> [p] -> ([p], [128])
|
||||||
@@ -291,7 +312,8 @@ AEAD128_decrypt_raw K N A C = (P, T)
|
|||||||
* - P: Plaintext
|
* - P: Plaintext
|
||||||
*
|
*
|
||||||
* Returns:
|
* Returns:
|
||||||
* - Authenticated ciphertext
|
* - C: Ciphertext
|
||||||
|
* - T: Tag
|
||||||
*/
|
*/
|
||||||
AEAD128_encrypt_bytes :
|
AEAD128_encrypt_bytes :
|
||||||
{a, p} (fin a, fin p) =>
|
{a, p} (fin a, fin p) =>
|
||||||
@@ -315,6 +337,7 @@ AEAD128_encrypt_bytes K N A P = (bitsToWords C, bitsToWords T)
|
|||||||
* - N: Nonce
|
* - N: Nonce
|
||||||
* - A: Associated data
|
* - A: Associated data
|
||||||
* - C: Ciphertext
|
* - C: Ciphertext
|
||||||
|
* - T: Tag
|
||||||
*
|
*
|
||||||
* Returns:
|
* Returns:
|
||||||
* - Some plaintext on authentication success
|
* - Some plaintext on authentication success
|
||||||
|
Reference in New Issue
Block a user