package p2p import ( "context" config "gitlab.dms3.io/p2p/go-p2p/config" "gitlab.dms3.io/p2p/go-p2p-core/host" ) // Config describes a set of settings for a p2p node. type Config = config.Config // Option is a p2p config option that can be given to the p2p constructor // (`p2p.New`). type Option = config.Option // ChainOptions chains multiple options into a single option. func ChainOptions(opts ...Option) Option { return func(cfg *Config) error { for _, opt := range opts { if opt == nil { continue } if err := opt(cfg); err != nil { return err } } return nil } } // New constructs a new p2p node with the given options, falling back on // reasonable defaults. The defaults are: // // - If no transport and listen addresses are provided, the node listens to // the multiaddresses "/ip4/0.0.0.0/tcp/0" and "/ip6/::/tcp/0"; // // - If no transport options are provided, the node uses TCP and websocket // transport protocols; // // - If no multiplexer configuration is provided, the node is configured by // default to use the "yamux/1.0.0" and "mplux/6.7.0" stream connection // multiplexers; // // - If no security transport is provided, the host uses the go-p2p's noise // and/or tls encrypted transport to encrypt all traffic; // // - If no peer identity is provided, it generates a random RSA 2048 key-pair // and derives a new identity from it; // // - If no peerstore is provided, the host is initialized with an empty // peerstore. // // To stop/shutdown the returned p2p node, the user needs to cancel the passed context and call `Close` on the returned Host. func New(ctx context.Context, opts ...Option) (host.Host, error) { return NewWithoutDefaults(ctx, append(opts, FallbackDefaults)...) } // NewWithoutDefaults constructs a new p2p node with the given options but // *without* falling back on reasonable defaults. // // Warning: This function should not be considered a stable interface. We may // choose to add required services at any time and, by using this function, you // opt-out of any defaults we may provide. func NewWithoutDefaults(ctx context.Context, opts ...Option) (host.Host, error) { var cfg Config if err := cfg.Apply(opts...); err != nil { return nil, err } return cfg.NewNode(ctx) }