No description
src | ||
tools | ||
.gitignore | ||
LICENSE | ||
README.md | ||
zeronet.py |
ZeroNet
Decentralized websites using Bitcoin crypto and BitTorrent network
Why?
- We believe in open, free and uncensored network and communication.
- No single point of failure: Site goes on until at least 1 peer serving it.
- No hosting costs: Site served by visitors.
- Imposible to shut down: It's nowhere because it's everywhere.
- Fast and works offline: You can access the site even if your internet is gone.
How does it works?
- After starting
zeronet.py
you will be able to visit zeronet sites using http://127.0.0.1:43110/{zeronet_address} (eg. http://127.0.0.1:43110/1EU1tbG9oC1A8jz2ouVwGZyQ5asrNsE4Vr). - When you visit a new zeronet site, it's trying to find peers using BitTorrent network and download the site files (html, css, js...) from them.
- Each visited sites become also served by You.
- Every site containing a
site.json
which holds all other files sha1 hash and a sign generated using site's private key. - If the site owner (who has the private key for the site address) modifies the site, then he/she signs the new
content.json
and publish it to the peers. After the peers verified thecontent.json
integrity using the sign they download the modified files and publish the new content to other peers.
Screenshot
How to join?
Windows:
- Install Python 2.7
- Install Python ZeroMQ
- Install Python Greenlet
- Install Python Gevent
- Install Python MsgPack
- start
zeronet.py
Linux (Debian):
apt-get install python-pip
pip install pyzmq
(if drops compile error thenapt-get install python-dev
and try again)pip install gevent
pip install msgpack-python
- start using
python zeronet.py
How can I create a ZeroNet site?
$ zeronet.py siteCreate
...
- Site private key: 23DKQpzxhbVBrAtvLEc2uvk7DZweh4qL3fn3jpM3LgHDczMK2TtYUq
- Site address: 13DNDkMUExRf9Xa9ogwPKqp7zyHFEqbhC2
...
- Site created!
$ zeronet.py
...
Congratulations, you are done! Now anyone can access your site using http://localhost:43110/13DNDkMUExRf9Xa9ogwPKqp7zyHFEqbhC2
How can I modify a ZeroNet site?
- Modify files located in data/13DNDkMUExRf9Xa9ogwPKqp7zyHFEqbhC2 directory. After you done:
$ zeronet.py siteSign 13DNDkMUExRf9Xa9ogwPKqp7zyHFEqbhC2
- Signing site: 13DNDkMUExRf9Xa9ogwPKqp7zyHFEqbhC2...
Private key (input hidden):
- Enter your private key you got when created the site, then:
$ zeronet.py sitePublish 13DNDkMUExRf9Xa9ogwPKqp7zyHFEqbhC2
...
Site:13DNDk..bhC2 Publishing to 3/10 peers...
Site:13DNDk..bhC2 Successfuly published to 3 peers
- Serving files....
- That's it! You successfuly signed and published your modifications.
If you want to help keep this project alive
Bitcoin: 1QDhxQ6PraUZa21ET5fYUCPgdrwBomnFgX