Repository for the XMSS reference code, accompanying Internet Draft draft-irtf-cfrg-xmss-hash-based-signatures
Switch branches/tags
Nothing to show
Clone or download
Permalink
Failed to load latest commit information.
test Prevent overrunning stack for large benchmarks Sep 11, 2018
ui Fix OID parsing Feb 15, 2018
.gitignore Clean up tests Oct 26, 2017
.travis.yml Add TravisCI configuration Oct 31, 2017
LICENSE Simplify licensing using LICENSE file Oct 19, 2017
Makefile Add benchmarking binary/target Sep 3, 2018
README.md Add TravisCI badge Oct 31, 2017
fips202.c Clean up includes Oct 19, 2017
fips202.h Perform various reformatting / renaming Oct 23, 2017
hash.c Fix prf when n != 32 Nov 1, 2017
hash.h Rename hash functions to tweaked hashes Nov 1, 2017
hash_address.c Make addr type switching not zero out remainder Nov 1, 2017
hash_address.h Rename parameters for readability and consistency Oct 24, 2017
params.c Allow more flexible parameter selection Sep 3, 2018
params.h Allow more flexible parameter selection Sep 3, 2018
randombytes.c Refactor for more consistent style and readability Aug 3, 2017
randombytes.h Perform various reformatting / renaming Oct 23, 2017
utils.c Move ull-byte-conversions to separate utils file Nov 1, 2017
utils.h Move ull-byte-conversions to separate utils file Nov 1, 2017
wots.c Rename hash functions to tweaked hashes Nov 1, 2017
wots.h Fix typo in WOTS comments: n-byte messages, not m Nov 1, 2017
xmss.c Store OID in bigendian notation in pk and sk Jan 30, 2018
xmss.h Perform various reformatting / renaming Oct 23, 2017
xmss_commons.c More explicitly label pk parts in verification Dec 6, 2017
xmss_commons.h Do not expose l_tree function Dec 6, 2017
xmss_core.c Allow more flexible parameter selection Sep 3, 2018
xmss_core.h Allow more flexible parameter selection Sep 3, 2018
xmss_core_fast.c Allow more flexible parameter selection Sep 3, 2018

README.md

XMSS reference code Build Status

This repository contains the reference implementation that accompanies the Internet Draft "XMSS: Extended Hash-Based Signatures", draft-irtf-cfrg-xmss-hash-based-signatures.

This reference implementation supports all parameter sets as defined in the Draft at run-time (specified by prefixing the public and private keys with a 32-bit oid). Implementations that want to use compile-time parameter sets can remove the struct xmss_params function parameter.

When using the current code base, please be careful, expect changes and watch this document for further documentation. In particular, xmss_core_fast.c is long due for a serious clean-up. While this will not change its public API or output, it may affect the storage format of the BDS state (i.e. part of the secret key).

Dependencies

For the SHA-2 hash functions (i.e. SHA-256 and SHA-512), we rely on OpenSSL. Make sure to install the OpenSSL development headers. On Debian-based systems, this is achieved by installing the OpenSSL development package libssl-dev.

License

This reference implementation was written by Andreas Hülsing and Joost Rijneveld. All included code is available under the CC0 1.0 Universal Public Domain Dedication.