add hash sha2 javascript api layer (#103)

README.md

@@ -278,6 +278,9 @@ https://en.wikipedia.org/wiki/Proxy_re-encryption
 ### Cryptographic primitives and utilities
 
 ```
+ecc_hash_sha256
+ecc_hash_sha512
+
 ecc_kdf_argon2id
 ```
 

bindings/js/README.md

@@ -261,5 +261,8 @@ https://en.wikipedia.org/wiki/Proxy_re-encryption
 ### Cryptographic primitives and utilities
 
 ```
-ecc_kdf_argon2id
+hash_sha256
+hash_sha512
+
+kdf_argon2id
 ```

bindings/js/dist/hash.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Computes the SHA-256 of a given input.
+ *
+ * See https://en.wikipedia.org/wiki/SHA-2
+ *
+ * @param {Uint8Array} input the input message
+ * @return {Uint8Array} the SHA-256 of the input
+ */
+export function hash_sha256(input: Uint8Array): Uint8Array;
+/**
+ * Computes the SHA-512 of a given input.
+ *
+ * See https://en.wikipedia.org/wiki/SHA-2
+ *
+ * @param {Uint8Array} input the input message
+ * @return {Uint8Array} the SHA-512 of the input
+ */
+export function hash_sha512(input: Uint8Array): Uint8Array;

bindings/js/dist/index.d.ts

@@ -1,5 +1,6 @@
 export const libecc_module: (libecc_module: any) => Promise<any>;
 export * from "./util.js";
+export * from "./hash.js";
 export * from "./kdf.js";
 export * from "./oprf.js";
 export * from "./opaque.js";

bindings/js/dist/kdf.d.ts

@@ -0,0 +1,11 @@
+/**
+ * See https://datatracker.ietf.org/doc/html/rfc9106
+ *
+ * @param {Uint8Array} passphrase
+ * @param {Uint8Array} salt, must be of size ecc_kdf_argon2id_SALTIZE
+ * @param {number} memorySize amount of memory (in kibibytes) to use
+ * @param {number} iterations number of passes
+ * @param {number} len intended output length
+ * @return {Uint8Array} the result or null if the computation didn't complete
+ */
+export function kdf_argon2id(passphrase: Uint8Array, salt: Uint8Array, memorySize: number, iterations: number, len: number): Uint8Array;

bindings/js/hash.js

@@ -0,0 +1,52 @@
+/*
+ * Copyright (c) 2023, Alden Torres
+ *
+ * Licensed under the terms of the MIT license.
+ * Copy of the license at https://opensource.org/licenses/MIT
+ */
+
+import {
+    libecc,
+} from "./util.js";
+
+/**
+ * Computes the SHA-256 of a given input.
+ *
+ * See https://en.wikipedia.org/wiki/SHA-2
+ *
+ * @param {Uint8Array} input the input message
+ * @return {Uint8Array} the SHA-256 of the input
+ */
+export function hash_sha256(
+    input,
+) {
+
+    let digest = new Uint8Array(libecc.ecc_hash_sha256_HASHSIZE);
+    libecc.ecc_hash_sha256(
+        digest,
+        input, input.length,
+    );
+
+    return digest;
+}
+
+/**
+ * Computes the SHA-512 of a given input.
+ *
+ * See https://en.wikipedia.org/wiki/SHA-2
+ *
+ * @param {Uint8Array} input the input message
+ * @return {Uint8Array} the SHA-512 of the input
+ */
+export function hash_sha512(
+    input,
+) {
+
+    let digest = new Uint8Array(libecc.ecc_hash_sha512_HASHSIZE);
+    libecc.ecc_hash_sha512(
+        digest,
+        input, input.length,
+    );
+
+    return digest;
+}