Struct Sign 

pub struct Sign { /* private fields */ }

Signature subsystem.

Provides access to post-quantum digital signature operations using ML-DSA (formerly Dilithium).

Example

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

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

// Generate key pair
let keypair = sign.generate_keypair(SignAlgorithm::MlDsa65).unwrap();

// Sign a message
let message = b"Hello, quantum world!";
let signature = sign.sign(keypair.secret_key(), message, SignAlgorithm::MlDsa65).unwrap();

// Verify the signature
let valid = sign.verify(keypair.public_key(), message, &signature, SignAlgorithm::MlDsa65).unwrap();
assert!(valid);

Implementations

impl Sign

pub fn generate_keypair( &self, algorithm: SignAlgorithm, ) -> Result<SignatureKeyPair>

Generate a signature key pair.

Arguments

• algorithm - The signature algorithm to use

Returns

A SignatureKeyPair containing the public and secret keys.

pub fn generate_keypair_44(&self) -> Result<SignatureKeyPair>

Generate ML-DSA-44 key pair.

pub fn generate_keypair_65(&self) -> Result<SignatureKeyPair>

Generate ML-DSA-65 key pair.

pub fn generate_keypair_87(&self) -> Result<SignatureKeyPair>

Generate ML-DSA-87 key pair.

pub fn sign( &self, secret_key: &[u8], message: &[u8], algorithm: SignAlgorithm, ) -> Result<Vec<u8>>

Sign a message.

Arguments

• secret_key - The signer’s secret key
• message - The message to sign
• algorithm - The signature algorithm to use

Returns

The digital signature.

pub fn sign_44(&self, secret_key: &[u8], message: &[u8]) -> Result<Vec<u8>>

Sign using ML-DSA-44.

pub fn sign_65(&self, secret_key: &[u8], message: &[u8]) -> Result<Vec<u8>>

Sign using ML-DSA-65.

pub fn sign_87(&self, secret_key: &[u8], message: &[u8]) -> Result<Vec<u8>>

Sign using ML-DSA-87.

pub fn sign_str( &self, secret_key: &[u8], message: &str, algorithm: SignAlgorithm, ) -> Result<Vec<u8>>

Sign a string message.

pub fn verify( &self, public_key: &[u8], message: &[u8], signature: &[u8], algorithm: SignAlgorithm, ) -> Result<bool>

Verify a signature.

Arguments

• public_key - The signer’s public key
• message - The original message
• signature - The signature to verify
• algorithm - The signature algorithm to use

Returns

true if the signature is valid, false otherwise.

pub fn verify_44( &self, public_key: &[u8], message: &[u8], signature: &[u8], ) -> Result<bool>

Verify using ML-DSA-44.

pub fn verify_65( &self, public_key: &[u8], message: &[u8], signature: &[u8], ) -> Result<bool>

Verify using ML-DSA-65.

pub fn verify_87( &self, public_key: &[u8], message: &[u8], signature: &[u8], ) -> Result<bool>

Verify using ML-DSA-87.

pub fn verify_str( &self, public_key: &[u8], message: &str, signature: &[u8], algorithm: SignAlgorithm, ) -> Result<bool>

Verify a string message.

pub fn verify_or_error( &self, public_key: &[u8], message: &[u8], signature: &[u8], algorithm: SignAlgorithm, ) -> Result<()>

Verify a signature, returning an error if invalid.

Unlike verify() which returns a boolean, this method returns an error if verification fails, making it suitable for use with ?.

Trait Implementations

impl Clone for Sign

fn clone(&self) -> Sign

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Sign

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

Formats the value using the given formatter.