Struct DaemonHandle 

pub struct DaemonHandle { /* private fields */ }

A lightweight handle to the daemon’s shared state.

This is the primary way for components, gRPC services, and spawned tasks to interact with the daemon. It provides access to:

• Event emission and subscription
• Configuration (settings, encryption key)
• Database handles

The handle is cheaply cloneable (wraps an Arc) and can be freely passed around to any code that needs daemon access.

Example

// Emit an event
handle.emit(DaemonEvent::HistoryPruned);

// Access settings
let settings = handle.settings().await;
let sync_freq = settings.daemon.sync_frequency;

// Access database
let history = handle.history_db().load(id).await?;

Implementations

impl DaemonHandle

pub fn emit(&self, event: DaemonEvent)

Emit an event to the daemon’s event bus.

This is fire-and-forget - if no receivers are listening (which shouldn’t happen in normal operation), the event is dropped silently.

pub fn subscribe(&self) -> Receiver<DaemonEvent>

Subscribe to the event bus.

Returns a receiver that will receive all events emitted after this call. Useful for components that need to listen for events outside of the normal handle_event callback flow.

pub fn shutdown(&self)

Request graceful shutdown of the daemon.

pub async fn settings(&self) -> RwLockReadGuard<'_, Settings>

Get the current settings.

This acquires a read lock on the settings. For most use cases, clone the settings if you need to hold onto them.

pub async fn reload_settings(&self) -> Result<()>

Reload settings from disk and emit a SettingsReloaded event.

Components listening for SettingsReloaded can then re-read settings via handle.settings() to pick up the changes.

pub async fn apply_settings(&self, settings: Settings)

Apply already-loaded settings and emit a SettingsReloaded event.

Use this when settings have already been loaded (e.g., from a file watcher) to avoid parsing the config file twice.

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

Get the encryption key.

pub fn history_db(&self) -> &HistoryDatabase

Get a reference to the history database.

pub fn store(&self) -> &SqliteStore

Get a reference to the record store.

Trait Implementations

impl Clone for DaemonHandle

fn clone(&self) -> DaemonHandle

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DaemonHandle

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

Formats the value using the given formatter.