diff --git a/README.md b/README.md index 827326d..8b5c4f8 100644 --- a/README.md +++ b/README.md @@ -1,10 +1,10 @@ -main reference: +## main reference: - https://zeronet.io - V3 mirror http://zeronet34m3r5ngdu54uj57dcafpgdjhxsgq5kla5con4qvcmfzpvhad.onion - https://github.com/HelloZeroNet/ZeroNet # V3 Hidden Service support -sadly script with small patch to integrate support for hidden (onion) service V3 on ZeroNet darknet. +sadly script with small patch to integrate support for hidden (onion) service V3 on ZeroNet darknet ( still support V2 ). this patch refers these issue: - https://github.com/HelloZeroNet/ZeroNet/issues/2351 @@ -15,10 +15,22 @@ In particular it manages the tracker function ( bootstrap plugin enable ) verify As you may know the hiddien service V2 are deprecated and in October will cease to exist permanently, is why in the transition phase (wait for V3 support to be released from the official repo) it's important to enable the boostrap plugin (and add v3 trackers in bootstrap list) to verify and share OnionV3 peers that cannot be verified by current trackers with the stable version. +### Patch explained +This patch doesn't definitively differentiate onion v2 from v3, via `CryptRsa.py` I've maintained the v2 functions unchanged and added a copy of those funcionts ( sign, verify key .. ) with library required by onion v3 (`CryptEd25519.py`), recognising the type of address version from the length of the hidden service keys used in the functions ( **definitely could be improved!** ). + +### Script explained +- move `upgrade_file/CryptEd25519.py` and `upgrade_file/CryptRsa.py` to `ZeroPath/src/Crypt/` +- replace in `ZeroPath/src/Tor/TorManager.py` the 2 words `RSA1024` with `ED25519-V3` +- add the line to the top: + `from Crypt import CryptEd25519` to : + - `ZeroPath/src/Tor/TorManager.py` + - `ZeroPath/plugins/AnnounceZero/AnnounceZeroPlugin.py` + +--- For the installation guide i will use a fresh new client, following the installation guide on the official repo : https://github.com/HelloZeroNet/ZeroNet -### Linux (x86-64bit) +#### Linux (x86-64bit) - `wget https://github.com/HelloZeroNet/ZeroNet-linux/archive/dist-linux64/ZeroNet-py3-linux64.tar.gz` - `tar xvpfz ZeroNet-py3-linux64.tar.gz` - `cd ZeroNet-linux-dist-linux64/` @@ -37,9 +49,7 @@ now the client is enabled to support V3 hidden services you can launch the client normally from ZeroNet-linux-dist-linux64 - `./ZeroNet.sh` ---- - -## Tor configuration and tracker settings +#### Tor configuration and tracker settings if you want to start immediately in tracker - tor always mode these are configurations tested on debian10, more information can be found in the official FAQ: - https://zeronet.io/docs/faq/#how-to-use-zeronet-with-the-tor-browser - https://zeronet.io/docs/faq/#how-to-use-zeronet-with-tor @@ -61,34 +71,20 @@ tor = always - enable tracker plugin, always from ZeroNet-linux-dist-linux64 `mv core/plugins/disabled-Bootstrapper core/plugins/Bootstrapper` - launch `./ZeroNet.sh` +- open http://127.0.0.1:43110/Stats to check the operation --- -## Tips -v3 tracker to add in bootstrap list: +### Tips +OnionV3 tracker to add in bootstrap list: - `zero://tnjppdoc4famqa62mldlzc3fqw2wlsfxov7iz3pz5ex6umnqpaupflqd.onion:16227` Syncronite trackers file list : - http://127.0.0.1:43110/15CEFKBRHFfAP9rmL6hhLmHoXrrgmw4B5o --- -## Todo +### Todo - understand why onion addresses aren't shared as shared trackers - permanent tracker onion address - upgrade plugins/StemPort for V3 support - default stem lib for manage hidden services - -## Patch explained -This patch doesn't definitively differentiate onion v2 from v3, via `CryptRsa.py` I've maintained the v2 functions unchanged and added a copy of those funcionts ( sign, verify key .. ) with library required by onion v3 (`Ed25519.py`), recognising the type of address version from the length of the hidden service keys used in the functions ( definitely could be improved! ). - - -## Script explained -- move `upgrade_file/CryptEd25519.py` and `upgrade_file/CryptRsa.py` to `ZeroPath/src/Crypt/` -- replace in `ZeroPath/src/Tor/TorManager.py` the 2 words `RSA1024` with `ED25519-V3` -- add the line to the top: - `from Crypt import CryptEd25519` to : - - `ZeroPath/src/Tor/TorManager.py` - - `ZeroPath/plugins/AnnounceZero/AnnounceZeroPlugin.py` - - -works