Merge pull request #1781

resources: update "How to restore a wallet from mnemonic seed" user guide

_i18n/en/resources/user-guides/restore_account.md

@@ -1,53 +1,110 @@
 {% include disclaimer.html translated="no" translationOutdated="no" %}
 
-## Operating Systems:  Windows, Linux, Mac
+### Table of contents
 
-- Retrieve your 25 word @mnemonic-seed that you saved when creating your old Monero @wallet
+- [When should I restore a wallet?](#when-should-i-restore-a-wallet)
+- [What is needed to restore a wallet from mnemonic seed?](#what-is-needed-to-restore-a-wallet-from-mnemonic-seed)
+- [What is the wallet restore height?](#what-is-the-wallet-restore-height)
+- [How to restore a wallet from mnemonic seed on Monero GUI](#how-to-restore-a-wallet-from-mnemonic-seed-on-monero-gui)
+- [How to restore a wallet from mnemonic seed on Monero CLI](#how-to-restore-a-wallet-from-mnemonic-seed-on-monero-cli)
+- [My restored wallet is showing a wrong balance](#my-restored-wallet-is-showing-a-wrong-balance)
 
-### Account Software:  monero-wallet-cli
+### When should I restore a wallet?
 
-- Open a command prompt and navigate to the drive and directory that contains monero-wallet-cli
+You should restore your @wallet in the following situations:
+- You lost access to your wallet (you forgot its password, your wallet file is corrupted or your device stopped working/is lost).
+- You want to create a copy of your wallet on another device.
 
-- At the command prompt type:  `monero-wallet-cli --restore-deterministic-wallet`
+This guide will teach you how to restore a Monero wallet from its @mnemonic-seed.
 
-- Once you press enter you will be prompted for a wallet file name.  Give your wallet a new name, any name will do
+If you want to restore a wallet from its private keys, please read [this guide]({{site.baseurl}}/resources/user-guides/restore_from_keys.html).
 
-- Press enter again and you will be prompted for a password.  Give your wallet a new and long password
+### What is needed to restore a wallet from mnemonic seed?
 
-- Press enter again you will be prompted to repeat the password
+A valid Monero mnemonic seed is a phrase with 13, 14, or 25 random words (multiple languages are supported). Your mnemonic seed has all the information needed to restore your wallet.
 
-- Press enter again and you will be prompted for the 25 word electrum style mnemonic seed that you retrieved earlier
+It is also useful to know your wallet restore height or the creation date of your wallet, since it makes your wallet synchronization faster.
 
--  You will then be prompted with "Restore from specific blockchain height (optional, default 0):" Default will start the restore process from the beginning of the Monero blockchain. If you don't know the specific blockchain height, just hit enter. (Specifying a specific blockchain height will start the restore process from that specific height. This will save a bit of time in scanning, if you know what starting blockchain height your initial funds were transacted for this specific account.)
+### Where can I find my mnemonic seed?
 
-After you have entered the 25 word mnemonic seed and have chosen your specific blockchain height, monero-wallet-cli will generate the same public address and view key as your old wallet and begin the refresh process automatically. (Please be patient as the refresh process may take a while.)
+Most Monero wallets ask the user to write down a mnemonic seed on a paper backup when a wallet is being created. So it's up to you to remember where and how you stored your mnemonic seed.
 
-### Account Software:  monero-wallet-gui
+Alternatively, if you still have access to the wallet being restored, you can usually find your mnemonic seed in a menu with some name like `Seed`, `Keys`, `Secrets`, or `Master Private Key`.
 
-Lauch `monero-wallet-gui`. If this is the first time you launched it go to the next step, otherwise click `Cancel`:
+### What is the wallet restore height?
 
-![cancel opening](/img/resources/user-guides/en/restore_account/cancel-opening.png)
+The wallet restore height is a setting that tells your wallet software at which block height it should start scanning the blockchain looking for transactions. Ideally it should be the number of the block which included the first incoming transaction to your wallet.
 
-Select your appropriate language `English(US)`:
+If you set a restore height higher than the block height of your first incoming transaction, your wallet software will not detect all transactions of your wallet. In consequence, your balance will be wrong and your wallet software will not work properly.
 
-![choose language](/img/resources/user-guides/en/restore_account/choose-language.png)
+If you set a restore height lower than the block height of your first incoming transaction, your wallet software will scan unnecessary blocks. In consequence, your initial wallet synchronization will take longer than necessary, but your wallet software will still work.
 
-Click on `Restore wallet from keys or mnemonic seed`:
+Therefore, if you're unsure about the block height of your first incoming transaction, it's always better to set a lower restore height instead of a higher one.
 
-![choose restore](/img/resources/user-guides/en/restore_account/choose-restore.png)
+![restore-height](/img/resources/user-guides/en/restore_account/restore-height.png)
 
-Keep `Restore from seed` selected, give your wallet a name & storage location, and complete the `Enter your 25 (or 24) word mnemonic seed`. Optionaly, specify a `Restore height (optional)` to avoid scanning of oldest blocks. Then click the `Right` arrow:
+### How to restore a wallet from mnemonic seed on Monero GUI
 
-![restore wallet](/img/resources/user-guides/en/restore_account/restore-wallet.png)
+1) On the main menu, click on `Restore wallet from keys or mnemonic seed`.
 
-On the next page, give your wallet a strong password and confirm it before clicking the `Right` arrow:
+![main-menu-restore-wallet](/img/resources/user-guides/en/restore_account/main-menu-restore-wallet.png)
+
+2) The `Restore wallet` page will be displayed:
+
+![restore-from-seed](/img/resources/user-guides/en/restore_account/restore-from-seed.png)
+
+3) On `Wallet name`, enter the name of the wallet you want to create. You don't need to use the same name of the wallet being restored.
+
+4) On `Wallet location`, choose where you want the wallet file to be saved.
+
+5) Keep `Restore from seed` selected.
+
+6) On the next field, type your 25 word `mnemonic seed`. It is expected that some mnemonic seeds have repeated words, as they work as a verification for errors (checksum).
+
+7) Use the field `Seed offset passphrase` to enter your passphrase, if you have one. When you enter a passphrase, Monero GUI will use your mnemonic seed together with your passphrase to compute a new wallet.
+
+8) The next field allows you to enter a `Restore height`. Even though this field is optional, it's not recommended to leave it blank, since setting a restore height makes your wallet synchronization faster. Ideally it should be the number of the block which included the first incoming transaction to your wallet:
+
+![restore-height-field](/img/resources/user-guides/en/restore_account/restore-height-field.png)
+
+Alternatively, you can also enter the date or an estimated date (YYYY-MM-DD format) of the first incoming transaction:
+
+![restore-height-field-date](/img/resources/user-guides/en/restore_account/restore-height-field-date.png)
+
+After entering your restore height, click on `Next` button.
+
+9) On the next page, give your wallet a strong password and confirm it. Since your wallet will hold your private keys and seed, it is really important to enter a strong password.
 
 ![wallet password](/img/resources/user-guides/en/restore_account/wallet-password.png)
 
