Updated documentation to reflect 128-bit address space
This commit is contained in:
		
							parent
							
								
									304610c682
								
							
						
					
					
						commit
						8f82a2b87f
					
				@ -1,4 +1,4 @@
 | 
				
			|||||||
# Sphinx build info version 1
 | 
					# Sphinx build info version 1
 | 
				
			||||||
# This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
 | 
					# This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
 | 
				
			||||||
config: 450b6695e9c51c393c691ba688e02b3c
 | 
					config: d4963122ff51d6bca74c9598f37a0cc1
 | 
				
			||||||
tags: 645f666f9bcd5a90fca523b33c5a78b7
 | 
					tags: 645f666f9bcd5a90fca523b33c5a78b7
 | 
				
			||||||
 | 
				
			|||||||
@ -161,20 +161,25 @@ by adding one of the following interfaces to your ``.reticulum/config`` file:
 | 
				
			|||||||
 | 
					
 | 
				
			||||||
.. code::
 | 
					.. code::
 | 
				
			||||||
 | 
					
 | 
				
			||||||
  # For connecting over TCP/IP:
 | 
					  # TCP/IP interface to the Dublin hub
 | 
				
			||||||
  [[RNS Testnet Frankfurt]]
 | 
					  [[RNS Testnet Dublin]]
 | 
				
			||||||
    type = TCPClientInterface
 | 
					    type = TCPClientInterface
 | 
				
			||||||
    interface_enabled = yes
 | 
					    enabled = yes
 | 
				
			||||||
    outgoing = True
 | 
					    target_host = dublin.connect.reticulum.network
 | 
				
			||||||
    target_host = frankfurt.rns.unsigned.io
 | 
					 | 
				
			||||||
    target_port = 4965
 | 
					    target_port = 4965
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					  # TCP/IP interface to the Frankfurt hub
 | 
				
			||||||
 | 
					  [[RNS Testnet Dublin]]
 | 
				
			||||||
 | 
					    type = TCPClientInterface
 | 
				
			||||||
 | 
					    enabled = yes
 | 
				
			||||||
 | 
					    target_host = frankfurt.connect.reticulum.network
 | 
				
			||||||
 | 
					    target_port = 5377
 | 
				
			||||||
 | 
					
 | 
				
			||||||
  # For connecting over I2P:
 | 
					  # Interface to I2P hub A
 | 
				
			||||||
  [[RNS Testnet I2P Node A]]
 | 
					  [[RNS Testnet I2P Hub A]]
 | 
				
			||||||
    type = I2PInterface
 | 
					    type = I2PInterface
 | 
				
			||||||
    interface_enabled = yes
 | 
					    enabled = yes
 | 
				
			||||||
    peers = ykzlw5ujbaqc2xkec4cpvgyxj257wcrmmgkuxqmqcur7cq3w3lha.b32.i2p
 | 
					    peers = uxg5kubabakh3jtnvsipingbr5574dle7bubvip7llfvwx2tgrua.b32.i2p
 | 
				
			||||||
 | 
					
 | 
				
			||||||
Many other Reticulum instances are connecting to this testnet, and you can also join it
 | 
					Many other Reticulum instances are connecting to this testnet, and you can also join it
 | 
				
			||||||
via other entry points if you know them. There is absolutely no control over the network
 | 
					via other entry points if you know them. There is absolutely no control over the network
 | 
				
			||||||
 | 
				
			|||||||
@ -14,9 +14,7 @@ Donations are gratefully accepted via the following channels:
 | 
				
			|||||||
.. code:: text
 | 
					.. code:: text
 | 
				
			||||||
 | 
					
 | 
				
			||||||
    Monero:
 | 
					    Monero:
 | 
				
			||||||
    84FpY1QbxHcgdseePYNmhTHcrgMX4nFf
 | 
					    84FpY1QbxHcgdseePYNmhTHcrgMX4nFfBYtz2GKYToqHVVhJp8Eaw1Z1EedRnKD19b3B8NiLCGVxzKV17UMmmeEsCrPyA5w
 | 
				
			||||||
    BYtz2GKYToqHVVhJp8Eaw1Z1EedRnKD1
 | 
					 | 
				
			||||||
    9b3B8NiLCGVxzKV17UMmmeEsCrPyA5w
 | 
					 | 
				
			||||||
 | 
					
 | 
				
			||||||
    Ethereum:
 | 
					    Ethereum:
 | 
				
			||||||
    0x81F7B979fEa6134bA9FD5c701b3501A2e61E897a
 | 
					    0x81F7B979fEa6134bA9FD5c701b3501A2e61E897a
 | 
				
			||||||
 | 
				
			|||||||
@ -117,29 +117,29 @@ Reticulum uses the singular concept of *destinations*. Any application using Ret
 | 
				
			|||||||
networking stack will need to create one or more destinations to receive data, and know the
 | 
					networking stack will need to create one or more destinations to receive data, and know the
 | 
				
			||||||
destinations it needs to send data to.
 | 
					destinations it needs to send data to.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
All destinations in Reticulum are represented as a 10 byte hash, derived from truncating a full
 | 
					All destinations in Reticulum are _represented_ as a 16 byte hash. This hash is derived from truncating a full
 | 
				
			||||||
SHA-256 hash of identifying characteristics of the destination. To users, the destination addresses
 | 
					SHA-256 hash of identifying characteristics of the destination. To users, the destination addresses
 | 
				
			||||||
will be displayed as 10 bytes in hexadecimal representation, as in the following example: ``<80e29bf7cccaf31431b3>``.
 | 
					will be displayed as 16 hexadecimal bytes, like this example: ``<13425ec15b621c1d928589718000d814>``.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
The truncation size of 10 bytes (80 bits) for destinations has been choosen as a reasonable tradeoff between address space
 | 
					The truncation size of 16 bytes (128 bits) for destinations has been choosen as a reasonable tradeoff
 | 
				
			||||||
 | 
					between address space
 | 
				
			||||||
and packet overhead. The address space accomodated by this size can support many billions of
 | 
					and packet overhead. The address space accomodated by this size can support many billions of
 | 
				
			||||||
simultaneously active devices on the same network, while keeping packet overhead low, which is
 | 
					simultaneously active devices on the same network, while keeping packet overhead low, which is
 | 
				
			||||||
essential on low-bandwidth networks. In the very unlikely case that this address space nears
 | 
					essential on low-bandwidth networks. In the very unlikely case that this address space nears
 | 
				
			||||||
congestion, a one-line code change can upgrade the Reticulum address space all the way up to 256
 | 
					congestion, a one-line code change can upgrade the Reticulum address space all the way up to 256
 | 
				
			||||||
bits, ensuring the Reticulum address space could potentially support galactic-scale networks.
 | 
					bits, ensuring the Reticulum address space could potentially support galactic-scale networks.
 | 
				
			||||||
This is obviusly complete and ridiculous over-allocation, and as such, the current 80 bits should
 | 
					This is obviusly complete and ridiculous over-allocation, and as such, the current 128 bits should
 | 
				
			||||||
be sufficient, even far into the future.
 | 
					be sufficient, even far into the future.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
By default Reticulum encrypts all data using elliptic curve cryptography. Any packet sent to a
 | 
					By default Reticulum encrypts all data using elliptic curve cryptography. Any packet sent to a
 | 
				
			||||||
destination is encrypted with a derived ephemeral key. Reticulum can also set up an encrypted
 | 
					destination is encrypted with a derived ephemeral key. Reticulum can also set up an encrypted
 | 
				
			||||||
channel to a destination with *Forward Secrecy* and *Initiator Anonymity* using a elliptic
 | 
					channel to a destination, called a *Link*. Both data sent over Links and single packets offer
 | 
				
			||||||
curve cryptography and ephemeral keys derived from a Diffie Hellman exchange on Curve25519. In
 | 
					*Forward Secrecy* and *Initiator Anonymity*, by using an Elliptic Curve Diffie Hellman key exchange
 | 
				
			||||||
Reticulum terminology, this is called a *Link*. The multi-hop transport, coordination, verification
 | 
					on Curve25519 to derive ephemeral keys. The multi-hop transport, coordination, verification
 | 
				
			||||||
and reliability layers are fully autonomous and also based on elliptic curve cryptography.
 | 
					and reliability layers are fully autonomous and also based on elliptic curve cryptography.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
Reticulum also offers symmetric key encryption for group-oriented communications, as well as
 | 
					Reticulum also offers symmetric key encryption for group-oriented communications, as well as
 | 
				
			||||||
unencrypted packets for broadcast purposes, or situations where you need the communication to be in
 | 
					unencrypted packets for local broadcast purposes.
 | 
				
			||||||
plain text.
 | 
					 | 
				
			||||||
 | 
					
 | 
				
			||||||
Reticulum can connect to a variety of interfaces such as radio modems, data radios and serial ports,
 | 
					Reticulum can connect to a variety of interfaces such as radio modems, data radios and serial ports,
 | 
				
			||||||
and offers the possibility to easily tunnel Reticulum traffic over IP links such as the Internet or
 | 
					and offers the possibility to easily tunnel Reticulum traffic over IP links such as the Internet or
 | 
				
			||||||
@ -186,7 +186,7 @@ Destination Naming
 | 
				
			|||||||
^^^^^^^^^^^^^^^^^^
 | 
					^^^^^^^^^^^^^^^^^^
 | 
				
			||||||
 | 
					
 | 
				
			||||||
Destinations are created and named in an easy to understand dotted notation of *aspects*, and
 | 
					Destinations are created and named in an easy to understand dotted notation of *aspects*, and
 | 
				
			||||||
represented on the network as a hash of this value. The hash is a SHA-256 truncated to 80 bits. The
 | 
					represented on the network as a hash of this value. The hash is a SHA-256 truncated to 128 bits. The
 | 
				
			||||||
top level aspect should always be a unique identifier for the application using the destination.
 | 
					top level aspect should always be a unique identifier for the application using the destination.
 | 
				
			||||||
The next levels of aspects can be defined in any way by the creator of the application.
 | 
					The next levels of aspects can be defined in any way by the creator of the application.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
@ -202,7 +202,7 @@ application name, a device type and measurement type, like this:
 | 
				
			|||||||
   aspects   : remotesensor, temperature
 | 
					   aspects   : remotesensor, temperature
 | 
				
			||||||
 | 
					
 | 
				
			||||||
   full name : environmentlogger.remotesensor.temperature
 | 
					   full name : environmentlogger.remotesensor.temperature
 | 
				
			||||||
   hash      : fa7ddfab5213f916dea
 | 
					   hash      : 4faf1b2e0a077e6a9d92fa051f256038
 | 
				
			||||||
 | 
					
 | 
				
			||||||
For the *single* destination, Reticulum will automatically append the associated public key as a
 | 
					For the *single* destination, Reticulum will automatically append the associated public key as a
 | 
				
			||||||
destination aspect before hashing. This is done to ensure only the correct destination is reached,
 | 
					destination aspect before hashing. This is done to ensure only the correct destination is reached,
 | 
				
			||||||
@ -683,7 +683,7 @@ Wire Format
 | 
				
			|||||||
 | 
					
 | 
				
			||||||
    A Reticulum packet is composed of the following fields:
 | 
					    A Reticulum packet is composed of the following fields:
 | 
				
			||||||
 | 
					
 | 
				
			||||||
    [HEADER 2 bytes] [ADDRESSES 10/20 bytes] [CONTEXT 1 byte] [DATA 0-477 bytes]
 | 
					    [HEADER 2 bytes] [ADDRESSES 16/32 bytes] [CONTEXT 1 byte] [DATA 0-465 bytes]
 | 
				
			||||||
 | 
					
 | 
				
			||||||
    * The HEADER field is 2 bytes long.
 | 
					    * The HEADER field is 2 bytes long.
 | 
				
			||||||
      * Byte 1: [IFAC Flag], [Header Type], [Propagation Type], [Destination Type] and [Packet Type]
 | 
					      * Byte 1: [IFAC Flag], [Header Type], [Propagation Type], [Destination Type] and [Packet Type]
 | 
				
			||||||
@ -695,15 +695,15 @@ Wire Format
 | 
				
			|||||||
        capabilities and configuration.
 | 
					        capabilities and configuration.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
    * The ADDRESSES field contains either 1 or 2 addresses.
 | 
					    * The ADDRESSES field contains either 1 or 2 addresses.
 | 
				
			||||||
      * Each address is 10 bytes long.
 | 
					      * Each address is 16 bytes long.
 | 
				
			||||||
      * The Header Type flag in the HEADER field determines
 | 
					      * The Header Type flag in the HEADER field determines
 | 
				
			||||||
        whether the ADDRESSES field contains 1 or 2 addresses.
 | 
					        whether the ADDRESSES field contains 1 or 2 addresses.
 | 
				
			||||||
      * Addresses are Reticulum hashes truncated to 10 bytes.
 | 
					      * Addresses are SHA-256 hashes truncated to 16 bytes.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
    * The CONTEXT field is 1 byte.
 | 
					    * The CONTEXT field is 1 byte.
 | 
				
			||||||
      * It is used by Reticulum to determine packet context.
 | 
					      * It is used by Reticulum to determine packet context.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
    * The DATA field is between 0 and 477 bytes.
 | 
					    * The DATA field is between 0 and 465 bytes.
 | 
				
			||||||
      * It contains the packets data payload.
 | 
					      * It contains the packets data payload.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
    IFAC Flag
 | 
					    IFAC Flag
 | 
				
			||||||
