d0s3t3ch/onion-wownero-blockchain-explorer
1
0
Fork 0
mirror of https://git.wownero.com/wownero/onion-wownero-blockchain-explorer.git synced 2024-08-15 00:33:12 +00:00
Code Issues Projects Releases Wiki Activity

Merge remote-tracking branch 'origin/aeon' into aeon

Browse source 
# Conflicts:
#	README.md
This commit is contained in:
moneroexamples 2018-06-10 14:06:23 +08:00
commit 537813be27
1 changed files with 32 additions and 33 deletions
Download patch file Download diff file Expand all files Collapse all files

65
README.md
View file

@ -4,20 +4,22 @@ The Onion Monero Blockchain Explorer was ported to Aeon. The port was
conducted by [stoffu](https://github.com/moneroexamples/onion-monero-blockchain-explorer/pull/118). conducted by [stoffu](https://github.com/moneroexamples/onion-monero-blockchain-explorer/pull/118).
## Explorer hosts ## Addresses
Alternative block explorers: Alternative block explorers:
- [https://chainradar.com/aeon/blocks](https://chainradar.com/aeon/blocks) - [https://chainradar.com/aeon/blocks](https://chainradar.com/aeon/blocks)
## Compilation on Ubuntu 16.04/18.04
## Compilation on Ubuntu 16.04
##### Compile latest Aeon development version ##### Compile latest Aeon development version
Download and compile recent Aeon into your home folder: Download and compile recent Aeon into your home folder:
```bash ```bash
# first install Aeon dependecines # first install monero dependecines
sudo apt update sudo apt update
sudo apt install git build-essential cmake libboost-all-dev miniupnpc libunbound-dev graphviz doxygen libunwind8-dev pkg-config libssl-dev libcurl4-openssl-dev libgtest-dev libreadline-dev libzmq3-dev libsodium-dev libpcsclite-dev sudo apt install git build-essential cmake libboost-all-dev miniupnpc libunbound-dev graphviz doxygen libunwind8-dev pkg-config libssl-dev libcurl4-openssl-dev libgtest-dev libreadline-dev libzmq3-dev libsodium-dev libpcsclite-dev
@ -25,23 +27,23 @@ sudo apt install git build-essential cmake libboost-all-dev miniupnpc libunbound
# go to home folder # go to home folder
cd ~ cd ~
git clone --recursive https://github.com/aeonix/aeon git clone --recursive https://github.com/monero-project/monero
cd aeon/ cd monero/
# checkout last monero version # checkout last monero version
git checkout -b last_release v0.12.1.0 git checkout -b last_release v0.12.0.0
make make
``` ```
##### Compile and run the explorer ##### Compile and run the explorer
Once the Aeon is compiles, the explorer can be downloaded and compiled Once the Monero is compiles, the explorer can be downloaded and compiled
as follows: as follows:
```bash ```bash
# go to home folder if still in ~/aeon # go to home folder if still in ~/monero
cd ~ cd ~
# download the source code # download the source code
@ -50,17 +52,14 @@ git clone https://github.com/moneroexamples/onion-monero-blockchain-explorer.git
# enter the downloaded sourced code folder # enter the downloaded sourced code folder
cd onion-monero-blockchain-explorer cd onion-monero-blockchain-explorer
# checkout the aeon branch
git checkout origin/aeon
# make a build folder and enter it # make a build folder and enter it
mkdir build && cd build mkdir build && cd build
# create the makefile # create the makefile
cmake .. cmake ..
# altearnatively can use: cmake -DAEON_DIR=/path/to/aeon_folder .. # altearnatively can use: cmake -DMONERO_DIR=/path/to/monero_folder ..
# if Aeon is not in ~/aeon # if monero is not in ~/monero
# #
# also can build with ASAN (sanitizers), for example # also can build with ASAN (sanitizers), for example
# cmake -DSANITIZE_ADDRESS=On .. # cmake -DSANITIZE_ADDRESS=On ..
@ -72,22 +71,22 @@ make
To run it: To run it:
``` ```
./aeonblocks ./xmrblocks
``` ```
By default it will look for blockchain in its default location i.e., `~/.aeon/lmdb`. By default it will look for blockchain in its default location i.e., `~/.bitmonero/lmdb`.
You can use `-b` option if its in different location. You can use `-b` option if its in different location.
For example: For example:
```bash ```bash
./xmrblocks -b /home/mwo/non-defult-aeon-location/lmdb/ ./xmrblocks -b /home/mwo/non-defult-monero-location/lmdb/
``` ```
Example output: Example output:
```bash ```bash
[mwo@arch onion-monero-blockchain-explorer]$ ./aeonblocks [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-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 (2016-05-28 02:04:49) [INFO ] Crow/0.1 server is running, local port 8081
``` ```
@ -97,7 +96,7 @@ Go to your browser: http://127.0.0.1:8081
## The explorer's command line options ## The explorer's command line options
``` ```
aeonblocks, Onion Aeon Blockchain Explorer: xmrblocks, Onion Monero Blockchain Explorer:
-h [ --help ] [=arg(=1)] (=0) produce help message -h [ --help ] [=arg(=1)] (=0) produce help message
-t [ --testnet ] [=arg(=1)] (=0) use testnet blockchain -t [ --testnet ] [=arg(=1)] (=0) use testnet blockchain
-s [ --stagenet ] [=arg(=1)] (=0) use stagenet blockchain -s [ --stagenet ] [=arg(=1)] (=0) use stagenet blockchain
@ -121,7 +120,7 @@ aeonblocks, Onion Aeon Blockchain Explorer:
enable users to have the index page on enable users to have the index page on
autorefresh autorefresh
--enable-emission-monitor [=arg(=1)] (=0) --enable-emission-monitor [=arg(=1)] (=0)
enable Aeon total emission monitoring enable Monero total emission monitoring
thread thread
-p [ --port ] arg (=8081) default explorer port -p [ --port ] arg (=8081) default explorer port
--testnet-url arg you can specify testnet url, if you run --testnet-url arg you can specify testnet url, if you run
@ -140,45 +139,45 @@ aeonblocks, Onion Aeon Blockchain Explorer:
--mempool-refresh-time arg (=5) time, in seconds, for each refresh of --mempool-refresh-time arg (=5) time, in seconds, for each refresh of
mempool state mempool state
-b [ --bc-path ] arg path to lmdb folder of the blockchain, -b [ --bc-path ] arg path to lmdb folder of the blockchain,
e.g., ~/.aeon/lmdb e.g., ~/.bitmonero/lmdb
--ssl-crt-file arg path to crt file for ssl (https) --ssl-crt-file arg path to crt file for ssl (https)
functionality functionality
--ssl-key-file arg path to key file for ssl (https) --ssl-key-file arg path to key file for ssl (https)
functionality functionality
-d [ --deamon-url ] arg (=http:://127.0.0.1:11181) -d [ --deamon-url ] arg (=http:://127.0.0.1:18081)
Aeon deamon url Monero deamon url
``` ```
Example usage, defined as bash aliases. Example usage, defined as bash aliases.
```bash ```bash
# for mainnet explorer # for mainnet explorer
alias aeonblocksmainnet='~/onion-monero-blockchain-explorer/build/aeonblocks --port 8081 --testnet-url "http://139.162.32.245:8082" --enable-pusher --enable-emission-monitor' alias xmrblocksmainnet='~/onion-monero-blockchain-explorer/build/xmrblocks --port 8081 --testnet-url "http://139.162.32.245:8082" --enable-pusher --enable-emission-monitor'
# for testnet explorer # for testnet explorer
alias aeonblockstestnet='~/onion-monero-blockchain-explorer/build/aeonblocks -t --port 8082 --mainnet-url "http://139.162.32.245:8081" --enable-pusher --enable-emission-monitor' alias xmrblockstestnet='~/onion-monero-blockchain-explorer/build/xmrblocks -t --port 8082 --mainnet-url "http://139.162.32.245:8081" --enable-pusher --enable-emission-monitor'
``` ```
These are aliases similar to those used for http://139.162.32.245:8081/ and http://139.162.32.245:8082/, respectively. These are aliases similar to those used for http://139.162.32.245:8081/ and http://139.162.32.245:8082/, respectively.
## Enable Aeon emission ## Enable Monero emission
Obtaining current Aeon emission amount is not straight forward. Thus, by default it is Obtaining current Monero emission amount is not straight forward. Thus, by default it is
disabled. To enable it use `--enable-emission-monitor` flag, e.g., disabled. To enable it use `--enable-emission-monitor` flag, e.g.,
```bash ```bash
aeonblocks --enable-emission-monitor xmrblocks --enable-emission-monitor
``` ```
This flag will enable emission monitoring thread. When started, the thread This flag will enable emission monitoring thread. When started, the thread
will initially scan the entire blockchain, and calculate the cumulative emission based on each block. will initially scan the entire blockchain, and calculate the cumulative emission based on each block.
Since it is a separate thread, the explorer will work as usual during this time. Since it is a separate thread, the explorer will work as usual during this time.
Every 10000 blocks, the thread will save current emission in a file, by default, Every 10000 blocks, the thread will save current emission in a file, by default,
in `~/.aeon/lmdb/emission_amount.txt`. For testnet or stagenet networks, in `~/.bitmonero/lmdb/emission_amount.txt`. For testnet or stagenet networks,
it is `~/.aeon/testnet/lmdb/emission_amount.txt` or `~/.aeon/stagenet/lmdb/emission_amount.txt`. This file is used so that we don't it is `~/.bitmonero/testnet/lmdb/emission_amount.txt` or `~/.bitmonero/stagenet/lmdb/emission_amount.txt`. This file is used so that we don't
need to rescan entire blockchain whenever the explorer is restarted. When the need to rescan entire blockchain whenever the explorer is restarted. When the
explorer restarts, the thread will first check if `~/.aeon/lmdb/emission_amount.txt` explorer restarts, the thread will first check if `~/.bitmonero/lmdb/emission_amount.txt`
is present, read its values, and continue from there if possible. Subsequently, only the initial is present, read its values, and continue from there if possible. Subsequently, only the initial
use of the tread is time consuming. Once the thread scans the entire blockchain, it updates use of the tread is time consuming. Once the thread scans the entire blockchain, it updates
the emission amount using new blocks as they come. Since the explorer writes this file, there can the emission amount using new blocks as they come. Since the explorer writes this file, there can
@ -206,7 +205,7 @@ By default, decoding and proving tx's outputs are done on the server side. To do
(private view and tx keys are not send to the server) JavaScript-based decoding can be enabled: (private view and tx keys are not send to the server) JavaScript-based decoding can be enabled:
``` ```
aeonblocks --enable-js xmrblocks --enable-js
``` ```
## Enable SSL (https) ## Enable SSL (https)
@ -222,10 +221,10 @@ openssl req -new -key server.key -out server.csr
openssl x509 -req -days 3650 -in server.csr -signkey server.key -out server.crt openssl x509 -req -days 3650 -in server.csr -signkey server.key -out server.crt
``` ```
Having the `crt` and `key` files, run `aeonblocks` in the following way: Having the `crt` and `key` files, run `xmrblocks` in the following way:
```bash ```bash
./aeonblocks --ssl-crt-file=/tmp/server.crt --ssl-key-file=/tmp/server.key ./xmrblocks --ssl-crt-file=/tmp/server.crt --ssl-key-file=/tmp/server.key
``` ```
Note: Because we generated our own certificate, modern browsers will complain Note: Because we generated our own certificate, modern browsers will complain