Argon2id-JS

Argon2id implementation in a plain JavaScript.

Usage

1. Import library

<!-- 1. Include worker to increase performance (Utilize multi-threading). -->
<script src="Argon2idWorker.min.js"></script>
<!-- 2. Include Argon2id library. -->
<script src="Argon2id.min.js"></script>

2. Hash

/*

  Parameters:
  1. Message (String)
  2. Salt (String) <>
  3. Iterations (Int) <2> (Min = 1)
  4. Memory Cost (Int) <32> (Min = 12)
  5. Parallelism Factor (Int) <3> (Min = 1)
  6. Length (Int) <32> (Min = 1)
  7. Secret (String) <>
  8. Associated Data (String) <>

*/

// Generate hash from the provided message
// If you don't provide salt, it will be auto generated
Argon2id.hash("message").then(hash => {
	console.log("Hash: " + hash);
});

// Generate Encoded hash from the provided message
// Both hash and hashEncoded functions accept the same parameters
Argon2id.hashEncoded("message").then(hashEncoded => {
	console.log("Encoded Hash: " + hashEncoded);
});
// To get hash from hashEncoded function you can use function called hashDecode
Argon2id.hashDecode("$argon2id$v=19$m=32,t=2,p=3$MjZZaFJwRjZ2N3pyUzU2ag$EzMK1uIBhPZQV8XPsjTOnw");

// Generate hash from the provided message and salt
Argon2id.hash("message", "salt").then(hash => {
	console.log("Hash: " + hash);
});
// To generate random secure salt use randomSalt function
Argon2id.hashEncoded("message", Argon2id.randomSalt()).then(hashEncoded => {
	console.log("Encoded Hash: " + hashEncoded);
});

// Generate hash from the provided message, salt, iterations, memory cost, parallelism factor and hash length
Argon2id.hashEncoded("message", Argon2id.randomSalt(), 2, 32, 3, 32).then(hashEncoded => {
	console.log("Encoded Hash: " + hashEncoded);
});
// This library also support Secret and Associated Data
Argon2id.hash("message", "salt", 2, 32, 3, 32, "Secret", "Associated Data").then(hash => {
	console.log("Hash: " + hash);
});

// To validate the message you can use verify function.
// This function accept hashEncoded, message, secret and associated data.
Argon2id.verify("$argon2id$v=19$m=32,t=2,p=3$MjZZaFJwRjZ2N3pyUzU2ag$EzMK1uIBhPZQV8XPsjTOnw", "test").then(match => {
	if(match) console.log("Message is valid.");
	if(!match) console.log("Message is not valid.");
});