dcrypt.coffee 

_bindings = require './build/default/dcrypt'

OpenSSL bindings for Node.js. This module extends what is in node-crypto bringing much needed additional functionality.

 
Random = _bindings.Random
Hash = _bindings.Hash
Sign = _bindings.Sign
Verify = _bindings.Verify
KeyPair = _bindings.KeyPair
Encode = _bindings.Encode
Cipher = _bindings.Cipher
Rsa = _bindings.Rsa

dcrypt = {}

Random

Given a length, randomBytes returns a buffer full of random data. 

dcrypt.random = {}
dcrypt.random.randomBytes = (len) ->
  len = len or 16
  buff = new Buffer len
  rb = new Random()
  rb.randomBytes buff
  return buff

exports.random = dcrypt.random

Hash

Create a hash object to digest some messages. Call hash.update(msg) to continually digest new data and hash.final(encoding_type) to receive the final digested message.

 
dcrypt.hash = Hash
exports.hash = {}
exports.hash.createHash = (hash) ->
  return new Hash hash

Sign

Sign a message with a private key. This message can then be verified as coming from that private key with a corresponding public key. This object can take and PKI algorithm type, such as ECDSA and RSA. 

dcrypt.sign = Sign
exports.sign = {}
exports.sign.createSign = (algo) ->
  return (new Sign).init algo

Verify

Use verify to verify a signed message came from the associated private key. Verify.final can take either a PEM encoded certificate or a PEM encoded public key. Result of Verify.final is a boolean as to whether it passed or not. 

dcrypt.verify = Verify
exports.verify= {}
exports.verify.createVerify= (algo) ->
  return (new Verify).init algo

Key Pairs

 
dcrypt.keypair = KeyPair
exports.keypair = {}

newRSA takes a size in bytes of the key, as well as a exponent size. Both these arguments are optional and default to 1024 for key and 65537 for exponent by default

 
exports.keypair.newRSA = (size, exp) ->
  size = size || 1024
  exp = exp || 65537
  return (new KeyPair).newRSA(size, exp)

newECDSA creates a new ecdsa key pair, if no curve is supplied it uses "secp256k1" as default

 
exports.keypair.newECDSA = (curve) ->
  curve = curve or "secp256k1"
  return (new KeyPair).newECDSA(curve)

parseECDSA parses the raw ECDSA parameters from a PEM file's contents

 
exports.keypair.parseECDSA = (filename, public) ->
  return (new KeyPair).parseECDSA(filename, public)

parseRSA parses the raw RSA parameters from a PEM file's contents

 
exports.keypair.parseRSA = (filename, public) ->
  return (new KeyPair).parseRSA(filename, public)

dcrypt.encode = Encode
exports.encode = {}
exports.encode.encodeBase58 = (data) ->
  return (new Encode).encodeBase58(data)

exports.encode.decodeBase58 = (data) ->
  return (new Encode).decodeBase58(data)

Cipher

 
dcrypt.cipher = Cipher
exports.cipher = {}
exports.cipher.createCipher = (cipher, key) ->
  return (new Cipher).init(cipher, key)

exports.cipher.createCipheriv = (cipher, key, iv) ->
  return (new Cipher).initiv(cipher, key, iv)

RSA

Encrypt a message with a RSA public key and decrypt it with the associated private key. Public key can either be in PEM key format or a PEM certificate. If no padding is chosen PKCS1 padding will be used. If no output encoding is supplied, hex is used.

 
dcrypt.rsa = Rsa 
exports.rsa = {}
exports.rsa.encrypt = (pem_pub, msg, padding, out_encoding) ->
  out_encoding = out_encoding or 'hex'
  padding = padding or 'RSA_PKCS1_PADDING'
  return (new Rsa).encrypt(pem_pub, msg, padding, out_encoding)

exports.rsa.decrypt = (pem_priv, enc_msg, padding, in_encoding) ->
  out_encoding = out_encoding or 'hex'
  padding = padding or 'RSA_PKCS1_PADDING'
  return (new Rsa).decrypt(pem_priv, enc_msg, padding, in_encoding)