Skip to content

Commit

Permalink
Release 1.0.0
Browse files Browse the repository at this point in the history
  • Loading branch information
dorssel committed Apr 28, 2023
1 parent 99fdfac commit 3f706e1
Show file tree
Hide file tree
Showing 348 changed files with 29,563 additions and 0 deletions.
19 changes: 19 additions & 0 deletions .reuse/dep5
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
Format: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
Upstream-Name: xmss-documentation
Source: https://github.com/FoxCryptoNL/xmss-documentation

Files: docs/*
Copyright: 2023 Fox Crypto B.V.
License: CC-BY-4.0

Files: docs/doxygen-awesome*
Copyright: 2021-2023 jothepro
License: MIT

Files: docs/katex* docs/fonts/KaTeX*
Copyright: 2013-2020 Khan Academy and other contributors
License: MIT

Files: docs/mermaid*
Copyright: 2014-2022 Knut Sveidqvist
License: MIT
156 changes: 156 additions & 0 deletions LICENSES/CC-BY-4.0.txt

Large diffs are not rendered by default.

9 changes: 9 additions & 0 deletions LICENSES/MIT.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
MIT License

Copyright (c) <year> <copyright holders>

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
38 changes: 38 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,38 @@
<!--
SPDX-FileCopyrightText: 2023 Fox Crypto B.V.
SPDX-License-Identifier: CC-BY-4.0
-->

# XMSS

eXtended Merkle Signature Scheme is a post-quantum safe signature algorithm
([RFC](https://datatracker.ietf.org/doc/html/rfc8391)).

![XMSS C Documentation License](https://img.shields.io/github/license/FoxCryptoNL/xmss-documentation?style=plastic)
[![XMSS C Documentation Release](https://img.shields.io/github/v/release/FoxCryptoNL/xmss-documentation?style=plastic)](https://github.com/FoxCryptoNL/xmss-documentation/releases)

## XMSS C Library Documentation

This repository contains the documentation of the XMSS C Library. For more information about the complete project,
please visit [https://github.com/FoxCryptoNL/xmss](https://github.com/FoxCryptoNL/xmss).

The documentation can be viewed online via
[https://FoxCryptoNL.github.io/xmss-documentation](https://FoxCryptoNL.github.io/xmss-documentation).

This repository will only be updated when a new release of the documentation of the XMSS C Library is published. The
documentation may be updated more frequently than the library source code. This includes the API documentation that is
generated from the source code. While this means that the source code and the published API documentation may slightly
differ, this will allow the documentation to be updated more frequently.

## Issues

Issues regarding the documentation, including the API documentation generated from the source code, can be reported in
this repository's [issue tracker](https://github.com/FoxCryptoNL/xmss-documentation/issues).

For reporting (security) issues regarding the implementation, please refer to the
[library's repository](https://github.com/FoxCryptoNL/xmss-library).

## Discussions

Discussions about the documentation, including the API documentation generated from the source code, can be held in the
[documentation discussions](https://github.com/FoxCryptoNL/xmss-documentation/discussions).
Empty file added docs/.nojekyll
Empty file.
Binary file added docs/FOX-CRYPTO.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
397 changes: 397 additions & 0 deletions docs/LICENSE.txt

Large diffs are not rendered by default.

154 changes: 154 additions & 0 deletions docs/annotated.html
Original file line number Diff line number Diff line change
@@ -0,0 +1,154 @@
<!-- HTML header for doxygen 1.9.1-->
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
<head>
<meta charset="utf-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
<meta name="generator" content="Doxygen 1.9.1"/>
<meta name="viewport" content="width=device-width, initial-scale=1"/>
<title>XMSS Library: Class List</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<link href="navtree.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="resize.js"></script>
<script type="text/javascript" src="navtreedata.js"></script>
<script type="text/javascript" src="navtree.js"></script>
<link href="search/search.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="search/searchdata.js"></script>
<script type="text/javascript" src="search/search.js"></script>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
<link href="custom.css" rel="stylesheet" type="text/css"/>
<link href="doxygen-awesome.css" rel="stylesheet" type="text/css"/>
<link href="doxygen-awesome-sidebar-only.css" rel="stylesheet" type="text/css"/>
<link href="doxygen-awesome-sidebar-only-darkmode-toggle.css" rel="stylesheet" type="text/css"/>
<link href="katex.min.css" rel="stylesheet" type="text/css"/>
<!-- KaTeX -->
<script type="text/javascript" defer src="katex.min.js"></script>
<script type="text/javascript" defer src="auto-render.min.js"></script>
<script type="text/javascript">
document.addEventListener("DOMContentLoaded", function() {
renderMathInElement(document.body, {
delimiters: [
{left: '$$', right: '$$', display: true},
{left: '$', right: '$', display: false}
],
macros: {
'\\Keccak': '\\text{K\\footnotesize{ECCAK}}'
}
});
});
</script>
<!-- end: KaTeX -->
<!-- Doxygen Awesome -->
<script type="text/javascript" src="doxygen-awesome-darkmode-toggle.js"></script>
<script type="text/javascript" src="doxygen-awesome-fragment-copy-button.js"></script>
<script type="text/javascript" src="doxygen-awesome-paragraph-link.js"></script>
<script type="text/javascript" src="doxygen-awesome-interactive-toc.js"></script>
<script type="text/javascript">
DoxygenAwesomeDarkModeToggle.init()
DoxygenAwesomeFragmentCopyButton.init()
DoxygenAwesomeParagraphLink.init()
DoxygenAwesomeInteractiveToc.init()
</script>
<!-- end: Doxygen Awesome -->
<!-- Final overrides (glue) -->
<link href="custom.css" rel="stylesheet" type="text/css"/>
<!-- end: Final overrides (glue) -->
</head>
<body>
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
<tbody>
<tr style="height: 56px;">
<td id="projectlogo"><img alt="Logo" src="FOX-CRYPTO.png"/></td>
<td id="projectalign" style="padding-left: 0.5em;">
<div id="projectname">XMSS Library
</div>
</td>
</tr>
</tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.9.1 -->
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&amp;dn=gpl-2.0.txt GPL-v2 */
var searchBox = new SearchBox("searchBox", "search",false,'Search','.html');
/* @license-end */
</script>
<script type="text/javascript" src="menudata.js"></script>
<script type="text/javascript" src="menu.js"></script>
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&amp;dn=gpl-2.0.txt GPL-v2 */
$(function() {
initMenu('',true,false,'search.php','Search');
$(document).ready(function() { init_search(); });
});
/* @license-end */</script>
<div id="main-nav"></div>
</div><!-- top -->
<div id="side-nav" class="ui-resizable side-nav-resizable">
<div id="nav-tree">
<div id="nav-tree-contents">
<div id="nav-sync" class="sync"></div>
</div>
</div>
<div id="splitbar" style="-moz-user-select:none;"
class="ui-resizable-handle">
</div>
</div>
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&amp;dn=gpl-2.0.txt GPL-v2 */
$(document).ready(function(){initNavTree('annotated.html',''); initResizable(); });
/* @license-end */
</script>
<div id="doc-content">
<!-- window showing the filter options -->
<div id="MSearchSelectWindow"
onmouseover="return searchBox.OnSearchSelectShow()"
onmouseout="return searchBox.OnSearchSelectHide()"
onkeydown="return searchBox.OnSearchSelectKey(event)">
</div>

