mirror of
https://github.com/monero-project/monero-site.git
synced 2024-12-13 20:06:35 +02:00
commit
a8b4f0a3f2
@ -1,11 +1,38 @@
|
|||||||
{% include disclaimer.html translated="no" translationOutdated="no" %}
|
{% include disclaimer.html translated="no" translationOutdated="no" %}
|
||||||
|
|
||||||
`monero-wallet-cli` is the wallet software that ships with the Monero tree. It is a console program,
|
`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,
|
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.
|
Monero separates these: `monerod` handles the blockchain, and `monero-wallet-cli` handles the account.
|
||||||
|
|
||||||
This guide will show how to perform various operations from the `monero-wallet-cli` UI. The guide assumes you are using the most recent version of Monero and have already created an account according to the other guides.
|
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.
|
||||||
|
|
||||||
|
## Overview
|
||||||
|
|
||||||
|
You can have a list of the most important commands by running `help`:
|
||||||
|
|
||||||
|
```
|
||||||
|
Important commands:
|
||||||
|
|
||||||
|
"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.
|
||||||
|
|
||||||
|
"wallet_info" - Show wallet main address and other info.
|
||||||
|
"balance" - Show balance.
|
||||||
|
"address all" - Show all addresses.
|
||||||
|
"address new" - 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.
|
||||||
|
|
||||||
|
"donate <amount>" - Donate XMR to the development team.
|
||||||
|
```
|
||||||
|
|
||||||
## Checking your balance
|
## Checking your balance
|
||||||
|
|
||||||
@ -13,67 +40,68 @@ Since the blockchain handling and the wallet are separate programs, many uses of
|
|||||||
need to work with the @daemon. This includes looking for incoming transactions to your address.
|
need to work with the @daemon. This includes looking for incoming transactions to your address.
|
||||||
Once you are running both `monero-wallet-cli` and `monerod`, enter `balance`.
|
Once you are running both `monero-wallet-cli` and `monerod`, enter `balance`.
|
||||||
|
|
||||||
Example:
|
Output:
|
||||||
|
|
||||||
This will pull blocks from the daemon the wallet did not yet see, and update your balance
|
```
|
||||||
to match. This process will normally be done in the background every minute or so. To see the
|
Currently selected account: [0] Primary account
|
||||||
balance without refreshing:
|
Tag: (No tag assigned)
|
||||||
|
Balance: 7.499942880000, unlocked balance: 7.499942880000
|
||||||
|
```
|
||||||
|
|
||||||
balance
|
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.
|
||||||
Balance: 64.526198850000, unlocked balance: 44.526198850000, including unlocked dust: 0.006198850000
|
|
||||||
|
|
||||||
In this example, `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. `unlocked dust` refers to very small amounts of unspent outputs that may have accumulated in your account.
|
|
||||||
|
|
||||||
## Sending monero
|
## Sending monero
|
||||||
|
|
||||||
You will need the standard address you want to send to (a long string starting with '4'), and
|
You will need the standard address you want to send to (a long string starting with '4' or a '8'). The command structure is:
|
||||||
possibly a payment ID, if the receiving party requires one. In that latter case, that party
|
|
||||||
may instead give you an integrated address, which is both of these packed into a single address.
|
|
||||||
|
|
||||||
### Sending to a standard address:
|
```
|
||||||
|
transfer ADDRESS AMOUNT
|
||||||
transfer ADDRESS AMOUNT PAYMENTID
|
```
|
||||||
|
|
||||||
Replace `ADDRESS` with the address you want to send to, `AMOUNT` with how many monero you want to send,
|
|
||||||
and `PAYMENTID` with the payment ID you were given. Payment ID's are optional. If the receiving party doesn't need one, just
|
|
||||||
omit it.
|
|
||||||
|
|
||||||
### Sending to an integrated address:
|
|
||||||
|
|
||||||
transfer ADDRESS AMOUNT
|
|
||||||
|
|
||||||
The payment ID is implicit in the integrated address in that case.
|
|
||||||
|
|
||||||
### Specify the number of outputs for a transaction:
|
|
||||||
|
|
||||||
transfer RINGSIZE ADDRESS AMOUNT
|
|
||||||
|
|
||||||
Replace `RINGSIZE` with the number of outputs you wish to use. **If not specified, the default is 11.** It's a good idea to use the default, but you can increase the number if you want to include more outputs. The higher the number, the larger the transaction, and higher fees are needed.
|
|
||||||
|
|
||||||
|
Replace `ADDRESS` with the address you want to send to and `AMOUNT` with how many monero you want to send.
|
||||||
|
|
||||||
## Receiving monero
|
## Receiving monero
|
||||||
|
|
||||||
If you have your own Monero address, you just need to give your standard address to someone.
|
If you have your own Monero address, you just need to give your address to someone.
|
||||||
|
|
||||||
You can find out your address with:
|
You can find out your primary address with:
|
||||||
|
|
||||||
address
|
```
|
||||||
|
address
|
||||||
|
```
|
||||||
|
|
||||||
Since Monero is anonymous, you won't see the origin address the funds you receive came from. If you
|
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
|
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. To make life
|
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`:
|
||||||
easier, you can generate an address that already includes a random payment ID:
|
|
||||||
|
|
||||||
integrated_address
|
```
|
||||||
|
Random payment ID: <82d79055f3b27f56>
|
||||||
|
Matching integrated address: 4KHQkZ4MmVePC2yau6Mb8vhuGGy8LVdsZD8CFcQJvr4BSTfC5AQX3aXCn5RiDPjvsEHiJu1TC1ybR8pRTCbZM5bhTrAD3HDwWMtAn1K7nV
|
||||||
|
```
|
||||||
|
|
||||||
This will generate a random payment ID, and give you the address that includes your own account
|
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:
|
and that payment ID. If you want to select a particular payment ID, you can do that too. Use:
|
||||||
|
|
||||||
integrated_address 12346780abcdef00
|
```
|
||||||
|
integrated_address 82d79055f3b27f56
|
||||||
|
```
|
||||||
|
|
||||||
Payments made to an integrated address generated from your account will go to your account,
|
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.
|
with that payment ID attached, so you can tell payments apart.
|
||||||
|
|
||||||
|
### Using subaddresses
|
||||||
|
|
||||||
|
It's suggested to use subaddresses (starting with `8`) instead of your main address (starting with `4`) to receive funds. Run:
|
||||||
|
|
||||||
|
```
|
||||||
|
address new
|
||||||
|
```
|
||||||
|
|
||||||
|
This will generate a subaddress, which you can share to receive payment on the account it's linked to. To view all generated addresses, run:
|
||||||
|
|
||||||
|
```
|
||||||
|
address list
|
||||||
|
```
|
||||||
|
|
||||||
## Proving to a third party you paid someone
|
## Proving to a third party you paid someone
|
||||||
|
|
||||||
@ -85,11 +113,15 @@ private key to a party, that party can tell whether that transaction sent monero
|
|||||||
particular address. Note that storing these per-transaction keys is disabled by default, and
|
particular address. Note that storing these per-transaction keys is disabled by default, and
|
||||||
you will have to enable it before sending, if you think you may need it:
|
you will have to enable it before sending, if you think you may need it:
|
||||||
|
|
||||||
set store-tx-info 1
|
```
|
||||||
|
set store-tx-info 1
|
||||||
|
```
|
||||||
|
|
||||||
You can retrieve the tx key from an earlier transaction:
|
You can retrieve the tx key from an earlier transaction:
|
||||||
|
|
||||||
get_tx_key 1234567890123456789012345678901212345678901234567890123456789012
|
```
|
||||||
|
get_tx_key 1234567890123456789012345678901212345678901234567890123456789012
|
||||||
|
```
|
||||||
|
|
||||||
Pass in the transaction ID you want the key for. Remember that a payment might have been
|
Pass in the transaction ID you want the key for. Remember that a payment might have been
|
||||||
split in more than one transaction, so you may need several keys. You can then send that key,
|
split in more than one transaction, so you may need several keys. You can then send that key,
|
||||||
@ -100,46 +132,49 @@ own address, will be able to see how much change was returned to you as well.
|
|||||||
If you are the third party (that is, someone wants to prove to you that they sent monero
|
If you are the third party (that is, someone wants to prove to you that they sent monero
|
||||||
to an address), then you can check this way:
|
to an address), then you can check this way:
|
||||||
|
|
||||||
check_tx_key TXID TXKEY ADDRESS
|
```
|
||||||
|
check_tx_key TXID TXKEY ADDRESS
|
||||||
|
```
|
||||||
|
|
||||||
Replace `TXID`, `TXKEY` and `ADDRESS` with the transaction ID, per-transaction key, and destination
|
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
|
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.
|
and let you know how much monero this transaction paid to the given address.
|
||||||
|
|
||||||
|
|
||||||
## Getting a chance to confirm/cancel payments
|
|
||||||
|
|
||||||
If you want to get a last chance confirmation when sending a payment:
|
|
||||||
|
|
||||||
set always-confirm-transfers 1
|
|
||||||
|
|
||||||
|
|
||||||
## How to find a payment to you
|
## How to find a payment to you
|
||||||
|
|
||||||
If you received a payment using a particular payment ID, you can look it up:
|
If you received a payment using a particular payment ID, you can look it up:
|
||||||
|
|
||||||
payments PAYMENTID
|
```
|
||||||
|
payments PAYMENTID
|
||||||
|
```
|
||||||
|
|
||||||
You can give more than one payment ID too.
|
You can give more than one payment ID too.
|
||||||
|
|
||||||
More generally, you can review incoming and outgoing payments:
|
More generally, you can review incoming and outgoing payments:
|
||||||
|
|
||||||
show_transfers
|
```
|
||||||
|
show_transfers
|
||||||
|
```
|
||||||
|
|
||||||
You can give an optional height to list only recent transactions, and request
|
You can give an optional height to list only recent transactions, and request
|
||||||
only incoming or outgoing transactions. For example,
|
only incoming or outgoing transactions. For example,
|
||||||
|
|
||||||
show_transfers in 650000
|
```
|
||||||
|
show_transfers in 650000
|
||||||
|
```
|
||||||
|
|
||||||
will only show incoming transfers after block 650000. You can also give a height
|
will only show incoming transfers after block 650000. You can also give a height
|
||||||
range.
|
range.
|
||||||
|
|
||||||
If you want to mine, you can do so from the wallet:
|
If you want to mine, you can do so from the wallet:
|
||||||
|
|
||||||
start_mining 2
|
```
|
||||||
|
start_mining 2
|
||||||
|
```
|
||||||
|
|
||||||
This will start mining on the daemon usin two threads. Note that this is solo mining,
|
This will start mining on the daemon usin two threads. Note that this is solo mining,
|
||||||
and may take a while before you find a block. To stop mining:
|
and may take a while before you find a block. To stop mining:
|
||||||
|
|
||||||
stop_mining
|
```
|
||||||
|
stop_mining
|
||||||
|
```
|
||||||
|
Loading…
Reference in New Issue
Block a user