2015-10-27 18:18:26 +00:00
|
|
|
---
|
|
|
|
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 -->"
|
|
|
|
---
|
|
|
|
# simplewallet
|
|
|
|
|
|
|
|
simplewallet is the wallet software that ships with the monero tree. It is a console program,
|
|
|
|
and manages an account (while a bitcoin wallet manages both an account and the blockchain,
|
|
|
|
Monero separates these: bitmonerod handles the blockchain, and simplewallet handles the account).
|
|
|
|
|
|
|
|
This guide assumes you already have created an account, according to the other guides, and
|
|
|
|
will show how to perform various operations from the simplewallet UI.
|
|
|
|
|
|
|
|
|
|
|
|
## Checking your balance
|
|
|
|
|
|
|
|
Since the blockchain handling and the wallet are separate programs, many uses of simplewallet
|
|
|
|
need to work with the daemon. This includes looking for incoming transactions to your address.
|
|
|
|
Once you are running both simplewallet and bitmonerod, refresh the wallet's idea of the blockchain:
|
|
|
|
|
|
|
|
refresh
|
|
|
|
|
|
|
|
This will pull blocks from the daemon the wallet did not yet see, and update your balance
|
2015-12-30 11:58:59 +00:00
|
|
|
to match. This process will normally be done in the background every minute or so. To see the
|
|
|
|
balance without refreshing:
|
2015-10-27 18:18:26 +00:00
|
|
|
|
|
|
|
balance
|
|
|
|
|
|
|
|
|
|
|
|
## 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
|
|
|
|
may instead give you an integrated address, which is both of these packed into a single address
|
|
|
|
(integrated address do not start with 4, but A).
|
|
|
|
|
|
|
|
This is the command to use when you are sending to a standard address:
|
|
|
|
|
|
|
|
transfer 3 ADDRESS AMOUNT PAYMENTID
|
|
|
|
|
2015-12-30 11:58:59 +00:00
|
|
|
Replace ADDRESS with the address you want to send to, AMOUNT with how many monero you want to send.
|
2015-10-27 18:18:26 +00:00
|
|
|
and PAYMENTID with the payment ID you were given. If the receiving party doesn't need one, just
|
|
|
|
omit it.
|
|
|
|
|
|
|
|
If you have an integrated address to send to:
|
|
|
|
|
|
|
|
transfer 3 ADDRESS AMOUNT
|
|
|
|
|
|
|
|
The payment ID is implicit in the integrated address in that case.
|
|
|
|
|
|
|
|
The 3 above is the mixin. It's a good idea to leave it to 3, but you can increase the number if
|
|
|
|
you want to mix with more outputs. The higher the mixin, the larger the transaction, and the
|
|
|
|
higher fees needed.
|
|
|
|
|
|
|
|
|
|
|
|
## Receiving monero
|
|
|
|
|
|
|
|
If you have your own Monero address, you just need to give your standard address to someone.
|
2015-12-30 11:58:59 +00:00
|
|
|
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:
|
2015-10-27 18:18:26 +00:00
|
|
|
|
|
|
|
integrated_address
|
|
|
|
|
|
|
|
This will generate a random payment ID, and give you the address that includes your own account
|
2015-12-30 11:58:59 +00:00
|
|
|
and that payment ID. If you want to select a particular payment ID, you can do that too:
|
2015-10-27 18:18:26 +00:00
|
|
|
|
|
|
|
integrated_address 12346780abcdef00
|
|
|
|
|
2015-12-30 11:58:59 +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.
|
|
|
|
|
2015-10-27 18:18:26 +00:00
|
|
|
|
|
|
|
## 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
|
2015-12-30 11:58:59 +00:00
|
|
|
particular address.
|
2015-10-27 18:18:26 +00:00
|
|
|
|
2015-12-30 11:58:59 +00:00
|
|
|
You can retrieve the tx key from an earlier transaction:
|
2015-10-27 18:18:26 +00:00
|
|
|
|
|
|
|
get_tx_key 1234567890123456789012345678901212345678901234567890123456789012
|
|
|
|
|
|
|
|
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:
|
|
|
|
|
|
|
|
check_tx_key TXID TXKEY ADDRESS
|
|
|
|
|
|
|
|
Replace TXID, TXKEY and ADDRESS with the transaction ID, per-transaction key, and destination
|
|
|
|
address which were supplied to you, respectively. simplewallet will check that transaction
|
|
|
|
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:
|
|
|
|
|
|
|
|
payments PAYMENTID
|
|
|
|
|
|
|
|
You can give more than one payment ID too.
|
|
|
|
|
2015-12-30 11:58:59 +00:00
|
|
|
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
|
|
|
|
|