templates and readme amended
This commit is contained in:
parent
d2a53ed3b8
commit
5be546e1ac
172
README.md
172
README.md
|
@ -1,14 +1,14 @@
|
||||||
# Onion Monero Blockchain Explorer
|
# Onion Monero Blockchain Explorer
|
||||||
|
|
||||||
Two Monero blockchain explorer exist in the clearnet. Although useful,
|
Monero blockchain explorer websites exist in the clearnet. Although useful,
|
||||||
their limitations are that they use JavaScript, have images
|
their limitations are that they use JavaScript, have images
|
||||||
([might be used for coockless tracking](http://lucb1e.com/rp/cookielesscookies/)),
|
([might be used for coockless tracking](http://lucb1e.com/rp/cookielesscookies/)),
|
||||||
track users activates through google analytics, are not open sourced, and are not
|
track users activates through google analytics, are not open sourced, and are not
|
||||||
available as hidden services. These things are of importance
|
available as hidden services. These things are of importance
|
||||||
for privacy-oriented users.
|
for privacy-oriented users.
|
||||||
|
|
||||||
In this example, these limitations are addressed. Specifically,
|
In this example, these limitations are addressed by development of
|
||||||
an Onion Monero Blockchain Explorer is developed. It is build in C++,
|
an Onion Monero Blockchain Explorer. It is build in C++,
|
||||||
and it not only shows how to use Monero C++ libraries, but also demonstrates how to
|
and it not only shows how to use Monero C++ libraries, but also demonstrates how to
|
||||||
use:
|
use:
|
||||||
|
|
||||||
|
@ -20,20 +20,168 @@ track users activates through google analytics, are not open sourced, and are no
|
||||||
|
|
||||||
## Onion Monero Blockchain Explorer features
|
## Onion Monero Blockchain Explorer features
|
||||||
|
|
||||||
- no javascript, no web analytics trackers, no images, i.e., no user tracking
|
- no javascript, no web analytics trackers, no images
|
||||||
- open source which allows everyone to check its source code, fork it, contribute
|
- open source
|
||||||
- made fully in C++ allowing for seamless integration with Monero
|
- made fully in C++
|
||||||
- does not use RPC calls, except to get mempool data, which improves its performance
|
- the only explorer showing encrypted payments ID
|
||||||
and enables to fetch more information from the blockchain
|
- the only explorer with the ability to search by encrypted payments ID, tx public
|
||||||
- index page lists recent transactions in the blockchain and in the memory pool,
|
keys, outputs public keys, input key images
|
||||||
rather than only recent blocks, allowing for fast overview of recent activity in Monero
|
- the only explorer showing ring signatures for inputs
|
||||||
|
|
||||||
|
|
||||||
|
## Prerequisite
|
||||||
|
|
||||||
|
Everything here was done and tested using Monero 0.9.4 on
|
||||||
|
Xubuntu 16.04 x86_64.
|
||||||
|
|
||||||
|
Instruction for Monero 0.9 compilation and Monero headers and libraries setup are
|
||||||
|
as shown here:
|
||||||
|
- [Compile Monero 0.9 on Ubuntu 16.04 x64](https://github.com/moneroexamples/compile-monero-09-on-ubuntu-16-04)
|
||||||
|
- [lmdbcpp-monero](https://github.com/moneroexamples/lmdbcpp-monero.git)
|
||||||
|
|
||||||
|
## C++ code
|
||||||
|
|
||||||
|
```c++
|
||||||
|
int main(int ac, const char* av[]) {
|
||||||
|
|
||||||
|
// get command line options
|
||||||
|
xmreg::CmdLineOptions opts {ac, av};
|
||||||
|
|
||||||
|
auto help_opt = opts.get_option<bool>("help");
|
||||||
|
|
||||||
|
// if help was chosen, display help text and finish
|
||||||
|
if (*help_opt)
|
||||||
|
{
|
||||||
|
return EXIT_SUCCESS;
|
||||||
|
}
|
||||||
|
|
||||||
|
auto port_opt = opts.get_option<string>("port");
|
||||||
|
auto bc_path_opt = opts.get_option<string>("bc-path");
|
||||||
|
auto custom_db_path_opt = opts.get_option<string>("custom-db-path");
|
||||||
|
auto deamon_url_opt = opts.get_option<string>("deamon-url");
|
||||||
|
|
||||||
|
//cast port number in string to uint16
|
||||||
|
uint16_t app_port = boost::lexical_cast<uint16_t>(*port_opt);
|
||||||
|
|
||||||
|
// get blockchain path
|
||||||
|
path blockchain_path;
|
||||||
|
|
||||||
|
if (!xmreg::get_blockchain_path(bc_path_opt, blockchain_path))
|
||||||
|
{
|
||||||
|
cerr << "Error getting blockchain path." << endl;
|
||||||
|
return EXIT_FAILURE;
|
||||||
|
}
|
||||||
|
|
||||||
|
// enable basic monero log output
|
||||||
|
xmreg::enable_monero_log();
|
||||||
|
|
||||||
|
// create instance of our MicroCore
|
||||||
|
// and make pointer to the Blockchain
|
||||||
|
xmreg::MicroCore mcore;
|
||||||
|
cryptonote::Blockchain* core_storage;
|
||||||
|
|
||||||
|
// initialize mcore and core_storage
|
||||||
|
if (!xmreg::init_blockchain(blockchain_path.string(),
|
||||||
|
mcore, core_storage))
|
||||||
|
{
|
||||||
|
cerr << "Error accessing blockchain." << endl;
|
||||||
|
return EXIT_FAILURE;
|
||||||
|
}
|
||||||
|
|
||||||
|
// create instance of page class which
|
||||||
|
// contains logic for the website
|
||||||
|
xmreg::page xmrblocks(&mcore, core_storage, *deamon_url_opt);
|
||||||
|
|
||||||
|
// crow instance
|
||||||
|
crow::SimpleApp app;
|
||||||
|
|
||||||
|
CROW_ROUTE(app, "/")
|
||||||
|
([&]() {
|
||||||
|
return xmrblocks.index2();
|
||||||
|
});
|
||||||
|
|
||||||
|
CROW_ROUTE(app, "/page/<uint>")
|
||||||
|
([&](size_t page_no) {
|
||||||
|
return xmrblocks.index2(page_no);
|
||||||
|
});
|
||||||
|
|
||||||
|
CROW_ROUTE(app, "/block/<uint>")
|
||||||
|
([&](size_t block_height) {
|
||||||
|
return xmrblocks.show_block(block_height);
|
||||||
|
});
|
||||||
|
|
||||||
|
CROW_ROUTE(app, "/block/<string>")
|
||||||
|
([&](string block_hash) {
|
||||||
|
return xmrblocks.show_block(block_hash);
|
||||||
|
});
|
||||||
|
|
||||||
|
CROW_ROUTE(app, "/tx/<string>")
|
||||||
|
([&](string tx_hash) {
|
||||||
|
return xmrblocks.show_tx(tx_hash);
|
||||||
|
});
|
||||||
|
|
||||||
|
CROW_ROUTE(app, "/tx/<string>/<uint>")
|
||||||
|
([&](string tx_hash, uint with_ring_signatures) {
|
||||||
|
return xmrblocks.show_tx(tx_hash, with_ring_signatures);
|
||||||
|
});
|
||||||
|
|
||||||
|
|
||||||
|
CROW_ROUTE(app, "/search").methods("GET"_method)
|
||||||
|
([&](const crow::request& req) {
|
||||||
|
return xmrblocks.search(string(req.url_params.get("value")));
|
||||||
|
});
|
||||||
|
|
||||||
|
CROW_ROUTE(app, "/autorefresh")
|
||||||
|
([&]() {
|
||||||
|
uint64_t page_no {0};
|
||||||
|
bool refresh_page {true};
|
||||||
|
return xmrblocks.index2(page_no, refresh_page);
|
||||||
|
});
|
||||||
|
|
||||||
|
// run the crow http server
|
||||||
|
app.port(app_port).multithreaded().run();
|
||||||
|
|
||||||
|
return EXIT_SUCCESS;
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
## Compile this example
|
||||||
|
The dependencies are same as those for Monero, so I assume Monero compiles
|
||||||
|
correctly. If so then to download and compile this example, the following
|
||||||
|
steps can be executed:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# download the source code
|
||||||
|
https://github.com/moneroexamples/onion-monero-blockchain-explorer.git
|
||||||
|
|
||||||
|
# enter the downloaded sourced code folder
|
||||||
|
cd onion-monero-blockchain-explorer
|
||||||
|
|
||||||
|
# create the makefile
|
||||||
|
cmake .
|
||||||
|
|
||||||
|
# compile
|
||||||
|
make
|
||||||
|
```
|
||||||
|
|
||||||
|
|
||||||
|
## Other examples
|
||||||
|
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.
|
||||||
|
|
||||||
|
Some Monero are also welcome:
|
||||||
|
```
|
||||||
|
48daf1rG3hE1Txapcsxh6WXNe9MLNKtu7W7tKTivtSoVLHErYzvdcpea2nSTgGkz66RFP4GKVAsTV14v6G3oddBTHfxP6tU
|
||||||
|
```
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
|
@ -938,6 +938,7 @@ namespace xmreg {
|
||||||
{"blk_timestamp" , blk_timestamp},
|
{"blk_timestamp" , blk_timestamp},
|
||||||
{"delta_time" , age.first},
|
{"delta_time" , age.first},
|
||||||
{"inputs_no" , txd.input_key_imgs.size()},
|
{"inputs_no" , txd.input_key_imgs.size()},
|
||||||
|
{"has_inputs" , !txd.input_key_imgs.empty()},
|
||||||
{"outputs_no" , txd.output_pub_keys.size()},
|
{"outputs_no" , txd.output_pub_keys.size()},
|
||||||
{"has_payment_id" , txd.payment_id != null_hash},
|
{"has_payment_id" , txd.payment_id != null_hash},
|
||||||
{"has_payment_id8" , txd.payment_id8 != null_hash8},
|
{"has_payment_id8" , txd.payment_id8 != null_hash8},
|
||||||
|
|
|
@ -27,12 +27,17 @@
|
||||||
padding: 10px;*/
|
padding: 10px;*/
|
||||||
}
|
}
|
||||||
|
|
||||||
tr, li {
|
tr, li, #pages {
|
||||||
font-family: "Lucida Console", Monaco, monospace;
|
font-family: "Lucida Console", Monaco, monospace;
|
||||||
font-size : 12px;
|
font-size : 12px;
|
||||||
height: 22px;
|
height: 22px;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
#pages
|
||||||
|
{
|
||||||
|
margin-top: 15px;
|
||||||
|
}
|
||||||
|
|
||||||
td {
|
td {
|
||||||
text-align: center;
|
text-align: center;
|
||||||
}
|
}
|
||||||
|
@ -85,7 +90,7 @@
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
<div class="center">
|
<div class="center">
|
||||||
<form action="/search" method="get" style="width:100%; margin-top:10px" class="style-1">
|
<form action="/search" method="get" style="width:100%; margin-top:15px" class="style-1">
|
||||||
<input type="text" name="value" size="100"
|
<input type="text" name="value" size="100"
|
||||||
placeholder="blk height, blk hash, tx hash, tx payment id, encrypted payment id, tx public key, input key image or output public key ">
|
placeholder="blk height, blk hash, tx hash, tx payment id, encrypted payment id, tx public key, input key image or output public key ">
|
||||||
<input type="submit" value="Search">
|
<input type="submit" value="Search">
|
||||||
|
|
|
@ -49,7 +49,7 @@
|
||||||
{{/txs}}
|
{{/txs}}
|
||||||
</table>
|
</table>
|
||||||
|
|
||||||
<div class="center" style="text-align: center;">
|
<div id="pages" class="center" style="text-align: center;">
|
||||||
{{^is_page_zero}}
|
{{^is_page_zero}}
|
||||||
<a href="/page/{{prev_page}}">previous page</a> |
|
<a href="/page/{{prev_page}}">previous page</a> |
|
||||||
<a href="/">first page</a> |
|
<a href="/">first page</a> |
|
||||||
|
|
|
@ -57,6 +57,7 @@
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
|
|
||||||
|
{{#has_inputs}}
|
||||||
<h3>Inputs' mixins time scale (from genesis till {{server_time}};
|
<h3>Inputs' mixins time scale (from genesis till {{server_time}};
|
||||||
resolution: {{timescales_scale}} days)</h3>
|
resolution: {{timescales_scale}} days)</h3>
|
||||||
<div class="center">
|
<div class="center">
|
||||||
|
@ -134,6 +135,6 @@
|
||||||
|
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
|
{{/has_inputs}}
|
||||||
|
|
||||||
</div>
|
</div>
|
||||||
|
|
Loading…
Reference in New Issue