/ckb-explorer-frontend

Nervos CKB Explorer Frontend

Primary LanguageTypeScriptMIT LicenseMIT

ckb explorer logo

CKB Explorer

License Github Actions CI Discord

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.