Struct Keys 

pub struct Keys { /* private fields */ }

Key storage (HSM) subsystem.

Provides secure key storage in the hardware security module.

Example

use quantacore::{initialize, open_first_device, KeyType, KeyUsage};

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

// Store a key
let key_data = vec![0u8; 32]; // Your key material
keys.store(
    0,  // slot
    KeyType::Secret,
    0,  // algorithm
    KeyUsage::ENCRYPT | KeyUsage::DECRYPT,
    "my-key",
    &key_data,
).unwrap();

// Load the key
let loaded = keys.load(0).unwrap();

// Get key info
let info = keys.get_info(0).unwrap();
println!("Key label: {}", info.label);

// Delete the key
keys.delete(0).unwrap();

Implementations

impl Keys

pub fn store( &self, slot: u32, key_type: KeyType, algorithm: i32, usage: KeyUsage, label: &str, key_data: &[u8], ) -> Result<()>

Store a key in the HSM.

Arguments

• slot - The slot number to store the key in
• key_type - The type of key
• algorithm - The algorithm identifier
• usage - Allowed usage flags
• label - A human-readable label (max 63 chars)
• key_data - The raw key material

pub fn load(&self, slot: u32) -> Result<Vec<u8>>

Load a key from the HSM.

Arguments

• slot - The slot number to load from

Returns

The raw key material.

pub fn get_info(&self, slot: u32) -> Result<KeyInfo>

Get information about a stored key.

Arguments

• slot - The slot number

Returns

Information about the key in that slot.

pub fn delete(&self, slot: u32) -> Result<()>

Delete a key from the HSM.

Arguments

• slot - The slot number to delete

pub fn list(&self) -> Result<Vec<u32>>

List all occupied key slots.

Returns

A vector of slot numbers that contain keys.

pub fn get_slot_count(&self) -> Result<u32>

Get the total number of key slots.

pub fn get_free_slot(&self) -> Result<u32>

Find the first free slot.

Returns

The slot number, or an error if no free slots.

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

Clear all keys from the HSM.

WARNING: This permanently deletes all stored keys!

pub fn is_slot_occupied(&self, slot: u32) -> Result<bool>

Check if a slot is occupied.

pub fn store_keypair( &self, slot: u32, algorithm: i32, label: &str, public_key: &[u8], secret_key: &[u8], ) -> Result<()>

Store a key pair (public + secret).

This is a convenience method that stores both keys in adjacent slots.

Arguments

• slot - The base slot (public key goes here, secret at slot+1)
• algorithm - Algorithm identifier
• label - Label prefix
• public_key - Public key bytes
• secret_key - Secret key bytes

Trait Implementations

impl Clone for Keys

fn clone(&self) -> Keys

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Keys

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

Formats the value using the given formatter.