Homomorphine is a less stressful interface for various Homomorphic encryption libraries and algorithms/models. Its (ultimate) goal is to remove a complexity of using various homomorphic backends, try to do (semi)automated optimizations and noise management to reduce the implicit complexity of dealing with the homomorphic encryption and implementation of various models providing a simple API, as well as CLang extensions that can be used to easily bind different programming languages to homomorphine and associated libraries.
Currently supported aritmetic model backends are SEAL and HELib (warning: HELib support is currently partially broken). Homomorphine also supports boolean circuits models and it currently supports TFHE library.
Homomorphine provides a different interface for arithmetic (modular and approximate number) and boolean circuit models given the different nature of operations performed on ciphers (boolean vs. numeric arithmetic operations).
You will have to install at least one of currently supported backends (either SEAL, HELib, or TFHE) and you will have to have C++14 compatible compiler (i.e. GCC 8/9), basic Boost package(s) and CMake. On OS/X 10.14 and later you can use Homebrew to install these:
brew install gcc boost cmakeYou can compile and install homomorphine using following commands:
cd native
cmake .
make -j9
make installYou can run the test suit using ctest:
ctest --verbose
Depending on your operating system and already installed libraries, you might also need libcrypto and openssl libraries (and relevant dev packages) in order to compile
For running homomorphine as a service you will need cpprestsdk, otherwise service executable won't be compiled. You can run Homomorphine as a service using homomorphine-service command:
./homomorphine-service --config=./config/devel.jsoncurrently supported interface is only RESTFul HTTP interface (HTTPS is coming relatively soon) and configuration is relatively straightforward, i.e.:
{
"interfaces": {
"http":{
"host":"localhost",
"port":"20888",
"protocol":"http",
"backend":"seal"
}
}
}Homomorphine is not intended to be used as a service (this will be provided through the separate service that will be using Homomorphine-Go library), however, it can be practical at the times.
At the moment it's best to check the tests in the test folder for a basic usage, however, more examples are coming in near future. Documentation can be found in the ./native/docs folder.
Homomorphine is currently not ready for production use (it should be as of version 0.2.x).