The JVM (Java, Android, Kotlin) implementation of the libp2p Networking Stack.
Background
web3j-libp2p is an implementation of the libp2p modular network stack for the Java virtual machine.
Its goal is to provide a single implementation that meets the needs of Java, Android and Kotlin developers. It is
written in Kotlin which was designed with Java and Android interop in mind.
The project was created by Web3 Labs with the support of the
Ethereum Community Fund and advisory from members of the libp2p team at
Protocol Labs.
Getting started
Versioned releases and regular snapshots will be available shortly for the various
libp2p modules. Until that time, please clone the repo and you can build the artifacts yourself:
git clone https://github.com/web3j/libp2p.git
cd libp2p
./gradlew build publishToMavenLocal
Contribute
We welcome contributions from everyone.
We are currently prioritising implementation of the libp2p modules that are required for eth2.0's Serenity release. As it currently stands
they are (taken from the following issue):
Library
Module
Available
Multiformat
Multiaddr
✅
Multihash
✅
General Purpose
Net
✅
Peer
✅
Crypto
✅
Protocol Muxer
Multistream(-select)
Stream Muxer
Multiplex
Crypto Channels
SecIO
Transport
TCP
⏳
Network Abstraction
Switch/Swarm
Peerstore
Local database backend (KV store or SQLite)
Protocols
Ping
Identify
Host Abstraction
✅
NAT traversal
Others
Floodsub/Gossipsub (w/signed message records)
Peer Routing
kad-dht
Discovery
Find_node (or whatever is chosen)
We recommend before starting work on a contribution that you communicate with the libp2p JVM community on the
Gitter channel to express your intent to ensure no-one is already working on it.
Additionally, keep an eye on the open Pull Requests and
branches to see what others are working on.
Also, please do review the project issues to identify any low hanging fruit
you can get started with!
Build instructions
git clone https://github.com/web3j/libp2p.git
cd libp2p
./gradlew build publishToMavenLocal