New @type for hidden service descriptors

Hi Karsten, as per #15004 (closed) I'm adding the ability to parse hidden service descriptors to Stem. I know this isn't of interest to Metrics right now but I'd like for us to add a new @type annotation for these documents.

This is a bit similar to #8365 (moved) for which you made commit bba6809. I'm thinking "@type hidden-service-descriptor 1.0" - thoughts?

added component::metrics/website priority::very low resolution::fixed status::closed type::enhancement labels

Sure, I can imagine adding that @type on CollecTor's formats page. Mind writing a short paragraph with a short description what these descriptors are, which entities publish them, that they're not collected by CollecTor but that they can be obtained from a local tor process, that they can be processed using libraries that also support processing the other descriptors listed on the formats page, and whatever else you think should be written there? Thanks!

Can do... ish. Here's the description I used in Stem's pydocs...

Parsing for Tor hidden service descriptors as described in Tor's `rend-spec
<https://gitweb.torproject.org/torspec.git/tree/rend-spec.txt>`_.

Unlike other descriptor types these describe a hidden service rather than a
relay. They're created by the service, and can only be fetched via relays with
the HSDir flag.

# TODO: Add a description for how to retrieve them when tor supports that (#14847).

Trouble is that TODO. Tor hasn't yet merged a controller method for getting these. :)

Can you ping me once #14847 (moved) is implemented?

Trac:
Status: new to needs_information

Will do.

How about we add the following text to https://collector.torproject.org/formats.html after Tor bridge descriptors?

Tor hidden service descriptors

Tor hidden services make it possible for users to hide their locations while offering various kinds of services, such as web publishing or an instant messaging server. A hidden service assembles a hidden service descriptor to make its service available in the network. This descriptor gets stored on hidden service directories and can be retrieved by hidden service clients. Hidden service descriptors are not formally archived, but some libraries support parsing these descriptors when obtaining them from a locally running Tor instance.

Hidden service descriptors @type hidden-service-descriptor 1.0

Hidden service descriptors contain all details that are necessary for clients to connect to a hidden service. Despite the version number being 1.0, these descriptors are part of the version 2 hidden service protocol.

Trac:
Sponsor: N/A to N/A

Looks great to me!

Great, merged. Closing.

Trac:
Resolution: N/A to fixed
Status: needs_information to closed

closed