Tor.State.Directories

Routines for tracking Tor directory servicers.

Documentation

data Directory

The information about a directory within the Tor network.

Constructors

Directory

Fields

dirNickname :: String

dirIsBridge :: Bool

dirAddress :: String

dirOnionPort :: Word16

dirDirPort :: Word16

dirV3Ident :: Maybe ByteString

dirFingerprint :: ByteString

dirPublished :: DateTime

dirExpires :: DateTime

dirIdentityKey :: PublicKey

dirSigningKey :: PublicKey

Instances

Show Directory

data DirectoryDB

The current directory database available to the node.

newDirectoryDatabase :: TorNetworkStack ls s -> (String -> IO ()) -> IO DirectoryDB

Generate a directory of available databases from which we can pull router lists and publish our own router information, as necessary.

sendRouterDescription :: TorNetworkStack ls s -> (String -> IO ()) -> DirectoryDB -> RouterDesc -> PrivateKey -> IO ()

Send our router description to all of the directories we know about.

getRandomDirectory :: DRG g => g -> DirectoryDB -> IO (Directory, g)

Select a random directory.

findDirectory :: ByteString -> DirectoryDB -> IO (Maybe Directory)

Find a directory that matches the given fingerprint.

addDirectory :: TorNetworkStack ls s -> (String -> IO ()) -> DirectoryDB -> Authority -> IO ()

Add a new directory to our set of known directories.