Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/blyssprivacy/sdk
SDK for private data access, built on homomorphic encryption.
https://github.com/blyssprivacy/sdk
homomorphic-encryption privacy private-information-retrieval
Last synced: 4 days ago
JSON representation
SDK for private data access, built on homomorphic encryption.
- Host: GitHub
- URL: https://github.com/blyssprivacy/sdk
- Owner: blyssprivacy
- License: mit
- Created: 2022-02-22T07:22:45.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-03-21T17:35:15.000Z (8 months ago)
- Last Synced: 2024-10-08T15:53:35.620Z (about 1 month ago)
- Topics: homomorphic-encryption, privacy, private-information-retrieval
- Language: Rust
- Homepage: https://blyss.dev
- Size: 982 KB
- Stars: 331
- Watchers: 9
- Forks: 18
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-privacy-engineering - blyss - Open-source SDK for accessing data privately using homomorphic encryption. (Awesome Privacy Engineering [](https://awesome.re) / Homomorphic Encryption)
- awesome-fhe - blyss - Rust FHE library specialized for private information retrieval. Includes bindings to JS & Python. (Libraries / [Sunscreen](https://sunscreen.tech/))
- awesome-he - blyss - Rust FHE library specialized for private information retrieval. Includes bindings to JS & Python. (Libraries)
README
Open-source SDK for accessing data privately using homomorphic encryption.
Docs |
Website |
Contact
The [Blyss SDK](https://blyss.dev) lets you use homomorphic encryption to [retrieve information privately](https://blintzbase.com/posts/pir-and-fhe-from-scratch/). With it, you can build new kinds of privacy-preserving services, like [private password breach checking](https://playground.blyss.dev/passwords/), [private nameserver resolution](https://sprl.it/), and even [private Wikipedia](https://spiralwiki.com/).
You can get an API key by [signing up](https://blyss.dev), or run a server locally. Detailed documentation is at [docs.blyss.dev](https://docs.blyss.dev).
> **Warning**
> The SDK has not yet been security reviewed, and the public Blyss service is still in beta. [Contact us](mailto:[email protected]) for access to a production-ready service.
## Quick start (cloud)
You can quickly try using the SDK with our managed service without downloading anything.
1. Get an API key by [signing up here](https://blyss.dev).
2. Open [this StackBlitz](https://stackblitz.com/edit/blyss-private-contact-intersection) and enter your API key where it says ``.
3. Try adding users to the service using the "Add a user" button. As you add more users, the service will _privately_ intersect each new users's contacts and the already existing users.
Every user's list of contacts stays completely private using homomorphic encryption: it never leaves their device unencrypted.
We also have [a simpler example using vanilla JS](https://codepen.io/blyssprivacy/pen/qByMJwr?editors=0010&layout=left).
## Quick start (local)
You can also use the Blyss SDK completely locally.
1. Clone this repo with `git clone [email protected]:blyssprivacy/sdk.git`.
2. Run the server by entering `lib/server` and running `cargo run --release`. The server will run on `localhost:8008` by default.
3. Run the client by entering `examples/node-local` and running `npx ts-node main.ts`. This will perform some writes and then a private read to your bucket.
## Install
### JavaScript / Node
To use the Blyss SDK in an existing TypeScript project, install it with `npm install @blyss/sdk`. Then, import the client with `import { Client } from '@blyss/sdk';`. If you're using SDK in Node, and prefer not to use ESM, you can instead import it as `const blyss = require('@blyss/sdk/node')`.
### Python
#### From PyPI:
`pip install --upgrade blyss`
#### From repo:
1. `cd python` from repo root.
2. `pip install --upgrade .`
## Examples
The `examples/` directory has several examples of how to use the Blyss SDK. Running the examples requires [an API key](https://blyss.dev).
### Browser
The browser example shows how to quickly start using the Blyss SDK from vanilla JavaScript. The `blyss-bundle.min.js` build output is a single-file JS bundle that binds the library to `window.blyss`. Including this is a fast way to get started, especially if you prefer to use vanilla JS.
1. Edit `examples/browser-simple/main.js` to use your API key.
2. Run a local HTTP server (we suggest [serve](https://github.com/vercel/serve)) in the repo root.
3. Go to `http://localhost:3000/examples/browser-simple/` in a browser.
### React
The React example shows how to use the Blyss SDK in modern client-side JS. It also implements a more complicated application: private contact intersection.
1. Enter `examples/react-complex`, and run `npm install`.
2. Edit `src/App.tsx` to use your API key.
3. Run `npm run start`.
### Node
The Node.js example shows how to use the Blyss SDK in server-side JS. Node 18+ is required.
1. Enter `examples/node`, and run `npm install`.
2. Edit `main.ts` to use your API key.
3. Run `ts-node main.ts`.
### Python
1. Install blyss.
2. Enter `examples/python`.
3. Run `python main.py`.
## Documentation
All documentation is available at [docs.blyss.dev](https://docs.blyss.dev). You can generate the docs by running `npm start` in `docs/`.
## Contributing
Please feel free to open issues and pull requests! For bugs, try to provide as much context as possible. We are also always open to documentation contributions.
## Building from source
### JavaScript / Node
1. Install Node with [nvm](https://github.com/nvm-sh/nvm#installing-and-updating), Rust with [rustup](https://rustup.rs/), and [wasm-pack](https://rustwasm.github.io/wasm-pack/installer/).
2. Run `npm install`.
3. Run `npm run build`.
This will build the complete SDK, including the core Rust libraries in `lib/spiral-rs` and `lib/doublepir`
### Python
Requires python 3.8+.
1. Run `pip install .` in `python`.
## Repository Map
The Blyss SDK is structured as:
1. `lib/`,
- `lib/server/`, a Rust project containing the open-source Blyss server.
- `lib/spiral-rs/`, a Rust crate containing the core cryptographic implementation of the [Spiral PIR scheme](https://eprint.iacr.org/2022/368).
- `lib/doublepir/`, a Rust crate containing the core cryptographic implementation of the [DoublePIR scheme](https://eprint.iacr.org/2022/949).
2. `js/`, the TypeScript code that implements the user-facing Blyss SDK.
- `js/bridge/`, a Rust "bridge" crate that exposes key functionality from `spiral-rs` and `doublepir` to the TypeScript code.
3. `python/`, the Python version of the SDK.
- `python/src/lib.rs`, another Rust "bridge" crate that exposes key functionality from `spiral-rs` to the Python code.
## License
MIT (see LICENSE.md)