bgpkit-commons 0.10.3

A library for common BGP-related data and functions.
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

# RPKI Module

**Purpose:** Resource Public Key Infrastructure validation and historical data access.

## Structure

```
src/rpki/
├── mod.rs              # RpkiTrie, Roa, Aspa, validation logic
├── cloudflare.rs       # Real-time RPKI data from Cloudflare
├── ripe_historical.rs  # RIPE NCC historical archives
├── rpkiviews.rs        # RPKIviews historical data
└── rpki_client.rs      # rpki-client JSON parser
```

## Key Types

| Type | Purpose |
|------|---------|
| `RpkiTrie` | Main storage: IpnetTrie of ROAs + ASPAs |
| `Roa` | Route Origin Authorization (prefix, ASN, max_length, validity) |
| `Aspa` | AS Provider Authorization |
| `RpkiValidation` | Valid / Invalid / Unknown result |
| `HistoricalRpkiSource` | Ripe or RpkiViews enum |

## Data Sources

| Source | Type | Use Case |
|--------|------|----------|
| Cloudflare | Real-time JSON | Current validation |
| RIPE NCC | Historical JSON | All 5 RIRs, archival |
| RPKIviews | Historical .tgz | Multiple vantage points |

## Usage Pattern

```rust
// Real-time validation
commons.load_rpki(None)?;
let result = commons.rpki_validate(64496, "192.0.2.0/24")?;

// Historical data
let date = NaiveDate::from_ymd_opt(2024, 1, 4).unwrap();
commons.load_rpki_historical(date, HistoricalRpkiSource::Ripe)?;
```

## Validation Logic

- **Valid:** Prefix-ASN match with valid max_length
- **Invalid:** Prefix has ROAs but not for this ASN
- **Unknown:** No ROAs exist (or all expired if check_expiry enabled)

## Notes

- RPKIviews streams tarballs efficiently (stops early once rpki-client.json found)
- `RoaEntry` type alias is deprecated - use `Roa`
- Multiple ROAs per prefix supported (avoids duplicates by (prefix, asn, max_length))