README
¶
Fetch.ai fetchd repository
This repository contains the source code for validators on the Fetch network. The source is based on the wasmd variant of the Cosmos-SDK, which includes a virtual machine that compiles to WebAssembly. It contains Fetch.ai-specific updates required for the test networks and future mainne t, including a decentralized random beacon (DRB) and a novel, compact multi-signatures scheme. Versions of this repository are not currently syncrhonised with either wasmd or the Cosmos-SDK. Please refer to the releases section for the compatiblity with upstream versions.
Note: Requires Go 1.16+
Supported Systems
The supported systems are limited by the dlls created in go-cosmwasm. In particular, we only support MacOS and Linux.
For linux, the default is to build for glibc, and we cross-compile with CentOS 7 to provide
backwards compatibility for glibc 2.12+. This includes all known supported distributions
using glibc (CentOS 7 uses 2.12, obsolete Debian Jessy uses 2.19).
As of 0.5.x we support muslc Linux systems, in particular Alpine linux,
which is popular in docker distributions. Note that we do not store the
static muslc build in the repo, so you must compile this yourself, and pass -tags muslc.
Please look at the Dockerfile for an example of how we build a static Go
binary for muslc. (Or just use this Dockerfile for your production setup).
Quick Start
Building and testing the project
First, install golang >= v1.16 (follow the guide from https://golang.org/dl/) and execute the following commands:
make install
You should now have fetchd successfully installed in your path. You can check this with 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 an error such as
which: no fetchd in ..., this mean either fetchd haven't been built properly or that your go binary folder is not in yourPATH. Check the installation guide again.
You can also verify that you are running the correct version
fetchd version
This should print a version number that must be compatible with the network you're connecting to (see the network page for the list of supported versions per network).
Alternatively, you can also build without installing the binary with:
make build
The fetchd binary will be available under ./build/fetchd.
Run a simple local test network
The easiest way to get started with a simple network is to run the docker-compose. The details of this can be found here. By default it will launch a small 3 validator nodes network.
Directories