Installation 🛠

Pre-requisites

You can start using the Fetch Ledger by first installing the following:

Go 1.18+: installation instructions are available here ↗️ (opens in a new tab).
Packages: make, gcc (on Ubuntu, install them with sudo apt-get update && sudo apt-get install -y make gcc).

Building the code

You can download the latest released version from GitHub and build the project using the running the following command:

git clone https://github.com/fetchai/fetchd.git && cd fetchd

Then, you can build the code by running the following command:

make build

This will generate the ./build/fetchd binary.

For non-developer users, we recommend to install the binaries into their system. This can be done with the following command:

make install

This will install the binaries in the directory specified by your $GOBIN environment variable (default to ~/go/bin). To verify the correct installation, run the following command:

which fetchd

This should return a path such as ~/go/bin/fetchd (might be different depending on your actual Go installation).

⚠️

If you get no output, or an error such as which: no fetchd in ..., possible cause can either be that make install failed with some errors or that your go binary folder (default: ~/go/bin) is not in your PATH. You can add the ~/go/bin folder to your PATH, by adding this line at the end of your ~/.bashrc:

export PATH=$PATH:~/go/bin

and then reload it with:

source ~/.bashrc

You can also verify that you are running the correct version by running the following command:

fetchd version

This would print a version number that must be compatible with the network you are connecting to. See the network page ↗️ for the list of supported versions per available networks.

FAQ

️🚫

Error: failed to parse log level (main:info,state:info,:error): Unknown Level String: 'main:info,state:info,:error', defaulting to NoLevel.

This means that you had a pre-stargate version of fetchd (≤ v0.7.x), and that you have just installed another stargate version (≥ v0.8.x).

You can solve the issue by removing the previous configuration files with the following:

rm ~/.fetchd/config/app.toml ~/.fetchd/config/config.toml

Was this page helpful?

Contract interaction How to use chain state snapshots