|
|
@ -98,17 +98,28 @@ 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. Zcash will also use Tor automatically to connect |
|
|
|
to other .onion nodes if the control socket can be successfully opened. This |
|
|
|
will positively affect the number of available .onion nodes and their usage. |
|
|
|
This means that if Tor is running (and proper authentication has been configured), |
|
|
|
Zcash automatically creates a hidden service to listen on. Zcash will also use Tor |
|
|
|
automatically to connect to other .onion nodes if the control socket can be |
|
|
|
successfully opened. This will positively affect the number of available .onion |
|
|
|
nodes and their usage. |
|
|
|
|
|
|
|
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`. |
|
|
|
|
|
|
|
Connecting to Tor's control socket API requires one of two authentication methods to be |
|
|
|
configured. For cookie authentication the user running zcashd must have write access |
|
|
|
to the `CookieAuthFile` specified in Tor configuration. In some cases this is |
|
|
|
preconfigured and the creation of a hidden service is automatic. If permission problems |
|
|
|
are seen with `-debug=tor` they can be resolved by adding both the user running tor and |
|
|
|
the user running zcashd to the same group and setting permissions appropriately. On |
|
|
|
Debian-based systems the user running zcashd can be added to the debian-tor group, |
|
|
|
which has the appropriate permissions. An alternative authentication method is the use |
|
|
|
of the `-torpassword` flag and a `hash-password` which can be enabled and specified in |
|
|
|
Tor configuration. |
|
|
|
|
|
|
|
|
|
|
|
4. Connect to a Zcash hidden server |
|
|
|
----------------------------------- |
|
|
|