nervosnetwork / ckb-explorer-frontend

Nervos CKB Explorer Frontend

CKB Explorer

CKB Explorer is a Nervos CKB blockchain explorer built with React and Ruby on Rails and includes two parts: CKB Explorer Frontend and CKB Explorer Server.

See live at CKB Explorer.

API documentation is available here.

CKB Explorer Frontend

Features

• Explore blocks, transactions, addresses and lock hashes

• Shows previous output and spending transaction details

• Quick-search for tx hash, address, lock hash, block hash or height

• Mobile-ready responsive design

• Translated to two languages (English and Chinese)

• Mainnet and Testnet with different theme colors

Getting Started

Prerequisite

• Node: install version 12.0.0 or greater.
• Yarn: See Yarn website for installation instructions. (needs 1.13.0 or greater).
• A fork of the repo (for any contributions).
• A clone of the ckb-explorer-frontend repo.

Edit .env file

You need to edit .env.development for development and .env.production for production to set your own api url as ckb explorer server.

REACT_APP_API_URL = 'http://your-api-url'        # Set your own server api url

REACT_APP_CHAIN_TYPE = 'testnet'                 # Set chain type (mainnet or testnet)

REACT_APP_MAINNET_URL = 'http://localhost:3000'  # MAINNET_URL is for deploying testnet, please ignore for development

REACT_APP_TESTNET_NAME = 'testnet'               # TESTNET_NAME will be displayed on explorer header and it also determines the subpath of the testnet

Installation

git clone https://github.com/nervosnetwork/ckb-explorer-frontend.git
cd ckb-explorer-frontend
yarn install   # install dependency libraries

Running locally

• yarn start to start the development server (or npm start, if not using Yarn).
• open http://localhost:3000/ to open the site in your favorite browser.

Building production

yarn build    # build ckb explorer frontend project
yarn test     # run project test cases

License

CKB Explorer Frontend is released under the terms of the MIT license. See COPYING for more information or see https://opensource.org/licenses/MIT.