go-waku/waku/options.go

185 lines
5.3 KiB
Go
Raw Normal View History

package waku
import (
"crypto/ecdsa"
"time"
"github.com/ethereum/go-ethereum/common"
"github.com/multiformats/go-multiaddr"
"github.com/urfave/cli/v2"
)
2022-07-25 15:28:17 +00:00
// RendezvousOptions are settings for enabling the rendezvous protocol for
// discovering new nodes
type RendezvousOptions struct {
Enable bool
Nodes []multiaddr.Multiaddr
}
2021-11-17 16:19:42 +00:00
2022-07-25 15:28:17 +00:00
// RendezvousServerOptions are settings to enable the waku node to act as a
// rendezvous server
type RendezvousServerOptions struct {
Enable bool
DBPath string
}
2022-07-25 15:28:17 +00:00
// DiscV5Options are settings to enable a modified version of Ethereums Node
// Discovery Protocol v5 as a means for ambient node discovery.
2021-11-17 16:19:42 +00:00
type DiscV5Options struct {
Enable bool
Nodes cli.StringSlice
Port int
AutoUpdate bool
2021-11-17 16:19:42 +00:00
}
2022-07-25 15:28:17 +00:00
// RelayOptions are settings to enable the relay protocol which is a pubsub
// approach to peer-to-peer messaging with a strong focus on privacy,
// censorship-resistance, security and scalability.
type RelayOptions struct {
Enable bool
Topics cli.StringSlice
PeerExchange bool
MinRelayPeersToPublish int
}
2022-07-05 21:28:34 +00:00
type RLNRelayOptions struct {
Enable bool
2022-09-11 21:08:58 +00:00
CredentialsPath string
2022-07-05 21:28:34 +00:00
MembershipIndex int
PubsubTopic string
ContentTopic string
Dynamic bool
ETHPrivateKey *ecdsa.PrivateKey
2022-07-05 21:28:34 +00:00
ETHClientAddress string
MembershipContractAddress common.Address
2022-07-05 21:28:34 +00:00
}
2022-07-25 15:28:17 +00:00
// FilterOptions are settings used to enable filter protocol. This is a protocol
// that enables subscribing to messages that a peer receives. This is a more
// lightweight version of WakuRelay specifically designed for bandwidth
// restricted devices.
type FilterOptions struct {
Enable bool
DisableFullNode bool
Nodes []multiaddr.Multiaddr
Timeout time.Duration
}
2021-10-09 18:18:53 +00:00
// LightpushOptions are settings used to enable the lightpush protocol. This is
// a lightweight protocol used to avoid having to run the relay protocol which
// is more resource intensive. With this protocol a message is pushed to a peer
// that supports both the lightpush protocol and relay protocol. That peer will
// broadcast the message and return a confirmation that the message was
// broadcasted
type LightpushOptions struct {
Enable bool
Nodes []multiaddr.Multiaddr
}
2021-10-09 18:18:53 +00:00
// StoreOptions are settings used for enabling the store protocol, used to
// retrieve message history from other nodes as well as acting as a store
// node and provide message history to nodes that ask for it.
type StoreOptions struct {
Enable bool
ShouldResume bool
RetentionTime time.Duration
RetentionMaxMessages int
Nodes []multiaddr.Multiaddr
}
// SwapOptions are settings used for configuring the swap protocol
type SwapOptions struct {
2022-06-19 21:47:39 +00:00
Enable bool
Mode int
PaymentThreshold int
DisconnectThreshold int
}
2021-10-09 18:18:53 +00:00
// DNSDiscoveryOptions are settings used for enabling DNS-based discovery
// protocol that stores merkle trees in DNS records which contain connection
// information for nodes. It's very useful for bootstrapping a p2p network.
type DNSDiscoveryOptions struct {
Enable bool
URLs cli.StringSlice
Nameserver string
}
2021-10-09 18:18:53 +00:00
// MetricsOptions are settings used to start a prometheus server for obtaining
// useful node metrics to monitor the health of behavior of the go-waku node.
type MetricsOptions struct {
Enable bool
Address string
Port int
}
// RPCServerOptions are settings used to start a json rpc server
type RPCServerOptions struct {
Enable bool
Port int
Address string
Admin bool
Private bool
RelayCacheCapacity int
}
// RESTServerOptions are settings used to start a rest http server
type RESTServerOptions struct {
Enable bool
Port int
Address string
Admin bool
Private bool
RelayCacheCapacity int
}
2022-07-25 15:28:17 +00:00
// WSOptions are settings used for enabling websockets and secure websockets
// support
2022-03-22 13:12:58 +00:00
type WSOptions struct {
Enable bool
2022-08-25 20:36:04 +00:00
WSPort int
WSSPort int
2022-03-22 13:12:58 +00:00
Address string
Secure bool
KeyPath string
CertPath string
}
2021-10-09 18:18:53 +00:00
// Options contains all the available features and settings that can be
// configured via flags when executing go-waku as a service.
type Options struct {
Port int
Address string
2022-03-22 00:48:46 +00:00
Dns4DomainName string
NodeKey *ecdsa.PrivateKey
KeyFile string
2022-07-25 12:24:42 +00:00
KeyPasswd string
GenerateKey bool
Overwrite bool
StaticNodes []multiaddr.Multiaddr
KeepAlive time.Duration
UseDB bool
DBPath string
AdvertiseAddress string
Version bool // TODO: use vflag from urcli
ShowAddresses bool
LogLevel string
LogEncoding string
2022-06-13 18:30:35 +00:00
NAT string
2022-06-19 21:47:39 +00:00
PersistPeers bool
2022-03-22 13:12:58 +00:00
Websocket WSOptions
Relay RelayOptions
Store StoreOptions
Swap SwapOptions
Filter FilterOptions
LightPush LightpushOptions
2022-07-05 21:28:34 +00:00
RLNRelay RLNRelayOptions
DiscV5 DiscV5Options
Rendezvous RendezvousOptions
RendezvousServer RendezvousServerOptions
DNSDiscovery DNSDiscoveryOptions
Metrics MetricsOptions
RPCServer RPCServerOptions
RESTServer RESTServerOptions
}