README.md

Fully Homomorphic Encryption for Gophers 🍩

go-tfhe is the Golang implementation of TFHE Homomorphic Encryption Library

TFHE, or Fully Homomorphic Encryption Library over the Torus, is a scheme developed by Ilaria Chillotti et al, that implements a fast, fully bootstrapped circuit environment for running programs within the encrypted realm. ( for the uninitiated, a quick rundown of FHE is here )

Show me the Code

The following snippet is a simple fully homomorphic 8-bit integer circuit. As you can see, fully homomorphic encryption constructs and evaluates boolean circuits, just as traditional computing environments do. This allows developers to produce FHE programs using boolean logic gates.

1. To create a fully homomorphic addition circuit with go, start by creating a new module:

go mod init example.com/fhe-add (this package should be changed to whatever you want your package structure to look like)

2. Import go-tfhe library:

go get github.com/thedonutfactory/go-tfhe

3. Create main.go and add the following code:

package main

import (
	"fmt"
	"github.com/thedonutfactory/go-tfhe/gates"
)

func main() {
	// generate public and private keys
	ctx := gates.DefaultGateBootstrappingParameters(100)
	pub, prv := ctx.GenerateKeys()

	// encrypt 2 8-bit ciphertexts
	x := prv.Encrypt(int8(22))
	y := prv.Encrypt(int8(33))

	// perform homomorphic sum gate operations
	BITS := 8
	temp := ctx.Int(3)
	sum := ctx.Int(9)
	carry := ctx.Int2()
	for i := 0; i < BITS; i++ {
		//sumi = xi XOR yi XOR carry(i-1)
		temp[0] = pub.Xor(x[i], y[i]) // temp = xi XOR yi
		sum[i] = pub.Xor(temp[0], carry[0])

		// carry = (xi AND yi) XOR (carry(i-1) AND (xi XOR yi))
		temp[1] = pub.And(x[i], y[i])
		temp[2] = pub.And(carry[0], temp[0])
		carry[1] = pub.Xor(temp[1], temp[2])
		carry[0] = pub.Copy(carry[1])
	}
	sum[BITS] = pub.Copy(carry[0])

	// decrypt results
	z := prv.Decrypt(sum[:])
	fmt.Println("The sum of of x and y: ", z)
}

4a. Run the program directly with go run main.go or,

4b. Compile the FHE program with go build -o fhe-add main.go, which will create the executable file fhe-add.

FHE Illustrated - like literally illustrated, with cute gophers

In spite of strong advances in confidential computing technologies, critical information is encrypted only temporarily – while not in use – and remains unencrypted during computation in most present-day computing infrastructures. Fully homomorphic encryption addresses this flaw by providing a mechanism for computation on fully encrypted data.

For example, let's say that Bob owns a cloud processing company that crunches health datasets for Allan. Bob has access to cutting-edge bare metal machines with a lot of processing power and is happy to sell Allan that processing power. However, due to HIPAA compliance requirements ( and a general, altruistic respect for an individual's privacy ), Allan cannot actually share the data.

How do we solve this problem with today's cryptography? Well, we can encrypt the data over the wire, send it to Bob's cloud processing company, and then securely hand him the private key to decrypt, process and reencrypt the data. Again, this only provides protection while the data is in transit or at rest. During computation, the data must be decrypted first. This still allows Bob and any of his employees access to very sensitive, private health data of Allan's customers.

Enter fully homomorphic encryption. Using an FHE cryptographic runtime, Allan can build a special homomorphic software program designed to process his customer data. He gives this special program over to Bob, where he installs it onto one of his meaty servers. Now, here's the magic: Allan can fully encrypt all of his customer data, give it to Bob, who executes the homomorphic software program to process it (because he's now a clearly a wizard), returning to Allan the fully encrypted results, all without ever seeing any of his customer's data unencrypted! Allan decrypts the resulting data with the same key he used to encrypt it's inputs, knowing full well that his data was always safe, even when being processed on Bob's servers.

Homomorphic encryption means that the data is never decrypted, yet it is still able to be processed by a third party. Modern day cryptographic miracle.

FHE Workflow

So, if Allan writes a simple program to add two numbers and return the results, classically he would create something like this:

function add(int8 a, int8 b) {
  return a + b
}

So if he were outsource Bob to run the program function:

add(2, 3) it would result in 5

Simple, but Bob and his employees could see the input and output values of the function.

Now, if he used a fully homomorphic runtime environment, he would be able to first encrypt the values of a and b, pass these encrypted values to Bob, where he executes the homomorphic version of the same function giving back an encrypted result. For illustration purposes, the interaction might look something like this:

1. Allan encrypts a's value of 2 resulting in 1d8b4cf854c
2. Allan encrypts a's value of 3 resulting in 32c4feed996
3. Allan asks Bob to run the program function add(1d8b4cf854c, 32c4feed996). (To Bob, the numbers are encrypted nonsense)
4. Bob gets the result 489f719cad and returns it to Allan
5. Allan decrypts the result with her key revealing the number to be 5. At no point did Bob ever see Allan's input or output data, but he performed all of the processing for her. Magic.

Potential FHE Use Cases

• Private Cloud Computing on public Clouds ( FHE on AWS, Azure or GCP is secure )
• Distributed, trustless computing / MFA
• End to end encrypted blockchain smart contracts
• Trustless Voting

References

[CGGI19]: I. Chillotti, N. Gama, M. Georgieva, and M. Izabachène. TFHE: Fast Fully Homomorphic Encryption over the Torus. In Journal of Cryptology, volume 33, pages 34–91 (2020). PDF

[CGGI16]: I. Chillotti, N. Gama, M. Georgieva, and M. Izabachène. Faster fully homomorphic encryption: Bootstrapping in less than 0.1 seconds. In Asiacrypt 2016 (Best Paper), pages 3-33. PDF