From 73d3702a490cb1f4d0289928454bf7db6e7e9501 Mon Sep 17 00:00:00 2001 From: Nick Mathewson Date: Wed, 8 Dec 2021 09:41:21 -0500 Subject: Fold prop 335-middle-only-redux.md into the specs. Also, mark it closed. --- dir-spec.txt | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) (limited to 'dir-spec.txt') diff --git a/dir-spec.txt b/dir-spec.txt index 543e341..45b8466 100644 --- a/dir-spec.txt +++ b/dir-spec.txt @@ -2329,6 +2329,11 @@ Table of Contents "Fast" if the router is suitable for high-bandwidth circuits. "Guard" if the router is suitable for use as an entry guard. "HSDir" if the router is considered a v2 hidden service directory. + "MiddleOnly" if the router is considered unsuitable for + usage other than as a middle relay. Clients do not need + to handle this option, since when it is present, the authorities + will automatically vote against flags that would make the router + usable in other positions. (Since 0.4.7.2-alpha.) "NoEdConsensus" if any Ed25519 key in the router's descriptor or microdescriptor does not reflect authority consensus. "Stable" if the router is suitable for long-lived circuits. @@ -2638,6 +2643,13 @@ Table of Contents authority believes that it's been up for at least 96 hours (or the current value of MinUptimeHidServDirectoryV2). + "MiddleOnly" -- An authority should vote for this flag if it believes + that a relay is unsuitable for use except as a middle relay. When + voting for this flag, the authority should also vote against "Exit", + "Guard", "HsDir", and "V2Dir". When voting for this flag, if the + authority votes on the "BadExit" flag, the authority should vote in + favor of "BadExit". (This flag was added in 0.4.7.2-alpha.) + "NoEdConsensus" -- authorities should not vote on this flag; it is produced as part of the consensus for consensus method 22 or later. @@ -2957,6 +2969,13 @@ Table of Contents "bwweightscale" and "maxunmeasuredbw" parameters correctly when computing votes. + * If consensus method 32 or later is used, authorities handle the + "MiddleOnly" flag specially when computing a consensus. When the + voters agree to include "MiddleOnly" in a routerstatus, they + automatically remove "Exit", "Guard", "V2Dir", and "HSDir". If + the BadExit flag is included in the consensus, they automatically + add it to the routerstatus. + The signatures at the end of a consensus document are sorted in ascending order by identity digest. -- cgit v1.2.3-54-g00ecf