2020-10-30 18:25:31 +00:00
|
|
|
{% include disclaimer.html translated="yes" 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 13:38:01 +00:00
|
|
|
|
2021-07-12 14:57:49 +00:00
|
|
|
`monero-wallet-cli` is the wallet software shipped in the Monero
|
|
|
|
archives. It is a console program, and manages an account. While a bitcoin
|
|
|
|
wallet manages both an account and the blockchain, Monero separates these:
|
|
|
|
`monerod` handles the blockchain, and `monero-wallet-cli` handles the
|
|
|
|
account.
|
|
|
|
|
|
|
|
This guide will show how to perform various operations with
|
|
|
|
`monero-wallet-cli`. The guide assumes you are using the most recent version
|
|
|
|
of Monero and have already created an account according to the other guides.
|
2018-12-05 23:11:30 +00:00
|
|
|
|
2021-07-12 14:57:49 +00:00
|
|
|
## Overview
|
2018-12-05 23:11:30 +00:00
|
|
|
|
2021-07-12 14:57:49 +00:00
|
|
|
You can have a list of the most important commands by running `help`:
|
2018-12-05 23:11:30 +00:00
|
|
|
|
2021-07-12 14:57:49 +00:00
|
|
|
```
|
|
|
|
Important commands:
|
2018-12-05 23:11:30 +00:00
|
|
|
|
2021-07-12 14:57:49 +00:00
|
|
|
"welcome" - Show welcome message.
|
|
|
|
"help all" - Show the list of all available commands.
|
|
|
|
"help <command>" - Show a command's documentation.
|
|
|
|
"apropos <keyword>" - Show commands related to a keyword.
|
2018-12-05 23:11:30 +00:00
|
|
|
|
2021-07-12 14:57:49 +00:00
|
|
|
"wallet_info" - Show wallet main address and other info.
|
|
|
|
"balance" - Show balance.
|
|
|
|
"address all" - Show all addresses.
|
|
|
|
"address new [<label text with white spaces allowed>]" - Create new subaddress.
|
|
|
|
"transfer <address> <amount>" - Send XMR to an address.
|
|
|
|
"show_transfers [in|out|pending|failed|pool]" - Show transactions.
|
|
|
|
"sweep_all <address>" - Send whole balance to another wallet.
|
|
|
|
"seed" - Show secret 25 words that can be used to recover this wallet.
|
|
|
|
"refresh" - Synchronize wallet with the Monero network.
|
|
|
|
"status" - Check current status of wallet.
|
|
|
|
"version" - Check software version.
|
|
|
|
"exit" - Exit wallet.
|
2018-12-05 23:11:30 +00:00
|
|
|
|
2021-07-12 14:57:49 +00:00
|
|
|
"donate <amount>" - Donate XMR to the development team.
|
|
|
|
```
|
2018-12-05 23:11:30 +00:00
|
|
|
|
2021-07-12 14:57:49 +00:00
|
|
|
## Checking your balance
|
2018-12-05 23:11:30 +00:00
|
|
|
|
2021-07-12 14:57:49 +00:00
|
|
|
Da die Zuständigkeiten für Blockchain und Wallet bei verschiedenen
|
|
|
|
Programmen liegen, benötigen einige Dienste des `monero-wallet-cli` eine
|
|
|
|
Verbindung mit einem Hintergrunddienst (darunter die Suche nach eingehenden
|
|
|
|
Transaktionen). Sobald du sowohl `monero-wallet-cli` wie auch `monerod`
|
|
|
|
gestartet hast, kannst du `balance` eingeben.
|
2018-12-05 23:11:30 +00:00
|
|
|
|
2021-07-12 14:57:49 +00:00
|
|
|
Output:
|
|
|
|
|
|
|
|
```
|
|
|
|
Currently selected account: [0] Primary account
|
|
|
|
Tag: (No tag assigned)
|
|
|
|
Balance: 7.499942880000, unlocked balance: 7.499942880000
|
|
|
|
```
|
2018-12-05 23:11:30 +00:00
|
|
|
|
2021-07-12 14:57:49 +00:00
|
|
|
In this example you're viewing the balance of your primary account (with
|
|
|
|
index `[0]`). `Balance` is your total balance. The `unlocked balance` is the
|
|
|
|
amount currently available to spend. Newly received transactions require 10
|
|
|
|
confirmations on the blockchain before being unlocked.
|
2018-12-05 23:11:30 +00:00
|
|
|
|
2021-07-12 14:57:49 +00:00
|
|
|
## Sending monero
|
2018-12-05 23:11:30 +00:00
|
|
|
|
2021-07-12 14:57:49 +00:00
|
|
|
You will need the standard address you want to send to (a long string
|
|
|
|
starting with '4' or a '8'). The command structure is:
|
2018-12-05 23:11:30 +00:00
|
|
|
|
2021-07-12 14:57:49 +00:00
|
|
|
```
|
|
|
|
transfer ADDRESS AMOUNT
|
|
|
|
```
|
2018-12-05 23:11:30 +00:00
|
|
|
|
2021-07-12 14:57:49 +00:00
|
|
|
Replace `ADDRESS` with the address you want to send to and `AMOUNT` with how
|
|
|
|
many monero you want to send.
|
2018-12-05 23:11:30 +00:00
|
|
|
|
2021-07-12 14:57:49 +00:00
|
|
|
## Receiving monero
|
2018-12-05 23:11:30 +00:00
|
|
|
|
2021-07-12 14:57:49 +00:00
|
|
|
If you have your own Monero address, you just need to give your address to
|
|
|
|
someone.
|
2018-12-05 23:11:30 +00:00
|
|
|
|
2021-07-12 14:57:49 +00:00
|
|
|
You can find out your primary address with:
|
2018-12-05 23:11:30 +00:00
|
|
|
|
2021-07-12 14:57:49 +00:00
|
|
|
```
|
|
|
|
address
|
|
|
|
```
|
2018-12-05 23:11:30 +00:00
|
|
|
|
2021-07-12 14:57:49 +00:00
|
|
|
Since Monero is anonymous, you won't see the origin address the funds you
|
|
|
|
receive came from. If you want to know, for instance to credit a particular
|
|
|
|
customer, you'll have to tell the sender to use a payment ID, which is an
|
|
|
|
arbitrary optional tag which gets attached to a transaction. It's not
|
|
|
|
possible to use standalone payment addresses, but you can generate an
|
|
|
|
address that already includes a random payment ID (integrated addresss)
|
|
|
|
using `integrated_address`:
|
2018-12-05 23:11:30 +00:00
|
|
|
|
2021-07-12 14:57:49 +00:00
|
|
|
```
|
|
|
|
Random payment ID: <82d79055f3b27f56>
|
|
|
|
Matching integrated address: 4KHQkZ4MmVePC2yau6Mb8vhuGGy8LVdsZD8CFcQJvr4BSTfC5AQX3aXCn5RiDPjvsEHiJu1TC1ybR8pRTCbZM5bhTrAD3HDwWMtAn1K7nV
|
|
|
|
```
|
2018-12-05 23:11:30 +00:00
|
|
|
|
2021-07-12 14:57:49 +00:00
|
|
|
This will generate a random payment ID, and give you the address that
|
|
|
|
includes your own account and that payment ID. If you want to select a
|
|
|
|
particular payment ID, you can do that too. Use:
|
2018-12-05 23:11:30 +00:00
|
|
|
|
2021-07-12 14:57:49 +00:00
|
|
|
```
|
|
|
|
integrated_address 82d79055f3b27f56
|
|
|
|
```
|
2018-12-05 23:11:30 +00:00
|
|
|
|
2021-07-12 14:57:49 +00:00
|
|
|
Payments made to an integrated address generated from your account will go
|
|
|
|
to your account, with that payment ID attached, so you can tell payments
|
|
|
|
apart.
|
2018-12-05 23:11:30 +00:00
|
|
|
|
2021-07-12 14:57:49 +00:00
|
|
|
### Using subaddresses
|
2018-12-05 23:11:30 +00:00
|
|
|
|
2021-07-12 14:57:49 +00:00
|
|
|
It's suggested to use subaddresses (starting with `8`) instead of your main
|
|
|
|
address (starting with `4`) to receive funds. Run:
|
2018-12-05 23:11:30 +00:00
|
|
|
|
2021-07-12 14:57:49 +00:00
|
|
|
```
|
|
|
|
address new [<label text with white spaces allowed>]
|
|
|
|
```
|
2018-12-05 23:11:30 +00:00
|
|
|
|
2021-07-12 14:57:49 +00:00
|
|
|
This will generate a subaddress and its optional label, which addess you can
|
|
|
|
share to receive payment on the account it's linked to. For example,
|
2018-12-05 23:11:30 +00:00
|
|
|
|
2021-07-12 14:57:49 +00:00
|
|
|
```
|
|
|
|
address new github_donations
|
|
|
|
```
|
2018-12-05 23:11:30 +00:00
|
|
|
|
2021-07-12 14:57:49 +00:00
|
|
|
will generate a subaddress and its label 'github_donations'.
|
2018-12-05 23:11:30 +00:00
|
|
|
|
2021-07-12 14:57:49 +00:00
|
|
|
To view all generated addresses, run:
|
2018-12-05 23:11:30 +00:00
|
|
|
|
2021-07-12 14:57:49 +00:00
|
|
|
```
|
|
|
|
address all
|
|
|
|
```
|
2018-12-05 23:11:30 +00:00
|
|
|
|
2021-07-12 14:57:49 +00:00
|
|
|
## Proving to a third party you paid someone
|
2018-12-05 23:11:30 +00:00
|
|
|
|
2021-07-12 14:57:49 +00:00
|
|
|
Solltest du einen Händler bezahlt haben, dieser aber bestreiten, das Geld
|
|
|
|
empfangen zu haben, kann es passieren, dass du deine Zahlung gegenüber
|
|
|
|
Dritten nachweisen musst - oder sogar gegenüber des Händlers, sofern es ein
|
|
|
|
ehrlicher Fehler seinerseits war. Da Monero privat ist und man nicht
|
|
|
|
ausmachen kann, wer Gelder empfangen oder gesendet hat, kannst du nicht
|
|
|
|
einfach auf deine Transaktion in der Blockchain verweisen. Durch
|
|
|
|
Bereitstellen des privaten, pro Transaktion vertraulichen Schlüssels ist es
|
|
|
|
Dritten allerdings möglich, zu sehen, ob in dieser Transaktion Monero an die
|
|
|
|
jeweilige Adresse gesendet wurden. Beachte, dass das Abspeichern dieser
|
|
|
|
Transaktionsschlüssel standardmäßig deaktiviert ist. Wenn du denkst, du
|
|
|
|
könntest diese Funktion gebrauchen, musst du sie vor dem Senden einschalten:
|
2018-12-05 23:11:30 +00:00
|
|
|
|
2021-07-12 14:57:49 +00:00
|
|
|
```
|
|
|
|
set store-tx-info 1
|
|
|
|
```
|
2018-12-05 23:11:30 +00:00
|
|
|
|
2021-07-12 14:57:49 +00:00
|
|
|
Du kannst den Transaktionsschlüssel einer früheren Transaktion abrufen:
|
2018-12-05 23:11:30 +00:00
|
|
|
|
2021-07-12 14:57:49 +00:00
|
|
|
```
|
|
|
|
get_tx_key 1234567890123456789012345678901212345678901234567890123456789012
|
|
|
|
```
|
2018-12-05 23:11:30 +00:00
|
|
|
|
2021-07-12 14:57:49 +00:00
|
|
|
Gib die Transaktions-ID, deren Schlüssel du benötigst, ein. Vergiss nicht,
|
|
|
|
dass eine Zahlung mit verschiedenen Einzeltransaktionen getätigt werden
|
|
|
|
kann; es kann also sein, dass du mehrere Schlüssel brauchst. Du kannst
|
|
|
|
diese(n) Schlüssel (zusammen mit der Transaktions-ID und der
|
|
|
|
Empfangsadresse) anschließend an denjenigen schicken, dem du einen Nachweis
|
|
|
|
über deine Transaktion erbringen möchtest. Bedenke, dass der entsprechende
|
|
|
|
Dritte - sollte er deine eigene Adresse kennen - sehen kann, wie viel
|
|
|
|
Wechselgeld an dich zurückgegangen ist.
|
2018-12-05 23:11:30 +00:00
|
|
|
|
2021-07-12 14:57:49 +00:00
|
|
|
Wenn du dieser Dritte bist (weil dir jemand beweisen möchte, dass er Monero
|
|
|
|
an eine Adresse gesendet hat), kannst du den Nachweis folgendermaßen
|
|
|
|
überprüfen:
|
2018-12-05 23:11:30 +00:00
|
|
|
|
2021-07-12 14:57:49 +00:00
|
|
|
```
|
|
|
|
check_tx_key TXID TXKEY ADDRESS
|
|
|
|
```
|
2018-12-05 23:11:30 +00:00
|
|
|
|
2021-07-12 14:57:49 +00:00
|
|
|
Replace `TXID`, `TXKEY` and `ADDRESS` with the transaction ID,
|
|
|
|
per-transaction key, and destination address which were supplied to you,
|
|
|
|
respectively. `monero-wallet-cli` will check that transaction and let you
|
|
|
|
know how much monero this transaction paid to the given address.
|
2018-12-05 23:11:30 +00:00
|
|
|
|
2021-07-12 14:57:49 +00:00
|
|
|
## How to find a payment to you
|
2018-12-05 23:11:30 +00:00
|
|
|
|
2021-07-12 14:57:49 +00:00
|
|
|
Hast du eine Zahlung mit einer bestimmten Zahlungs-ID erhalten, kannst du
|
|
|
|
diese folgendermaßen aufsuchen:
|
2018-12-05 23:11:30 +00:00
|
|
|
|
2021-07-12 14:57:49 +00:00
|
|
|
```
|
|
|
|
payments PAYMENTID
|
|
|
|
```
|
2018-12-05 23:11:30 +00:00
|
|
|
|
2020-10-30 18:25:31 +00:00
|
|
|
Du kannst auch mehr als eine Zahlungs-ID eingeben.
|
2018-12-05 23:11:30 +00:00
|
|
|
|
2020-10-30 18:25:31 +00:00
|
|
|
Grundsätzlich kannst du ein- und ausgehende Zahlungen wie folgt prüfen:
|
2018-12-05 23:11:30 +00:00
|
|
|
|
2021-07-12 14:57:49 +00:00
|
|
|
```
|
|
|
|
show_transfers
|
|
|
|
```
|
2018-12-05 23:11:30 +00:00
|
|
|
|
2021-07-12 14:57:49 +00:00
|
|
|
Du kannst zur Anzeige jüngerer Transaktionen eine bestimmte Höhe setzen und
|
|
|
|
nur eingehende oder nur ausgehende Transaktionen abfragen, zum Beispiel
|
|
|
|
zeigt
|
2018-12-05 23:11:30 +00:00
|
|
|
|
2021-07-12 14:57:49 +00:00
|
|
|
```
|
|
|
|
show_transfers in 650000
|
|
|
|
```
|
2018-12-05 23:11:30 +00:00
|
|
|
|
2021-07-12 14:57:49 +00:00
|
|
|
nur die eingegangen Transaktionen nach dem Block 650000 an. Du kannst
|
|
|
|
außerdem einen Höhenbereich festlegen.
|
2018-12-05 23:11:30 +00:00
|
|
|
|
2020-10-30 18:25:31 +00:00
|
|
|
Falls du minen möchtest, kannst du dies vom Wallet aus tun:
|
2018-12-05 23:11:30 +00:00
|
|
|
|
2021-07-12 14:57:49 +00:00
|
|
|
```
|
|
|
|
start_mining 2
|
|
|
|
```
|
2018-12-05 23:11:30 +00:00
|
|
|
|
2021-07-12 14:57:49 +00:00
|
|
|
Hierdurch startet das Mining mit dem Hintergrunddienst unter Gebrauch zweier
|
|
|
|
Threads. Bedenke, dass dieses Solomining eine Weile dauern kann, bis du
|
|
|
|
einen Block findest. Du beendest das Minen mit
|
2018-12-05 23:11:30 +00:00
|
|
|
|
2021-07-12 14:57:49 +00:00
|
|
|
```
|
|
|
|
stop_mining
|
|
|
|
```
|