Struct Config 

pub struct Config { /* private fields */ }

Configuration for an SDK gRPC client (shared by canton-ledger and canton-admin).

Implementations

impl Config

pub fn new(endpoint: impl Into<String>) -> Config

Create a configuration targeting endpoint, with no authentication and no retrying.

pub fn with_token(self, token: impl Into<String>) -> Config

Authenticate with a fixed bearer token.

pub fn with_oidc<T>(self, provider: T) -> Config

where T: TokenSource + 'static,

Authenticate with a dynamic token source (e.g. an OIDC provider with client-credentials and auto-refresh).

pub fn with_retry(self, retry: RetryConfig) -> Config

Enable retrying of unary calls on retriable errors, per retry.

pub fn with_tls(self, tls: TlsConfig) -> Config

Use TLS for the gRPC channel (server-side and, if configured, mutual).

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

Set the per-request timeout on the gRPC channel (default 30s). Long submitAndWait calls under load may need a higher bound.

pub fn endpoint(&self) -> &str

The gRPC endpoint of the target service, e.g. http://localhost:3901.

pub fn auth(&self) -> &Auth

The configured authentication mode.

pub fn retry(&self) -> Option<&RetryConfig>

The configured retry policy, if any.

pub fn connect_channel(&self) -> Result<Channel, Error>

Build a lazily-connected gRPC Channel for this configuration.

Returns immediately; the TCP/TLS handshake happens on the first RPC. TLS is applied when Config::with_tls was set or the endpoint is https; a with_tls endpoint given as http:// is normalised to https:// so TLS is never silently downgraded (see [resolve_endpoint]).

Errors

Returns Error::InvalidRequest if the endpoint URI or the TLS configuration is invalid.

Trait Implementations

impl Clone for Config

fn clone(&self) -> Config

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Config

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

Formats the value using the given formatter.