Struct tcn::ReportAuthorizationKey

pub struct ReportAuthorizationKey { /* fields omitted */ }

Authorizes publication of a report of potential exposure.

Methods

impl ReportAuthorizationKey

pub fn new<R: RngCore + CryptoRng>(rng: R) -> ReportAuthorizationKey

Initialize a new report authorization key from a random number generator.

pub fn initial_temporary_contact_key(&self) -> TemporaryContactKey

Compute the initial temporary contact key derived from this report authorization key.

Note: this function returns tck_1, the first temporary contact key that can be used to generate tcks.

impl ReportAuthorizationKey

pub fn create_report(
    &self,
    memo_type: MemoType,
    memo_data: Vec<u8>,
    j_1: u16,
    j_2: u16
) -> Result<SignedReport, Error>

Create a report of potential exposure.

Inputs

• memo_type, memo_data: the type and data for the report's memo field.
• j_1 > 0: the ratchet index of the first temporary contact number in the report.
• j_2: the ratchet index of the last temporary contact number other users should check.

Notes

Creating a report reveals all temporary contact numbers subsequent to j_1, not just up to j_2, which is included for convenience.

The memo_data must be less than 256 bytes long.

Reports are unlinkable from each other only up to the memo field. In other words, adding the same high-entropy data to the memo fields of multiple reports will cause them to be linkable.

impl ReportAuthorizationKey

pub fn read<R: Read>(reader: R) -> Result<ReportAuthorizationKey, Error>

Try to read a ReportAuthorizationKey from a generic io::Reader.

pub fn write<W: Write>(&self, writer: W) -> Result<(), Error>

Try to write a ReportAuthorizationKey into a generic io::Writeer.

Trait Implementations

impl Clone for ReportAuthorizationKey

fn clone(&self) -> ReportAuthorizationKey

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for ReportAuthorizationKey

impl Debug for ReportAuthorizationKey

fn fmt(&self, f: &mut Formatter) -> Result

Formats the value using the given formatter.