How boschresearch/pq-wolfssl works
pq-wolfSSL is a wolfSSL 4.7.0 fork that adds post-quantum cryptography to TLS 1.3, X.509 certificates, and cryptographic benchmarking. The principal workflow is a TLS peer using wolfSSL’s TLS implementation, which relies on wolfCrypt for cryptographic operations; the fork additionally integrates PQ key exchange and signatures into handshakes and certificate operations. The tree also contains many embedded-platform examples and compatibility headers. Relationships among unsampled PQ and certificate internals are based on README capability statements, not inspected implementation details.
Main entry points: tls13.c TLS 1.3 handshake · src PQC benchmarks · asn.h ASN.1 certificates · ssl.h TLS API
Components 27
TLS protocol
- TLS engine
src/ssl.c - TLS versions
src/tls.c - TLS 1.3 handshake
src/tls13.c
Cryptography
- Crypto API
wolfssl/wolfcrypt/settings.h - Kyber KEM
wolfcrypt/src/kyber.c - Dilithium signatures
wolfcrypt/src/dilithium.c - Falcon signatures
wolfcrypt/src/falcon.c - SPHINCS+ signatures
wolfcrypt/src/sphincs.c - XMSS signatures
wolfcrypt/src/xmss.c - Crypto utilities
wolfcrypt/src/misc.c - PQC benchmarks
wolfcrypt/src
Certificates and API
- TLS API
wolfssl/ssl.h - ASN.1 certificates
wolfssl/wolfcrypt/asn.h - OCSP support
wolfssl/ocsp.h
Embedded examples
- Micrium TLS client
IDE/ECLIPSE/MICRIUM/client_wolfssl.c - Micrium client interface
IDE/ECLIPSE/MICRIUM/client_wolfssl.h - Renesas TLS demo
IDE/Renesas/cs+/Projects/t4_demo/wolf_client.c - Renesas demo interface
IDE/Renesas/cs+/Projects/t4_demo/wolf_demo.h - STM32 example
IDE/STM32Cube/main.c - STM32 example interface
IDE/STM32Cube/wolfssl_example.h - Azure client
IDE/VS-AZURE-SPHERE/client/client.c - Azure client interface
IDE/VS-AZURE-SPHERE/client/client.h - MQX TLS client
mqx/wolfssl_client/Sources/main.c - MQX crypto benchmark
mqx/wolfcrypt_benchmark/Sources/main.c - MQX crypto tests
mqx/wolfcrypt_test/Sources/main.c - MCAPI configuration
mcapi/user_settings.h
Other components
- TLS peer
Connections 23
- TLS peer → TLS API: uses TLS
README - TLS API → OCSP support: exposes OCSP
wolfssl/ssl.h - TLS API → ASN.1 certificates: references ASN.1
wolfssl/ssl.h - TLS engine → TLS versions: uses protocol
- TLS 1.3 handshake → Kyber KEM: uses key exchange
README - TLS 1.3 handshake → Dilithium signatures: uses authentication
README - TLS 1.3 handshake → Falcon signatures: uses authentication
README - TLS 1.3 handshake → SPHINCS+ signatures: uses authentication
README - TLS 1.3 handshake → XMSS signatures: uses authentication
README - ASN.1 certificates → Dilithium signatures: supports PQ certificates
README - ASN.1 certificates → Falcon signatures: supports PQ certificates
README - ASN.1 certificates → SPHINCS+ signatures: supports PQ certificates
README - ASN.1 certificates → XMSS signatures: supports PQ certificates
README - PQC benchmarks → Kyber KEM: benchmarks algorithms
README - PQC benchmarks → Dilithium signatures: benchmarks algorithms
README - PQC benchmarks → Falcon signatures: benchmarks algorithms
README - PQC benchmarks → SPHINCS+ signatures: benchmarks algorithms
README - PQC benchmarks → XMSS signatures: benchmarks algorithms
README - Crypto API → MCAPI configuration: includes settings
wolfssl/wolfcrypt/settings.h - Micrium TLS client → Micrium client interface: includes interface
IDE/ECLIPSE/MICRIUM/client_wolfssl.c - Renesas TLS demo → Renesas demo interface: includes interface
IDE/Renesas/cs+/Projects/t4_demo/wolf_client.c - STM32 example → STM32 example interface: includes interface
IDE/STM32Cube/main.c - Azure client → Azure client interface: includes interface
IDE/VS-AZURE-SPHERE/client/client.c