Struct Hash 

pub struct Hash { /* private fields */ }

Hash subsystem.

Provides hardware-accelerated hash functions including SHA-2, SHA-3, SHAKE, HMAC, and HKDF.

Example

use quantacore::{initialize, open_first_device, HashAlgorithm};

initialize().unwrap();
let device = open_first_device().unwrap();
let hash = device.hash();

// One-shot hashing
let digest = hash.sha256(b"Hello, World!").unwrap();
println!("SHA-256: {}", hex::encode(&digest));

// Incremental hashing
let mut ctx = hash.create_context(HashAlgorithm::Sha3_256).unwrap();
ctx.update(b"Hello, ").unwrap();
ctx.update(b"World!").unwrap();
let digest = ctx.finalize().unwrap();

Implementations

impl Hash

pub fn hash(&self, algorithm: HashAlgorithm, data: &[u8]) -> Result<Vec<u8>>

Compute a hash digest.

Arguments

• algorithm - The hash algorithm to use
• data - The data to hash

Returns

The hash digest.

pub fn sha256(&self, data: &[u8]) -> Result<Vec<u8>>

Compute SHA-256 digest.

pub fn sha384(&self, data: &[u8]) -> Result<Vec<u8>>

Compute SHA-384 digest.

pub fn sha512(&self, data: &[u8]) -> Result<Vec<u8>>

Compute SHA-512 digest.

pub fn sha3_256(&self, data: &[u8]) -> Result<Vec<u8>>

Compute SHA3-256 digest.

pub fn sha3_384(&self, data: &[u8]) -> Result<Vec<u8>>

Compute SHA3-384 digest.

pub fn sha3_512(&self, data: &[u8]) -> Result<Vec<u8>>

Compute SHA3-512 digest.

pub fn shake128(&self, data: &[u8], output_len: usize) -> Result<Vec<u8>>

Compute SHAKE128 output.

Arguments

• data - The input data
• output_len - The desired output length in bytes

pub fn shake256(&self, data: &[u8], output_len: usize) -> Result<Vec<u8>>

Compute SHAKE256 output.

Arguments

• data - The input data
• output_len - The desired output length in bytes

pub fn create_context(&self, algorithm: HashAlgorithm) -> Result<HashContext>

Create a hash context for incremental hashing.

Example

let mut ctx = hash.create_context(HashAlgorithm::Sha256).unwrap();
ctx.update(b"part 1").unwrap();
ctx.update(b"part 2").unwrap();
let digest = ctx.finalize().unwrap();

pub fn hmac( &self, algorithm: HashAlgorithm, key: &[u8], data: &[u8], ) -> Result<Vec<u8>>

Compute HMAC.

Arguments

• algorithm - The hash algorithm to use
• key - The HMAC key
• data - The data to authenticate

Returns

The MAC tag.

pub fn hmac_sha256(&self, key: &[u8], data: &[u8]) -> Result<Vec<u8>>

Compute HMAC-SHA256.

pub fn hmac_sha384(&self, key: &[u8], data: &[u8]) -> Result<Vec<u8>>

Compute HMAC-SHA384.

pub fn hmac_sha512(&self, key: &[u8], data: &[u8]) -> Result<Vec<u8>>

Compute HMAC-SHA512.

pub fn hkdf( &self, algorithm: HashAlgorithm, ikm: &[u8], salt: &[u8], info: &[u8], output_len: usize, ) -> Result<Vec<u8>>

Derive a key using HKDF.

Arguments

• algorithm - The hash algorithm to use
• ikm - Input keying material
• salt - Optional salt (can be empty)
• info - Optional context info (can be empty)
• output_len - Desired output length

Returns

The derived key material.

pub fn hkdf_sha256( &self, ikm: &[u8], salt: &[u8], info: &[u8], output_len: usize, ) -> Result<Vec<u8>>

Derive a key using HKDF-SHA256.

Trait Implementations

impl Clone for Hash

fn clone(&self) -> Hash

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Hash

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

Formats the value using the given formatter.