Cosigner onboarding
In the previous step, Bob used our application to create the wallet. The next step is to get Alice set up as a cosigner and to enable her to sign transactions. To do this Alice needs to:
- Import the wallet configuration to her app
- Activate the wallet on her BitBox, by importing the wallet configuration to the device
It’s important to understand that importing the wallet to the phone does not enable Alice to sign transactions yet. Her signing key is held on her BitBox, as we have covered on the wallet creation page. Both, the wallet app on her phone and the signing device need to know about the wallet configuration, so that they can work together to sign transactions.
Bob shares the wallet configuration with Alice #
The first step is to import the family savings wallet to Alice’s app. By tapping the “onboard cosigner” task, Bob can display a QR code that Alice scans to import the wallet configuration. Alternatively, Bob can share the configuration over a secure messaging channel if Alice is elsewhere.
The app also shows an option to view the wallet descriptor, which is a small piece of text that contains all the information that a wallet application needs to recover a multi-key wallet. We will cover this topic in more detail in the following chapter about the wallet backup.
Alice imports the wallet to her app #
Alice scans the QR code from Bob’s phone to import the wallet to her app. She reviews the final wallet configuration and hits “add wallet”.
After the wallet has been added, the app home screen shows the wallet, along with a task list that reminds her to:
- Save the wallet recovery kit
- Activate her signing device
Alice activates the wallet on her BitBox #
Alice taps on the reminder and imports the wallet configuration to the BitBox.
After Alice has successfully activated the wallet on her BitBox, Bob checks off the “Onboard cosigners” task on his end. For our application, this is a manual step, because it does not run a server that coordinates activity between the users. This adds a bit more friction to the user experience but minimizes reliance on the wallet provider.
While Alice was busy getting set up, Bob followed the same procedure to activate the wallet on his Trezor, as well as on the shared ColdCard, which they store in a safe location away from their home.
The wallet is ready #
The family savings wallet is now fully functional:
- Bob and Alice now have access to the shared wallet
- They can view the wallet and its balance in their respective apps
- Both can initiate and sign transactions using their respective devices
- Neither their children nor their lawyer have access to the wallet, as the wallet configuration has not been shared with them
On the next page we will look into how the couple backs up the wallet.