Struct VCLPacket 

pub struct VCLPacket {
    pub version: u8,
    pub packet_type: PacketType,
    pub sequence: u64,
    pub prev_hash: Vec<u8>,
    pub nonce: [u8; 24],
    pub payload: Vec<u8>,
    pub signature: Vec<u8>,
}

A single unit of data transmission in VCL Protocol.

Packets are created, signed, and serialized internally by VCLConnection. After recv() returns, payload contains the decrypted data.

Fields

version: u8

Protocol version. Currently 2.

packet_type: PacketType

Routing type — see PacketType.

sequence: u64

Monotonically increasing sequence number (per direction).

prev_hash: Vec<u8>

SHA-256 hash of the previous packet in the same direction. All-zeros for the first packet.

nonce: [u8; 24]

24-byte XChaCha20 nonce used to encrypt this packet’s payload.

payload: Vec<u8>

After recv(): decrypted payload. On the wire: XChaCha20-Poly1305 ciphertext.

signature: Vec<u8>

64-byte Ed25519 signature over the packet hash.

Implementations

impl VCLPacket

pub fn new( sequence: u64, prev_hash: Vec<u8>, payload: Vec<u8>, nonce: [u8; 24], ) -> Self

Create a new PacketType::Data packet.

pub fn new_typed( sequence: u64, prev_hash: Vec<u8>, payload: Vec<u8>, nonce: [u8; 24], packet_type: PacketType, ) -> Self

Create a packet with a specific PacketType. Used internally for Ping, Pong, KeyRotation, and Fragment packets.

pub fn compute_hash(&self) -> Vec<u8>

Compute the SHA-256 hash of this packet. Used for chain linking and signature generation.

pub fn sign(&mut self, private_key: &[u8]) -> Result<(), VCLError>

Sign this packet with an Ed25519 private_key (32 bytes).

Errors

Returns VCLError::InvalidKey if private_key is not 32 bytes.

pub fn verify(&self, public_key: &[u8]) -> Result<bool, VCLError>

Verify the Ed25519 signature against public_key (32 bytes).

Returns Ok(true) if valid, Ok(false) if the signature does not match.

Errors

Returns VCLError::InvalidKey if public_key is malformed.

pub fn validate_chain(&self, expected_prev_hash: &[u8]) -> bool

Returns true if self.prev_hash matches expected_prev_hash.

pub fn serialize(&self) -> Vec<u8>

Serialize this packet to bytes using bincode.

pub fn deserialize(data: &[u8]) -> Result<Self, VCLError>

Deserialize a packet from bytes.

Errors

Returns VCLError::SerializationError if the bytes are malformed.

Trait Implementations

impl Clone for VCLPacket

fn clone(&self) -> VCLPacket

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for VCLPacket

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for VCLPacket

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for VCLPacket

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.