discv5

在docs.rs上的文档

概述

这是Discovery v5对等发现协议的Rust实现。

Discovery v5是为加密对等发现而设计的协议。网络中的每个对等体/节点通过其ENR（Ethereum Node Record）进行标识，它本质上是一个包含节点公钥以及可选的IP地址和端口的签名键值存储。

Discv5使用类似于kademlia的路由表来存储和管理发现的对等体和主题。该协议允许通过与发现的节点进行常规的PING/PONG来在NAT环境中进行外部IP发现。节点返回它们收到的外部IP地址，并选择一个简单的多数派作为我们的外部IP地址。如果外部IP地址更新，这将产生一个事件来通知蜂群（如果用于这种行为）。

关于简单的CLI发现服务，请参阅 discv5-cli

用法

创建此服务的简单示例如下

   use discv5::{enr, enr::{CombinedKey, NodeId}, TokioExecutor, Discv5, ConfigBuilder};
   use discv5::socket::ListenConfig;
   use std::net::SocketAddr;

   // construct a local ENR
   let enr_key = CombinedKey::generate_secp256k1();
   let enr = enr::Enr::empty(&enr_key).unwrap();

   // build the tokio executor
   let mut runtime = tokio::runtime::Builder::new_multi_thread()
       .thread_name("Discv5-example")
       .enable_all()
       .build()
       .unwrap();

   // configuration for the sockets to listen on
   let listen_config = ListenConfig::Ipv4 {
       ip: Ipv4Addr::UNSPECIFIED,
       port: 9000,
   };

   // default configuration
   let config = ConfigBuilder::new(listen_config).build();

   // construct the discv5 server
   let mut discv5: Discv5 = Discv5::new(enr, enr_key, config).unwrap();

   // In order to bootstrap the routing table an external ENR should be added
   // This can be done via add_enr. I.e.:
   // discv5.add_enr(<ENR>)

   // start the discv5 server
   runtime.block_on(discv5.start());

   // run a find_node query
   runtime.block_on(async {
      let found_nodes = discv5.find_node(NodeId::random()).await.unwrap();
      println!("Found nodes: {:?}", found_nodes);
   });

ENR中的地址

此协议将丢弃来自在ENR中宣传不可接触地址的对等体（例如，连接到非本地节点时127.0.0.1）的消息（即不响应请求）。本节解释了这一设计决策背后的原因。