libp2p is a p2p network SDK implemented in java language. The functional modules that have been implemented so far include

• node discovery by p2p, include ipv4 and ipv6,
• tcp connection management,
• publish nodes on dns domain and node discovery by dns,
• support compressed message transmission among nodes

Building libp2p requires git and Oracle JDK 1.8 to be installed, other JDK versions are not supported yet. Make sure you operate on Linux and MacOS operating systems.

Clone the repo and switch to the main branch

$ git clone https://github.com/tronprotocol/libp2p.git
$ cd libp2p
$ git checkout -t origin/main

Then, run the following command to build libp2p, the libp2p.jar file can be found in libp2p/build/libs/ after being built successfully.

$ ./gradlew clean build -x test

libp2p can run independently or be imported into other projects.

Running libp2p requires Oracle JDK 1.8 to be installed, other JDK versions are not supported yet. Make sure you operate on Linux and MacOS operating systems. then run the following command to start the node:

$ nohup java -jar libp2p.jar [options] >> start.log 2>&1 &

See the manual for details on options

Add repo setting:

repositories {
    ...
    mavenCentral()
}

Then add the required packages as dependencies. Please add dependencies locally.

dependencies {
    implementation group: 'io.github.tronprotocol', name: 'libp2p', version: '2.1.0'
}

Or if you are using the jar files as your dependencies:

dependencies {
    implementation fileTree(dir:'libs', include: 'libp2p.jar')
}

<repositories>
    <repository>
        <id>central-repos</id>
        <name>Central Repository</name>
        <url>https://repo.maven.apache.org/maven2</url>
    </repository>
</repositories>

<dependency>
    <groupId>io.github.tronprotocol</groupId>
    <artifactId>libp2p</artifactId>
    <version>2.1.0</version>
</dependency>

For some examples please check our example package.

• After February 21, 2023， releases are signed the gpg key:

  pub: 1254 F859 D2B1 BD9F 66E7 107D F859 BCB4 4A28 290B
  uid: [email protected]