Skip to content

Releases: ShibbityShwab/lightspeed

LightSpeed v0.3.0

20 Mar 00:48
@ShibbityShwab ShibbityShwab
v0.3.0
8e5eed1

Choose a tag to compare

View all tags
LightSpeed v0.3.0 Latest
Latest

What's New in v0.3.0

Assets 5
Loading

v0.2.0 — Beta Release: Live Infrastructure Verified

23 Feb 15:57
@ShibbityShwab ShibbityShwab
v0.2.0
312c6b8

Choose a tag to compare

View all tags
v0.2.0 — Beta Release: Live Infrastructure Verified

🚀 Beta Release — Live Infrastructure Verified

Loading

LightSpeed v0.1.0

22 Feb 14:59
@github-actions github-actions
v0.1.0
c702f5e

Choose a tag to compare

View all tags
LightSpeed v0.1.0

🎉 Initial MVP Release

The first release of LightSpeed — a zero-cost, open-source global network optimizer for multiplayer games.

Added

Client (lightspeed)

  • UDP Tunnel Engine — async packet relay with Tokio, keepalive, stats, and timeout handling
  • Tunnel Header Protocol — efficient 24-byte binary header with encode/decode, session tokens, sequence numbers
  • QUIC Control Plane — proxy discovery, health checks, and control messaging via quinn
  • Game Profiles — built-in configurations for Fortnite, CS2, and Dota 2 (port ranges, server IPs, anti-cheat info)
  • Route Selection Framework — nearest-proxy selector, multipath config, failover logic
  • ML Route Prediction Stubs — feature extraction, model loading, and prediction interfaces for linfa integration
  • Packet Capture Abstraction — cross-platform capture trait with platform-specific backends (Windows/Linux/macOS)
  • Configuration System — TOML-based config with CLI overrides via clap

Proxy Server (lightspeed-proxy)

  • UDP Relay Loop — high-performance session-based packet relay with concurrent client support
  • Session Management — token-based sessions with automatic timeout and cleanup
  • Rate Limiting — per-IP and per-session rate limiting with configurable thresholds
  • Abuse Detection — destination validation, amplification prevention, private IP blocking
  • Authentication — lightweight token-based client authentication
  • Metrics — Prometheus-compatible metrics endpoint (connections, packets, bytes, latency)
  • Health Endpoint — HTTP health check for monitoring and load balancing
  • QUIC Control Server — control plane for client discovery and health probing

Protocol (lightspeed-protocol)

  • Binary Header Format — 24-byte tunnel header: magic, version, flags, session token, sequence, timestamp, game ID, payload length
  • Control Messages — Protobuf-defined control protocol (Ping, Pong, Auth, RouteRequest, RouteResponse, HealthCheck)
  • Shared Types — common types used by both client and proxy

Documentation

  • Full architecture design (docs/architecture.md)
  • Protocol specification (docs/protocol.md)
  • Security audit report (docs/security-audit-mvp.md)
  • Integration test report (docs/test-report-mvp.md)

Testing

  • 52 tests total, 100% pass rate
  • End-to-end tunnel lifecycle tests
  • Concurrent client relay tests
  • Security integration tests (spoofed tokens, rate limiting, abuse detection)
  • Performance benchmarks (162μs tunnel overhead)

Security

  • Token-based session authentication
  • Per-IP and per-session rate limiting
  • Destination validation (blocks private IPs, localhost, multicast)
  • Amplification attack prevention
  • No Critical or High findings in security audit

Technical Details

  • Language: Rust (2021 edition)
  • Async Runtime: Tokio
  • Tunnel Protocol: Custom 24-byte UDP header, unencrypted for transparency
  • Control Plane: QUIC via quinn (feature-gated)
  • Target Overhead: ≤5ms (achieved: 162μs average)
  • Supported Platforms: Windows x64, Linux x64, Linux ARM64

Installation

Quick Install

  1. Download the archive for your platform below
  2. Extract it to a folder of your choice
  3. Run lightspeed --help to get started

Supported Platforms

Platform Archive
Windows x64 lightspeed-v0.1.0-windows-x64.zip
Linux x64 lightspeed-v0.1.0-linux-x64.tar.gz
Linux ARM64 lightspeed-v0.1.0-linux-arm64.tar.gz

Build from Source

git clone https://github.com/ShibbityShwab/lightspeed.git
cd lightspeed
cargo build --release
Loading