https://github.com/kayleexx/veil
https://github.com/kayleexx/veil
Last synced: 9 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/kayleexx/veil
- Owner: Kayleexx
- License: mit
- Created: 2025-09-07T16:08:29.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2025-09-08T17:00:10.000Z (9 months ago)
- Last Synced: 2025-09-08T18:09:55.485Z (9 months ago)
- Language: Rust
- Size: 32.2 KB
- Stars: 4
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Veil: Secure Multi-Party Computation & Encryption Framework
Veil is a Rust-based project that provides a **multi-purpose encryption and secret-sharing framework** with support for:
* AES encryption
* Hash-based encryption
* String reversal
* Shamir’s Secret Sharing for secure split/combine of secrets
* Multi-party computation (MPC) with secret aggregation over a network
It includes both **server** and **client** components with an interactive CLI.
---
## Table of Contents
* [Features](#features)
* [Installation](#installation)
* [Project Structure](#project-structure)
* [Usage](#usage)
* [Start Server](#start-server)
* [Start Client](#start-client)
* [Commands](#commands)
* [Examples](#examples)
* [Shamir’s Secret Sharing](#shamirs-secret-sharing)
* [MPC Aggregation](#mpc-aggregation)
* [License](#license)
---
## Features
* **Dynamic encryption selection:** `aes`, `hash`, `reverse`
* **Secret splitting & combining** using Shamir’s Secret Sharing
* **Multi-party secret aggregation** with XOR-based combination
* **Secure network communication** over TCP with random salts
* **Interactive CLI** for easy testing and experimentation
---
## Installation
1. Clone the repository:
```bash
git clone https://github.com/yourusername/veil.git
cd veil
```
2. Build the project:
```bash
cargo build --release
```
3. Run the project:
```bash
cargo run --release
```
> Requires Rust 1.70+ and the `tokio` async runtime.
---
## Project Structure
```
veil/
├── Cargo.toml
├── src/
│ ├── main.rs # CLI entry point
│ ├── network.rs # Server & Client networking logic
│ ├── mpc.rs # Multi-party computation & aggregation
│ ├── secret_sharing.rs# Shamir's Secret Sharing implementation
│ ├── aes.rs # AES encryption logic
│ ├── hash_and_reverse.rs # Hashing & string reversal encryptors
│ └── lib.rs
└── README.md
```
---
## Usage
### Start Server
```bash
cargo run --release
```
Server will ask:
```
Do you want to run as server/node or client?
```
Type `server` and provide an address:
```
127.0.0.1:7878
```
---
### Start Client
```bash
cargo run --release
```
Type `client` and provide server address:
```
127.0.0.1:7878
```
Then you can enter commands interactively.
---
### Commands
```
aes|text # AES encrypt 'text'
hash|text # Hash 'text'
reverse|text # Reverse 'text'
split|secret|k|n # Split 'secret' into n shares with threshold k
combine|share1,... # Combine shares into original secret
mpc|party1,party2|party1,party2 # Aggregate multiple parties' shares
```
---
## Examples
**AES Encryption:**
```
> aes|hello
Server response:
```
**Reverse Encryption:**
```
> reverse|hello
Server response: olleh
```
**Hash Encryption:**
```
> hash|hello
Server response:
```
**Secret Sharing (Split):**
```
> split|mysecret|3|5
Server response: 5 hex-encoded shares separated by commas
```
**Secret Sharing (Combine):**
```
> combine|share1,share2,share3
Server response: mysecret
```
**MPC Aggregation:**
```
> mpc|party1share1,party1share2|party2share1,party2share2
Server response:
```
---
## Shamir’s Secret Sharing
Veil uses Shamir’s Secret Sharing scheme to securely **split secrets into shares**:
* `k` = minimum threshold to reconstruct secret
* `n` = total number of shares
All shares are **hex encoded** for network transmission. Combining any `k` valid shares will reconstruct the original secret.
---
## MPC Aggregation
* Accepts multiple parties, each providing multiple shares
* Aggregates secrets using XOR across parties
* Returns a single **hex-encoded aggregated secret**
* Supports secure collaborative computation without revealing individual secrets
---
## Output
---
## License
MIT License.