#network #peer-to-peer

tentacle

Minimal implementation for a multiplexed p2p network framework

21 releases

0.4.0-alpha.1 May 6, 2021
0.3.8 Feb 23, 2021
0.3.7 Jan 27, 2021
0.3.3 Nov 4, 2020
0.2.0-alpha.1 Mar 14, 2019

#49 in Network programming

Download history 520/week @ 2021-02-24 369/week @ 2021-03-03 369/week @ 2021-03-10 225/week @ 2021-03-17 549/week @ 2021-03-24 277/week @ 2021-03-31 280/week @ 2021-04-07 357/week @ 2021-04-14 362/week @ 2021-04-21 350/week @ 2021-04-28 239/week @ 2021-05-05 746/week @ 2021-05-12 1129/week @ 2021-05-19 662/week @ 2021-05-26 334/week @ 2021-06-02 234/week @ 2021-06-09

1,649 downloads per month
Used in 16 crates (6 directly)

MIT license

710KB
17K SLoC

Tentacle

Build Status image

Overview

This is a minimal implementation for a multiplexed p2p network based on yamux that supports mounting custom protocols.

Architecture

  1. Data stream transmission
+----+      +----------------+      +-----------+      +-------------+      +----------+      +------+
|user| <--> | custom streams | <--> |Yamux frame| <--> |Secure stream| <--> |TCP stream| <--> |remote|
+----+      +----------------+      +-----------+      +-------------+      +----------+      +------+
  1. Code implementation

All data is passed through the futures channel, yamux splits the actual tcp/websocket stream into multiple substreams, and the service layer wraps the yamux substream into a protocol stream.

Detailed introduction: 中文/English

Note: It is not compatible with libp2p.

Status

The API of this project is basically usable. However we still need more tests. PR is welcome.

The codes in the protocols/ directory are no longer maintained and only used as reference

Feature flatc is not recommended and will be removed in the next version.

Usage

From cargo

[dependencies]
tentacle = { version = "0.3", features = ["molc"] }

Example

  1. Clone
$ git clone https://github.com/nervosnetwork/tentacle.git
  1. On one terminal:

Listen on 127.0.0.1:1337

$ RUST_LOG=simple=info,tentacle=debug cargo run --example simple --features molc,ws -- server
  1. On another terminal:
$ RUST_LOG=simple=info,tentacle=debug cargo run --example simple --features molc
  1. Now you can see some data interaction information on the terminal.

You can see more detailed example in these three repos:

Run on browser and test

  1. setup a ws server:
$ cd tentacle && RUST_LOG=info cargo run --example simple --features molc,ws -- server
  1. setup a browser client
$ cd simple_wasm/www && wasm-pack build
$ npm install && npm run start

all wasm code generate from book

  1. Use a browser to visit http://localhost:8080/

  2. Now you can see the connection on the server workbench or on browser's console

Other Languages

Implementations in other languages

Why?

Because when I use rust-libp2p, I have encountered some difficult problems, and it is difficult to locate whether it is my problem or the library itself, it is better to implement one myself.

Dependencies

~4.5–9MB
~179K SLoC