Central repository for work on libp2p

This repository is the central place for Rust development of the libp2p spec.

Warning: While we are trying our best to be compatible with other libp2p implementations, we cannot guarantee that this is the case considering the lack of a precise libp2p specifications.

Documentation

How to use the library?

• Main documentation: https://docs.rs/libp2p

Where to ask questions?

• In the Rust section of https://discuss.libp2p.io.
• In the #libp2p IRC channel on freenode.
• By opening an issue in this repository.

Repository Structure

The main components of this repository are structured as follows:

• core/: The implementation of mwc-libp2p-core with its Network, Transport and StreamMuxer API on which almost all other crates depend.

• transports/: Implementations of transport protocols (e.g. TCP) and protocol upgrades (e.g. for authenticated encryption, compression, ...) based on the mwc-libp2p-core Transport API .

• muxers/: Implementations of the StreamMuxer interface of mwc-libp2p-core, e.g. (sub)stream multiplexing protocols on top of (typically TCP) connections. Multiplexing protocols are (mandatory) Transport upgrades.

• swarm/: The implementation of mwc-libp2p-swarm building on mwc-libp2p-core with the central interfaces NetworkBehaviour and ProtocolsHandler used to implement application protocols (see protocols/).

• protocols/: Implementations of application protocols based on the mwc-libp2p-swarm APIs.

• misc/: Utility libraries.

• examples/: Worked examples of built-in application protocols (see protocols/) with common Transport configurations.

Notable users

(open a pull request if you want your project to be added here)

• https://github.com/paritytech/polkadot
• https://github.com/paritytech/substrate
• https://github.com/sigp/lighthouse
• https://github.com/golemfactory/golem-libp2p
• https://github.com/comit-network
• https://github.com/rs-ipfs/rust-ipfs
• https://github.com/marcopoloprotocol/marcopolo
• https://github.com/ChainSafe/forest

lib.rs:

mDNS is a protocol defined by RFC 6762 that allows querying nodes that correspond to a certain domain name.

In the context of libp2p, the mDNS protocol is used to discover other nodes on the local network that support libp2p.

Usage

This crate provides the Mdns struct which implements the NetworkBehaviour trait. This struct will automatically discover other libp2p nodes on the local network.