Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

📡 Peer & Connection Management


Parameter NameDefault ValueIntroduced in VersionLast Updated in Version
MaxConnectionsPerIP83 (default was 30)35

Description:

Defines the maximum number of connections allowed per IP address.


Parameter NameDefault ValueIntroduced in VersionLast Updated in Version
IncomingConnectionsLimit24000 (default was -1)27

Description:

A non-negative number that specifies the maximum incoming connections for the gossip protocol configured in NetAddress. A value of 0 means no connections allowed.

Estimating 1.5 MB per incoming connection.


Parameter NameDefault ValueIntroduced in VersionLast Updated in Version
P2PHybridIncomingConnectionsLimit12003434

Description:

Used as IncomingConnectionsLimit for P2P connections in Hybrid Network. For pure P2P Network the field IncomingConnectionsLimit is used instead.


Parameter NameDefault ValueIntroduced in VersionLast Updated in Version
BroadcastConnectionsLimit-144

Description:

Defines the maximum number of peer connections that will receive broadcast (gossip) messages from this node.

Succinctly, it works in the following way:

  • If a node has more connections than the specified limit, it prioritizes broadcasting to peers in the following order:

    1. Outgoing connections: Peers a node actively connects to.
    2. Peers with higher stake: Determined by the amount of ALGO held, as indicated by their participation key.
  • Special values:

    • 0: Disables all outgoing broadcast messages, including transaction broadcasts to peers.
    • -1: No limit on the number of connections receiving broadcasts (default setting).

For further details, refer to the Algorand Network non-normative specification.


Parameter NameDefault ValueIntroduced in VersionLast Updated in Version
AnnounceParticipationKeytrue44

Description:

Indicates if this node should announce its participation key with the largest stake to its peers. In case of a DoS attack, this allows peers to prioritize connections.


Parameter NameDefault ValueIntroduced in VersionLast Updated in Version
PriorityPeersEmpty string44

Description:

Specifies peer IP addresses that should always get outgoing broadcast messages from
this node.


Parameter NameDefault ValueIntroduced in VersionLast Updated in Version
ConnectionsRateLimitingCount6044

Description:

Used with ConnectionsRateLimitingWindowSeconds to determine whether a connection request should be accepted. The gossip network examines all the incoming requests in the past ConnectionsRateLimitingWindowSeconds seconds that share the same origin. If the total count exceeds this value, the connection is refused.


Parameter NameDefault ValueIntroduced in VersionLast Updated in Version
ConnectionsRateLimitingWindowSeconds144

Description:

Used with ConnectionsRateLimitingCount to determine whether a connection request should be accepted. Providing a zero value in this variable disables the connection rate limiting.


Parameter NameDefault ValueIntroduced in VersionLast Updated in Version
DisableOutgoingConnectionThrottlingfalse55

Description:

Disables connection throttling of the network library, which allows the network library to continuously disconnect Relay Nodes based on their relative (and absolute) performance.


Parameter NameDefault ValueIntroduced in VersionLast Updated in Version
DisableLocalhostConnectionRateLimittrue1616

Description:

Controls whether the incoming connection rate limit applies to connections originating from the local machine. Setting this to true allows this node to create a large local-machine network that won’t trip the incoming connection limit observed by Relay Nodes.