271 lines
5.2 KiB
C
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
|