quicsilver 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 5e879e4531621883da97721256a2b0db478ba995d8bf54c93ddf959fca9cd36d
+  data.tar.gz: 579023d40239d8c7a77671be44fb37265d735f864a13072887598406908c0aae
+SHA512:
+  metadata.gz: 25c070017404e15d673cfcb267ef90722dd255af0c68dd3488f1065ebe8fcc84614054b7ae3b5b0e2cd1bc74ca725a7ddd4e0500b80f849580ebef3306705443
+  data.tar.gz: 61f273afb32f2a45d07bc2f634a8f6d52973654b4e874ed01dd87a674126046f2e332741ca464b6f41a025e206064172a9614c602bb7285dab0b68b6efa7d09a

data/.gitignore

@@ -0,0 +1,12 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+/vendor/*
+/certs/*
+*.bundle
+lib/quicsilver/quicsilver.bundle

data/.gitmodules

@@ -0,0 +1,3 @@
+[submodule "vendor/msquic"]
+	path = vendor/msquic
+	url = https://github.com/microsoft/msquic.git

data/.ruby-version

@@ -0,0 +1 @@
+3.4.2

data/CHANGELOG.md

@@ -0,0 +1,22 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.0] - 2025-10-28
+
+### Added
+- Initial HTTP/3 server implementation using Microsoft MSQUIC
+- HTTP/3 client for testing and development
+- Rack support
+- HTTP/3 frame encoding/decoding (DATA, HEADERS, SETTINGS)
+- QPACK header compression (static table support)
+- Bidirectional request/response streams
+- Request body buffering for large payloads
+
+### Limitations
+This is still in prototype, it has the following known limitations:
+- No server push, GOAWAY, or trailer support
+- Limited error handling

data/Gemfile

@@ -0,0 +1,6 @@
+source "https://rubygems.org"
+
+git_source(:github) {|repo_name| "https://github.com/#{repo_name}" }
+
+# Specify your gem's dependencies in quicsilver.gemspec
+gemspec

data/Gemfile.lock

@@ -0,0 +1,28 @@
+PATH
+  remote: .
+  specs:
+    quicsilver (0.1.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    minitest (5.25.5)
+    rake (10.5.0)
+    rake-compiler (1.3.0)
+      rake
+    rake-compiler-dock (1.9.1)
+
+PLATFORMS
+  arm64-darwin-23
+  ruby
+
+DEPENDENCIES
+  bundler (~> 2.0)
+  minitest (~> 5.0)
+  quicsilver!
+  rake (~> 10.0)
+  rake-compiler (~> 1.2)
+  rake-compiler-dock (~> 1.3)
+
+BUNDLED WITH
+   2.6.5

data/README.md

@@ -0,0 +1,105 @@
+# Quicsilver
+
+HTTP/3 server for Ruby with Rack support.
+
+Disclaimer: currenly in early prototype.
+
+## Installation
+
+```bash
+git clone <repository>
+cd quicsilver
+bundle install
+rake compile
+```
+
+## Quick Start
+
+### 1. Set up certificates
+
+```bash
+bash examples/setup_certs.sh
+```
+
+### 2. Run a Rack app over HTTP/3
+
+```ruby
+require "quicsilver"
+
+# Define your Rack app
+app = ->(env) {
+  path = env['PATH_INFO']
+
+  case path
+  when '/'
+    [200, {'Content-Type' => 'text/plain'}, ["Hello HTTP/3!"]]
+  when '/api/users'
+    [200, {'Content-Type' => 'application/json'}, ['{"users": ["alice", "bob"]}']]
+  else
+    [404, {'Content-Type' => 'text/plain'}, ["Not Found"]]
+  end
+}
+
+# Start HTTP/3 server with Rack app
+server = Quicsilver::Server.new(4433, app: app)
+server.start
+server.wait_for_connections
+```
+
+### 3. Test with the client
+
+```bash
+ruby examples/minimal_http3_client.rb
+```
+
+## Usage
+
+### Rack HTTP/3 Server
+
+```ruby
+require "quicsilver"
+
+app = ->(env) {
+  [200, {'Content-Type' => 'text/html'}, ["<h1>Hello from HTTP/3!</h1>"]]
+}
+
+server = Quicsilver::Server.new(4433, app: app)
+server.start
+server.wait_for_connections
+```
+
+### HTTP/3 Client
+
+```ruby
+require "quicsilver"
+
+client = Quicsilver::Client.new("127.0.0.1", 4433, unsecure: true)
+client.connect
+
+# Send HTTP/3 request
+request = Quicsilver::HTTP3::RequestEncoder.new(
+  method: 'GET',
+  path: '/api/users',
+  authority: 'example.com'
+)
+client.send_data(request.encode)
+
+client.disconnect
+```
+
+## Development
+
+```bash
+# Run tests
+rake test
+
+# Build extension
+rake compile
+
+# Clean build artifacts
+rake clean
+```
+
+## License
+
+MIT License

data/Rakefile

@@ -0,0 +1,31 @@
+require "bundler/gem_tasks"
+require "rake/testtask"
+require "rake/extensiontask"
+
+Rake::ExtensionTask.new('quicsilver') do |ext|
+  ext.lib_dir = 'lib/quicsilver'
+end
+
+task :setup do
+  # Initialize git submodule if it doesn't exist
+  unless File.exist?('vendor/msquic')
+    sh 'git submodule add https://github.com/microsoft/msquic.git vendor/msquic'
+    sh 'cd vendor/msquic && git submodule update --init --recursive'
+  end
+end
+
+task :build_msquic => :setup do
+  # Build MSQUIC using CMake with proper macOS framework linking
+  sh 'cd vendor/msquic && cmake -B build -DCMAKE_BUILD_TYPE=Release -DCMAKE_EXE_LINKER_FLAGS="-framework CoreServices" -DCMAKE_SHARED_LINKER_FLAGS="-framework CoreServices"'
+  sh 'cd vendor/msquic && cmake --build build --config Release'
+end
+
+task :build => [:build_msquic, :compile]
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << "test"
+  t.libs << "lib"
+  t.test_files = FileList["test/**/*_test.rb"]
+end
+
+task :default => :test

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "quicsilver"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start(__FILE__)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/examples/README.md

@@ -0,0 +1,105 @@
+# Quicsilver Examples
+
+This directory contains examples for testing your Ruby QUIC implementation.
+
+## 🚀 Quick Start
+
+### 1. Generate Certificates
+
+```bash
+cd examples
+./setup_certs.sh
+```
+
+This creates the necessary certificate files in the `certs/` directory.
+
+### 2. Run the Server
+
+```bash
+# Terminal 1
+ruby examples/test_server.rb
+```
+
+### 3. Test the Connection
+
+```bash
+# Terminal 2  
+ruby examples/test_connection.rb
+```
+
+## 📁 Files
+
+| File | Purpose |
+|------|---------|
+| `setup_certs.sh` | Generate certificates for testing |
+| `test_server.rb` | Ruby QUIC server |
+| `test_connection.rb` | QUIC client test |
+
+## ✅ Expected Output
+
+**Server:**
+```
+🔥 Quicsilver QUIC Server Test
+════════════════════════════════════════
+📋 Server Info:
+   server_id: a47271c7ae4276d5
+   address: 127.0.0.1
+   port: 4433
+   running: false
+   cert_file: /path/to/certs/server.crt
+   key_file: /path/to/certs/server.key
+   max_connections: 100
+
+🚀 Starting QUIC server on 127.0.0.1:4433
+✅ QUIC server started successfully!
+   🔗 Listening for connections...
+🎯 Server is running! Press Ctrl+C to stop
+```
+
+**Client:**
+```
+🔗 Testing QUIC Connection to 127.0.0.1:4433...
+
+Connected to 127.0.0.1:4433
+✅ SUCCESS! Connected to QUIC server
+   🕐 Connection time: 13.5ms
+   📊 Connected status: true
+   📋 Connection info: {"connected" => true, "failed" => false, ...}
+
+🧪 Testing connection stability...
+   ⏱️  Tick 1: Connected = true
+   ⏱️  Tick 2: Connected = true  
+   ⏱️  Tick 3: Connected = true
+✅ Connection test completed!
+🔒 Connection closed cleanly
+```
+
+## 🔧 Manual Certificate Setup
+
+If you prefer to create certificates manually:
+
+```bash
+mkdir -p certs
+cd certs
+
+# Generate private key
+openssl genrsa -out server.key 2048
+
+# Generate certificate with proper QUIC extensions
+openssl req -new -x509 -key server.key -out server.crt -days 365 \
+  -subj "/CN=localhost/O=QuicsilverTest/C=US" \
+  -addext "subjectAltName=DNS:localhost,IP:127.0.0.1" \
+  -addext "extendedKeyUsage=serverAuth"
+```
+
+## 🐛 Troubleshooting
+
+**Port in use error:** The server automatically cleans up port 4433 before starting.
+
+**Connection refused:** Make sure the server is running before testing the client.
+
+**Certificate errors:** Run `./setup_certs.sh` to regenerate certificates with proper QUIC extensions.
+
+---
+
+That's it! No Docker, no external servers, just pure Ruby QUIC. 🎯 

