Skip to main content

Secure offline setup of AirGap for Acurast

AirGap is a self-custody solution, developed by Papers AG, with a two-device approach:

  • Offline signer (AirGap Vault) holding the private keys
  • Online device running the Acurast Hub in a browser with a camera, to prepare and submit transactions

The Hub connects to AirGap Vault directly. Addresses and signing payloads are transported via QR codes. No other wallet app is needed.

info

The Hub used to connect to AirGap through the AirGap Wallet app. That connection is no longer supported. If you used it, connect AirGap Vault directly as described in step 4. Your Acurast address stays the same.

1. Make the offline phone ready and install AirGap Vault​

info

You can also download AirGap Vault from the Google Play or Apple App store and take the phone offline afterwards.

For the best possible security, follow the steps below.

  1. Get a new phone that will only be used for offline signing and never has a connection to the internet.
    • An Android phone is recommended.
    • Also get a fresh USB stick which you can connect to the phone.
  2. You don't need to log in to a Google Account, but you need to set a PIN code, pattern, fingerprint or face-id for your device.
  3. Start the phone and update it to the latest OS.
  4. Take the phone offline, remove all previous Wi-Fi connections (so it can't connect accidentally), and set it to Airplane Mode.
  5. Download the latest AirGap Vault APK from GitHub and move it to the USB stick.
  6. Plug it in and install the APK on your phone, give the necessary permissions.

2. Prepare the online device​

  1. On the online device (a phone or computer with a camera), open hub.acurast.com in a browser and allow camera access when asked.

3. Generate a new secret​

  1. Open the AirGap Vault app, skip through the initial messages and accept the disclaimer.
  2. Select the offline configuration and skip to the screen where you can generate a new secret.
  3. Select Generate and give permissions for camera and microphone.
  4. Go through the entropy generation process (touch, gyro, camera, mic).
  5. Write down the secret recovery seed phrase and store it according to best practices.
    • ❌ Do not store the seed phrase on an online device.
    • ❌ Do not store it in an online password manager.
  6. Verify the written-down recovery seed phrase.
  7. Set an encryption password and ensure you always remember it.
    • ✅ You may use a password manager here (but never store the seed in it).

4. Generate an Acurast account and connect it to the Hub​

  1. Add an Acurast account and confirm with your encryption password and the device PIN. A new Acurast address will be generated.
  2. In the Hub, click Connect Wallet and select AirGap Vault.
  3. In AirGap Vault, open the new Acurast account and tap the QR code icon to share its address, then hold the QR code in front of the online device's camera.
    • Only the account's public key is shared. The Hub now shows your Acurast address.
    • No camera on the online device? Choose Paste the QR code content instead in the Hub.

5. Verify the recovery​

  1. In AirGap Vault, go back to the main screen.
  2. Click on the card of the newly generated secret.
  3. Tap on the 3-dot menu → Secret management → scroll down and select Delete → Confirm Secret Removal.
    • The secret is now wiped from the offline phone.
  4. Go back to the main screen and select Import.
  5. Import the secret recovery phrase from your written notes.
  6. Set the same encryption password as before.
  7. Once done, generate an Acurast account.
  8. Compare the recovered account to the address the Hub showed in step 17.
    • ✅ If they match → recovery successful.
    • ❌ If not → delete and start again from step 10.

Signing transactions​

Whenever the Hub needs a signature, it shows a QR code with the request:

  1. Scan it with AirGap Vault, review the request in the vault and sign it.
  2. In the Hub, click Scan response and hold the signature QR code shown by AirGap Vault in front of the camera.

Before approving, compare the payload the Hub displays with the one AirGap Vault shows.

Important to know​

  1. The encryption password set in step 14 will determine the derived account.
    • If you forget it, recovery is impossible even with the seed phrase.
  2. Follow best practices when storing the seed phrase:
    • Example: metal plate in safe, paper note in safe, ensure you can identify the right seed.
  3. Do not store the encryption password in the same place as the recovery seed.
  4. More documentation: AirGap Support
  5. NEVER connect your offline phone to the internet.
    • If you must, first completely remove the secret from the phone.
  6. If you need to copy the account address, connect AirGap Vault to the Hub and copy it there.

Resources​