XChaCha20 (JavaScript)
This is a pure JavaScript implementation of XChaCha20 (and therefore ChaCha20
and HChaCha20), for use in polyfill libraries.
Important Security Warning
This library provides unauthenticated encryption.
You shouldn't use it directly. It's meant to be a building block for other,
high-level protocols.
Use sodium-native instead!
Installing this Library
npm install xchacha20-js
Using this Library
Usage is straightforward.
const XChaCha20 = require('xchacha20-js');
let xcha20 = new XChaCha20;
let message = "test message";
let key = Buffer.from('808182838485868788898a8b8c8d8e8f909192939495969798999a9b9c9d9e9f', 'hex');
let nonce = Buffer.from('404142434445464748494a4b4c4d4e4f5051525354555658', 'hex');
let blockCounter = 1;
xcha20.encrypt(message, nonce, key, blockCounter).then(
function (ciphertext) {
xcha20.decrypt(ciphertext, nonce, key, blockCounter).then(
function (plaintext) {
console.log(plaintext.toString() === message);
}
)
}
);
Alternatively. using async
/ await
...
const XChaCha20 = require('xchacha20-js');
let xcha20 = new XChaCha20;
let message = "test message";
let key = Buffer.from('808182838485868788898a8b8c8d8e8f909192939495969798999a9b9c9d9e9f', 'hex');
let nonce = Buffer.from('404142434445464748494a4b4c4d4e4f5051525354555658', 'hex');
(async function(){
let blockCounter = 1;
let ciphertext = await xcha20.encrypt(message, nonce, key, blockCounter);
let plaintext = await xcha20.decrypt(ciphertext, nonce, key, blockCounter);
console.log(plaintext.toString() === message);
})();