Block explorer web interface based on the esplora-electrs HTTP API.
Written as a single-page app in a reactive and functional style using rxjs and cycle.js.
See live at Blockstream.info.
API documentation is available here.
Join the translation efforts on Transifex.
-
Explore blocks, transactions and addresses
-
Support for Segwit and Bech32 addresses
-
Shows previous output and spending transaction details
-
Quick-search for txid, address, block hash or height by navigating to
/<query>
-
Advanced view with script hex/assembly, witness data, outpoints and more
-
Mobile-ready responsive design
-
Translated to 17 languages
-
Light and dark themes
-
Noscript support
-
For Liquid and other Elements-based chains: support for CT, peg-in/out transactions and multi-asset
-
Mainnet, Testnet and Elements high performance electrum server
To start a development server with live babel/browserify transpilation, run:
$ git clone https://github.com/Blockstream/esplora && cd esplora
$ npm install
$ export API_URL=http://localhost:3000/ # or https://blockstream.info/api/ if you don't have a local API server
# (see more config options below)
$ npm run dev-server
The server will be available at http://localhost:5000/
To display debugging information for the Rx streams in the web developer console, set localStorage.debug = '*'
and refresh.
To build the static assets directory for production deployment, set config options (see below)
and run $ npm run dist
. The files will be created under dist/
.
Because Esplora is a single-page app, the HTTP server needs to be configured to serve the index.html
file in reply to missing pages.
See contrib/nginx.conf.in
for example nginx configuration (TL;DR: try_files $uri /index.html
).
To start a pre-rendering server that generates static HTML replies suitable for noscript users, run:
# (clone, cd, "npm install" and configure as above)
$ export STATIC_ROOT=http://localhost:5000/ # for loading CSS, images and fonts
$ npm run prerender-server
The server will be available at http://localhost:5001/
All options are optional.
NODE_ENV
- set toproduction
to enable js minification, or todevelopment
to disable (defaults toproduction
)BASE_HREF
- base href for user interface (defaults to/
, change if not served from the root directory)STATIC_ROOT
- root for static assets (defaults toBASE_HREF
, change to load static assets from a different server)API_URL
- URL for HTTP REST API (defaults to/api
, change if the API is available elsewhere)CANONICAL_URL
- absolute base url for user interface (optional, only required for opensearch and canonical link tags)NATIVE_ASSET_LABEL
- the name of the network native asset (defaults toBTC
)SITE_TITLE
- website title for<title>
(defaults toBlock Explorer
)SITE_DESC
- meta description (defaults toEsplora Block Explorer
)HOME_TITLE
- text for homepage title (defaults toSITE_TITLE
)SITE_FOOTER
- text for page footer (defaults toPowered by esplora
)HEAD_HTML
- custom html to inject at the end of<head>
FOOT_HTML
- custom html to inject at the end of<body>
CUSTOM_ASSETS
- space separated list of static assets to add to the buildCUSTOM_CSS
- space separated list of css files to append intostyle.css
NOSCRIPT_REDIR
- redirect noscript users to{request_path}?nojs
(should be captured server-side and redirected to the prerender server, also seeNOSCRIPT_REDIR_BASE
in dev server options)
Note that API_URL
should be set to the publicly-reachable URL where the user's browser can issue requests at.
(that is, not via localhost
, unless you're setting up a dev environment where the browser is running on the same machine as the API server.)
Elements-only configuration:
IS_ELEMENTS
- set to1
to indicate this is an Elements-based chain (enables asset issuance and peg features)NATIVE_ASSET_ID
- the ID of the native asset used to pay fees (defaults to6f0279e9ed041c3d710a9f57d0c02928416460c4b722ae3457a11eec381c526d
, the asset id for BTC)BLIND_PREFIX
- the base58 address prefix byte used for confidential addresses (defaults to12
)PARENT_CHAIN_EXPLORER_TXOUT
- URL format for linking to transaction outputs on the parent chain, with{txid}
and{vout}
as placeholders. Example:https://blockstream.info/tx/{txid}#output:{vout}
PARENT_CHAIN_EXPLORER_ADDRESS
- URL format for linking to addresses on parent chain, with{addr}
replaced by the address. Example:https://blockstream.info/address/{addr}
ASSET_MAP_URL
- url to load json asset map (in the "minimal" format)
Menu configuration (useful for inter-linking multiple instances on different networks):
MENU_ITEMS
- json map of menu items, where the key is the label and the value is the urlMENU_ACTIVE
- the active menu item identified by its label
All GUI options, plus:
PORT
- port to bind http development server (defaults to5000
)CORS_ALLOW
- value to set forAccess-Control-Allow-Origin
header (optional)NOSCRIPT_REDIR_BASE
- base url for prerender server, for redirecting?nojs
requests (should be set alongsideNOSCRIPT_REDIR
)
All GUI options, plus:
PORT
- port to bind pre-rendering server (defaults to5001
)
Note that unlike the regular JavaScript-based app that sends API requests from the client-side,
the pre-rendering server sends API requests from the server-side. This means that API_URL
should
be configured to the URL reachable by the server, typically http://localhost:3000/
.
docker build -t esplora .
Alternatively, you may use the pre-built blockstream/esplora
image from Docker Hub.
docker run -p 50001:50001 -p 8080:80 \
--volume $PWD/data_bitcoin_mainnet:/data \
--rm -i -t esplora \
bash -c "/srv/explorer/run.sh bitcoin-mainnet explorer"
docker run -p 50001:50001 -p 8082:80 \
--volume $PWD/data_liquid_mainnet:/data \
--rm -i -t esplora \
bash -c "/srv/explorer/run.sh liquid-mainnet explorer"
docker run -p 50001:50001 -p 8084:80 \
--volume $PWD/data_bitcoin_testnet:/data \
--rm -i -t esplora \
bash -c "/srv/explorer/run.sh bitcoin-testnet explorer"
docker run -p 50001:50001 -p 8084:80 \
--volume $PWD/data_bitcoin_signet:/data \
--rm -i -t esplora \
bash -c "/srv/explorer/run.sh bitcoin-signet explorer"
docker run -p 50001:50001 -p 8096:80 \
--volume $PWD/data_liquid_testnet:/data \
--rm -i -t esplora \
bash -c "/srv/explorer/run.sh liquid-testnet explorer"
docker run -p 50001:50001 -p 8092:80 \
--volume $PWD/data_liquid_regtest:/data \
--rm -i -t esplora \
bash -c "/srv/explorer/run.sh liquid-regtest explorer"
docker run -p 50001:50001 -p 8094:80 \
--volume $PWD/data_bitcoin_regtest:/data \
--rm -i -t esplora \
bash -c "/srv/explorer/run.sh bitcoin-regtest explorer"
When run for Bitcoin regtest or Liquid regtest, the esplora container will
create a default wallet and mine 100 blocks internally. You can disable this behavior
by setting NO_REGTEST_MINING=1
.
Set -e DEBUG=verbose
to enable more verbose logging.
Set -e NO_PRECACHE=1
to disable pre-caching of statistics for "popular addresses",
which may take a long time and is not necessary for personal use.
Set -e NO_ADDRESS_SEARCH=1
to disable the by-prefix address search index.
Set -e ENABLE_LIGHTMODE=1
to enable esplora-electrs's light mode.
Set -e ONION_URL=http://xyz.onion
to enable the Onion-Location
header.
docker build -t blockstream/esplora-base:latest -f Dockerfile.deps .
docker push blockstream/esplora-base:latest
docker inspect --format='{{index .RepoDigests 0}}' blockstream/esplora-base
docker build --squash -t blockstream/tor:latest -f Dockerfile.tor .
docker push blockstream/tor:latest
docker inspect --format='{{index .RepoDigests 0}}' blockstream/tor
Run: docker -d --name hidden_service blockstream/tor:latest tor -f /home/tor/torrc
(could add a -v /extra/torrc:/home/tor/torrc
, if you have a custom torrc)
Example torrc:
DataDirectory /home/tor/tor
PidFile /var/run/tor/tor.pid
ControlSocket /var/run/tor/control GroupWritable RelaxDirModeCheck
ControlSocketsGroupWritable 1
SocksPort unix:/var/run/tor/socks WorldWritable
SocksPort 9050
CookieAuthentication 1
CookieAuthFileGroupReadable 1
CookieAuthFile /var/run/tor/control.authcookie
Log [handshake]debug [*]notice stderr
HiddenServiceDir /home/tor/tor/hidden_service_v3/
HiddenServiceVersion 3
HiddenServicePort 80 127.0.0.1:80
MIT