This repository contains docker-compose files and configuration files for verifiers and blockchain nodes that are required to run a FDC client.
Bitcoin, Dogecoin and Ripple use an indexer that creates a local database with data from the blockchain. This is then exposed via api by verifier api server.
EVM based chains (Ethereum, Flare, Songbird) use a verifier api server that directly queries the rpc node.
-
Blockchain nodes:
- Bitcoin - flarefoundation/bitcoin
- Dogecoin - flarefoundation/dogecoin
- Ripple - flarefoundation/rippled
- Ethereum - ethereum/client-go and prysm
-
Indexers and verification servers for:
-
EVM verifier - flare-foundation/evm-verifier
EVM verifier also requires FLR and SGB nodes, which are not part of this repository.
The components listed here are all required to run a full FDC suite, but they are not required to be deployed from this repository. For example, if you already have a compatible Bitcoin rpc node, you can configure this repo to run everything else except for BTC node.
This repository can also be used multiple times to split this deployment across multiple servers.
The minimal hardware requirements for a complete testnet configuration are:
- CPU: 8 cores @ 2.2GHz
- DISK: 100 GB SSD disk
- MEMORY: 8 GB
The minimal hardware requirements for a complete mainnet configuration are:
- CPU: 16/32 cores/threads @ 2.2GHz
- DISK: 4 TB NVMe disk
- MEMORY: 64 GB
If you don't want to deploy everything on a single server, separate components can be deployed on different servers. In that case the requirements for a single server can be lower.
FDC suite deploy was tested on Debian 12 and Ubuntu 22.04.
Additional required software:
- Docker version 24.0.0 or higher
- Docker Compose version 2.18.0 or higher
- A machine(s) with
dockeranddocker composeinstalled. - A deployment user in the
dockergroup. - The Docker folder set to a mount point that has sufficient disk space for Docker volumes. The installation creates several Docker volumes.
git clone https://github.com/flare-foundation/fdc-suite-deployment.git
cd fdc-suite-deployment
Docker images are automatically built and published to github container registry. By default the deployment will download the images automatically. If you need to build them manually clone the required git repository (linked in the overview of this readme), and run:
docker build -t <image-tag> .replace image tag with the tag that is used in docker-compose.yaml files that use this image or modify docker-compose files to use your image tag.
The only required configuration is setting the authentication for the node. To generate a password for admin user run:
cd nodes-mainnet/btc
./generate-password.shexample output:
password: c021cae645db6d3371b26ced94c8d17a5d9f3accbf3591d8b4c0be19623e5662
String to be appended to bitcoin.conf:
rpcauth=admin:a0956d81a2344f1602d9ed7b82ef3118$2caf19c9cf27937f728f600fc14e8db97f80218d727e331a57c3cfc55b3e17fe
Your password:
c021cae645db6d3371b26ced94c8d17a5d9f3accbf3591d8b4c0be19623e5662
or configure the username and password manually:
./rpcauth.py <USERNAME> <PASSWORD>Configuration works like BTC.
For example, to generate a password for admin user run:
cd nodes-mainnet/doge
./generate-password.shDefault configuration doesn't need any additional configuration.
Configure file nodes-mainnet/eth/jwt.hex for authentication. To generate the password randomly run:
openssl rand -hex 32 > nodes-mainnet/eth/jwt.hexBlockchain nodes expose all ports by default.
Files .env.example and generate-config.sh files in the root of this repository are used to configure indexers and verifiers. They don't configure anything related to blockchain nodes.
For a simple configuration of verifiers the only file that needs to be edited is .env file in the root of this repository. Copy .env.example file to .env and edit it.
Inside this file:
For RPC nodes, fill in the authentication data you created in the previous step. If you run blockchain nodes and verifiers on the same server, you can use the ip 172.17.0.1 to reach the nodes.
Indexers will start indexing the blockchain with the block number configured in *_START_BLOCK_NUMBER variables. This needs to be set the first time when you start the indexers to avoid indexing too much data. FDC requires at least 14 days of history, so pick a block number that was finalized 14 days ago. On later restarts indexers will start indexing from the latest block in the database.
Set TESTNET to true if you are running verifiers for testnets.
Set VERIFIER_API_KEYS to api keys that will have access to verifier api servers. One or more comma separated keys can be configured. You will likely need at least one key for FDC client that will call verifier api servers.
*_DB_PASSWORD variables are used internally for the indexer database. If you don't know why you probably don't need to access the database, so set those passwords to a random string.
from the root of this repo, run ./generate-config.sh
This script uses the values from .env and generates config files from *.example files in directories:
- verifiers/btc/
- verifiers/doge/
- verifiers/xrp/
- evm-verifier/
cd into correct directory (example nodes-mainnet/btc) and run docker compose up -d.
Do this for all blockchain nodes you plan to run on the current server.
cd into correct directory (example verifiers/btc) and run docker compose up -d.
Do this for all verifiers you plan to run on the current server.