autogen: Improve wording and reduce verbosity of documentation by hanno-becker · Pull Request #1758 · pq-code-package/mlkem-native

hanno-becker · 2026-06-25T04:04:32Z

Remove references to 'shipped' assembly and instead talk explicitly about mlkem/*. Remove AI slop. Use standard autogen header in auto-generated ABI checker files.

Remove references to 'shipped' assembly and instead talk explicitly about mlkem/*. Remove AI slop. Use standard autogen header in auto- generated ABI checker files. Signed-off-by: Hanno Becker <beckphan@amazon.co.uk>

oqs-bot · 2026-06-25T04:30:41Z

CBMC Results (ML-KEM-768)

Full Results (191 proofs)

Proof	Status	Current	Previous	Change
`TOTAL`	✅	1640s	1929s	-15.0%
`mlk_indcpa_keypair_derand`	✅	309s	341s	-9%
`mlk_indcpa_enc`	✅	246s	277s	-11%
`mlk_poly_rej_uniform`	✅	135s	163s	-17%
`mlk_rej_uniform_c`	✅	116s	163s	-29%
`rej_uniform_native_x86_64`	✅	52s	71s	-27%
`mlk_polyvec_basemul_acc_montgomery_cached_c`	✅	49s	59s	-17%
`poly_ntt_native`	✅	36s	47s	-23%
`mlk_poly_reduce_native`	✅	33s	41s	-20%
`rej_uniform_native_aarch64`	✅	33s	43s	-23%
`mlk_keccak_squeezeblocks_x4`	✅	26s	28s	-7%
`mlk_ntt_layer`	✅	26s	41s	-37%
`keccakf1600x4_permute_native_x4`	✅	17s	18s	-6%
`mlk_fqmul`	✅	17s	18s	-6%
`mlk_poly_decompress_d4_native`	✅	15s	18s	-17%
`polyvec_basemul_acc_montgomery_cached_native`	✅	13s	17s	-24%
`mlk_poly_decompress_d10_native`	✅	12s	16s	-25%
`mlk_polyvec_add`	✅	10s	13s	-23%
`mlk_keccak_squeeze_once`	✅	9s	9s	+0%
`mlk_keccak_squeezeblocks`	✅	9s	8s	+12%
`mlk_indcpa_dec`	✅	8s	14s	-43%
`mlk_poly_frombytes_native`	✅	8s	13s	-38%
`mlk_ntt_butterfly_block`	✅	7s	9s	-22%
`mlk_poly_frombytes_c`	✅	7s	6s	+17%
`mlk_poly_frommsg`	✅	7s	13s	-46%
`mlk_poly_ntt`	✅	7s	9s	-22%
`mlk_poly_sub`	✅	7s	7s	+0%
`mlk_keccak_absorb_once`	✅	6s	4s	+50%
`mlk_poly_rej_uniform_x4`	✅	6s	7s	-14%
`mlk_polyvec_ntt`	✅	6s	2s	+200%
`kem_enc`	✅	5s	4s	+25%
`mlk_keccak_absorb_once_x4`	✅	5s	7s	-29%
`mlk_poly_decompress_d4_c`	✅	5s	5s	+0%
`mlk_poly_getnoise_eta2`	✅	5s	1s	+400%
`mlk_polymat_permute_bitrev_to_custom`	✅	5s	5s	+0%
`poly_compress_d11_native_x86_64`	✅	5s	3s	+67%
`poly_decompress_d4_native_x86_64`	✅	5s	4s	+25%
`keccakf1600x4_extract_bytes_native`	✅	4s	4s	+0%
`kem_dec`	✅	4s	6s	-33%
`kem_enc_derand`	✅	4s	2s	+100%
`mlk_ct_get_optblocker_i32`	✅	4s	1s	+300%
`mlk_invntt_layer`	✅	4s	6s	-33%
`mlk_keccakf1600_permute_c`	✅	4s	6s	-33%
`mlk_poly_add`	✅	4s	5s	-20%
`mlk_poly_compress_d4_c`	✅	4s	1s	+300%
`mlk_poly_decompress_d11_native`	✅	4s	2s	+100%
`mlk_poly_decompress_dv`	✅	4s	3s	+33%
`mlk_poly_tobytes_native`	✅	4s	4s	+0%
`mlk_polyvec_reduce`	✅	4s	2s	+100%
`mlk_scalar_decompress_d10`	✅	4s	2s	+100%
`mlk_scalar_signed_to_unsigned_q`	✅	4s	2s	+100%
`poly_decompress_d10_native_x86_64`	✅	4s	6s	-33%
`poly_frombytes_native_x86_64`	✅	4s	7s	-43%
`poly_tomont_native_aarch64`	✅	4s	4s	+0%
`poly_tomont_native_x86_64`	✅	4s	4s	+0%
`polyvec_basemul_acc_montgomery_cached_k2_native_aarch64`	✅	4s	2s	+100%
`intt_native_aarch64`	✅	3s	3s	+0%
`keccak_f1600_x1_native_aarch64_v84a`	✅	3s	3s	+0%
`keccak_f1600_x4_native_aarch64_v84a`	✅	3s	4s	-25%
`keccakf1600x4_xor_bytes_native`	✅	3s	2s	+50%
`kem_check_pk`	✅	3s	1s	+200%
`kem_check_sk`	✅	3s	2s	+50%
`kem_keypair`	✅	3s	2s	+50%
`mlk_check_pct`	✅	3s	4s	-25%
`mlk_ct_cmov_zero`	✅	3s	1s	+200%
`mlk_ct_sel_uint8`	✅	3s	3s	+0%
`mlk_enc_getnoise_eta1_eta2`	✅	3s	2s	+50%
`mlk_gen_matrix_serial`	✅	3s	4s	-25%
`mlk_keccakf1600_xor_bytes (big endian)`	✅	3s	1s	+200%
`mlk_matvec_mul`	✅	3s	2s	+50%
`mlk_poly_cbd_eta2`	✅	3s	2s	+50%
`mlk_poly_compress_d10`	✅	3s	5s	-40%
`mlk_poly_compress_d10_native`	✅	3s	3s	+0%
`mlk_poly_compress_d11`	✅	3s	2s	+50%
`mlk_poly_compress_d11_native`	✅	3s	2s	+50%
`mlk_poly_compress_du`	✅	3s	2s	+50%
`mlk_poly_decompress_d4`	✅	3s	2s	+50%
`mlk_poly_frombytes`	✅	3s	4s	-25%
`mlk_poly_getnoise_eta1_4x`	✅	3s	4s	-25%
`mlk_poly_getnoise_eta1_4x_native`	✅	3s	1s	+200%
`mlk_poly_mulcache_compute_c`	✅	3s	4s	-25%
`mlk_poly_mulcache_compute_native`	✅	3s	3s	+0%
`mlk_poly_reduce`	✅	3s	3s	+0%
`mlk_poly_tobytes_c`	✅	3s	4s	-25%
`mlk_poly_tomont_c`	✅	3s	2s	+50%
`mlk_poly_tomont_native`	✅	3s	2s	+50%
`mlk_poly_tomsg`	✅	3s	3s	+0%
`mlk_polyvec_basemul_acc_montgomery_cached`	✅	3s	5s	-40%
`mlk_polyvec_compress_du`	✅	3s	2s	+50%
`mlk_polyvec_frombytes`	✅	3s	2s	+50%
`mlk_scalar_compress_d4`	✅	3s	3s	+0%
`mlk_scalar_compress_d5`	✅	3s	1s	+200%
`mlk_sha3_512`	✅	3s	3s	+0%
`mlk_shake128_squeezeblocks`	✅	3s	3s	+0%
`mlk_shake256x4`	✅	3s	4s	-25%
`mlk_value_barrier_i32`	✅	3s	3s	+0%
`mlk_value_barrier_u32`	✅	3s	6s	-50%
`ntt_native_x86_64`	✅	3s	2s	+50%
`nttunpack_native_x86_64`	✅	3s	2s	+50%
`poly_compress_d10_native_x86_64`	✅	3s	4s	-25%
`poly_compress_d4_native_x86_64`	✅	3s	3s	+0%
`poly_mulcache_compute_native_x86_64`	✅	3s	4s	-25%
`poly_tobytes_native_aarch64`	✅	3s	4s	-25%
`poly_tobytes_native_x86_64`	✅	3s	3s	+0%
`keccak_f1600_x1_native_aarch64`	✅	2s	2s	+0%
`keccak_f1600_x4_native_avx2`	✅	2s	2s	+0%
`keccakf1600_permute_native`	✅	2s	3s	-33%
`kem_keypair_derand`	✅	2s	3s	-33%
`mlk_barrett_reduce`	✅	2s	2s	+0%
`mlk_ct_cmask_neg_i16`	✅	2s	2s	+0%
`mlk_ct_cmask_nonzero_u16`	✅	2s	2s	+0%
`mlk_ct_get_optblocker_u32`	✅	2s	3s	-33%
`mlk_ct_get_optblocker_u8`	✅	2s	3s	-33%
`mlk_ct_memcmp`	✅	2s	2s	+0%
`mlk_ct_sel_int16`	✅	2s	2s	+0%
`mlk_gen_matrix`	✅	2s	3s	-33%
`mlk_keccakf1600_extract_bytes`	✅	2s	1s	+100%
`mlk_keccakf1600_extract_bytes (big endian)`	✅	2s	2s	+0%
`mlk_keccakf1600_permute`	✅	2s	3s	-33%
`mlk_keccakf1600_xor_bytes`	✅	2s	1s	+100%
`mlk_keccakf1600x4_xor_bytes`	✅	2s	1s	+100%
`mlk_montgomery_reduce`	✅	2s	2s	+0%
`mlk_poly_compress_d10_c`	✅	2s	2s	+0%
`mlk_poly_compress_d11_c`	✅	2s	4s	-50%
`mlk_poly_compress_d4_native`	✅	2s	3s	-33%
`mlk_poly_compress_d5`	✅	2s	1s	+100%
`mlk_poly_compress_d5_c`	✅	2s	2s	+0%
`mlk_poly_compress_d5_native`	✅	2s	4s	-50%
`mlk_poly_compress_dv`	✅	2s	3s	-33%
`mlk_poly_decompress_d10`	✅	2s	2s	+0%
`mlk_poly_decompress_d5`	✅	2s	3s	-33%
`mlk_poly_decompress_d5_c`	✅	2s	2s	+0%
`mlk_poly_decompress_d5_native`	✅	2s	3s	-33%
`mlk_poly_getnoise_eta1122_4x`	✅	2s	2s	+0%
`mlk_poly_invntt_tomont`	✅	2s	2s	+0%
`mlk_poly_invntt_tomont_c`	✅	2s	2s	+0%
`mlk_poly_reduce_c`	✅	2s	3s	-33%
`mlk_poly_tobytes`	✅	2s	2s	+0%
`mlk_poly_tomont`	✅	2s	2s	+0%
`mlk_polyvec_decompress_du`	✅	2s	1s	+100%
`mlk_polyvec_invntt_tomont`	✅	2s	2s	+0%
`mlk_polyvec_mulcache_compute`	✅	2s	3s	-33%
`mlk_polyvec_permute_bitrev_to_custom`	✅	2s	4s	-50%
`mlk_polyvec_permute_bitrev_to_custom_native`	✅	2s	3s	-33%
`mlk_polyvec_tobytes`	✅	2s	3s	-33%
`mlk_polyvec_tomont`	✅	2s	2s	+0%
`mlk_rej_uniform`	✅	2s	4s	-50%
`mlk_scalar_compress_d1`	✅	2s	3s	-33%
`mlk_scalar_compress_d10`	✅	2s	4s	-50%
`mlk_scalar_compress_d11`	✅	2s	1s	+100%
`mlk_scalar_decompress_d11`	✅	2s	3s	-33%
`mlk_scalar_decompress_d5`	✅	2s	3s	-33%
`mlk_sha3_256`	✅	2s	3s	-33%
`mlk_shake128_absorb_once`	✅	2s	2s	+0%
`mlk_shake256`	✅	2s	3s	-33%
`mlk_value_barrier_u8`	✅	2s	4s	-50%
`ntt_native_aarch64`	✅	2s	7s	-71%
`poly_decompress_d5_native_x86_64`	✅	2s	3s	-33%
`poly_getnoise_eta1122_4x_native`	✅	2s	2s	+0%
`poly_invntt_tomont_native`	✅	2s	2s	+0%
`poly_reduce_native_aarch64`	✅	2s	2s	+0%
`poly_reduce_native_x86_64`	✅	2s	3s	-33%
`polyvec_basemul_acc_montgomery_cached_k2_native_x86_64`	✅	2s	1s	+100%
`polyvec_basemul_acc_montgomery_cached_k3_native_aarch64`	✅	2s	2s	+0%
`polyvec_basemul_acc_montgomery_cached_k3_native_x86_64`	✅	2s	4s	-50%
`polyvec_basemul_acc_montgomery_cached_k4_native_aarch64`	✅	2s	4s	-50%
`polyvec_basemul_acc_montgomery_cached_k4_native_x86_64`	✅	2s	2s	+0%
`rej_uniform_native`	✅	2s	2s	+0%
`sys_check_capability`	✅	2s	1s	+100%
`intt_native_x86_64`	✅	1s	2s	-50%
`keccak_f1600_x4_native_aarch64_v8a_scalar_hybrid`	✅	1s	3s	-67%
`keccak_f1600_x4_native_aarch64_v8a_v84a_scalar_hybrid`	✅	1s	1s	+0%
`mlk_ct_cmask_nonzero_u8`	✅	1s	3s	-67%
`mlk_keccakf1600x4_extract_bytes`	✅	1s	4s	-75%
`mlk_keccakf1600x4_extract_bytes_c`	✅	1s	2s	-50%
`mlk_keccakf1600x4_permute`	✅	1s	2s	-50%
`mlk_keccakf1600x4_xor_bytes_c`	✅	1s	1s	+0%
`mlk_keypair_getnoise_eta1`	✅	1s	3s	-67%
`mlk_poly_cbd_eta1`	✅	1s	2s	-50%
`mlk_poly_compress_d4`	✅	1s	3s	-67%
`mlk_poly_decompress_d10_c`	✅	1s	2s	-50%
`mlk_poly_decompress_d11`	✅	1s	2s	-50%
`mlk_poly_decompress_d11_c`	✅	1s	3s	-67%
`mlk_poly_decompress_du`	✅	1s	4s	-75%
`mlk_poly_mulcache_compute`	✅	1s	1s	+0%
`mlk_poly_ntt_c`	✅	1s	2s	-50%
`mlk_scalar_decompress_d4`	✅	1s	2s	-50%
`mlk_shake128x4_absorb_once`	✅	1s	1s	+0%
`mlk_shake128x4_squeezeblocks`	✅	1s	3s	-67%
`poly_compress_d5_native_x86_64`	✅	1s	4s	-75%
`poly_decompress_d11_native_x86_64`	✅	1s	3s	-67%
`poly_mulcache_compute_native_aarch64`	✅	1s	3s	-67%

oqs-bot · 2026-06-25T04:32:04Z

CBMC Results (ML-KEM-512)

Full Results (191 proofs)

Proof	Status	Current	Previous	Change
`TOTAL`	✅	1481s	1556s	-4.8%
`mlk_indcpa_enc`	✅	242s	250s	-3%
`mlk_indcpa_keypair_derand`	✅	200s	209s	-4%
`mlk_poly_rej_uniform`	✅	126s	131s	-4%
`mlk_rej_uniform_c`	✅	107s	115s	-7%
`rej_uniform_native_x86_64`	✅	53s	57s	-7%
`mlk_polyvec_basemul_acc_montgomery_cached_c`	✅	50s	53s	-6%
`rej_uniform_native_aarch64`	✅	36s	34s	+6%
`mlk_poly_reduce_native`	✅	32s	34s	-6%
`poly_ntt_native`	✅	30s	37s	-19%
`mlk_keccak_squeezeblocks_x4`	✅	24s	25s	-4%
`mlk_ntt_layer`	✅	23s	28s	-18%
`mlk_indcpa_dec`	✅	17s	17s	+0%
`keccakf1600x4_permute_native_x4`	✅	16s	19s	-16%
`mlk_fqmul`	✅	16s	16s	+0%
`mlk_poly_decompress_d4_native`	✅	13s	14s	-7%
`mlk_poly_decompress_d10_native`	✅	11s	14s	-21%
`mlk_polyvec_add`	✅	10s	11s	-9%
`mlk_keccak_squeeze_once`	✅	9s	6s	+50%
`mlk_ntt_butterfly_block`	✅	9s	7s	+29%
`mlk_poly_frombytes_native`	✅	8s	7s	+14%
`mlk_poly_rej_uniform_x4`	✅	8s	5s	+60%
`polyvec_basemul_acc_montgomery_cached_native`	✅	8s	9s	-11%
`mlk_invntt_layer`	✅	7s	4s	+75%
`mlk_keccak_squeezeblocks`	✅	7s	8s	-12%
`mlk_keccakf1600_permute_c`	✅	7s	6s	+17%
`mlk_poly_frommsg`	✅	7s	11s	-36%
`mlk_poly_ntt`	✅	6s	9s	-33%
`mlk_poly_sub`	✅	6s	7s	-14%
`kem_enc_derand`	✅	5s	2s	+150%
`mlk_ct_memcmp`	✅	5s	2s	+150%
`mlk_keccak_absorb_once`	✅	5s	3s	+67%
`mlk_keccak_absorb_once_x4`	✅	5s	5s	+0%
`mlk_poly_frombytes_c`	✅	5s	4s	+25%
`mlk_poly_getnoise_eta1122_4x`	✅	5s	3s	+67%
`mlk_poly_getnoise_eta1_4x_native`	✅	5s	3s	+67%
`kem_dec`	✅	4s	3s	+33%
`mlk_check_pct`	✅	4s	3s	+33%
`mlk_gen_matrix`	✅	4s	3s	+33%
`mlk_keccakf1600_extract_bytes (big endian)`	✅	4s	2s	+100%
`mlk_keccakf1600_xor_bytes (big endian)`	✅	4s	2s	+100%
`mlk_keccakf1600x4_xor_bytes_c`	✅	4s	4s	+0%
`mlk_keypair_getnoise_eta1`	✅	4s	2s	+100%
`mlk_matvec_mul`	✅	4s	3s	+33%
`mlk_poly_add`	✅	4s	6s	-33%
`mlk_poly_decompress_d4_c`	✅	4s	3s	+33%
`mlk_poly_invntt_tomont`	✅	4s	3s	+33%
`mlk_poly_mulcache_compute_native`	✅	4s	3s	+33%
`mlk_poly_reduce_c`	✅	4s	1s	+300%
`mlk_poly_tomont_c`	✅	4s	2s	+100%
`mlk_poly_tomont_native`	✅	4s	3s	+33%
`mlk_polymat_permute_bitrev_to_custom`	✅	4s	5s	-20%
`mlk_polyvec_mulcache_compute`	✅	4s	2s	+100%
`mlk_polyvec_permute_bitrev_to_custom_native`	✅	4s	5s	-20%
`mlk_polyvec_tomont`	✅	4s	2s	+100%
`mlk_scalar_signed_to_unsigned_q`	✅	4s	3s	+33%
`ntt_native_x86_64`	✅	4s	2s	+100%
`poly_frombytes_native_x86_64`	✅	4s	4s	+0%
`polyvec_basemul_acc_montgomery_cached_k3_native_aarch64`	✅	4s	2s	+100%
`keccak_f1600_x4_native_aarch64_v84a`	✅	3s	2s	+50%
`keccak_f1600_x4_native_aarch64_v8a_scalar_hybrid`	✅	3s	3s	+0%
`kem_enc`	✅	3s	2s	+50%
`kem_keypair`	✅	3s	2s	+50%
`kem_keypair_derand`	✅	3s	3s	+0%
`mlk_barrett_reduce`	✅	3s	3s	+0%
`mlk_ct_cmask_nonzero_u8`	✅	3s	2s	+50%
`mlk_keccakf1600_permute`	✅	3s	3s	+0%
`mlk_keccakf1600_xor_bytes`	✅	3s	5s	-40%
`mlk_montgomery_reduce`	✅	3s	2s	+50%
`mlk_poly_cbd_eta2`	✅	3s	3s	+0%
`mlk_poly_compress_d11`	✅	3s	3s	+0%
`mlk_poly_compress_d11_native`	✅	3s	2s	+50%
`mlk_poly_compress_d4`	✅	3s	3s	+0%
`mlk_poly_compress_d5_native`	✅	3s	3s	+0%
`mlk_poly_compress_dv`	✅	3s	2s	+50%
`mlk_poly_decompress_d11`	✅	3s	1s	+200%
`mlk_poly_decompress_d11_native`	✅	3s	2s	+50%
`mlk_poly_decompress_d4`	✅	3s	3s	+0%
`mlk_poly_decompress_d5`	✅	3s	1s	+200%
`mlk_poly_getnoise_eta1_4x`	✅	3s	6s	-50%
`mlk_poly_mulcache_compute_c`	✅	3s	1s	+200%
`mlk_poly_tobytes`	✅	3s	2s	+50%
`mlk_poly_tomont`	✅	3s	1s	+200%
`mlk_polyvec_basemul_acc_montgomery_cached`	✅	3s	4s	-25%
`mlk_rej_uniform`	✅	3s	2s	+50%
`mlk_scalar_compress_d11`	✅	3s	2s	+50%
`mlk_scalar_compress_d5`	✅	3s	4s	-25%
`mlk_scalar_decompress_d11`	✅	3s	3s	+0%
`mlk_scalar_decompress_d4`	✅	3s	3s	+0%
`mlk_shake256x4`	✅	3s	2s	+50%
`poly_decompress_d10_native_x86_64`	✅	3s	7s	-57%
`poly_decompress_d4_native_x86_64`	✅	3s	4s	-25%
`poly_decompress_d5_native_x86_64`	✅	3s	1s	+200%
`poly_getnoise_eta1122_4x_native`	✅	3s	3s	+0%
`poly_mulcache_compute_native_x86_64`	✅	3s	2s	+50%
`poly_tobytes_native_aarch64`	✅	3s	2s	+50%
`polyvec_basemul_acc_montgomery_cached_k3_native_x86_64`	✅	3s	4s	-25%
`intt_native_aarch64`	✅	2s	3s	-33%
`keccakf1600x4_xor_bytes_native`	✅	2s	3s	-33%
`kem_check_sk`	✅	2s	4s	-50%
`mlk_ct_cmask_neg_i16`	✅	2s	2s	+0%
`mlk_ct_cmask_nonzero_u16`	✅	2s	1s	+100%
`mlk_ct_cmov_zero`	✅	2s	3s	-33%
`mlk_ct_get_optblocker_i32`	✅	2s	2s	+0%
`mlk_ct_get_optblocker_u8`	✅	2s	2s	+0%
`mlk_ct_sel_uint8`	✅	2s	2s	+0%
`mlk_enc_getnoise_eta1_eta2`	✅	2s	1s	+100%
`mlk_gen_matrix_serial`	✅	2s	3s	-33%
`mlk_keccakf1600_extract_bytes`	✅	2s	2s	+0%
`mlk_keccakf1600x4_extract_bytes_c`	✅	2s	1s	+100%
`mlk_keccakf1600x4_xor_bytes`	✅	2s	2s	+0%
`mlk_poly_cbd_eta1`	✅	2s	3s	-33%
`mlk_poly_compress_d10_native`	✅	2s	4s	-50%
`mlk_poly_compress_d4_c`	✅	2s	3s	-33%
`mlk_poly_compress_d4_native`	✅	2s	1s	+100%
`mlk_poly_compress_du`	✅	2s	2s	+0%
`mlk_poly_decompress_d10`	✅	2s	4s	-50%
`mlk_poly_decompress_d10_c`	✅	2s	2s	+0%
`mlk_poly_decompress_d11_c`	✅	2s	3s	-33%
`mlk_poly_decompress_d5_c`	✅	2s	3s	-33%
`mlk_poly_decompress_d5_native`	✅	2s	2s	+0%
`mlk_poly_decompress_du`	✅	2s	2s	+0%
`mlk_poly_decompress_dv`	✅	2s	3s	-33%
`mlk_poly_getnoise_eta2`	✅	2s	2s	+0%
`mlk_poly_reduce`	✅	2s	2s	+0%
`mlk_poly_tobytes_c`	✅	2s	3s	-33%
`mlk_poly_tobytes_native`	✅	2s	3s	-33%
`mlk_poly_tomsg`	✅	2s	4s	-50%
`mlk_polyvec_compress_du`	✅	2s	1s	+100%
`mlk_polyvec_decompress_du`	✅	2s	2s	+0%
`mlk_polyvec_frombytes`	✅	2s	1s	+100%
`mlk_polyvec_invntt_tomont`	✅	2s	3s	-33%
`mlk_polyvec_ntt`	✅	2s	3s	-33%
`mlk_scalar_compress_d1`	✅	2s	3s	-33%
`mlk_scalar_compress_d10`	✅	2s	1s	+100%
`mlk_scalar_compress_d4`	✅	2s	1s	+100%
`mlk_sha3_256`	✅	2s	2s	+0%
`mlk_sha3_512`	✅	2s	2s	+0%
`mlk_shake128_absorb_once`	✅	2s	2s	+0%
`mlk_shake128_squeezeblocks`	✅	2s	4s	-50%
`mlk_value_barrier_u32`	✅	2s	2s	+0%
`mlk_value_barrier_u8`	✅	2s	1s	+100%
`ntt_native_aarch64`	✅	2s	4s	-50%
`nttunpack_native_x86_64`	✅	2s	2s	+0%
`poly_compress_d10_native_x86_64`	✅	2s	4s	-50%
`poly_compress_d11_native_x86_64`	✅	2s	1s	+100%
`poly_mulcache_compute_native_aarch64`	✅	2s	2s	+0%
`poly_reduce_native_aarch64`	✅	2s	2s	+0%
`poly_reduce_native_x86_64`	✅	2s	2s	+0%
`poly_tobytes_native_x86_64`	✅	2s	2s	+0%
`poly_tomont_native_x86_64`	✅	2s	3s	-33%
`polyvec_basemul_acc_montgomery_cached_k2_native_aarch64`	✅	2s	5s	-60%
`polyvec_basemul_acc_montgomery_cached_k4_native_aarch64`	✅	2s	2s	+0%
`rej_uniform_native`	✅	2s	1s	+100%
`intt_native_x86_64`	✅	1s	4s	-75%
`keccak_f1600_x1_native_aarch64`	✅	1s	1s	+0%
`keccak_f1600_x1_native_aarch64_v84a`	✅	1s	2s	-50%
`keccak_f1600_x4_native_aarch64_v8a_v84a_scalar_hybrid`	✅	1s	3s	-67%
`keccak_f1600_x4_native_avx2`	✅	1s	1s	+0%
`keccakf1600_permute_native`	✅	1s	2s	-50%
`keccakf1600x4_extract_bytes_native`	✅	1s	3s	-67%
`kem_check_pk`	✅	1s	2s	-50%
`mlk_ct_get_optblocker_u32`	✅	1s	2s	-50%
`mlk_ct_sel_int16`	✅	1s	2s	-50%
`mlk_keccakf1600x4_extract_bytes`	✅	1s	2s	-50%
`mlk_keccakf1600x4_permute`	✅	1s	2s	-50%
`mlk_poly_compress_d10`	✅	1s	2s	-50%
`mlk_poly_compress_d10_c`	✅	1s	2s	-50%
`mlk_poly_compress_d11_c`	✅	1s	1s	+0%
`mlk_poly_compress_d5`	✅	1s	3s	-67%
`mlk_poly_compress_d5_c`	✅	1s	3s	-67%
`mlk_poly_frombytes`	✅	1s	2s	-50%
`mlk_poly_invntt_tomont_c`	✅	1s	4s	-75%
`mlk_poly_mulcache_compute`	✅	1s	2s	-50%
`mlk_poly_ntt_c`	✅	1s	2s	-50%
`mlk_polyvec_permute_bitrev_to_custom`	✅	1s	3s	-67%
`mlk_polyvec_reduce`	✅	1s	3s	-67%
`mlk_polyvec_tobytes`	✅	1s	1s	+0%
`mlk_scalar_decompress_d10`	✅	1s	2s	-50%
`mlk_scalar_decompress_d5`	✅	1s	3s	-67%
`mlk_shake128x4_absorb_once`	✅	1s	3s	-67%
`mlk_shake128x4_squeezeblocks`	✅	1s	2s	-50%
`mlk_shake256`	✅	1s	3s	-67%
`mlk_value_barrier_i32`	✅	1s	1s	+0%
`poly_compress_d4_native_x86_64`	✅	1s	2s	-50%
`poly_compress_d5_native_x86_64`	✅	1s	1s	+0%
`poly_decompress_d11_native_x86_64`	✅	1s	2s	-50%
`poly_invntt_tomont_native`	✅	1s	4s	-75%
`poly_tomont_native_aarch64`	✅	1s	1s	+0%
`polyvec_basemul_acc_montgomery_cached_k2_native_x86_64`	✅	1s	3s	-67%
`polyvec_basemul_acc_montgomery_cached_k4_native_x86_64`	✅	1s	2s	-50%
`sys_check_capability`	✅	1s	2s	-50%

oqs-bot · 2026-06-25T04:32:42Z

CBMC Results (ML-KEM-1024)

⚠️ Attention Required

Proof	Status	Current	Previous	Change
`mlk_fqmul`	⚠️	24s	14s	+71%

Full Results (191 proofs)

Proof	Status	Current	Previous	Change
`TOTAL`	✅	2033s	1696s	+19.9%
`mlk_indcpa_enc`	✅	414s	382s	+8%
`mlk_indcpa_keypair_derand`	✅	189s	164s	+15%
`mlk_poly_rej_uniform`	✅	189s	134s	+41%
`mlk_rej_uniform_c`	✅	170s	120s	+42%
`mlk_polyvec_basemul_acc_montgomery_cached_c`	✅	92s	68s	+35%
`rej_uniform_native_x86_64`	✅	76s	58s	+31%
`poly_ntt_native`	✅	48s	39s	+23%
`mlk_poly_reduce_native`	✅	45s	35s	+29%
`rej_uniform_native_aarch64`	✅	45s	38s	+18%
`mlk_ntt_layer`	✅	41s	32s	+28%
`mlk_keccak_squeezeblocks_x4`	✅	32s	25s	+28%
`polyvec_basemul_acc_montgomery_cached_native`	✅	29s	28s	+4%
`mlk_fqmul`	⚠️	24s	14s	+71%
`mlk_polyvec_add`	✅	21s	15s	+40%
`keccakf1600x4_permute_native_x4`	✅	17s	18s	-6%
`mlk_poly_decompress_d11_native`	✅	17s	12s	+42%
`mlk_poly_decompress_d5_native`	✅	17s	14s	+21%
`mlk_indcpa_dec`	✅	13s	11s	+18%
`mlk_poly_frommsg`	✅	13s	11s	+18%
`mlk_polyvec_ntt`	✅	11s	10s	+10%
`mlk_ntt_butterfly_block`	✅	10s	8s	+25%
`mlk_poly_frombytes_native`	✅	10s	10s	+0%
`mlk_poly_ntt`	✅	10s	6s	+67%
`mlk_keccak_squeeze_once`	✅	9s	9s	+0%
`mlk_keccak_squeezeblocks`	✅	9s	8s	+12%
`mlk_keccak_absorb_once_x4`	✅	8s	4s	+100%
`mlk_poly_add`	✅	8s	3s	+167%
`mlk_poly_sub`	✅	8s	7s	+14%
`mlk_invntt_layer`	✅	7s	5s	+40%
`mlk_polymat_permute_bitrev_to_custom`	✅	7s	5s	+40%
`poly_decompress_d11_native_x86_64`	✅	7s	5s	+40%
`kem_keypair_derand`	✅	6s	3s	+100%
`mlk_gen_matrix`	✅	6s	5s	+20%
`mlk_keccakf1600_permute_c`	✅	6s	4s	+50%
`mlk_poly_frombytes_c`	✅	6s	6s	+0%
`mlk_poly_rej_uniform_x4`	✅	6s	5s	+20%
`mlk_polyvec_decompress_du`	✅	6s	1s	+500%
`poly_frombytes_native_x86_64`	✅	6s	6s	+0%
`kem_dec`	✅	5s	4s	+25%
`kem_keypair`	✅	5s	3s	+67%
`mlk_keypair_getnoise_eta1`	✅	5s	2s	+150%
`mlk_poly_compress_d11_c`	✅	5s	2s	+150%
`mlk_poly_getnoise_eta1_4x`	✅	5s	2s	+150%
`mlk_polyvec_invntt_tomont`	✅	5s	1s	+400%
`poly_reduce_native_aarch64`	✅	5s	1s	+400%
`intt_native_x86_64`	✅	4s	1s	+300%
`mlk_ct_memcmp`	✅	4s	3s	+33%
`mlk_enc_getnoise_eta1_eta2`	✅	4s	3s	+33%
`mlk_gen_matrix_serial`	✅	4s	4s	+0%
`mlk_keccak_absorb_once`	✅	4s	4s	+0%
`mlk_keccakf1600_permute`	✅	4s	2s	+100%
`mlk_poly_compress_d4_c`	✅	4s	5s	-20%
`mlk_poly_decompress_d4`	✅	4s	3s	+33%
`mlk_poly_decompress_dv`	✅	4s	2s	+100%
`mlk_poly_getnoise_eta1_4x_native`	✅	4s	5s	-20%
`mlk_poly_getnoise_eta2`	✅	4s	3s	+33%
`mlk_poly_invntt_tomont`	✅	4s	2s	+100%
`mlk_poly_tomsg`	✅	4s	2s	+100%
`mlk_polyvec_frombytes`	✅	4s	1s	+300%
`mlk_polyvec_permute_bitrev_to_custom_native`	✅	4s	1s	+300%
`mlk_polyvec_reduce`	✅	4s	3s	+33%
`mlk_scalar_compress_d4`	✅	4s	1s	+300%
`mlk_scalar_compress_d5`	✅	4s	2s	+100%
`mlk_scalar_decompress_d11`	✅	4s	2s	+100%
`mlk_shake256x4`	✅	4s	2s	+100%
`nttunpack_native_x86_64`	✅	4s	3s	+33%
`poly_decompress_d5_native_x86_64`	✅	4s	4s	+0%
`poly_mulcache_compute_native_aarch64`	✅	4s	3s	+33%
`poly_tobytes_native_aarch64`	✅	4s	2s	+100%
`poly_tomont_native_x86_64`	✅	4s	2s	+100%
`polyvec_basemul_acc_montgomery_cached_k2_native_aarch64`	✅	4s	2s	+100%
`keccak_f1600_x4_native_avx2`	✅	3s	3s	+0%
`kem_check_pk`	✅	3s	2s	+50%
`kem_check_sk`	✅	3s	2s	+50%
`kem_enc_derand`	✅	3s	2s	+50%
`mlk_ct_cmask_nonzero_u16`	✅	3s	4s	-25%
`mlk_ct_get_optblocker_u8`	✅	3s	2s	+50%
`mlk_ct_sel_int16`	✅	3s	2s	+50%
`mlk_keccakf1600_extract_bytes (big endian)`	✅	3s	2s	+50%
`mlk_keccakf1600x4_permute`	✅	3s	1s	+200%
`mlk_keccakf1600x4_xor_bytes`	✅	3s	3s	+0%
`mlk_matvec_mul`	✅	3s	3s	+0%
`mlk_montgomery_reduce`	✅	3s	3s	+0%
`mlk_poly_cbd_eta1`	✅	3s	3s	+0%
`mlk_poly_cbd_eta2`	✅	3s	2s	+50%
`mlk_poly_compress_d11`	✅	3s	2s	+50%
`mlk_poly_compress_d11_native`	✅	3s	1s	+200%
`mlk_poly_compress_d4`	✅	3s	3s	+0%
`mlk_poly_compress_d5_c`	✅	3s	3s	+0%
`mlk_poly_compress_du`	✅	3s	3s	+0%
`mlk_poly_compress_dv`	✅	3s	3s	+0%
`mlk_poly_decompress_d10`	✅	3s	1s	+200%
`mlk_poly_decompress_d10_c`	✅	3s	3s	+0%
`mlk_poly_decompress_d5_c`	✅	3s	3s	+0%
`mlk_poly_invntt_tomont_c`	✅	3s	5s	-40%
`mlk_poly_mulcache_compute_native`	✅	3s	2s	+50%
`mlk_poly_reduce_c`	✅	3s	2s	+50%
`mlk_poly_tomont_c`	✅	3s	3s	+0%
`mlk_polyvec_basemul_acc_montgomery_cached`	✅	3s	2s	+50%
`mlk_polyvec_mulcache_compute`	✅	3s	2s	+50%
`mlk_polyvec_permute_bitrev_to_custom`	✅	3s	2s	+50%
`mlk_polyvec_tobytes`	✅	3s	2s	+50%
`mlk_scalar_decompress_d4`	✅	3s	2s	+50%
`mlk_scalar_decompress_d5`	✅	3s	4s	-25%
`mlk_sha3_256`	✅	3s	2s	+50%
`mlk_sha3_512`	✅	3s	2s	+50%
`mlk_shake256`	✅	3s	2s	+50%
`mlk_value_barrier_u8`	✅	3s	3s	+0%
`ntt_native_aarch64`	✅	3s	2s	+50%
`poly_compress_d5_native_x86_64`	✅	3s	1s	+200%
`poly_decompress_d4_native_x86_64`	✅	3s	3s	+0%
`poly_reduce_native_x86_64`	✅	3s	3s	+0%
`polyvec_basemul_acc_montgomery_cached_k2_native_x86_64`	✅	3s	2s	+50%
`polyvec_basemul_acc_montgomery_cached_k3_native_x86_64`	✅	3s	1s	+200%
`polyvec_basemul_acc_montgomery_cached_k4_native_x86_64`	✅	3s	3s	+0%
`rej_uniform_native`	✅	3s	1s	+200%
`intt_native_aarch64`	✅	2s	3s	-33%
`keccak_f1600_x1_native_aarch64_v84a`	✅	2s	2s	+0%
`keccak_f1600_x4_native_aarch64_v8a_scalar_hybrid`	✅	2s	1s	+100%
`keccakf1600x4_extract_bytes_native`	✅	2s	1s	+100%
`keccakf1600x4_xor_bytes_native`	✅	2s	4s	-50%
`mlk_check_pct`	✅	2s	3s	-33%
`mlk_ct_cmask_nonzero_u8`	✅	2s	2s	+0%
`mlk_ct_cmov_zero`	✅	2s	2s	+0%
`mlk_ct_get_optblocker_i32`	✅	2s	2s	+0%
`mlk_ct_sel_uint8`	✅	2s	3s	-33%
`mlk_keccakf1600_xor_bytes (big endian)`	✅	2s	3s	-33%
`mlk_keccakf1600x4_extract_bytes`	✅	2s	2s	+0%
`mlk_keccakf1600x4_xor_bytes_c`	✅	2s	1s	+100%
`mlk_poly_compress_d10_c`	✅	2s	1s	+100%
`mlk_poly_compress_d10_native`	✅	2s	3s	-33%
`mlk_poly_compress_d4_native`	✅	2s	2s	+0%
`mlk_poly_compress_d5_native`	✅	2s	2s	+0%
`mlk_poly_decompress_d10_native`	✅	2s	3s	-33%
`mlk_poly_decompress_d11_c`	✅	2s	2s	+0%
`mlk_poly_decompress_d4_c`	✅	2s	4s	-50%
`mlk_poly_decompress_du`	✅	2s	3s	-33%
`mlk_poly_getnoise_eta1122_4x`	✅	2s	2s	+0%
`mlk_poly_mulcache_compute`	✅	2s	2s	+0%
`mlk_poly_ntt_c`	✅	2s	2s	+0%
`mlk_poly_reduce`	✅	2s	4s	-50%
`mlk_poly_tobytes_c`	✅	2s	1s	+100%
`mlk_poly_tomont_native`	✅	2s	2s	+0%
`mlk_polyvec_compress_du`	✅	2s	2s	+0%
`mlk_polyvec_tomont`	✅	2s	3s	-33%
`mlk_rej_uniform`	✅	2s	2s	+0%
`mlk_scalar_compress_d1`	✅	2s	1s	+100%
`mlk_scalar_compress_d10`	✅	2s	1s	+100%
`mlk_scalar_decompress_d10`	✅	2s	1s	+100%
`mlk_scalar_signed_to_unsigned_q`	✅	2s	5s	-60%
`mlk_shake128_absorb_once`	✅	2s	1s	+100%
`mlk_shake128_squeezeblocks`	✅	2s	4s	-50%
`mlk_shake128x4_absorb_once`	✅	2s	3s	-33%
`mlk_value_barrier_i32`	✅	2s	2s	+0%
`ntt_native_x86_64`	✅	2s	3s	-33%
`poly_compress_d10_native_x86_64`	✅	2s	5s	-60%
`poly_compress_d11_native_x86_64`	✅	2s	2s	+0%
`poly_compress_d4_native_x86_64`	✅	2s	2s	+0%
`poly_decompress_d10_native_x86_64`	✅	2s	4s	-50%
`poly_getnoise_eta1122_4x_native`	✅	2s	1s	+100%
`poly_tomont_native_aarch64`	✅	2s	1s	+100%
`polyvec_basemul_acc_montgomery_cached_k4_native_aarch64`	✅	2s	3s	-33%
`keccak_f1600_x1_native_aarch64`	✅	1s	1s	+0%
`keccak_f1600_x4_native_aarch64_v84a`	✅	1s	3s	-67%
`keccak_f1600_x4_native_aarch64_v8a_v84a_scalar_hybrid`	✅	1s	3s	-67%
`keccakf1600_permute_native`	✅	1s	2s	-50%
`kem_enc`	✅	1s	2s	-50%
`mlk_barrett_reduce`	✅	1s	1s	+0%
`mlk_ct_cmask_neg_i16`	✅	1s	1s	+0%
`mlk_ct_get_optblocker_u32`	✅	1s	4s	-75%
`mlk_keccakf1600_extract_bytes`	✅	1s	2s	-50%
`mlk_keccakf1600_xor_bytes`	✅	1s	2s	-50%
`mlk_keccakf1600x4_extract_bytes_c`	✅	1s	2s	-50%
`mlk_poly_compress_d10`	✅	1s	1s	+0%
`mlk_poly_compress_d5`	✅	1s	1s	+0%
`mlk_poly_decompress_d11`	✅	1s	2s	-50%
`mlk_poly_decompress_d4_native`	✅	1s	3s	-67%
`mlk_poly_decompress_d5`	✅	1s	3s	-67%
`mlk_poly_frombytes`	✅	1s	2s	-50%
`mlk_poly_mulcache_compute_c`	✅	1s	3s	-67%
`mlk_poly_tobytes`	✅	1s	3s	-67%
`mlk_poly_tobytes_native`	✅	1s	4s	-75%
`mlk_poly_tomont`	✅	1s	5s	-80%
`mlk_scalar_compress_d11`	✅	1s	1s	+0%
`mlk_shake128x4_squeezeblocks`	✅	1s	4s	-75%
`mlk_value_barrier_u32`	✅	1s	4s	-75%
`poly_invntt_tomont_native`	✅	1s	1s	+0%
`poly_mulcache_compute_native_x86_64`	✅	1s	2s	-50%
`poly_tobytes_native_x86_64`	✅	1s	2s	-50%
`polyvec_basemul_acc_montgomery_cached_k3_native_aarch64`	✅	1s	4s	-75%
`sys_check_capability`	✅	1s	3s	-67%

hanno-becker requested a review from a team as a code owner June 25, 2026 04:04

hanno-becker marked this pull request as draft June 25, 2026 04:07

autogen: Improve wording and reduce verbosity of documentation

c846a62

Remove references to 'shipped' assembly and instead talk explicitly about mlkem/*. Remove AI slop. Use standard autogen header in auto- generated ABI checker files. Signed-off-by: Hanno Becker <beckphan@amazon.co.uk>

hanno-becker force-pushed the autogen_fixup branch from 02afffe to c846a62 Compare June 25, 2026 04:28

hanno-becker changed the title ~~autogen: Remove stale comment from earlier version of ABI checker~~ autogen: Improve wording and reduce verbosity of documentation Jun 25, 2026

hanno-becker marked this pull request as ready for review June 25, 2026 04:40

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

autogen: Improve wording and reduce verbosity of documentation#1758

autogen: Improve wording and reduce verbosity of documentation#1758
hanno-becker wants to merge 1 commit into
mainfrom
autogen_fixup

hanno-becker commented Jun 25, 2026 •

edited

Loading

Uh oh!

oqs-bot commented Jun 25, 2026 •

edited

Loading

Uh oh!

oqs-bot commented Jun 25, 2026 •

edited

Loading

Uh oh!

oqs-bot commented Jun 25, 2026 •

edited

Loading

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Uh oh!

Conversation

hanno-becker commented Jun 25, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

oqs-bot commented Jun 25, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

CBMC Results (ML-KEM-768)

Uh oh!

oqs-bot commented Jun 25, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

CBMC Results (ML-KEM-512)

Uh oh!

oqs-bot commented Jun 25, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

CBMC Results (ML-KEM-1024)

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

hanno-becker commented Jun 25, 2026 •

edited

Loading

oqs-bot commented Jun 25, 2026 •

edited

Loading

oqs-bot commented Jun 25, 2026 •

edited

Loading

oqs-bot commented Jun 25, 2026 •

edited

Loading