mosaik 0.3.13

A Rust runtime for building self-organizing, leaderless distributed systems.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63

# Installation

## Requirements

- **Rust ≥ 1.93** (edition 2024)
- A Unix-like OS (Linux, macOS) or Windows

## Add to Your Project

Add mosaik to your `Cargo.toml`:

```toml
[dependencies]
mosaik = "0.3"
```

Mosaik pulls in its core dependencies automatically, including:

- [`tokio`](https://docs.rs/tokio) — async runtime (full features)
- [`iroh`](https://docs.rs/iroh) — QUIC-based P2P networking
- [`serde`](https://docs.rs/serde) — serialization framework
- [`futures`](https://docs.rs/futures) — `Stream` and `Sink` traits

## Common Additional Dependencies

Most mosaik applications will also want:

```toml
[dependencies]
tokio = { version = "1", features = ["full"] }
serde = { version = "1.0", features = ["derive"] }
futures = "0.3"
anyhow = "1"
```

- **`tokio`** — you need the tokio runtime to run mosaik
- **`serde` with `derive`** — for `#[derive(Serialize, Deserialize)]` on your data types
- **`futures`** — for `StreamExt` / `SinkExt` traits on consumers and producers

## Verify Installation

Create a minimal test to verify everything links correctly:

```rust,ignore
use mosaik::{Network, NetworkId};

#[tokio::main]
async fn main() -> anyhow::Result<()> {
    let network = Network::new("test-network".into()).await?;
    println!("Node online: {}", network.local().id());
    Ok(())
}
```

```bash
cargo run
```

If you see a node ID printed, mosaik is installed and working.

## Feature Flags

Mosaik currently does not define any optional feature flags. All functionality is included by default.