Struct Device 

pub struct Device { /* private fields */ }

Handle to an open QUAC 100 device.

This struct provides access to all device functionality including KEM, signatures, hashing, random number generation, and key storage.

The device is automatically closed when this struct is dropped.

Thread Safety

Device is Send and Sync, allowing it to be shared across threads. The underlying hardware operations are serialized by the device.

Example

use quantacore::{initialize, open_first_device};

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

let info = device.get_info().unwrap();
println!("Connected to: {}", info.model);

// Access subsystems
let kem = device.kem();
let sign = device.sign();
let hash = device.hash();
let random = device.random();

Implementations

impl Device

pub fn index(&self) -> u32

Get device index.

pub fn get_info(&self) -> Result<DeviceInfo>

Get device information.

Example

let device = open_first_device().unwrap();
let info = device.get_info().unwrap();
println!("Model: {}", info.model);
println!("Serial: {}", info.serial_number);
println!("Firmware: {}", info.firmware_version);

pub fn get_status(&self) -> Result<DeviceStatus>

Get device status.

Example

let device = open_first_device().unwrap();
let status = device.get_status().unwrap();
println!("Temperature: {}°C", status.temperature);
println!("Entropy: {}%", status.entropy_level);
println!("Healthy: {}", status.is_healthy());

pub fn self_test(&self) -> Result<()>

Run device self-test.

This performs a comprehensive self-test of the device hardware and cryptographic implementations.

Example

let device = open_first_device().unwrap();
device.self_test().expect("Self-test failed");
println!("Device self-test passed");

pub fn reset(&self) -> Result<()>

Reset the device.

This performs a soft reset of the device. All ongoing operations will be cancelled.

pub fn kem(&self) -> Kem

Get the KEM (Key Encapsulation Mechanism) subsystem.

Example

let device = open_first_device().unwrap();
let kem = device.kem();
let keypair = kem.generate_keypair(KemAlgorithm::MlKem768).unwrap();

pub fn sign(&self) -> Sign

Get the signature subsystem.

Example

let device = open_first_device().unwrap();
let sign = device.sign();
let keypair = sign.generate_keypair(SignAlgorithm::MlDsa65).unwrap();

pub fn hash(&self) -> Hash

Get the hash subsystem.

Example

let device = open_first_device().unwrap();
let hash = device.hash();
let digest = hash.sha256(b"Hello, World!").unwrap();

pub fn random(&self) -> Random

Get the random number generator subsystem.

Example

let device = open_first_device().unwrap();
let random = device.random();
let bytes = random.bytes(32).unwrap();

pub fn keys(&self) -> Keys

Get the key storage (HSM) subsystem.

Example

let device = open_first_device().unwrap();
let keys = device.keys();
let slots = keys.list().unwrap();

pub fn close(self)

Close the device explicitly.

This is optional; the device will be closed automatically when dropped.

Trait Implementations

impl Clone for Device

fn clone(&self) -> Device

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Device

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

Formats the value using the given formatter.