Sign Up for Free

RunKit +

Try any Node.js package right in your browser

This is a playground to test code. It runs a full Node.js environment and already has all of npm’s 400,000 packages pre-installed, including avon with all npm packages installed. Try it out:

var avon = require("avon")

This service is provided by RunKit and is not affiliated with npm, Inc or the package authors.

avon v2.1.0

node bindings for the blake2 cryptographic hash

avon

Node bindings for the blake2 cryptographic hash function. The relationship of Avon to Blake is of course obvious.

Blake2 provides four different hashing functions:

  • blake2b, blake2bp: 64-bit architectures, single & multicore variations
  • blake2s, blake2sp: 32-bit and under architectures, single & multicore variations

All four algorithms are different & will produce different sums. Choose the one that's appropriate for your use.

on npm Build Status Coverage Status

Tested on node 0.10, 4.x, 5.x, and 6.x.

Usage

Avon exports sumFile(), sumBuffer(), and sumStream() functions to calculate a hash for whatever sort of data you have. sumBuffer() is synchronous. sumFile() and sumStream() take an optional callback. If no callback is provided, they return promises. Use the control flow method you prefer! The calculated hash is a node Buffer.

If you don't specify an algorithm, the 64-bit single-core B algorithm is used.

var Avon = require('avon');
var assert = require('assert');

var buf = new Buffer('this is some input');

var hash = Avon.sumBuffer(buf, Avon.ALGORITHMS.BP);
assert(hash instanceof Buffer);
console.log(hash.toString('hex'));

var sum = Avon.sumBuffer(buf, Avon.ALGORITHMS.SP);
console.log(sum.toString('hex');

Want to hash a file? Sure!

Avon.sumFile('my_file.dat', Avon.ALGORITHMS.SP, function(err, buffer)
{
    if (err) console.error('noooo!');
    else console.log(buffer.toString('hex'))
});

Or create a stream:

var input = fs.createReadStream('my-large-file');
var hasher = Avon.sumStream(Avon.ALGORITHMS.BP);

input.on('close', function()
{
    var digest = hasher.digest('hex');
    // you now have a string with the final hash digest
    // the hash is unusable from here on
});

input.pipe(hasher);

API

Avon.ALGORITHMS exports the enum-like list of algorithms: B, BP, S, and SP.

Blake2 provides a bewildering variety of variations. Avon exposes all of them both in the general-purpose functions given above, and in some convenience wrappers. This chart might help you decide which to use.

functioninputarchmulticore?async?algo name
sumStreamstream**-pass algo name
sumBufferbuffer**npass algo name
sumFilefile**ypass algo name
blake2buffer64nnB
blake2SMPbuffer64ynBP
blake2_32buffer32nnS
blake2_32SMPbuffer32ynSP
blake2Filefile64nyB
blake2SMPFilefile64yyBP
blake2_32Filefile32nyS
blake2_32SMPFilefile32yySP

Notes

V8 bindings made considerably easier thanks to NAN.

License

ISC.

RunKit is a free, in-browser JavaScript dev environment for prototyping Node.js code, with every npm package installed. Sign up to share your code.
Sign Up for Free