seedlink-rs-protocol 0.2.0

SeedLink protocol types, commands, and frame parsing
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

# seedlink-rs

Pure Rust SeedLink client and server. Zero unsafe, zero C dependency.

Sister project of [miniseed-rs](https://github.com/luhtfiimanal/miniseed-rs).

## Crates

| Crate | Description |
|-------|-------------|
| [seedlink-rs-protocol](https://crates.io/crates/seedlink-rs-protocol) | SeedLink protocol types, commands, and frame parsing |
| [seedlink-rs-client](https://crates.io/crates/seedlink-rs-client) | Async SeedLink client (tokio) |
| seedlink-rs-server | Async SeedLink server (tokio) — coming soon |

## Quick Start

```rust
use seedlink_rs_client::SeedLinkClient;

#[tokio::main]
async fn main() -> seedlink_rs_client::Result<()> {
    let mut client = SeedLinkClient::connect("rtserve.iris.washington.edu:18000").await?;
    client.station("ANMO", "IU").await?;
    client.select("BHZ").await?;
    client.data().await?;
    client.end_stream().await?;

    while let Some(frame) = client.next_frame().await? {
        println!("seq={}, payload={} bytes", frame.sequence(), frame.payload().len());
    }
    Ok(())
}
```

## Status

**seedlink-rs-protocol** and **seedlink-rs-client** are published and functional.
Tested against IRIS (`rtserve.iris.washington.edu:18000`) with 154 tests passing.

### What works today

- SeedLink v3 and v4 protocol negotiation
- Station/channel selection, DATA, FETCH, END, INFO, BYE
- `TIME` command for time-windowed data requests (v3)
- Sequence tracking and resume from last sequence
- `futures::Stream` impl via `frame_stream()` / `into_stream()`
- Auto-reconnect with exponential backoff and per-station sequence resume
- Built-in deduplication — downstream never sees duplicate frames after reconnect
- miniSEED decode via [miniseed-rs](https://github.com/luhtfiimanal/miniseed-rs) integration
- `tracing` integration for structured logging
- Configurable connect and read timeouts
- Clean EOF handling (`next_frame()` returns `None`)

### Roadmap

- [ ] `seedlink-rs-server` — async SeedLink server for data distribution

## License

Apache-2.0