@stablelib/chacha

What is @stablelib/chacha?

@stablelib/chacha is a JavaScript library that provides implementations of the ChaCha stream cipher and the Poly1305 message authentication code. It is part of the StableLib collection of cryptographic libraries, which are designed to be secure, fast, and easy to use.

What are @stablelib/chacha's main functionalities?

ChaCha20 Encryption

This feature allows you to encrypt data using the ChaCha20 stream cipher. The code sample demonstrates how to initialize the cipher with a key and nonce, and then encrypt a plaintext message.

const { ChaCha20 } = require('@stablelib/chacha');
const key = new Uint8Array(32); // 256-bit key
const nonce = new Uint8Array(12); // 96-bit nonce
const plaintext = new Uint8Array([1, 2, 3, 4, 5]);
const chacha = new ChaCha20(key, nonce);
const ciphertext = chacha.encrypt(plaintext);
console.log(ciphertext);

ChaCha20 Decryption

This feature allows you to decrypt data that was encrypted using the ChaCha20 stream cipher. The code sample demonstrates how to initialize the cipher with a key and nonce, and then decrypt a ciphertext message.

const { ChaCha20 } = require('@stablelib/chacha');
const key = new Uint8Array(32); // 256-bit key
const nonce = new Uint8Array(12); // 96-bit nonce
const ciphertext = new Uint8Array([/* encrypted data */]);
const chacha = new ChaCha20(key, nonce);
const decrypted = chacha.decrypt(ciphertext);
console.log(decrypted);

Poly1305 Authentication

This feature allows you to generate a Poly1305 message authentication code (MAC) for a given message. The code sample demonstrates how to initialize the Poly1305 instance with a key, update it with a message, and then generate the authentication tag.

const { Poly1305 } = require('@stablelib/chacha');
const key = new Uint8Array(32); // 256-bit key
const message = new Uint8Array([1, 2, 3, 4, 5]);
const poly1305 = new Poly1305(key);
const tag = poly1305.update(message).digest();
console.log(tag);

Other packages similar to @stablelib/chacha

tweetnacl

TweetNaCl is a cryptographic library that provides a variety of cryptographic functions, including the ChaCha20 stream cipher and Poly1305 MAC. It is known for its simplicity and small size. Compared to @stablelib/chacha, TweetNaCl offers a broader range of cryptographic primitives but may not be as modular or specialized.

libsodium

Libsodium is a widely-used cryptographic library that provides high-level cryptographic functions, including ChaCha20 and Poly1305. It is known for its ease of use, security, and performance. Compared to @stablelib/chacha, Libsodium offers a more comprehensive suite of cryptographic tools and is available in multiple languages.

crypto-js

Crypto-JS is a popular JavaScript library that provides a variety of cryptographic algorithms, including AES, SHA, and HMAC. While it does not natively support ChaCha20 and Poly1305, it is often used for general cryptographic needs in JavaScript applications. Compared to @stablelib/chacha, Crypto-JS is more general-purpose and less specialized in stream ciphers.

README

The README file is missing