hearhellacopters / node-crypto

Portable Crypto libraries for Node and Browsers

encryption-for-node

14 vanilla TypeScript, 0 dependencies portable encryption libraries. Great for Node servers or Browsers.

Encryptions

• AES
• Aria
• Blowfish
• Camellia
• Cast128
• ChaCha20
• Triple DES
• IDEA
• MARS
• MISTY1
• SEED
• Serpent
• SM4
• Twofish

Installation

npm install encryption-for-node

Features

• Barebones, small size, no bulk encryption methods.
• Runs ECB or CBC modes.
• Static or PKCS padding.
• Accepts Buffer or Uint8Array. Returns the same type.
• Easily modifiable to fit any needs.

Require or Import

//For Node:
const {CAST128} = require('encryption-for-node');
//For Browser:
import {CAST128} from 'encryption-for-node';

Use

All encryptions classes follow the same format. Use cipher.set_key then cipher.set_iv for CBC mode. If cipher.set_iv is not set, runs in ECB mode. If static padding number is not set, uses PKCS padding on last block if needed.

//encrypt:
const cipher = new Blowfish();
cipher.set_key(Uint8ArrayOrBufferKey);
cipher.set_iv(Uint8ArrayOrBufferIV);
var paddingNumber = 0xFF; //If padding number is not set, uses PKCS padding.
const CipherText = cipher.encrypt(Uint8ArrayOrBufferText, paddingNumber);
//decrypt
const cipher = new Blowfish();
cipher.set_key(Uint8ArrayOrBufferKey);
cipher.set_iv(Uint8ArrayOrBufferIV);
var paddingNumberOrTrue = 0xFF; //Will check the last block and remove if padded is ``number``. Will remove PKCS if ``true``.
const DecryptedUInt8ArrayOrBuffer = cipher.decrypt(ciphertext, paddingNumberOrTrue);

Note: Most encryptions can be run multiple times once setup with a key. IV will need to be reset for CBC mode before each use.

Tech

Encryption	Key Length	IV Length
AES	16, 24 or 32 byte key	16 byte IV
ARIA	16, 24 or 32 byte key	same as key
BLOWFISH	Up to 56 byte key	8 byte IV
CAMELLIA	16, 24 or 32 byte key	16 byte IV
CAST128	16 byte key	8 byte IV
*CHACHA20	32 byte key, 12 byte nonce	16 byte IV
DES3	8 byte key	8 byte IV
IDEA	16 byte key	8 byte IV
MARS	16, 24 or 32 byte key	16 byte IV
MISTY1	16 byte key	8 byte IV
SEED	16 byte key	16 byte IV
SERPENT	16, 24 or 32 byte key	16 byte IV
SM4	16 byte key	16 byte IV
TWOFISH	16 byte key	16 byte IV

*key must be reset after each use

License

MIT

Disclaimer

This library spawned from a project where issues with different Node versions meant not having the same access to some of these encryptions. I created these vanilla JavaScript versions of these encryptions so we could implement them in different environments and have them all match. I do not know how they hold up speed or performance wise against something more direct like a C++ source code, as the goal here was flexible. Some encryptions were limited in key length as it would have required extra coding outside of the function of the project. All libraries are presented as is, I take no responsibility for outside use.

If you plan to implement these encryption libraries for anything other than personal or educational use, please be sure you have the appropriate permissions from the original owner of the cipher.