Simple cryptocurrency block explorer system(include Zerocoin, Masternode, Proposal).
Thanks for cool blockchain explorer, Bulwark developer teams!
This repo assumes git, mongodb, node, yarn, and are installed with configuration done. Please adjust commands to your local environment.
Download links:
https://docs.mongodb.com/manual/administration/install-on-linux/
https://nodejs.org/en/download/package-manager/
https://yarnpkg.com/lang/en/docs/install/
It is also required to have the phore daemon running in the background. It is recommended to set this up before beginning to set up the explorer so that it syncs by the time you need it.
I fixed bulwark daemon install script to phore.
bash script/phored_setup.sh
This will install the latest phore wallet and create a rpc username/password before starting the daemon.
I made, fixed install.sh in script. You can use this for installation of phore-explorer.
curl -s https://raw.githubusercontent.com/liray-unendlich/phore-explorer/master/script/install.sh | bash
Required: Username "explorer", 1Hour to run this script
You will need to wait 1 hour because this script will start update js automatically. So you need to load blockchain data with phored.
git clone https://github.com/liray-unendlich/phore-explorer.git - copy repo to local folder.
cd phore-explorer - change location.
yarn install - install packages used by the system.
cp config.template.js config.js - setup configuration using template.
mongo - connect using mongo client.
use blockex - switch to database.
db.createUser( { user: "blockexuser", pwd: "Explorer!1", roles: [ "readWrite" ] } ) - create a user with the values stored in the config.js file from above, meaning they should match.
exit - exit the mongo client.
The following automated tasks are currently needed for BlockEx to update but before running the tasks please update the cron script /path/to/blockex/script/cron_block.sh for the block with the local /path/to/node.
yarn run cron:coin - will fetch coin related information like price and supply from coinmarketcap.com.
yarn run cron:masternode - updates the masternodes list in the database with the most recent information clearing old information before.
yarn run cron:peer - gather the list of peers and fetch geographical IP information.
yarn run cron:block - will sync blocks and transactions by storing them in the database.
yarn run cron:rich - generate the rich list.
yarn run cron:proposal - generate proposal list.
Note: is is recommended to run all the crons before editing the crontab to have the information right away. Follow the order above, start with cron:coin and end with cron:rich.
To setup the crontab please see run crontab -e to edit the crontab and paste the following lines (edit with your local information):
*/1 * * * * cd /path/to/blockex && ./script/cron_block.sh >> ./tmp/block.log 2>&1
*/1 * * * * cd /path/to/blockex && /path/to/node ./cron/masternode.js >> ./tmp/masternode.log 2>&1
*/1 * * * * cd /path/to/blockex && /path/to/node ./cron/peer.js >> ./tmp/peer.log 2>&1
*/1 * * * * cd /path/to/blockex && /path/to/node ./cron/rich.js >> ./tmp/rich.log 2>&1
*/5 * * * * cd /path/to/blockex && /path/to/node ./cron/coin.js >> ./tmp/coin.log 2>&1
*/1 * * * * cd /path/to/blockex && /path/to/node ./cron/budget.js >> ./tmp/budget.log 2>&1
At this time only the client web interface needs to be built using webpack and this can be done by running yarn run build:web. This will bundle the application and put it in the /public folder for delivery.
yarn run start:api - will start the api.
yarn run start:web - will start the web, open browser http://localhost:8081.
yarn run test:client - will run the client side tests.
yarn run test:server - will test the rpc connection, database connection, and api endpoints.
- Add blocknumber index to masternode count
- Add check whether proposal is passed
- Add overview box about count each version of node
Block Explorer(マスターノード/Zerocoin対応)
git, mongodb, node, yarnが導入されていることが前提です。各種設定は個々の環境に合わせてください。
ダウンロードリンク:
https://docs.mongodb.com/manual/administration/install-on-linux/
https://nodejs.org/en/download/package-manager/
https://yarnpkg.com/lang/en/docs/install/
また、各通貨のデーモン(ex. phored)が動作することも前提です。ブロックエクスプローラの設定をする前に同期を完了させていることをお勧めします。
デーモンのインストールスクリプト(Phore)
bash script/phored_setup.sh
このコマンドによりRPCユーザー名/パスワードを設定しPhoreデーモンを起動できます。
さらに
curl -s https://raw.githubusercontent.com/liray-unendlich/phore-explorer/master/script/install.sh | bash
をコンソールに入れることで直接インストールできるようにした。このスクリプトはphoredを含む必要なものを全てダウンロード・インストールするものです。
ただ、ユーザーとして explorer という名前のユーザーを作成する必要があります。
git clone https://github.com/liray-unendlich/phore-explorer.git - レポをダウンロード
cd phore-explorer - レポ内へ移動
yarn install - 各種パッケージをダウンロード
cp config.template.js config.js - テンプレートを利用し設定ファイルを作成
mongo - mongodbの設定開始
use blockex - blockexという名称のデータベースを作成
db.createUser( { user: "blockexuser", pwd: "Explorer!1", roles: [ "readWrite" ] } ) - ユーザー名/パスワードを指定しユーザーを作成。このユーザー名/パスワードはconfig.jsと一致させてください。
exit - mongodbの設定を終了
block explorerの自動更新を行うための設定です。これをcrontabに書き込む前にここの環境に合わせpathを変更してください。cronを設定する前にnode cron/block.jsを実行するか、/path/to/phore-explorer/script/cron_block.shを実行しブロックデータを一度取得してください。node.jsのパスに合わせ/path/to/nodeを変更してください。
yarn run cron:coin - coinの価格情報/流通情報をCoinMarketcap.comより取得します。
yarn run cron:masternode - マスターノードのリストを更新し、データベースへ保存します。
yarn run cron:peer - ピア情報の更新、保存を行います。
yarn run cron:block - ブロックデータの同期、保存を行います。
yarn run cron:rich - リッチリストの作成を行います。
yarn run cron:proposal - プロポーザルリストの作成を行います(データベースへの取得まで導入済み)。
Note: crontabに追加する前に、各1回ずつ実行しておくことをお勧めします。
crontabの設定は crontab -eで行えます。各種パスはここの環境に合わせ設定してください。:
*/1 * * * * cd /path/to/blockex && ./script/cron_block.sh >> ./tmp/block.log 2>&1
*/1 * * * * cd /path/to/blockex && /path/to/node ./cron/masternode.js >> ./tmp/masternode.log 2>&1
*/1 * * * * cd /path/to/blockex && /path/to/node ./cron/peer.js >> ./tmp/peer.log 2>&1
*/1 * * * * cd /path/to/blockex && /path/to/node ./cron/rich.js >> ./tmp/rich.log 2>&1
*/5 * * * * cd /path/to/blockex && /path/to/node ./cron/coin.js >> ./tmp/coin.log 2>&1
クライアントのウェブインターフェースはwebpackを利用してビルドします。以下のコマンドを用いてビルドが可能で、
yarn run build:web
バンドル後 /public へデータを移しています。
yarn run start:api - APIのスタート
yarn run start:web - ウェブをスタートし http://localhost:8081 で接続できます。
yarn run test:web - クライアントサイドのテストを行います。
yarn run test:server - RPC, データベース, APIのテストを行います。
yarn run test:rpc - RPCのみのテストを行います。