Skip to main content

5.1 App Overview

The Tholos mobile app is used to create vaults and sign transactions + messages. Whereas, the Web Dashboard is used to view transactions, assets, and initate new transactions.

You can effectively think of the Tholos mobile app as a hardware wallet, such as a Ledger, and the Web Dashboard as a place to see the contents of the wallet. For example, Ledger has the Ledger Live application.

On the mobile app, you will first be directed to sign in with an account. Currently, you can sign in with a Google account or create an email/password combination. In the future we will add support for using an existing wallet like a MetaMask as your login to Tholos. The account is used to sync your data with the Web Dashboard.

Note: Your secret share is not stored on your Tholos account. You will have to enter your backup code to use your secret share on a new mobile device.

After you log in, and you have not yet created a vault, you can choose to either Create a Vault, Join Vault Lobby or Restore Vault.

Once you have created, joined, or restored a vault, you will only see an option to sign a transaction.

Create a Vault

  1. Enter the name of your vault, the number of vault owners, and the minimum number of people needed to sign a transaction (also known as the Threshold)
  2. Tholos will generate a Lobby ID. Send this Lobby ID to anyone you wish to be an owner of the vault. They will enter the Lobby ID in the Join Vault Lobby option on the Tholos home screen.
  3. Once you have sent everyone the Lobby ID, click Continue to join the waiting room. If you don't join the waiting room, the other owners won't be able to join.
  4. As soon as everyone has joined the Lobby, the vault will be automatically created. This will only take a few seconds. Do not close the app.
  5. You will then be asked to back up your vault with a file. Do not forget the password you use to encrypt your backup file, or you will not be able to recover the vault.
  6. Done! You have successfully created the vault and you can view your vault on the Web Dashboard

Join Vault Lobby

  1. Enter the Lobby ID you received from another vault owner.
  2. Click Join Lobby. You will enter the waiting room.
  3. As soon as everyone has joined the Lobby, the vault will be automatically created. This will only take a few seconds. Do not close the app.
  4. You will then be asked twice to back up your vault with a backup code. Copy the code and save it somewhere on your phone. You will not be able to recover your secret share without this code.
  5. Done! You have successfully created the vault and you can view your vault on the Web Dashboard

Restore Vault

  1. Click Import Backup File
  2. Enter the password for your backup file
  3. Done! You have recovered your vault and can sign transactions again.

Sign Transaction

  1. Enter the Lobby ID you received from the owner who initiated the transaction
  2. Click Join Lobby. You will enter the waiting room.