Struct SynClient 

pub struct SynClient { /* private fields */ }

Unified RPC client with connection pooling

This is the central client that manages all outgoing RPC connections. Generated service clients use this pool rather than creating their own connections.

The underlying HTTP client (reqwest) automatically pools connections, so SynClient can be cloned cheaply and shared across the application.

Implementations

impl SynClient

pub fn new(gateway_url: impl Into<String>) -> Self

Create a new unified RPC client

Arguments

• gateway_url - URL of the gateway (e.g., “http://localhost:8080”)

Example

let client = SynClient::new("http://localhost:8080");

pub fn with_protobuf(gateway_url: impl Into<String>) -> Self

Create a client with protobuf encoding (more efficient)

pub fn with_mtls( gateway_url: impl Into<String>, cert_path: impl AsRef<Path>, key_path: impl AsRef<Path>, ca_cert_path: impl AsRef<Path>, ) -> Result<Self>

Create a client with mTLS authentication (production)

pub fn with_timeout(self, timeout: Duration) -> Self

Set the request timeout

pub async fn call( &self, interface: impl Into<InterfaceId>, method: impl Into<MethodId>, payload: Bytes, ) -> Result<Bytes>

Call a service method with raw bytes

Arguments

• interface - The interface name or ID
• method - The method name or ID
• payload - The request payload (serialized)

pub async fn call_json<TReq, TResp>( &self, interface: impl Into<InterfaceId>, method: impl Into<MethodId>, request: &TReq, ) -> Result<TResp>

where TReq: Serialize, TResp: DeserializeOwned,

Call with typed request and response (JSON serialization)

This is a convenience method for JSON-serializable types.

pub async fn call_proto<TReq, TResp>( &self, interface: impl Into<InterfaceId>, method: impl Into<MethodId>, request: &TReq, ) -> Result<TResp>

where TReq: Message, TResp: Message + Default,

Call with typed request and response (Protobuf serialization)

This is the efficient method for protobuf types. Generated service clients use this method.

pub fn gateway_url(&self) -> &str

Get the gateway URL

Trait Implementations

impl Clone for SynClient

fn clone(&self) -> SynClient

Returns a duplicate of the value.

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

Performs copy-assignment from source.