@etclabscore/jade-explorer v1.0.3
Jade Explorer
Table of Contents
About The Project
Jade Explorer is a minimal block explorer for EVM-based blockchains and utilizes Jade Service Runner for managing background services (Multi-Geth), OpenRPC for underlying functionality, and Pristine. It does not use a database, and can be configured to point at any remote RPC node for any EVM-based network. The goal of Jade Explorer is to provide a resource for network information and block exploration.
Explorer Features:
- Display chain id
- Syncing status
- Runtime configuration for endpoints
- Search by Block, Transaction, Address
- Charts for hash, transaction count, gas used, uncles
- Preview latest blocks with pagination
- Multi-language support
Getting Started
Prerequisites
- node
v10.15.3
or later - npm
v6.4.1
or later
Installation
Clone/ download the project, and install dependencies.
git clone https://github.com/etclabscore/jade-explorer.git && cd jade-explorer && npm install
Usage
Run service
If you don't have a service-runner running, then you can use the one in the package.json via: (or see the configuration section below to provide your own ethereum rpc URL):
npm run service-runner
Jade Service Runner will run at http://localhost:8002/.
Multi-Geth & Service Runner
By default, multi-geth service will run ETC mainnet. Jade Service runner conveniently contains the service in the /.services/
directory of project.
# ./services/
.
└── multi-geth
└── 1.9.0
└── multi-geth
└── 1.9.0
└── classic
├── geth
│ ├── chaindata
│ ├── ethash
│ └── nodes
└── keystore
Start the explorer
npm start
The explorer will run at http://localhost:3000/.
Configurations
Set rpc via url
?rpcUrl=
Set custom rpc url.
Example: https://explorer.jade.builders/?rpcUrl=https://services.jade.builders/multi-geth/kotti/1.9.2
Configure default urls via environment variables
Override eth url
REACT_APP_ETH_RPC_URL=https://services.jade.builders/multi-geth/mainnet/1.9.2 npm start
OR
Override service runner url
REACT_APP_SERVICE_RUNNER_URL=https://services.jade.builders/ npm start
Roadmap
See the open issues for a list of proposed features (and known issues).
Contributing
How to contribute, build and release are outlined in CONTRIBUTING.md, BUILDING.md and RELEASING.md respectively. Commits in this repository follow the CONVENTIONAL_COMMITS.md specification.
License
Apache License 2.0
Resources
This repo originally forked from ETCDEVTeam/emerald-explorer.