Connect to OneKey App via QR Code (Air-Gap)

This article provides a detailed guide on how you can effectively connect your OneKey Pro (an airgapped hardware wallet) to OneKey App, and how you can sign an transaction via QR codes. 

To ensure a successful connection between your OneKey Pro hardware wallet and App wallet, please make sure that the firmware on your OneKey Pro has been updated to the latest version.

Connect to OneKey App via QR Codes

The OneKey Pro provides a simple and secure method to connect to OneKey App using QR codes.

Step 1: Unlock OneKey Pro
  • Unlock your OneKey Pro device.
  • Swipe up to show apps.
Step 2: Get the QR Code
  • Choose "Connect App Wallet" from the screen.
  • Select "OneKey Wallet" and the QR code will be displayed.

Air gap - OneKey Wallet show qr code.png

Step 3: Add Hardware on OneKey App
  • Open OneKey App and unlock with password or biometrics.
  • Tap on the existing account name and choose "Add Wallet" - "Connect Hardware Wallet"
  • Choose "QR code".
  • Scan the QR code on your OneKey Pro to add. A OneKey Pro added via QR code will be marked with a QR logo in the device icon corner.Air gap OneKey App computer.pngAir gap OneKey App Phone.png

How does OneKey App interact with a hardware wallet in Air Gap mode?

Air Gap mode disables data transmission between app and hardware wallets via cable or bluetooth, leaving QR codes the only option. A summarized 3-step process:

  • A user creates a request on OneKey App (transactions, add account or view address). OneKey App generates a QR code, for OneKey Pro to read.
  • OneKey Pro scans and decodes the QR code on OneKey App, and later shows the user the request made from OneKey App for confirmation.
  • Once the action is confirmed on OneKey Pro, OneKey Pro will generate a QR code (contains confirmation message) for OneKey App to read and finish the request.

How to sign a transaction in Air Gap mode

Step 1: Create Transaction on OneKey App
  • Create a transaction on OneKey App and App will generate a transaction QR Code.Air gap create tx on App.png
Step 2: Scan with OneKey Pro and confirm
  • Unlock OneKey Pro and choose "Scan" to turn on OneKey Pro's camera.Air gap turn on OneKey Pro Scan.png
  • Scan the transaction QR code on OneKey App.Air Gap Pro scans App.png
  • Slide to confirm on OneKey Pro - OneKey Pro generates a confirmation QR Code.Air Gap Confirm Tx on OneKey Pro.png
Step 3: Scan with OneKey App and finish
  • Click "Next" on OneKey App, and scan the confirmation QR Code on OneKey Pro to finish.Air Gap App scan Pro to finish.png

Settings for AirGap Mode

AirGap Mode refers to a security measure where your OneKey Pro is completely isolated from other devices and networks. This isolation prevents any potential remote attacks trying to access your digital assets, disabling Bluetooth, USB, and NFC transfer function.

To enable AirGap Mode on your OneKey Pro, follow these steps:

  1. Unlock your OneKey Pro device and navigate to the "Settings" menu.
  2. Select "AirGap Mode" from the menu.
  3. Toggle on "Air Gap" to enable the AirGap Mode.
  4. You'll be asked to confirm your action. Tap on "Enable" to activate the AirGap Mode.
Currently only EVM and Bitcoin addresses are supported under AirGap Mode - switch off AirGap Mode and create a new connection via cable or bluetooth when you fail to create a non-EVM-or-BTC address(for example, Solana).
Was this article helpful?
0 out of 0 found this helpful