exchange/src/util/taler-exchange-secmod-cs.h
Gian Demarmels 5b7e8f9ac5
refactoring
2022-02-04 15:36:11 +01:00

271 lines
5.2 KiB
C

/*
This file is part of TALER
Copyright (C) 2020 Taler Systems SA
TALER is free software; you can redistribute it and/or modify it under the
terms of the GNU General Public License as published by the Free Software
Foundation; either version 3, or (at your option) any later version.
TALER is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with
TALER; see the file COPYING. If not, see <http://www.gnu.org/licenses/>
*/
/**
* @file util/taler-exchange-secmod-cs.h
* @brief IPC messages for the CS crypto helper.
* @author Christian Grothoff
* @author Gian Demarmels
* @author Lucien Heuzeveldt
*/
#ifndef TALER_EXCHANGE_SECMOD_CS_H
#define TALER_EXCHANGE_SECMOD_CS_H
#define TALER_HELPER_CS_MT_PURGE 1
#define TALER_HELPER_CS_MT_AVAIL 2
#define TALER_HELPER_CS_MT_REQ_INIT 4
#define TALER_HELPER_CS_MT_REQ_SIGN 5
#define TALER_HELPER_CS_MT_REQ_REVOKE 6
#define TALER_HELPER_CS_MT_REQ_RDERIVE 7
#define TALER_HELPER_CS_MT_RES_SIGNATURE 8
#define TALER_HELPER_CS_MT_RES_SIGN_FAILURE 9
#define TALER_HELPER_CS_MT_RES_RDERIVE 10
#define TALER_HELPER_CS_MT_RES_RDERIVE_FAILURE 11
#define TALER_HELPER_CS_SYNCED 12
GNUNET_NETWORK_STRUCT_BEGIN
/**
* Message sent if a key is available.
*/
struct TALER_CRYPTO_CsKeyAvailableNotification
{
/**
* Type is #TALER_HELPER_CS_MT_AVAIL
*/
struct GNUNET_MessageHeader header;
/**
* Number of bytes of the section name.
*/
uint32_t section_name_len;
/**
* When does the key become available?
*/
struct GNUNET_TIME_TimestampNBO anchor_time;
/**
* How long is the key available after @e anchor_time?
*/
struct GNUNET_TIME_RelativeNBO duration_withdraw;
/**
* Public key used to generate the @e sicm_sig.
*/
struct TALER_SecurityModulePublicKeyP secm_pub;
/**
* Signature affirming the announcement, of
* purpose #TALER_SIGNATURE_SM_DENOMINATION_KEY.
*/
struct TALER_SecurityModuleSignatureP secm_sig;
/**
* Denomination Public key
*/
struct GNUNET_CRYPTO_CsPublicKey denom_pub;
/* followed by @e section_name bytes of the configuration section name
of the denomination of this key */
};
/**
* Message sent if a key was purged.
*/
struct TALER_CRYPTO_CsKeyPurgeNotification
{
/**
* Type is #TALER_HELPER_CS_MT_PURGE.
*/
struct GNUNET_MessageHeader header;
/**
* For now, always zero.
*/
uint32_t reserved;
/**
* Hash of the public key of the purged CS key.
*/
struct TALER_CsPubHashP h_cs;
};
/**
* Message sent if a signature is requested.
*/
struct TALER_CRYPTO_CsSignRequest
{
/**
* Type is #TALER_HELPER_CS_MT_REQ_SIGN.
*/
struct GNUNET_MessageHeader header;
/**
* For now, always zero.
*/
uint32_t reserved;
/**
* Hash of the public key of the CS key to use for the signature.
*/
struct TALER_CsPubHashP h_cs;
/**
* Planchet containing message to sign
* and nonce to derive R from
*/
struct TALER_BlindedCsPlanchet planchet;
};
/**
* Message sent if a signature is requested.
*/
struct TALER_CRYPTO_CsRDeriveRequest
{
/**
* Type is #TALER_HELPER_CS_MT_REQ_RDERIVE.
*/
struct GNUNET_MessageHeader header;
/**
* For now, always zero.
*/
uint32_t reserved;
/**
* Hash of the public key of the CS key to use for the derivation.
*/
struct TALER_CsPubHashP h_cs;
/**
* Withdraw nonce to derive R from
*/
struct TALER_WithdrawNonce nonce;
};
/**
* Message sent if a key was revoked.
*/
struct TALER_CRYPTO_CsRevokeRequest
{
/**
* Type is #TALER_HELPER_CS_MT_REQ_REVOKE.
*/
struct GNUNET_MessageHeader header;
/**
* For now, always zero.
*/
uint32_t reserved;
/**
* Hash of the public key of the revoked CS key.
*/
struct TALER_CsPubHashP h_cs;
};
/**
* Message sent if a signature was successfully computed.
*/
struct TALER_CRYPTO_SignResponse
{
/**
* Type is #TALER_HELPER_CS_MT_RES_SIGNATURE.
*/
struct GNUNET_MessageHeader header;
/**
* For now, always zero.
*/
uint32_t reserved;
/**
* Contains the blindided s and the chosen b
*/
struct TALER_BlindedDenominationCsSignAnswer cs_answer;
};
/**
* Message sent if a R is successfully derived
*/
struct TALER_CRYPTO_RDeriveResponse
{
/**
* Type is #TALER_HELPER_CS_MT_RES_RDERIVE.
*/
struct GNUNET_MessageHeader header;
/**
* For now, always zero.
*/
uint32_t reserved;
/**
* derived R
*/
struct TALER_DenominationCsPublicR r_pub;
};
/**
* Message sent if signing failed.
*/
struct TALER_CRYPTO_SignFailure
{
/**
* Type is #TALER_HELPER_CS_MT_RES_SIGN_FAILURE.
*/
struct GNUNET_MessageHeader header;
/**
* If available, Taler error code. In NBO.
*/
uint32_t ec;
};
/**
* Message sent if derivation failed.
*/
struct TALER_CRYPTO_RDeriveFailure
{
/**
* Type is #TALER_HELPER_CS_MT_RES_RDERIVE_FAILURE.
*/
struct GNUNET_MessageHeader header;
/**
* If available, Taler error code. In NBO.
*/
uint32_t ec;
};
GNUNET_NETWORK_STRUCT_END
#endif