pironmind / epirus-free

Ethereum, Hyperledger Besu and Quorum private blockchain explorer

Blockchain Explorer for Besu, Quorum and Ethereum

Introduction

This dockerized environment is designed for viewing private Quorum, Pantheon and Ethereum networks.

Usage

Clone the repo, navigate to the cloned directory and run the instance with:

docker-compose pull
NODE_ENDPOINT=http://<node_endpoint> docker-compose up

Note that if setting NODE_ENDPOINT to a local Ethereum instance, you may need to use the IP address associated with the Docker bridged interface.

On Linux, the bridged adapter should be 172.16.239.1, as denoted in docker-compose.yml. To connect to a local node, start with the command:

NODE_ENDPOINT=http://172.16.239.1:8545 docker-compose up

On MacOS and Windows, a platform sepcific command is required due to limitations around the Docker network stack on MacOS. This is as follows:

NODE_ENDPOINT=http://host.docker.internal:8545 docker-compose up

Note that in both cases, your local instance of geth must be started with --rpcaddr 0.0.0.0 and --rpcvhosts="*", or Epirus will be unable to access it.

Also note that on Windows Epirus may take a long time to come up (sometimes up to 20 minutes) due to Windows filesystem performance issues with Linux VMs.

Append the -d argument to run the containers in the backgroud

You will be able to access the Explorer UI via:

• http://localhost/

To stop the containers use:

docker-compose down

To connect to new network you should remove the volumes associated with the old network

docker-compose down -v

Quorum & Pantheon

To run the Quroum 7 node example with epirus free follow these instructions.

To run the Pantheon-quickstart privacy network example follow these instructions.

Tokens and contract metadata

This is a free version of our Epirus Blockchain Explorer. For additional features such as full tokens support, and contract metadata upload (so all transaction and events are decoded), please use our offering available on the Azure Marketplace.

We can also provide hosted Blockchain Explorer instances - these can be hosted within your cloud subscription or hosted by us.

Some of the features include:

• SSO authentication (Active Directory, SAML, Okta, etc)
• Dedicated database
• Data encryption at rest and in transit
• Continuous backup and point in time data recovery
• Full access to backups
• Tableau integration support

For further information visit our website or email [e-mail].

Limitations

• Due to a limitation with Docker, you may only have one instance of the Explorer running at a time.