I2P_Developers/i2p.www
3
0
Fork 5
Code Issues 27 Pull Requests Actions 1 Packages Projects Releases Wiki Activity

I2NP: Rewrite overview, update version info, add version info to message chart

Browse Source
This commit is contained in:
zzz
2021-05-06 11:25:15 -04:00
parent 64c969b3d7
commit 8259e904cc
1 changed files with 21 additions and 18 deletions
Download Patch File Download Diff File Expand all files Collapse all files

39
i2p2www/spec/i2np.rst
View File

@@ -3,8 +3,8 @@ I2NP Specification
================== ==================
.. meta:: .. meta::
:category: Protocols :category: Protocols
:lastupdated: 2021-01 :lastupdated: 2021-05
:accuratefor: 0.9.49 :accuratefor: 0.9.50
.. contents:: .. contents::
@@ -12,11 +12,12 @@ I2NP Specification
Overview Overview
======== ========
The I2P Network Protocol (I2NP), which is sandwiched between I2CP and the The I2P Network Protocol (I2NP) is the layer above the
various I2P transport protocols, manages the routing and mixing of messages I2P transport protocols. It is a router-to-router protocol.
between routers, as well as the selection of what transports to use when It is used for network database lookups and replies, for creating
communicating with a peer for which there are multiple common transports tunnels, and for encrypted router and client data messages.
supported. I2NP messages may be sent point-to-point to another router,
or sent anonymously through tunnels to that router.
.. _versions: .. _versions:
@@ -25,7 +26,8 @@ Protocol Versions
================= =================
All routers must publish their I2NP protocol version in the "router.version" All routers must publish their I2NP protocol version in the "router.version"
field in the RouterInfo properties. This version field indicates their level field in the RouterInfo properties.
This version field is the API version, indiciating the level
of support for various I2NP protocol features, and is not necessarily the of support for various I2NP protocol features, and is not necessarily the
actual router version. actual router version.
@@ -33,7 +35,8 @@ If alternative (non-Java) routers wish to publish any version information about
the actual router implementation, they must do so in another property. the actual router implementation, they must do so in another property.
Versions other than those listed below are allowed. Support will be determined Versions other than those listed below are allowed. Support will be determined
through a numeric comparison; for example, 0.9.13 implies support for 0.9.12 through a numeric comparison; for example, 0.9.13 implies support for 0.9.12
features. Note that the "coreVersion" property is not used for determination features. Note that the "coreVersion" property is no longer published
in the router info, and was never used for determination
of the I2NP protocol version. of the I2NP protocol version.
A basic summary of the I2NP protocol versions is as follows. For details, see A basic summary of the I2NP protocol versions is as follows. For details, see
@@ -597,9 +600,9 @@ Delivery Instructions!
Messages Messages
======== ========
================================== ======= ================================== ======= =======
Message Type Message Type Since
================================== ======= ================================== ======= =======
DatabaseStore_ 1 DatabaseStore_ 1
DatabaseLookup_ 2 DatabaseLookup_ 2
DatabaseSearchReply_ 3 DatabaseSearchReply_ 3
@@ -610,15 +613,15 @@ TunnelGateway_ 19
Data_ 20 Data_ 20
TunnelBuild_ 21 TunnelBuild_ 21
TunnelBuildReply_ 22 TunnelBuildReply_ 22
VariableTunnelBuild_ 23 VariableTunnelBuild_ 23 0.7.12
VariableTunnelBuildReply_ 24 VariableTunnelBuildReply_ 24 0.7.12
Reserved [Prop157]_ 25 Reserved [Prop157]_ 25 TBD
Reserved [Prop157]_ 26 Reserved [Prop157]_ 26 TBD
Reserved [Prop157]_ 27 Reserved [Prop157]_ 27 TBD
Reserved 0 Reserved 0
Reserved for experimental messages 224-254 Reserved for experimental messages 224-254
Reserved for future expansion 255 Reserved for future expansion 255
================================== ======= ================================== ======= =======
.. _msg-DatabaseStore: .. _msg-DatabaseStore: