@stablelib/poly1305

What is @stablelib/poly1305?

@stablelib/poly1305 is a JavaScript implementation of the Poly1305 message authentication code (MAC) algorithm. It is part of the StableLib collection of cryptographic libraries and is designed to provide high-performance and secure MAC generation for use in various cryptographic protocols.

What are @stablelib/poly1305's main functionalities?

Generate Poly1305 MAC

This feature allows you to generate a Poly1305 MAC for a given message using a 32-byte key. The code sample demonstrates how to create a Poly1305 instance, update it with a message, and then generate the MAC.

const { Poly1305 } = require('@stablelib/poly1305');

const key = new Uint8Array(32); // 32-byte key
const message = new Uint8Array([1, 2, 3, 4, 5]); // Message to authenticate

const poly1305 = new Poly1305(key);
poly1305.update(message);
const mac = poly1305.finish();

console.log('MAC:', mac);

Verify Poly1305 MAC

This feature allows you to verify a Poly1305 MAC for a given message and key. The code sample demonstrates how to create a Poly1305 instance, update it with a message, and then compare the generated MAC with an expected MAC.

const { Poly1305 } = require('@stablelib/poly1305');

const key = new Uint8Array(32); // 32-byte key
const message = new Uint8Array([1, 2, 3, 4, 5]); // Message to authenticate
const expectedMac = new Uint8Array(16); // Expected MAC

const poly1305 = new Poly1305(key);
poly1305.update(message);
const isValid = poly1305.finish().every((byte, index) => byte === expectedMac[index]);

console.log('MAC is valid:', isValid);

Other packages similar to @stablelib/poly1305

tweetnacl

TweetNaCl is a cryptographic library that provides a variety of cryptographic functions, including the Poly1305 MAC algorithm. It is known for its simplicity and high performance. Compared to @stablelib/poly1305, 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 a comprehensive set of cryptographic functions, including the Poly1305 MAC algorithm. It is known for its ease of use, security, and performance. Compared to @stablelib/poly1305, Libsodium offers a more extensive set of features and is suitable for a wide range of cryptographic applications.

crypto-js

Crypto-JS is a popular JavaScript library that provides a variety of cryptographic algorithms, including HMAC, which can be used as an alternative to Poly1305 for message authentication. While it does not specifically implement Poly1305, it offers a wide range of cryptographic functions and is widely used in the JavaScript community.

README

The README file is missing