monero-wallet-cli.md 6.6 KB
Newer Older
1
2
3
4
5
6
7
8
9
10
---
layout: static_page
title: "Monero tools"
title-pre-kick: "Monero tools "
title-kick: "for the network "
title-post-kick: ""
kick-class: "purple-kicks"
icon: "icon_userguides"
attribution: "<!-- Icon is based on work by Freepik (http://www.freepik.com) and is licensed under Creative Commons BY 3.0 -->"
---
11
# monero-wallet-cli
12

13
`monero-wallet-cli` is the wallet software that ships with the Monero tree. It is a console program,
14
and manages an account. While a bitcoin wallet manages both an account and the blockchain,
15
Monero separates these: `monerod` handles the blockchain, and `monero-wallet-cli` handles the account.
16

17
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 the Monero Core software *(currently 0.9.0.0 Hydrogen Helix)*, and have already created an account according to the other guides.
18
19
20
21


## Checking your balance

22
Since the blockchain handling and the wallet are separate programs, many uses of `monero-wallet-cli`
23
need to work with the daemon. This includes looking for incoming transactions to your address.
24
Once you are running both `monero-wallet-cli` and `monerod`, enter `balance`.
25

26
Example:
27
28

This will pull blocks from the daemon the wallet did not yet see, and update your balance
29
30
to match. This process will normally be done in the background every minute or so. To see the
balance without refreshing:
31

32
33
34
35
    balance
    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.
36
37
38
39
40

## Sending monero

You will need the standard address you want to send to (a long string starting with '4'), and
possibly a payment ID, if the receiving party requires one. In that latter case, that party
41
may instead give you an integrated address, which is both of these packed into a single address.
42

43
### Sending to a standard address:
44

45
    transfer ADDRESS AMOUNT PAYMENTID
46

47
Replace ADDRESS with the address you want to send to, AMOUNT with how many monero you want to send.
48
and PAYMENTID with the payment ID you were given. If the receiving party doesn't need one, just
Riccardo Spagni's avatar
Riccardo Spagni committed
49
=======
50
51
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
52
53
omit it.

54
### Sending to an integrated address:
55

56
    transfer ADDRESS AMOUNT
57
58
59

The payment ID is implicit in the integrated address in that case.

60
61
62
63
64
### Specify the mixin for a transaction:

    transfer MIXIN ADDRESS AMOUNT

Replace `MIXIN` with the mixin amount you wish to use. **If not specified, the default mixin is 4.** It's a good idea to use the default, but you can increase the number if you want to mix with more outputs. The higher the mixin, the larger the transaction, and higher fees are needed.
65
66
67
68
69


## Receiving monero

If you have your own Monero address, you just need to give your standard address to someone.
Riccardo Spagni's avatar
Riccardo Spagni committed
70

71
72
73
74
75
76
77
78
You can find out your address with:

  address

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. To make life
easier, you can generate an address that already includes a random payment ID:
79

80
    integrated_address
81
82

This will generate a random payment ID, and give you the address that includes your own account
83
and that payment ID. If you want to select a particular payment ID, you can do that too:
84

85
    integrated_address 12346780abcdef00
86

87
88
89
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.

90
91
92
93
94
95
96
97
98
99
100

## Proving to a third party you paid someone

If you pay a merchant, and the merchant claims to not have received the funds, you may need
to prove to a third party you did send the funds - or even to the merchant, if it is a honest
mistake. Monero is private, so you can't just point to your transaction in the blockchain,
as you can't tell who sent it, and who received it. However, by supplying the per-transaction
private key to a party, that party can tell whether that transaction sent monero to that
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:

101
    set store-tx-keys 1
102

103
You can retrieve the tx key from an earlier transaction:
104

105
    get_tx_key 1234567890123456789012345678901212345678901234567890123456789012
106
107
108
109
110
111
112
113
114
115

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,
or these keys, to whoever you want to provide proof of your transaction, along with the
transaction id and the address you sent to. Note that this third party, if knowing your
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
to an address), then you can check this way:

116
    check_tx_key TXID TXKEY ADDRESS
117

118
Replace `TXID`, `TXKEY` and `ADDRESS` with the transaction ID, per-transaction key, and destination
119
address which were supplied to you, respectively. monero-wallet-cli will check that transaction
120
121
122
123
124
125
126
127
128
129
130
131
132
133
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

If you received a payment using a particular payment ID, you can look it up:

134
    payments PAYMENTID
135
136
137

You can give more than one payment ID too.

138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
More generally, you can review incoming and outgoing payments:

  show_transfers

You can give an optional height to list only recent transactions, and request
only incoming or outgoing transactions. For example,

  show_transfers in 650000

will only incoming transfers after block 650000. You can also give a height
range.

If you want to mine, you can do so from the wallet:

  start_mining 2

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:

  stop_mining