elsie-four-cipher
v1.0.2
Published
A js implementation of the ElsieFour (LC4) cipher
Downloads
2
Readme
elsie-four-cipher
A node.js implementation of the ElsieFour (LC4) cipher (https://eprint.iacr.org/2017/339.pdf). Currently supports encryption and decryption, but not the nonce or signature auth.
Install
npm install elsie-four-cipher --save
Example
const cipher = require('elsie-four-cipher');
// encrypt(key, message). This example returns tk5j23tq94_gw9c#lhzs
cipher.encrypt('s2ferw_nx346ty5odiupq#lmz8ajhgcvk79b', 'aaaaaaaaaaaaaaaaaaaa');
// decrypt (key, message). This example returns aaaaaaaaaaaaaaaaaaaa
cipher.decrypt('s2ferw_nx346ty5odiupq#lmz8ajhgcvk79b', 'tk5j23tq94_gw9c#lhzs');
What is ElsieFour?
ElsieFour (LC4) is a low-tech cipher that can be computed by hand; but unlike many historical ciphers, LC4 is designed to be hard to break. LC4 is in tended for encrypted communication between humans only, and therefore it encrypts and decrypts plaintexts and ciphertexts consisting only of the English letters A through Z plus a few other characters
In other words, it's a cipher that can be easily computed by hand. It uses a grid of the following alphabet:
#_23456789abcdefghijklmnopqrstuvwxyz
In some combination (a key). This grid is operated on depending on the value of the square and the location of a marker that starts in the top right corner. (See the paper for a detailed explaination. There is a tutorial with images near the end of the paper)
Test
npm test
License
This project is under the MIT License (See LICENSE)