History

Jakub Sokołowski 5ac8b873b8 config/cli/fleet: disable Rendezvous, drop nodes Since we've broken LibP2P communication with our Rendezvous nodes somewhere after `v0.79.11` we should not enable it by defaults since it generates errors like these: ``` failed to dial 16Uiu2...d687e4: all dials failed failed to negotiate security protocol: protocol not supported ``` Since normal bootnodes are defined as well as a list of static nodes there should not be a need for using Rendezvous as well. Resolves: https://github.com/status-im/status-go/issues/2309 Signed-off-by: Jakub Sokołowski <jakub@status.im>		2021-08-13 16:22:17 +02:00
..
cli	config/cli/fleet: disable Rendezvous, drop nodes	2021-08-13 16:22:17 +02:00
README.md	make Waku the default protocol	2020-08-20 10:27:47 +02:00
status-chain-genesis.json	Streamline configuration in status-go. Part of #1180 (#1183 )	2018-09-13 18:31:29 +02:00

README.md

Introduction

This document describes the available options in the JSON config for status-go.

The structure of the JSON config is defined in the params/config.go file, which also contains detailed comments on meaning of each option. The NodeConfig struct defines the general configuration keys at the root of the JSON file.

If the descriptions of any options are too vague feel free to open an issue.

Example config files can be viewed in the config/cli folder.

Important Sections

The JSON config is separated into several sections. The most important ones are listed below.

`NodeConfig`

The root of the JSON configuration.

An example of most important settings would include:

{
    "NetworkID": 1,
    "DataDir": "/tmp/status-go-data",
    "NodeKey": "123qwe123qwe123qwe123",
    "Rendezvous": true,
    "NoDiscovery": false,
    "ListenAddr": "0.0.0.0:30303",
    "AdvertiseAddr": "12.34.56.78",
    "RegisterTopics": ["whispermail"]
}

If you'd want to enable JSON RPC port you'd need:

{
    "HTTPEnabled": true,
    "HTTPHost": "0.0.0.0",
    "HTTPPort": 8545,
    "APIModules": "eth,net,web3,admin"
}

In order to adjust logging settings you'd need:

{
    "LogFile": "/var/log/status-go.log",
    "LogLevel": "INFO",
    "LogMaxSize": 200,
    "LogMaxBackups": 5,
    "LogCompressRotated": true
}

Valid LogLevel settings are: ERROR, WARN, INFO, DEBUG, TRACE

`WakuConfig`

If you want your node to relay Waku(modified Whisper) protocol messages you'll want to include this:

{
    "WakuConfig": {
        "Enabled": true,
        "EnableMailServer": true,
        "DataDir": "/tmp/status-go-data/waku",
        "MailServerPassword": "status-offline-inbox"
    }
}

The MailServerPassword is used for symmetric encryption of history requests.

By default it will use leveldb embedded database. To use postgres instead you need to add this to your config:

{
    "DatabaseConfig": {
      "PGConfig": {
        "Enabled": true,
        "URI": "postgres://user:password@host:port?options"
      }
    }
}

NOTE: The default password used by Status App and our mailservers is status-offline-inbox.

`ClusterConfig`

This config manages what peers and bootstrap nodes your status-go instance connects when it starts.

{
  "ClusterConfig": {
    "Enabled": true,
    "Fleet": "eth.prod",
    "BootNodes": [
      "enode://345ert345ert@23.45.67.89:30404"
    ],
    "TrustedMailServers": [
      "enode://qwe123qwe123@98.76.54.32:30504"
    ],
    "StaticNodes": [
      "enode://123qwe123qwe@12.34.56.78:30305"
    ],
    "RendezvousNodes": [
      "/ip4/87.65.43.21/tcp/30703/ethv4/16Uiu2HAm312312312312312312312312"
    ]
  }
}

BootNodes help the status-go instance find peers. They are more important to have than StaticNodes or TrustedMailServers, which are just statically added peers on start.

RendezvousNodes are an alternative protocol for doing the same peer discovery as BootNodes do.