Struct ReportAuthorizationKey

pub struct ReportAuthorizationKey { /* private fields */ }

Authorizes publication of a report of potential exposure.

Implementations

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 duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ReportAuthorizationKey

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

Formats the value using the given formatter.

impl Copy for ReportAuthorizationKey