Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/berty/go-libp2p-tor-transport
🚧 WIP: tor transport for libp2p
https://github.com/berty/go-libp2p-tor-transport
berty ipfs libp2p onion privacy tor
Last synced: 4 months ago
JSON representation
🚧 WIP: tor transport for libp2p
- Host: GitHub
- URL: https://github.com/berty/go-libp2p-tor-transport
- Owner: berty
- License: apache-2.0
- Created: 2020-08-26T20:51:44.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2022-11-14T13:01:19.000Z (about 2 years ago)
- Last Synced: 2024-09-27T17:01:13.594Z (4 months ago)
- Topics: berty, ipfs, libp2p, onion, privacy, tor
- Language: Go
- Homepage:
- Size: 163 KB
- Stars: 53
- Watchers: 14
- Forks: 7
- Open Issues: 15
-
Metadata Files:
- Readme: README.md
- License: LICENSE-APACHE
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
# go-libp2p-tor-transport
Go tor transport is a [go-libp2p](https://github.com/libp2p/go-libp2p) transport targeting mainly \*nix platform.
## WIP
This transport is in very early stages (PoC) many of features enumerated here are just targets.
You can follow the process of the **1.0** [here](https://github.com/berty/go-libp2p-tor-transport/projects/1).
## Usage :
```go
import (
"context"
tor "berty.tech/go-libp2p-tor-transport"
config "berty.tech/go-libp2p-tor-transport/config"
libp2p "github.com/libp2p/go-libp2p"
)
func main() {
builder, err := tor.NewBuilder( // Create a builder
config.EnableEmbeded, // Use the embeded tor instance.
)
c(err)
host, err := libp2p.New( // Create a libp2p node
context.Background(),
libp2p.Transport(builder), // Use the builder to create a transport instance (you can't reuse the same builder after that).
)
c(err)
}
func c(err error) { // Used to check error in this example, replace by whatever you want.
if err != nil {
panic(err)
}
}
```
### With config :
```go
import (
"context"
"time"
tor "berty.tech/go-libp2p-tor-transport"
config "berty.tech/go-libp2p-tor-transport/config"
libp2p "github.com/libp2p/go-libp2p"
)
func main() {
builder, err := tor.NewBuilder( // NewBuilder can accept some `config.Configurator`
config.AllowTcpDial, // Some Configurator are already ready to use.
config.SetSetupTimeout(time.Minute), // Some require a parameter, in this case it's a function that will return a Configurator.
config.SetBinaryPath("/usr/bin/tor"),
)
// Evrything else is as previously shown.
c(err)
hostWithConfig, err := libp2p.New(
context.Background(),
libp2p.Transport(builder),
)
c(err)
}
func c(err error) {
if err != nil {
panic(err)
}
}
```
## Support
This transport target \*nix (Linux, OSX, IOS, Android, ...), it also can be built for windows but many of the attack reduction mesures will not be present (on windows potentialy un encrypted traffic will transit through the loopback, also some tor control port are gonna be exposed.).
## Tor Provider Compatibility
You can use 3 different provider :
- Embeded, this transport naturaly include a tor build, nothing to do.
- External node, the transport will connect to an already running tor node (usefull for server, can increase annonymity by running a relay at the same time blocking SCA attacks).
- File Path, you can give a path to a tor node executable, the transport will start the node and setup it.
## Running Mode
- Compatibility, this will create tunnels only 1 or 0 long, this disable privacy protection but allows to connect or be contacted by annonym nodes at a much lower cost (you can also use that to go around your nat) **default**.
- Annonymity, this will works like you expect 3 hop tunnels, in combination with a correct configuration of your libp2p node you will be able to also dial non annonym nodes through an exit relay.