From 2298877f78027b606fe05bb4745d123b67c1a841 Mon Sep 17 00:00:00 2001 From: "Wladimir J. van der Laan" Date: Wed, 11 Nov 2015 15:08:38 +0100 Subject: [PATCH] doc: update docs for Tor listening - add new data directory files for 0.12 to doc/files.md - mention torcontrol in doc/tor.md --- doc/files.md | 2 ++ doc/tor.md | 20 +++++++++++++++++++- 2 files changed, 21 insertions(+), 1 deletion(-) diff --git a/doc/files.md b/doc/files.md index 260d36ef3..2d3787912 100644 --- a/doc/files.md +++ b/doc/files.md @@ -10,3 +10,5 @@ * fee_estimates.dat: stores statistics used to estimate minimum transaction fees and priorities required for confirmation * peers.dat: peer IP address database (custom format) * wallet.dat: personal wallet (BDB) with keys and transactions +* .cookie: session RPC authentication cookie (written at start when cookie authentication is used, deleted on shutdown): since 0.12.0 +* onion_private_key: cached Tor hidden service private key for `-listenonion`: since 0.12.0 diff --git a/doc/tor.md b/doc/tor.md index 61549b631..384bae387 100644 --- a/doc/tor.md +++ b/doc/tor.md @@ -86,7 +86,25 @@ for normal IPv4/IPv6 communication, use: ./zcashd -onion=127.0.0.1:9050 -externalip=zctestseie6wxgio.onion -discover -3. Connect to a Zcash hidden server +3. Automatically listen on Tor +-------------------------------- + +Starting with Tor version 0.2.7.1 it is possible, through Tor's control socket +API, to create and destroy 'ephemeral' hidden services programmatically. +Zcash has been updated to make use of this. + +This means that if Tor is running (and proper authorization is available), +Zcash automatically creates a hidden service to listen on, without +manual configuration. This will positively affect the number of available +.onion nodes. + +This new feature is enabled by default if Zcash is listening, and +a connection to Tor can be made. It can be configured with the `-listenonion`, +`-torcontrol` and `-torpassword` settings. To show verbose debugging +information, pass `-debug=tor`. + + +4. Connect to a Zcash hidden server ----------------------------------- To test your set-up, you might want to try connecting via Tor on a different computer to just a