@ -714,8 +714,8 @@ Wire Format
 | 
				
			|||||||
 | 
					
 | 
				
			||||||
    Header Types
 | 
					    Header Types
 | 
				
			||||||
    -----------------
 | 
					    -----------------
 | 
				
			||||||
    type 1           0  Two byte header, one 10 byte address field
 | 
					    type 1           0  Two byte header, one 16 byte address field
 | 
				
			||||||
    type 2           1  Two byte header, two 10 byte address fields
 | 
					    type 2           1  Two byte header, two 16 byte address fields
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					
 | 
				
			||||||
    Propagation Types
 | 
					    Propagation Types
 | 
				
			||||||
@ -747,7 +747,7 @@ Wire Format
 | 
				
			|||||||
       HEADER FIELD           DESTINATION FIELDS            CONTEXT FIELD  DATA FIELD
 | 
					       HEADER FIELD           DESTINATION FIELDS            CONTEXT FIELD  DATA FIELD
 | 
				
			||||||
     _______|_______   ________________|________________   ________|______   __|_
 | 
					     _______|_______   ________________|________________   ________|______   __|_
 | 
				
			||||||
    |               | |                                 | |               | |    |
 | 
					    |               | |                                 | |               | |    |
 | 
				
			||||||
    01010000 00000100 [HASH1, 10 bytes] [HASH2, 10 bytes] [CONTEXT, 1 byte] [DATA]
 | 
					    01010000 00000100 [HASH1, 16 bytes] [HASH2, 16 bytes] [CONTEXT, 1 byte] [DATA]
 | 
				
			||||||
    || | | |    |
 | 
					    || | | |    |
 | 
				
			||||||
    || | | |    +-- Hops             = 4
 | 
					    || | | |    +-- Hops             = 4
 | 
				
			||||||
    || | | +------- Packet Type      = DATA
 | 
					    || | | +------- Packet Type      = DATA
 | 
				
			||||||
@ -762,7 +762,7 @@ Wire Format
 | 
				
			|||||||
       HEADER FIELD   DESTINATION FIELD   CONTEXT FIELD  DATA FIELD
 | 
					       HEADER FIELD   DESTINATION FIELD   CONTEXT FIELD  DATA FIELD
 | 
				
			||||||
     _______|_______   _______|_______   ________|______   __|_
 | 
					     _______|_______   _______|_______   ________|______   __|_
 | 
				
			||||||
    |               | |               | |               | |    |
 | 
					    |               | |               | |               | |    |
 | 
				
			||||||
    00000000 00000111 [HASH1, 10 bytes] [CONTEXT, 1 byte] [DATA]
 | 
					    00000000 00000111 [HASH1, 16 bytes] [CONTEXT, 1 byte] [DATA]
 | 
				
			||||||
    || | | |    |
 | 
					    || | | |    |
 | 
				
			||||||
    || | | |    +-- Hops             = 0
 | 
					    || | | |    +-- Hops             = 0
 | 
				
			||||||
    || | | +------- Packet Type      = DATA
 | 
					    || | | +------- Packet Type      = DATA
 | 
				
			||||||
@ -777,7 +777,7 @@ Wire Format
 | 
				
			|||||||
       HEADER FIELD     IFAC FIELD    DESTINATION FIELD   CONTEXT FIELD  DATA FIELD
 | 
					       HEADER FIELD     IFAC FIELD    DESTINATION FIELD   CONTEXT FIELD  DATA FIELD
 | 
				
			||||||
     _______|_______   ______|______   _______|_______   ________|______   __|_
 | 
					     _______|_______   ______|______   _______|_______   ________|______   __|_
 | 
				
			||||||
    |               | |             | |               | |               | |    |
 | 
					    |               | |             | |               | |               | |    |
 | 
				
			||||||
    10000000 00000111 [IFAC, N bytes] [HASH1, 10 bytes] [CONTEXT, 1 byte] [DATA]
 | 
					    10000000 00000111 [IFAC, N bytes] [HASH1, 16 bytes] [CONTEXT, 1 byte] [DATA]
 | 
				
			||||||
    || | | |    |
 | 
					    || | | |    |
 | 
				
			||||||
    || | | |    +-- Hops             = 0
 | 
					    || | | |    +-- Hops             = 0
 | 
				
			||||||
    || | | +------- Packet Type      = DATA
 | 
					    || | | +------- Packet Type      = DATA
 | 
				
			||||||
 | 
				
			|||||||
@ -223,7 +223,7 @@ interfaces, similar to the ``ifconfig`` program.
 | 
				
			|||||||
     Traffic : 8.49 KB↑
 | 
					     Traffic : 8.49 KB↑
 | 
				
			||||||
               9.23 KB↓
 | 
					               9.23 KB↓
 | 
				
			||||||
 | 
					
 | 
				
			||||||
  Reticulum Transport Instance <5245a8efe1788c6a70e1> running
 | 
					  Reticulum Transport Instance <5245a8efe1788c6a1cd36144a270e13b> running
 | 
				
			||||||
 | 
					
 | 
				
			||||||
.. code:: text
 | 
					.. code:: text
 | 
				
			||||||
 | 
					
 | 
				
			||||||
@ -248,10 +248,10 @@ destinations on the Reticulum network.
 | 
				
			|||||||
.. code:: text
 | 
					.. code:: text
 | 
				
			||||||
 | 
					
 | 
				
			||||||
  # Run rnpath
 | 
					  # Run rnpath
 | 
				
			||||||
  rnpath eca6f4e4dc26ae329e61
 | 
					  rnpath c89b4da064bf66d280f0e4d8abfd9806
 | 
				
			||||||
 | 
					
 | 
				
			||||||
  # Example output
 | 
					  # Example output
 | 
				
			||||||
  Path found, destination <eca6f4e4dc26ae329e61> is 4 hops away via <56b115c30cd386cad69c> on TCPInterface[Testnet/frankfurt.rns.unsigned.io:4965]
 | 
					  Path found, destination <c89b4da064bf66d280f0e4d8abfd9806> is 4 hops away via <f53a1c4278e0726bb73fcc623d6ce763> on TCPInterface[Testnet/frankfurt.connect.reticulu.network:4965]
 | 
				
			||||||
 | 
					
 | 
				
			||||||
.. code:: text
 | 
					.. code:: text
 | 
				
			||||||
 | 
					
 | 
				
			||||||
@ -285,11 +285,11 @@ destinations will not have this option enabled, and will not be probable.
 | 
				
			|||||||
.. code:: text
 | 
					.. code:: text
 | 
				
			||||||
 | 
					
 | 
				
			||||||
  # Run rnprobe
 | 
					  # Run rnprobe
 | 
				
			||||||
  rnprobe example_utilities.echo.request 9382f334de63217a4278
 | 
					  rnprobe example_utilities.echo.request 2d03725b327348980d570f739a3a5708
 | 
				
			||||||
 | 
					
 | 
				
			||||||
  # Example output
 | 
					  # Example output
 | 
				
			||||||
  Sent 16 byte probe to <9382f334de63217a4278>
 | 
					  Sent 16 byte probe to <2d03725b327348980d570f739a3a5708>
 | 
				
			||||||
  Valid reply received from <9382f334de63217a4278>
 | 
					  Valid reply received from <2d03725b327348980d570f739a3a5708>
 | 
				
			||||||
  Round-trip time is 38.469 milliseconds over 2 hops
 | 
					  Round-trip time is 38.469 milliseconds over 2 hops
 | 
				
			||||||
 | 
					
 | 
				
			||||||
.. code:: text
 | 
					.. code:: text
 | 
				
			||||||
@ -319,10 +319,10 @@ files through Reticulum.
 | 
				
			|||||||
 | 
					
 | 
				
			||||||
  # Run rncp on the receiving system, specifying which identities
 | 
					  # Run rncp on the receiving system, specifying which identities
 | 
				
			||||||
  # are allowed to send files
 | 
					  # are allowed to send files
 | 
				
			||||||
  rncp --receive -a 940ea3f9e1037d38758f -a e28d5aee4317c24a9041
 | 
					  rncp --receive -a 1726dbad538775b5bf9b0ea25a4079c8 -a c50cc4e4f7838b6c31f60ab9032cbc62
 | 
				
			||||||
 | 
					
 | 
				
			||||||
  # From another system, copy a file to the receiving system
 | 
					  # From another system, copy a file to the receiving system
 | 
				
			||||||
  rncp ~/path/to/file.tgz 256320d405d6d525d1e9
 | 
					  rncp ~/path/to/file.tgz 73cbd378bb0286ed11a707c13447bb1e
 | 
				
			||||||
 | 
					
 | 
				
			||||||
You can specify as many allowed senders as needed, or complete disable authentication.
 | 
					You can specify as many allowed senders as needed, or complete disable authentication.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
@ -362,21 +362,21 @@ output.
 | 
				
			|||||||
 | 
					
 | 
				
			||||||
  # Run rnx on the listening system, specifying which identities
 | 
					  # Run rnx on the listening system, specifying which identities
 | 
				
			||||||
  # are allowed to execute commands
 | 
					  # are allowed to execute commands
 | 
				
			||||||
  rncp --listen -a 8111c4ff2968ab0c1286 -a 590256654482b4ba4038
 | 
					  rncp --listen -a 941bed5e228775e5a8079fc38b1ccf3f -a 1b03013c25f1c2ca068a4f080b844a10
 | 
				
			||||||
 | 
					
 | 
				
			||||||
  # From another system, run a command 
 | 
					  # From another system, run a command 
 | 
				
			||||||
  rnx ad9a4c9da60089d41c29 "cat /proc/cpuinfo"
 | 
					  rnx 7a55144adf826958a9529a3bcf08b149 "cat /proc/cpuinfo"
 | 
				
			||||||
 | 
					
 | 
				
			||||||
  # Or enter the interactive mode pseudo-shell
 | 
					  # Or enter the interactive mode pseudo-shell
 | 
				
			||||||
  rnx ad9a4c9da60089d41c29 -x
 | 
					  rnx 7a55144adf826958a9529a3bcf08b149 -x
 | 
				
			||||||
 | 
					
 | 
				
			||||||
  # The default identity file is stored in
 | 
					  # The default identity file is stored in
 | 
				
			||||||
  # ~/.reticulum/identities/rnx, but you can use
 | 
					  # ~/.reticulum/identities/rnx, but you can use
 | 
				
			||||||
  # another one, which will be created if it does
 | 
					  # another one, which will be created if it does
 | 
				
			||||||
  # not already exist
 | 
					  # not already exist
 | 
				
			||||||
  rnx ad9a4c9da60089d41c29 -i /path/to/identity
 | 
					  rnx 7a55144adf826958a9529a3bcf08b149 -i /path/to/identity -x
 | 
				
			||||||
 | 
					
 | 
				
			||||||
You can specify as many allowed senders as needed, or complete disable authentication.
 | 
					You can specify as many allowed senders as needed, or completely disable authentication.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
.. code:: text
 | 
					.. code:: text
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
				
			|||||||
@ -50,7 +50,7 @@ What does Reticulum Offer?
 | 
				
			|||||||
 | 
					
 | 
				
			||||||
  * Low cost of keeping links open at only 0.62 bits per second
 | 
					  * Low cost of keeping links open at only 0.62 bits per second
 | 
				
			||||||
 | 
					
 | 
				
			||||||
* Reliable and efficient transfer of arbritrary amounts of data
 | 
					* Reliable and efficient transfer of arbitrary amounts of data
 | 
				
			||||||
 | 
					
 | 
				
			||||||
  * Reticulum can handle a few bytes of data or files of many gigabytes
 | 
					  * Reticulum can handle a few bytes of data or files of many gigabytes
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
				
			|||||||
@ -1,6 +1,6 @@
 | 
				
			|||||||
