1 files changed, 66 insertions, 0 deletions
diff --git a/Reference_Implementation/SHA3api_ref.h b/Reference_Implementation/SHA3api_ref.h
new file mode 100644
index 000000000000..6d62304e59b7
--- /dev/null
+++ b/Reference_Implementation/SHA3api_ref.h
@@ -0,0 +1,66 @@
+#ifndef _AHS_API_H_
+#define _AHS_API_H_
+
+/***********************************************************************
+**
+** Interface declarations of the AHS API using the Skein hash function.
+**
+** Source code author: Doug Whiting, 2008.
+**
+** This algorithm and source code is released to the public domain.
+** 
+************************************************************************/
+
+#include "skein.h"
+
+typedef enum
+    {
+    SUCCESS     = SKEIN_SUCCESS,
+    FAIL        = SKEIN_FAIL,
+    BAD_HASHLEN = SKEIN_BAD_HASHLEN
+    }
+    HashReturn;
+
+typedef size_t   DataLength;                /* bit count  type */
+typedef u08b_t   BitSequence;               /* bit stream type */
+
+typedef struct
+    {
+    uint_t  statebits;                      /* 256, 512, or 1024 */
+    union
+        {
+        Skein_Ctxt_Hdr_t h;                 /* common header "overlay" */
+        Skein_256_Ctxt_t ctx_256;
+        Skein_512_Ctxt_t ctx_512;
+        Skein1024_Ctxt_t ctx1024;
+        } u;
+    }
+    hashState;
+
+/* "incremental" hashing API */
+HashReturn Init  (hashState *state, int hashbitlen);
+HashReturn Update(hashState *state, const BitSequence *data, DataLength databitlen);
+HashReturn Final (hashState *state,       BitSequence *hashval);
+
+/* "all-in-one" call */
+HashReturn Hash  (int hashbitlen,   const BitSequence *data, 
+                  DataLength databitlen,  BitSequence *hashval);
+
+
+/*
+** Re-define the compile-time constants below to change the selection
+** of the Skein state size in the Init() function in SHA3api_ref.c.
+**
+** That is, the NIST API does not allow for explicit selection of the
+** Skein block size, so it must be done implicitly in the Init() function.
+** The selection is controlled by these constants.
+*/
+#ifndef SKEIN_256_NIST_MAX_HASHBITS
+#define SKEIN_256_NIST_MAX_HASHBITS (0)
+#endif
+
+#ifndef SKEIN_512_NIST_MAX_HASHBITS
+#define SKEIN_512_NIST_MAX_HASHBITS (512)
+#endif
+
+#endif  /* ifdef _AHS_API_H_ */