The gruft library is a fast implementation of several cryptographic hash functions in pure Javascript: MD5, SHA-1, SHA-256, and Tiger/192. gruft can output digests in various formats: hex strings, Base64-encoded (also as a URL-safe variant), or as byte-sequences (i.e. Javascript Arrays).
Unlike many other implementations, any hash function in the gruft library will always perform a self-test against known test-vectors upon instantiation.
Author Nikola Klaric (github.com/nikola)
Source https://github.com/nikola/gruft
Latest release version 0.2.0
License MIT License
Should work with any ECMA-262-compliant Javascript engine (including Node.js).
DemoType or paste any text into the textarea below, and the hash functions will compute automatically.
MD5 SHA-1 SHA-256 Tiger/192
Upon loading this page you'll already see hex digests computed on the right side. This is correct behavior: Any of these hash functions will produce a digest even for an empty string, i.e. for an empty textarea.
UsageStep 1. Include the gruft-common module in your page, e.g.
<script src="path/to/javascript/files/gruft-common.js"></script>
Step 2. Include the hash function module(s) that you require in your page, e.g.
<script src="path/to/javascript/files/gruft-md5.js"></script>
<script src="path/to/javascript/files/gruft-sha256.js"></script>
Step 3a. In your Javascript code, instantiate the hash functions that you intend to use, e.g.
var md5 = new gruft.MD5();
var sha256 = new gruft.SHA256();
Step 3b. Call the digest()-function on the instance with your input string, e.g.
md5.digest("The quick brown fox jumps over the lazy dog")
That is all.
Upon instantiation (as shown in 3a), the respective hash function will perform a self-test with about 12 different variations of discrete test-vectors. If this self-test fails, the hash function will raise an error telling you which exact test-vector failed. Subsequent instantiations of the same hash function on your page will raise a fatal error to prevent further usage of the respective module.
The digest()-function expects at least one argument. Calling the function without an argument is not the same as passing an empty string. You can also pass additional options to control the output format of the hash function:
- message
- The input string to digest. You can pass the input string as the first argument (and additional options as the second), or pack the input string into the options and pass them as a single argument.
- format
- The hash format. Available options are: "hex" (the default), "base64" (Base64-encoded), "base64_safe" (a URL-safe variant), "byteseq" (a Javascript Array).
- order
- The byte-order of the hash. The default order is, respectively: little-endian (for MD5, Tiger/192), big-endian (for SHA-1, SHA-256). You can choose a different byte-order by passing "little" or "big" in this field.
Usage examples (taken from the respective self-test code):
> var md5 = new gruft.MD5();Download
> md5.digest("")
"d41d8cd98f00b204e9800998ecf8427e"
> md5.digest({message:"MD5", format:"byteseq"})
[0x7f, 0x13, 0x8a, 0x09, 0x16, 0x9b, 0x25, 0x0e, 0x9d, 0xcb, 0x37, 0x81, 0x40, 0x90, 0x73, 0x78]
> md5.digest({message:"ABCDEFGHIJ"})
"e86410fa2d6e2634fd8ac5f4b3afe7f3"
> md5.digest({message:"ABCDEFGHIJ", format:"base64"})
"6GQQ+i1uJjT9isX0s6/n8w=="
> md5.digest("ABCDEFGHIJ", {format:"base64_safe"})
"6GQQ-i1uJjT9isX0s6_n8w"
> var tiger = new gruft.Tiger192();
> tiger.digest("Tiger", {order:"big"})
"9f00f599072300dd276abb38c8eb6dec37790c116f9d2bdf"
Latest revision from master: