ptrs-gesher-core

Core traits and helpers for the ptrs-gesher pluggable transports framework.

This crate defines the transport-agnostic abstractions that every concrete transport (obfs4, webtunnel, etc.) implements:

• ClientTransport / ServerTransport -- connection-oriented trait pair that transforms an AsyncRead + AsyncWrite stream into an obfuscated tunnel.
• ClientBuilder / ServerBuilder -- configuration and construction of transport instances from key-value Args.
• PluggableTransport -- top-level trait tying builders and transports together.
• Args -- ordered multimap for PT parameters (cert=, iat-mode=, etc.).

Status

Version 0.3.0 -- not yet published to crates.io. Interface subject to change.

Example

use ptrs::{Args, ClientBuilder as _};
use obfs4;

let mut args = Args::new();
args.add("cert", "AAAA...");
args.add("iat-mode", "0");

let mut builder = obfs4::ClientBuilder::default();
builder.options(&args)?;
let client = builder.build();
// client.establish(...) or client.wrap(...) to create the tunnel.

Notes / Resources

• Pluggable Transport Specification (up to 3.0)
• PT Spec v1
• Extended ORPort
• Tor Extended ORPort Auth

License

Dual-licensed under either:

• Apache License, Version 2.0
• MIT license

at your option.