From f58b71a14e17a3760fd1ce8baabc57a1afa3522a Mon Sep 17 00:00:00 2001
From: Mark Haines <mark.haines@matrix.org>
Date: Thu, 20 Aug 2015 10:12:19 +0100
Subject: [PATCH] Clarify that only the public parts of keys are sent over the
wire
---
docs/olm.rst | 12 ++++++++----
1 file changed, 8 insertions(+), 4 deletions(-)
diff --git a/docs/olm.rst b/docs/olm.rst
index d07dc1d..51a38bd 100644
--- a/docs/olm.rst
+++ b/docs/olm.rst
@@ -186,7 +186,8 @@ significant bits are stored in the first byte.
=========== ===== ======== ================================================
Name Tag Type Meaning
=========== ===== ======== ================================================
-Ratchet-Key 0x0A String The ratchet key, :math:`T_{i}`, of the message
+Ratchet-Key 0x0A String The public part of the ratchet key, :math:`T_{i}`,
+ of the message
Chain-Index 0x10 Integer The chain index, :math:`j`, of the message
Cipher-Text 0x22 String The cipher-text, :math:`X_{i,j}`, of the message
=========== ===== ======== ================================================
@@ -213,9 +214,12 @@ The payload uses the same key-value format as for normal messages.
============ ===== ======== ================================================
Name Tag Type Meaning
============ ===== ======== ================================================
-One-Time-Key 0x0A String Bob's single-use key, :math:`E_b`.
-Base-Key 0x12 String Alice's single-use key, :math:`E_a`.
-Identity-Key 0x1A String Alice's identity key, :math:`I_a`.
+One-Time-Key 0x0A String The public part of Bob's single-use key,
+ :math:`E_b`.
+Base-Key 0x12 String The public part of Alice's single-use key,
+ :math:`E_a`.
+Identity-Key 0x1A String The public part of Alice's identity key,
+ :math:`I_a`.
Message 0x22 String An embedded Olm message with its own version and
MAC.
============ ===== ======== ================================================
--
GitLab