status-go/wakuv2/config.go

// Copyright 2019 The Waku Library Authors.
//
// The Waku library is free software: you can redistribute it and/or modify
// it under the terms of the GNU Lesser General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.
//
// The Waku library is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty off
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
// GNU Lesser General Public License for more details.
//
// You should have received a copy of the GNU Lesser General Public License
// along with the Waku library. If not, see <http://www.gnu.org/licenses/>.
//
// This software uses the go-ethereum library, which is licensed
// under the GNU Lesser General Public Library, version 3 or any later.

package wakuv2

import (
	"errors"

	"go.uber.org/zap"

	ethdisc "github.com/ethereum/go-ethereum/p2p/dnsdisc"

	"github.com/status-im/status-go/wakuv2/common"
)

var (
	ErrBadLightClientConfig = errors.New("either peer exchange server or discv5 must be disabled, and the peer exchange client must be enabled")
	ErrBadFullNodeConfig    = errors.New("peer exchange server and discv5 must be enabled, and the peer exchange client must be disabled")
)

// Config represents the configuration state of a waku node.
type Config struct {
	MaxMessageSize                         uint32           `toml:",omitempty"` // Maximal message length allowed by the waku node
	Host                                   string           `toml:",omitempty"`
	Port                                   int              `toml:",omitempty"`
	EnablePeerExchangeServer               bool             `toml:",omitempty"` // PeerExchange server makes sense only when discv5 is running locally as it will have a cache of peers that it can respond to in case a PeerExchange request comes from the PeerExchangeClient
	EnablePeerExchangeClient               bool             `toml:",omitempty"`
	MinPeersForRelay                       int              `toml:",omitempty"` // Indicates the minimum number of peers required for using Relay Protocol
	MinPeersForFilter                      int              `toml:",omitempty"` // Indicates the minimum number of peers required for using Filter Protocol
	LightClient                            bool             `toml:",omitempty"` // Indicates if the node is a light client
	WakuNodes                              []string         `toml:",omitempty"`
	Rendezvous                             bool             `toml:",omitempty"`
	DiscV5BootstrapNodes                   []string         `toml:",omitempty"`
	Nameserver                             string           `toml:",omitempty"` // Optional nameserver to use for dns discovery
	Resolver                               ethdisc.Resolver `toml:",omitempty"` // Optional resolver to use for dns discovery
	EnableDiscV5                           bool             `toml:",omitempty"` // Indicates whether discv5 is enabled or not
	DiscoveryLimit                         int              `toml:",omitempty"` // Indicates the number of nodes to discover with peer exchange client
	AutoUpdate                             bool             `toml:",omitempty"`
	UDPPort                                int              `toml:",omitempty"`
	EnableStore                            bool             `toml:",omitempty"`
	StoreCapacity                          int              `toml:",omitempty"`
	StoreSeconds                           int              `toml:",omitempty"`
	TelemetryServerURL                     string           `toml:",omitempty"`
	TelemetrySendPeriodMs                  int              `toml:",omitempty"` // Number of milliseconds to wait between sending requests to telemetry service
	DefaultShardPubsubTopic                string           `toml:",omitempty"` // Pubsub topic to be used by default for messages that do not have a topic assigned (depending whether sharding is used or not)
	DefaultShardedPubsubTopics             []string         `toml:", omitempty"`
	ClusterID                              uint16           `toml:",omitempty"`
	EnableConfirmations                    bool             `toml:",omitempty"` // Enable sending message confirmations
	SkipPublishToTopic                     bool             `toml:",omitempty"` // Used in testing
	EnableMissingMessageVerification       bool             `toml:",omitempty"`
	EnableStoreConfirmationForMessagesSent bool             `toml:",omitempty"` //Flag that enables checking with store node for sent message confimration
	UseThrottledPublish                    bool             `toml:",omitempty"` // Flag that indicates whether a rate limited priority queue will be used to send messages or not
}

func (c *Config) Validate(logger *zap.Logger) error {
	if c.LightClient && (c.EnablePeerExchangeServer || c.EnableDiscV5 || !c.EnablePeerExchangeClient) {
		logger.Warn("bad configuration for a light client", zap.Error(ErrBadLightClientConfig))
		return nil
	}
	if !c.LightClient && (!c.EnablePeerExchangeServer || !c.EnableDiscV5 || c.EnablePeerExchangeClient) {
		logger.Warn("bad configuration for a full node", zap.Error(ErrBadFullNodeConfig))
		return nil
	}
	return nil
}

var DefaultConfig = Config{
	MaxMessageSize:    common.DefaultMaxMessageSize,
	Host:              "0.0.0.0",
	Port:              0,
	DiscoveryLimit:    20,
	MinPeersForRelay:  1, // TODO: determine correct value with Vac team
	MinPeersForFilter: 2, // TODO: determine correct value with Vac team and via testing
	AutoUpdate:        false,
}

func setDefaults(cfg *Config) *Config {
	if cfg == nil {
		cfg = new(Config)
	}

	if cfg.MaxMessageSize == 0 {
		cfg.MaxMessageSize = DefaultConfig.MaxMessageSize
	}

	if cfg.Host == "" {
		cfg.Host = DefaultConfig.Host
	}

	if cfg.DiscoveryLimit == 0 {
		cfg.DiscoveryLimit = DefaultConfig.DiscoveryLimit
	}

	if cfg.MinPeersForRelay == 0 {
		cfg.MinPeersForRelay = DefaultConfig.MinPeersForRelay
	}

	if cfg.MinPeersForFilter == 0 {
		cfg.MinPeersForFilter = DefaultConfig.MinPeersForFilter
	}

	if cfg.DefaultShardPubsubTopic == "" {
		cfg.DefaultShardPubsubTopic = DefaultShardPubsubTopic()
		//For now populating with both used shards, but this can be populated from user subscribed communities etc once community sharding is implemented
		cfg.DefaultShardedPubsubTopics = append(cfg.DefaultShardedPubsubTopics, DefaultShardPubsubTopic())
		cfg.DefaultShardedPubsubTopics = append(cfg.DefaultShardedPubsubTopics, DefaultNonProtectedPubsubTopic())
	}

	return cfg
}