{"id":50487053,"url":"https://github.com/systemslibrarian/crypto-lab-blind-oracle-api","last_synced_at":"2026-06-01T23:03:36.822Z","repository":{"id":348786321,"uuid":"1199758542","full_name":"systemslibrarian/crypto-lab-blind-oracle-api","owner":"systemslibrarian","description":"Browser-based Rust + Axum + TFHE-rs backend for crypto-lab-blind-oracle — gate-bootstrapped homomorphic addition on FheUint8 ciphertexts. Holds only a ServerKey. Cannot decrypt its own output.","archived":false,"fork":false,"pushed_at":"2026-04-11T21:55:31.000Z","size":23,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-11T23:27:15.994Z","etag":null,"topics":["axum","crypto-lab","cryptography","fhe","homomorphic-encryption","privacy","rust","tfhe","webassembly"],"latest_commit_sha":null,"homepage":"https://systemslibrarian.github.io/blind-oracle/","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/systemslibrarian.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-02T17:18:06.000Z","updated_at":"2026-04-11T21:55:34.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/systemslibrarian/crypto-lab-blind-oracle-api","commit_stats":null,"previous_names":["systemslibrarian/blind-oracle-api","systemslibrarian/crypto-lab-blind-oracle-api"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/systemslibrarian/crypto-lab-blind-oracle-api","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/systemslibrarian%2Fcrypto-lab-blind-oracle-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/systemslibrarian%2Fcrypto-lab-blind-oracle-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/systemslibrarian%2Fcrypto-lab-blind-oracle-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/systemslibrarian%2Fcrypto-lab-blind-oracle-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/systemslibrarian","download_url":"https://codeload.github.com/systemslibrarian/crypto-lab-blind-oracle-api/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/systemslibrarian%2Fcrypto-lab-blind-oracle-api/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33797128,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-01T02:00:06.963Z","response_time":115,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["axum","crypto-lab","cryptography","fhe","homomorphic-encryption","privacy","rust","tfhe","webassembly"],"created_at":"2026-06-01T23:03:34.979Z","updated_at":"2026-06-01T23:03:36.816Z","avatar_url":"https://github.com/systemslibrarian.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# blind-oracle-api\n\n## What It Is\n\nBlind Oracle API is a Rust back-end that performs fully homomorphic encrypted addition on `FheUint8` ciphertexts using [TFHE-rs](https://github.com/zama-ai/tfhe-rs). The server receives a `ServerKey` (evaluation key) and two encrypted 8-bit integers from the browser client, computes their homomorphic sum via gate bootstrapping, and returns the encrypted result — without ever accessing plaintext. TFHE is a lattice-based FHE scheme with post-quantum security assumptions; the `ClientKey` never leaves the browser, making the server a blind oracle that processes ciphertexts it cannot decrypt.\n\n## When to Use It\n\n- **Privacy-preserving server-side computation** — when a client needs a server to compute on its data without revealing the inputs or outputs.\n- **Demonstrating FHE gate bootstrapping** — each `FheUint8` operation resets the noise budget automatically, enabling unlimited computation depth with no manual noise management.\n- **Blind oracle pattern** — when the trust model requires the server to hold only an evaluation key and never possess decryption capability.\n- **Post-quantum secure computation** — TFHE's lattice-based hardness assumption is believed to resist quantum attacks, unlike RSA or ECC.\n- **Not suitable for high-throughput or low-latency workloads** — a single `FheUint8` addition takes 100 ms–2 s; use conventional encryption or MPC when sub-millisecond latency is required.\n\n## Live Demo\n\nThis API is the back-end for the Blind Oracle experiment at [systemslibrarian.github.io/crypto-lab/](https://systemslibrarian.github.io/crypto-lab/). The browser generates a TFHE key pair, encrypts two 8-bit integers, sends the ciphertexts and `ServerKey` to this API, and decrypts the homomorphic sum locally. The user can enter any two numbers (0–255) and verify that the server returns the correct encrypted result without ever seeing plaintext.\n\n## How to Run Locally\n\n```bash\ngit clone https://github.com/systemslibrarian/crypto-lab-blind-oracle-api.git\ncd crypto-lab-blind-oracle-api\ncargo build --release\ncargo run --release\n```\n\nThe server listens on port `3001` by default. Set the `PORT` environment variable to override:\n\n```bash\nPORT=8080 cargo run --release\n```\n\n\u003e **Note:** TFHE-rs is a large cryptographic library. First build takes 5–10 minutes; subsequent builds are incremental.\n\n## Part of the Crypto-Lab Suite\n\nThis API is one component of the [Crypto-Lab](https://systemslibrarian.github.io/crypto-lab/) suite of cryptographic demonstrations.\n\n---\n\n\u003e *Whether you eat or drink or whatever you do, do it all for the glory of God.* — 1 Corinthians 10:31\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsystemslibrarian%2Fcrypto-lab-blind-oracle-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsystemslibrarian%2Fcrypto-lab-blind-oracle-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsystemslibrarian%2Fcrypto-lab-blind-oracle-api/lists"}