hopr-api 1.7.0

Common high-level external and internal API traits used by hopr-lib to implement the HOPR protocol
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

# hopr-api

[![Crates.io](https://img.shields.io/crates/v/hopr-api)](https://crates.io/crates/hopr-api)
[![docs.rs](https://img.shields.io/docsrs/hopr-api)](https://docs.rs/hopr-api)
[![Security](https://github.com/hoprnet/hopr-api/actions/workflows/checks-zizmor.yaml/badge.svg)](https://github.com/hoprnet/hopr-api/actions/workflows/checks-zizmor.yaml)
[![License](https://img.shields.io/crates/l/hopr-api)](LICENSE)
[![MSRV](https://img.shields.io/crates/msrv/hopr-api)](https://github.com/hoprnet/hopr-api)
[![Crates.io Downloads](https://img.shields.io/crates/d/hopr-api)](https://crates.io/crates/hopr-api)

Common high-level API traits for the [HOPR protocol](https://hoprnet.org/).

This crate defines the public API surface as **traits only** — no concrete implementations.
Implementations live in the main [hoprnet](https://github.com/hoprnet/hoprnet) repository.

## Modules

All modules are feature-gated:

| Feature               | Module             | Description                                            |
| --------------------- | ------------------ | ------------------------------------------------------ |
| `chain`               | `chain`            | On-chain operation APIs (accounts, channels, tickets…) |
| `ct`                  | `ct`               | Cover traffic and probing API traits                   |
| `graph`               | `graph`            | Network graph topology, QoS, routing costs             |
| `network`             | `network`          | Network state, peer observations, connectivity         |
| `node`                | `node`             | High-level HOPR node API traits and state machine      |
| `node-session-client` | `node::session`    | Session client for establishing HOPR sessions          |
| `node-session-server` | `node::session`    | Session server for processing incoming sessions        |
| `tickets`             | `tickets`          | Winning ticket management and redemption               |
| `full`                | _all_              | Enables all of the above + `serde`                     |

## Usage

```toml
[dependencies]
hopr-api = { version = "1.7.0", features = ["full"] }
```

## Development

Requires [Nix](https://nixos.org/) with flakes enabled.

```bash
# Enter development shell
nix develop

# Build
cargo build

# Test
cargo test --lib

# Lint
cargo clippy

# Format
nix fmt
```

## License

[GPL-3.0-only](LICENSE)