https://github.com/itzmeanjan/chalametpir-demo
Demostration of using ChalametPIR - Keyword Private Information Retrieval
https://github.com/itzmeanjan/chalametpir-demo
chalametpir kwpir lwe-pir private-information-retrieval
Last synced: about 1 month ago
JSON representation
Demostration of using ChalametPIR - Keyword Private Information Retrieval
- Host: GitHub
- URL: https://github.com/itzmeanjan/chalametpir-demo
- Owner: itzmeanjan
- License: bsd-3-clause
- Created: 2025-03-08T09:15:22.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2025-07-11T06:05:54.000Z (3 months ago)
- Last Synced: 2025-07-11T10:04:43.755Z (3 months ago)
- Topics: chalametpir, kwpir, lwe-pir, private-information-retrieval
- Language: Rust
- Homepage:
- Size: 69.3 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# chalametpir-demo
Demostration of using ChalametPIR - Keyword Private Information Retrieval, the Rust Library Crate @ https://github.com/itzmeanjan/ChalametPIR.
## Introduction
This binary crate demonstrates usage of Keyword Private Information Retrieval using the [ChalametPIR](https://crates.io/crates/chalamet_pir) library crate. It showcases a client-server architecture where the client can query a database of key-value pairs without revealing the queried keyword to the server.
## Prerequisites
Rust stable toolchain; see https://rustup.rs for installation guide. MSRV for this crate is 1.85.0.
```bash
# While developing this demonstration, I was using
$ rustc --version
rustc 1.85.0 (4d91de4e4 2025-02-17)
```
## Running the Demo
1. Run the PIR server.
```bash
cargo run --profile optimized --bin server db/crypto.json
```
2. In a separate terminal window, run the PIR client.
```bash
cargo run --profile optimized --bin client
```
3. **Query the Database:** The client will prompt you to enter keywords. Type in a keyword present in your database and hit Enter. The client will then display the corresponding value. Type 'quit' to exit the client.
> [!NOTE]
> For fetching the value associated with the queried keyword, client first prepares a PIR query using its local hint database, which it downloaded from the PIR server, when setting up the PIR client. Then it attempts to decode the received PIR response from the PIR server. If you prompt it to fetch value associated with some key which is absent in the database, the client will not be able to decode the response. During this execution of the protocol, server will never learn which keyword was queried by the client.
https://github.com/user-attachments/assets/5e5a1f43-bb34-409b-889a-54fede133153