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

//! This crate implements the apple/google proximity contact tracing.
//!
//! The version of this implementation is the [initial reference
//! spec](https://covid19-static.cdn-apple.com/applications/covid19/current/static/contact-tracing/pdf/ContactTracing-CryptographySpecification.pdf)
//! from April 2020.
//!
//! # Features
//!
//! * `chrono`: Adds timestamp operations to all structs (on by default)
//! * `serde`: Adds serde support (implies `base64`)
//! * `base64`: Adds base64 encoding/decoding through `Display` and `FromStr`
//!
//! # Broadcast Example
//!
//! To broadcast one needs a tracing key and the rolling proximity identifier
//! (RPI) for a given time.  The RPI is normally created from the daily tracing
//! key but there is a shortcut to derive it automatically:
//!
//! ```
//! use contact_tracing::{TracingKey, DailyTracingKey, Rpi};
//!
//! let tkey = TracingKey::unique();
//! let rpi = Rpi::for_now(&tkey);
//! ```
//!
//! # Infection Checking Example
//!
//! Infection checking uses the daily tracing keys directly:
//!
//! ```
//! use contact_tracing::{TracingKey, DailyTracingKey, Rpi};
//!
//! // normally these would come from the internet somewhere
//! let tkey = TracingKey::unique();
//! let dtkey = DailyTracingKey::for_today(&tkey);
//!
//! for (tin, rpi) in dtkey.iter_rpis().enumerate() {
//!     // check your database of contacts against the TIN and RPIs generated
//!     // for each daily tracing key downloaded.  The TIN should be within
//!     // some reasonable window of the timestamp you captured.
//! }
//! ```

mod dtkey;
mod rpi;
mod tkey;
mod utils;

pub use dtkey::*;
pub use rpi::*;
pub use tkey::*;

#[allow(unused_imports)]
pub use utils::*;