[][src]Crate contact_tracing

This crate implements the apple/google proximity contact tracing.

The version of this implementation is the initial reference spec 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.
}

Structs

DailyTracingKey

A compact representation of contact numbers.

InvalidDailyTracingKey

Returned if a daily tracing key is invalid.

InvalidRpi

Raised if a RPI is invalid.

InvalidTracingKey

Raised if a tracing key is invalid.

Rpi

A Rolling Proximity Identifier.

TracingKey

A compact representation of contact numbers.

Functions

day_number_for_timestamp

Returns the day number for a timestamp.

tin_for_timestamp

Returns the TIN for a timestamp.

tin_for_timestamp_checked

Returns the TIN for a timestamp in a day.