https://github.com/systemslibrarian/crypto-lab-blind-oracle
Browser-based demo of fully homomorphic encryption — encrypt two numbers in your browser, a Rust/TFHE-rs server adds them homomorphically, returns the encrypted result. The server mathematically cannot read what it computed.
https://github.com/systemslibrarian/crypto-lab-blind-oracle
crypto-lab gate-bootstrapping homomorphic-encryption privacy-preserving-computation rust-wasm wasm-crypto webcrypto
Last synced: 1 day ago
JSON representation
Browser-based demo of fully homomorphic encryption — encrypt two numbers in your browser, a Rust/TFHE-rs server adds them homomorphically, returns the encrypted result. The server mathematically cannot read what it computed.
- Host: GitHub
- URL: https://github.com/systemslibrarian/crypto-lab-blind-oracle
- Owner: systemslibrarian
- Created: 2026-04-02T17:17:37.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2026-04-11T21:56:02.000Z (about 2 months ago)
- Last Synced: 2026-04-11T23:27:12.887Z (about 2 months ago)
- Topics: crypto-lab, gate-bootstrapping, homomorphic-encryption, privacy-preserving-computation, rust-wasm, wasm-crypto, webcrypto
- Language: TypeScript
- Homepage: https://systemslibrarian.github.io/crypto-lab-blind-oracle/
- Size: 14.7 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Blind Oracle
[Live Demo](https://systemslibrarian.github.io/crypto-lab-blind-oracle/) · [Backend API](https://github.com/systemslibrarian/blind-oracle-api)
## 1. What It Is
Blind Oracle is a browser-to-server demonstration of Fully Homomorphic Encryption using TFHE-rs and gate bootstrapping over encrypted FheUint8 values. The client encrypts two inputs, the server performs homomorphic addition, and the client decrypts the encrypted result locally. This solves the problem of outsourcing computation while keeping plaintext hidden from the compute provider. The security model is asymmetric homomorphic encryption (public evaluation key on the server, secret decryption key kept client-side), with post-quantum lattice-based foundations through TFHE.
## 2. When to Use It
- Use it when you must run arithmetic on sensitive values in an untrusted cloud because TFHE-rs lets the server compute directly on ciphertexts.
- Use it for privacy-preserving analytics proofs of concept because the wire payloads and server responses stay encrypted end to end.
- Use it for zero-trust multi-tenant compute experiments because the server key enables evaluation but not plaintext recovery.
- Do not use it for low-latency, high-throughput production paths where plaintext processing is acceptable because bootstrapping and large ciphertexts add substantial performance overhead.
## 3. Live Demo
Live demo: https://systemslibrarian.github.io/crypto-lab-blind-oracle/
You can enter two secret values in the 0-255 range, encrypt and transmit them, and trigger homomorphic addition on the oracle. The UI shows ciphertext previews, response time, the oracle log, and a modal showing what the oracle received without plaintext access. Controls include SECRET VALUE A, SECRET VALUE B, ENCRYPT & TRANSMIT, COMPUTE (FHE ADD), WHAT THE ORACLE SAW, and RESET.
## 4. How to Run Locally
```bash
git clone https://github.com/systemslibrarian/crypto-lab-blind-oracle.git
cd crypto-lab-blind-oracle
npm install
npm run dev
```
Set `VITE_API_URL` (for example in `.env.development`) to the backend API URL if it is not running at the default expected endpoint.
## 5. Part of the Crypto-Lab Suite
This demo is part of the broader Crypto-Lab collection at https://systemslibrarian.github.io/crypto-lab/.
Whether you eat or drink or whatever you do, do it all for the glory of God. — 1 Corinthians 10:31