More updates for prop. 157

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
 ========

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') }}