unpc v1.2.0

Universal NodeJS Passwords Crypto

🔒 Password hashing and verification library providing single interface for SHA256, SCrypt, BCrypt, Argon2 and PBKDF2 algorithms

🍬 Why use this lib?

• Secure. Library has only 2 dependencies and is constantly being scanned by Snyk & Code QL for vulnerabilities.
• Simple. Standardized api allows to do hashing, salting, peppering and verification with just 2 methods
• Modular. Every supported hashing algorithm is a simple class, that can be imported and used independently.

📦 Installation

• Using npm:

  npm i unpc

• Using Yarn:

  yarn add unpc

• Using pnpm:

  pnpm add unpc

🚚 Additional libraries

To support best hashing algorithms unpc needs third party libraries with C bindings

Argon2

If you want to add support for argon2 algorithm and argon2i, argon2d and argon2id adapters, you need to install package argon2

npm i argon2

BCrypt

If you want to add support for bcrypt algorithm and bcrypt adapter, you need to install package bcrypt

npm i bcrypt

🛠️ Examples

Basic

import { Crypt } from "unpc";
import { Argon2iHashingAdapter } from "unpc/argon2i";

const crypt = new Crypt({
  default: "argon2i",
  adapters: [Argon2iHashingAdapter],
  options: { encoding: "hex" }
});

const secret = "Hello world!";
const hash = await crypt.hash(secret);
console.log(hash);
//

const isCorrect = await crypt.verify(hash, secret);

console.log(isCorrect); // true

Full examples

1. Basic
2. With custom hashing adapter

Adapters

License

Distributed under the MIT License. See LICENSE.txt for more information.