airgap-it / airgap-distro

Bootable live usb/cd linux distribution containing AirGap Vault.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

AirGap Vault Distribution

AirGap Vault Distribution can be started from a CDROM or an USB stick on a computer and being used to sign air gapped transactions. The AirGap Vault Distribution is the equivalent of the mobile version of AirGap Vault, use the mobile app AirGap Wallet to broadcast transactions.

Setup AirGap Vault Distribution

Copy AirGap Vault Distribution to a CDROM or USB stick

CDROM:
use your favorite program to burn the ISO to CDROM. Nothing special. CDROMs are naturally read-only and tamper resistant.

USB:
If you don't burn AirGap to a CDROM, writing AirGap Vault to a USB stick with a hardware read-write toggle (e.g., Kanguru FlashBlu) is the next best thing.

On USB sticks without write protection, you can remove the AirGap Vault USB after booting as an additional security measure. AirGap loads into RAM so after booting you no longer need the USB.

  1. Insert USB stick and detect the device path::
$ dmesg|grep Attached | tail --lines=1
[583494.891574] sd 19:0:0:0: [sdf] Attached SCSI removable disk
  1. Write ISO to USB::
$ sudo dd if=path/to/airgap.iso of=/dev/sdf
$ lsblk | grep sdf
sdf                                8:80   1   7.4G  1 disk  
└─sdf1                             8:81   1   444M  1 part 

How to build from source

AirGap is built with Vagrant

  1. Install Vagrant
$ git clone https://github.com/airgap-it/airgap-distro.git 
$ cd airgap-distro
$ vagrant up --provision # build the distro, will be in /tmp/airgap-vault-distro.iso
$ vagrant ssh-config 
$ scp -i .vagrant/machines/default/virtualbox/private_key -P 2222 vagrant@127.0.0.1:/tmp/airgap-vault-distro.iso .

How to create and sign transactions

  1. Import your mnemonic phrase or generate a new one
  2. Add a new wallet ex. Ethereum with the standard or your desired derivation path
  3. Sync the wallet address over QR with your AirGap Wallet app
  4. Create a new transaction within the AirGap Wallet app
  5. Scan the transaction QR code with the AirGap Vault Distribution
  6. Sign the transaction within AirGap Vault Distribution
  7. Scan the signed transaction QR code with AirGap Wallet
  8. Confirm and broadcast the transaction with AirGap Wallet

Credits

This project was inspired by BitKey. The distribution as well as this readme have been created based on their work.

About

Bootable live usb/cd linux distribution containing AirGap Vault.


Languages

Language:Shell 100.0%