Subscan Essentials is a high-precision blockchain explorer scaffold supporting Substrate-based networks. Developed by the Subscan team and powering subscan.io, it provides:

• Developer-friendly interface
• Standard/custom module parsing
• Extensible plugin system
• Multi-chain compatibility

• Features
• Quick Start
  • Prerequisites
  • Installation
  • React UI Configuration
  • Configuration
  • Running Services
• Docker Deployment
• Testing
• Contributing
• License
• Resources

• Substrate Integration
  • Custom type registration (guide)
  • Indexes blocks, extrinsics, events, logs, and EVM data
• Extensibility
  • Custom plugins framework (docs)
  • Auto-generate plugin templates via gen tool
• APIs
  • Built-in HTTP API documentation (docs)

• Linux/macOS
• Git
• Go 1.23+
• Redis 3.0.4+
• MySQL 8.0+ or PostgreSQL 16+

./build.sh build

Subscan Essentials supports a React-based UI for a modern frontend experience. The React UI repository is available at subscan-essentials-ui-react.

• Node.js 18+
• npm or yarn

1. Clone the repository:

git clone https://github.com/subscan-explorer/subscan-essentials-ui-react.git
cd subscan-essentials-ui-react

2. Install dependencies:

npm install
# or
yarn

Add API host environment variable when deployment:

# API endpoint address
NEXT_PUBLIC_API_HOST=http://localhost:4399

npm run dev
# or
yarn run dev

Visit http://localhost:3000 to view the UI interface.

npm run build
# or
yarn run build

cp configs/config.yaml.example configs/config.yaml

server:
  http:
    addr: 0.0.0.0:4399 # http api port
    timeout: 30s       # http timeout 
database:
  mysql:
    api: "mysql://root:[email protected]:3306?writeTimeout=3s&parseTime=true&loc=Local&charset=utf8mb4,utf8" # mysql default dsn
  postgres:
    api: "host=localhost user=gorm password=gorm dbname=gorm port=9920 sslmode=disable" # postgres default dsn
redis:
  proto: tcp
  addr: 127.0.0.1:6379 # redis host
  password: "" # redis password
  read_timeout: 1s 
  write_timeout: 1s
  idle: 10
  active: 100
UI:
  enable_substrate: true # if true, ui will show substrate data
  enable_evm: true       # if true, ui will show evm data

• Start DB

Make sure you have started redis and mysql/postgres

• Subscribe

cd cmd && ./subscan start subscribe

• Worker

cd cmd && ./subscan start worker

• Api Server

cd cmd && ./subscan

• Help

NAME:
   SUBSCAN - SUBSCAN Backend Service, use -h get help

USAGE:
   cmd [global options] command [command options] [arguments...]

VERSION:
   2.0

DESCRIPTION:
   SubScan Backend Service, substrate blockchain explorer

COMMANDS:
   start              Start one worker, E.g. subscribe
   install            Install default database and create default conf file
   CheckCompleteness  Create blocks completeness
   help, h            Shows a list of commands or help for one command

GLOBAL OPTIONS:
   --conf value   (default: "../configs")
   --help, -h     show help
   --version, -v  print the version

Use docker-compose can start projects quickly

Create local network

docker network create app_net

Run mysql and redis container

docker-compose -f docker-compose.db.yml up  -d

Run subscan service

docker-compose build
docker-compose up -d

1. Create test database (if using MySQL):

CREATE DATABASE subscan-essentials;

2. Run tests:

go test -v ./...

We welcome contributions! Please see CONTRIBUTING.md for guidelines. Good first issues are labeled with good first issue.

GPL-3.0

• [SUBSCAN] https://github.com/subscan-explorer
• [scale.go] https://github.com/subscan-explorer/scale.go SCALE codec implementation
• [Darwinia] https://github.com/darwinia-network