Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Sunscreen-tech/Sunscreen
A compiler for fully homomorphic encryption and zero knowledge proofs
https://github.com/Sunscreen-tech/Sunscreen
cryptography homomorphic-encryption zero-knowledge
Last synced: about 2 months ago
JSON representation
A compiler for fully homomorphic encryption and zero knowledge proofs
- Host: GitHub
- URL: https://github.com/Sunscreen-tech/Sunscreen
- Owner: Sunscreen-tech
- License: agpl-3.0
- Created: 2021-11-03T18:57:04.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2024-04-12T17:58:38.000Z (8 months ago)
- Last Synced: 2024-04-20T08:52:01.831Z (8 months ago)
- Topics: cryptography, homomorphic-encryption, zero-knowledge
- Language: Rust
- Homepage: https://docs.sunscreen.tech
- Size: 109 MB
- Stars: 219
- Watchers: 6
- Forks: 25
- Open Issues: 15
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-fhe - Sunscreen - Rust compiler for the BFV fully homomorphic encryption scheme. (Libraries / [Sunscreen](https://sunscreen.tech/))
- awesome-he - Sunscreen - Rust compiler for the BFV fully homomorphic encryption scheme. (Libraries)
README
[](https://github.com/Sunscreen-tech/Sunscreen/actions/workflows/rust.yml)
# Intro
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](https://playground.sunscreen.tech).
Extensive documentation can be found [here](https://docs.sunscreen.tech).
*WARNING!* This library is meant for experiments only. It has not been externally audited and is not intended for use in production.
# Set up
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 Rust
Install [Rustup](https://rustup.rs/) and follow the directions for your OS. We recommend stable Rust 1.58 or later.
## MacOS
```brew install cmake git```
## Linux
### Install prereqs
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 cmake```
## Windows
We recommend developing sunscreen on macOS or Linux, as Windows is really slow.
### Cmake
Install [cmake 3](https://github.com/Kitware/CMake/releases/download/v3.23.0-rc2/cmake-3.23.0-rc2-windows-x86_64.msi).
### Clang
Install [llvm+clang](https://github.com/llvm/llvm-project/releases/download/llvmorg-13.0.0/LLVM-13.0.0-win64.exe). 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%`.
### MSVC C++
Install the [MSVC C++ toolchain](https://aka.ms/vs/17/release/vs_BuildTools.exe)
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.
### Enable long file paths
Some of our compilation tests produce really long file paths. These tests will fail unless you [enable long file paths](https://www.howtogeek.com/266621/how-to-make-windows-10-accept-file-paths-over-260-characters/). TL;DR; run `regedit.exe`, set `HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\FileSystem` to `1` and reboot.
### git
Install [git](https://git-scm.com/download/win). Defaults are fine.
## Initialize submodules
```
git submodule update --init --recursive
```
# Dev workflows
Working with Sunscreen is as you'd expect with any other Rust repository:
## Build
```cargo build```
## Test
```cargo test --release```
## Docs
```cargo doc --open```
## Format
```cargo fmt```
## Debug
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.
# License
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.
# Contribute
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].