rift-discovery 0.1.4

Peer discovery via mDNS and DHT for Rift P2P
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
64
65
66
67
68
69
70
71
72
73

# rift-discovery

<p align="center">
  <a href="https://github.com/infinityabundance/riftd">
    <img src="https://raw.githubusercontent.com/infinityabundance/riftd/main/assets/riftd.svg" alt="riftd" width="80">
  </a>
</p>

<p align="center">
  <a href="https://crates.io/crates/rift-discovery"><img src="https://img.shields.io/crates/v/rift-discovery.svg" alt="crates.io"></a>
  <a href="https://docs.rs/rift-discovery"><img src="https://docs.rs/rift-discovery/badge.svg" alt="docs.rs"></a>
  <a href="https://github.com/infinityabundance/riftd/blob/main/LICENSE-MIT"><img src="https://img.shields.io/badge/license-MIT%2FApache--2.0-blue.svg" alt="License"></a>
  <a href="https://doi.org/10.5281/zenodo.18528430"><img src="https://zenodo.org/badge/DOI/10.5281/zenodo.18528430.svg" alt="DOI"></a>
</p>

<p align="center">
  Peer discovery via mDNS and DHT for the <a href="https://github.com/infinityabundance/riftd">riftd</a> P2P protocol.
</p>

---

Part of the [riftd](https://github.com/infinityabundance/riftd) project — serverless P2P voice + text chat over UDP.

## What's in this crate?

`rift-discovery` combines local and wide-area peer discovery:

- **mDNS Discovery** — Find peers on the local network automatically
- **DHT Discovery** — Find peers anywhere on the internet
- **Service Browsing** — Discover rift channels and peers
- **Peer Announcement** — Advertise your presence
- **Unified API** — Single interface for all discovery methods

## Usage

```rust
use rift_discovery::Discovery;

let discovery = Discovery::new(peer_id).await?;

// Start announcing
discovery.announce(channel_id).await?;

// Discover peers (combines mDNS + DHT)
let mut stream = discovery.discover();
while let Some(peer) = stream.next().await {
    println!("Found peer: {:?}", peer);
}
```

## How Discovery Works

1. **LAN** — mDNS broadcasts find peers on the same network instantly
2. **Internet** — DHT queries find peers anywhere (requires bootstrap)
3. **Invites** — Direct connection via invite tokens (see rift-rndzv)

## Related Crates

| Crate | Description |
|-------|-------------|
| [rift-dht](https://crates.io/crates/rift-dht) | DHT implementation |
| [rift-rndzv](https://crates.io/crates/rift-rndzv) | Invite-based rendezvous |
| [rift-mesh](https://crates.io/crates/rift-mesh) | Mesh networking layer |

## Citation

If you use riftd in academic work, please cite:

> de Beer, R. (2026). *Predictive Rendezvous: Time–Intent–Deterministic Peer Coordination Without Infrastructure*. Zenodo. https://doi.org/10.5281/zenodo.18528430

## License

Licensed under either of [Apache License, Version 2.0](LICENSE-APACHE) or [MIT license](LICENSE-MIT) at your option.