data/examples/minimal_http3_client.rb

@@ -0,0 +1,89 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "quicsilver"
+
+puts "🔌 Minimal HTTP/3 Client Example"
+puts "=" * 40
+
+# Create client
+client = Quicsilver::Client.new("127.0.0.1", 4433, unsecure: true)
+
+puts "🔧 Connecting to server..."
+begin
+  client.connect
+  puts "✅ Connected successfully!"
+  puts "📋 Connection info: #{client.connection_info}"
+  
+  # HTTP/3 requests using RequestEncoder
+  require_relative '../lib/quicsilver/http3/request_encoder'
+
+  request1 = Quicsilver::HTTP3::RequestEncoder.new(
+    method: 'GET',
+    path: '/api/users',
+    authority: 'example.com'
+  )
+  client.send_data(request1.encode)
+
+  request2 = Quicsilver::HTTP3::RequestEncoder.new(
+    method: 'GET',
+    path: '/api/posts/123',
+    authority: 'example.com'
+  )
+  client.send_data(request2.encode)
+
+  request3 = Quicsilver::HTTP3::RequestEncoder.new(
+    method: 'POST',
+    path: '/api/messages',
+    authority: 'example.com',
+    body: '{"text":"Hello world"}'
+  )
+  client.send_data(request3.encode)
+
+  # JSON payloads (API requests) - now as proper HTTP/3 POST requests
+  request4 = Quicsilver::HTTP3::RequestEncoder.new(
+    method: 'POST',
+    path: '/api/subscribe',
+    authority: 'example.com',
+    headers: { 'content-type' => 'application/json' },
+    body: '{"action":"subscribe","channel":"orders"}'
+  )
+  client.send_data(request4.encode)
+
+  request5 = Quicsilver::HTTP3::RequestEncoder.new(
+    method: 'POST',
+    path: '/api/update',
+    authority: 'example.com',
+    headers: { 'content-type' => 'application/json' },
+    body: '{"action":"update","user_id":42,"status":"online"}'
+  )
+  client.send_data(request5.encode)
+
+  # These old manually-crafted requests use incorrect QPACK indices - removed
+
+  # Metrics/telemetry
+  # client.send_data("METRIC:cpu=45.2,mem=1024,ts=#{Time.now.to_i}")
+  # client.send_data("EVENT:login,user=alice,ip=192.168.1.100")
+  
+  # Large message test - now as HTTP/3 request
+  request8 = Quicsilver::HTTP3::RequestEncoder.new(
+    method: 'POST',
+    path: '/upload',
+    authority: 'example.com',
+    body: "X" * 50000  # 50KB
+  )
+  client.send_data(request8.encode)
+
+  # Keep connection alive for a bit
+  puts "⏳ Connection established. Press Enter to disconnect..."
+  gets
+  
+rescue Quicsilver::ConnectionError => e
+  puts "❌ Connection failed: #{e.message}"
+rescue Quicsilver::TimeoutError => e
+  puts "⏰ Connection timed out: #{e.message}"
+ensure
+  puts "🔌 Disconnecting..."
+  client.disconnect
+  puts "👋 Disconnected"
+end 

data/examples/minimal_http3_server.rb

@@ -0,0 +1,32 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "quicsilver"
+
+puts "🚀 Minimal HTTP/3 Server Example"
+puts "=" * 40
+
+# First, set up certificates if they don't exist
+unless File.exist?("certs/server.crt") && File.exist?("certs/server.key")
+  puts "📝 Setting up certificates..."
+  system("bash examples/setup_certs.sh")
+end
+
+# Create and start the server
+server = Quicsilver::Server.new(4433)
+
+puts "🔧 Starting server..."
+server.start
+
+puts "✅ Server is running on port 4433"
+puts "📋 Server info: #{server.server_info}"
+
+# Keep the server running
+puts "⏳ Server is running. Press Ctrl+C to stop..."
+begin
+  server.wait_for_connections
+rescue Interrupt
+  puts "\n🛑 Stopping server..."
+  server.stop
+  puts "👋 Server stopped"
+end 

data/examples/rack_http3_server.rb

