Tor.DataFormat.Consensus

Routines for parsing a consensus document.

Documentation

data Consensus

A current consensus from a directory server.

Constructors

Consensus

Fields

conMethods :: Maybe [Int]

conMethod :: Int

conValidAfter :: DateTime

conFreshUntil :: DateTime

conValidUntil :: DateTime

conVotingDelay :: (Integer, Integer)

conSuggestedClientVers :: Maybe [Version]

conSuggestedServerVers :: Maybe [Version]

conKnownFlags :: [String]

conParameters :: [(String, Int32)]

conAuthorities :: [Authority]

conRouters :: [Router]

conBandwidthWeights :: Map String Int32

conSignatures :: [(Bool, ByteString, ByteString, ByteString)]

Instances

Show Consensus

Fetchable (Consensus, ByteString, ByteString)

data Authority

An authority that might sign a consensus document.

Constructors

Authority

Fields

authName :: String

authIdent :: ByteString

authAddress :: String

authIP :: String

authDirPort :: Word16

authOnionPort :: Word16

authContact :: String

authVoteDigest :: ByteString

Instances

Show Authority

data Router

A router within the consensus document.

Constructors

Router

Fields

rtrNickName :: String

rtrIdentity :: ByteString

rtrDigest :: ByteString

rtrPubTime :: DateTime

rtrIP :: String

rtrOnionPort :: Word16

rtrDirPort :: Maybe Word16

rtrIP6Addrs :: [(String, Word16)]

rtrStatus :: [String]

rtrVersion :: Maybe Version

rtrBandwidth :: Maybe (Integer, [(String, String)])

rtrPortList :: Maybe (Bool, [PortSpec])

Instances

Show Router

parseConsensusDocument :: ByteString -> Either String (Consensus, ByteString, ByteString)

Parse a consensus document, returning either an error or the parsed consensus and the SHA1 and SHA256 hashes of that consensus, for later validation.