A P2P file transfer protocol
Go to file
Chlins Zhang d2005fa13c
docs: correct Value field size limit in README (#31)
Signed-off-by: chlins <chlins.zhang@gmail.com>
2025-07-09 12:12:54 +08:00
.github
benches
docs
src
tests
.gitignore
.markdownlint.yml
.typos.toml
Cargo.lock
Cargo.toml
LICENSE
README.md
rust-toolchain.toml

README.md

Vortex Protocol

LICENSE Discussions

Introduction

Vortex protocol is a high-performance peer-to-peer (P2P) file transfer protocol implementation in Rust, designed as part of the Dragonfly project. It utilizes the TLV (Tag-Length-Value) format for efficient and flexible data transmission, making it ideal for large-scale file distribution scenarios.

Features

  • Efficient TLV Protocol: Optimized for fast serialization and deserialization of data packets.
  • Large File Support: Handles piece sizes up to 1 GiB and value fields up to 4 GiB.
  • Memory Safety: Built in Rust with zero-cost abstractions and memory safety guarantees.
  • High Performance: Designed for high-throughput file transfer scenarios.
  • Extensible Design: Reserved tags for future protocol extensions like compression and encryption.

Documentation

For details, please see the specification.

Benchmarking

Vortex protocol includes comprehensive benchmarks for packet creation, serialization, and deserialization:

# Run all benchmarks
cargo bench

# Run specific benchmark group
cargo bench "Vortex Packet Creation"

The benchmarks cover various packet sizes:

  • Small packets (32 bytes)
  • Medium packets (1 KB)
  • Large packets (1 MB)
  • Extra large packets (16 MB)