Struct ClientBuilder 

pub struct ClientBuilder { /* private fields */ }

Used to configure, assemble and build Client

Implementations

impl ClientBuilder

pub fn with_module_inits(&mut self, module_inits: ClientModuleInitRegistry)

Replace module generator registry entirely

There has to be at least one module supporting being primary among the registered modules. The client won’t start without the federation and the client having at least one overlapping primary module. In case there are multiple, the one to use can be selected with ClientBuilder::with_primary_module_kind or ClientBuilder::with_primary_module_instance_id.

pub fn with_module<M: ClientModuleInit>(&mut self, module_init: M)

Make module generator available when reading the config

There has to be at least one module supporting being primary among the registered modules. The client won’t start without the federation and the client having at least one overlapping primary module. In case there are multiple, the one to use can be selected with ClientBuilder::with_primary_module_kind or ClientBuilder::with_primary_module_instance_id.

pub fn stopped(&mut self)

pub fn with_api_request_hook(self, hook: ApiRequestHook) -> Self

Build the Client with a custom wrapper around its api request logic

This is intended to be used by downstream applications, e.g. to:

• simulate offline mode,
• save battery when the OS indicates lack of connectivity,
• inject faults and delays for testing purposes,
• collect statistics and emit notifications.

pub fn with_primary_module(&mut self, primary_module_instance: ModuleInstanceId)

👎Deprecated since 0.6.0: Use with_primary_module_kind instead, as the instance id can’t be known upfront. If you really need the old behavior you can use with_primary_module_instance_id.

Uses this module with the given instance id as the primary module. See fedimint_client_module::ClientModule::supports_being_primary for more information.

Panics

If there was a primary module specified previously

pub fn with_primary_module_instance_id( &mut self, primary_module_instance: ModuleInstanceId, )

You are likely looking for ClientBuilder::with_primary_module_kind. This function is rarely useful and often dangerous, handle with care.

Uses this module with the given instance id as the primary module. See fedimint_client_module::ClientModule::supports_being_primary for more information. Since the module instance id of modules of a specific kind may differ between different federations it is generally not recommended to specify it, but rather to specify the module kind that should be used as primary. See ClientBuilder::with_primary_module_kind.

Panics

If there was a primary module specified previously

pub fn with_primary_module_kind(&mut self, primary_module_kind: ModuleKind)

Uses this module kind as the primary module if present in the config. See fedimint_client_module::ClientModule::supports_being_primary for more information.

Panics

If there was a primary module kind specified previously

pub fn with_meta_service(&mut self, meta_service: Arc<MetaService>)

pub fn db_no_decoders(&self) -> &Database

pub async fn load_existing_config(&self) -> Result<ClientConfig>

pub fn set_admin_creds(&mut self, creds: AdminCreds)

pub fn with_connector(&mut self, connector: Connector)

pub async fn preview(self, invite_code: &InviteCode) -> Result<ClientPreview>

pub async fn preview_with_existing_config( self, config: ClientConfig, api_secret: Option<String>, ) -> Result<ClientPreview>

Use Self::preview instead

pub async fn open(self, pre_root_secret: RootSecret) -> Result<ClientHandle>

pub fn get_event_log_transient_receiver(&self) -> Receiver<EventLogEntry>

Register to receiver all new transient (unpersisted) events