Interface DirSourceEntry

All Superinterfaces:
java.io.Serializable

public interface DirSourceEntry
extends java.io.Serializable
Contains details about an authority and its vote that contributed to a consensus.

A directory source entry is not a descriptor type of its own but is part of a network status consensus (RelayNetworkStatusConsensus).

Since:
1.0.0
  • Method Summary

    Modifier and Type Method Description
    java.lang.String getContactLine()
    Return the contact information for this authority, which may contain non-ASCII characters.
    int getDirPort()
    Return the TCP port where this authority accepts directory-related HTTP connections.
    byte[] getDirSourceEntryBytes()
    Return the raw directory source entry bytes.
    java.lang.String getHostname()
    Return the authority's hostname.
    java.lang.String getIdentity()
    Return a SHA-1 digest of the authority's long-term authority identity key used for the version 3 directory protocol, encoded as 40 upper-case hexadecimal characters.
    java.lang.String getIp()
    Return the authority's primary IPv4 address in dotted-quad format.
    java.lang.String getNickname()
    Return the authority's nickname consisting of 1 to 19 alphanumeric characters.
    int getOrPort()
    Return the TCP port where this authority accepts TLS connections for the main OR protocol.
    java.lang.String getVoteDigestSha1Hex()
    Return the SHA-1 vote digest, encoded as 40 lower-case hexadecimal characters.
    boolean isLegacy()
    Return whether this directory source entry was created using a legacy key.
  • Method Details

    • getDirSourceEntryBytes

      byte[] getDirSourceEntryBytes()
      Return the raw directory source entry bytes.
      Since:
      1.0.0
    • getNickname

      java.lang.String getNickname()
      Return the authority's nickname consisting of 1 to 19 alphanumeric characters.
      Since:
      1.0.0
    • getIdentity

      java.lang.String getIdentity()
      Return a SHA-1 digest of the authority's long-term authority identity key used for the version 3 directory protocol, encoded as 40 upper-case hexadecimal characters.
      Since:
      1.0.0
    • getHostname

      java.lang.String getHostname()
      Return the authority's hostname.
      Since:
      1.2.0
    • getIp

      java.lang.String getIp()
      Return the authority's primary IPv4 address in dotted-quad format.
      Since:
      1.0.0
    • getDirPort

      int getDirPort()
      Return the TCP port where this authority accepts directory-related HTTP connections.
      Since:
      1.0.0
    • getOrPort

      int getOrPort()
      Return the TCP port where this authority accepts TLS connections for the main OR protocol.
      Since:
      1.0.0
    • isLegacy

      boolean isLegacy()
      Return whether this directory source entry was created using a legacy key.
      Since:
      1.0.0
    • getContactLine

      java.lang.String getContactLine()
      Return the contact information for this authority, which may contain non-ASCII characters.
      Since:
      1.0.0
    • getVoteDigestSha1Hex

      java.lang.String getVoteDigestSha1Hex()
      Return the SHA-1 vote digest, encoded as 40 lower-case hexadecimal characters.
      Since:
      1.7.0