codec_sv2

codec_sv2 provides the message encoding and decoding functionality for the Stratum V2 (Sv2) protocol, handling secure communication between Sv2 roles. This crate abstracts the complexity of message encoding/decoding with optional Noise protocol support, ensuring both regular and encrypted messages can be serialized, transmitted, and decoded consistently and reliably.

Main Components

• Encoder: Encodes Sv2 messages with or without Noise protocol support.

• Decoder: Decodes Sv2 messages with or without Noise protocol support.

• Handshake State: Manages the current Noise protocol handshake state of the codec.

Usage

To include this crate in your project, run:

cargo add codec_sv2

This crate can be built with the following feature flags:

• noise_sv2: Enables support for Noise protocol encryption and decryption.
• with_buffer_pool: Enables buffer pooling for more efficient memory management.
• with_serde: builds binary_sv2 and buffer_sv2 crates with serde-based encoding and decoding. Note that this feature flag is only used for the Message Generator, and deprecated for any other kind of usage. It will likely be fully deprecated in the future.

Examples

This crate provides two examples demonstrating how to encode and decode Sv2 frames:

1. Unencrypted Example: Encode and decode standard Sv2 frames, detailing the message serialization and transmission process for unencrypted communications.

2. Encrypted Example: Encode and decode Sv2 frames with Noise protocol encryption, detailing the entire encryption handshake and transport phase and serialization and transmission process for encrypted communications.