Veil Blockchain explorer developed with asp.net core and nuxt3

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

• 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

See /docs/api.md

See /docs/api-compatibility.md

See /docs/compiling/backend.md

See /docs/compiling/frontend.md

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

• 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

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

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

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

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.

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:https://<ip>:3000
# url on which frontend available, used for SEO, meta tags etc.
NUXT_PUBLIC_BASE_URL=http:https://<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:https://<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

see /docs/setup/node.md

see /docs/setup/database.md

see /docs/setup/backend.md

see /docs/setup/frontend.md

see /docs/setup/nginx.md