var DOCUMENTATION_OPTIONS = {
 | 
					var DOCUMENTATION_OPTIONS = {
 | 
				
			||||||
    URL_ROOT: document.getElementById("documentation_options").getAttribute('data-url_root'),
 | 
					    URL_ROOT: document.getElementById("documentation_options").getAttribute('data-url_root'),
 | 
				
			||||||
    VERSION: '0.3.8 beta',
 | 
					    VERSION: '0.3.9 beta',
 | 
				
			||||||
    LANGUAGE: 'None',
 | 
					    LANGUAGE: 'None',
 | 
				
			||||||
    COLLAPSE_INDEX: false,
 | 
					    COLLAPSE_INDEX: false,
 | 
				
			||||||
    BUILDER: 'html',
 | 
					    BUILDER: 'html',
 | 
				
			||||||
 | 
				
			|||||||
@ -5,7 +5,7 @@
 | 
				
			|||||||
  <head>
 | 
					  <head>
 | 
				
			||||||
    <meta charset="utf-8" />
 | 
					    <meta charset="utf-8" />
 | 
				
			||||||
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
 | 
					    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
 | 
				
			||||||
    <title>Code Examples — Reticulum Network Stack 0.3.8 beta documentation</title>
 | 
					    <title>Code Examples — Reticulum Network Stack 0.3.9 beta documentation</title>
 | 
				
			||||||
    <link rel="stylesheet" type="text/css" href="_static/pygments.css" />
 | 
					    <link rel="stylesheet" type="text/css" href="_static/pygments.css" />
 | 
				
			||||||
    <link rel="stylesheet" type="text/css" href="_static/classic.css" />
 | 
					    <link rel="stylesheet" type="text/css" href="_static/classic.css" />
 | 
				
			||||||
    
 | 
					    
 | 
				
			||||||
@ -31,7 +31,7 @@
 | 
				
			|||||||
        <li class="right" >
 | 
					        <li class="right" >
 | 
				
			||||||
          <a href="reference.html" title="API Reference"
 | 
					          <a href="reference.html" title="API Reference"
 | 
				
			||||||
             accesskey="P">previous</a> |</li>
 | 
					             accesskey="P">previous</a> |</li>
 | 
				
			||||||
        <li class="nav-item nav-item-0"><a href="index.html">Reticulum Network Stack 0.3.8 beta documentation</a> »</li>
 | 
					        <li class="nav-item nav-item-0"><a href="index.html">Reticulum Network Stack 0.3.9 beta documentation</a> »</li>
 | 
				
			||||||
        <li class="nav-item nav-item-this"><a href="">Code Examples</a></li> 
 | 
					        <li class="nav-item nav-item-this"><a href="">Code Examples</a></li> 
 | 
				
			||||||
      </ul>
 | 
					      </ul>
 | 
				
			||||||
    </div>  
 | 
					    </div>  
 | 
				
			||||||
@ -2394,7 +2394,7 @@ interface to efficiently pass files of any size over a Reticulum <a class="refer
 | 
				
			|||||||
        <li class="right" >
 | 
					        <li class="right" >
 | 
				
			||||||
          <a href="reference.html" title="API Reference"
 | 
					          <a href="reference.html" title="API Reference"
 | 
				
			||||||
             >previous</a> |</li>
 | 
					             >previous</a> |</li>
 | 
				
			||||||
        <li class="nav-item nav-item-0"><a href="index.html">Reticulum Network Stack 0.3.8 beta documentation</a> »</li>
 | 
					        <li class="nav-item nav-item-0"><a href="index.html">Reticulum Network Stack 0.3.9 beta documentation</a> »</li>
 | 
				
			||||||
        <li class="nav-item nav-item-this"><a href="">Code Examples</a></li> 
 | 
					        <li class="nav-item nav-item-this"><a href="">Code Examples</a></li> 
 | 
				
			||||||
      </ul>
 | 
					      </ul>
 | 
				
			||||||
    </div>
 | 
					    </div>
 | 
				
			||||||
 | 
				
			|||||||
@ -5,7 +5,7 @@
 | 
				
			|||||||
  <head>
 | 
					  <head>
 | 
				
			||||||
    <meta charset="utf-8" />
 | 
					    <meta charset="utf-8" />
 | 
				
			||||||
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
 | 
					    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
 | 
				
			||||||
    <title>Index — Reticulum Network Stack 0.3.8 beta documentation</title>
 | 
					    <title>Index — Reticulum Network Stack 0.3.9 beta documentation</title>
 | 
				
			||||||
    <link rel="stylesheet" type="text/css" href="_static/pygments.css" />
 | 
					    <link rel="stylesheet" type="text/css" href="_static/pygments.css" />
 | 
				
			||||||
    <link rel="stylesheet" type="text/css" href="_static/classic.css" />
 | 
					    <link rel="stylesheet" type="text/css" href="_static/classic.css" />
 | 
				
			||||||
    
 | 
					    
 | 
				
			||||||
@ -23,7 +23,7 @@
 | 
				
			|||||||
        <li class="right" style="margin-right: 10px">
 | 
					        <li class="right" style="margin-right: 10px">
 | 
				
			||||||
          <a href="#" title="General Index"
 | 
					          <a href="#" title="General Index"
 | 
				
			||||||
             accesskey="I">index</a></li>
 | 
					             accesskey="I">index</a></li>
 | 
				
			||||||
        <li class="nav-item nav-item-0"><a href="index.html">Reticulum Network Stack 0.3.8 beta documentation</a> »</li>
 | 
					        <li class="nav-item nav-item-0"><a href="index.html">Reticulum Network Stack 0.3.9 beta documentation</a> »</li>
 | 
				
			||||||
        <li class="nav-item nav-item-this"><a href="">Index</a></li> 
 | 
					        <li class="nav-item nav-item-this"><a href="">Index</a></li> 
 | 
				
			||||||
      </ul>
 | 
					      </ul>
 | 
				
			||||||
    </div>  
 | 
					    </div>  
 | 
				
			||||||
@ -440,7 +440,7 @@
 | 
				
			|||||||
        <li class="right" style="margin-right: 10px">
 | 
					        <li class="right" style="margin-right: 10px">
 | 
				
			||||||
          <a href="#" title="General Index"
 | 
					          <a href="#" title="General Index"
 | 
				
			||||||
             >index</a></li>
 | 
					             >index</a></li>
 | 
				
			||||||
        <li class="nav-item nav-item-0"><a href="index.html">Reticulum Network Stack 0.3.8 beta documentation</a> »</li>
 | 
					        <li class="nav-item nav-item-0"><a href="index.html">Reticulum Network Stack 0.3.9 beta documentation</a> »</li>
 | 
				
			||||||
        <li class="nav-item nav-item-this"><a href="">Index</a></li> 
 | 
					        <li class="nav-item nav-item-this"><a href="">Index</a></li> 
 | 
				
			||||||
      </ul>
 | 
					      </ul>
 | 
				
			||||||
    </div>
 | 
					    </div>
 | 
				
			||||||
 | 
				
			|||||||
@ -5,7 +5,7 @@
 | 
				
			|||||||
  <head>
 | 
					  <head>
 | 
				
			||||||
    <meta charset="utf-8" />
 | 
					    <meta charset="utf-8" />
 | 
				
			||||||
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
 | 
					    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
 | 
				
			||||||
    <title>Getting Started Fast — Reticulum Network Stack 0.3.8 beta documentation</title>
 | 
					    <title>Getting Started Fast — Reticulum Network Stack 0.3.9 beta documentation</title>
 | 
				
			||||||
    <link rel="stylesheet" type="text/css" href="_static/pygments.css" />
 | 
					    <link rel="stylesheet" type="text/css" href="_static/pygments.css" />
 | 
				
			||||||
    <link rel="stylesheet" type="text/css" href="_static/classic.css" />
 | 
					    <link rel="stylesheet" type="text/css" href="_static/classic.css" />
 | 
				
			||||||
    
 | 
					    
 | 
				
			||||||
@ -31,7 +31,7 @@
 | 
				
			|||||||
        <li class="right" >
 | 
					        <li class="right" >
 | 
				
			||||||
          <a href="whatis.html" title="What is Reticulum?"
 | 
					          <a href="whatis.html" title="What is Reticulum?"
 | 
				
			||||||
             accesskey="P">previous</a> |</li>
 | 
					             accesskey="P">previous</a> |</li>
 | 
				
			||||||
        <li class="nav-item nav-item-0"><a href="index.html">Reticulum Network Stack 0.3.8 beta documentation</a> »</li>
 | 
					        <li class="nav-item nav-item-0"><a href="index.html">Reticulum Network Stack 0.3.9 beta documentation</a> »</li>
 | 
				
			||||||
        <li class="nav-item nav-item-this"><a href="">Getting Started Fast</a></li> 
 | 
					        <li class="nav-item nav-item-this"><a href="">Getting Started Fast</a></li> 
 | 
				
			||||||
      </ul>
 | 
					      </ul>
 | 
				
			||||||
    </div>  
 | 
					    </div>  
 | 
				
			||||||
@ -164,20 +164,25 @@ easier setup, use TCP.</p>
 | 
				
			|||||||
<h2>Connect to the Public Testnet<a class="headerlink" href="#connect-to-the-public-testnet" title="Permalink to this headline">¶</a></h2>
 | 
					<h2>Connect to the Public Testnet<a class="headerlink" href="#connect-to-the-public-testnet" title="Permalink to this headline">¶</a></h2>
 | 
				
			||||||
<p>An experimental public testnet has been made accessible over both I2P and TCP. You can join it
 | 
					<p>An experimental public testnet has been made accessible over both I2P and TCP. You can join it
 | 
				
			||||||
by adding one of the following interfaces to your <code class="docutils literal notranslate"><span class="pre">.reticulum/config</span></code> file:</p>
 | 
					by adding one of the following interfaces to your <code class="docutils literal notranslate"><span class="pre">.reticulum/config</span></code> file:</p>
 | 
				
			||||||
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="c1"># For connecting over TCP/IP:</span>
 | 
					<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="c1"># TCP/IP interface to the Dublin hub</span>
 | 
				
			||||||
<span class="p">[[</span><span class="n">RNS</span> <span class="n">Testnet</span> <span class="n">Frankfurt</span><span class="p">]]</span>
 | 
					<span class="p">[[</span><span class="n">RNS</span> <span class="n">Testnet</span> <span class="n">Dublin</span><span class="p">]]</span>
 | 
				
			||||||
  <span class="nb">type</span> <span class="o">=</span> <span class="n">TCPClientInterface</span>
 | 
					  <span class="nb">type</span> <span class="o">=</span> <span class="n">TCPClientInterface</span>
 | 
				
			||||||
  <span class="n">interface_enabled</span> <span class="o">=</span> <span class="n">yes</span>
 | 
					  <span class="n">enabled</span> <span class="o">=</span> <span class="n">yes</span>
 | 
				
			||||||
  <span class="n">outgoing</span> <span class="o">=</span> <span class="kc">True</span>
 | 
					  <span class="n">target_host</span> <span class="o">=</span> <span class="n">dublin</span><span class="o">.</span><span class="n">connect</span><span class="o">.</span><span class="n">reticulum</span><span class="o">.</span><span class="n">network</span>
 | 
				
			||||||
  <span class="n">target_host</span> <span class="o">=</span> <span class="n">frankfurt</span><span class="o">.</span><span class="n">rns</span><span class="o">.</span><span class="n">unsigned</span><span class="o">.</span><span class="n">io</span>
 | 
					 | 
				
			||||||
  <span class="n">target_port</span> <span class="o">=</span> <span class="mi">4965</span>
 | 
					  <span class="n">target_port</span> <span class="o">=</span> <span class="mi">4965</span>
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					<span class="c1"># TCP/IP interface to the Frankfurt hub</span>
 | 
				
			||||||
 | 
					<span class="p">[[</span><span class="n">RNS</span> <span class="n">Testnet</span> <span class="n">Dublin</span><span class="p">]]</span>
 | 
				
			||||||
 | 
					  <span class="nb">type</span> <span class="o">=</span> <span class="n">TCPClientInterface</span>
 | 
				
			||||||
 | 
					  <span class="n">enabled</span> <span class="o">=</span> <span class="n">yes</span>
 | 
				
			||||||
 | 
					  <span class="n">target_host</span> <span class="o">=</span> <span class="n">frankfurt</span><span class="o">.</span><span class="n">connect</span><span class="o">.</span><span class="n">reticulum</span><span class="o">.</span><span class="n">network</span>
 | 
				
			||||||
 | 
					  <span class="n">target_port</span> <span class="o">=</span> <span class="mi">5377</span>
 | 
				
			||||||
 | 
					
 | 
				
			||||||
<span class="c1"># For connecting over I2P:</span>
 | 
					<span class="c1"># Interface to I2P hub A</span>
 | 
				
			||||||
<span class="p">[[</span><span class="n">RNS</span> <span class="n">Testnet</span> <span class="n">I2P</span> <span class="n">Node</span> <span class="n">A</span><span class="p">]]</span>
 | 
					<span class="p">[[</span><span class="n">RNS</span> <span class="n">Testnet</span> <span class="n">I2P</span> <span class="n">Hub</span> <span class="n">A</span><span class="p">]]</span>
 | 
				
			||||||
  <span class="nb">type</span> <span class="o">=</span> <span class="n">I2PInterface</span>
 | 
					  <span class="nb">type</span> <span class="o">=</span> <span class="n">I2PInterface</span>
 | 
				
			||||||
  <span class="n">interface_enabled</span> <span class="o">=</span> <span class="n">yes</span>
 | 
					  <span class="n">enabled</span> <span class="o">=</span> <span class="n">yes</span>
 | 
				
			||||||
  <span class="n">peers</span> <span class="o">=</span> <span class="n">ykzlw5ujbaqc2xkec4cpvgyxj257wcrmmgkuxqmqcur7cq3w3lha</span><span class="o">.</span><span class="n">b32</span><span class="o">.</span><span class="n">i2p</span>
 | 
					  <span class="n">peers</span> <span class="o">=</span> <span class="n">uxg5kubabakh3jtnvsipingbr5574dle7bubvip7llfvwx2tgrua</span><span class="o">.</span><span class="n">b32</span><span class="o">.</span><span class="n">i2p</span>
 | 
				
			||||||
</pre></div>
 | 
					</pre></div>
 | 
				
			||||||
</div>
 | 
					</div>
 | 
				
			||||||
<p>Many other Reticulum instances are connecting to this testnet, and you can also join it
 | 
					<p>Many other Reticulum instances are connecting to this testnet, and you can also join it
 | 
				
			||||||
@ -414,7 +419,7 @@ section of this manual.</p>
 | 
				
			|||||||
        <li class="right" >
 | 
					        <li class="right" >
 | 
				
			||||||
          <a href="whatis.html" title="What is Reticulum?"
 | 
					          <a href="whatis.html" title="What is Reticulum?"
 | 
				
			||||||
             >previous</a> |</li>
 | 
					             >previous</a> |</li>
 | 
				
			||||||
        <li class="nav-item nav-item-0"><a href="index.html">Reticulum Network Stack 0.3.8 beta documentation</a> »</li>
 | 
					        <li class="nav-item nav-item-0"><a href="index.html">Reticulum Network Stack 0.3.9 beta documentation</a> »</li>
 | 
				
			||||||
        <li class="nav-item nav-item-this"><a href="">Getting Started Fast</a></li> 
 | 
					        <li class="nav-item nav-item-this"><a href="">Getting Started Fast</a></li> 
 | 
				
			||||||
      </ul>
 | 
					      </ul>
 | 
				
			||||||
    </div>
 | 
					    </div>
 | 
				
			||||||
 | 
				
			|||||||
@ -5,7 +5,7 @@
 | 
				
			|||||||
  <head>
 | 
					  <head>
 | 
				
			||||||
    <meta charset="utf-8" />
 | 
					    <meta charset="utf-8" />
 | 
				
			||||||
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
 | 
					    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
 | 
				
			||||||
    <title>Communications Hardware — Reticulum Network Stack 0.3.8 beta documentation</title>
 | 
					    <title>Communications Hardware — Reticulum Network Stack 0.3.9 beta documentation</title>
 | 
				
			||||||
    <link rel="stylesheet" type="text/css" href="_static/pygments.css" />
 | 
					    <link rel="stylesheet" type="text/css" href="_static/pygments.css" />
 | 
				
			||||||
    <link rel="stylesheet" type="text/css" href="_static/classic.css" />
 | 
					    <link rel="stylesheet" type="text/css" href="_static/classic.css" />
 | 
				
			||||||
    
 | 
					    
 | 
				
			||||||
@ -31,7 +31,7 @@
 | 
				
			|||||||
        <li class="right" >
 | 
					        <li class="right" >
 | 
				
			||||||
          <a href="understanding.html" title="Understanding Reticulum"
 | 
					          <a href="understanding.html" title="Understanding Reticulum"
 | 
				
			||||||
             accesskey="P">previous</a> |</li>
 | 
					             accesskey="P">previous</a> |</li>
 | 
				
			||||||
        <li class="nav-item nav-item-0"><a href="index.html">Reticulum Network Stack 0.3.8 beta documentation</a> »</li>
 | 
					        <li class="nav-item nav-item-0"><a href="index.html">Reticulum Network Stack 0.3.9 beta documentation</a> »</li>
 | 
				
			||||||
        <li class="nav-item nav-item-this"><a href="">Communications Hardware</a></li> 
 | 
					        <li class="nav-item nav-item-this"><a href="">Communications Hardware</a></li> 
 | 
				
			||||||
      </ul>
 | 
					      </ul>
 | 
				
			||||||
    </div>  
 | 
					    </div>  
 | 
				
			||||||
@ -307,7 +307,7 @@ connectivity for client devices.</p>
 | 
				
			|||||||
        <li class="right" >
 | 
					        <li class="right" >
 | 
				
			||||||
          <a href="understanding.html" title="Understanding Reticulum"
 | 
					          <a href="understanding.html" title="Understanding Reticulum"
 | 
				
			||||||
             >previous</a> |</li>
 | 
					             >previous</a> |</li>
 | 
				
			||||||
        <li class="nav-item nav-item-0"><a href="index.html">Reticulum Network Stack 0.3.8 beta documentation</a> »</li>
 | 
					        <li class="nav-item nav-item-0"><a href="index.html">Reticulum Network Stack 0.3.9 beta documentation</a> »</li>
 | 
				
			||||||
        <li class="nav-item nav-item-this"><a href="">Communications Hardware</a></li> 
 | 
					        <li class="nav-item nav-item-this"><a href="">Communications Hardware</a></li> 
 | 
				
			||||||
      </ul>
 | 
					      </ul>
 | 
				
			||||||
    </div>
 | 
					    </div>
 | 
				
			||||||
 | 
				
			|||||||
@ -5,7 +5,7 @@
 | 
				
			|||||||
  <head>
 | 
					  <head>
 | 
				
			||||||
    <meta charset="utf-8" />
 | 
					    <meta charset="utf-8" />
 | 
				
			||||||
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
 | 
					    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
 | 
				
			||||||
    <title>Reticulum Network Stack Manual — Reticulum Network Stack 0.3.8 beta documentation</title>
 | 
					    <title>Reticulum Network Stack Manual — Reticulum Network Stack 0.3.9 beta documentation</title>
 | 
				
			||||||
    <link rel="stylesheet" type="text/css" href="_static/pygments.css" />
 | 
					    <link rel="stylesheet" type="text/css" href="_static/pygments.css" />
 | 
				
			||||||
    <link rel="stylesheet" type="text/css" href="_static/classic.css" />
 | 
					    <link rel="stylesheet" type="text/css" href="_static/classic.css" />
 | 
				
			||||||
    
 | 
					    
 | 
				
			||||||
@ -27,7 +27,7 @@
 | 
				
			|||||||
        <li class="right" >
 | 
					        <li class="right" >
 | 
				
			||||||
          <a href="whatis.html" title="What is Reticulum?"
 | 
					          <a href="whatis.html" title="What is Reticulum?"
 | 
				
			||||||
             accesskey="N">next</a> |</li>
 | 
					             accesskey="N">next</a> |</li>
 | 
				
			||||||
        <li class="nav-item nav-item-0"><a href="#">Reticulum Network Stack 0.3.8 beta documentation</a> »</li>
 | 
					        <li class="nav-item nav-item-0"><a href="#">Reticulum Network Stack 0.3.9 beta documentation</a> »</li>
 | 
				
			||||||
        <li class="nav-item nav-item-this"><a href="">Reticulum Network Stack Manual</a></li> 
 | 
					        <li class="nav-item nav-item-this"><a href="">Reticulum Network Stack Manual</a></li> 
 | 
				
			||||||
      </ul>
 | 
					      </ul>
 | 
				
			||||||
    </div>  
 | 
					    </div>  
 | 
				
			||||||
@ -246,7 +246,7 @@ to participate in the development of Reticulum itself.</p>
 | 
				
			|||||||
        <li class="right" >
 | 
					        <li class="right" >
 | 
				
			||||||
          <a href="whatis.html" title="What is Reticulum?"
 | 
					          <a href="whatis.html" title="What is Reticulum?"
 | 
				
			||||||
             >next</a> |</li>
 | 
					             >next</a> |</li>
 | 
				
			||||||
        <li class="nav-item nav-item-0"><a href="#">Reticulum Network Stack 0.3.8 beta documentation</a> »</li>
 | 
					        <li class="nav-item nav-item-0"><a href="#">Reticulum Network Stack 0.3.9 beta documentation</a> »</li>
 | 
				
			||||||
        <li class="nav-item nav-item-this"><a href="">Reticulum Network Stack Manual</a></li> 
 | 
					        <li class="nav-item nav-item-this"><a href="">Reticulum Network Stack Manual</a></li> 
 | 
				
			||||||
      </ul>
 | 
					      </ul>
 | 
				
			||||||
    </div>
 | 
					    </div>
 | 
				
			||||||
 | 
				
			|||||||
@ -5,7 +5,7 @@
 | 
				
			|||||||
  <head>
 | 
					  <head>
 | 
				
			||||||
    <meta charset="utf-8" />
 | 
					    <meta charset="utf-8" />
 | 
				
			||||||
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
 | 
					    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
 | 
				
			||||||
    <title>Supported Interfaces — Reticulum Network Stack 0.3.8 beta documentation</title>
 | 
					    <title>Supported Interfaces — Reticulum Network Stack 0.3.9 beta documentation</title>
 | 
				
			||||||
    <link rel="stylesheet" type="text/css" href="_static/pygments.css" />
 | 
					    <link rel="stylesheet" type="text/css" href="_static/pygments.css" />
 | 
				
			||||||
    <link rel="stylesheet" type="text/css" href="_static/classic.css" />
 | 
					    <link rel="stylesheet" type="text/css" href="_static/classic.css" />
 | 
				
			||||||
    
 | 
					    
 | 
				
			||||||
@ -31,7 +31,7 @@
 | 
				
			|||||||
        <li class="right" >
 | 
					        <li class="right" >
 | 
				
			||||||
          <a href="hardware.html" title="Communications Hardware"
 | 
					          <a href="hardware.html" title="Communications Hardware"
 | 
				
			||||||
             accesskey="P">previous</a> |</li>
 | 
					             accesskey="P">previous</a> |</li>
 | 
				
			||||||
        <li class="nav-item nav-item-0"><a href="index.html">Reticulum Network Stack 0.3.8 beta documentation</a> »</li>
 | 
					        <li class="nav-item nav-item-0"><a href="index.html">Reticulum Network Stack 0.3.9 beta documentation</a> »</li>
 | 
				
			||||||
        <li class="nav-item nav-item-this"><a href="">Supported Interfaces</a></li> 
 | 
					        <li class="nav-item nav-item-this"><a href="">Supported Interfaces</a></li> 
 | 
				
			||||||
      </ul>
 | 
					      </ul>
 | 
				
			||||||
    </div>  
 | 
					    </div>  
 | 
				
			||||||
@ -811,7 +811,7 @@ that a large span of network types can seamlessly <em>co-exist</em> and intercon
 | 
				
			|||||||
        <li class="right" >
 | 
					        <li class="right" >
 | 
				
			||||||
          <a href="hardware.html" title="Communications Hardware"
 | 
					          <a href="hardware.html" title="Communications Hardware"
 | 
				
			||||||
             >previous</a> |</li>
 | 
					             >previous</a> |</li>
 | 
				
			||||||
        <li class="nav-item nav-item-0"><a href="index.html">Reticulum Network Stack 0.3.8 beta documentation</a> »</li>
 | 
					        <li class="nav-item nav-item-0"><a href="index.html">Reticulum Network Stack 0.3.9 beta documentation</a> »</li>
 | 
				
			||||||
        <li class="nav-item nav-item-this"><a href="">Supported Interfaces</a></li> 
 | 
					        <li class="nav-item nav-item-this"><a href="">Supported Interfaces</a></li> 
 | 
				
			||||||
      </ul>
 | 
					      </ul>
 | 
				
			||||||
    </div>
 | 
					    </div>
 | 
				
			||||||
 | 
				
			|||||||
@ -5,7 +5,7 @@
 | 
				
			|||||||
  <head>
 | 
					  <head>
 | 
				
			||||||
    <meta charset="utf-8" />
 | 
					    <meta charset="utf-8" />
 | 
				
			||||||
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
 | 
					    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
 | 
				
			||||||
    <title>Building Networks — Reticulum Network Stack 0.3.8 beta documentation</title>
 | 
					    <title>Building Networks — Reticulum Network Stack 0.3.9 beta documentation</title>
 | 
				
			||||||
    <link rel="stylesheet" type="text/css" href="_static/pygments.css" />
 | 
					    <link rel="stylesheet" type="text/css" href="_static/pygments.css" />
 | 
				
			||||||
    <link rel="stylesheet" type="text/css" href="_static/classic.css" />
 | 
					    <link rel="stylesheet" type="text/css" href="_static/classic.css" />
 | 
				
			||||||
    
 | 
					    
 | 
				
			||||||
@ -16,8 +16,8 @@
 | 
				
			|||||||
    
 | 
					    
 | 
				
			||||||
    <link rel="index" title="Index" href="genindex.html" />
 | 
					    <link rel="index" title="Index" href="genindex.html" />
 | 
				
			||||||
    <link rel="search" title="Search" href="search.html" />
 | 
					    <link rel="search" title="Search" href="search.html" />
 | 
				
			||||||
    <link rel="next" title="Supported Interfaces" href="interfaces.html" />
 | 
					    <link rel="next" title="API Reference" href="reference.html" />
 | 
				
			||||||
    <link rel="prev" title="Using Reticulum on Your System" href="using.html" /> 
 | 
					    <link rel="prev" title="Supported Interfaces" href="interfaces.html" /> 
 | 
				
			||||||
  </head><body>
 | 
					  </head><body>
 | 
				
			||||||
    <div class="related" role="navigation" aria-label="related navigation">
 | 
					    <div class="related" role="navigation" aria-label="related navigation">
 | 
				
			||||||
      <h3>Navigation</h3>
 | 
					      <h3>Navigation</h3>
 | 
				
			||||||
@ -26,12 +26,12 @@
 | 
				
			|||||||
          <a href="genindex.html" title="General Index"
 | 
					          <a href="genindex.html" title="General Index"
 | 
				
			||||||
             accesskey="I">index</a></li>
 | 
					             accesskey="I">index</a></li>
 | 
				
			||||||
        <li class="right" >
 | 
					        <li class="right" >
 | 
				
			||||||
          <a href="interfaces.html" title="Supported Interfaces"
 | 
					          <a href="reference.html" title="API Reference"
 | 
				
			||||||
             accesskey="N">next</a> |</li>
 | 
					             accesskey="N">next</a> |</li>
 | 
				
			||||||
        <li class="right" >
 | 
					        <li class="right" >
 | 
				
			||||||
          <a href="using.html" title="Using Reticulum on Your System"
 | 
					          <a href="interfaces.html" title="Supported Interfaces"
 | 
				
			||||||
             accesskey="P">previous</a> |</li>
 | 
					             accesskey="P">previous</a> |</li>
 | 
				
			||||||
        <li class="nav-item nav-item-0"><a href="index.html">Reticulum Network Stack 0.3.8 beta documentation</a> »</li>
 | 
					        <li class="nav-item nav-item-0"><a href="index.html">Reticulum Network Stack 0.3.9 beta documentation</a> »</li>
 | 
				
			||||||
        <li class="nav-item nav-item-this"><a href="">Building Networks</a></li> 
 | 
					        <li class="nav-item nav-item-this"><a href="">Building Networks</a></li> 
 | 
				
			||||||
      </ul>
 | 
					      </ul>
 | 
				
			||||||
    </div>  
 | 
					    </div>  
 | 
				
			||||||
@ -234,11 +234,11 @@ connected outliers are now an integral part of the network.</p>
 | 
				
			|||||||
</ul>
 | 
					</ul>
 | 
				
			||||||
 | 
					
 | 
				
			||||||
  <h4>Previous topic</h4>
 | 
					  <h4>Previous topic</h4>
 | 
				
			||||||
  <p class="topless"><a href="using.html"
 | 
					 | 
				
			||||||
                        title="previous chapter">Using Reticulum on Your System</a></p>
 | 
					 | 
				
			||||||
  <h4>Next topic</h4>
 | 
					 | 
				
			||||||
  <p class="topless"><a href="interfaces.html"
 | 
					  <p class="topless"><a href="interfaces.html"
 | 
				
			||||||
                        title="next chapter">Supported Interfaces</a></p>
 | 
					                        title="previous chapter">Supported Interfaces</a></p>
 | 
				
			||||||
 | 
					  <h4>Next topic</h4>
 | 
				
			||||||
 | 
					  <p class="topless"><a href="reference.html"
 | 
				
			||||||
 | 
					                        title="next chapter">API Reference</a></p>
 | 
				
			||||||
  <div role="note" aria-label="source link">
 | 
					  <div role="note" aria-label="source link">
 | 
				
			||||||
    <h3>This Page</h3>
 | 
					    <h3>This Page</h3>
 | 
				
			||||||
    <ul class="this-page-menu">
 | 
					    <ul class="this-page-menu">
 | 
				
			||||||
@ -267,12 +267,12 @@ connected outliers are now an integral part of the network.</p>
 | 
				
			|||||||
          <a href="genindex.html" title="General Index"
 | 
					          <a href="genindex.html" title="General Index"
 | 
				
			||||||
             >index</a></li>
 | 
					             >index</a></li>
 | 
				
			||||||
        <li class="right" >
 | 
					        <li class="right" >
 | 
				
			||||||
          <a href="interfaces.html" title="Supported Interfaces"
 | 
					          <a href="reference.html" title="API Reference"
 | 
				
			||||||
             >next</a> |</li>
 | 
					             >next</a> |</li>
 | 
				
			||||||
        <li class="right" >
 | 
					        <li class="right" >
 | 
				
			||||||
          <a href="using.html" title="Using Reticulum on Your System"
 | 
					          <a href="interfaces.html" title="Supported Interfaces"
 | 
				
			||||||
             >previous</a> |</li>
 | 
					             >previous</a> |</li>
 | 
				
			||||||
        <li class="nav-item nav-item-0"><a href="index.html">Reticulum Network Stack 0.3.8 beta documentation</a> »</li>
 | 
					        <li class="nav-item nav-item-0"><a href="index.html">Reticulum Network Stack 0.3.9 beta documentation</a> »</li>
 | 
				
			||||||
        <li class="nav-item nav-item-this"><a href="">Building Networks</a></li> 
 | 
					        <li class="nav-item nav-item-this"><a href="">Building Networks</a></li> 
 | 
				
			||||||
      </ul>
 | 
					      </ul>
 | 
				
			||||||
    </div>
 | 
					    </div>
 | 
				
			||||||
 | 
				
			|||||||
@ -5,7 +5,7 @@
 | 
				
			|||||||
  <head>
 | 
					  <head>
 | 
				
			||||||
    <meta charset="utf-8" />
 | 
					    <meta charset="utf-8" />
 | 
				
			||||||
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
 | 
					    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
 | 
				
			||||||
    <title>API Reference — Reticulum Network Stack 0.3.8 beta documentation</title>
 | 
					    <title>API Reference — Reticulum Network Stack 0.3.9 beta documentation</title>
 | 
				
			||||||
    <link rel="stylesheet" type="text/css" href="_static/pygments.css" />
 | 
					    <link rel="stylesheet" type="text/css" href="_static/pygments.css" />
 | 
				
			||||||
    <link rel="stylesheet" type="text/css" href="_static/classic.css" />
 | 
					    <link rel="stylesheet" type="text/css" href="_static/classic.css" />
 | 
				
			||||||
    
 | 
					    
 | 
				
			||||||
@ -31,7 +31,7 @@
 | 
				
			|||||||
        <li class="right" >
 | 
					        <li class="right" >
 | 
				
			||||||
          <a href="networks.html" title="Building Networks"
 | 
					          <a href="networks.html" title="Building Networks"
 | 
				
			||||||
             accesskey="P">previous</a> |</li>
 | 
					             accesskey="P">previous</a> |</li>
 | 
				
			||||||
        <li class="nav-item nav-item-0"><a href="index.html">Reticulum Network Stack 0.3.8 beta documentation</a> »</li>
 | 
					        <li class="nav-item nav-item-0"><a href="index.html">Reticulum Network Stack 0.3.9 beta documentation</a> »</li>
 | 
				
			||||||
        <li class="nav-item nav-item-this"><a href="">API Reference</a></li> 
 | 
					        <li class="nav-item nav-item-this"><a href="">API Reference</a></li> 
 | 
				
			||||||
      </ul>
 | 
					      </ul>
 | 
				
			||||||
    </div>  
 | 
					    </div>  
 | 
				
			||||||
@ -1366,7 +1366,7 @@ will announce it.</p>
 | 
				
			|||||||
        <li class="right" >
 | 
					        <li class="right" >
 | 
				
			||||||
          <a href="networks.html" title="Building Networks"
 | 
					          <a href="networks.html" title="Building Networks"
 | 
				
			||||||
             >previous</a> |</li>
 | 
					             >previous</a> |</li>
 | 
				
			||||||
        <li class="nav-item nav-item-0"><a href="index.html">Reticulum Network Stack 0.3.8 beta documentation</a> »</li>
 | 
					        <li class="nav-item nav-item-0"><a href="index.html">Reticulum Network Stack 0.3.9 beta documentation</a> »</li>
 | 
				
			||||||
        <li class="nav-item nav-item-this"><a href="">API Reference</a></li> 
 | 
					        <li class="nav-item nav-item-this"><a href="">API Reference</a></li> 
 | 
				
			||||||
      </ul>
 | 
					      </ul>
 | 
				
			||||||
    </div>
 | 
					    </div>
 | 
				
			||||||
 | 
				
			|||||||
@ -5,7 +5,7 @@
 | 
				
			|||||||
  <head>
 | 
					  <head>
 | 
				
			||||||
    <meta charset="utf-8" />
 | 
					    <meta charset="utf-8" />
 | 
				
			||||||
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
 | 
					    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
 | 
				
			||||||
    <title>Search — Reticulum Network Stack 0.3.8 beta documentation</title>
 | 
					    <title>Search — Reticulum Network Stack 0.3.9 beta documentation</title>
 | 
				
			||||||
    <link rel="stylesheet" type="text/css" href="_static/pygments.css" />
 | 
					    <link rel="stylesheet" type="text/css" href="_static/pygments.css" />
 | 
				
			||||||
    <link rel="stylesheet" type="text/css" href="_static/classic.css" />
 | 
					    <link rel="stylesheet" type="text/css" href="_static/classic.css" />
 | 
				
			||||||
    
 | 
					    
 | 
				
			||||||
@ -29,7 +29,7 @@
 | 
				
			|||||||
        <li class="right" style="margin-right: 10px">
 | 
					        <li class="right" style="margin-right: 10px">
 | 
				
			||||||
          <a href="genindex.html" title="General Index"
 | 
					          <a href="genindex.html" title="General Index"
 | 
				
			||||||
             accesskey="I">index</a></li>
 | 
					             accesskey="I">index</a></li>
 | 
				
			||||||
        <li class="nav-item nav-item-0"><a href="index.html">Reticulum Network Stack 0.3.8 beta documentation</a> »</li>
 | 
					        <li class="nav-item nav-item-0"><a href="index.html">Reticulum Network Stack 0.3.9 beta documentation</a> »</li>
 | 
				
			||||||
        <li class="nav-item nav-item-this"><a href="">Search</a></li> 
 | 
					        <li class="nav-item nav-item-this"><a href="">Search</a></li> 
 | 
				
			||||||
      </ul>
 | 
					      </ul>
 | 
				
			||||||
    </div>  
 | 
					    </div>  
 | 
				
			||||||
@ -85,7 +85,7 @@
 | 
				
			|||||||
        <li class="right" style="margin-right: 10px">
 | 
					        <li class="right" style="margin-right: 10px">
 | 
				
			||||||
          <a href="genindex.html" title="General Index"
 | 
					          <a href="genindex.html" title="General Index"
 | 
				
			||||||
             >index</a></li>
 | 
					             >index</a></li>
 | 
				
			||||||
        <li class="nav-item nav-item-0"><a href="index.html">Reticulum Network Stack 0.3.8 beta documentation</a> »</li>
 | 
					        <li class="nav-item nav-item-0"><a href="index.html">Reticulum Network Stack 0.3.9 beta documentation</a> »</li>
 | 
				
			||||||
        <li class="nav-item nav-item-this"><a href="">Search</a></li> 
 | 
					        <li class="nav-item nav-item-this"><a href="">Search</a></li> 
 | 
				
			||||||
      </ul>
 | 
					      </ul>
 | 
				
			||||||
    </div>
 | 
					    </div>
 | 
				
			||||||
 | 
				
			|||||||
										
											
												File diff suppressed because one or more lines are too long
											
										
									
								
							@ -5,7 +5,7 @@
 | 
				
			|||||||
  <head>
 | 
					  <head>
 | 
				
			||||||
    <meta charset="utf-8" />
 | 
					    <meta charset="utf-8" />
 | 
				
			||||||
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
 | 
					    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
 | 
				
			||||||
    <title>Support Reticulum — Reticulum Network Stack 0.3.8 beta documentation</title>
 | 
					    <title>Support Reticulum — Reticulum Network Stack 0.3.9 beta documentation</title>
 | 
				
			||||||
    <link rel="stylesheet" type="text/css" href="_static/pygments.css" />
 | 
					    <link rel="stylesheet" type="text/css" href="_static/pygments.css" />
 | 
				
			||||||
    <link rel="stylesheet" type="text/css" href="_static/classic.css" />
 | 
					    <link rel="stylesheet" type="text/css" href="_static/classic.css" />
 | 
				
			||||||
    
 | 
					    
 | 
				
			||||||
@ -27,7 +27,7 @@
 | 
				
			|||||||
        <li class="right" >
 | 
					        <li class="right" >
 | 
				
			||||||
          <a href="examples.html" title="Code Examples"
 | 
					          <a href="examples.html" title="Code Examples"
 | 
				
			||||||
             accesskey="P">previous</a> |</li>
 | 
					             accesskey="P">previous</a> |</li>
 | 
				
			||||||
        <li class="nav-item nav-item-0"><a href="index.html">Reticulum Network Stack 0.3.8 beta documentation</a> »</li>
 | 
					        <li class="nav-item nav-item-0"><a href="index.html">Reticulum Network Stack 0.3.9 beta documentation</a> »</li>
 | 
				
			||||||
        <li class="nav-item nav-item-this"><a href="">Support Reticulum</a></li> 
 | 
					        <li class="nav-item nav-item-this"><a href="">Support Reticulum</a></li> 
 | 
				
			||||||
      </ul>
 | 
					      </ul>
 | 
				
			||||||
    </div>  
 | 
					    </div>  
 | 
				
			||||||
@ -45,9 +45,7 @@ systems by donating, providing feedback and contributing code and learning resou
 | 
				
			|||||||
<h2>Donations<a class="headerlink" href="#donations" title="Permalink to this headline">¶</a></h2>
 | 
					<h2>Donations<a class="headerlink" href="#donations" title="Permalink to this headline">¶</a></h2>
 | 
				
			||||||
<p>Donations are gratefully accepted via the following channels:</p>
 | 
					<p>Donations are gratefully accepted via the following channels:</p>
 | 
				
			||||||
<div class="highlight-text notranslate"><div class="highlight"><pre><span></span>Monero:
 | 
					<div class="highlight-text notranslate"><div class="highlight"><pre><span></span>Monero:
 | 
				
			||||||
84FpY1QbxHcgdseePYNmhTHcrgMX4nFf
 | 
					84FpY1QbxHcgdseePYNmhTHcrgMX4nFfBYtz2GKYToqHVVhJp8Eaw1Z1EedRnKD19b3B8NiLCGVxzKV17UMmmeEsCrPyA5w
 | 
				
			||||||
BYtz2GKYToqHVVhJp8Eaw1Z1EedRnKD1
 | 
					 | 
				
			||||||
9b3B8NiLCGVxzKV17UMmmeEsCrPyA5w
 | 
					 | 
				
			||||||
 | 
					
 | 
				
			||||||
Ethereum:
 | 
					Ethereum:
 | 
				
			||||||
0x81F7B979fEa6134bA9FD5c701b3501A2e61E897a
 | 
					0x81F7B979fEa6134bA9FD5c701b3501A2e61E897a
 | 
				
			||||||
@ -127,7 +125,7 @@ report issues, suggest functionality and contribute code to Reticulum.</p>
 | 
				
			|||||||
        <li class="right" >
 | 
					        <li class="right" >
 | 
				
			||||||
          <a href="examples.html" title="Code Examples"
 | 
					          <a href="examples.html" title="Code Examples"
 | 
				
			||||||
             >previous</a> |</li>
 | 
					             >previous</a> |</li>
 | 
				
			||||||
        <li class="nav-item nav-item-0"><a href="index.html">Reticulum Network Stack 0.3.8 beta documentation</a> »</li>
 | 
					        <li class="nav-item nav-item-0"><a href="index.html">Reticulum Network Stack 0.3.9 beta documentation</a> »</li>
 | 
				
			||||||
        <li class="nav-item nav-item-this"><a href="">Support Reticulum</a></li> 
 | 
					        <li class="nav-item nav-item-this"><a href="">Support Reticulum</a></li> 
 | 
				
			||||||
      </ul>
 | 
					      </ul>
 | 
				
			||||||
    </div>
 | 
					    </div>
 | 
				
			||||||
 | 
				
			|||||||
@ -5,7 +5,7 @@
 | 
				
			|||||||
  <head>
 | 
					  <head>
 | 
				
			||||||
    <meta charset="utf-8" />
 | 
					    <meta charset="utf-8" />
 | 
				
			||||||
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
 | 
					    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
 | 
				
			||||||
    <title>Understanding Reticulum — Reticulum Network Stack 0.3.8 beta documentation</title>
 | 
					    <title>Understanding Reticulum — Reticulum Network Stack 0.3.9 beta documentation</title>
 | 
				
			||||||
    <link rel="stylesheet" type="text/css" href="_static/pygments.css" />
 | 
					    <link rel="stylesheet" type="text/css" href="_static/pygments.css" />
 | 
				
			||||||
    <link rel="stylesheet" type="text/css" href="_static/classic.css" />
 | 
					    <link rel="stylesheet" type="text/css" href="_static/classic.css" />
 | 
				
			||||||
    
 | 
					    
 | 
				
			||||||
@ -16,8 +16,8 @@
 | 
				
			|||||||
    
 | 
					    
 | 
				
			||||||
    <link rel="index" title="Index" href="genindex.html" />
 | 
					    <link rel="index" title="Index" href="genindex.html" />
 | 
				
			||||||
    <link rel="search" title="Search" href="search.html" />
 | 
					    <link rel="search" title="Search" href="search.html" />
 | 
				
			||||||
    <link rel="next" title="API Reference" href="reference.html" />
 | 
					    <link rel="next" title="Communications Hardware" href="hardware.html" />
 | 
				
			||||||
    <link rel="prev" title="Communications Hardware" href="hardware.html" /> 
 | 
					    <link rel="prev" title="Using Reticulum on Your System" href="using.html" /> 
 | 
				
			||||||
  </head><body>
 | 
					  </head><body>
 | 
				
			||||||
    <div class="related" role="navigation" aria-label="related navigation">
 | 
					    <div class="related" role="navigation" aria-label="related navigation">
 | 
				
			||||||
      <h3>Navigation</h3>
 | 
					      <h3>Navigation</h3>
 | 
				
			||||||
@ -26,12 +26,12 @@
 | 
				
			|||||||
          <a href="genindex.html" title="General Index"
 | 
					          <a href="genindex.html" title="General Index"
 | 
				
			||||||
             accesskey="I">index</a></li>
 | 
					             accesskey="I">index</a></li>
 | 
				
			||||||
        <li class="right" >
 | 
					        <li class="right" >
 | 
				
			||||||
          <a href="reference.html" title="API Reference"
 | 
					          <a href="hardware.html" title="Communications Hardware"
 | 
				
			||||||
             accesskey="N">next</a> |</li>
 | 
					             accesskey="N">next</a> |</li>
 | 
				
			||||||
        <li class="right" >
 | 
					        <li class="right" >
 | 
				
			||||||
          <a href="hardware.html" title="Communications Hardware"
 | 
					          <a href="using.html" title="Using Reticulum on Your System"
 | 
				
			||||||
             accesskey="P">previous</a> |</li>
 | 
					             accesskey="P">previous</a> |</li>
 | 
				
			||||||
        <li class="nav-item nav-item-0"><a href="index.html">Reticulum Network Stack 0.3.8 beta documentation</a> »</li>
 | 
					        <li class="nav-item nav-item-0"><a href="index.html">Reticulum Network Stack 0.3.9 beta documentation</a> »</li>
 | 
				
			||||||
        <li class="nav-item nav-item-this"><a href="">Understanding Reticulum</a></li> 
 | 
					        <li class="nav-item nav-item-this"><a href="">Understanding Reticulum</a></li> 
 | 
				
			||||||
      </ul>
 | 
					      </ul>
 | 
				
			||||||
    </div>  
 | 
					    </div>  
 | 
				
			||||||
@ -165,26 +165,26 @@ to be transported over multiple hops in a complex network to reach the recipient
 | 
				
			|||||||
Reticulum uses the singular concept of <em>destinations</em>. Any application using Reticulum as it’s
 | 
					Reticulum uses the singular concept of <em>destinations</em>. Any application using Reticulum as it’s
 | 
				
			||||||
networking stack will need to create one or more destinations to receive data, and know the
 | 
					networking stack will need to create one or more destinations to receive data, and know the
 | 
				
			||||||
destinations it needs to send data to.</p>
 | 
					destinations it needs to send data to.</p>
 | 
				
			||||||
<p>All destinations in Reticulum are represented as a 10 byte hash, derived from truncating a full
 | 
					<p>All destinations in Reticulum are _represented_ as a 16 byte hash. This hash is derived from truncating a full
 | 
				
			||||||
SHA-256 hash of identifying characteristics of the destination. To users, the destination addresses
 | 
					SHA-256 hash of identifying characteristics of the destination. To users, the destination addresses
 | 
				
			||||||
will be displayed as 10 bytes in hexadecimal representation, as in the following example: <code class="docutils literal notranslate"><span class="pre"><80e29bf7cccaf31431b3></span></code>.</p>
 | 
					will be displayed as 16 hexadecimal bytes, like this example: <code class="docutils literal notranslate"><span class="pre"><13425ec15b621c1d928589718000d814></span></code>.</p>
 | 
				
			||||||
<p>The truncation size of 10 bytes (80 bits) for destinations has been choosen as a reasonable tradeoff between address space
 | 
					<p>The truncation size of 16 bytes (128 bits) for destinations has been choosen as a reasonable tradeoff
 | 
				
			||||||
 | 
					between address space
 | 
				
			||||||
and packet overhead. The address space accomodated by this size can support many billions of
 | 
					and packet overhead. The address space accomodated by this size can support many billions of
 | 
				
			||||||
simultaneously active devices on the same network, while keeping packet overhead low, which is
 | 
					simultaneously active devices on the same network, while keeping packet overhead low, which is
 | 
				
			||||||
essential on low-bandwidth networks. In the very unlikely case that this address space nears
 | 
					essential on low-bandwidth networks. In the very unlikely case that this address space nears
 | 
				
			||||||
congestion, a one-line code change can upgrade the Reticulum address space all the way up to 256
 | 
					congestion, a one-line code change can upgrade the Reticulum address space all the way up to 256
 | 
				
			||||||
bits, ensuring the Reticulum address space could potentially support galactic-scale networks.
 | 
					bits, ensuring the Reticulum address space could potentially support galactic-scale networks.
 | 
				
			||||||
This is obviusly complete and ridiculous over-allocation, and as such, the current 80 bits should
 | 
					This is obviusly complete and ridiculous over-allocation, and as such, the current 128 bits should
 | 
				
			||||||
be sufficient, even far into the future.</p>
 | 
					be sufficient, even far into the future.</p>
 | 
				
			||||||
<p>By default Reticulum encrypts all data using elliptic curve cryptography. Any packet sent to a
 | 
					<p>By default Reticulum encrypts all data using elliptic curve cryptography. Any packet sent to a
 | 
				
			||||||
destination is encrypted with a derived ephemeral key. Reticulum can also set up an encrypted
 | 
					destination is encrypted with a derived ephemeral key. Reticulum can also set up an encrypted
 | 
				
			||||||
channel to a destination with <em>Forward Secrecy</em> and <em>Initiator Anonymity</em> using a elliptic
 | 
					channel to a destination, called a <em>Link</em>. Both data sent over Links and single packets offer
 | 
				
			||||||
curve cryptography and ephemeral keys derived from a Diffie Hellman exchange on Curve25519. In
 | 
					<em>Forward Secrecy</em> and <em>Initiator Anonymity</em>, by using an Elliptic Curve Diffie Hellman key exchange
 | 
				
			||||||
Reticulum terminology, this is called a <em>Link</em>. The multi-hop transport, coordination, verification
 | 
					on Curve25519 to derive ephemeral keys. The multi-hop transport, coordination, verification
 | 
				
			||||||
and reliability layers are fully autonomous and also based on elliptic curve cryptography.</p>
 | 
					and reliability layers are fully autonomous and also based on elliptic curve cryptography.</p>
 | 
				
			||||||
<p>Reticulum also offers symmetric key encryption for group-oriented communications, as well as
 | 
					<p>Reticulum also offers symmetric key encryption for group-oriented communications, as well as
 | 
				
			||||||
unencrypted packets for broadcast purposes, or situations where you need the communication to be in
 | 
					unencrypted packets for local broadcast purposes.</p>
 | 
				
			||||||
plain text.</p>
 | 
					 | 
				
			||||||
<p>Reticulum can connect to a variety of interfaces such as radio modems, data radios and serial ports,
 | 
					<p>Reticulum can connect to a variety of interfaces such as radio modems, data radios and serial ports,
 | 
				
			||||||
and offers the possibility to easily tunnel Reticulum traffic over IP links such as the Internet or
 | 
					and offers the possibility to easily tunnel Reticulum traffic over IP links such as the Internet or
 | 
				
			||||||
private IP networks.</p>
 | 
					private IP networks.</p>
 | 
				
			||||||
@ -234,7 +234,7 @@ out requests and responses, large data transfers and more.</p>
 | 
				
			|||||||
<div class="section" id="destination-naming">
 | 
					<div class="section" id="destination-naming">
 | 
				
			||||||
<span id="understanding-destinationnaming"></span><h4>Destination Naming<a class="headerlink" href="#destination-naming" title="Permalink to this headline">¶</a></h4>
 | 
					<span id="understanding-destinationnaming"></span><h4>Destination Naming<a class="headerlink" href="#destination-naming" title="Permalink to this headline">¶</a></h4>
 | 
				
			||||||
<p>Destinations are created and named in an easy to understand dotted notation of <em>aspects</em>, and
 | 
					<p>Destinations are created and named in an easy to understand dotted notation of <em>aspects</em>, and
 | 
				
			||||||
represented on the network as a hash of this value. The hash is a SHA-256 truncated to 80 bits. The
 | 
					represented on the network as a hash of this value. The hash is a SHA-256 truncated to 128 bits. The
 | 
				
			||||||
top level aspect should always be a unique identifier for the application using the destination.
 | 
					top level aspect should always be a unique identifier for the application using the destination.
 | 
				
			||||||
The next levels of aspects can be defined in any way by the creator of the application.</p>
 | 
					The next levels of aspects can be defined in any way by the creator of the application.</p>
 | 
				
			||||||
<p>Aspects can be as long and as plentiful as required, and a resulting long destination name will not
 | 
					<p>Aspects can be as long and as plentiful as required, and a resulting long destination name will not
 | 
				
			||||||
@ -245,7 +245,7 @@ application name, a device type and measurement type, like this:</p>
 | 
				
			|||||||
aspects   : remotesensor, temperature
 | 
					aspects   : remotesensor, temperature
 | 
				
			||||||
 | 
					
 | 
				
			||||||
full name : environmentlogger.remotesensor.temperature
 | 
					full name : environmentlogger.remotesensor.temperature
 | 
				
			||||||
hash      : fa7ddfab5213f916dea
 | 
					hash      : 4faf1b2e0a077e6a9d92fa051f256038
 | 
				
			||||||
</pre></div>
 | 
					</pre></div>
 | 
				
			||||||
</div>
 | 
					</div>
 | 
				
			||||||
<p>For the <em>single</em> destination, Reticulum will automatically append the associated public key as a
 | 
					<p>For the <em>single</em> destination, Reticulum will automatically append the associated public key as a
 | 
				
			||||||
@ -737,7 +737,7 @@ pass onto the network.</p>
 | 
				
			|||||||
 | 
					
 | 
				
			||||||
A Reticulum packet is composed of the following fields:
 | 
					A Reticulum packet is composed of the following fields:
 | 
				
			||||||
 | 
					
 | 
				
			||||||
[HEADER 2 bytes] [ADDRESSES 10/20 bytes] [CONTEXT 1 byte] [DATA 0-477 bytes]
 | 
					[HEADER 2 bytes] [ADDRESSES 16/32 bytes] [CONTEXT 1 byte] [DATA 0-465 bytes]
 | 
				
			||||||
 | 
					
 | 
				
			||||||
* The HEADER field is 2 bytes long.
 | 
					* The HEADER field is 2 bytes long.
 | 
				
			||||||
  * Byte 1: [IFAC Flag], [Header Type], [Propagation Type], [Destination Type] and [Packet Type]
 | 
					  * Byte 1: [IFAC Flag], [Header Type], [Propagation Type], [Destination Type] and [Packet Type]
 | 
				
			||||||
@ -749,15 +749,15 @@ A Reticulum packet is composed of the following fields:
 | 
				
			|||||||
    capabilities and configuration.
 | 
					    capabilities and configuration.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
* The ADDRESSES field contains either 1 or 2 addresses.
 | 
					* The ADDRESSES field contains either 1 or 2 addresses.
 | 
				
			||||||
  * Each address is 10 bytes long.
 | 
					  * Each address is 16 bytes long.
 | 
				
			||||||
  * The Header Type flag in the HEADER field determines
 | 
					  * The Header Type flag in the HEADER field determines
 | 
				
			||||||
    whether the ADDRESSES field contains 1 or 2 addresses.
 | 
					    whether the ADDRESSES field contains 1 or 2 addresses.
 | 
				
			||||||
  * Addresses are Reticulum hashes truncated to 10 bytes.
 | 
					  * Addresses are SHA-256 hashes truncated to 16 bytes.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
* The CONTEXT field is 1 byte.
 | 
					* The CONTEXT field is 1 byte.
 | 
				
			||||||
  * It is used by Reticulum to determine packet context.
 | 
					  * It is used by Reticulum to determine packet context.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
* The DATA field is between 0 and 477 bytes.
 | 
					* The DATA field is between 0 and 465 bytes.
 | 
				
			||||||
  * It contains the packets data payload.
 | 
					  * It contains the packets data payload.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
IFAC Flag
 | 
					IFAC Flag
 | 
				
			||||||
@ -768,8 +768,8 @@ authenticated    1  Interface authentication is included in packet
 | 
				
			|||||||
 | 
					
 | 
				
			||||||
Header Types
 | 
					Header Types
 | 
				
			||||||
-----------------
 | 
					-----------------
 | 
				
			||||||
type 1           0  Two byte header, one 10 byte address field
 | 
					type 1           0  Two byte header, one 16 byte address field
 | 
				
			||||||
type 2           1  Two byte header, two 10 byte address fields
 | 
					type 2           1  Two byte header, two 16 byte address fields
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					
 | 
				
			||||||
Propagation Types
 | 
					Propagation Types
 | 
				
			||||||
@ -801,7 +801,7 @@ proof           11
 | 
				
			|||||||
   HEADER FIELD           DESTINATION FIELDS            CONTEXT FIELD  DATA FIELD
 | 
					   HEADER FIELD           DESTINATION FIELDS            CONTEXT FIELD  DATA FIELD
 | 
				
			||||||
 _______|_______   ________________|________________   ________|______   __|_
 | 
					 _______|_______   ________________|________________   ________|______   __|_
 | 
				
			||||||
|               | |                                 | |               | |    |
 | 
					|               | |                                 | |               | |    |
 | 
				
			||||||
01010000 00000100 [HASH1, 10 bytes] [HASH2, 10 bytes] [CONTEXT, 1 byte] [DATA]
 | 
					01010000 00000100 [HASH1, 16 bytes] [HASH2, 16 bytes] [CONTEXT, 1 byte] [DATA]
 | 
				
			||||||
|| | | |    |
 | 
					|| | | |    |
 | 
				
			||||||
|| | | |    +-- Hops             = 4
 | 
					|| | | |    +-- Hops             = 4
 | 
				
			||||||
|| | | +------- Packet Type      = DATA
 | 
					|| | | +------- Packet Type      = DATA
 | 
				
			||||||
@ -816,7 +816,7 @@ proof           11
 | 
				
			|||||||
   HEADER FIELD   DESTINATION FIELD   CONTEXT FIELD  DATA FIELD
 | 
					   HEADER FIELD   DESTINATION FIELD   CONTEXT FIELD  DATA FIELD
 | 
				
			||||||
 _______|_______   _______|_______   ________|______   __|_
 | 
					 _______|_______   _______|_______   ________|______   __|_
 | 
				
			||||||
|               | |               | |               | |    |
 | 
					|               | |               | |               | |    |
 | 
				
			||||||
00000000 00000111 [HASH1, 10 bytes] [CONTEXT, 1 byte] [DATA]
 | 
					00000000 00000111 [HASH1, 16 bytes] [CONTEXT, 1 byte] [DATA]
 | 
				
			||||||
|| | | |    |
 | 
					|| | | |    |
 | 
				
			||||||
|| | | |    +-- Hops             = 0
 | 
					|| | | |    +-- Hops             = 0
 | 
				
			||||||
|| | | +------- Packet Type      = DATA
 | 
					|| | | +------- Packet Type      = DATA
 | 
				
			||||||
@ -831,7 +831,7 @@ proof           11
 | 
				
			|||||||
   HEADER FIELD     IFAC FIELD    DESTINATION FIELD   CONTEXT FIELD  DATA FIELD
 | 
					   HEADER FIELD     IFAC FIELD    DESTINATION FIELD   CONTEXT FIELD  DATA FIELD
 | 
				
			||||||
 _______|_______   ______|______   _______|_______   ________|______   __|_
 | 
					 _______|_______   ______|______   _______|_______   ________|______   __|_
 | 
				
			||||||
|               | |             | |               | |               | |    |
 | 
					|               | |             | |               | |               | |    |
 | 
				
			||||||
10000000 00000111 [IFAC, N bytes] [HASH1, 10 bytes] [CONTEXT, 1 byte] [DATA]
 | 
					10000000 00000111 [IFAC, N bytes] [HASH1, 16 bytes] [CONTEXT, 1 byte] [DATA]
 | 
				
			||||||
|| | | |    |
 | 
					|| | | |    |
 | 
				
			||||||
|| | | |    +-- Hops             = 0
 | 
					|| | | |    +-- Hops             = 0
 | 
				
			||||||
|| | | +------- Packet Type      = DATA
 | 
					|| | | +------- Packet Type      = DATA
 | 
				
			||||||
@ -956,11 +956,11 @@ those risks are acceptable to you.</p>
 | 
				
			|||||||
</ul>
 | 
					</ul>
 | 
				
			||||||
 | 
					
 | 
				
			||||||
  <h4>Previous topic</h4>
 | 
					  <h4>Previous topic</h4>
 | 
				
			||||||
  <p class="topless"><a href="hardware.html"
 | 
					  <p class="topless"><a href="using.html"
 | 
				
			||||||
                        title="previous chapter">Communications Hardware</a></p>
 | 
					                        title="previous chapter">Using Reticulum on Your System</a></p>
 | 
				
			||||||
  <h4>Next topic</h4>
 | 
					  <h4>Next topic</h4>
 | 
				
			||||||
  <p class="topless"><a href="reference.html"
 | 
					  <p class="topless"><a href="hardware.html"
 | 
				
			||||||
                        title="next chapter">API Reference</a></p>
 | 
					                        title="next chapter">Communications Hardware</a></p>
 | 
				
			||||||
  <div role="note" aria-label="source link">
 | 
					  <div role="note" aria-label="source link">
 | 
				
			||||||
    <h3>This Page</h3>
 | 
					    <h3>This Page</h3>
 | 
				
			||||||
    <ul class="this-page-menu">
 | 
					    <ul class="this-page-menu">
 | 
				
			||||||
@ -989,12 +989,12 @@ those risks are acceptable to you.</p>
 | 
				
			|||||||
          <a href="genindex.html" title="General Index"
 | 
					          <a href="genindex.html" title="General Index"
 | 
				
			||||||
             >index</a></li>
 | 
					             >index</a></li>
 | 
				
			||||||
        <li class="right" >
 | 
					        <li class="right" >
 | 
				
			||||||
          <a href="reference.html" title="API Reference"
 | 
					          <a href="hardware.html" title="Communications Hardware"
 | 
				
			||||||
             >next</a> |</li>
 | 
					             >next</a> |</li>
 | 
				
			||||||
        <li class="right" >
 | 
					        <li class="right" >
 | 
				
			||||||
          <a href="hardware.html" title="Communications Hardware"
 | 
					          <a href="using.html" title="Using Reticulum on Your System"
 | 
				
			||||||
             >previous</a> |</li>
 | 
					             >previous</a> |</li>
 | 
				
			||||||
        <li class="nav-item nav-item-0"><a href="index.html">Reticulum Network Stack 0.3.8 beta documentation</a> »</li>
 | 
					        <li class="nav-item nav-item-0"><a href="index.html">Reticulum Network Stack 0.3.9 beta documentation</a> »</li>
 | 
				
			||||||
        <li class="nav-item nav-item-this"><a href="">Understanding Reticulum</a></li> 
 | 
					        <li class="nav-item nav-item-this"><a href="">Understanding Reticulum</a></li> 
 | 
				
			||||||
      </ul>
 | 
					      </ul>
 | 
				
			||||||
    </div>
 | 
					    </div>
 | 
				
			||||||
 | 
				
			|||||||
@ -5,7 +5,7 @@
 | 
				
			|||||||
  <head>
 | 
					  <head>
 | 
				
			||||||
    <meta charset="utf-8" />
 | 
					    <meta charset="utf-8" />
 | 
				
			||||||
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
 | 
					    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
 | 
				
			||||||
    <title>Using Reticulum on Your System — Reticulum Network Stack 0.3.8 beta documentation</title>
 | 
					    <title>Using Reticulum on Your System — Reticulum Network Stack 0.3.9 beta documentation</title>
 | 
				
			||||||
    <link rel="stylesheet" type="text/css" href="_static/pygments.css" />
 | 
					    <link rel="stylesheet" type="text/css" href="_static/pygments.css" />
 | 
				
			||||||
    <link rel="stylesheet" type="text/css" href="_static/classic.css" />
 | 
					    <link rel="stylesheet" type="text/css" href="_static/classic.css" />
 | 
				
			||||||
    
 | 
					    
 | 
				
			||||||
@ -16,7 +16,7 @@
 | 
				
			|||||||
    
 | 
					    
 | 
				
			||||||
    <link rel="index" title="Index" href="genindex.html" />
 | 
					    <link rel="index" title="Index" href="genindex.html" />
 | 
				
			||||||
    <link rel="search" title="Search" href="search.html" />
 | 
					    <link rel="search" title="Search" href="search.html" />
 | 
				
			||||||
    <link rel="next" title="Building Networks" href="networks.html" />
 | 
					    <link rel="next" title="Understanding Reticulum" href="understanding.html" />
 | 
				
			||||||
    <link rel="prev" title="Getting Started Fast" href="gettingstartedfast.html" /> 
 | 
					    <link rel="prev" title="Getting Started Fast" href="gettingstartedfast.html" /> 
 | 
				
			||||||
  </head><body>
 | 
					  </head><body>
 | 
				
			||||||
    <div class="related" role="navigation" aria-label="related navigation">
 | 
					    <div class="related" role="navigation" aria-label="related navigation">
 | 
				
			||||||
@ -26,12 +26,12 @@
 | 
				
			|||||||
          <a href="genindex.html" title="General Index"
 | 
					          <a href="genindex.html" title="General Index"
 | 
				
			||||||
             accesskey="I">index</a></li>
 | 
					             accesskey="I">index</a></li>
 | 
				
			||||||
        <li class="right" >
 | 
					        <li class="right" >
 | 
				
			||||||
          <a href="networks.html" title="Building Networks"
 | 
					          <a href="understanding.html" title="Understanding Reticulum"
 | 
				
			||||||
             accesskey="N">next</a> |</li>
 | 
					             accesskey="N">next</a> |</li>
 | 
				
			||||||
        <li class="right" >
 | 
					        <li class="right" >
 | 
				
			||||||
          <a href="gettingstartedfast.html" title="Getting Started Fast"
 | 
					          <a href="gettingstartedfast.html" title="Getting Started Fast"
 | 
				
			||||||
             accesskey="P">previous</a> |</li>
 | 
					             accesskey="P">previous</a> |</li>
 | 
				
			||||||
        <li class="nav-item nav-item-0"><a href="index.html">Reticulum Network Stack 0.3.8 beta documentation</a> »</li>
 | 
					        <li class="nav-item nav-item-0"><a href="index.html">Reticulum Network Stack 0.3.9 beta documentation</a> »</li>
 | 
				
			||||||
        <li class="nav-item nav-item-this"><a href="">Using Reticulum on Your System</a></li> 
 | 
					        <li class="nav-item nav-item-this"><a href="">Using Reticulum on Your System</a></li> 
 | 
				
			||||||
      </ul>
 | 
					      </ul>
 | 
				
			||||||
    </div>  
 | 
					    </div>  
 | 
				
			||||||
@ -243,7 +243,7 @@ RNodeInterface[RNode UHF]
 | 
				
			|||||||
   Traffic : 8.49 KB↑
 | 
					   Traffic : 8.49 KB↑
 | 
				
			||||||
             9.23 KB↓
 | 
					             9.23 KB↓
 | 
				
			||||||
 | 
					
 | 
				
			||||||
Reticulum Transport Instance <5245a8efe1788c6a70e1> running
 | 
					Reticulum Transport Instance <5245a8efe1788c6a1cd36144a270e13b> running
 | 
				
			||||||
</pre></div>
 | 
					</pre></div>
 | 
				
			||||||
</div>
 | 
					</div>
 | 
				
			||||||
<div class="highlight-text notranslate"><div class="highlight"><pre><span></span>usage: rnstatus [-h] [--config CONFIG] [--version] [-a] [-v]
 | 
					<div class="highlight-text notranslate"><div class="highlight"><pre><span></span>usage: rnstatus [-h] [--config CONFIG] [--version] [-a] [-v]
 | 
				
			||||||
@ -264,10 +264,10 @@ optional arguments:
 | 
				
			|||||||
<p>With the <code class="docutils literal notranslate"><span class="pre">rnpath</span></code> utility, you can look up and view paths for
 | 
					<p>With the <code class="docutils literal notranslate"><span class="pre">rnpath</span></code> utility, you can look up and view paths for
 | 
				
			||||||
destinations on the Reticulum network.</p>
 | 
					destinations on the Reticulum network.</p>
 | 
				
			||||||
<div class="highlight-text notranslate"><div class="highlight"><pre><span></span># Run rnpath
 | 
					<div class="highlight-text notranslate"><div class="highlight"><pre><span></span># Run rnpath
 | 
				
			||||||
rnpath eca6f4e4dc26ae329e61
 | 
					rnpath c89b4da064bf66d280f0e4d8abfd9806
 | 
				
			||||||
 | 
					
 | 
				
			||||||
# Example output
 | 
					# Example output
 | 
				
			||||||
Path found, destination <eca6f4e4dc26ae329e61> is 4 hops away via <56b115c30cd386cad69c> on TCPInterface[Testnet/frankfurt.rns.unsigned.io:4965]
 | 
					Path found, destination <c89b4da064bf66d280f0e4d8abfd9806> is 4 hops away via <f53a1c4278e0726bb73fcc623d6ce763> on TCPInterface[Testnet/frankfurt.connect.reticulu.network:4965]
 | 
				
			||||||
</pre></div>
 | 
					</pre></div>
 | 
				
			||||||
</div>
 | 
					</div>
 | 
				
			||||||
<div class="highlight-text notranslate"><div class="highlight"><pre><span></span>usage: rnpath [-h] [--config CONFIG] [--version] [-t] [-r] [-d] [-D] [-w seconds] [-v] [destination]
 | 
					<div class="highlight-text notranslate"><div class="highlight"><pre><span></span>usage: rnpath [-h] [--config CONFIG] [--version] [-t] [-r] [-d] [-D] [-w seconds] [-v] [destination]
 | 
				
			||||||
@ -297,11 +297,11 @@ to the <code class="docutils literal notranslate"><span class="pre">ping</span><
 | 
				
			|||||||
specified destination is configured to send proofs for received packets. Many
 | 
					specified destination is configured to send proofs for received packets. Many
 | 
				
			||||||
destinations will not have this option enabled, and will not be probable.</p>
 | 
					destinations will not have this option enabled, and will not be probable.</p>
 | 
				
			||||||
<div class="highlight-text notranslate"><div class="highlight"><pre><span></span># Run rnprobe
 | 
					<div class="highlight-text notranslate"><div class="highlight"><pre><span></span># Run rnprobe
 | 
				
			||||||
rnprobe example_utilities.echo.request 9382f334de63217a4278
 | 
					rnprobe example_utilities.echo.request 2d03725b327348980d570f739a3a5708
 | 
				
			||||||
 | 
					
 | 
				
			||||||
# Example output
 | 
					# Example output
 | 
				
			||||||
Sent 16 byte probe to <9382f334de63217a4278>
 | 
					Sent 16 byte probe to <2d03725b327348980d570f739a3a5708>
 | 
				
			||||||
Valid reply received from <9382f334de63217a4278>
 | 
					Valid reply received from <2d03725b327348980d570f739a3a5708>
 | 
				
			||||||
Round-trip time is 38.469 milliseconds over 2 hops
 | 
					Round-trip time is 38.469 milliseconds over 2 hops
 | 
				
			||||||
</pre></div>
 | 
					</pre></div>
 | 
				
			||||||
</div>
 | 
					</div>
 | 
				
			||||||
@ -327,10 +327,10 @@ optional arguments:
 | 
				
			|||||||
files through Reticulum.</p>
 | 
					files through Reticulum.</p>
 | 
				
			||||||
<div class="highlight-text notranslate"><div class="highlight"><pre><span></span># Run rncp on the receiving system, specifying which identities
 | 
					<div class="highlight-text notranslate"><div class="highlight"><pre><span></span># Run rncp on the receiving system, specifying which identities
 | 
				
			||||||
# are allowed to send files
 | 
					# are allowed to send files
 | 
				
			||||||
rncp --receive -a 940ea3f9e1037d38758f -a e28d5aee4317c24a9041
 | 
					rncp --receive -a 1726dbad538775b5bf9b0ea25a4079c8 -a c50cc4e4f7838b6c31f60ab9032cbc62
 | 
				
			||||||
 | 
					
 | 
				
			||||||
# From another system, copy a file to the receiving system
 | 
					# From another system, copy a file to the receiving system
 | 
				
			||||||
rncp ~/path/to/file.tgz 256320d405d6d525d1e9
 | 
					rncp ~/path/to/file.tgz 73cbd378bb0286ed11a707c13447bb1e
 | 
				
			||||||
</pre></div>
 | 
					</pre></div>
 | 
				
			||||||
</div>
 | 
					</div>
 | 
				
			||||||
<p>You can specify as many allowed senders as needed, or complete disable authentication.</p>
 | 
					<p>You can specify as many allowed senders as needed, or complete disable authentication.</p>
 | 
				
			||||||
@ -365,22 +365,22 @@ execute commands on remote systems over Reticulum, and to view returned command
 | 
				
			|||||||
output.</p>
 | 
					output.</p>
 | 
				
			||||||
<div class="highlight-text notranslate"><div class="highlight"><pre><span></span># Run rnx on the listening system, specifying which identities
 | 
					<div class="highlight-text notranslate"><div class="highlight"><pre><span></span># Run rnx on the listening system, specifying which identities
 | 
				
			||||||
# are allowed to execute commands
 | 
					# are allowed to execute commands
 | 
				
			||||||
rncp --listen -a 8111c4ff2968ab0c1286 -a 590256654482b4ba4038
 | 
					rncp --listen -a 941bed5e228775e5a8079fc38b1ccf3f -a 1b03013c25f1c2ca068a4f080b844a10
 | 
				
			||||||
 | 
					
 | 
				
			||||||
# From another system, run a command
 | 
					# From another system, run a command
 | 
				
			||||||
rnx ad9a4c9da60089d41c29 "cat /proc/cpuinfo"
 | 
					rnx 7a55144adf826958a9529a3bcf08b149 "cat /proc/cpuinfo"
 | 
				
			||||||
 | 
					
 | 
				
			||||||
# Or enter the interactive mode pseudo-shell
 | 
					# Or enter the interactive mode pseudo-shell
 | 
				
			||||||
rnx ad9a4c9da60089d41c29 -x
 | 
					rnx 7a55144adf826958a9529a3bcf08b149 -x
 | 
				
			||||||
 | 
					
 | 
				
			||||||
# The default identity file is stored in
 | 
					# The default identity file is stored in
 | 
				
			||||||
# ~/.reticulum/identities/rnx, but you can use
 | 
					# ~/.reticulum/identities/rnx, but you can use
 | 
				
			||||||
# another one, which will be created if it does
 | 
					# another one, which will be created if it does
 | 
				
			||||||
# not already exist
 | 
					# not already exist
 | 
				
			||||||
rnx ad9a4c9da60089d41c29 -i /path/to/identity
 | 
					rnx 7a55144adf826958a9529a3bcf08b149 -i /path/to/identity -x
 | 
				
			||||||
</pre></div>
 | 
					</pre></div>
 | 
				
			||||||
</div>
 | 
					</div>
 | 
				
			||||||
<p>You can specify as many allowed senders as needed, or complete disable authentication.</p>
 | 
					<p>You can specify as many allowed senders as needed, or completely disable authentication.</p>
 | 
				
			||||||
<div class="highlight-text notranslate"><div class="highlight"><pre><span></span>usage: rnx [-h] [--config path] [-v] [-q] [-p] [-l] [-i identity] [-x] [-b] [-a allowed_hash] [-n] [-N] [-d] [-m] [-w seconds] [-W seconds] [--stdin STDIN] [--stdout STDOUT] [--stderr STDERR] [--version]
 | 
					<div class="highlight-text notranslate"><div class="highlight"><pre><span></span>usage: rnx [-h] [--config path] [-v] [-q] [-p] [-l] [-i identity] [-x] [-b] [-a allowed_hash] [-n] [-N] [-d] [-m] [-w seconds] [-W seconds] [--stdin STDIN] [--stdout STDOUT] [--stderr STDERR] [--version]
 | 
				
			||||||
           [destination] [command]
 | 
					           [destination] [command]
 | 
				
			||||||
 | 
					
 | 
				
			||||||
@ -528,8 +528,8 @@ WantedBy=multi-user.target
 | 
				
			|||||||
  <p class="topless"><a href="gettingstartedfast.html"
 | 
					  <p class="topless"><a href="gettingstartedfast.html"
 | 
				
			||||||
                        title="previous chapter">Getting Started Fast</a></p>
 | 
					                        title="previous chapter">Getting Started Fast</a></p>
 | 
				
			||||||
  <h4>Next topic</h4>
 | 
					  <h4>Next topic</h4>
 | 
				
			||||||
  <p class="topless"><a href="networks.html"
 | 
					  <p class="topless"><a href="understanding.html"
 | 
				
			||||||
                        title="next chapter">Building Networks</a></p>
 | 
					                        title="next chapter">Understanding Reticulum</a></p>
 | 
				
			||||||
  <div role="note" aria-label="source link">
 | 
					  <div role="note" aria-label="source link">
 | 
				
			||||||
    <h3>This Page</h3>
 | 
					    <h3>This Page</h3>
 | 
				
			||||||
    <ul class="this-page-menu">
 | 
					    <ul class="this-page-menu">
 | 
				
			||||||
@ -558,12 +558,12 @@ WantedBy=multi-user.target
 | 
				
			|||||||
          <a href="genindex.html" title="General Index"
 | 
					          <a href="genindex.html" title="General Index"
 | 
				
			||||||
             >index</a></li>
 | 
					             >index</a></li>
 | 
				
			||||||
        <li class="right" >
 | 
					        <li class="right" >
 | 
				
			||||||
          <a href="networks.html" title="Building Networks"
 | 
					          <a href="understanding.html" title="Understanding Reticulum"
 | 
				
			||||||
             >next</a> |</li>
 | 
					             >next</a> |</li>
 | 
				
			||||||
        <li class="right" >
 | 
					        <li class="right" >
 | 
				
			||||||
          <a href="gettingstartedfast.html" title="Getting Started Fast"
 | 
					          <a href="gettingstartedfast.html" title="Getting Started Fast"
 | 
				
			||||||
             >previous</a> |</li>
 | 
					             >previous</a> |</li>
 | 
				
			||||||
        <li class="nav-item nav-item-0"><a href="index.html">Reticulum Network Stack 0.3.8 beta documentation</a> »</li>
 | 
					        <li class="nav-item nav-item-0"><a href="index.html">Reticulum Network Stack 0.3.9 beta documentation</a> »</li>
 | 
				
			||||||
        <li class="nav-item nav-item-this"><a href="">Using Reticulum on Your System</a></li> 
 | 
					        <li class="nav-item nav-item-this"><a href="">Using Reticulum on Your System</a></li> 
 | 
				
			||||||
      </ul>
 | 
					      </ul>
 | 
				
			||||||
    </div>
 | 
					    </div>
 | 
				
			||||||
 | 
				
			|||||||
@ -5,7 +5,7 @@
 | 
				
			|||||||
  <head>
 | 
					  <head>
 | 
				
			||||||
    <meta charset="utf-8" />
 | 
					    <meta charset="utf-8" />
 | 
				
			||||||
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
 | 
					    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
 | 
				
			||||||
    <title>What is Reticulum? — Reticulum Network Stack 0.3.8 beta documentation</title>
 | 
					    <title>What is Reticulum? — Reticulum Network Stack 0.3.9 beta documentation</title>
 | 
				
			||||||
    <link rel="stylesheet" type="text/css" href="_static/pygments.css" />
 | 
					    <link rel="stylesheet" type="text/css" href="_static/pygments.css" />
 | 
				
			||||||
    <link rel="stylesheet" type="text/css" href="_static/classic.css" />
 | 
					    <link rel="stylesheet" type="text/css" href="_static/classic.css" />
 | 
				
			||||||
    
 | 
					    
 | 
				
			||||||
@ -31,7 +31,7 @@
 | 
				
			|||||||
        <li class="right" >
 | 
					        <li class="right" >
 | 
				
			||||||
          <a href="index.html" title="Reticulum Network Stack Manual"
 | 
					          <a href="index.html" title="Reticulum Network Stack Manual"
 | 
				
			||||||
             accesskey="P">previous</a> |</li>
 | 
					             accesskey="P">previous</a> |</li>
 | 
				
			||||||
        <li class="nav-item nav-item-0"><a href="index.html">Reticulum Network Stack 0.3.8 beta documentation</a> »</li>
 | 
					        <li class="nav-item nav-item-0"><a href="index.html">Reticulum Network Stack 0.3.9 beta documentation</a> »</li>
 | 
				
			||||||
        <li class="nav-item nav-item-this"><a href="">What is Reticulum?</a></li> 
 | 
					        <li class="nav-item nav-item-this"><a href="">What is Reticulum?</a></li> 
 | 
				
			||||||
      </ul>
 | 
					      </ul>
 | 
				
			||||||
    </div>  
 | 
					    </div>  
 | 
				
			||||||
@ -76,7 +76,7 @@
 | 
				
			|||||||
<li><p>Low cost of keeping links open at only 0.62 bits per second</p></li>
 | 
					<li><p>Low cost of keeping links open at only 0.62 bits per second</p></li>
 | 
				
			||||||
</ul>
 | 
					</ul>
 | 
				
			||||||
</li>
 | 
					</li>
 | 
				
			||||||
<li><p>Reliable and efficient transfer of arbritrary amounts of data</p>
 | 
					<li><p>Reliable and efficient transfer of arbitrary amounts of data</p>
 | 
				
			||||||
<ul>
 | 
					<ul>
 | 
				
			||||||
<li><p>Reticulum can handle a few bytes of data or files of many gigabytes</p></li>
 | 
					<li><p>Reticulum can handle a few bytes of data or files of many gigabytes</p></li>
 | 
				
			||||||
<li><p>Sequencing, transfer coordination and checksumming is automatic</p></li>
 | 
					<li><p>Sequencing, transfer coordination and checksumming is automatic</p></li>
 | 
				
			||||||
@ -211,7 +211,7 @@ network, and vice versa.</p>
 | 
				
			|||||||
        <li class="right" >
 | 
					        <li class="right" >
 | 
				
			||||||
          <a href="index.html" title="Reticulum Network Stack Manual"
 | 
					          <a href="index.html" title="Reticulum Network Stack Manual"
 | 
				
			||||||
             >previous</a> |</li>
 | 
					             >previous</a> |</li>
 | 
				
			||||||
        <li class="nav-item nav-item-0"><a href="index.html">Reticulum Network Stack 0.3.8 beta documentation</a> »</li>
 | 
					        <li class="nav-item nav-item-0"><a href="index.html">Reticulum Network Stack 0.3.9 beta documentation</a> »</li>
 | 
				
			||||||
        <li class="nav-item nav-item-this"><a href="">What is Reticulum?</a></li> 
 | 
					        <li class="nav-item nav-item-this"><a href="">What is Reticulum?</a></li> 
 | 
				
			||||||
      </ul>
 | 
					      </ul>
 | 
				
			||||||
    </div>
 | 
					    </div>
 | 
				
			||||||
 | 
				
			|||||||
		Loading…
	
	
			
			x
			
			
		
	
		Reference in New Issue
	
	Block a user