Simplify versioning system for user guides
This new approach doesn't require version numbers and make easier for contributors to understand the status
of the document. There are only 3 states:
- Outdated: The page is outdated and might not work as expected
- Untranslated: The page needs to be translated
- Translation outdated: The page is translated, but the original (English) document has been updated
To mark a guide as outdated, we change the boolean of the front matter entry 'outdated' in /resources/user-guides/GUIDE.
If 'False', the guide is updated. If 'True' all versions of the guide (English included) will show a warning at the bottom
of the page.
The other 2 states are related to the status of the translated pages and we control them from the language-specific
user guides: /_i18n/LANG/resources/user-guides/GUIDE. At the top of the page a snippet will include 2 parameters:
- translated: "yes" if the page is translated, "no" if it's not.
- translationOutdated: "yes" if the translation is outdated, "no" if it's not
This new system aims to be simpler than the precedent, avoiding to compare versioning numbers and using a higher level
system instead (yes, no, True, False). I also removed the middle way status 'only minor changes', because if there are
only minor changes that don't affect the usability of the guide, we don't need to point it out.
The old system was complex and people didn't use it. These changes will hopefully make things easier for translators and
other contributors.
2020-05-03 13:38:01 +00:00
|
|
|
{% include disclaimer.html translated="yes" translationOutdated="no" %}
|
|
|
|
|
|
2021-09-10 07:37:07 +00:00
|
|
|
### Table of contents
|
2017-12-19 21:10:15 +00:00
|
|
|
|
2021-09-10 07:37:07 +00:00
|
|
|
- [When should I restore a wallet?](#when-should-i-restore-a-wallet)
|
2018-05-13 22:28:58 +00:00
|
|
|
|
2021-09-10 07:37:07 +00:00
|
|
|
- [What is needed to restore a wallet from mnemonic
|
|
|
|
|
seed?](#what-is-needed-to-restore-a-wallet-from-mnemonic-seed)
|
2017-12-19 21:10:15 +00:00
|
|
|
|
2021-09-10 07:37:07 +00:00
|
|
|
- [What is the wallet restore height?](#what-is-the-wallet-restore-height)
|
2017-12-19 21:10:15 +00:00
|
|
|
|
2021-09-10 07:37:07 +00:00
|
|
|
- [How to restore a wallet from mnemonic seed on Monero
|
|
|
|
|
GUI](#how-to-restore-a-wallet-from-mnemonic-seed-on-monero-gui)
|
2017-12-19 21:10:15 +00:00
|
|
|
|
2021-09-10 07:37:07 +00:00
|
|
|
- [How to restore a wallet from mnemonic seed on Monero
|
|
|
|
|
CLI](#how-to-restore-a-wallet-from-mnemonic-seed-on-monero-cli)
|
2017-12-19 21:10:15 +00:00
|
|
|
|
2021-09-10 07:37:07 +00:00
|
|
|
- [My restored wallet is showing a wrong
|
|
|
|
|
balance](#my-restored-wallet-is-showing-a-wrong-balance)
|
2017-12-19 21:10:15 +00:00
|
|
|
|
2021-09-10 07:37:07 +00:00
|
|
|
### When should I restore a wallet?
|
2017-12-19 21:10:15 +00:00
|
|
|
|
2021-09-10 07:37:07 +00:00
|
|
|
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.
|
2017-12-19 21:10:15 +00:00
|
|
|
|
2021-09-10 07:37:07 +00:00
|
|
|
This guide will teach you how to restore a Monero wallet from its
|
|
|
|
|
@mnemonic-seed.
|
2017-12-19 21:10:15 +00:00
|
|
|
|
2021-09-10 07:37:07 +00:00
|
|
|
If you want to restore a wallet from its private keys, please read [this
|
|
|
|
|
guide]({{site.baseurl}}/resources/user-guides/restore_from_keys.html).
|
2017-12-19 21:10:15 +00:00
|
|
|
|
2021-09-10 07:37:07 +00:00
|
|
|
### What is needed to restore a wallet from mnemonic seed?
|
2018-05-13 22:28:58 +00:00
|
|
|
|
2021-09-10 07:37:07 +00:00
|
|
|
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.
|
2018-05-13 22:28:58 +00:00
|
|
|
|
2021-09-10 07:37:07 +00:00
|
|
|
It is also useful to know your wallet restore height or the creation date of
|
|
|
|
|
your wallet, since it makes your wallet synchronization faster.
|
2018-05-13 22:28:58 +00:00
|
|
|
|
2021-09-10 07:37:07 +00:00
|
|
|
### Where can I find my mnemonic seed?
|
2018-05-13 22:28:58 +00:00
|
|
|
|
2021-09-10 07:37:07 +00:00
|
|
|
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.
|
2018-05-13 22:28:58 +00:00
|
|
|
|
2021-09-10 07:37:07 +00:00
|
|
|
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`.
|
2018-05-13 22:28:58 +00:00
|
|
|
|
2021-09-10 07:37:07 +00:00
|
|
|
### What is the wallet restore height?
|
2018-05-13 22:28:58 +00:00
|
|
|
|
2021-09-10 07:37:07 +00:00
|
|
|
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.
|
2018-05-13 22:28:58 +00:00
|
|
|
|
2021-09-10 07:37:07 +00:00
|
|
|
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.
|
2018-05-13 22:28:58 +00:00
|
|
|
|
2021-09-10 07:37:07 +00:00
|
|
|
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.
|
2018-05-13 22:28:58 +00:00
|
|
|
|
2021-09-10 07:37:07 +00:00
|
|
|
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.
|
2018-05-13 22:28:58 +00:00
|
|
|
|
2021-09-10 07:37:07 +00:00
|
|
|
|
2018-05-13 22:28:58 +00:00
|
|
|
|
2021-09-10 07:37:07 +00:00
|
|
|
### How to restore a wallet from mnemonic seed on Monero GUI
|
2018-05-13 22:28:58 +00:00
|
|
|
|
2021-09-10 07:37:07 +00:00
|
|
|
1) On the main menu, click on `Restore wallet from keys or mnemonic seed`.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
2) The `Restore wallet` page will be displayed:
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
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:
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Alternatively, you can also enter the date or an estimated date (YYYY-MM-DD
|
|
|
|
|
format) of the first incoming transaction:
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
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.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
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.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
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:
|
2018-05-13 22:28:58 +00:00
|
|
|
|
2020-10-31 14:42:04 +00:00
|
|
|
|
2021-09-10 07:37:07 +00:00
|
|
|
|
|
|
|
|
### 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.
|
