Package org.torproject.descriptor

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

      All Methods Instance Methods Abstract Methods 
      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 Detail

      • 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