aigis-enc-binding

Rust bindings for the PQMagic AIGIS-ENC implementation (KEM + tagged KEM/TKEM).

This crate compiles the upstream C implementation with cc and exposes:

Low-level FFI-style wrappers (aigis_enc_*, aigis_tkem_*)
A safe high-level API (AigisEnc)

Features

Choose one parameter set at compile time:

params-1
params-2 (default)
params-3
params-4

Example:

cargo run --example demo --features params-2

Quick Start

use aigis_enc_binding::{AigisEnc, CRYPTO_TKEM_TAGBYTES};

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let (pk, sk) = AigisEnc::keypair()?;

    // KEM
    let (ct, ss1) = AigisEnc::encapsulate(&pk)?;
    let ss2 = AigisEnc::decapsulate(&ct, &sk)?;
    assert_eq!(ss1, ss2);

    // TKEM
    let tag = vec![0x42u8; CRYPTO_TKEM_TAGBYTES];
    let (tct, tss1) = AigisEnc::encapsulate_with_tag(&pk, &tag)?;
    let tss2 = AigisEnc::decapsulate_with_tag(&tct, &sk, &tag)?;
    assert_eq!(tss1, tss2);

    Ok(())
}

Public API

AigisEnc::keypair()
AigisEnc::encapsulate(pk)
AigisEnc::decapsulate(ct, sk)
AigisEnc::encapsulate_with_tag(pk, tag)
AigisEnc::decapsulate_with_tag(ct, sk, tag)

Constants:

CRYPTO_PUBLICKEYBYTES
CRYPTO_SECRETKEYBYTES
CRYPTO_CIPHERTEXTBYTES
CRYPTO_BYTES
CRYPTO_TKEM_TAGBYTES
PARAMS

Build Notes

The crate contains vendored C sources under vendor/pqmagic so it can be packaged and published.
On Windows, the build links advapi32 for system randomness.

License