Struct DeviceManager 

pub struct DeviceManager { /* private fields */ }

A native device manager with CLI pairing and host-interaction prompts.

Remembers whether -p was given, since the selector only keeps the password when Trezor or KeepKey is built in.

Implementations

impl DeviceManager

pub fn password_given(&self) -> bool

Returns whether a password argument was supplied, including an empty one.

pub fn refuse_password( &self, device_type: DeviceType, ) -> Result<(), SelectError<NativeError>>

Rejects a supplied host password for BitBox02, which requires on-device entry.

Methods from Deref<Target = DeviceManager<NativeSource>>

pub async fn list( &self, ) -> Result<Vec<DeviceCandidate>, <S as DeviceSource>::Error>

Lists candidates using the selector, potentially probing emulators.

pub async fn open( &self, candidate: &DeviceCandidate, ) -> Result<Device, <S as DeviceSource>::Error>

Opens a candidate using the selector and configured callbacks.

pub async fn enumerate(&self) -> Result<DeviceScan, <S as DeviceSource>::Error>

Opens listed candidates without additional unlock or metadata requests.

Source-specific opening may still send wallet commands, such as native Specter’s fingerprint probe. Opening errors are collected in DeviceScan::skipped.

pub async fn select( &self, ) -> Result<(Option<Device>, Vec<SkippedDevice>), SelectError<<S as DeviceSource>::Error>>

Opens candidates and runs their unlock handshake until the optional fingerprint matches.

Successful Trezor or KeepKey initialization can leave the wallet PIN-locked. A common bhwi::common::ErrorKind::UserCancelled from unlock or fingerprint queries aborts selection. Without a fingerprint filter, any unlock failure is returned rather than silently selecting another wallet. Other failures are collected as skipped devices. Trezor and KeepKey device-side cancellations become authentication refusals and may be skipped when filtering by fingerprint.

pub async fn scan( &self, ) -> Result<DeviceScan, SelectError<<S as DeviceSource>::Error>>

Opens and probes candidates, caching information and initialized-wallet fingerprints.

A common bhwi::common::ErrorKind::UserCancelled from unlock or probe commands aborts the scan. Other per-device failures, including Trezor and KeepKey device-side cancellations mapped to authentication refusals, are collected as skipped devices.

pub async fn get_device_with_fingerprint( &self, ) -> Result<Option<Device>, SelectError<<S as DeviceSource>::Error>>

Selects a wallet, returning an error if all candidates were skipped.

With no fingerprint filter, the first successful unlock handshake is accepted; Trezor and KeepKey may still require a PIN. Uses the rules of Self::select.

pub async fn get_device_without_contacting( &self, ) -> Result<Option<Device>, SelectError<<S as DeviceSource>::Error>>

Returns the first usable candidate from Self::enumerate.

The manager makes no additional unlock or metadata request. Discovery and source-specific opening may still perform protocol I/O, including native Specter’s fingerprint probe.

Trait Implementations

impl AddressOutput for DeviceManager

fn get_address<'life0, 'async_trait>( &'life0 self, target: AddressTarget, ) -> Pin<Box<dyn Future<Output = Result<()>> + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Retrieves an address and prints it to stdout.

impl Deref for DeviceManager

type Target = DeviceManager<NativeSource>

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl DescriptorOutput for DeviceManager

fn get_keypool<'life0, 'async_trait>( &'life0 self, options: GetKeypoolOptions, format: Option<OutputFormat>, ) -> Pin<Box<dyn Future<Output = Result<()>> + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Derives and prints one ranged keypool descriptor.

fn get_pubkey_descriptors<'life0, 'async_trait>( &'life0 self, account: Option<u32>, format: Option<OutputFormat>, ) -> Pin<Box<dyn Future<Output = Result<()>> + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Derives and prints receive and change descriptors for supported address types.