monero-site/_i18n/ar/resources/user-guides/view_only.md

56 lines
3.2 KiB
Markdown
Raw Normal View History

2021-04-02 10:27:34 +03:00
{% include disclaimer.html translated="no" translationOutdated="no" %}
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 16:38:01 +03:00
2021-04-02 10:27:34 +03:00
A view-only wallet is a special type of wallet that can only see incoming transactions. Since it doesn't hold your mnemonic seed and private spend key, it can't sign transactions and it can't see outgoing transactions. This makes them particularly interesting for
2018-07-16 16:13:48 +03:00
2021-04-02 10:27:34 +03:00
* Validate incoming transactions to cold wallets or hardware wallets
* Monitor incoming donations to a fundraising campaign
* Developers writing libraries to validate payments
2018-07-16 16:13:48 +03:00
2021-04-02 10:27:34 +03:00
View-only wallets cannot sign transactions, therefore they can't spend a balance alone. However, they can be used as part of an offline transaction signing, by creating unsigned transactions to be signed offline in a cold device, and later by sending the signed transaction to the network.
2018-07-16 16:13:48 +03:00
2021-04-02 10:27:34 +03:00
If your wallet has outgoing transactions, the balance displayed will not be correct. To get a correct balance in a view-only wallet, you have to import the accompanying key images of each output of the wallet.
2018-07-16 16:13:48 +03:00
2021-04-02 10:27:34 +03:00
You can also create a view-only wallet of a hardware wallet, however this kind of view-only wallet doesn't support offline transaction signing and importing of key images.
2018-07-16 16:13:48 +03:00
2021-04-02 10:27:34 +03:00
In order to create a view-only wallet, you must either have access to a wallet or know the main address and the private view key from a wallet.
2018-07-16 16:13:48 +03:00
2021-04-02 10:27:34 +03:00
### CLI: Creating a View-Only Wallet from a Private View Key
2018-07-16 16:13:48 +03:00
2021-04-02 10:27:34 +03:00
Open an existing wallet and type `address` and `viewkey` commands to display the wallet's address and its private (secret) view key. Type `exit` to close the wallet.
2018-07-16 16:13:48 +03:00
2021-04-02 10:27:34 +03:00
Next, create your view-only wallet by typing `monero-wallet-cli --generate-from-view-key wallet-name`. The last argument will be your new wallet's file name. You will be prompted for `Standard address` and `View key` by the wallet. Paste in your original wallet's address and private (secret) view key. Next, enter and confirm a password for your new wallet.
### GUI: Creating a View-Only Wallet from an Existing Wallet File
If you have access to the existing wallet, open your wallet and go to `Settings` > `Wallet` > `Create a view-only wallet`:
2018-07-16 16:13:48 +03:00
![settings](/img/resources/user-guides/en/view-only/settings.png)
2018-07-16 16:13:48 +03:00
2021-04-02 10:27:34 +03:00
The view-only wallet file will be created within the same directory and using your current password.
2018-07-16 16:13:48 +03:00
2021-04-02 10:27:34 +03:00
Optionally, double-click the `Success` window to copy the message, then click `OK` to close it:
2018-07-16 16:13:48 +03:00
![Success](/img/resources/user-guides/en/view-only/Success.png)
2021-04-02 10:27:34 +03:00
### GUI: Creating a View-only Wallet from a Private View Key
If you don't have access to the existing wallet, you can create a view-only wallet by knowing the wallet's main address and its private view key.
In order to do that, go to the main Menu and click on `Restore wallet from keys or mnemonic seed`:
![restore-view-only](/img/resources/user-guides/en/view-only/restore-view-only.png)
Enter a name for you view-only wallet file. Optionally, you can change the file location.
Select `Restore from keys`.
In `Account address (public)` field, enter your wallet's main address, which starts with 4.
In `View key (private)` field, enter the private view key of your wallet.
Leave the `Spend key (private)` field blank.
Enter a `Wallet creation date` or a `Restore height` if you have one (optional).
Click on `Next` to create your view-only wallet file.