Unverified Commit 32f0bfb8 authored by Riccardo Spagni's avatar Riccardo Spagni
Browse files

Merge pull request #187

f70e53a4 User-Guides: remove maintainability issue in monero-wallet-cli entry (anonimal)
67beed68 User-Guides: cleanup monero-wallet-cli entry (anonimal)
764ca679 Knowledge-Base: update bitmonerod to monerod (anonimal)
631c1b25 Knowledge-Base: update simplewallet to monero-wallet-cli (anonimal)
parents 4ab69b4e f70e53a4
......@@ -11,9 +11,9 @@ attribution: "<!-- Icon is based on work by Freepik (http://www.freepik.com) and
### Monero Core
Monero Core consists of several applications, including bitmonerod (the daemon used if running a @full-node, as it maintains the connection to the Monero network) and simplewallet (a Monero @account manager application), as well as several other helper applications.
Monero Core consists of several applications, including monerod (the daemon used if running a @full-node, as it maintains the connection to the Monero network) and monero-wallet-cli (a Monero @account manager application), as well as several other helper applications.
If you are using Monero Core for the first time you can simply download an appropriate release, and run bitmonerod to get synced up to the network.
If you are using Monero Core for the first time you can simply download an appropriate release, and run monerod to get synced up to the network.
Note: the SHA256 hashes are listed by the downloads for convenience, but a GPG-signed list of the hashes is at [getmonero.org/downloads/hashes.txt](https://getmonero.org/downloads/hashes.txt) and should be treated as canonical, with the signature checked against the appropriate GPG key in the source code (in /utils/gpg_keys).
......
......@@ -17,9 +17,9 @@ However, because Monero has @stealth-addresses there is no need to have separate
A @payment-ID is a hexadecimal string that is 64 characters long, and is normally randomly created by the merchant. An example of a payment ID is: <span class="long-term">666c75666679706f6e7920697320746865206265737420706f6e792065766572</span>
### Checking for a Payment in simplewallet
### Checking for a Payment in monero-wallet-cli
If you want to check for a payment using simplewallet you can use the "payments" command followed by the payment ID or payment IDs you want to check. For example:
If you want to check for a payment using monero-wallet-cli you can use the "payments" command followed by the payment ID or payment IDs you want to check. For example:
{:.cli-code}
<span style="color: yellow;">[wallet 49VNLa]:</span> payments 666c75666679706f6e7920697320746865206265737420706f6e792065766572
......@@ -33,7 +33,7 @@ If you need to check for payments programmatically, then details follow the next
<i class="fa fa-level-up fa-rotate-90 fa-lg instruction-list"></i> Generate a random 64 character hexadecimal string for the payment
<i class="fa fa-level-up fa-rotate-90 fa-lg instruction-list"></i> Communicate the payment ID and Monero address to the individual who is making payment
<i class="fa fa-level-up fa-rotate-90 fa-lg instruction-list"></i> Check for the payment using the "payments" command in simplewallet
<i class="fa fa-level-up fa-rotate-90 fa-lg instruction-list"></i> Check for the payment using the "payments" command in monero-wallet-cli
### Checking for a Payment Programatically
......
......@@ -23,11 +23,11 @@ Monero will run on most hardware, including ARM and 32-bit systems. In order to
Once you have the files downloaded and unpacked you don't need to do anything beyond running the Monero daemon.
- On Windows: locate bitmonerod.exe in Windows Explorer and double-click on it. If it opens and then closes, or crashes after starting, then you may want to start it from within Command Prompt in order to see what errors arise.
- On Windows: locate monerod.exe in Windows Explorer and double-click on it. If it opens and then closes, or crashes after starting, then you may want to start it from within Command Prompt in order to see what errors arise.
- On OS X: locate bitmonerod in Finder and double-click on it. As with Windows, if it opens and then closes, or crashes after starting, then you can start it from within Terminal.
- On OS X: locate monerod in Finder and double-click on it. As with Windows, if it opens and then closes, or crashes after starting, then you can start it from within Terminal.
- On Linux: dependent on whether you are running it on a desktop or server operating system, you will want to start bitmonerod either in a screen session or in a console window of its own.
- On Linux: dependent on whether you are running it on a desktop or server operating system, you will want to start monerod either in a screen session or in a console window of its own.
### Ensuring Your Node is Running Correctly
......@@ -49,4 +49,4 @@ SYNCHRONIZATION started</span>
The yellow text indicates it is receiving blocks as it synchronises up with the rest of the Monero network. The green "synchronized ok" text will appear once it has correctly synched up. Once you see this there's nothing further you need to do, you are now running a Monero node!
To exit the node at any time you can type "exit" into the daemon window and press enter, and it will shut itself down.
\ No newline at end of file
To exit the node at any time you can type "exit" into the daemon window and press enter, and it will shut itself down.
......@@ -11,11 +11,11 @@ attribution: "<!-- Icon is based on work by Freepik (http://www.freepik.com) and
## Introduction
This is a list of the bitmonerod daemon RPC calls, their inputs and outputs, and examples of each.
This is a list of the monerod daemon RPC calls, their inputs and outputs, and examples of each.
Many RPC calls use the daemon's JSON RPC interface while others use their own interfaces, as demonstrated below.
Note: "atomic units" refer to the smallest fraction of 1 XMR according to the bitmonerod implementation. **1 XMR = 1e12 atomic units.**
Note: "atomic units" refer to the smallest fraction of 1 XMR according to the monerod implementation. **1 XMR = 1e12 atomic units.**
### [JSON RPC Methods](#json-rpc-methods):
......@@ -47,7 +47,7 @@ Note: "atomic units" refer to the smallest fraction of 1 XMR according to the bi
## JSON RPC Methods
The majority of bitmonerod RPC calls use the daemon's `json_rpc` interface to request various bits of information. These methods all follow a similar structure, for example:
The majority of monerod RPC calls use the daemon's `json_rpc` interface to request various bits of information. These methods all follow a similar structure, for example:
IP=127.0.0.1
PORT=18081
......
......@@ -11,9 +11,9 @@ attribution: "<!-- Icon is based on work by Freepik (http://www.freepik.com) and
## Introduction
This is a list of the simplewallet RPC calls, their inputs and outputs, and examples of each.
This is a list of the monero-wallet-cli RPC calls, their inputs and outputs, and examples of each.
All simplewallet methods use the same JSON RPC interface. For example:
All monero-wallet-cli methods use the same JSON RPC interface. For example:
IP=127.0.0.1
PORT=18082
......@@ -24,7 +24,7 @@ All simplewallet methods use the same JSON RPC interface. For example:
-d '{"jsonrpc":"2.0","id":"0","method":"'$METHOD'","params":'"$PARAMS"'}' \
-H 'Content-Type: application/json'
Note: "atomic units" refer to the smallest fraction of 1 XMR according to the bitmonerod implementation. **1 XMR = 1e12 atomic units.**
Note: "atomic units" refer to the smallest fraction of 1 XMR according to the monerod implementation. **1 XMR = 1e12 atomic units.**
### Index of JSON RPC Methods:
......@@ -55,7 +55,7 @@ Inputs: *None*.
Outputs:
* *balance* - unsigned int; The total balance of the current simplewallet in session.
* *balance* - unsigned int; The total balance of the current monero-wallet-cli in session.
* *unlocked_balance* - unsigned int; Unlocked funds are those funds that are sufficiently deep enough in the Monero blockchain to be considered safe to spend.
Example:
......@@ -80,7 +80,7 @@ Inputs: *None*.
Outputs:
* *address* - string; The 95-character hex address string of the simplewallet in session.
* *address* - string; The 95-character hex address string of the monero-wallet-cli in session.
Example:
......@@ -103,7 +103,7 @@ Inputs: *None*.
Outputs:
* *height* - string; The current simplewallet's blockchain height. If the wallet has been offline for a long time, it may need to catch up with the daemon.
* *height* - string; The current monero-wallet-cli's blockchain height. If the wallet has been offline for a long time, it may need to catch up with the daemon.
Example:
......
......@@ -44,7 +44,7 @@ view key: 4130fa26463d9451781771a8baa5d0b8085c47c4500cefe4746bab48f1d15903
Your wallet has been generated.
To start synchronizing with the daemon use "refresh" command.
Use "help" command to see the list of available commands.
Always use "exit" command when closing simplewallet to save
Always use "exit" command when closing monero-wallet-cli to save
current session's state. Otherwise, you will possibly need to synchronize
your wallet again. Your wallet key is NOT under risk anyway.<br>
<span style="color: lime;">PLEASE NOTE: the following 25 words can be used to recover access to your wallet. Please write them down and store them somewhere safe and secure. Please do not store them in your email or on file storage services outside of your immediate control.</span><br>
......
......@@ -27,7 +27,7 @@ attribution: "<!-- Icon is based on work by Freepik (http://www.freepik.com) and
- Copy the Monero binaries to to a RAM disk (/dev/shm in Linux, Windows bootable ISOs normally have a Z: drive or something)
- Don't run the Monero daemon. Instead, using the command line, use simplewallet to create a new Monero @account
- Don't run the Monero daemon. Instead, using the command line, use monero-wallet-cli to create a new Monero @account
- When prompted for a name, give it any name, it doesn't really matter
......
......@@ -16,7 +16,7 @@ attribution: "<!-- Icon is based on work by Freepik (http://www.freepik.com) and
![image1](https://github.com/luuul/monero-site/blob/master/knowledge-base/user-guides/png/create_wallet/1.png)
![image2](https://github.com/luuul/monero-site/blob/master/knowledge-base/user-guides/png/create_wallet/2.png)
- Extract the files with the archive manager (same as Winzip on Windows). Note the path where the files "bitmonerod" and "simplewallet" are
- Extract the files with the archive manager (same as Winzip on Windows). Note the path where the files "monerod" and "monero-wallet-cli" are
![image3](https://github.com/luuul/monero-site/blob/master/knowledge-base/user-guides/png/create_wallet/3.png)
![image4](https://github.com/luuul/monero-site/blob/master/knowledge-base/user-guides/png/create_wallet/4.png)
......@@ -32,14 +32,14 @@ attribution: "<!-- Icon is based on work by Freepik (http://www.freepik.com) and
![image7](https://github.com/luuul/monero-site/blob/master/knowledge-base/user-guides/png/create_wallet/7.png)
- Load bitmonerod by typing in your terminal : "*./bitmonerod*". Wait for the synchronisation with the network (bitmonerod is updating the blockchain you have downloaded in step 4 or is downloading it from scratch). This can take a lot of time the first time, so be patient
- Load monerod by typing in your terminal : "*./monerod*". Wait for the synchronisation with the network (monerod is updating the blockchain you have downloaded in step 4 or is downloading it from scratch). This can take a lot of time the first time, so be patient
![image8](https://github.com/luuul/monero-site/blob/master/knowledge-base/user-guides/png/create_wallet/8.png)
![image9](https://github.com/luuul/monero-site/blob/master/knowledge-base/user-guides/png/create_wallet/9.png)
![image10](https://github.com/luuul/monero-site/blob/master/knowledge-base/user-guides/png/create_wallet/10.png)
![image11](https://github.com/luuul/monero-site/blob/master/knowledge-base/user-guides/png/create_wallet/11.png)
- Once bitmonerod is synchronised with the network, open a new terminal, change the directory (cf. step 5), and launch simplewallet by typing "*./simplewallet*"
- Once monerod is synchronised with the network, open a new terminal, change the directory (cf. step 5), and launch monero-wallet-cli by typing "*./monero-wallet-cli*"
![image12](https://github.com/luuul/monero-site/blob/master/knowledge-base/user-guides/png/create_wallet/12.png)
......@@ -66,8 +66,8 @@ attribution: "<!-- Icon is based on work by Freepik (http://www.freepik.com) and
![image22](https://github.com/luuul/monero-site/blob/master/knowledge-base/user-guides/png/create_wallet/22.png)
![image23](https://github.com/luuul/monero-site/blob/master/knowledge-base/user-guides/png/create_wallet/23.png)
- To exit bitmonerod or simplewallet just type "*exit*" in the associated terminal
- To exit monerod or monero-wallet-cli just type "*exit*" in the associated terminal
Now to access the portfolio you have just created you will have to launch bitmonerod, wait for it to be synchronised with the network, launch simplewallet, and type the name of your portfolio and your password.
Now to access the portfolio you have just created you will have to launch monerod, wait for it to be synchronised with the network, launch monero-wallet-cli, and type the name of your portfolio and your password.
......@@ -11,7 +11,7 @@ attribution: "<!-- Icon is based on work by Freepik (http://www.freepik.com) and
Sometimes, your funds will become stuck - you will have some locked funds that never become unlocked. This is how you fix it.
- Load your wallet in simplewallet.
- Load your wallet in monero-wallet-cli.
- Type
......@@ -19,23 +19,23 @@ Sometimes, your funds will become stuck - you will have some locked funds that n
into the command prompt. Write down your 25 word seed, if you haven't already. This is the best way to make sure you don't loose access to your funds.
- Close simplewallet by typing
- Close monero-wallet-cli by typing
> exit
- Backup all of your wallet related files. These include:
> yourwalletname.bin
> yourwalletname.bin.keys
> yourwalletname.bin.address.txt
> yourwalletname.bin
> yourwalletname.bin.keys
> yourwalletname.bin.address.txt
This can be done by copying the files to a new folder.
This can be done by copying the files to a new folder.
Sometimes, when creating your wallet, you might have named it something without the .bin part. In that case, the wallet file will be called yourwalletname without the .bin at the end.
- Delete yourwallet.bin
- Load simplewallet, type in the name of the wallet you just deleted
- Load monero-wallet-cli, type in the name of the wallet you just deleted
- Enter password. The wallet will now refresh and hopefully your locked funds will now become unlocked.
- Enter password. The wallet will now refresh and hopefully your locked funds will now become unlocked.
......@@ -17,4 +17,4 @@ attribution: "<!-- Icon is based on work by Freepik (http://www.freepik.com) and
<div class="text-left" style="padding-bottom: 15px;"><a style="color: #505050;" href="view_only"><img src="//static.getmonero.org/images/icon_client.svg" class="title-icon"><h2 class="inline"><span class="green-kicks">How to make a view only wallet</span></h2></a></div>
<div class="text-left" style="padding-bottom: 15px;"><a style="color: #505050;" href="vps_run_node"><img src="//static.getmonero.org/images/icon_client.svg" class="title-icon"><h2 class="inline"><span class="green-kicks">How to run a node on VPS</span></h2></a></div>
<div class="text-left" style="padding-bottom: 15px;"><a style="color: #505050;" href="monero_tools"><img src="//static.getmonero.org/images/icon_client.svg" class="title-icon"><h2 class="inline"><span class="green-kicks">Monero tools</span></h2></a></div>
<div class="text-left" style="padding-bottom: 15px;"><a style="color: #505050;" href="simplewallet"><img src="//static.getmonero.org/images/icon_client.svg" class="title-icon"><h2 class="inline"><span class="green-kicks">Getting started with simplewallet</span></h2></a></div>
<div class="text-left" style="padding-bottom: 15px;"><a style="color: #505050;" href="monero-wallet-cli"><img src="//static.getmonero.org/images/icon_client.svg" class="title-icon"><h2 class="inline"><span class="green-kicks">Getting started with monero-wallet-cli</span></h2></a></div>
......@@ -8,20 +8,20 @@ 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
# monero-wallet-cli
`simplewallet` is the wallet software that ships with the Monero tree. It is a console program,
`monero-wallet-cli` 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.
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 `simplewallet` 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.
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.
## Checking your balance
Since the blockchain handling and the wallet are separate programs, many uses of `simplewallet`
Since the blockchain handling and the wallet are separate programs, many uses of `monero-wallet-cli`
need to work with the daemon. This includes looking for incoming transactions to your address.
Once you are running both `simplewallet` and `bitmonerod`, enter `balance`.
Once you are running both `monero-wallet-cli` and `monerod`, enter `balance`.
Example:
......@@ -44,9 +44,6 @@ may instead give you an integrated address, which is both of these packed into a
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. If the receiving party doesn't need one, just
=======
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.
......@@ -70,7 +67,7 @@ If you have your own Monero address, you just need to give your standard address
You can find out your address with:
address
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
......@@ -116,7 +113,7 @@ 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
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.
......@@ -124,7 +121,7 @@ and let you know how much monero this transaction paid to the given address.
If you want to get a last chance confirmation when sending a payment:
set always-confirm-transfers 1
set always-confirm-transfers 1
## How to find a payment to you
......@@ -137,22 +134,22 @@ You can give more than one payment ID too.
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
only incoming or outgoing transactions. For example,
show_transfers in 650000
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
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
stop_mining
......@@ -30,3 +30,4 @@ attribution: "<!-- Icon is based on work by Freepik (http://www.freepik.com) and
- You will then be prompted with "Restore from specific blockchain height (optional, default 0):" Default will start the restore process from the beginning of the Monero blockchain. If you don't know the specific blockchain height, just hit enter. (Specifying a specific blockchain height will start the restore process from that specific height. This will save a bit of time in scanning, if you know what starting blockchain height your initial funds were transacted for this specific account.)
After you have entered the 25 word mnemonic seed and have chosen your specific blockchain height, monero-wallet-cli will generate the same public address and view key as your old wallet and begin the refresh process automatically. (Please be patient as the refresh process may take a while.)
......@@ -13,11 +13,11 @@ attribution: "<!-- Icon is based on work by Freepik (http://www.freepik.com) and
Note : In order to create a viewonly wallet you need first to compile the last source available on [Github](https://github.com/monero-project/bitmonero) as this functionality is not yet included in the official binaries (Sept. 2015).
- To create a view only wallet you will need to first create a "normal" wallet and get the associated viewkey and address. You can get them once logged in simplewallet by typing "*viewkey*" and "*address*". Note each of them carefully and exit simplewallet.
- To create a view only wallet you will need to first create a "normal" wallet and get the associated viewkey and address. You can get them once logged in monero-wallet-cli by typing "*viewkey*" and "*address*". Note each of them carefully and exit monero-wallet-cli.
- Launch a new instance of simplewallet by typing "`./simplewallet --generate-from-view-key yourAddress:yourViewKey:nameOfTheViewOnlyWallet`" where *yourViewKey* is the view key you got from step 1 and *yourAddress* the associated address. The last part of the command is the name you want to give to you view only portfolio.
- Launch a new instance of monero-wallet-cli by typing "`./monero-wallet-cli --generate-from-view-key yourAddress:yourViewKey:nameOfTheViewOnlyWallet`" where *yourViewKey* is the view key you got from step 1 and *yourAddress* the associated address. The last part of the command is the name you want to give to you view only portfolio.
- Follow the instructions from the terminal. To see the balance of your portfolio type "*refresh*" (bitmonerod need to be synchronised with the network first).
- Follow the instructions from the terminal. To see the balance of your portfolio type "*refresh*" (monerod need to be synchronised with the network first).
- You now have a view only wallet.
......@@ -8,46 +8,46 @@ 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 -->"
---
# bitmonerod
# monerod
`bitmonerod` is the daemon software that ships with the Monero tree. It is a console program, and manages the blockchain. While a bitcoin wallet manages both an account and the blockchain, Monero separates these: `bitmonerod` handles the blockchain, and `simplewallet` handles the account.
`monerod` is the daemon software that ships with the Monero tree. It is a console program, and manages the blockchain. 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 assumes you have already set up your VPS account and are using SSH to tunnel into the server console.
This guide assumes you have already set up your VPS account and are using SSH to tunnel into the server console.
## Linux, 64-bit (Ubuntu 14.04)
### Make sure that port 18080 is open
`bitmonerod` uses this port to communicate with other nodes on the Monero network.
`monerod` uses this port to communicate with other nodes on the Monero network.
Example if using `ufw`: `sudo ufw allow 18080`
Example if using `iptables`: `sudo iptables -A INPUT -p tcp --dport 18080 -j ACCEPT`
### Download the current Monero Core binaries
wget https://downloads.getmonero.org/linux64
### Make a directory and extract the files.
mkdir bitmonero
tar -xjvf linux64 -C bitmonero
### Launch the daemon
cd bitmonero
./bitmonerod
./monerod
### Options:
Show list of all options and settings:
./bitmonerod --help
./monerod --help
Launch the daemon as a background process:
./bitmonerod --detach
Monitor the output of `bitmonerod` if running as daemon:
./monerod --detach
Monitor the output of `monerod` if running as daemon:
tail -f ~/.bitmonero/bitmonero.log
\ No newline at end of file
Supports Markdown
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment