[tor-commits] [torspec/main] add ed25519-master-pubkey.txt description

[nickm at torproject.org]

commit 8b1babf17c4b61084bfce18daee72d83ea6dfba3
Author: nusenu <360-nusenu at gitlab.torproject.org>
Date:   Sun Sep 12 20:27:26 2021 +0000

    add ed25519-master-pubkey.txt description
---
 proposals/326-tor-relay-well-known-uri-rfc8615.md | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/proposals/326-tor-relay-well-known-uri-rfc8615.md b/proposals/326-tor-relay-well-known-uri-rfc8615.md
index 568d387..b1ed60a 100644
--- a/proposals/326-tor-relay-well-known-uri-rfc8615.md
+++ b/proposals/326-tor-relay-well-known-uri-rfc8615.md
@@ -53,6 +53,27 @@ B234567890123456789012345678901234567890
 ```
 The RSA SHA1 relay fingerprint can be found in the file named "fingerprint" located in the Tor data directory on the relay.
 
+## /.well-known/tor-relay/ed25519-master-pubkey.txt
+
+* The file contains one or more ed25519 Tor relay public master keys of relays operated by the entity in control of this website.
+* Each line contains one public ed25519 master key in its base64 encoded form.
+* The file may contain comments (starting with #).
+* Non-comment lines must be exactly 43 characters long and consist of the following characters [a-zA-z0-9/+].
+* Each key MUST appear at most once.
+* The file MUST not be larger than one MByte.
+* The content MUST be a media type of "text/plain".
+
+Example file content:
+
+```
+# we operate these Tor relays
+yp0fwtp4aa/VMyZJGz8vN7Km3zYet1YBZwqZEk1CwHI
+kXdA5dmIhXblAquMx0M0ApWJJ4JGQGLsjUSn86cbIaU
+bHzOT41w56KHh+w6TYwUhN4KrGwPWQWJX04/+tw/+RU
+```
+
+The base64 encoded ed25519 public master key can be found in the file named "fingerprint-ed25519" located in the Tor data directory on the relay.
+
 
 # Change Controller