Tentacle

概述

这是一个基于 yamux 的最小化多路复用 p2p 网络实现，支持挂载自定义协议。

架构

1. 数据流传输

+----+      +----------------+      +-----------+      +-------------+      +----------+      +------+
|user| <--> | custom streams | <--> |Yamux frame| <--> |Secure stream| <--> |TCP stream| <--> |remote|
+----+      +----------------+      +-----------+      +-------------+      +----------+      +------+

2. 代码实现

所有数据都通过 futures 通道传递，yamux 将实际的 tcp/websocket 流分割成多个子流，服务层将 yamux 子流包装成协议流。

详细介绍： 中文/English

注意：与 libp2p 不兼容。

状态

此项目的 API 基本可用。但我们仍然需要更多的测试。欢迎 PR。

目录 protocols/ 中的代码不再维护，仅用作参考

用法

从 cargo

[dependencies]
tentacle = { version = "0.4.0" }

示例

1. 克隆

$ git clone https://github.com/nervosnetwork/tentacle.git

2. 在一个终端

监听 127.0.0.1:1337

$ RUST_LOG=simple=info,tentacle=debug cargo run --example simple --features ws -- server

3. 在另一个终端

$ RUST_LOG=simple=info,tentacle=debug cargo run --example simple

4. 现在你可以在终端上看到一些数据交互信息。

你可以在这些三个仓库中看到更详细的示例

• p2p-message
• ckb
• cita
• muta
• axon

在浏览器上运行并测试

1. 设置 ws 服务器

$ cd tentacle && RUST_LOG=info cargo run --example simple --features ws -- server

2. 设置浏览器客户端

$ cd simple_wasm/www && wasm-pack build
$ npm install && npm run start

所有 wasm 代码生成自 书

3. 使用浏览器访问 https://127.0.0.1:8080/

4. 现在你可以在服务器工作台或浏览器控制台中看到连接。

其他语言

其他语言的实现

• Go

为什么？

因为我使用 rust-libp2p 时遇到了一些难题，难以确定是问题出在我自己还是库本身，最好是自行实现。