Libp2p implementation for the JVM, written in Kotlin π₯
List of components in the Libp2p spec and their JVM implementation status
| Component | Status | |
|---|---|---|
| Transport | tcp | π |
| quic | π | |
| websocket | π | |
| webtransport | ||
| webrtc-browser-to-server | ||
| webrtc-private-to-private | ||
| Secure Communication | noise | π |
| tls | π | |
| plaintext | π | |
| secio (deprecated) | π | |
| Protocol Select | multistream | π |
| Stream Multiplexing | yamux | π |
| mplex | π | |
| NAT Traversal | circuit-relay-v2 | π |
| autonat | π | |
| hole-punching | ||
| Discovery | bootstrap | |
| random-walk | ||
| mdns-discovery | π | |
| rendezvous | ||
| Peer Routing | kad-dht | |
| Publish/Subscribe | floodsub | π |
| gossipsub | π | |
| Storage | record | |
| Other protocols | ping | π |
| identify | π |
Legend:
- π - tested in production
- π - prototype or beta, not tested in production
- π - in progress
Deterministic Gossip simulator which may simulate networks as large as 10000 of peers
Please check the Simulator README for more details
The library is basically being developed with Android compatibility in mind. However we are not aware of anyone using it in production.
The examples/android-chatter module contains working sample Android application. This module is ignored by the Gradle
build when no Android SDK is installed.
To include the Android module define a valid SDK location with an ANDROID_HOME environment variable
or by setting the sdk.dir path in your project's local properties file local.properties.
Importing the project into Android Studio should work out of the box.
Hosting of artefacts is graciously provided by Cloudsmith.
As an alternative, artefacts are also available on JitPack.
Add the required repositories to the repositories section of your Gradle file.
repositories {
// ...
maven { url "https://dl.cloudsmith.io/public/libp2p/jvm-libp2p/maven/" }
maven { url "https://jitpack.io" }
maven { url "https://artifacts.consensys.net/public/maven/maven/" }
}Add the library to the implementation part of your Gradle file.
dependencies {
// ...
implementation 'io.libp2p:jvm-libp2p:X.Y.Z-RELEASE'
}Add the required repositories to the dependencyManagement section of the pom file:
<repositories>
<repository>
<id>libp2p-jvm-libp2p</id>
<url>https://dl.cloudsmith.io/public/libp2p/jvm-libp2p/maven/</url>
</repository>
<repository>
<id>JitPack</id>
<url>https://jitpack.io</url>
</repository>
<repository>
<id>Consensys</id>
<url>https://artifacts.consensys.net/public/maven/maven/</url>
</repository>
</repositories>Add the library to the dependencies section of the pom file:
<dependency>
<groupId>io.libp2p</groupId>
<artifactId>jvm-libp2p</artifactId>
<version>X.Y.Z-RELEASE</version>
</dependency>To build the library you will need just
- JDK (Java Development Kit) of version 11 or higher
For building a stable release version clone the master branch:
git clone https://github.com/libp2p/jvm-libp2p -b masterFor building a version with the latest updates clone the develop (default) branch:
git clone https://github.com/libp2p/jvm-libp2pTo build the library from the jvm-libp2p folder, run:
./gradlew buildAfter the build is complete you may find the library .jar file here: jvm-libp2p/build/libs/jvm-libp2p-X.Y.Z-RELEASE.jar
- Teku - Ethereum Consensus Layer client
- Nabu - minimal Java implementation of IPFS
- Peergos - peer-to-peer encrypted global filesystem
(Please open a pull request if you want your project to be added here)
Dual-licensed under MIT and ASLv2, by way of the Permissive License Stack.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent