From 369cd98d5a1e5d6c786c6a548e02db371d96c2c3 Mon Sep 17 00:00:00 2001
From: Itamar Turner-Trauring <itamar@itamarst.org>
Date: Tue, 29 Sep 2020 10:17:26 -0400
Subject: [PATCH] Clarify what "JSON-serializable bytes" means.

---
 src/allmydata/introducer/interfaces.py | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/src/allmydata/introducer/interfaces.py b/src/allmydata/introducer/interfaces.py
index 0b7a32fa5..9f08f1943 100644
--- a/src/allmydata/introducer/interfaces.py
+++ b/src/allmydata/introducer/interfaces.py
@@ -112,6 +112,11 @@ class IIntroducerClient(Interface):
          service-name: bytes('storage')
          anonymous-storage-FURL: bytes(furl)
 
+        In order to be JSON-serializable, all byte strings are assumed to be
+        ASCII-encoded, and the receiver can therefore decode them into Unicode
+        strings if they wish. Representation of these fields elsewhere in Tahoe
+        may differ, e.g. by being unicode strings.
+
         Note that app-version will be an empty dictionary if either the
         publishing client or the Introducer are running older code.
         """