Skip to content

Commit 4bff49b

Browse files
committed
Merge bitcoin/bitcoin#22172: doc: update tor.md, release notes with removal of tor v2 support
2ad034a doc: update release notes with removal of tor v2 support (Jon Atack) 49938ee doc: update tor.md with removal of tor v2 support (Jon Atack) Pull request description: Follow-up documentation to #22050 that removed support for Tor version 2 hidden services from Bitcoin Core. ACKs for top commit: laanwj: ACK 2ad034a Tree-SHA512: 0f13f9d1db7e11f1e3d9967b6d17b8dc3144b3ab3a258c706464c5e6ac5cbcf2ce2db4ea54be9939f05a82ebd1e7f325f50b435f9822c08b4f21ed4ac58de0af
2 parents 96f828b + 2ad034a commit 4bff49b

File tree

2 files changed

+18
-3
lines changed

2 files changed

+18
-3
lines changed

doc/release-notes.md

+9-2
Original file line numberDiff line numberDiff line change
@@ -59,6 +59,13 @@ Notable changes
5959
P2P and network changes
6060
-----------------------
6161

62+
- This release removes support for Tor version 2 hidden services in favor of Tor
63+
v3 only, as the Tor network [dropped support for Tor
64+
v2](https://blog.torproject.org/v2-deprecation-timeline) with the release of
65+
Tor version 0.4.6. Henceforth, Bitcoin Core ignores Tor v2 addresses; it
66+
neither rumors them over the network to other peers, nor stores them in memory
67+
or to `peers.dat`. (#22050)
68+
6269
- Added NAT-PMP port mapping support via
6370
[`libnatpmp`](https://miniupnp.tuxfamily.org/libnatpmp.html). (#18077)
6471

@@ -142,8 +149,8 @@ Tools and Utilities
142149
- A new CLI `-addrinfo` command returns the number of addresses known to the
143150
node per network type (including Tor v2 versus v3) and total. This can be
144151
useful to see if the node knows enough addresses in a network to use options
145-
like `-onlynet=<network>` or to upgrade to current and future Tor releases
146-
that support Tor v3 addresses only. (#21595)
152+
like `-onlynet=<network>` or to upgrade to this release of Bitcoin Core 22.0
153+
that supports Tor v3 only. (#21595)
147154

148155
Wallet
149156
------

doc/tor.md

+9-1
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,14 @@ It is possible to run Bitcoin Core as a Tor onion service, and connect to such s
55
The following directions assume you have a Tor proxy running on port 9050. Many distributions default to having a SOCKS proxy listening on port 9050, but others may not. In particular, the Tor Browser Bundle defaults to listening on port 9150. See [Tor Project FAQ:TBBSocksPort](https://www.torproject.org/docs/faq.html.en#TBBSocksPort) for how to properly
66
configure Tor.
77

8+
## Compatibility
9+
10+
- Starting with version 22.0, Bitcoin Core only supports Tor version 3 hidden
11+
services (Tor v3). Tor v2 addresses are ignored by Bitcoin Core and neither
12+
relayed nor stored.
13+
14+
- Tor removed v2 support beginning with version 0.4.6.
15+
816
## How to see information about your Tor configuration via Bitcoin Core
917

1018
There are several ways to see your local onion address in Bitcoin Core:
@@ -18,7 +26,7 @@ information in the debug log about your Tor configuration.
1826
CLI `-addrinfo` returns the number of addresses known to your node per network
1927
type, including Tor v2 and v3. This is useful to see how many onion addresses
2028
are known to your node for `-onlynet=onion` and how many Tor v3 addresses it
21-
knows when upgrading to current and future Tor releases that support Tor v3 only.
29+
knows when upgrading to Bitcoin Core v22.0 and up that supports Tor v3 only.
2230

2331
## 1. Run Bitcoin Core behind a Tor proxy
2432

0 commit comments

Comments
 (0)