Connection API

How your app reaches the device: pick a transport, follow the connection and signing lifecycle, and release the popup when the flow ends. The connection is lazy — the transport (and the popup) is created on the first request method (info, getDeviceInfo, setLabel, an Account API method or sign()), so these setters are cached and applied on connect.

setTransport

Selects how the connector reaches the device — over WebHID or Bluetooth, with no native helper to install.

setConnectionListener

Registers a callback that fires whenever the connection state changes. The callback receives two independent axes: the popup axis (is the bridge window alive?) and the device axis (is a hardware wallet attached?). Use it to drive connection UI (spinner, connected badge, "please reconnect your device" prompt).

setSignProgressListener

Registers a callback that fires once per device signature while a Cardano transaction is signed through the CBOR signer (txCbor and the structured operations that use the same signer) — up to three for CIP-95 governance / voting. A one-signature transaction still sends a single { step: 1, total: 1 }. Use it to show "1 of 2" progress instead of a frozen spinner.

setTimeOutMs

Sets the request timeout, in milliseconds, for transport-level operations.

popupWindowClose

Closes the bridge popup and releases the active transport. Call when your flow ends or to force-release a stuck popup.