2016-09-22 01:48:29 +00:00
|
|
|
# Onion Monero Blockchain Explorer
|
2016-05-07 09:32:28 +00:00
|
|
|
|
2016-09-22 01:48:29 +00:00
|
|
|
Curently available Monero blockchain explorer websites have several limitations which are of special importance to privacy-oriented users:
|
2016-05-07 09:32:28 +00:00
|
|
|
|
2016-09-22 01:48:29 +00:00
|
|
|
- they use JavaScript,
|
|
|
|
- have images which might be used for [cookieless tracking](http://lucb1e.com/rp/cookielesscookies/),
|
|
|
|
- track users activates through google analytics,
|
|
|
|
- are closed sourced,
|
|
|
|
- are not available as hidden services,
|
|
|
|
- provide only basic search capabilities,
|
2017-01-26 21:46:21 +00:00
|
|
|
- do not support Monero testnet
|
2016-05-07 09:32:28 +00:00
|
|
|
|
2016-05-09 01:40:16 +00:00
|
|
|
|
|
|
|
In this example, these limitations are addressed by development of
|
2016-09-22 01:48:29 +00:00
|
|
|
an Onion Monero Blockchain Explorer. The example not only shows how to use Monero C++ libraries, but also demonstrates how to use:
|
2016-05-09 01:40:16 +00:00
|
|
|
|
|
|
|
- [crow](https://github.com/ipkn/crow) - C++ micro web framework
|
|
|
|
- [lmdb++](https://github.com/bendiken/lmdbxx) - C++ wrapper for the LMDB
|
|
|
|
- [mstch](https://github.com/no1msd/mstch) - C++ {{mustache}} templates
|
2016-12-05 01:20:09 +00:00
|
|
|
- [json](https://github.com/nlohmann/json) - JSON for Modern C++
|
2016-11-23 06:29:03 +00:00
|
|
|
- [date](https://github.com/HowardHinnant/date) - C++ date and time library
|
|
|
|
- [fmt](https://github.com/fmtlib/fmt) - Small, safe and fast string formatting library
|
2016-05-07 09:32:28 +00:00
|
|
|
|
2016-07-20 21:17:43 +00:00
|
|
|
## Address
|
2016-05-21 07:50:28 +00:00
|
|
|
|
2017-02-28 06:07:41 +00:00
|
|
|
Tor users:
|
|
|
|
|
|
|
|
- [http://libwh5lvouddzei4.onion/](http://libwh5lvouddzei4.onion/) - most up to date.
|
|
|
|
|
2017-01-26 08:16:15 +00:00
|
|
|
Clearnet versions:
|
2017-02-28 06:09:25 +00:00
|
|
|
- [https://explorer.xmr.my/](https://explorer.xmr.my/) - https enabled.
|
2017-02-16 23:26:18 +00:00
|
|
|
- [https://xmrchain.net/](https://xmrchain.net/) - https enabled.
|
2017-02-05 10:39:37 +00:00
|
|
|
- [https://monerohash.com/explorer/](https://monerohash.com/explorer/) - nice looking one, https enabled.
|
2017-02-16 23:26:18 +00:00
|
|
|
- [http://explore.MoneroWorld.com](http://explore.moneroworld.com) - same as the second one.
|
2017-02-20 00:46:33 +00:00
|
|
|
- [http://blox.supportxmr.com/](http://blox.supportxmr.com/).
|
2017-02-16 23:26:18 +00:00
|
|
|
|
2017-02-28 06:09:25 +00:00
|
|
|
Clearnet testnet Monero version:
|
2017-02-20 00:46:33 +00:00
|
|
|
|
|
|
|
- [https://testnet.explorer.xmr.my/](https://testnet.explorer.xmr.my/) - https enabled, most up to date.
|
|
|
|
- [https://testnet.xmrchain.com/](https://testnet.xmrchain.com/) - https enabled.
|
2017-01-15 02:21:29 +00:00
|
|
|
|
2017-01-26 00:04:55 +00:00
|
|
|
|
2017-01-09 02:58:45 +00:00
|
|
|
i2p users (main Monero network) - down for now:
|
2016-11-24 03:29:47 +00:00
|
|
|
|
|
|
|
- [http://monerotools.i2p](http://monerotools.i2p)
|
2016-05-21 07:50:28 +00:00
|
|
|
|
2016-11-23 06:29:03 +00:00
|
|
|
|
2016-09-22 01:48:29 +00:00
|
|
|
## Onion Monero Blockchain Explorer features
|
|
|
|
|
2016-12-05 01:20:09 +00:00
|
|
|
The key features of the Onion Monero Blockchain Explorer are:
|
2016-09-22 01:48:29 +00:00
|
|
|
|
|
|
|
- no javascript, no cookies, no web analytics trackers, no images,
|
|
|
|
- open sourced,
|
|
|
|
- made fully in C++,
|
|
|
|
- the only explorer showing encrypted payments ID,
|
|
|
|
- the only explorer with the ability to search by encrypted payments ID, tx public
|
2016-11-23 06:29:03 +00:00
|
|
|
and private keys, stealth addresses, input key images, block timestamps
|
|
|
|
(UTC time, e.g., 2016-11-23 14:03:05)
|
2016-09-22 01:48:29 +00:00
|
|
|
- the only explorer showing ring signatures,
|
|
|
|
- the only explorer showing transaction extra field,
|
|
|
|
- the only explorer showing public components of Monero addresses,
|
2016-12-20 07:09:59 +00:00
|
|
|
- the only explorer that can show which outputs and mixins belong to the given Monero address and viewkey,
|
2016-09-22 02:03:47 +00:00
|
|
|
- the only explorer that can be used to prove that you send Monero to someone,
|
2016-09-22 01:48:29 +00:00
|
|
|
- the only explorer showing detailed information about mixins, such as, mixins'
|
|
|
|
age, timescale, mixin of mixins,
|
2016-11-23 22:24:03 +00:00
|
|
|
- the only explorer showing number of amount output indices,
|
2017-01-26 21:46:21 +00:00
|
|
|
- the only explorer supporting Monero testnet network,
|
2016-12-05 01:20:09 +00:00
|
|
|
- the only explorer providing tx checker and pusher for online pushing of transactions,
|
|
|
|
- the only explorer allowing to inspect encrypted key images file and output files.
|
2017-02-28 22:45:04 +00:00
|
|
|
- the only explorer able to estimate possible spendings based on address and viewkey.
|
2016-09-22 01:48:29 +00:00
|
|
|
|
2016-05-08 08:45:51 +00:00
|
|
|
## Prerequisite
|
2016-05-07 09:32:28 +00:00
|
|
|
|
2016-12-28 02:59:38 +00:00
|
|
|
Instruction for Monero 0.10.1 compilation and Monero headers and libraries setup are
|
2016-05-08 08:45:51 +00:00
|
|
|
as shown here:
|
2017-02-08 08:58:57 +00:00
|
|
|
- [Compile Monero on Ubuntu 16.04 x64](https://github.com/moneroexamples/compile-monero-09-on-ubuntu-16-04)
|
2017-01-17 03:04:55 +00:00
|
|
|
- [lmdbcpp-monero](https://github.com/moneroexamples/lmdbcpp-monero.git) (optional)
|
2016-05-08 08:45:51 +00:00
|
|
|
|
2016-05-28 01:53:11 +00:00
|
|
|
## Compile and run the explorer
|
2016-05-23 01:17:15 +00:00
|
|
|
|
2016-05-28 02:07:37 +00:00
|
|
|
##### Monero headers and libraries setup
|
2016-05-28 01:53:11 +00:00
|
|
|
|
2016-12-04 08:09:21 +00:00
|
|
|
The Onion Explorer uses Monero C++ libraries and headers.
|
|
|
|
Instructions how to download source files and compile Monero,
|
2016-05-28 01:53:11 +00:00
|
|
|
setup header and library files are presented here:
|
|
|
|
|
2016-05-28 01:55:54 +00:00
|
|
|
- https://github.com/moneroexamples/compile-monero-09-on-ubuntu-16-04 (Ubuntu 16.04)
|
|
|
|
- https://github.com/moneroexamples/compile-monero-09-on-arch-linux (Arch Linux)
|
2016-05-28 01:53:11 +00:00
|
|
|
|
|
|
|
|
2016-05-28 02:12:50 +00:00
|
|
|
##### Custom lmdb database (optional)
|
2016-05-28 01:53:11 +00:00
|
|
|
|
|
|
|
Most unique search abilities of the Onion Explorer are achieved through using
|
|
|
|
a [custom lmdb database](https://github.com/moneroexamples/lmdbcpp-monero.git) constructed based on the Monero blockchain.
|
|
|
|
The reason for the custom database is that Monero's own lmdb database has limited
|
|
|
|
search abilities. For example, its not possible to search for a tx having a
|
2016-05-28 05:12:00 +00:00
|
|
|
given key image, except by performing an exhaustive search on the blockchain which is very time consuming.
|
2016-05-28 01:53:11 +00:00
|
|
|
|
2016-05-28 05:12:00 +00:00
|
|
|
Instruction how to compile the `lmdbcpp-monero` are provided here:
|
2016-05-28 02:06:35 +00:00
|
|
|
|
2016-05-28 01:53:11 +00:00
|
|
|
- https://github.com/moneroexamples/lmdbcpp-monero.git
|
|
|
|
|
2016-05-28 05:12:00 +00:00
|
|
|
The custom database is rather big, 12GB now, and it must be running alongside Monero deamon
|
2017-01-13 04:25:18 +00:00
|
|
|
so that it keeps updating itself with new information from new blocks as they are added
|
|
|
|
to the blockchain. Also, by default it is 10 blocks behind the current blockchain height
|
|
|
|
to minimize indexing/saving orphaned blocks.
|
2016-05-28 05:12:00 +00:00
|
|
|
|
|
|
|
For these reasons, its use is optional. However, without it, some searches wont be possible,
|
|
|
|
e.g., searching for key images, output and tx public keys, encrypted payments id.
|
2016-05-28 01:53:11 +00:00
|
|
|
|
2016-05-28 02:12:50 +00:00
|
|
|
##### Compile and run the explorer
|
2016-05-28 02:06:35 +00:00
|
|
|
Once the Monero is compiled and setup, the explorer can be downloaded and compiled
|
|
|
|
as follows:
|
2016-05-08 08:45:51 +00:00
|
|
|
|
|
|
|
```bash
|
|
|
|
# download the source code
|
2016-05-21 06:23:56 +00:00
|
|
|
git clone https://github.com/moneroexamples/onion-monero-blockchain-explorer.git
|
2016-05-08 08:45:51 +00:00
|
|
|
|
|
|
|
# enter the downloaded sourced code folder
|
|
|
|
cd onion-monero-blockchain-explorer
|
|
|
|
|
2016-11-23 06:29:03 +00:00
|
|
|
# make a build folder and enter it
|
|
|
|
mkdir build && cd build
|
|
|
|
|
2016-05-08 08:45:51 +00:00
|
|
|
# create the makefile
|
2016-11-23 06:29:03 +00:00
|
|
|
cmake ..
|
2016-05-08 08:45:51 +00:00
|
|
|
|
|
|
|
# compile
|
|
|
|
make
|
|
|
|
```
|
|
|
|
|
2016-05-28 02:06:35 +00:00
|
|
|
When compilation finishes executable `xmrblocks` should be created.
|
|
|
|
|
|
|
|
To run it:
|
|
|
|
```
|
|
|
|
./xmrblocks
|
|
|
|
```
|
|
|
|
|
|
|
|
Example output:
|
|
|
|
|
|
|
|
```bash
|
|
|
|
[mwo@arch onion-monero-blockchain-explorer]$ ./xmrblocks
|
|
|
|
2016-May-28 10:04:49.160280 Blockchain initialized. last block: 1056761, d0.h0.m12.s47 time ago, current difficulty: 1517857750
|
|
|
|
(2016-05-28 02:04:49) [INFO ] Crow/0.1 server is running, local port 8081
|
|
|
|
```
|
|
|
|
|
|
|
|
Go to your browser: http://127.0.0.1:8081
|
|
|
|
|
2017-01-17 02:48:46 +00:00
|
|
|
## The explorer's command line options
|
|
|
|
|
|
|
|
```
|
|
|
|
./xmrblocks -h
|
|
|
|
-h [ --help ] [=arg(=1)] (=0) produce help message
|
|
|
|
-t [ --testnet ] [=arg(=1)] (=0) use testnet blockchain
|
|
|
|
--enable-pusher [=arg(=1)] (=0) enable pushing signed tx
|
2017-02-28 07:10:50 +00:00
|
|
|
--enable-key-image-checker [=arg(=1)] (=0)
|
|
|
|
enable key images file checker
|
|
|
|
--enable-output-key-checker [=arg(=1)] (=0)
|
|
|
|
enable outputs key file checker
|
|
|
|
--enable-autorefresh-option [=arg(=1)] (=0)
|
|
|
|
enable users to have the index page on
|
|
|
|
autorefresh
|
2017-01-17 02:48:46 +00:00
|
|
|
-p [ --port ] arg (=8081) default port
|
|
|
|
-b [ --bc-path ] arg path to lmdb blockchain
|
|
|
|
--ssl-crt-file arg A path to crt file for ssl (https)
|
|
|
|
functionality
|
|
|
|
--ssl-key-file arg A path to key file for ssl (https)
|
|
|
|
functionality
|
|
|
|
-c [ --custom-db-path ] arg path to the custom lmdb database used
|
|
|
|
for searching things
|
|
|
|
-d [ --deamon-url ] arg (=http:://127.0.0.1:18081)
|
|
|
|
monero address string
|
|
|
|
```
|
|
|
|
|
2016-12-19 01:51:58 +00:00
|
|
|
## Enable SSL (https)
|
|
|
|
|
2017-01-26 08:16:15 +00:00
|
|
|
By default, the explorer does not use ssl. But it has such a functionality.
|
2016-12-19 01:51:58 +00:00
|
|
|
|
|
|
|
As an example, you can generate your own ssl certificates as follows:
|
|
|
|
|
|
|
|
```bash
|
|
|
|
cd /tmp # example folder
|
|
|
|
openssl genrsa -out server.key 1024
|
|
|
|
openssl req -new -key server.key -out server.csr
|
|
|
|
openssl x509 -req -days 3650 -in server.csr -signkey server.key -out server.crt
|
|
|
|
```
|
|
|
|
|
|
|
|
Having the `crt` and `key` files, run `xmrblocks` in the following way:
|
|
|
|
|
|
|
|
```bash
|
|
|
|
./xmrblocks --ssl-crt-file=/tmp/server.crt --ssl-key-file=/tmp/server.key
|
|
|
|
```
|
|
|
|
|
|
|
|
Note: Because we generated our own certificate, modern browsers will complain
|
|
|
|
about it as they cant verify the signatures against any third party. So probably
|
|
|
|
for any practical use need to have properly issued ssl certificates.
|
2016-05-28 02:06:35 +00:00
|
|
|
|
2017-01-14 01:20:56 +00:00
|
|
|
## Enable transaction pusher
|
|
|
|
|
|
|
|
By default, the tx pusher is disabled. The pushing will not work, but tx checking and inspecting will.
|
|
|
|
|
|
|
|
To enable pushing the txs, use flag `--enable-pusher`, e.g.:
|
|
|
|
|
|
|
|
```bash
|
|
|
|
./xmrblocks --enable-pusher
|
|
|
|
```
|
|
|
|
|
|
|
|
Note: There has been a number of issues with compatibility of tx's binary data between different Monero versions
|
|
|
|
and operating systems. Unless you are using latest development version of Monero and the explorer has been compiled
|
2017-01-26 08:16:15 +00:00
|
|
|
against the lastest version, pushing and checking unsigined and signed tx data
|
|
|
|
might not work due to incompatibilities in binary data.
|
2017-01-14 01:20:56 +00:00
|
|
|
|
2017-01-17 02:50:18 +00:00
|
|
|
## Example screenshot
|
|
|
|
|
2017-01-18 00:46:42 +00:00
|
|
|
![Onion Monero Blockchain Explorer](https://raw.githubusercontent.com/moneroexamples/onion-monero-blockchain-explorer/master/screenshot/screenshot_01.jpg)
|
2017-01-17 02:50:18 +00:00
|
|
|
|
|
|
|
|
|
|
|
## Other monero examples
|
2016-05-23 01:17:15 +00:00
|
|
|
|
2016-05-08 08:45:51 +00:00
|
|
|
Other examples can be found on [github](https://github.com/moneroexamples?tab=repositories).
|
|
|
|
Please know that some of the examples/repositories are not
|
|
|
|
finished and may not work as intended.
|
|
|
|
|
|
|
|
## How can you help?
|
|
|
|
|
|
|
|
Constructive criticism, code and website edits are always good. They can be made through github.
|
|
|
|
|