HQC は、NIST のポスト量子暗号標準化プロジェクトにおいて NIST が選定したコードベースの鍵カプセル化メカニズム (KEM) です。このリポジトリには、HQC チームによって提供された実装が含まれています。
このプロジェクトは、クロスプラットフォームコード、テスト、既知解ベクトル、パッケージングツールなどのモジュール式コンポーネントで構成されています。
任意のバリアントをアウトオブツリーのディレクトリでビルドし、1 つのコマンドラインで
テストスイート全体を実行できます。アーキテクチャ (HQC_ARCH)、該当する場合は
正確な SIMD バックエンド (HQC_X86_IMPL)、およびオプションのランタイムサニタイザー
(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