Struct Sdk 

pub struct Sdk { /* private fields */ }

SDK for interacting with Universal Timestamping protocol.

Implementations

impl Sdk

pub async fn stamp_files<D>( &self, files: &[PathBuf], ) -> Result<Vec<DetachedTimestamp>>

where D: Digest + FixedOutputReset + DigestOpExt + Send, Output<D>: Copy,

Creates a timestamp for the given files.

pub async fn stamp_digest<D>( &self, digests: &[Output<D>], ) -> Result<Vec<DetachedTimestamp>>

where D: Digest + FixedOutputReset + DigestOpExt + Send, Output<D>: Copy,

Creates a timestamp for the given digests.

pub async fn stamp_files_in<A, D>( &self, files: &[PathBuf], allocator: A, ) -> Result<Vec<DetachedTimestamp<A>, A>>

where A: Allocator + Clone, D: Digest + FixedOutputReset + DigestOpExt + Send, Output<D>: Copy,

Creates a timestamp for the given files in the provided allocator.

Note

This uses the allocator_api2 crate for allocator api.

pub async fn stamp_digests_in<A, D>( &self, digests: &[Output<D>], allocator: A, ) -> Result<Vec<DetachedTimestamp<A>, A>>

where A: Allocator + Clone, D: Digest + FixedOutputReset + DigestOpExt + Send, Output<D>: Copy,

Creates a timestamp for the given digests in the provided allocator.

Note

This uses the allocator_api2 crate for allocator api.

impl Sdk

pub async fn upgrade<A: Allocator + Clone>( &self, stamp: &mut DetachedTimestamp<A>, ) -> Result<BTreeMap<String, UpgradeResult>>

Upgrades all pending attestations in the given detached timestamp.

impl Sdk

pub async fn verify( &self, file: impl AsRef<Path>, timestamp: &DetachedTimestamp, ) -> Result<Vec<AttestationStatus>>

Verifies the given file against the given detached timestamp, returning a list of attestation statuses.

pub async fn verify_in<A: Allocator + Clone>( &self, file: impl AsRef<Path>, timestamp: &DetachedTimestamp<A>, allocator: A, ) -> Result<Vec<AttestationStatus<A>, A>>

Verifies the given file against the given detached timestamp, returning a list of attestation statuses.

This is the same as verify, but allows specifying a custom allocator for the attestation statuses.

Note

This uses the allocator_api2 crate for allocator api.

pub async fn verify_digest<D: Digest>( &self, file: impl AsRef<Path>, expected: &[u8], ) -> Result<()>

Verifies the digest of the given file against the expected digest.

pub fn aggregate_verify_results( &self, results: &[AttestationStatus], ) -> VerifyStatus

Aggregate the individual attestation statuses into an overall verification status for the timestamp.

The earliest valid attestation timestamp is used as the timestamp for the overall status, if there is at least one valid attestation.

The logic is as follows:

• If there is at least one VALID attestation:
• If there are also INVALID or UNKNOWN attestations, the overall status is PARTIAL_VALID
• Otherwise, the overall status is VALID
• If there are no VALID attestations, but at least one PENDING attestation, the overall status is PENDING
• If there are no VALID attestations, but at least one UNKNOWN attestation, the overall status is UNKNOWN
• If there are no VALID or PENDING attestations, the overall status is INVALID

impl Sdk

pub fn new() -> Self

Create a new SDK with default settings.

pub fn builder() -> SdkBuilder

Create a new SDK builder with default settings.

pub fn try_builder_from_calendars( calendars: impl IntoIterator<Item = Url>, ) -> Result<SdkBuilder, BuilderError>

Create a new SDK builder with given calendars and default settings.

Trait Implementations

impl Clone for Sdk

fn clone(&self) -> Sdk

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Sdk

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

Formats the value using the given formatter.

impl Default for Sdk

fn default() -> Self

Returns the “default value” for a type.