Skip to main content

Crate thalassa

Crate thalassa 

Source
Expand description

§Thalassa

Crates.io docs.rs

§Description

Implementation of the TLS presentation language data format defined in RFC8446. Mostly cares about what MLS (RFC9420) cares about, eventually we’ll cover the entirety of the spec to support other TLS-PL usecases (like, uh, TLS).

The killer feature compared to other crates is zero-copy deserialization, making it seriously fast, like up to 5TB/s fast on 1MB payloads.

This includes a derive proc macro heavily inspired by tls_codec, with a feature focus on discriminant related attributes - which I contributed to.

Compatible with WASM.

§Documentation

Here: https://docs.rs/thalassa

§Roadmap

  • Make E2E interop tests with tls_codec
  • Actually manage to benchmark the real performance? Despite my best efforts, I get numbers in the range of 500TB/s on deserialization, which absolutely doesn’t sound right.
  • “Distant variant” feature on the derive
    • This basically allows to de/serialize Rust enums as TLSPL variants, but allowing to use a discriminant not immediately preceding the variant contents, which is currently a requirement (as with tls_codec). This is extremely common in protocols making use of TLSPL, such as MLS, MIMI or keytrans.
    • Done! It’s been named #[tlspl(select)] and will be available in 0.0.2
  • Billion Laughs protection (recursion depth tracking)
  • Serde compat
  • Facet compat (maybe?) - NOPE. Not happening
  • Docs improvements, examples, etc

§AI Disclaimer

Unlike a lot of things being created currently, this library was written WITHOUT the use of any LLM.

§Acknowledgements

§License

Licensed under either of these:

Re-exports§

pub use parsio as io;

Modules§

error
types
util

Macros§

assert_untagged
Asserts that the target struct implements TlsplUntaggedEnum

Traits§

TlsplDeserialize
TlsplSerialize
TlsplSize

Derive Macros§

TlsplAllderive
TlsplDeserializederive
TlsplSerializederive
TlsplSizederive