#dragonfly #p2p #protocols

vortex-protocol

A P2P file transfer protocol

1 unstable release

new 0.1.0 Apr 16, 2025

#4 in #dragonfly

Download history 98/week @ 2025-04-11

98 downloads per month

Apache-2.0

35KB
606 lines

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)

Dependencies

~0.6–1.2MB
~23K SLoC