Struct AppHandle 

pub struct AppHandle { /* private fields */ }

Implementations

impl AppHandle

pub async fn start() -> Result<Self>

pub async fn start_with_options( mode: NetworkMode, port: u16, master_key: Option<&[u8; 32]>, ) -> Result<Self>

pub async fn start_with_db(db: Db) -> Result<Self>

pub async fn start_with_db_and_options( db: Db, mode: NetworkMode, port: u16, ) -> Result<Self>

pub fn mode(&self) -> NetworkMode

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

pub fn fingerprint(&self) -> &str

pub fn peer_id(&self) -> PeerId

pub fn discovered_rooms(&self) -> Vec<DiscoveredRoom>

pub fn active_room_ids(&self) -> Vec<String>

pub fn active_room_info(&self, room_id: &str) -> Option<StoredRoom>

pub fn room_members(&self, room_id: &str) -> Vec<String>

pub fn room_messages( &self, room_id: &str, limit: i64, ) -> Result<Vec<StoredRoomMessage>>

pub fn search_room_messages( &self, room_id: &str, query: &str, limit: i64, ) -> Result<Vec<StoredRoomMessage>>

pub async fn start_room( &self, name: &str, encrypted: bool, passphrase: Option<&str>, ) -> Result<String>

Create a new room. Returns its room_id.

pub async fn join_room( &self, room_id: &str, passphrase: Option<&str>, ) -> Result<()>

Join an existing room. The room may come from a live announcement (preferred), our restorable set, or the DB directly — whichever has the freshest copy. For encrypted rooms passphrase is required.

pub async fn leave_room(&self, room_id: &str) -> Result<()>

pub async fn send_room_message(&self, room_id: &str, body: &str) -> Result<()>

pub async fn shutdown(&self)

pub async fn dial(&self, input: &str) -> Result<()>

Dial a peer by a user-entered address. Accepts:

• 1.2.3.4:9000
• [fe80::1]:9000
• /ip4/.../tcp/...[/p2p/<peer>] (raw multiaddr)

pub fn known_peers(&self) -> Vec<KnownPeerStatus>

pub async fn forget_peer(&self, address: &str) -> Result<()>

pub async fn redial(&self, address: &str) -> Result<()>

Re-dial a stored address — used by the lobby’s “reconnect” action.

pub async fn send_file(&self, room_id: &str, path: &Path) -> Result<String>

Send a local file to a room. Reads the file, optionally encrypts it for encrypted rooms, chunks it, broadcasts a FileOffer then each FileChunk. Returns the file_id once all chunks are queued.

pub async fn save_to_downloads( &self, room_id: &str, file_id: &str, ) -> Result<PathBuf>

Save a completed/ready attachment to the user’s Downloads folder. Decrypts encrypted attachments on the way out.

pub async fn cancel_transfer(&self, room_id: &str, file_id: &str) -> Result<()>

Drop any in-flight chunks and remove the attachment row.

pub fn open_saved(&self, room_id: &str, file_id: &str) -> Result<()>

Launch the system’s default opener on a saved file.

pub fn list_room_attachments( &self, room_id: &str, ) -> Result<Vec<StoredAttachment>>

pub fn set_member_verified( &self, room_id: &str, fingerprint: &str, verified: bool, ) -> Result<()>

Mark a peer’s fingerprint as verified in the given room. Used by the ^V verification modal after the user has compared the fingerprint out-of-band.

pub fn verified_fingerprints(&self, room_id: &str) -> Vec<String>

pub fn display_name(&self) -> Option<String>

pub fn set_display_name(&self, name: Option<&str>) -> Result<()>

pub fn lookup_member_display_name(&self, fingerprint: &str) -> Option<String>

Look up the display name we’ve seen for a peer in any room.

pub fn is_room_muted(&self, room_id: &str) -> bool

pub fn set_room_muted(&self, room_id: &str, muted: bool) -> Result<()>

pub async fn broadcast_typing(&self, room_id: &str)

Broadcast a “I’m typing” pulse to the given room. Caller is responsible for debouncing (don’t fire more than every ~500ms).

pub fn typers_in_room(&self, room_id: &str) -> Vec<String>

Returns the fingerprints of peers currently typing in room_id, pruning entries past their TTL.

pub async fn rotate_room( &self, room_id: &str, new_passphrase: &str, ) -> Result<()>

Rotate this room’s outbound Megolm session under a fresh passphrase. Broadcasts RotateRoomKey (so other members know to expect a new passphrase) and a fresh MemberAnnounce with the new wrapped session key. Old inbound sessions stay in storage for decrypting historic messages.

pub async fn accept_rotation( &self, room_id: &str, new_salt: &[u8], new_passphrase: &str, ) -> Result<()>

Used by the TUI when another member rotates a room we’re in. Derives the new key, updates our local state, and re-announces so the rotator can share their fresh outbound session with us.

Trait Implementations

impl Clone for AppHandle

fn clone(&self) -> AppHandle

Returns a duplicate of the value.

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

Performs copy-assignment from source.