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.
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 [<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."donate <amount>" - Donate XMR to the development team.Checking your balance
Since the blockchain handling and the wallet are separate programs, many uses of monero-wallet-clineed 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.
Output:
Currently selected account: [0] Primary accountTag: (No tag assigned)Balance: 7.499942880000, unlocked balance: 7.499942880000In 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.
Sending monero
You will need the standard address you want to send to (a long string starting with '4' or a '8'). The command structure is:
transfer ADDRESS AMOUNTReplace ADDRESS with the address you want to send to and AMOUNT with how many monero you want to send.
Receiving monero
If you have your own Monero address, you just need to give your address to someone.
You can find out your primary address with:
addressSince Monero is anonymous, you won't see the origin address the funds you receive came from. If youwant to know, for instance to credit a particular customer, you'll have to tell the sender to usea 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:
Random payment ID: <82d79055f3b27f56>Matching integrated address: 4KHQkZ4MmVePC2yau6Mb8vhuGGy8LVdsZD8CFcQJvr4BSTfC5AQX3aXCn5RiDPjvsEHiJu1TC1ybR8pRTCbZM5bhTrAD3HDwWMtAn1K7nVThis will generate a random payment ID, and give you the address that includes your own accountand that payment ID. If you want to select a particular payment ID, you can do that too. Use:
integrated_address 82d79055f3b27f56Payments 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.
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 [<label text with white spaces allowed>]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,
address new github_donationswill generate a subaddress and its label 'github_donations'.
To view all generated addresses, run:
address allProving to a third party you paid someone
If you pay a merchant, and the merchant claims to not have received the funds, you may needto prove to a third party you did send the funds - or even to the merchant, if it is a honestmistake. 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-transactionprivate key to a party, that party can tell whether that transaction sent monero to thatparticular address. Note that storing these per-transaction keys is disabled by default, andyou will have to enable it before sending, if you think you may need it:
set store-tx-info 1You can retrieve the tx key from an earlier transaction:
get_tx_key 1234567890123456789012345678901212345678901234567890123456789012Pass in the transaction ID you want the key for. Remember that a payment might have beensplit 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 thetransaction id and the address you sent to. Note that this third party, if knowing yourown 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 moneroto an address), then you can check this way:
check_tx_key TXID TXKEY ADDRESSReplace TXID, TXKEY and ADDRESS with the transaction ID, per-transaction key, and destinationaddress which were supplied to you, respectively. monero-wallet-cli will check that transactionand let you know how much monero this transaction paid to the given address.
How to find a payment to you
If you received a payment using a particular payment ID, you can look it up:
payments PAYMENTIDYou can give more than one payment ID too.
More generally, you can review incoming and outgoing payments:
show_transfersYou can give an optional height to list only recent transactions, and requestonly incoming or outgoing transactions. For example,
show_transfers in 650000will only show incoming transfers after block 650000. You can also give a heightrange.
If you want to mine, you can do so from the wallet:
start_mining 2This 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« Back to the list
