From ba450711d7db49d014e072281d74c1cc4842a66c Mon Sep 17 00:00:00 2001
From: zzz <zzz@mail.i2p>
Date: Wed, 4 Jan 2017 14:47:27 +0000
Subject: [PATCH] note on address sorting

---
 i2p2www/spec/common-structures.rst | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/i2p2www/spec/common-structures.rst b/i2p2www/spec/common-structures.rst
index cdbe85e24..edeaba81c 100644
--- a/i2p2www/spec/common-structures.rst
+++ b/i2p2www/spec/common-structures.rst
@@ -3,8 +3,8 @@ Common structures Specification
 ===============================
 .. meta::
     :category: Design
-    :lastupdated: August 2016
-    :accuratefor: 0.9.26
+    :lastupdated: January 2017
+    :accuratefor: 0.9.28
 
 .. contents::
 
@@ -1019,6 +1019,8 @@ Notes
 * The peer_size Integer_ may be followed by a list of that many router hashes.
   This is currently unused. It was intended for a form of restricted routes,
   which is unimplemented.
+  Certain implementations may require the list to be sorted so the signature is invariant.
+  To be researched before enabling this feature.
 
 * The signature may be verified using the signing public key of the
   router_ident.
@@ -1026,6 +1028,10 @@ Notes
 * See the network database page [NETDB-ROUTERINFO]_ for standard options that
   are expected to be present in all router infos.
 
+* Very old routers required the addresses to be sorted by the SHA256 of their data
+  so the signature is invariant.
+  This is no longer required, and not worth implementing for backward compatibility.
+
 JavaDoc: http://{{ i2pconv('i2p-javadocs.i2p') }}/net/i2p/data/router/RouterInfo.html
 
 .. _struct-DeliveryInstructions:
-- 
GitLab