veil-explorer

Veil Blockchain explorer developed with asp.net core and nuxt3

Warning master branch contains unreleased changes which is not yet covered by docs

Example: https://explorer.veil-project.com

Features

• light/dark theme
• multilingual UI (see /docs/localization.md)
• real-time updates of blockchain info, algo stats, recent blocks and first page of blocks browser
• blocks list
• block and transactions information
• search by transaction, address, block hash or height

API

Documentation

See /docs/api.md

Compatibility

See /docs/api-compatibility.md

Compiling from sources

Backend

See /docs/compiling/backend.md

Frontend

See /docs/compiling/frontend.md

Getting started

Tested OSes

Both of frontend and backend tested on Windows 11 and Ubuntu 22.04

On production environment it is recommended to use the latest version of the LTS Ubuntu

Required software

• Veil Node - required for backend to pull blockchain information
• PostgreSQL 13+ - required to run backend
• Dotnet 8+ (runtime) - required to run backend in case when using non self-contained build
• NodeJS 20+ - required to run frontend

Installation

There are basic setup guide that suitable for all supported environments and full setup tutorial wrote for Ubuntu 20.04

Basic setup guide

Node installation

1. Unpack latest veil node release
2. Generate rpcauth value with:

python3 rpcauth.py [username] [noderpc_password]

rpcauth.py: https://github.com/Veil-Project/veil/blob/master/share/rpcauth/rpcauth.py

3. Create config default.conf Add this content to opened file, change variables if required:

listen=1
server=1
rpcbind=127.0.0.1
rpcauth=[generated rpcauth string]
rpcport=5050
txindex=1

3. Run bin/veild -txindex

Database

1. Create new postgresql database
2. Restore SQL files from /explorer-backend/schemas

Backend

1. Unpack explorer-backend.[os]-[arch].self-contained.release-[version].tar.gz
2. Copy /explorer-backend/appsettings.json.tpl to [server directory]/appsettings.json
3. Change postgresql connection string inside appsettings.json, change other parameters.
4. Create data dir inside backend folder

See: /docs/backend-configuration.md

4. Run server executable (explorer-backend)
5. It will take some time to synchronize backend database with node.

Frontend

1. Unpack explorer-frontend.universal-[version].tar.gz
2. Create start script which should export environment variables used as explorer-frontend config:

# listen address
HOST=127.0.0.1
# listen port
PORT=3000
# url on which frontend available, used for SEO, meta tags etc.
NUXT_PUBLIC_I18N_BASE_URL=http://<ip>:3000
# url on which frontend available, used for SEO, meta tags etc.
NUXT_PUBLIC_BASE_URL=http://<ip>:3000
NUXT_PUBLIC_CHAIN_DEFAULT=main
# JSON formatted configuration to connect frontend with backend
# for now you should only change value of "path", so just replace <ip> and <backend_port>
NUXT_PUBLIC_CHAIN_APIS="[{\"name\": \"main\", \"path\": \"http://<ip>:5000/api\"}]"
NUXT_PUBLIC_RECENT_BLOCKS_COUNT=5
NUXT_PUBLIC_BLOCKS_PER_PAGE=15
NUXT_PUBLIC_TXS_PER_PAGE=15
NUXT_PUBLIC_MAX_BLOCK_WEIGHT=4000000
NUXT_PUBLIC_SYNC_NOTICE_CASE=15
NUXT_PUBLIC_COOKIE_SAVE_DAYS=90

See: /docs/frontend-configuration.md

3. Run start script

Full setup tutorial

Node

see /docs/setup/node.md

Database

see /docs/setup/database.md

Backend

see /docs/setup/backend.md

Frontend

see /docs/setup/frontend.md

NGINX as reverse proxy (optional)

see /docs/setup/nginx.md