Sunscreen is an ecosystem for building privacy-preserving applications using fully homomorphic encryption (and later on zero-knowledge proofs as well). Fully homomorphic encryption (FHE) is a special kind of encryption scheme that allows anyone to perform computations directly on encrypted data. Since it's quite hard to write FHE programs, we've created a "compiler" to make this process easier for developers.
If you'd like to try out our FHE compiler before downloading it, we offer a playground.
Extensive documentation can be found here.
WARNING! This library is meant for experiments only. It has not been externally audited and is not intended for use in production.
These directions cover the requirements for developing the sunscreen platform itself, which may be more than needed to merely consume it as a dependency. If you wish to develop an application using Sunscreen, see the installation.
Install Rustup and follow the directions for your OS. We recommend stable Rust 1.58 or later.
brew install cmake git
Using yum:
sudo yum install gcc gcc-c++ cmake3 openssl-devel clang git
Using apt:
sudo apt install build-essential clang cmake3 libssl-dev git
After installing prereqs, make a link to cmake3 named cmake
sudo ln /usr/bin/cmake3 <somwhere/under/$PATH/>cmake
We recommend developing sunscreen on macOS or Linux, as Windows is really slow.
Install cmake 3.
Install llvm+clang. In the installer, select the option to add LLVM to your %PATH%. If you forget to do check this option, add C:\Program Files\LLVM\bin to your %PATH%.
Install the MSVC C++ toolchain
When prompted for what to install, ensure you additionally check the Windows 10 SDK. You'll need to rerun the tool and modify your installation if you forget to do this.
Some of our compilation tests produce really long file paths. These tests will fail unless you enable long file paths. TL;DR; run regedit.exe, set HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\FileSystem to 1 and reboot.
Install git. Defaults are fine.
git submodule update --init --recursive
Working with Sunscreen is as you'd expect with any other Rust repository:
cargo build
cargo test --release
cargo doc --open
cargo fmt
We have a launch.json checked in that defines a bunch of debug configurations. In VSCode, you should see a bunch of dropdowns in the debug menu to debug the tests and examples.
This project is licensed under the terms of the GNU AGPLv3 license. If you require a different license for your application, please reach out to us.
Feel free to open up issues!
If you'd like to submit a pull request, you'll need to agree to a Contributor License Agreement. For more info, contact us at [email protected].
