mirror of https://github.com/fluencelabs/rust-libp2p synced 2025-06-27 00:31:35 +00:00

Go to file

Max Inden a2e774992d src: Move introduction to new tutorial.rs (#2018 )

This commit extends the ping example in `src/tutorial.rs, by walking a
newcomer through the implementation of a simple ping node step-by-step,
introducing all the core libp2p concepts along the way.

With the ping tutorial in place, there is no need for the lengthy libp2p
crate level introduction, which is thus removed with this commit.

Co-authored-by: Roman Borschel <romanb@users.noreply.github.com>

2021-04-01 15:46:41 +02:00

.github

Make clippy "happy". (#1950 )

2021-02-15 11:59:51 +01:00

core

swarm: Extend NetworkBehaviour callbacks. (#2011 )

2021-03-24 17:21:53 +01:00

docs

docs/release: Only choose crate name not bench name (#1897 )

2020-12-18 11:35:39 +01:00

examples

src: Move introduction to new tutorial.rs (#2018 )

2021-04-01 15:46:41 +02:00

misc

*: Prepare v0.36.0 release

2021-03-17 15:28:13 +01:00

muxers

*: Prepare v0.36.0 release

2021-03-17 15:28:13 +01:00

protocols

build(deps): update derive_builder requirement from 0.9.0 to 0.10.0 (#2026 )

2021-04-01 13:57:29 +02:00

src

src: Move introduction to new tutorial.rs (#2018 )

2021-04-01 15:46:41 +02:00

swarm

swarm/CHANGELOG: Add entry for NetworkBehaviour callbacks

2021-03-24 17:33:15 +01:00

swarm-derive

swarm: Extend NetworkBehaviour callbacks. (#2011 )

2021-03-24 17:21:53 +01:00

transports

transports/wasm-ext: Prepare v0.28.1

2021-04-01 14:28:32 +02:00

.editorconfig

Update .editorconfig to align with rustfmt. (#162 )

2018-04-09 10:52:25 +02:00

.gitignore

initial commit: transport interfaces

2017-04-08 03:31:22 +02:00

Cargo.toml

transports/wasm-ext: Prepare v0.28.1

2021-04-01 14:28:32 +02:00

CHANGELOG.md

transports/wasm-ext: Prepare v0.28.1

2021-04-01 14:28:32 +02:00

LICENSE

Some petty changes head of QUIC (#1854 )

2020-11-24 12:40:11 +01:00

README.md

Update README.md (#2003 )

2021-03-18 11:50:31 +01:00

README.md

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.

Getting started

Main documentation can be found on https://docs.rs/libp2p.
The examples folder contains small binaries showcasing the many protocols in this repository.
To report bugs, suggest improvements or request new features please open GitHub issue on this repository.
For rust-libp2p specific questions please use the GitHub Discussions forum https://github.com/libp2p/rust-libp2p/discussions.
For discussions and questions related to multiple libp2p implementations please use the libp2p Discourse forum https://discuss.libp2p.io.

Repository Structure

The main components of this repository are structured as follows:

core/: The implementation of 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 libp2p-core Transport API .
muxers/: Implementations of the StreamMuxer interface of libp2p-core, e.g. (sub)stream multiplexing protocols on top of (typically TCP) connections. Multiplexing protocols are (mandatory) Transport upgrades.
swarm/: The implementation of libp2p-swarm building on libp2p-core with the central interfaces NetworkBehaviour and ProtocolsHandler used to implement application protocols (see protocols/).
protocols/: Implementations of application protocols based on the 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)