Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/libp2p/rust-libp2p

The Rust Implementation of the libp2p networking stack.
https://github.com/libp2p/rust-libp2p

decentralization libp2p networking peer-to-peer rust

Last synced: 6 days ago
JSON representation

The Rust Implementation of the libp2p networking stack.

Host: GitHub
URL: https://github.com/libp2p/rust-libp2p
Owner: libp2p
License: mit
Created: 2017-03-24T20:05:11.000Z (almost 8 years ago)
Default Branch: master
Last Pushed: 2024-10-29T10:18:42.000Z (3 months ago)
Last Synced: 2024-10-29T15:32:13.279Z (3 months ago)
Topics: decentralization, libp2p, networking, peer-to-peer, rust
Language: Rust
Homepage: https://libp2p.io
Size: 17.7 MB
Stars: 4,554
Watchers: 98
Forks: 949
Open Issues: 209
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Security: SECURITY.md
- Roadmap: ROADMAP.md

Awesome Lists containing this project

awesome-rust - libp2p/rust-libp2p - libp2p.svg?style=svg)](https://app.circleci.com/pipelines/github/libp2p/rust-libp2p) (Libraries / Network programming)
awesome-blockchain-rust - rust-libp2p
awesome-rust-cn - libp2p/rust-libp2p
awesome-substrate - rust-libp2p, The Rust Implementation of libp2p networking stack

README

        # Central repository for work on libp2p



[![dependency status](https://deps.rs/repo/github/libp2p/rust-libp2p/status.svg?style=flat-square)](https://deps.rs/repo/github/libp2p/rust-libp2p)

[![Crates.io](https://img.shields.io/crates/v/libp2p.svg)](https://crates.io/crates/libp2p)

[![docs.rs](https://img.shields.io/badge/api-rustdoc-blue.svg)](https://docs.rs/libp2p)

[![docs.rs master](https://img.shields.io/badge/docs-master-blueviolet)](https://libp2p.github.io/rust-libp2p/libp2p/)

This repository is the central place for Rust development of the [libp2p](https://libp2p.io) spec.

## Getting started

- **Main documentation** can be found on https://docs.rs/libp2p.

- The **[examples](examples)** folder contains small binaries showcasing the

  many protocols in this repository.

- For **security related issues** please [file a private security vulnerability

  report](https://github.com/libp2p/rust-libp2p/security/advisories/new) . Please do not file a

  public issue on GitHub.

- To **report bugs, suggest improvements or request new features** please open a

  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.

- For synchronous discussions join the [open rust-libp2p maintainer

  calls](https://github.com/libp2p/rust-libp2p/discussions?discussions_q=open+maintainers+call+)

  or the [biweekly libp2p community calls](https://discuss.libp2p.io/t/libp2p-community-calls/1157).

## Repository Structure

The main components of this repository are structured as follows:

  * `core/`: The implementation of `libp2p-core` with its `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 `ConnectionHandler` used

    to implement application protocols (see `protocols/`).

  * `protocols/`: Implementations of application protocols based on the

    `libp2p-swarm` APIs.

  * `misc/`: Utility libraries.

  * `libp2p/examples/`: Worked examples of built-in application protocols (see `protocols/`)

    with common `Transport` configurations.

## Community Guidelines

The libp2p project operates under the [IPFS Code of

Conduct](https://github.com/ipfs/community/blob/master/code-of-conduct.md).

> tl;dr

>

> - Be respectful.

> - We're here to help: [email protected]

> - Abusive behavior is never tolerated.

> - Violations of this code may result in swift and permanent expulsion from the

>   IPFS [and libp2p] community.

> - "Too long, didn't read" is not a valid excuse for not knowing what is in

>   this document.

## Maintainers

(In alphabetical order.)

- Guillaume Michel ([@guillaumemichel](https://github.com/guillaumemichel))

- João Oliveira ([@jxs](https://github.com/jxs))

## Notable users

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

- [COMIT](https://github.com/comit-network/xmr-btc-swap) - Bitcoin–Monero Cross-chain Atomic Swap.

- [Forest](https://github.com/ChainSafe/forest) - An implementation of Filecoin written in Rust.

- [fuel-core](https://github.com/FuelLabs/fuel-core) - A Rust implementation of the Fuel protocol.

- [HotShot](https://github.com/EspressoSystems/HotShot) - Decentralized sequencer in Rust developed by [Espresso Systems](https://www.espressosys.com/).

- [ipfs-embed](https://github.com/ipfs-rust/ipfs-embed) - A small embeddable ipfs implementation used and maintained by [Actyx](https://www.actyx.com).

- [Homestar](https://github.com/ipvm-wg/homestar) - An InterPlanetary Virtual Machine (IPVM) implementation used and maintained by Fission.

- [beetle](https://github.com/n0-computer/beetle) - Next-generation implementation of IPFS for Cloud & Mobile platforms.

- [Lighthouse](https://github.com/sigp/lighthouse) - Ethereum consensus client in Rust.

- [Locutus](https://github.com/freenet/locutus) - Global, observable, decentralized key-value store.

- [OpenMina](https://github.com/openmina/openmina) - In-browser Mina Rust implementation.

- [rust-ipfs](https://github.com/rs-ipfs/rust-ipfs) - IPFS implementation in Rust.

- [Safe Network](https://github.com/maidsafe/safe_network) - Safe Network implementation in Rust.

- [SQD Network](https://github.com/subsquid/sqd-network) - A decentralized storage for Web3 data.

- [Starcoin](https://github.com/starcoinorg/starcoin) - A smart contract blockchain network that scales by layering.

- [Subspace](https://github.com/subspace/subspace) - Subspace Network reference implementation

- [Substrate](https://github.com/paritytech/substrate) - Framework for blockchain innovation,

used by [Polkadot](https://www.parity.io/technologies/polkadot/).

- [Taple](https://github.com/opencanarias/taple-core) - Sustainable DLT for asset and process traceability by [OpenCanarias](https://www.opencanarias.com/en/).

- [Ceylon](https://github.com/ceylonai/ceylon) - A Multi-Agent System (MAS) Development Framework.