Struct RelayContext 

pub struct RelayContext { /* private fields */ }

Relay connection context

This manages the state for a single relay connection, including:

• Key exchange state
• Encryption key
• Invoke ID counter

Implementations

impl RelayContext

pub fn new(target_did: String) -> Self

Create a new relay context

pub fn set_target_public_key(&mut self, public_key: Vec<u8>)

Set the target’s public key for signature verification

pub fn next_invoke_id(&self) -> u64

Get the next invoke ID

pub fn state(&self) -> &RelayState

Get current state

pub fn public_key_bytes(&self) -> [u8; 32]

Get our public key bytes

pub fn public_key_base64(&self) -> String

Get our public key as base64 (SubjectPublicKeyInfo DER, matching JS client)

pub fn create_key_exchange_request(&mut self, token: &str) -> InvokeRequest

Create the initial key exchange request

This is the first message sent on the Invoke stream.

pub fn process_key_exchange_response( &mut self, key_exchange: &InvokeRequestKeyExchange, ) -> Result<()>

Process the key exchange response

This verifies the signature and derives the shared encryption key.

pub fn encrypt(&self, plaintext: &[u8]) -> Result<(Vec<u8>, [u8; 16])>

Encrypt a payload for sending

pub fn decrypt(&self, ciphertext: &[u8], iv: &[u8]) -> Result<Vec<u8>>

Decrypt a received payload

pub fn create_encrypted_request( &self, invoke_id: u64, remote_response: &RemoteResponse, ) -> Result<InvokeRequest>

Create an encrypted InvokeRequest wrapping a RemoteResponse

Note: In the relay protocol, the client sends “responses” to the relay which forwards them to the target Volt (which treats them as requests).

pub fn parse_response( &mut self, response: &InvokeResponse, ) -> Result<Option<RemoteRequest>>

Parse an InvokeResponse and extract the RemoteRequest

Handles both key exchange responses and encrypted payload responses.

pub fn create_method_invoke( &self, invoke_id: u64, service_id: &str, method_name: &str, method_type: MethodType, request_data: Vec<u8>, ) -> RemoteResponse

Create a MethodInvoke payload for calling a service method

pub fn create_method_payload( &self, invoke_id: u64, payload: Vec<u8>, ) -> RemoteResponse

Create a MethodPayload for streaming data

pub fn create_method_end(&self, invoke_id: u64) -> RemoteResponse

Create a MethodEnd to signal end of stream

Trait Implementations

impl Debug for RelayContext

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

Formats the value using the given formatter.