inet256

README

INET256

A 256 bit address space for peer-to-peer hosts/applications.

The value proposition:

All you have to do to send messages to another process is know its address, which will never change.

All you have to do to recieve messages is generate a private, public key pair and connect to the INET256 daemon

The INET256 API and Address Spec: Spec

The architecture of the reference implementation: Architecture

Documentation for the daemon's config file: Daemon Config

Features

• Stable addresses derived from public keys
• Secure communication to other nodes in the network
• Best-effort delivery like IP or UDP. At-most-once delivery, unlike IP and UDP.
• Messages are never corrupted. If it gets there, it's correct.
• Easy to add/remove/change routing algorithms.
• Addresses are plentiful. Spawn a new node for each process. Every process gets its own address, no need for ports.
• Daemon can run without root or NET_ADMIN capability.
• IPv6 Portal for IPv6 over INET256. Exposed as a TUN device. (requires NET_ADMIN).
• Autopeering and transport address discovery help make peering easy.

Network Routing Protocols

This project separates a modern communication API from the routing algorithm that powers it. The autoconfiguring, distributed routing algorithms of the sort required are under active research, and we don't want to couple INET256 to any one algorithm as the state of the art could change rapidly.

Users are ultimately in control of which networks they participate in. Networks can be selected in the configuration file.

We are eager to add other protocols. Check out networks/beaconnet for an example of simple routing protocol. It's a good place to start.

Utilities/Applications

This project provides tools for using INET256 networks, some of which are not yet implemented

• IPv6 Portal (TUN Device). Similar to CJDNS and Yggdrasil.

• NAT Table from IPv6 to INET256. No port mappings, layer 3 only.

• DHCPv6 server which gives out addresses corresponding to virtual nodes.

• IPv4 VPN, declarative mappings from INET256 -> IPv4. similar to WireGuard.

• netcat. Send newline separated messages to other nodes: inet256 nc.

• echo. A server to echo messages back to the sender: inet256 echo.

Code Tour

• pkg/inet256 API definitions. Mostly things required by the spec.

• pkg/inet256srv The reference implementation of an INET256 Service.

• pkg/inet256d The daemon that manages setting up transports, autopeering, discovery, the actual INET256 service, and the gRPC API.

• pkg/inet256ipv6 Logic for bridging INET256 to IPv6. Includes the IPv6 portal.

• pkg/inet256test A test suite for Network implementations.

• networks/ Network implementations, routing logic is in these.

• client/ Client implementations, these connect to the daemon.

License

Code in this repository is by default licensed under the GPL as defined in LICENSE. Some of the sub-directories contain their own LICENSE files for the LGPL, or MPL as defined therein. That license applies to the sub-tree.

In summary: you should be able to import an INET256 client in a language of your choice and do whatever you want. But other than clients, the implementation is strongly copyleft.