github.com/ari-anchor/sei-tendermint@v0.0.0-20230519144642-dc826b7b56bb/internal/p2p/pex/doc.go (about)

     1  /*
     2  Package PEX (Peer exchange) handles all the logic necessary for nodes to share
     3  information about their peers to other nodes. Specifically, this is the exchange
     4  of addresses that a peer can use to discover more peers within the network.
     5  
     6  The PEX reactor is a continuous service which periodically requests addresses
     7  and serves addresses to other peers. There are two versions of this service
     8  aligning with the two p2p frameworks that Tendermint currently supports.
     9  
    10  The reactor is embedded with the new p2p stack and uses the peer manager to advertise
    11  peers as well as add new peers to the peer store. The V2 reactor passes a
    12  different set of proto messages which include a list of
    13  [urls](https://golang.org/pkg/net/url/#URL).These can be used to save a set of
    14  endpoints that each peer uses. The V2 reactor has backwards compatibility with
    15  V1. It can also handle V1 messages.
    16  
    17  The reactor is able to tweak the intensity of it's search by decreasing or
    18  increasing the interval between each request. It tracks connected peers via a
    19  linked list, sending a request to the node at the front of the list and adding
    20  it to the back of the list once a response is received. Using this method, a
    21  node is able to spread out the load of requesting peers across all the peers it
    22  is currently connected with.
    23  
    24  With each inbound set of addresses, the reactor monitors the amount of new
    25  addresses to already seen addresses and uses the information to dynamically
    26  build a picture of the size of the network in order to ascertain how often the
    27  node needs to search for new peers.
    28  */
    29  package pex