Struct CreateFastCell 

pub struct CreateFastCell {
    pub circ_id: u32,
    pub key_material: [u8; 20],
    pub unused: Vec<u8>,
}

Circuit creation cell using fast handshake (no public key).

CREATE_FAST cells are used to create circuits with the first hop (guard) relay. This is faster than the full CREATE handshake because the TLS connection already authenticates the relay.

Security

CREATE_FAST does not provide forward secrecy because it doesn’t use public key cryptography. It relies on the TLS connection for security. For multi-hop circuits, subsequent hops should use CREATE2.

Wire Format

[ CircID ][ 5 (CREATE_FAST) ][ Key Material (20 bytes) ][ Padding ]

Example

use stem_rs::client::cell::CreateFastCell;

// Create with random key material
let cell = CreateFastCell::new(1);

Fields

circ_id: u32

Circuit ID for the new circuit.

key_material: [u8; 20]

Random key material (20 bytes) for key derivation.

unused: Vec<u8>

Unused padding bytes.

Implementations

impl CreateFastCell

pub fn new(circ_id: u32) -> Self

Creates a new CREATE_FAST cell with random key material.

Arguments

• circ_id - Circuit ID for the new circuit

pub fn with_key_material(circ_id: u32, key_material: [u8; 20]) -> Self

Creates a CREATE_FAST cell with specific key material.

Arguments

• circ_id - Circuit ID for the new circuit
• key_material - 20 bytes of key material

pub fn pack(&self, link_protocol: &LinkProtocol) -> Vec<u8>

Packs this cell into bytes for transmission.

pub fn unpack(payload: &[u8], circ_id: u32) -> Result<Self, Error>

Unpacks a CREATE_FAST cell from payload bytes.

Errors

Returns Error::Protocol if payload is too short for key material.

Trait Implementations

impl Clone for CreateFastCell

fn clone(&self) -> CreateFastCell

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CreateFastCell

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

Formats the value using the given formatter.

impl PartialEq for CreateFastCell

fn eq(&self, other: &CreateFastCell) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for CreateFastCell