[Author Prev][Author Next][Thread Prev][Thread Next][Author Index][Thread Index]

[tor-dev] Torspec proposal for adding new X- fields to relay descriptor

URL:Âhttps://dl.dropboxusercontent.com/u/3308162/ExtraRelayDescriptorFields.txt

Fulltext below. ÂComments appreciated.

-V
=======================

Filename: ExtraRelayDescriptorFields.txt
Title: Adding new X- fields to relay descriptor
Author: Virgil Griffith, Nick Mathewson
Created: 2014-06-03
Status: Open


1. Motivation
We wish to allow developers to build new applications atop relays. Towards this
end, we wish to add the ability for users to specify arbitrary new key-value
entries under the "X-" namespace.


2. Proposal
Allow optional key-value lines in the relay's torrc file. ÂThese lines will be
mirrored in the relay's descriptor which is then published in the directory
consensus.

The format is:
X-key value


For example:
X-bitcoin 19mP9FKrXqL46Si58pHdhGKow88SUPy1V8
X-gravatar https://s.gravatar.com/avatar/d27fce46c9ac41a41bb52455ae75701d
X-nameid virgil.gr
X-favoritequote Be excellent to each other. ÂParty on dudes!


The value field must be printable ASCII (characters 32-126). ÂThe value must
not under any condition contain a newline. ÂThe key may contain lowercase
ASCII letters (a-z), digits, underscore, or dash. ÂIn regex, [-_0-9a-z].

There may need to be a maximum sum length of the X- entries. ÂThis is
left to the developers. ÂI propose a maximum sum length of 5 kilobytes.



_______________________________________________
tor-dev mailing list
tor-dev@xxxxxxxxxxxxxxxxxxxx
https://lists.torproject.org/cgi-bin/mailman/listinfo/tor-dev