HQC 是一种基于编码的密钥封装机制(KEM),在 NIST 后量子密码标准化项目 期间被 NIST 选中。本仓库包含 HQC 团队提供的实现。
该项目按模块化组件组织,包括跨平台代码、测试、已知答案向量和打包工具。
可以在树外目录中构建任意变体,并通过单条命令行运行完整测试套件。选择架构(HQC_ARCH)、适用的确切 SIMD 后端(HQC_X86_IMPL)以及可选的运行时 sanitizer(HQC_SANITIZER)。
# 1) Configure
cmake -S . -B build-<arch> \
-DCMAKE_BUILD_TYPE=Release \
-DHQC_ARCH=<arch> \
-DHQC_X86_IMPL=<impl> \
-DHQC_SANITIZER=<sanitizer>
# 2) Build
cmake --build build-<arch> -- -j$(nproc)
# 3) Test
ctest --test-dir build-<arch> --output-on-failure -j$(nproc)
配置选项
<arch>:ref、x86_64<impl>:avx256<sanitizer>:NONE、ASAN、LSAN、MSAN、UBSAN示例 1(可移植参考实现)
rm -rf build-ref &&
cmake -S . -B build-ref \
-DCMAKE_BUILD_TYPE=Release \
-DHQC_ARCH=ref &&
cmake --build build-ref -j$(nproc) &&
ctest --test-dir build-ref -j$(nproc)
示例 2(优化的 AVX2 实现(Haswell/AVX256))
rm -rf build-avx256 &&
cmake -S . -B build-avx256 \
-DCMAKE_BUILD_TYPE=Release \
-DHQC_ARCH=x86_64 \
-DHQC_X86_IMPL=avx256 &&
cmake --build build-avx256 -j$(nproc) &&
ctest --test-dir build-avx256 -j$(nproc)
可选的开发者工具位于 tools/ 目录下,可通过 -DHQC_BUILD_TOOLS=ON 进行构建(命令与用法参见 tools/README.md)。
范围。 本项目仅针对抵御时序攻击,目前不考虑其他侧信道攻击。
本项目旨在避免依赖机密的控制流以及对机密内存位置的访问,从而挫败时序攻击。 针对编译器引发的时序攻击的代码加固工作仍在进行中,仅会考虑在目标架构上按照我们的编译说明进行编译时引入的漏洞(参见 #11 和 #12)。
在 FIPS 207 标准可用之前,鼓励大家通过创建 work item 在此报告问题。
我们也欢迎针对 work item 提交的合并请求。
所有源代码在每次提交前都必须使用 clang-format 进行格式化。
# Run from the build directory you already created
cmake --build build-<arch> --target clang-format # rewrites files in-place
cmake --build build-<arch> --target check-format # check format