From 16ad39b0953e5aefd22221f6d8318af8fcb41dd8 Mon Sep 17 00:00:00 2001 From: Daniel Nordh <3393669+danielnordh@users.noreply.github.com> Date: Thu, 14 Oct 2021 10:24:36 +0100 Subject: [PATCH 01/18] Update intro paragraph. --- guide/onboarding/restoring-a-wallet.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/guide/onboarding/restoring-a-wallet.md b/guide/onboarding/restoring-a-wallet.md index 69f6d57aa..6b9a9d680 100644 --- a/guide/onboarding/restoring-a-wallet.md +++ b/guide/onboarding/restoring-a-wallet.md @@ -24,7 +24,9 @@ image: https://bitcoin.design/assets/images/guide/onboarding/restoring-a-wallet/
-There are a number of reasons why a user might need to recover their wallet. Typically, this might be because they lost their device, had it stolen, are migrating from a different wallet or deleted and redownloaded a particular wallet application. Regardless of how it occurred, it’s important that your wallet application has clear, easy instructions that provide an easy way for users to recover their funds. There are a number of ways that a wallet recovery can be done. However, as covered in the [wallet interoperability]({{ 'guide/designing-products/wallet-interoperability' | relative_url }}) section, not all wallets from one application can be recovered in another. +There are several reasons why a user might need to restore their wallet. They may have lost their device, are migrating from a different application or deleted their wallet application. Regardless of how it occurred, it’s important that your wallet application has an easy way for users to recover their funds. + +However, as covered in the [wallet interoperability]({{ 'guide/designing-products/wallet-interoperability' | relative_url }}) section, depending on what standards they support, not all wallets from one application can be recovered in another. This is particularly true for a wallet holding Bitcoin on the Lightning network, and restoring should be done with the application originally used. {% include picture.html image = "/assets/images/guide/onboarding/restoring-a-wallet/import-options.png" From bfde82e6f26eea8aa9c886b2036dfd96311241f2 Mon Sep 17 00:00:00 2001 From: Daniel Nordh <3393669+danielnordh@users.noreply.github.com> Date: Thu, 14 Oct 2021 10:25:20 +0100 Subject: [PATCH 02/18] Update restore from cloud backup --- guide/onboarding/restoring-a-wallet.md | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/guide/onboarding/restoring-a-wallet.md b/guide/onboarding/restoring-a-wallet.md index 6b9a9d680..082737785 100644 --- a/guide/onboarding/restoring-a-wallet.md +++ b/guide/onboarding/restoring-a-wallet.md @@ -42,9 +42,7 @@ However, as covered in the [wallet interoperability]({{ 'guide/designing-product ### Restore from an automatic cloud backup -As outlined earlier in the chapter, we consider an automatic cloud backup a good option, especially for beginners. One of the major UX benefits of this is a seamless recovery process. All users needs to do to gain access to their funds again is to log into their cloud storage account. - -If they aren't logged in, they only need to enter their password before the wallet can automatically access the recovery phrase stored on the user's iCloud or Google Drive account. Once the recovery phrase is located, the wallet can begin to regenerate the keys required for the user to access their funds. +As outlined earlier in the chapter, we consider an automatic cloud backup a good option, especially for beginners. One of the major UX benefits of this is a seamless recovery process. Assuming they are restoring in the same wallet application originally used, all the user needs to do to gain access to their funds again is to log into their cloud storage account. ### Restore with recovery phrase From 08ef1536e91a20b077dbd8895db9b3a4f55521fc Mon Sep 17 00:00:00 2001 From: Daniel Nordh <3393669+danielnordh@users.noreply.github.com> Date: Thu, 14 Oct 2021 10:26:28 +0100 Subject: [PATCH 03/18] Update Restore manually --- guide/onboarding/restoring-a-wallet.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/guide/onboarding/restoring-a-wallet.md b/guide/onboarding/restoring-a-wallet.md index 082737785..fbc21f34b 100644 --- a/guide/onboarding/restoring-a-wallet.md +++ b/guide/onboarding/restoring-a-wallet.md @@ -44,9 +44,9 @@ However, as covered in the [wallet interoperability]({{ 'guide/designing-product As outlined earlier in the chapter, we consider an automatic cloud backup a good option, especially for beginners. One of the major UX benefits of this is a seamless recovery process. Assuming they are restoring in the same wallet application originally used, all the user needs to do to gain access to their funds again is to log into their cloud storage account. -### Restore with recovery phrase +### Restore manually with a recovery phrase -Users of your bitcoin wallet may also have created other wallets with different providers. If this is the case, they can transfer that wallet into yours by entering their 12 or 24-word recovery phrase. There are several ways you can choose to allow a user to enter a recovery phase. These were outlined earlier in the [manual backup]({{ 'guide/onboarding/backing-up-a-recovery-phrase/manual-backup/' | relative_url }}) section of this chapter. +Users may have created a wallet with another wallet application. In this case, they can import that wallet into yours by entering their 12 or 24-word recovery phrase. There are several ways you can choose to allow a user to enter a recovery phase. These were outlined earlier in the [manual backup]({{ 'guide/onboarding/backing-up-a-recovery-phrase/manual-backup/' | relative_url }}) section of this chapter. ### Restore from an encrypted QR code backup From c72b79e692735f284bbb4eca1ce8704ebbe6e5e4 Mon Sep 17 00:00:00 2001 From: Daniel Nordh <3393669+danielnordh@users.noreply.github.com> Date: Thu, 14 Oct 2021 10:27:31 +0100 Subject: [PATCH 04/18] Update restore from QR code --- guide/onboarding/restoring-a-wallet.md | 7 +------ 1 file changed, 1 insertion(+), 6 deletions(-) diff --git a/guide/onboarding/restoring-a-wallet.md b/guide/onboarding/restoring-a-wallet.md index fbc21f34b..65d0880ee 100644 --- a/guide/onboarding/restoring-a-wallet.md +++ b/guide/onboarding/restoring-a-wallet.md @@ -50,12 +50,7 @@ Users may have created a wallet with another wallet application. In this case, t ### Restore from an encrypted QR code backup -You might also provide the option for users to scan an encrypted QR code version of their recovery phrase. This has two key benefits: - -1. Switching between a mobile OS is easier. -2. It provides the option for more redundant backups. - -For a more detailed explantion of this recovery technique check out this [blog post](https://blog.keys.casa/product-update-transaction-memos-encrypted-backups/) by Casa. +Some applications also provide a proprietary option for users to scan an encrypted QR code version of their recovery phrase. For a more detailed explantion of this recovery technique check out this [blog post](https://blog.keys.casa/product-update-transaction-memos-encrypted-backups/) by Casa. Some less popular methods include importing a file such as wallet.dat. Such a file would have all the information required to recover funds such as public keys and key metadata. In some cases you might be developing a watch-only wallet that only lets users track their bitcoin transactions. In this case you would import an extended public key, this tends to be for technically minded users however. From ac0a5ff66fca5266e48f998fbdfaa4e4a85d5f05 Mon Sep 17 00:00:00 2001 From: Daniel Nordh <3393669+danielnordh@users.noreply.github.com> Date: Thu, 14 Oct 2021 10:30:14 +0100 Subject: [PATCH 05/18] Add section about restoring with funds on Lightning network --- guide/onboarding/restoring-a-wallet.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/guide/onboarding/restoring-a-wallet.md b/guide/onboarding/restoring-a-wallet.md index 65d0880ee..69da97032 100644 --- a/guide/onboarding/restoring-a-wallet.md +++ b/guide/onboarding/restoring-a-wallet.md @@ -52,6 +52,10 @@ Users may have created a wallet with another wallet application. In this case, t Some applications also provide a proprietary option for users to scan an encrypted QR code version of their recovery phrase. For a more detailed explantion of this recovery technique check out this [blog post](https://blog.keys.casa/product-update-transaction-memos-encrypted-backups/) by Casa. +### Restore a wallet with funds on the Lightning network + +To fully restore a wallet with funds on the [Lightning network](https://bitcoin.design/guide/glossary/#lightning-network), the state and history of the payment channels are needed in addition to the recovery phrase. As there are no standards for this yet, wallet applications need to have their own format for backing this up, and subsequently restoring. Due to the amount of data, an encrypted QR code like in the previous example can be appropriate. + Some less popular methods include importing a file such as wallet.dat. Such a file would have all the information required to recover funds such as public keys and key metadata. In some cases you might be developing a watch-only wallet that only lets users track their bitcoin transactions. In this case you would import an extended public key, this tends to be for technically minded users however. --- From b2ee0d88b308839cc6dd106c027d09a03474d586 Mon Sep 17 00:00:00 2001 From: Daniel Nordh <3393669+danielnordh@users.noreply.github.com> Date: Thu, 14 Oct 2021 10:32:02 +0100 Subject: [PATCH 06/18] Update less popular options. --- guide/onboarding/restoring-a-wallet.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/guide/onboarding/restoring-a-wallet.md b/guide/onboarding/restoring-a-wallet.md index 69da97032..738de4220 100644 --- a/guide/onboarding/restoring-a-wallet.md +++ b/guide/onboarding/restoring-a-wallet.md @@ -54,9 +54,9 @@ Some applications also provide a proprietary option for users to scan an encryp ### Restore a wallet with funds on the Lightning network -To fully restore a wallet with funds on the [Lightning network](https://bitcoin.design/guide/glossary/#lightning-network), the state and history of the payment channels are needed in addition to the recovery phrase. As there are no standards for this yet, wallet applications need to have their own format for backing this up, and subsequently restoring. Due to the amount of data, an encrypted QR code like in the previous example can be appropriate. +To fully restore a wallet with funds on the [Lightning network](/guide/glossary/#lightning-network), the state and history of the payment channels are needed in addition to the recovery phrase. As there are no standards for this yet, wallet applications need to have their own format for backing this up, and subsequently restoring. Due to the amount of data, an encrypted QR code like in the previous example can be appropriate. -Some less popular methods include importing a file such as wallet.dat. Such a file would have all the information required to recover funds such as public keys and key metadata. In some cases you might be developing a watch-only wallet that only lets users track their bitcoin transactions. In this case you would import an extended public key, this tends to be for technically minded users however. +Some less popular methods for restoring a wallet include importing a file with all the information required to recover funds such as public keys and key metadata. A wallet.dat file from Bitcoin Core is one example of such a file scheme. If you are developing a watch-only wallet, you would import an [extended public key](/guide/glossary/#extended-public-key-xpub-ypub-zpub), this tends to be for technically minded users however. --- From 2bcb44f63c4b9ba74b3e559ee4351f5f1c9e08c8 Mon Sep 17 00:00:00 2001 From: Daniel Nordh <3393669+danielnordh@users.noreply.github.com> Date: Thu, 14 Oct 2021 10:43:42 +0100 Subject: [PATCH 07/18] Minor readability tweaks after proof reading. --- guide/onboarding/restoring-a-wallet.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/guide/onboarding/restoring-a-wallet.md b/guide/onboarding/restoring-a-wallet.md index 738de4220..8786da7ba 100644 --- a/guide/onboarding/restoring-a-wallet.md +++ b/guide/onboarding/restoring-a-wallet.md @@ -24,9 +24,9 @@ image: https://bitcoin.design/assets/images/guide/onboarding/restoring-a-wallet/
-There are several reasons why a user might need to restore their wallet. They may have lost their device, are migrating from a different application or deleted their wallet application. Regardless of how it occurred, it’s important that your wallet application has an easy way for users to recover their funds. +There are several reasons why a user might need to restore their wallet. They may have lost their device, are migrating from a different application or deleted their wallet application. Regardless of why, it’s important that your wallet application has an easy way for users to recover their funds. -However, as covered in the [wallet interoperability]({{ 'guide/designing-products/wallet-interoperability' | relative_url }}) section, depending on what standards they support, not all wallets from one application can be recovered in another. This is particularly true for a wallet holding Bitcoin on the Lightning network, and restoring should be done with the application originally used. +However, not all wallets from one application can be recovered in another, depending on what standards they support as covered in the [wallet interoperability]({{ 'guide/designing-products/wallet-interoperability' | relative_url }}) section. This is particularly true for a wallet holding bitcoin on the Lightning network, and restoring should be done with the application originally used. {% include picture.html image = "/assets/images/guide/onboarding/restoring-a-wallet/import-options.png" @@ -46,17 +46,17 @@ As outlined earlier in the chapter, we consider an automatic cloud backup a good ### Restore manually with a recovery phrase -Users may have created a wallet with another wallet application. In this case, they can import that wallet into yours by entering their 12 or 24-word recovery phrase. There are several ways you can choose to allow a user to enter a recovery phase. These were outlined earlier in the [manual backup]({{ 'guide/onboarding/backing-up-a-recovery-phrase/manual-backup/' | relative_url }}) section of this chapter. +Users may have created a wallet with another wallet application. In this case, they should be able to import that wallet into yours by entering their 12 or 24-word recovery phrase. There are several options for the UI when entering a recovery phase, as outlined earlier in the [manual backup]({{ 'guide/onboarding/backing-up-a-recovery-phrase/manual-backup/' | relative_url }}) section of this chapter. ### Restore from an encrypted QR code backup -Some applications also provide a proprietary option for users to scan an encrypted QR code version of their recovery phrase. For a more detailed explantion of this recovery technique check out this [blog post](https://blog.keys.casa/product-update-transaction-memos-encrypted-backups/) by Casa. +Some applications also provide an option for users to scan an encrypted proprietary QR code version of their recovery phrase. For a more detailed explanation of this recovery technique check out this [blog post](https://blog.keys.casa/product-update-transaction-memos-encrypted-backups/) by Casa. ### Restore a wallet with funds on the Lightning network To fully restore a wallet with funds on the [Lightning network](/guide/glossary/#lightning-network), the state and history of the payment channels are needed in addition to the recovery phrase. As there are no standards for this yet, wallet applications need to have their own format for backing this up, and subsequently restoring. Due to the amount of data, an encrypted QR code like in the previous example can be appropriate. -Some less popular methods for restoring a wallet include importing a file with all the information required to recover funds such as public keys and key metadata. A wallet.dat file from Bitcoin Core is one example of such a file scheme. If you are developing a watch-only wallet, you would import an [extended public key](/guide/glossary/#extended-public-key-xpub-ypub-zpub), this tends to be for technically minded users however. +Some less popular methods for restoring a wallet include importing a file with all the information required to recover funds such as public keys and key metadata. A wallet.dat file from Bitcoin Core is one example of such a file scheme. If you are developing a watch-only wallet, you would import an [extended public key](/guide/glossary/#extended-public-key-xpub-ypub-zpub) instead of the recovery phrase, this tends to be for technically minded users however. --- From 50bc68a22ebfcc8ec6f629201bacfa379828c2c6 Mon Sep 17 00:00:00 2001 From: Daniel Nordh <3393669+danielnordh@users.noreply.github.com> Date: Thu, 14 Oct 2021 10:46:56 +0100 Subject: [PATCH 08/18] Add link, minor readability tweaks. --- guide/onboarding/restoring-a-wallet.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/guide/onboarding/restoring-a-wallet.md b/guide/onboarding/restoring-a-wallet.md index 8786da7ba..d21a918f8 100644 --- a/guide/onboarding/restoring-a-wallet.md +++ b/guide/onboarding/restoring-a-wallet.md @@ -24,7 +24,7 @@ image: https://bitcoin.design/assets/images/guide/onboarding/restoring-a-wallet/
-There are several reasons why a user might need to restore their wallet. They may have lost their device, are migrating from a different application or deleted their wallet application. Regardless of why, it’s important that your wallet application has an easy way for users to recover their funds. +There are several reasons why a user might need to restore their wallet. They may have lost their device, be migrating from a different application or have deleted their wallet application. Regardless of why, it’s important that your wallet application has an easy way for users to recover their funds. However, not all wallets from one application can be recovered in another, depending on what standards they support as covered in the [wallet interoperability]({{ 'guide/designing-products/wallet-interoperability' | relative_url }}) section. This is particularly true for a wallet holding bitcoin on the Lightning network, and restoring should be done with the application originally used. @@ -42,7 +42,7 @@ However, not all wallets from one application can be recovered in another, depen ### Restore from an automatic cloud backup -As outlined earlier in the chapter, we consider an automatic cloud backup a good option, especially for beginners. One of the major UX benefits of this is a seamless recovery process. Assuming they are restoring in the same wallet application originally used, all the user needs to do to gain access to their funds again is to log into their cloud storage account. +As outlined earlier in the chapter, we consider an [automatic cloud backup](/guide/onboarding/backing-up-a-recovery-phrase/automatic-cloud-backup/) a good option, especially for beginners. One of the major UX benefits of this is a seamless recovery process. Assuming they are restoring in the same wallet application originally used, all the user needs to do to gain access to their funds again is to log into their cloud storage account. ### Restore manually with a recovery phrase From 98d1a33370635dbb86b52400527df3c7215e8497 Mon Sep 17 00:00:00 2001 From: Daniel Nordh <3393669+danielnordh@users.noreply.github.com> Date: Thu, 14 Oct 2021 14:51:23 +0100 Subject: [PATCH 09/18] Address feedback. --- guide/onboarding/restoring-a-wallet.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/guide/onboarding/restoring-a-wallet.md b/guide/onboarding/restoring-a-wallet.md index d21a918f8..cf73a0cba 100644 --- a/guide/onboarding/restoring-a-wallet.md +++ b/guide/onboarding/restoring-a-wallet.md @@ -54,7 +54,7 @@ Some applications also provide an option for users to scan an encrypted proprie ### Restore a wallet with funds on the Lightning network -To fully restore a wallet with funds on the [Lightning network](/guide/glossary/#lightning-network), the state and history of the payment channels are needed in addition to the recovery phrase. As there are no standards for this yet, wallet applications need to have their own format for backing this up, and subsequently restoring. Due to the amount of data, an encrypted QR code like in the previous example can be appropriate. +To fully restore a wallet with funds on the [Lightning network](/guide/glossary/#lightning-network), the state and history of the payment channels are needed in addition to the recovery phrase. As there are no standards for this yet, wallet applications need to have their own format for backing this up, and subsequently restoring. Due to the amount of information, a QR code of the encrypted datalike in the previous example can be appropriate. Some less popular methods for restoring a wallet include importing a file with all the information required to recover funds such as public keys and key metadata. A wallet.dat file from Bitcoin Core is one example of such a file scheme. If you are developing a watch-only wallet, you would import an [extended public key](/guide/glossary/#extended-public-key-xpub-ypub-zpub) instead of the recovery phrase, this tends to be for technically minded users however. From 1dde535abd3c8cdf2b75f4e8721a6bd5034ee19b Mon Sep 17 00:00:00 2001 From: Daniel Nordh <3393669+danielnordh@users.noreply.github.com> Date: Mon, 18 Oct 2021 10:48:35 +0100 Subject: [PATCH 10/18] Add comma Co-authored-by: Christoph Ono --- guide/onboarding/restoring-a-wallet.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/guide/onboarding/restoring-a-wallet.md b/guide/onboarding/restoring-a-wallet.md index cf73a0cba..68e1294ec 100644 --- a/guide/onboarding/restoring-a-wallet.md +++ b/guide/onboarding/restoring-a-wallet.md @@ -26,7 +26,7 @@ image: https://bitcoin.design/assets/images/guide/onboarding/restoring-a-wallet/ There are several reasons why a user might need to restore their wallet. They may have lost their device, be migrating from a different application or have deleted their wallet application. Regardless of why, it’s important that your wallet application has an easy way for users to recover their funds. -However, not all wallets from one application can be recovered in another, depending on what standards they support as covered in the [wallet interoperability]({{ 'guide/designing-products/wallet-interoperability' | relative_url }}) section. This is particularly true for a wallet holding bitcoin on the Lightning network, and restoring should be done with the application originally used. +However, not all wallets from one application can be recovered in another, depending on what standards they support, as covered in the [wallet interoperability]({{ 'guide/designing-products/wallet-interoperability' | relative_url }}) section. This is particularly true for a wallet holding bitcoin on the Lightning network, and restoring should be done with the application originally used. {% include picture.html image = "/assets/images/guide/onboarding/restoring-a-wallet/import-options.png" From e7011111f15fe24832ca8d8d429470baad703dd3 Mon Sep 17 00:00:00 2001 From: Daniel Nordh <3393669+danielnordh@users.noreply.github.com> Date: Mon, 18 Oct 2021 10:49:13 +0100 Subject: [PATCH 11/18] Add space Co-authored-by: Christoph Ono --- guide/onboarding/restoring-a-wallet.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/guide/onboarding/restoring-a-wallet.md b/guide/onboarding/restoring-a-wallet.md index 68e1294ec..4f8c0ff47 100644 --- a/guide/onboarding/restoring-a-wallet.md +++ b/guide/onboarding/restoring-a-wallet.md @@ -42,7 +42,7 @@ However, not all wallets from one application can be recovered in another, depen ### Restore from an automatic cloud backup -As outlined earlier in the chapter, we consider an [automatic cloud backup](/guide/onboarding/backing-up-a-recovery-phrase/automatic-cloud-backup/) a good option, especially for beginners. One of the major UX benefits of this is a seamless recovery process. Assuming they are restoring in the same wallet application originally used, all the user needs to do to gain access to their funds again is to log into their cloud storage account. +As outlined earlier in the chapter, we consider an [automatic cloud backup](/guide/onboarding/backing-up-a-recovery-phrase/automatic-cloud-backup/) a good option, especially for beginners. One of the major UX benefits of this is a seamless recovery process. Assuming they are restoring in the same wallet application originally used, all the user needs to do to gain access to their funds again is to log in to their cloud storage account. ### Restore manually with a recovery phrase From 2694555936199cdbc2b8c1172889114f34470aa7 Mon Sep 17 00:00:00 2001 From: Daniel Nordh <3393669+danielnordh@users.noreply.github.com> Date: Mon, 18 Oct 2021 10:49:31 +0100 Subject: [PATCH 12/18] Add comma Co-authored-by: Christoph Ono --- guide/onboarding/restoring-a-wallet.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/guide/onboarding/restoring-a-wallet.md b/guide/onboarding/restoring-a-wallet.md index 4f8c0ff47..52a8146aa 100644 --- a/guide/onboarding/restoring-a-wallet.md +++ b/guide/onboarding/restoring-a-wallet.md @@ -50,7 +50,7 @@ Users may have created a wallet with another wallet application. In this case, t ### Restore from an encrypted QR code backup -Some applications also provide an option for users to scan an encrypted proprietary QR code version of their recovery phrase. For a more detailed explanation of this recovery technique check out this [blog post](https://blog.keys.casa/product-update-transaction-memos-encrypted-backups/) by Casa. +Some applications also provide an option for users to scan an encrypted proprietary QR code version of their recovery phrase. For a more detailed explanation of this recovery technique, check out this [blog post](https://blog.keys.casa/product-update-transaction-memos-encrypted-backups/) by Casa. ### Restore a wallet with funds on the Lightning network From 86c2e3e081138fc770f7ea70681fac644e176709 Mon Sep 17 00:00:00 2001 From: Daniel Nordh <3393669+danielnordh@users.noreply.github.com> Date: Mon, 18 Oct 2021 10:53:18 +0100 Subject: [PATCH 13/18] Add space, comma Co-authored-by: Christoph Ono --- guide/onboarding/restoring-a-wallet.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/guide/onboarding/restoring-a-wallet.md b/guide/onboarding/restoring-a-wallet.md index 52a8146aa..88655cb53 100644 --- a/guide/onboarding/restoring-a-wallet.md +++ b/guide/onboarding/restoring-a-wallet.md @@ -54,7 +54,7 @@ Some applications also provide an option for users to scan an encrypted proprie ### Restore a wallet with funds on the Lightning network -To fully restore a wallet with funds on the [Lightning network](/guide/glossary/#lightning-network), the state and history of the payment channels are needed in addition to the recovery phrase. As there are no standards for this yet, wallet applications need to have their own format for backing this up, and subsequently restoring. Due to the amount of information, a QR code of the encrypted datalike in the previous example can be appropriate. +To fully restore a wallet with funds on the [Lightning network](/guide/glossary/#lightning-network), the state and history of the payment channels are needed in addition to the recovery phrase. As there are no standards for this yet, wallet applications need to have their own format for backing this up, and subsequently restoring. Due to the amount of information, a QR code of the encrypted data, like in the previous example, can be appropriate. Some less popular methods for restoring a wallet include importing a file with all the information required to recover funds such as public keys and key metadata. A wallet.dat file from Bitcoin Core is one example of such a file scheme. If you are developing a watch-only wallet, you would import an [extended public key](/guide/glossary/#extended-public-key-xpub-ypub-zpub) instead of the recovery phrase, this tends to be for technically minded users however. From f8a43f4bd9cc99c1d0dde6665498bc53a24de52b Mon Sep 17 00:00:00 2001 From: Daniel Nordh <3393669+danielnordh@users.noreply.github.com> Date: Mon, 18 Oct 2021 10:59:48 +0100 Subject: [PATCH 14/18] Clarify Bitcoin wallet --- guide/onboarding/restoring-a-wallet.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/guide/onboarding/restoring-a-wallet.md b/guide/onboarding/restoring-a-wallet.md index cf73a0cba..f8726b925 100644 --- a/guide/onboarding/restoring-a-wallet.md +++ b/guide/onboarding/restoring-a-wallet.md @@ -24,7 +24,7 @@ image: https://bitcoin.design/assets/images/guide/onboarding/restoring-a-wallet/
-There are several reasons why a user might need to restore their wallet. They may have lost their device, be migrating from a different application or have deleted their wallet application. Regardless of why, it’s important that your wallet application has an easy way for users to recover their funds. +There are several reasons why a user might need to restore their Bitcoin wallet. They may have lost their device, be migrating from a different application or have deleted their wallet application. Regardless of why, it’s important that your wallet application has an easy way for users to recover their funds. However, not all wallets from one application can be recovered in another, depending on what standards they support as covered in the [wallet interoperability]({{ 'guide/designing-products/wallet-interoperability' | relative_url }}) section. This is particularly true for a wallet holding bitcoin on the Lightning network, and restoring should be done with the application originally used. From 0845dc3068086690211859a394d73779a15c46dd Mon Sep 17 00:00:00 2001 From: Daniel Nordh <3393669+danielnordh@users.noreply.github.com> Date: Mon, 18 Oct 2021 11:01:13 +0100 Subject: [PATCH 15/18] Specifically mention iCloud and Google Drive --- guide/onboarding/restoring-a-wallet.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/guide/onboarding/restoring-a-wallet.md b/guide/onboarding/restoring-a-wallet.md index f8726b925..e28ff3e13 100644 --- a/guide/onboarding/restoring-a-wallet.md +++ b/guide/onboarding/restoring-a-wallet.md @@ -42,7 +42,7 @@ However, not all wallets from one application can be recovered in another, depen ### Restore from an automatic cloud backup -As outlined earlier in the chapter, we consider an [automatic cloud backup](/guide/onboarding/backing-up-a-recovery-phrase/automatic-cloud-backup/) a good option, especially for beginners. One of the major UX benefits of this is a seamless recovery process. Assuming they are restoring in the same wallet application originally used, all the user needs to do to gain access to their funds again is to log into their cloud storage account. +As outlined earlier in the chapter, we consider an [automatic cloud backup](/guide/onboarding/backing-up-a-recovery-phrase/automatic-cloud-backup/) a good option, especially for beginners. One of the major UX benefits of this is a seamless recovery process. Assuming they are restoring in the same wallet application originally used, all the user needs to do to gain access to their funds again is to log into their cloud storage account (typically iCloud or Google Drive). ### Restore manually with a recovery phrase From 31f2cc8c683efcfe2c67802a2d0854eafae3877c Mon Sep 17 00:00:00 2001 From: Daniel Nordh <3393669+danielnordh@users.noreply.github.com> Date: Mon, 18 Oct 2021 11:10:26 +0100 Subject: [PATCH 16/18] Add note about restore not containing user data beyond private keys. --- guide/onboarding/restoring-a-wallet.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/guide/onboarding/restoring-a-wallet.md b/guide/onboarding/restoring-a-wallet.md index 38e5b8f22..f4f718d9d 100644 --- a/guide/onboarding/restoring-a-wallet.md +++ b/guide/onboarding/restoring-a-wallet.md @@ -26,7 +26,7 @@ image: https://bitcoin.design/assets/images/guide/onboarding/restoring-a-wallet/ There are several reasons why a user might need to restore their Bitcoin wallet. They may have lost their device, be migrating from a different application or have deleted their wallet application. Regardless of why, it’s important that your wallet application has an easy way for users to recover their funds. -However, not all wallets from one application can be recovered in another, depending on what standards they support, as covered in the [wallet interoperability]({{ 'guide/designing-products/wallet-interoperability' | relative_url }}) section. This is particularly true for a wallet holding bitcoin on the Lightning network, and restoring should be done with the application originally used. +However, not all wallets from one application can be recovered in another, depending on what standards they support, as covered in the [wallet interoperability]({{ 'guide/designing-products/wallet-interoperability' | relative_url }}) section. This is particularly true for a wallet holding bitcoin on the Lightning network, and restoring should be done with the application originally used. It's also worth noting that restoring from a recovery phrase only restores the private keys, but no user data like transaction notes, contacts etc. {% include picture.html image = "/assets/images/guide/onboarding/restoring-a-wallet/import-options.png" From c03962ceaacb46b473c7f3cff762339d8e0cee5e Mon Sep 17 00:00:00 2001 From: Daniel Nordh <3393669+danielnordh@users.noreply.github.com> Date: Mon, 18 Oct 2021 11:21:49 +0100 Subject: [PATCH 17/18] Add recommendation container. --- guide/onboarding/restoring-a-wallet.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/guide/onboarding/restoring-a-wallet.md b/guide/onboarding/restoring-a-wallet.md index f4f718d9d..12f232371 100644 --- a/guide/onboarding/restoring-a-wallet.md +++ b/guide/onboarding/restoring-a-wallet.md @@ -56,6 +56,12 @@ Some applications also provide an option for users to scan an encrypted proprie To fully restore a wallet with funds on the [Lightning network](/guide/glossary/#lightning-network), the state and history of the payment channels are needed in addition to the recovery phrase. As there are no standards for this yet, wallet applications need to have their own format for backing this up, and subsequently restoring. Due to the amount of information, a QR code of the encrypted data, like in the previous example, can be appropriate. +{% include tip/recommendation.html %} + +Be clear to users what you support and what wallet specifications they can expect to restore in your application. Most bitcoin products should support restoring from a recovery phrase at a minimum. Capability to restore an HD wallet implemented according to BIP32, 39, 43, 44, 49, 84 and 380 would be a good starting point. + +{% include tip/close.html %} + Some less popular methods for restoring a wallet include importing a file with all the information required to recover funds such as public keys and key metadata. A wallet.dat file from Bitcoin Core is one example of such a file scheme. If you are developing a watch-only wallet, you would import an [extended public key](/guide/glossary/#extended-public-key-xpub-ypub-zpub) instead of the recovery phrase, this tends to be for technically minded users however. --- From f79e11fcbedf37f8a9a3c6567ae9dcf1b192af06 Mon Sep 17 00:00:00 2001 From: Daniel Nordh <3393669+danielnordh@users.noreply.github.com> Date: Tue, 19 Oct 2021 08:59:30 +0100 Subject: [PATCH 18/18] Clarify Lightning interoperability issues. Co-authored-by: Pavlenex --- guide/onboarding/restoring-a-wallet.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/guide/onboarding/restoring-a-wallet.md b/guide/onboarding/restoring-a-wallet.md index 12f232371..efb0b2486 100644 --- a/guide/onboarding/restoring-a-wallet.md +++ b/guide/onboarding/restoring-a-wallet.md @@ -26,7 +26,7 @@ image: https://bitcoin.design/assets/images/guide/onboarding/restoring-a-wallet/ There are several reasons why a user might need to restore their Bitcoin wallet. They may have lost their device, be migrating from a different application or have deleted their wallet application. Regardless of why, it’s important that your wallet application has an easy way for users to recover their funds. -However, not all wallets from one application can be recovered in another, depending on what standards they support, as covered in the [wallet interoperability]({{ 'guide/designing-products/wallet-interoperability' | relative_url }}) section. This is particularly true for a wallet holding bitcoin on the Lightning network, and restoring should be done with the application originally used. It's also worth noting that restoring from a recovery phrase only restores the private keys, but no user data like transaction notes, contacts etc. +However, not all wallets from one application can be recovered in another, depending on what standards they support, as covered in the [wallet interoperability]({{ 'guide/designing-products/wallet-interoperability' | relative_url }}) section. Lack of interoperability and vendor dependance is an issue for wallets holding bitcoin on the Lightning network. Lightning network wallets can currently only be restored in the application originally used. It's also worth noting that restoring from a recovery phrase only restores the private keys, but no user data like transaction notes, contacts etc. {% include picture.html image = "/assets/images/guide/onboarding/restoring-a-wallet/import-options.png"