From fbe88e7d35148d80a743b2607419519c80606fe3 Mon Sep 17 00:00:00 2001
From: zzz <zzz@i2pmail.org>
Date: Sat, 31 Jul 2021 10:33:58 -0400
Subject: [PATCH] More updates for prop. 157
---
i2p2www/spec/proposals/157-new-tbm.rst | 10 +++++++++-
i2p2www/spec/tunnel-creation-ecies.rst | 25 +++++++++++++++++++++++++
2 files changed, 34 insertions(+), 1 deletion(-)
diff --git a/i2p2www/spec/proposals/157-new-tbm.rst b/i2p2www/spec/proposals/157-new-tbm.rst
index f5242dad6..9126626b0 100644
--- a/i2p2www/spec/proposals/157-new-tbm.rst
+++ b/i2p2www/spec/proposals/157-new-tbm.rst
@@ -5,13 +5,21 @@ Smaller Tunnel Build Messages
:author: zzz, orignal
:created: 2020-10-09
:thread: http://zzz.i2p/topics/2957
- :lastupdated: 2021-07-28
+ :lastupdated: 2021-07-31
:status: Open
:target: 0.9.51
.. contents::
+Note
+====
+Implemented as of API version 0.9.51.
+Network deployment and testing in progress.
+Subject to minor revision.
+See [I2NP]_ and [Tunnel-Creation-ECIES]_ for the final specification.
+
+
Overview
========
diff --git a/i2p2www/spec/tunnel-creation-ecies.rst b/i2p2www/spec/tunnel-creation-ecies.rst
index 4740e9870..ba80322fb 100644
--- a/i2p2www/spec/tunnel-creation-ecies.rst
+++ b/i2p2www/spec/tunnel-creation-ecies.rst
@@ -837,6 +837,8 @@ uses AES.
.. raw:: html
+ {% highlight lang='dataspec' %}
+
// Parameters
k = replyKey from KDF above
n = record number 0-7
@@ -849,6 +851,26 @@ uses AES.
{% endhighlight %}
+Garlic Encryption
+```````````````````````
+
+Garlic wrapping of the messages hides them from the OBEP (for an inbound build)
+or the IBGW (for an outbound build). This is recommended but not required.
+If the OBEP and IBGW are the same router, it is not necessary.
+
+Garlic encryption of an inbound Short Tunnel Build Message,
+by the creator, encrypted to the ECIES IBGW, uses Noise 'N' encryption,
+as defined in [ECIES-ROUTERS]_.
+
+Garlic encryption of an Outbound Tunnel Build Reply Message,
+by the OBEP, encrypted to the creator, uses
+They are encrypted as Existing Session messages with
+the 32-byte garlic reply key and 8-byte garlic reply tag from the KDF above.
+The format is as specified for replies to Database Lookups in [I2NP]_,
+[ECIES-ROUTERS]_, and [ECIES-X25519]_.
+
+
+
Implementation Notes
=====================
@@ -868,6 +890,9 @@ References
.. [Cryptography]
{{ spec_url('cryptography') }}
+.. [ECIES-ROUTERS]
+ {{ spec_url('ecies-routers') }}
+
.. [ECIES-X25519]
{{ spec_url('ecies') }}
--
GitLab