@keystonehq/hw-transport-webusb

Features

This NPM package provides the TransportWebUSB class, which handles WebUSB functionality in Keystone hardware wallets.

TransportWebUSB Class

The TransportWebUSB class takes a USB device and an optional configuration object during initialization.

The class offers two key static methods:

requestPermission

This asynchronous method requests user permission to access a USB device. It first verifies if the WebUSB API is supported in the current environment, then requests access to a USB device. After the device access permission is granted, it ensures the device is properly closed.

connect

This asynchronous method connects to a USB device. It checks for WebUSB API support in the current environment and retrieves a list of all USB devices that the application has permission to access. If multiple devices are available, the method prompts the user to select one. It then creates and returns a new TransportWebUSB instance using the selected device and the provided configuration.

TransportConfig

The TransportConfig object is an optional parameter during the initialization of the TransportWebUSB class. It enables developers to customize various settings related to the transport operation:

• endpoint: (Optional) Specifies the endpoint for the USB communication.
• timeout: (Optional) Determines the maximum duration (in milliseconds) that the transport operation should wait before timing out.
• maxPacketSize: (Optional) Defines the maximum packet size that the transport operation can handle.
• disconnectListener: (Optional) A function that is invoked when the USB device is disconnected. This function should accept a USBDevice object as an argument, representing the device that has been disconnected.

Additional Documentation

For more information, you can refer to the following documents:

• Transport Result Status Codes
• EAPDU Protocol Documentation