Ezcrypto.js

A small vendoring wrapper for sjcl with support for hashes and encodings required by the Ezira.io platform.

Usage

If you are using Webpack or Browserify, you must ensure that Node's built-in crypto package is excluded from your builds.

Otherwise, just

$ yarn install ezcrypto.js

API

> ezcrypto = require('ezcrypto.js');

ezcrypto.sha256(data)

Hashes the content of an ArrayBuffer using SHA-256.

> shaHash = ezcrypto.sha256(new Uint8Array().buffer)
ArrayBuffer { byteLength: 32 }
> ezcrypto.hexify(shaHash)
'e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855'

ezcrypto.ripemd160(data)

Hashes the content of an ArrayBuffer using RIPEMD-160.

> ripemdHash = ezcrypto.ripemd160(new Uint8Array().buffer)
ArrayBuffer { byteLength: 20 }e
> ezcrypto.hexify(ripemdHash)
'9c1185a5c5e9fc54612808977ee8f548b2258d31'

ezcrypto.PrivateKey

Provides operations over Ezira secp256k1-based ECC private keys.

> secretKey = ezcrypto.PrivateKey.from('5JCDRqLdyX4W7tscyzyxav8EaqABSVAWLvfi7rdqMKJneqqwQGt')
PrivateKey { getPublicKey: [Function], sign: [Function] }
> secretKey.getPublicKey().toString()
'EZT5pZ15FDVAvNKW3saTJchWmSSmYtEvA6aKiXwDtCq2JRZV9KtR9'
> secretSig = secretKey.sign(new Uint8Array(32).buffer)
ArrayBuffer { byteLength: 65 }
> ezcrypto.hexify(secretSig)
'20387d5f9ae215a64065fde2a9d4f7be83d3480b7cc89f7c01488042da348845408909e9d4f1d66466c53f0007c771a73bf2883d8d5ab4735b5b4316091361442c'

ezcrypto.PublicKey

Provides operations over Ezira secp256k1-based ECC public keys.

> publicKey = ezcrypto.PublicKey.from('EZT5SKxjN1YdrFLgoPcp9KteUmNVdgE8DpTPC9sF6jbjVqP9d2Utq')
... 
> publicKey.verify(new Uint8Array(32).buffer, secretSig)
true
> PublicKey.recover(someHash, someSig)
...

ezcrypto.generateKeys()

Generates a new pair of keys in Ezira WIF format using cryptographically secure random number generation.

> ezcrypto.generateKeys()
{
  private: "5JCDRqLdyX4W7tscyzyxav8EaqABSVAWLvfi7rdqMKJneqqwQGt",
  public: "EZT5pZ15FDVAvNKW3saTJchWmSSmYtEvA6aKiXwDtCq2JRZV9KtR9"
}

ezcrypto.keysFromPassword(accountName, accountPassword)

Given an account name and password, regenerates the derived owner, posting, active, and memo keys.

> ezcrypto.keysFromPassword('username', 'password')
{ owner:
   { private: '5JCDRqLdyX4W7tscyzyxav8EaqABSVAWLvfi7rdqMKJneqqwQGt',
     public: 'EZT5pZ15FDVAvNKW3saTJchWmSSmYtEvA6aKiXwDtCq2JRZV9KtR9' },
  memo:
   { private: '5JSmQQJXH5ZrSW3KJSTUPFJy7SuLeDiY3bW6vB1McamxzJQFhwD',
     public: 'EZT5nwJgD9jmkAdTXuiz3jqrkw3om95gCapZo4e4Bcp3qzyiedwCn' },
  posting:
   { private: '5HsoxWiHRRyx6oSxKj32HDqDMzSGhs79zLZopDc7nMcjMbcPp5E',
     public: 'EZT6gZmazY23TEMkxmPpnmvbAgWFAzwtaSDbhSUdmpTXzoJJLPFH4' },
  active:
   { private: '5JamTPvZyQsHf8c2pbN92F1gUY3sJkpW3ZJFzdmfbAJPAXT5aw3',
     public: 'EZT5SKxjN1YdrFLgoPcp9KteUmNVdgE8DpTPC9sF6jbjVqP9d2Utq' } }

Requirements

ezcrypto is written in Javascript as specified by ECMA-262, version 5.1. Other than its vendored copy of sjcl, it has no dependencies and never will.

ezcrypto explicitly supports the following environments without polyfills:

• Node.js versions 4 and up
• Microsoft Edge (all versions)
• Safari for macOS versions 7.1+
• Safari for iOS versions 8+
• Firefox, Chrome, and Opera versions 30+

ezcrypto explicitly does not support the following environments:

• Opera Mini
• Android Browser (i.e., the non-Chromium versions)
• Microsoft Internet Explorer versions <10

Contributing

Contributions must conform to the following rules:

• They must pass formatting and linting and the existing automated test suite must pass.
• They must add test coverage for new code.
• They must not introduce any new dependencies.
• They must support the environments listed above without the use of polyfills.