Installation
StreamingFast Firehose Ethereum Installation
Last updated
Was this helpful?
StreamingFast Firehose Ethereum Installation
Last updated
Was this helpful?
Firehose installation is accomplished through a few fairly simple tasks including obtaining specific binaries and some configuration steps.
It's important to note that Firehose comes in many different flavors for different blockchains. Firehose also has a legacy version and a new version. The setup process isn't difficult however having a clear idea and path in mind before you begin is recommended.
After Firehose has been installed, configured, and synchronized with the target blockchain operating the software becomes the primary goal.
Documentation is provided for the various blockchains and versions of Firehose to get operators up and running as quickly as possible.
Firehose for Ethereum is available as a Docker image for quick and easy installation. Visit the following link to install Firehose through Docker.
Install Firehose using Docker through the terminal using the following command.
Geth extracts raw blockchain data from Ethereum nodes. The StreamingFast Firehose-enabled Blockchain Node is an instrumented, version of the official Geth implementation.
StreamingFast provides support for various Ethereum-compatible blockchains ready to use with Firehose. The overall setup and installation process is very similar across the different Ethereum-compatible blockchains.
Every Ethereum-compatible blockchain has specific requirements and other differences that should be taken into consideration before rolling out a production Firehose solution.
Important: Each blockchain has specific requirements for processing power, RAM, available disk space, and write speed that need to be considered.
Obtaining the instrumented version of Geth for the target blockchain is the first step in the Firehose setup process. The setup process differs slightly for the different blockchains.
Ethereum is the default implementation for firehose-ethereum and uses the Geth version that does not contain references to any other blockchains in its release title or file name.
The Geth binaries provided by StreamingFast have “fh” within the version to indicate they’re not the standard, non-instrumented, community-developed node version.
Firehose v1.0.0 is the most recent release of Firehose. Release versions are also provided for legacy versions of Firehose. It is recommended that new setups use the latest version and existing setups are upgraded as soon as possible.
It’s important that the Geth binary file’s version matches the Firehose for Ethereum binary file version. Firehose for Ethereum binaries v1.0.0 and above will only work with Firehose-instrumented Geth versions tagged with “fh2". The older Firehose-instrumented Geth versions tagged “fh1” are legacy versions and should not be used anymore.
Ensure that the Geth Firehose and fireeth versions match. When errors are encountered during Firehose setup it’s often because of this versioning between Geth and fireeth. Double-check both binaries using the appropriate versioning commands provided in this documentation.
Choose the Geth binary associated with the blockchain being targeted for the Firehose implementation being created. Firehose is currently available for Linux and macOS and binaries are provided for each operating system.
Save the Geth binary to a convenient location on the computer Firehose is being set up on. StreamingFast recommends simply saving binaries to the /usr/local/bin
directory on the target machine. This will enable system-wide calls to the apps within the StreamingFast suite, such as Firehose.
To check the status of the Geth setup run the binary and pass it the version flag. The Geth version will be displayed in the terminal window. This aids in ensuring the correct Geth version was downloaded.
./geth_linux version
A message similar to the following should be displayed in the terminal window If everything is working correctly.
The version seen in the message printed to the terminal should match the version of the Firehose binary downloaded in the following steps.
Save the Firehose binary to the main Firehose directory. After the archive has completed downloading extract it to obtain the Firehose binary.
To check the status of the Firehose setup run the binary and pass it the version flag. The Firehose version will be displayed in the terminal window. This aids in ensuring the correct Firehose version was downloaded.
./fireeth --version
The following message will be displayed in the terminal window if Firehose is working correctly.
The following steps will differ slightly for each blockchain. Specific configuration steps, settings, and processes are outlined for blockchains currently supported by StreamingFast.
All Firehose instrumented Geth binaries are provided on the Firehose go-ethereum . Direct links to the latest Geth binaries for the supported Ethereum-compatible blockchains are also provided below.
Another consideration is where the Firehose setup will be deployed. The next steps for full setup are determined by specifics for the target environment and blockchain. Documentation is provided for for now.