11 releases

0.1.10 Feb 21, 2024
0.1.9 Jan 31, 2024
0.1.6 Dec 28, 2023
0.1.1 Nov 23, 2023

#1450 in Network programming

Download history 517/week @ 2023-12-31 455/week @ 2024-01-07 342/week @ 2024-01-14 609/week @ 2024-01-21 225/week @ 2024-01-28 154/week @ 2024-02-04 271/week @ 2024-02-11 397/week @ 2024-02-18 162/week @ 2024-02-25 70/week @ 2024-03-03 58/week @ 2024-03-10 50/week @ 2024-03-17 34/week @ 2024-03-24 76/week @ 2024-03-31 15/week @ 2024-04-07 29/week @ 2024-04-14

155 downloads per month
Used in 2 crates

MIT license

8KB

License: MIT Discord

Atm0s SDN: Global-scaled Ultra-low latency Decentralized SDN

A SAN I/O driven, open-source decentralized network infrastructure that can deliver high-quality data with minimal latency and efficient cost, similar to what Cloudflare achieves for their network.

For a deep dive into the technical aspects of network architecture, please refer to our Smart-Routing

Features

  • Blazingly fast, powered by Rust.
  • High availability by being fully distributed, with no central controller.
  • Multi-zone support, high scalability.
  • Definable Metric based Adaptive routing: cost, latency, .etc...
  • Fixed size routing table.
  • Designed with large scale built-in PubSub service.
  • Automatic Network orchestration and discovery (also can be manual).
  • High extendibility by using Network Service.
  • Built-in features: PubSub, KeyValue, VPN.
  • Cross platform: Linux, MacOs, Windows.

Architecture

Each node in the network is embedded with Geo-Location data inside its ID. A Node ID consists of multiple layers, and every node will have multiple routing tables, each corresponding to a layer.

  • Layer1: Geo1 Table (Zone level)
  • Layer2: Geo2 Table (Country level)
  • Layer3: Inner Geo Group Table (City level)
  • Layer4: Inner Group Index Table (DC level)

TODO: Graphics instead of bulletlist TODO: ARCHITECTURE.md with general information about: Project, System structure, Design philosophy, ...

Getting started

cargo add 8xff-sdn

Create a group chat application (Optional)

You can refer to the chat_example file here to get started on the basis of building an application for the network.

Demo group chat application

Running manual discovery multi nodes in a single device

Start node1:

cargo run --example chat_example -- --node-id 0

Start node2:

cargo run --example chat_example --node-id 1 --neighbour /p2p/0/ip4/127.0.0.1/udp/50000

In node1

> router
[Registry 0] local services: [] remote services: [], nexts []
[Table 0/3/0] slots: []
[Table 0/2/0] slots: []
[Table 0/1/0] slots: []
[Table 0/0/0] slots: [1]
# Join the room using join command with room id
> join 1

In node2

> join 1
> send hello

Now, node1 will receive a message from node2

Node 1 to room 1: hello

Available commands:

  • help: Show available commands and description
  • router: Print routing table
  • join: Join a room
  • send: Send a message to room
  • leave: Leave joined room

Running manual discovery multi nodes in multi devices

It can also start chat-example in multi nodes and connect over LAN or Internet

Start node1:

cargo run --example chat_example --node-id 0

Start node2:

cargo run --example chat_example --node-id 1 --neighbours /p2p/0/ip4/[IP_HERE]/udp/50000

Showcases

Contributing

The project is continuously being improved and updated. We are always looking for ways to make it better, whether that's through optimizing performance, adding new features, or fixing bugs. We welcome contributions from the community and are always looking for new ideas and suggestions. If you find it interesting or believe it could be helpful, we welcome your contributions to the codebase or consider starring the repository to show your support and motivate our team!

For more information, you can join our Discord channel

Roadmap

The first version will be released together with Media Server at the end of 2023.

Details on our roadmap can be seen TBA.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

We would like to thank all the contributors who have helped in making this project successful.

Dependencies

~10–21MB
~345K SLoC