Addr v2

addr v2 is a proposed new version of the addr message in the Bitcoin P2P network protocol, which is used to advertise the addresses of nodes that accept incoming connections.

The original addr message allows relaying 128-bit IPv6 addresses with backwards compatibility for IPv4 and onioncat-encoded version 2 (v2) Tor hidden service (.onion) addresses. However, v3 Tor hidden service addresses are 256 bits in size, as are addresses for several other privacy-enhancing network protocols. Since those newer address types can’t be used with the existing addr message, a new version of the message has been proposed. Additionally, the update may allow tweaking other aspects of the message or the behavior of nodes and clients that process it.

Primary code and documentation

• BIP155

Optech newsletter and website mentions

2022

• BTCD v0.23.2 adds support for addr v2

2021

• BIPs #1134 clarifies BIP155 usage of `sendaddr2’ P2P feature negotiation message
• Bitcoin Core #20685 Adds I2P support, including addrv2 gossiping
• Rust Bitcoin 0.26.0 released with version 2 addr support
• Bitcoin Core 0.21.0 released with version 2 addr support

2020

• 2020 year in review: version 2 addr message
• Bitcoin Core #20564 only sends addrv2 to protocol version 70016 peers
• BIP155 updated to require sendaddrv2 message be sent before verack
• Bitcoin Core #19954 implements BIP155 and Tor v3 support
• BIPs #907 updates BIP155 messages to allow addresses up to 512 bytes
• Summary of Bitcoin Core PR Review Club discussion about an addr v2 PR

2019

• Proposed per-node signaling for address relay with v2 addr messages
• Version 2 addr message assigned BIP155
• Version 2 addr message proposed

See also

• P2P protocol addr message

• Anonymity networks

  
  

Previous Topic:
Adaptor signatures

Next Topic:
Anchor outputs

Edit page
Report Issue