Marketplace has launched, further enabling blockchain developers! Learn more

How to Run the Expedition Block Explorer for Ethereum

November 07, 2022

Overview

When exploring and working with the Ethereum blockchain network, a developer might find themselves needing to look up transactions, tokens, addresses, or prices. An Ethereum blockchain explorer, a useful, beginner-friendly tool used to analyze various blockchain data, would be the ideal solution for this. It can be used by both developers and regular users and can help reduce the development time for building on Ethereum.  

In this guide, we will walk through how to install and run the Expedition Ethereum block explorer locally. Let's get started!  

What is the Expedition Ethereum Block Explorer?

Expedition is an open-source block explorer for Ethereum created by Etclabs team. It is built on a variety of other open-source items, including Jade Service Runner for managing background services (Multi-Geth) and OpenRPC for underlying functionality. If you have a node endpoint, you can run Expedition directly. 

Expedition does not use a database and can be configured to point at any remote RPC node for any EVM-based network. We can look forward to these features once everything is set up:

  • Display chain id
  • Node Syncing status
  • Runtime configuration for endpoints
  • Search by Block, Transaction, Address
  • Charts for the hash, transaction count, gas used, uncles
  • Preview latest blocks with pagination
  • Multi-language support

Before proceeding, please make sure you have the following installed on your machine. If you don't, follow the help links to get set up:

  • NodeJS installed  [help]
  • Git installed  [help]

Install Expedition Ethereum Block Explorer

As mentioned earlier, Expedition doesn’t use any database, so we can simply clone it and run it using our QuickNode URL. We can install Expedition using git and npm installer of Node.js. You can simply copy the below in your cmd/terminal:

install expedition ethereum block explorer

Copy
$ git clone https://github.com/etclabscore/expedition.git && cd expedition && npm install

Above, we are first cloning the Expedition file from GitHub. Then we're changing the directory to expedition and finally, we're installing expedition using npm.

You might encounter errors such as 'HTTP' request fatal' and this might be because of the git version installed on your computer. Ensure that you have the latest and most stable git version. Additionally, make sure that you copy the exact link because these links are case-sensitive in git.

The most common issue at this step is an internal failure with node-gyp. You can follow node-gyp installation instructions here if you run into it.

Note: You will need to have your python version match one of the compatible versions listed in the instructions above if you encounter the node-gyp issue.

Set Up Your QuickNode Endpoint

For our purposes today, we'll need an API endpoint to connect with the Ethereum main network. You're welcome to use public nodes or deploy and manage your own infrastructure; however, if you'd like faster response times, you can leave the heavy lifting to us and sign up for a free account here.

After you've created your Ethereum endpoint, copy the HTTP Provider link on the left-hand side and save it. We'll use it in the next section. 

Screenshot of Quicknode Ethereum endpoint

Running Expedition

Now, we're ready to run our Expedition explorer. Use the following command to run it locally: 

running expedition

Copy
$ REACT_APP_ETH_RPC_URL=ADD_YOUR_ETHEREUM_NODE_URL npm start

Make sure to replace the ADD_YOUR_ETHEREUM_NODE_URL with the HTTP provider from the instructions above. 

This will start the explorer at https://localhost:3000/. You can view it in your browser and see something like this:



Voila! You now have the Expedition explorer running locally on your machine. 

Conclusion

Great work! Within just a few minutes, we were able to host our own Ethereum block explorer with QuickNode and Expedition. Since Expedition does not use any database and does not pull data in real-time, there is no maintenance cost.

We ❤️ Feedback!

If you have any feedback or questions on this guide, let us know. We'd love to hear from you! Feel free to also reach out to us via Twitter and/or our community server on Discord

Related articles 11

Ethereum Full Node vs Archive Node
Published: Apr 8, 2021
Updated: Sep 20, 2022

Ethereum runs on a network of computers (also known as nodes) that verify transactions based on a consensus protocol and ledger, which make up the blockchain. In this guide, you will learn...

Continue reading
How to setup a Chainlink node
Published: Jul 6, 2020
Updated: Sep 21, 2022

Smart-contracts are the heart and soul of all the development happening on the Ethereum blockchain, and as more and more people develop on Ethereum, smart contracts are becoming more...

Continue reading
Introduction to Ethereum Rollups
Published: Dec 28, 2021
Updated: Sep 9, 2022

Ethereum, the most popular blockchain, has seen scaling issues for quite a long time now. With high gas fees due to congestion being the primary pain point. With the increasing cost to use the...

Continue reading
How to run a Hyperledger Besu node
Published: May 18, 2021
Updated: Sep 9, 2022

As the Ethereum network continues to grow, the need for an enterprise-ready Ethereum client arises. Hyperledger Besu is an enterprise-friendly Ethereum client that can implement both public...

Continue reading
How to Run a Binance Smart Chain Node
Published: Jul 2, 2021
Updated: Oct 11, 2022

Binance Smart Chain, BSC for short, is a blockchain that seeks to provide both an alternative and extension to the Ethereum Blockchain. It has done this through several clever implementations...

Continue reading
How to install and run a Geth node
Published: Apr 5, 2020
Updated: Sep 12, 2022

Ethereum nodes are computers participating in Ethereum blockchain network. These nodes are actual computers running software that verifies, stores, and sometimes creates blocks. The actual...

Continue reading
How to run Nethermind node
Published: May 18, 2021
Updated: Nov 18, 2022

To run an Ethereum node without any problems, it is essential to choose a good node client. Nethermind is one of the oldest and most trusted Ethereum node clients. In this guide, let’s see how...

Continue reading
How to Install and Run a Stacks Node
Published: Aug 26, 2022
Updated: Sep 9, 2022

Stacks 2.0 is an open-source layer-1 blockchain that allows developers to build smart contracts and decentralized blockchain applications. This guide will demonstrate how to install the Stacks...

Continue reading
How to Use Laika with QuickNode
Published: Apr 22, 2022
Updated: Sep 9, 2022

Developers spend most of their time writing code, testing, and fixing bugs. A lot of the time spent with these tasks can be simplified by using a tool like Laika. Laika is a Web3 development...

Continue reading