44 releases
0.2.27 | Jul 6, 2022 |
---|---|
0.2.25 | Apr 26, 2022 |
0.2.18 | Mar 23, 2022 |
0.1.12 | Sep 23, 2021 |
0.1.1 | Jun 30, 2021 |
#141 in #routing
Used in 5 crates
(3 directly)
35KB
821 lines
Melnet serves as Themelio's peer-to-peer network layer, based on a randomized topology and gossip. Peers are divided into servers, which have a publicly reachable address, and clients, which do not. It's based on a simple stdcode request-response protocol, where the only way to "push" a message is to send a request to a server. There is no multiplexing --- the whole thing works like HTTP/1.1. TCP connections are pretty cheap these days.
This also means that clients never receive notifications, and must poll servers.
The general way to use melnet
is as follows:
- Create a
NetState
. This holds the routing table, RPC verb handlers, and other "global" data. - If running as a server, register RPC verbs with
NetState::register_verb
and runNetState::run_server
in the background. - Use a
Client
, like the global one returned byg_client()
, to make RPC calls to other servers. Servers are simply identified by astd::net::SocketAddr
.
Dependencies
~14–48MB
~724K SLoC