@@ -0,0 +1,60 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "quicsilver"
+
+puts "🚀 Rack HTTP/3 Server Example"
+puts "=" * 40
+
+# First, set up certificates if they don't exist
+unless File.exist?("certs/server.crt") && File.exist?("certs/server.key")
+  puts "📝 Setting up certificates..."
+  system("bash examples/setup_certs.sh")
+end
+
+# Define a simple Rack app
+app = ->(env) {
+  path = env['PATH_INFO']
+  method = env['REQUEST_METHOD']
+
+  case path
+  when '/'
+    [200,
+     {'Content-Type' => 'text/plain'},
+     ["Welcome to Quicsilver HTTP/3!\n"]]
+  when '/api/users'
+    [200,
+     {'Content-Type' => 'application/json'},
+     ['{"users": ["alice", "bob", "charlie"]}']]
+  when '/api/status'
+    [200,
+     {'Content-Type' => 'application/json'},
+     ["{\"status\": \"ok\", \"method\": \"#{method}\", \"path\": \"#{path}\"}"]]
+  else
+    [404,
+     {'Content-Type' => 'text/plain'},
+     ["Not Found: #{path}\n"]]
+  end
+}
+
+# Create and start the server with the Rack app
+server = Quicsilver::Server.new(4433, app: app)
+
+puts "🔧 Starting server..."
+server.start
+
+puts "✅ Server is running on port 4433"
+puts "📋 Try these requests:"
+puts "   curl --http3 -k https://127.0.0.1:4433/"
+puts "   curl --http3 -k https://127.0.0.1:4433/api/users"
+puts "   curl --http3 -k https://127.0.0.1:4433/api/status"
+
+# Keep the server running
+puts "⏳ Server is running. Press Ctrl+C to stop..."
+begin
+  server.wait_for_connections
+rescue Interrupt
+  puts "\n🛑 Stopping server..."
+  server.stop
+  puts "👋 Server stopped"
+end

data/examples/setup_certs.sh

@@ -0,0 +1,57 @@
+#!/bin/bash
+
+# Quicsilver Certificate Setup
+# This script generates self-signed certificates for QUIC testing
+
+echo "🔐 Generating certificates for Quicsilver QUIC testing..."
+
+# Create certs directory if it doesn't exist
+mkdir -p ../certs
+cd ../certs
+
+# Create OpenSSL config with proper TLS server extensions
+cat > openssl.conf << 'EOF'
+[req]
+distinguished_name = req_distinguished_name
+req_extensions = v3_req
+prompt = no
+
+[req_distinguished_name]
+CN = localhost
+O = QuicsilverTest
+C = US
+
+[v3_req]
+keyUsage = keyEncipherment, dataEncipherment
+extendedKeyUsage = serverAuth
+subjectAltName = @alt_names
+
+[alt_names]
+DNS.1 = localhost
+IP.1 = 127.0.0.1
+EOF
+
+# Generate private key and certificate
+echo "📝 Generating private key..."
+openssl genrsa -out server.key 2048
+
+echo "📜 Generating certificate..."
+openssl req -new -x509 -key server.key -out server.crt -days 365 \
+  -config openssl.conf -extensions v3_req
+
+# Create PKCS#12 format (optional, for other tools)
+echo "📦 Creating PKCS#12 bundle..."
+openssl pkcs12 -export -out server.p12 -inkey server.key -in server.crt \
+  -passout pass:password -name "localhost"
+
+# Clean up
+rm openssl.conf
+
+echo "✅ Certificate files created:"
+echo "   📄 server.crt - Certificate file"
+echo "   🔑 server.key - Private key file"  
+echo "   📦 server.p12 - PKCS#12 bundle (password: 'password')"
+echo ""
+echo "🚀 You can now run:"
+echo "   Terminal 1: ruby examples/test_server.rb"
+echo "   Terminal 2: ruby examples/test_connection.rb"

data/ext/quicsilver/extconf.rb

@@ -0,0 +1,25 @@
+require 'mkmf'
+
+# Find MSQUIC in the submodule
+msquic_dir = File.expand_path('../../../vendor/msquic', __FILE__)
+
+# Add MSQUIC include directory
+$CFLAGS << " -I#{msquic_dir}/src/inc"
+$CFLAGS << " -I#{msquic_dir}/src/inc/public"
+
+# Add our fixes header
+$CFLAGS << " -I#{File.expand_path('.', __FILE__)}"
+
+# Add MSQUIC library directory
+lib_dir = "#{msquic_dir}/build/bin/Release"
+$LDFLAGS << " -L#{lib_dir}"
+
+# Set rpath so the extension can find the library at runtime
+$LDFLAGS << " -Wl,-rpath,#{lib_dir}"
+
+# Find the MSQUIC library
+unless find_library('msquic', nil, lib_dir)
+  raise "MSQUIC library not found. Please run 'rake build_msquic' first."
+end
+
+create_makefile('quicsilver/quicsilver')