UKey Wallet Getting Started
Welcome to UKey hardware wallet. To ensure that your digital asset management environment meets security requirements and ensure stable communication between UKey hardware devices and terminals, please confirm the following official environment compatibility requirements before deploying the client.
1. desktop operating environment
UKey Wallet desktop client supports multiple platforms natively. Please confirm that your operating system meets the following minimum version requirements:
operating system | Minimum system requirements | Recommended system requirements | Architecture description |
macOS | 10.15 Catalina | 13 Ventura and above | Natively compatible with Intel and Apple Silicon (M1/M2/M3) chips |
Windows | Windows 10 (version 1809) | Windows 11 | It is recommended to use standard x86/x64 architecture processor |
Linux | Ubuntu 18.04 / Debian 10 / Fedora 32 / RHEL 8 | Ubuntu 22.04 LTS and above | Compatible with major distributions |
2. mobile operating environment
operating system | Minimum system requirements | Recommended system requirements |
iOS / iPadOS | iOS 15.5 | iOS 17 and above |
Android | Android 7.0 | Android 13 and above |
UKey official security policy statement:
In order to prevent the underlying system Permissions from being abused and leaking critical data (such as private key cache), UKey Wallet will conduct strict running environment detection. This application is prohibited from running on jailbroken iOS devices or rooted Android devices. Attempting to force a run may trigger the security lock mechanism or cause the application to terminate abnormally.
3. browser extension and WebUSB hardware communication support
When interacting with DApp through web pages or browser extension, UKey hardware needs to rely on the browser's WebUSB API to establish a secure HTTPS direct data channel. Since major browser manufacturers have different support strategies for the underlying API, please refer to the following compatibility matrix:
3.1 Officially recommended and supported browsers (Chromium kernel)
Google Chrome:Fully supported (version 61 and above)
Microsoft Edge:Fully supported (version 79 and above)
Official advice:Please always update your browser to the latest version to get the latest security patches.
3.2 Unsupported browser (unable to call hardware API)
Due to kernel limitations, the following browsers cannot recognize and connect to UKey hardware devices. Please avoid using them for hardware interaction:
Firefox
Safari
Opera
Samsung Internet
QQ Browser
Internet Explorer (IE)
UC Browser(⚠️ Known risks:Calling hardware interfaces in the UC Browser environment may cause the browser process to crash abnormally. )
3.3 mobile Web interaction limitations
Android environment:WebUSB hardware communication can work normally using Chromium kernel browser (such as mobile Chrome/Edge) on Android.
iOS environment (restricted):Due to the official underlying security policy of Apple, all web browsers on the iOS platform (including Chrome and iOS version of Edge) do not support the WebUSB interface. iOS users who need to manage assets and sign transaction must use the official UKey App directly. Do not attempt to connect the hardware via the iOS mobile browser.
4. Physical interface and device communication specifications
To ensure that the hardware device can transmit cryptographic signature instructions to the client stably and securely, please confirm the following physical connection conditions:
Wired connection:Please use the original USB-A or USB-C data cable that came with the device and connect directly to the computer motherboard port. It is not recommended to use third-party low-quality USB hubs or docks to avoid data packet loss due to unstable power supply voltage or signal attenuation.
mobile communication:
Direct wired connection:Android The mobile phone must be in the system SettingsEnabled OTG data transmission function.
Wireless connection:Please confirm that the mobile device has Enabled Bluetooth and has granted the UKey App the necessary Bluetooth communication to Permissions.
5. System resource reservation
To ensure smooth client deployment, secure storage of local encrypted data, and future OTA firmware updates of UKey hardware, it is recommended that terminal devices reserve at least 500 MB Available disk space.