-Specify your @daemon settings and click the `Right` arrow:
+10) If your wallet is in `Advanced mode`, the `Daemon settings` page will be displayed. Here you can choose whether you want to start a local node or connect to a remote node. Choose your desired option and click on `Next` button.
 
 ![daemon settings](/img/resources/user-guides/en/restore_account/daemon-settings.png)
 
-Click on `USE MONERO` to enjoy your restored wallet:
+11) The next page will display a summary of the wallet you are going to restore. Click on `Create wallet` button to restore your wallet:
 
 ![all set up](/img/resources/user-guides/en/restore_account/all-set-up.png)
+
+### How to restore a wallet from mnemonic seed on Monero CLI
+
+1) Open the terminal on your Monero CLI directory and run the following command:
+
+- Linux: `./monero-wallet-cli --restore-deterministic-wallet`
+
+- Windows: `monero-wallet-cli --restore-deterministic-wallet`
+
+2) Next, you will be asked for a wallet file name. Enter the name of the wallet you want to create and press `Enter`.
+
+3) Monero CLI will then ask you to give your wallet a password and confirm it. Since your wallet will hold your private keys and seed, it is really important to enter a strong password.
+
+4) Next, enter your 25 word mnemonic seed.
+
+5) Next, Monero CLI will ask for a `Restore height`. Even though it is optional, it's not recommended to leave it blank, since setting a restore height makes your wallet synchronization faster. Ideally it should be the number of the block which included the first incoming transaction to your wallet. Alternatively, you can also enter the date or an estimated date (YYYY-MM-DD format) of the first incoming transaction.
+
+6) After you have entered restore height, Monero CLI will then restore your wallet and start the wallet synchronization. Please be patient as this process may take a while. You will need to wait for it to finish before start using your wallet.
+
+7) If you run into any trouble, running `./monero-wallet-cli --help` will show you the options available to you at wallet startup. Once you're inside your wallet, running the `help` command will list the help for the commands available to you within the wallet.
+
+### My restored wallet is showing a wrong balance
+
+This problem usually occurs when you set a restore height that is higher than the block height of the first incoming transaction to your wallet. To solve this issue, you will have to change the wallet restore height. Please read [this guide]({{site.baseurl}}/resources/user-guides/change-restore-height.html) for detailed instructions on how to do this.