More updates for prop. 157

This commit is contained in:
zzz
2021-07-31 10:33:58 -04:00
parent fb085e6cca
commit fbe88e7d35
2 changed files with 34 additions and 1 deletions

View File

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

View File

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