Struct ServerConfigurationHandle 

pub struct ServerConfigurationHandle { /* private fields */ }

The snapshot the client was built with, plus the latch a refresh may set.

Cloning shares both: every consumer sees the same latch the moment a refresh trips it.

Implementations

impl ServerConfigurationHandle

pub fn new(provider: Arc<dyn ConfigProvider>) -> Self

Hold one snapshot, with no zero left in its limits.

CFG-031 replaces a zero on the wire with the compiled default, but a snapshot an app builds in Rust and hands in through a ConfigProvider (CFG-033) never passes through that conversion, and a zero dimension would panic the chunks(limit) calls in xmtp_api (CFG-064). Every snapshot reaches a client through this constructor, so sanitizing here is what keeps the zero out of all three readers at once: this handle, the wrapper that chunks with it, and the transport.

pub fn restrict(&self, request: &mut SignatureRequest)

Bind a signature request to the chains this deployment accepts, before it is handed to the app (CFG-069, CFG-070).

pub fn configuration(&self) -> &ServerConfiguration

The snapshot. Fixed for the life of the client (CFG-030): a refresh rewrites the stored row, never this value.

pub fn commit_log_enabled(&self) -> bool

Whether this deployment keeps a commit log (CFG-068). Read at every write and read site, so a deployment that turns it off turns it off for every group this client touches.

pub fn latched(&self) -> Option<ConfigurationLatch>

The latched failure, if one has been observed.

pub fn check(&self) -> Result<(), ClientError>

Fail when a latch is set. Every call that reaches the network goes through here (CFG-051, CFG-061).

Trait Implementations

impl Clone for ServerConfigurationHandle

fn clone(&self) -> ServerConfigurationHandle

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ServerConfigurationHandle

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

Formats the value using the given formatter.

impl Default for ServerConfigurationHandle

fn default() -> Self

Returns the “default value” for a type.