JavaScript Elliptic curve cryptography library compatible with PyBitmessage
Go to file
Kagami Hiiragi 0dd788aca0 README fixes
2014-12-28 14:13:08 +03:00
.gitignore Initial commit 2014-12-21 20:46:37 +03:00
.jshintignore Initial commit 2014-12-21 20:46:37 +03:00
.jshintrc Initial commit 2014-12-21 20:46:37 +03:00
.npmignore Initial commit 2014-12-21 20:46:37 +03:00
.travis.yml Initial commit 2014-12-21 20:46:37 +03:00
browser.js Check private key length in getPublic 2014-12-27 15:47:25 +03:00
COPYING Initial commit 2014-12-21 20:46:37 +03:00
index.js Typo fix 2014-12-26 21:02:01 +03:00
karma.conf.js Setup karma 2014-12-21 21:05:05 +03:00
package.json 0.1.1 2014-12-26 20:49:17 +03:00
README.md README fixes 2014-12-28 14:13:08 +03:00
test.js Add usages, improve README 2014-12-28 14:02:28 +03:00

eccrypto Build Status

JavaScript Elliptic curve cryptography library for both browserify and node.

Motivation

There is currently no any isomorphic ECC library which provides ECDSA, ECDH and ECIES for both Node.js and Browser and uses the fastest libraries available (e.g. secp256k1-node is much faster than other libraries but can be used only on Node.js). So eccrypto is an attempt to create one. Current goals:

  • Convert private key to public
  • ECDSA
  • ECDH
  • ECIES

Implementation details:

  • Use Node.js crypto module/library bindings where possible
  • Use WebCryptoAPI where possible
  • Promise-driven API
  • Only secp256k1 curve, HMAC-SHA256 for ECDH and AES-256-CBC for ECIES

Possible future goals:

  • Support other curves/KDF/MAC/symmetric encryption schemes

Native crypto API limitations

crypto

ECDH only works in Node 0.11+ (see https://github.com/joyent/node/pull/5854), ECDSA is only supported when keys are in PEM format (see https://github.com/joyent/node/issues/6904) and ECIES is not supported at all.

WebCryptoAPI

ECDSA and ECDH are supported in Chrome only on Windows (see also bug 338883), aren't supported by Firefox (fixed only in 36.0+, see bug 1034854) and ECIES is not defined at all in WebCryptoAPI draft. Also WebCryptoAPI currently defines only curves recommended by NIST which means that secp256k1 is not supported (see also: [1], [2]).

So we use seck256k1 library in Node for ECDSA, elliptic in Browser for ECDSA and ECDH and implement ECIES manually with the help of native crypto API.

Usage

With the help of browserify eccrypto provides different implementations for Browser and Node.js with the same API. Because WebCryptoAPI defines asynchronous promise-driven API, implementation for Node needs to use promises too.

var crypto = require("crypto");
var eccrypto = require("eccrypto");

var privateKey = crypto.randomBytes(32);
var publicKey = eccrypto.getPublic(privateKey);
var str = "msg to sign";
// Always hash you msg to sign!
var msg = crypto.createHash("sha256").update(str).digest();

eccrypto.sign(privateKey, msg).then(function(sig) {
  console.log("signed:", sig);
  // Public key is sufficient for verifying but private key also could be
  // passed for convinience.
  eccrypto.verify(publicKey, msg, sig).then(function() {
    console.log("verified");
  });
});

License

eccrypto - JavaScript Elliptic curve cryptography library

Written in 2014 by Kagami Hiiragi kagami@genshiken.org

To the extent possible under law, the author(s) have dedicated all copyright and related and neighboring rights to this software to the public domain worldwide. This software is distributed without any warranty.

You should have received a copy of the CC0 Public Domain Dedication along with this software. If not, see http://creativecommons.org/publicdomain/zero/1.0/.