<!-- iframe showing the search results (closed by default) -->
<div id="MSearchResultsWindow">
<iframe src="javascript:void(0)" frameborder="0"
name="MSearchResults" id="MSearchResults">
</iframe>
</div>

<div class="header">
<div class="headertitle">
<div class="title">Class List</div> </div>
</div><!--header-->
<div class="contents">
<div class="textblock">Here are the classes, structs, unions and interfaces with brief descriptions:</div><div class="directory">
<table class="directory">
<tr id="row_0_" class="even"><td class="entry"><span style="width:16px;display:inline-block;">&#160;</span><span class="icona"><span class="icon">C</span></span><a class="el" href="structXmssBuffer.html" target="_self">XmssBuffer</a></td><td class="desc">A pointer to a buffer with a given size </td></tr>
<tr id="row_1_"><td class="entry"><span style="width:16px;display:inline-block;">&#160;</span><span class="icona"><span class="icon">C</span></span><a class="el" href="structXmssNativeValue256.html" target="_self">XmssNativeValue256</a></td><td class="desc">The internal (native) representation of a 256-bit value </td></tr>
<tr id="row_2_" class="even"><td class="entry"><span style="width:16px;display:inline-block;">&#160;</span><span class="icona"><span class="icon">C</span></span><a class="el" href="structXmssPrivateKeyStatefulBlob.html" target="_self">XmssPrivateKeyStatefulBlob</a></td><td class="desc">A stored stateful private key part </td></tr>
<tr id="row_3_"><td class="entry"><span style="width:16px;display:inline-block;">&#160;</span><span class="icona"><span class="icon">C</span></span><a class="el" href="structXmssPrivateKeyStatelessBlob.html" target="_self">XmssPrivateKeyStatelessBlob</a></td><td class="desc">A stored stateless private key part </td></tr>
<tr id="row_4_" class="even"><td class="entry"><span style="width:16px;display:inline-block;">&#160;</span><span class="icona"><span class="icon">C</span></span><a class="el" href="structXmssPublicKey.html" target="_self">XmssPublicKey</a></td><td class="desc">Exportable format for a public key </td></tr>
<tr id="row_5_"><td class="entry"><span style="width:16px;display:inline-block;">&#160;</span><span class="icona"><span class="icon">C</span></span><a class="el" href="structXmssPublicKeyBlob.html" target="_self">XmssPublicKeyBlob</a></td><td class="desc">Structure containing the size and the public key formatted for export </td></tr>
<tr id="row_6_" class="even"><td class="entry"><span style="width:16px;display:inline-block;">&#160;</span><span class="icona"><span class="icon">C</span></span><a class="el" href="structXmssPublicKeyInternalBlob.html" target="_self">XmssPublicKeyInternalBlob</a></td><td class="desc">A stored public key for the signing library </td></tr>
<tr id="row_7_"><td class="entry"><span style="width:16px;display:inline-block;">&#160;</span><span class="icona"><span class="icon">C</span></span><a class="el" href="structXmssSignature.html" target="_self">XmssSignature</a></td><td class="desc">Exportable format for a signature </td></tr>
<tr id="row_8_" class="even"><td class="entry"><span style="width:16px;display:inline-block;">&#160;</span><span class="icona"><span class="icon">C</span></span><a class="el" href="structXmssSignatureBlob.html" target="_self">XmssSignatureBlob</a></td><td class="desc">Structure that embeds the exportable format for a signature, along with the signature's data size </td></tr>
<tr id="row_9_"><td class="entry"><span style="width:16px;display:inline-block;">&#160;</span><span class="icona"><span class="icon">C</span></span><a class="el" href="structXmssValue256.html" target="_self">XmssValue256</a></td><td class="desc">A generic 256-bit value, represented as a byte stream </td></tr>
</table>
</div><!-- directory -->
</div><!-- contents -->
</div><!-- doc-content -->
<!-- HTML footer for doxygen 1.9.1-->
<!-- start footer part -->
<div id="nav-path" class="navpath"><!-- id is needed for treeview function! -->
<ul>
<li class="footer">Generated by <a href="https://www.doxygen.org/index.html"><img class="footer" src="doxygen.svg" width="104" height="31" alt="doxygen"/></a> 1.9.1 </li>
</ul>
</div>
</body>
<!-- Mermaid -->
<script type="text/javascript" defer src="mermaid.min.js"></script>
<!-- end: Mermaid -->
</html>
13 changes: 13 additions & 0 deletions docs/annotated_dup.js
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
var annotated_dup =
[
[ "XmssBuffer", "structXmssBuffer.html", "structXmssBuffer" ],
[ "XmssNativeValue256", "structXmssNativeValue256.html", "structXmssNativeValue256" ],
[ "XmssPrivateKeyStatefulBlob", "structXmssPrivateKeyStatefulBlob.html", "structXmssPrivateKeyStatefulBlob" ],
[ "XmssPrivateKeyStatelessBlob", "structXmssPrivateKeyStatelessBlob.html", "structXmssPrivateKeyStatelessBlob" ],
[ "XmssPublicKey", "structXmssPublicKey.html", "structXmssPublicKey" ],
[ "XmssPublicKeyBlob", "structXmssPublicKeyBlob.html", "structXmssPublicKeyBlob" ],
[ "XmssPublicKeyInternalBlob", "structXmssPublicKeyInternalBlob.html", "structXmssPublicKeyInternalBlob" ],
[ "XmssSignature", "structXmssSignature.html", "structXmssSignature" ],
[ "XmssSignatureBlob", "structXmssSignatureBlob.html", "structXmssSignatureBlob" ],
[ "XmssValue256", "structXmssValue256.html", "structXmssValue256" ]
];
1 change: 1 addition & 0 deletions docs/auto-render.min.js

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

Binary file added docs/bc_s.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/bdwn.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading

0 comments on commit 3f706e1

Please sign in to comment.