A library providing an ACN (Anonymous Communication Network) abstraction and a tor (for now) implementation.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Sarah Jamie Lewis f13387fcae Merge pull request 'torProvider: now creates new subdir for tor process per run to avoid collisions of zombies; log tor processl bump op.log version' (#14) from randDirLog into master 1 week ago
testing Moving to OpenPrivacy Bine / Adding GetPID to ACN 1 month ago
tor torProvider: now creates new subdir for tor process per run to avoid collisions of zombies; log tor processl bump op.log version 1 week ago
.drone.yml Kill Tor once the unit tests have finsihed 4 months ago
.gitignore Sketch of Tor Authenticator 4 months ago
LICENSE import libricochet-go connectivity package as stand alone repo 9 months ago
README.md Sketch of Tor Authenticator 4 months ago
acn.go Moving to OpenPrivacy Bine / Adding GetPID to ACN 1 month ago
go.mod torProvider: now creates new subdir for tor process per run to avoid collisions of zombies; log tor processl bump op.log version 1 week ago
go.sum torProvider: now creates new subdir for tor process per run to avoid collisions of zombies; log tor processl bump op.log version 1 week ago
localProvider.go Moving to OpenPrivacy Bine / Adding GetPID to ACN 1 month ago

README.md

connectivity

A library providing an ACN (Anonymous Communication Network ) networking abstraction

Supported ACNs

  • Tor v3 Onion Services

Requirements for ACN Support

  • Reference an EndPoint via a string / hostname
  • Maintain an endpoint via a PublicKey (the underlying crypto is the responsibility of the implementation)

Using

Each ACN implementation provides a specific start function that takes in the required parameters to e.g. find a specific binary on the system, attempt to talk to a specific system service or launch an in-memory networking manager:

    acn, err := NewTorACN(".", "", 9051, HashedPasswordAuthenticator{"examplehasedpassword"})
    if err != nil {
        t.Error(err)
        return
    }

At this point the ACN is responsible for setting up the networking interface, the result of which can be checked via the Status callback:

    acn.SetStatusCallback(getStatusCallback(progChan))

    progress := 0
    for progress < 100 {
        progress = <-progChan
    }

Once initialized the ACN can be used to open new connections:

    conn,err := acn.Open(hostname);

Or host a service on the ACN:

    ls,err := acn.Listen(identity, port) ;

We also provide closing and restart functionality for managing the networking service:

    acn.Restart()

and

    acn.Close()