You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

49 lines
2.0 KiB

  1. # P2P Config
  2. Here we describe configuration options around the Peer Exchange.
  3. These can be set using flags or via the `$TMHOME/config/config.toml` file.
  4. ## Seed Mode
  5. `--p2p.seed_mode`
  6. The node operates in seed mode. In seed mode, a node continuously crawls the network for peers,
  7. and upon incoming connection shares some peers and disconnects.
  8. ## Seeds
  9. `--p2p.seeds “id100000000000000000000000000000000@1.2.3.4:26656,id200000000000000000000000000000000@2.3.4.5:4444”`
  10. Dials these seeds when we need more peers. They should return a list of peers and then disconnect.
  11. If we already have enough peers in the address book, we may never need to dial them.
  12. ## Persistent Peers
  13. `--p2p.persistent_peers “id100000000000000000000000000000000@1.2.3.4:26656,id200000000000000000000000000000000@2.3.4.5:26656”`
  14. Dial these peers and auto-redial them if the connection fails.
  15. These are intended to be trusted persistent peers that can help
  16. anchor us in the p2p network. The auto-redial uses exponential
  17. backoff and will give up after a day of trying to connect.
  18. But If `persistent_peers_max_dial_period` is set greater than zero,
  19. pause between each dial to each persistent peer will not exceed `persistent_peers_max_dial_period`
  20. during exponential backoff and we keep trying again without giving up
  21. **Note:** If `seeds` and `persistent_peers` intersect,
  22. the user will be warned that seeds may auto-close connections
  23. and that the node may not be able to keep the connection persistent.
  24. ## Private Peers
  25. `--p2p.private_peer_ids “id100000000000000000000000000000000,id200000000000000000000000000000000”`
  26. These are IDs of the peers that we do not add to the address book or gossip to
  27. other peers. They stay private to us.
  28. ## Unconditional Peers
  29. `--p2p.unconditional_peer_ids “id100000000000000000000000000000000,id200000000000000000000000000000000”`
  30. These are IDs of the peers which are allowed to be connected by both inbound or outbound regardless of
  31. `max_num_inbound_peers` or `max_num_outbound_peers` of user's node reached or not.