Skip to content

Commit 3f908ce

Browse files
authored
Merge pull request #753 from BitcoinDesign/feature/localization-note-for-recovery-phrases
Added note around localization considerations for recovery phrases in the glossary
2 parents 727ab99 + a4a9edc commit 3f908ce

File tree

3 files changed

+4
-1
lines changed

3 files changed

+4
-1
lines changed

guide/daily-spending-wallet/backup-and-recovery/recovery.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -57,7 +57,7 @@ As outlined earlier in the chapter, we consider an [automatic cloud backup](/gui
5757

5858
### Restore manually with a recovery phrase
5959

60-
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/daily-spending-wallet/backup-and-recovery/manual-backup/' | relative_url }}) section of this chapter.
60+
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/daily-spending-wallet/backup-and-recovery/manual-backup/' | relative_url }}) section of this chapter. Consider supporting recovery phrases in [multiple languages](https://github.com/bitcoin/bips/blob/master/bip-0039/bip-0039-wordlists.md) for better global accessibility.
6161

6262
### Restore from an encrypted QR code backup
6363

guide/glossary/index.md

+2
Original file line numberDiff line numberDiff line change
@@ -334,6 +334,8 @@ Many wallet-applications work with HD wallets and recovery phrases, and are inte
334334

335335
**Technicalities** - Recovery of multisig-wallets needs both the extended public key and the recovery phrase of all participating keys as well as the master key fingerprint as defined by BIP32 concatenated with the derivation path of the public key. The derivation path is represented as 32-bit little endian unsigned integer indexes concatenated with each other. The number of 32 bit unsigned integer indexes must match the depth provided in the extended public key.
336336

337+
**Language considerations** - Recovery phrases typically consists of English-language words, which may not be intuitive to recognize, remember, or write for many users around the world. Consider supporting multiple languages (see [BIP39 wordlists](https://github.com/bitcoin/bips/blob/master/bip-0039/bip-0039-wordlists.md)), or an alternate backup technique like [output descriptors]({{ '/guide/glossary/#output-script-descriptor' | relative_url }}).
338+
337339
### Simplified payment verification (SPV)
338340

339341
It is possible to verify bitcoin payments without running a full network node. This is called simplified payment verification, or SPV. A user’s bitcoin spv wallet only needs a copy of the block headers of the longest chain, which are available by querying network nodes until it is apparent that the longest chain has been obtained. SPV lets you validate your transactions without having to worry about anybody else’s transactions. It ensures your transactions are in a block, and it provides confirmations that additional blocks are being added to the chain. An SPV wallet is a type of bitcoin wallet that works this way.

guide/how-it-works/private-key-management/manual-backup.md

+1
Original file line numberDiff line numberDiff line change
@@ -79,6 +79,7 @@ Safe backups can be made fairly simple. Take a look at our [bitcoin backups]({{
7979

8080
#### Do's
8181
- Explain what a recovery phrase is, and provide guidance on how to do *safe offline backups* BEFORE the user is exposed to the recovery phrase
82+
- Consider supporting recovery phrases in [multiple languages](https://github.com/bitcoin/bips/blob/master/bip-0039/bip-0039-wordlists.md) for better global accessibility
8283

8384
#### Products that use this scheme
8485

0 commit comments

Comments
 (0)