libp2p的替代工作库

此存储库是libp2p规范在Rust中的替代实现。与rust-libp2p不同，libp2p-rs使用async/await语法编写，并由异步运行时驱动。尽管如此，许多代码是从rust-libp2p借用的，一些是从go-libp2p借用的。我们正在尝试保持与这两种实现兼容，但遗憾的是无法保证。

文档

如何使用此库？

如上所述，API与rust-libp2p完全不同。在libp2p-rs中根本不存在“NetworkBehaviour”这一概念。相反，您应该使用您喜欢的传输构建Swarm，然后从其中创建Swarm::Control。Swarm::Control暴露了所有Swarm API，可用于操作Swarm - 打开/读取/写入/关闭流等。这与go-libp2p中的BasicHost非常相似。至于Kad-DHT，出于同样的原因，您应该获取Kad::Control。此外，您可以将Swarm与Kad结合，之后您将拥有具有路由功能的RoutedHost。

强烈建议仔细查看文档和示例代码

• API文档可以在： https://docs.rs/libp2p-rs
• 设计文档可以在docs中找到

代码示例

• 有关如何编写代码的详细信息可以在examples中找到
  • swarm_simple 示例演示了如何构建传输和创建子流进行通信
  • kad_simple 示例演示了如何运行 Kad-DHT 服务器。在此示例中，集成了交互式壳体，用于调试/观察 Kad-DHT 内部数据结构
  • ...

版本发布

注意：主分支现在是一个活跃的开发分支（从 v0.1.0 开始），这意味着任何时间都可能进行破坏性更改。