mirror of
https://git.wownero.com/wownero/onion-wownero-blockchain-explorer.git
synced 2024-08-15 00:33:12 +00:00
Aeon readme updated
This commit is contained in:
moneroexamples
parent
2ba9a35830
commit
220384ed6d
1 changed files with 19 additions and 97 deletions
116
README.md
116
README.md
|
|
@ -1,103 +1,25 @@
|
|||
# Onion Aeon Blockchain Explorer
|
||||
|
||||
Currently available Monero blockchain explorers have several limitations which are of
|
||||
special importance to privacy-oriented users:
|
||||
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).
|
||||
|
||||
- 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,
|
||||
- do not support Monero testnet nor stagenet networks,
|
||||
- have limited JSON API.
|
||||
|
||||
|
||||
In this example, these limitations are addressed by development of
|
||||
an Onion Monero Blockchain Explorer. The example not only shows how to use
|
||||
Monero C++ libraries, but also demonstrates how to use:
|
||||
|
||||
- [crow](https://github.com/ipkn/crow) - C++ micro web framework
|
||||
- [mstch](https://github.com/no1msd/mstch) - C++ {{mustache}} templates
|
||||
- [json](https://github.com/nlohmann/json) - JSON for Modern C++
|
||||
- [fmt](https://github.com/fmtlib/fmt) - Small, safe and fast string formatting library
|
||||
|
||||
## Addresses
|
||||
|
||||
Tor users:
|
||||
|
||||
- [http://dvwae436pd7nt4bc.onion](http://dvwae436pd7nt4bc.onion) (Front-end templates are [maintained by @suhz](https://github.com/suhz/onion-monero-blockchain-explorer/tree/moneroexplorer.com/src/templates)).
|
||||
|
||||
Clearnet versions:
|
||||
- [https://labor.serveo.net/](https://labor.serveo.net/) - temprorary link (slow), bleading edge version.
|
||||
- [https://xmrchain.net/](https://xmrchain.net/) - https enabled, most popular and very stable.
|
||||
- [https://MoneroExplorer.com/](https://moneroexplorer.com/) - nice looking one, https enabled.
|
||||
- [https://monerohash.com/explorer/](https://monerohash.com/explorer/) - nice looking one, https enabled.
|
||||
- [http://explore.MoneroWorld.com](http://explore.moneroworld.com) - same as the second one.
|
||||
- [https://moneroexplorer.pro/](https://moneroexplorer.pro/) - nice looking one, https enabled.
|
||||
- [http://monerochain.com/](http://monerochain.com/) - JSON API based, multiple nodes.
|
||||
- [https://blox.minexmr.com/](https://blox.minexmr.com/) - - https enabled.
|
||||
|
||||
Testnet version:
|
||||
|
||||
- [http://nimis.serveo.net/](http://nimis.serveo.net/) - bleeding edge version (down currently).
|
||||
- [https://testnet.xmrchain.com/](https://testnet.xmrchain.com/) - https enabled.
|
||||
- [https://explorer.monero-otc.com/](https://explorer.monero-otc.com/) - https enabled.
|
||||
|
||||
Stagenet version:
|
||||
|
||||
- [http://162.210.173.150:8083/](http://162.210.173.150:8083/) - recent version.
|
||||
|
||||
i2p users (main Monero network):
|
||||
|
||||
- [http://7o4gezpkye6ekibhgpkg7v626ze4idsirapufzrefkdysa6zxhha.b32.i2p/](http://7o4gezpkye6ekibhgpkg7v626ze4idsirapufzrefkdysa6zxhha.b32.i2p/)
|
||||
|
||||
Alternative block explorers:
|
||||
|
||||
- [http://moneroblocks.info](http://moneroblocks.info/)
|
||||
- [https://monerobase.com](https://monerobase.com/)
|
||||
- [http://chainradar.com](http://chainradar.com/xmr/blocks)
|
||||
|
||||
|
||||
## Onion Monero Blockchain Explorer features
|
||||
|
||||
The key features of the Onion Monero Blockchain Explorer are:
|
||||
|
||||
- no cookies, no web analytics trackers, no images,
|
||||
- by default no JavaScript, but can be enabled for client side decoding and proving transactions,
|
||||
- open sourced,
|
||||
- made fully in C++,
|
||||
- showing encrypted payments ID,
|
||||
- showing ring signatures,
|
||||
- showing transaction extra field,
|
||||
- showing public components of Monero addresses,
|
||||
- decoding which outputs and mixins belong to the given Monero address and viewkey,
|
||||
- can prove that you send Monero to someone,
|
||||
- detailed information about mixins, such as, mixins' age, timescale, mixin of mixins,
|
||||
- showing number of amount output indices,
|
||||
- support Monero testnet and stagnet networks,
|
||||
- tx checker and pusher for online pushing of transactions,
|
||||
- estimate possible spendings based on address and viewkey,
|
||||
- can provide total amount of all miner fees,
|
||||
- decoding encrypted payment id,
|
||||
- decoding outputs and proving txs sent to sub-address.
|
||||
|
||||
|
||||
## Development branch
|
||||
|
||||
Current development branch:
|
||||
|
||||
- https://github.com/moneroexamples/onion-monero-blockchain-explorer/tree/devel
|
||||
|
||||
- [https://chainradar.com/aeon/blocks](https://chainradar.com/aeon/blocks)
|
||||
|
||||
|
||||
## Compilation on Ubuntu 16.04
|
||||
|
||||
##### Compile latest Monero development version
|
||||
##### Compile latest Aeon development version
|
||||
|
||||
Download and compile recent Monero into your home folder:
|
||||
Download and compile recent Aeon into your home folder:
|
||||
|
||||
```bash
|
||||
# first install monero dependecines
|
||||
# first install Aeon dependecines
|
||||
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
|
||||
|
|
@ -117,7 +39,7 @@ make
|
|||
|
||||
##### Compile and run the explorer
|
||||
|
||||
Once the Monero is compiles, the explorer can be downloaded and compiled
|
||||
Once the Aeon is compiles, the explorer can be downloaded and compiled
|
||||
as follows:
|
||||
|
||||
```bash
|
||||
|
|
@ -140,7 +62,7 @@ mkdir build && cd build
|
|||
cmake ..
|
||||
|
||||
# altearnatively can use: cmake -DAEON_DIR=/path/to/aeon_folder ..
|
||||
# if monero is not in ~/aeon
|
||||
# if Aeon is not in ~/aeon
|
||||
#
|
||||
# also can build with ASAN (sanitizers), for example
|
||||
# cmake -DSANITIZE_ADDRESS=On ..
|
||||
|
|
@ -155,13 +77,13 @@ To run it:
|
|||
./aeonblocks
|
||||
```
|
||||
|
||||
By default it will look for blockchain in its default location i.e., `~/.bitmonero/lmdb`.
|
||||
By default it will look for blockchain in its default location i.e., `~/.aeon/lmdb`.
|
||||
You can use `-b` option if its in different location.
|
||||
|
||||
For example:
|
||||
|
||||
```bash
|
||||
./xmrblocks -b /home/mwo/non-defult-monero-location/lmdb/
|
||||
./xmrblocks -b /home/mwo/non-defult-aeon-location/lmdb/
|
||||
```
|
||||
|
||||
Example output:
|
||||
|
|
@ -177,7 +99,7 @@ Go to your browser: http://127.0.0.1:8081
|
|||
## The explorer's command line options
|
||||
|
||||
```
|
||||
aeonblocks, Onion Monero Blockchain Explorer:
|
||||
aeonblocks, Onion Aeon Blockchain Explorer:
|
||||
-h [ --help ] [=arg(=1)] (=0) produce help message
|
||||
-t [ --testnet ] [=arg(=1)] (=0) use testnet blockchain
|
||||
-s [ --stagenet ] [=arg(=1)] (=0) use stagenet blockchain
|
||||
|
|
@ -201,7 +123,7 @@ aeonblocks, Onion Monero Blockchain Explorer:
|
|||
enable users to have the index page on
|
||||
autorefresh
|
||||
--enable-emission-monitor [=arg(=1)] (=0)
|
||||
enable Monero total emission monitoring
|
||||
enable Aeon total emission monitoring
|
||||
thread
|
||||
-p [ --port ] arg (=8081) default explorer port
|
||||
--testnet-url arg you can specify testnet url, if you run
|
||||
|
|
@ -220,13 +142,13 @@ aeonblocks, Onion Monero Blockchain Explorer:
|
|||
--mempool-refresh-time arg (=5) time, in seconds, for each refresh of
|
||||
mempool state
|
||||
-b [ --bc-path ] arg path to lmdb folder of the blockchain,
|
||||
e.g., ~/.bitmonero/lmdb
|
||||
e.g., ~/.aeon/lmdb
|
||||
--ssl-crt-file arg path to crt file for ssl (https)
|
||||
functionality
|
||||
--ssl-key-file arg path to key file for ssl (https)
|
||||
functionality
|
||||
-d [ --deamon-url ] arg (=http:://127.0.0.1:11181)
|
||||
Monero deamon url
|
||||
Aeon deamon url
|
||||
```
|
||||
|
||||
Example usage, defined as bash aliases.
|
||||
|
|
@ -241,9 +163,9 @@ alias aeonblockstestnet='~/onion-monero-blockchain-explorer/build/aeonblocks -t
|
|||
|
||||
These are aliases similar to those used for http://139.162.32.245:8081/ and http://139.162.32.245:8082/, respectively.
|
||||
|
||||
## Enable Monero emission
|
||||
## Enable Aeon emission
|
||||
|
||||
Obtaining current Monero emission amount is not straight forward. Thus, by default it is
|
||||
Obtaining current Aeon emission amount is not straight forward. Thus, by default it is
|
||||
disabled. To enable it use `--enable-emission-monitor` flag, e.g.,
|
||||
|
||||
|
||||
|
|
@ -255,10 +177,10 @@ 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.
|
||||
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,
|
||||
in `~/.bitmonero/lmdb/emission_amount.txt`. For testnet or stagenet networks,
|
||||
it is `~/.bitmonero/testnet/lmdb/emission_amount.txt` or `~/.bitmonero/stagenet/lmdb/emission_amount.txt`. This file is used so that we don't
|
||||
in `~/.aeon/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
|
||||
need to rescan entire blockchain whenever the explorer is restarted. When the
|
||||
explorer restarts, the thread will first check if `~/.bitmonero/lmdb/emission_amount.txt`
|
||||
explorer restarts, the thread will first check if `~/.aeon/lmdb/emission_amount.txt`
|
||||
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
|
||||
the emission amount using new blocks as they come. Since the explorer writes this file, there can
|
||||
|
|
|
|||
Loading…
Reference in a new issue