
Implementação de esquema criptográfico pós-quântico (Hamming Quasi-Cíclico) com versões de referência e otimizadas para encapsulamento seguro de chaves.
HQC é um Mecanismo de Encapsulamento de Chaves (KEM) baseado em códigos, selecionado pelo NIST durante o Projeto de Padronização de Criptografia Pós-Quântica do NIST. Este repositório contém a implementação fornecida pela equipe do HQC.
O projeto está organizado em componentes modulares, incluindo código multiplataforma, testes, vetores de resposta conhecida e ferramentas de empacotamento.
É possível compilar qualquer variante em um diretório fora da árvore de código e executar a suíte de testes completa
com uma única linha de comando. Escolha a arquitetura (HQC_ARCH), o back-end SIMD exato
se aplicável (HQC_X86_IMPL) e um sanitizador de tempo de execução opcional
(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)
Opções de Configuração
<arch>: ref, x86_64<impl>: avx256<sanitizer>: NONE, ASAN, LSAN, MSAN, UBSANExemplo 1 (Implementação de referência portátil)
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)
Exemplo 2 (implementação AVX2 otimizada (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)
Ferramentas de desenvolvedor opcionais ficam em tools/ e podem ser compiladas usando -DHQC_BUILD_TOOLS=ON (consulte tools/README.md para comandos e uso).
Escopo. Este projeto tem como alvo apenas a resistência a ataques de temporização; outros ataques de canal lateral não são considerados atualmente.
Espera-se que este projeto evite fluxos de controle dependentes de segredos e o acesso a locais de memória secretos, a fim de frustrar ataques de temporização. O endurecimento do código contra ataques de temporização induzidos pelo compilador é um trabalho em andamento e apenas vulnerabilidades introduzidas quando compilado seguindo nossas instruções de compilação em arquiteturas alvo serão consideradas (consulte #11 e #12).
Até que o padrão FIPS 207 esteja disponível, as pessoas são incentivadas a relatar problemas aqui abrindo um work item.
Merge requests que abordem work items também são bem-vindos.
Todas as fontes devem ser formatadas com clang-format antes de cada commit.
# 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