ZeroNetX

Rust Implementation of ZeroNet Protocol

Currently This Repo is open to Code Reviews/Security Audit/Best Code Practice Suggestions. You can freely review and suggest your opinions to us.

Features:

• Site Create => Create New Site
• Site Download => Download Site from internet peers
• Site Need File => Download Site Single(Inner) File from peers
• Find Peers via Trackers => Discover Peers using torrent tracker network
• Site Sign => sign changes in site files
• Site Verify => verify content file hashes with files
• PeerExchange => Get more peers from connected peers
• PeerPing => Get peer alive status
• dbRebuild => Build db from data files using dbschema.json
• dbQuery => Sql Query on built db to fetch data
• getConfig => Client Config data

Available Commands:

• siteCreate
• siteDownload
• siteNeedFile
• siteFindPeers
• sitePeerExchange
• siteFetchChanges
• siteSign
• siteVerify
• peerPing
• dbRebuild
• dbQuery
• getConfig

pass -s "Your Site Address" for above commands

Download :

Latest Packages Available on Github Releases.

Usage :

Window :

zeronet.exe siteDownload -s "1HELLoE3sFD9569CLCbHEAVqvqV7U2Ri9d"

Linux/Mac :

./zeronet siteDownload -s "1HELLoE3sFD9569CLCbHEAVqvqV7U2Ri9d"

You may need to give exec permission on Linux/Mac OS

chmod +x zeronet

and rerun the cmd

Building ZeroNetX

Repository

Clone the ZNX repository.

Dependencies

• Install rustup

• cd zeronet-rs

• Windows : Install nightly rust toolchain using

  rustup override set nightly-2025-04-26-x86_64-pc-windows-msvc

• rustc --version info for other platforms

  rustc 1.88.0-nightly (b4c8b0c3f 2025-04-25)

Once you have the dependencies installed, you can build ZNX using Cargo.

For a debug build:

cargo run

For a release build:

cargo run --release

And to run the tests:

cargo test

Troubleshooting

Cargo errors claiming that a dependency is using unstable features

Try cargo clean and cargo build.

License