Skip to content

aarani/NOnion

Folders and files

NameName
Last commit message
Last commit date

Latest commit

8575312 · Mar 31, 2024
Mar 31, 2024
Sep 26, 2022
Mar 31, 2024
Mar 31, 2024
Apr 20, 2022
Nov 11, 2022
Jun 25, 2021
Oct 13, 2021
Oct 13, 2021
Oct 30, 2022
Apr 11, 2023
Oct 13, 2021
Mar 31, 2024
Nov 24, 2022

Repository files navigation

NOnion

Build Status

Unofficial work in progress .NET TOR client library (implemented in F#)

How do I add this to my project?

Install via NuGet:

.NET CLI

> dotnet add package NOnion

VS Package Manager

> Install-Package NOnion

Getting Started (F#)

Bootstrapping

To utilize the Tor network, start by bootstrapping your directory. This step involves downloading the most recent information about available routers and their identity keys.

To initiate the bootstrapping process, you require a list of initial nodes for communication. In NOnion, there are two methods to obtain this list: 1- Download from GitLab 2- Utilize the embedded list in the NOnion binary (Note: this list could potentially be outdated)

Based on what option you choose use one of the following commands to bootstrap a TorClient object:

let! torClient = TorClient.AsyncBootstrapWithEmbeddedList None

OR

let! torClient = TorClient.AsyncBootstrapWithGitlab None

Browsing the web

To route your traffic through Tor, you require a circuit, which consists of multiple hops or routers. NOnion simplifies this process for you. Just specify the desired length of your circuit and use the following command:

let hopCount = 3 // any length you want
let! circuit = torClient.AsyncCreateCircuit hopCount Exit None

Once the circuit is established, generate a stream to channel your traffic and establish a connection with your intended destination.

let address = "google.com" // Hostname you want to connect to
let port = 80 // Port you want to connect it

do!
	stream.ConnectToOutside address port
	|> Async.Ignore

Now, utilize the stream just like any other System.IO.Stream:

do! stream.AsyncWrite [|1uy; 2uy; 3uy; 4uy|]

Connecting to hidden services

To connect to a hidden service using the Tor network, use the folowing command:

let onionAddress = "facebookwkhpilnemxj7asaniu7vnjjbiltxjqhye3mhbshg7kx5tfyd.onion"

let! serviceClient = TorServiceClient.Connect torClient onionAddress
let! stream = serviceClient.GetStream()

Now, utilize the stream just like any other System.IO.Stream:

do!
    sprintf "GET / HTTP/1.0\r\n\r\n"
    |> System.Text.Encoding.ASCII.GetBytes
    |> stream.AsyncWrite

Hosting a hidden service

Start a hidden service, use the following command:

let serviceHost = new TorServiceHost(torClient, None)
do! serviceHost.Start()

Note: use TorServiceHost's maybeMasterPrivateKey parameter to supply your existing bouncy castle private key

Now use the following command to wait for incoming streams/clients:

let! incomingStream = serviceHost.AcceptClient()

Now, utilize the stream just like any other System.IO.Stream.

Everything mentioned above can be accomplished in C#. Our test project is also written in C#, so feel free to examine it.

Contributing

Don't underestimate the power of your contribution - even a small pull request can make a big difference in a small project, so submit yours today!

About

[WIP] [INSECURE] TOR implementation for .NET

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published