hcrypt

Fully homomorphic encryption implementation for node.js

This package provides an API for node.js application to use homomorphic encryption to perform some computations.

Only integers are currently supported.

Operations supported: algebraic addition and multiplication.

Prerequisites

You must have GMP (5.0.0+ or MPIR 2.6.0+) and MPFR (3.0.0+) libraries installed in the system. Also, build tools are required for the native addon.

For Debian-based: sudo apt-get install libgmp-dev libmpfr-dev libmpfr4 gcc g++ automake autoconf

For RHEL-based: sudo yum install gmp mpfr gcc gcc-c++ automake autoconf, but note that gmp and mpfr versions in the repo are outdated so you should just compile them from sources.

On Windows you can use cygwin, just don't forget to set GMP and MPFR to devel while installing.

This package should work with latest stable npm and node, but may also work with any below. If you run into any problems while installing be sure to udpate npm first.

MPFR: http://www.mpfr.org/mpfr-current/#download GMP: https://gmplib.org/#DOWNLOAD

To Install

npm install node-hcrypt

The installation may take a while.

API

The module exports two main object types: Crypto and Operator. Crypto provides with encrypting / decrypting functionality while Operator deals with the operations on encrypted data. Module also exports helpers for converting any arbitrary numbers and performing operations with them, but they will be integrated into the mentioned above object types soon.

Crypto

var hcrypt = require('node-hcrypt');

var crypto = new hcrypt.Crypto();

Methods

| Method | Description | | ---- | ----- | | encrypt(int bit):string | Encrypts 1 or 0. Returns encrypted value as a base64 string. | | decrypt(string encrypted):int | Decrypts. Returns 1 or 0. | | export():object | Returns public key for use with Operator. |

Operator

var hcrypt = require('node-hcrypt');

var crypto = new hcrypt.Crypto();

var operator = new hcrypt.Operator(crypto.export());

Methods

| Method | Description | | ---- | ----- | | add(string encryptedA, string encryptedB):string encryptedC | Performs logical addition. | | mul(string encryptedA, string encryptedB):string encryptedC | Performs logical multiplication. | | halfAdd(string encryptedA, string encryptedB):[string encryptedC, string carryD] | Performs half-addition with carry in return. | | fullAdd(string carryI, string encryptedA, string encryptedB):[string encryptedC, string carryD] | Performs full addition with a carry in return. | | recrypt(string encryptedI):string encryptedO | Performs cryptographic refresh. Should be done after 2-3 operations under the same encrypted value. |

Tests

WIP

License

MIT