root/crypto/openssl/crypto/slh_dsa/slh_adrs.h
/*
 * Copyright 2024-2025 The OpenSSL Project Authors. All Rights Reserved.
 *
 * Licensed under the Apache License 2.0 (the "License").  You may not use
 * this file except in compliance with the License.  You can obtain a copy
 * in the file LICENSE in the source distribution or at
 * https://www.openssl.org/source/license.html
 */

#include <openssl/e_os2.h>

/*
 * An Address object is used to store a blob of data that is used by hash
 * functions. It stores information related to the type of operation, as well as
 * information related to tree addresses and heights.
 * SHAKE based algorithms use 32 bytes for this object, whereas SHA2 based
 * algorithms use a compressed format of 22 bytes. For this reason there are
 * different method tables to support the different formats.
 * FIPS 205 Section 4.2 describes the SHAKE related functions.
 * The compressed format is discussed in Section 11.2.
 */

#define SLH_ADRS_SIZE 32 /* size of the ADRS blob */
#define SLH_ADRSC_SIZE 22 /* size of a compact ADRS blob */
#define SLH_ADRS_SIZE_MAX SLH_ADRS_SIZE

/* 7 Different types of addresses */
#define SLH_ADRS_TYPE_WOTS_HASH 0
#define SLH_ADRS_TYPE_WOTS_PK 1
#define SLH_ADRS_TYPE_TREE 2
#define SLH_ADRS_TYPE_FORS_TREE 3
#define SLH_ADRS_TYPE_FORS_ROOTS 4
#define SLH_ADRS_TYPE_WOTS_PRF 5
#define SLH_ADRS_TYPE_FORS_PRF 6

#define SLH_ADRS_DECLARE(a) uint8_t a[SLH_ADRS_SIZE_MAX]
#define SLH_ADRS_FUNC_DECLARE(ctx, adrsf) \
    const SLH_ADRS_FUNC *adrsf = ctx->adrs_func
#define SLH_ADRS_FN_DECLARE(adrsf, t) OSSL_SLH_ADRS_FUNC_##t *t = adrsf->t

typedef void(OSSL_SLH_ADRS_FUNC_zero)(uint8_t *adrs);
typedef void(OSSL_SLH_ADRS_FUNC_copy)(uint8_t *dst, const uint8_t *src);
typedef void(OSSL_SLH_ADRS_FUNC_copy_keypair_address)(uint8_t *dst, const uint8_t *src);
/*
 * Note that the tree address is actually 12 bytes in uncompressed format,
 * but we only use 8 bytes
 */
typedef void(OSSL_SLH_ADRS_FUNC_set_tree_address)(uint8_t *adrs, uint64_t in);
typedef void(OSSL_SLH_ADRS_FUNC_set_layer_address)(uint8_t *adrs, uint32_t layer);
typedef void(OSSL_SLH_ADRS_FUNC_set_type_and_clear)(uint8_t *adrs, uint32_t type);
typedef void(OSSL_SLH_ADRS_FUNC_set_keypair_address)(uint8_t *adrs, uint32_t in);
typedef void(OSSL_SLH_ADRS_FUNC_set_chain_address)(uint8_t *adrs, uint32_t in);
typedef void(OSSL_SLH_ADRS_FUNC_set_tree_height)(uint8_t *adrs, uint32_t in);
typedef void(OSSL_SLH_ADRS_FUNC_set_hash_address)(uint8_t *adrs, uint32_t in);
typedef void(OSSL_SLH_ADRS_FUNC_set_tree_index)(uint8_t *adrs, uint32_t in);

typedef struct slh_adrs_func_st {
    OSSL_SLH_ADRS_FUNC_set_layer_address *set_layer_address;
    OSSL_SLH_ADRS_FUNC_set_tree_address *set_tree_address;
    OSSL_SLH_ADRS_FUNC_set_type_and_clear *set_type_and_clear;
    OSSL_SLH_ADRS_FUNC_set_keypair_address *set_keypair_address;
    OSSL_SLH_ADRS_FUNC_copy_keypair_address *copy_keypair_address;
    OSSL_SLH_ADRS_FUNC_set_chain_address *set_chain_address;
    OSSL_SLH_ADRS_FUNC_set_tree_height *set_tree_height;
    OSSL_SLH_ADRS_FUNC_set_hash_address *set_hash_address;
    OSSL_SLH_ADRS_FUNC_set_tree_index *set_tree_index;
    OSSL_SLH_ADRS_FUNC_zero *zero;
    OSSL_SLH_ADRS_FUNC_copy *copy;
} SLH_ADRS_FUNC;

const SLH_ADRS_FUNC *ossl_slh_get_adrs_fn(int is_compressed);