【生态】点对点网络：Splash！介绍

Splash! 

Splash! 是一个去中心化网络，用于在 Chia 生态系统中共享 Offer 文件，基于Rusts libp2p 和 DHT 对等节点发现。

每个连接的对等节点都会收到其他对等节点广播的所有 Offer。没有中心化的连接，对等节点相互连接并相互了解。

专用的 Splash！命令行工具可以充当应用程序与 Splash! 网络之间的代理。它将向网络广播您的 Offer，并通过本地 HTTP API 将其他对等节点的 Offer 转发到您的本地应用程序。

安装

您可以在发布部分下载预制的二进制文件（https://github.com/dexie-space/splash/releases）。

构建

您还可以从源代码构建和安装（需要最新的稳定 [Rust] 编译器。）

cargo install --git https://github.com/dexie-space/splash.git splash

用法

Usage: splash [OPTIONS]

Options:
  -k, --known-peer <MULTIADDR>
          Set initial peer, if missing use dexies DNS introducer
  -l, --listen-address <MULTIADDR>
          Set listen address, defaults to all interfaces, use multiple times for multiple addresses
  -i, --identity-file <IDENTITY_FILE>
          Store and reuse peer identity (only useful for known peers)
      --offer-hook <OFFER_HOOK>
          HTTP endpoint where incoming offers are posted to, sends JSON body {"offer":"offer1..."} (defaults to STDOUT)
      --listen-offer-submission <HOST:PORT>
          Start a HTTP API for offer submission, expects JSON body {"offer":"offer1..."}
  -h, --help
          Print help

例子

启动节点并监听所有接口（将使用 dexies DNS 引入器）：

./splash

启动一个节点并打开本地网络服务器以在端口 4000 上提交 Offer：

./splash --listen-offer-submission 127.0.0.1:4000

启动一个节点并将传入的 Offer 发布到 HTTP 挂钩：

./splash --offer-hook http://yourApi/v1/offers

启动一个节点并从已知对等节点引导（不会使用 dexies DNS 引入器）：

./splash --known-peer /ip6/::1/tcp/12345/p2p/12D3K...

启动一个节点并监听特定的接口/端口：

./splash --listen-address /ip6/::1/tcp/12345

启动节点并重用身份：

./splash --identity-file identity.json

使用 Docker 测试 API

docker run -p 11511:11511 -p 4000:4000 dexiespace/splash:latest \
--listen-offer-submission 0.0.0.0:4000 \
--listen-address /ip4/0.0.0.0/tcp/11511
# send the request
curl -X POST -H "Content-Type: application/json" -d '{"offer":"offer1..."}' http://localhost:4000

成为稳定的节点

要成为稳定的对等节点，您需要在防火墙中打开入站端口。然后开始 Splash！使用 --listen-address 选项并选择您的公共接口和所选端口（例如 11511 ）。

./splash --listen-address /ip6/2001:db8::1/tcp/11511 --listen-address /ip4/1.2.3.4/tcp/11511

运行稳定的对等节点？让我们知道！我们会将您添加到默认引导列表中。