diff --git a/i2p2www/spec/proposals/157-new-tbm.rst b/i2p2www/spec/proposals/157-new-tbm.rst index f5242dad603b58fe1d09631d022dd8c38f400fa5..9126626b0aabd2062d920eae1108475b5036cd6d 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 4740e98704d0aa7213c6bbcd5a5871bd4ac999e6..ba80322fb41a4822534ddc1a35c467c60db4bef3 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') }}