// This file is under GNU General Public License 3.0

 // see LICENSE.txt

 #pragma once

 #include "key_reset.h"

 #include "pEpEngine.h"

 #include "keymanagement.h"

 #include "message.h"

 #include "message_api.h"

 #include "cryptotech.h"

 #ifdef __cplusplus

 extern "C" {

 #endif

 // key_reset() - reset the database status for a key, removing all trust information

 //               and default database connections. For own keys, also revoke the key

 //               and communicate the revocation and new key to partners we have sent

 //               mail to recently from the specific identity (i.e. address/user_id)

 //               that contacted them. We also in this case set up information so that

 //               if someone we mail uses the wrong key and wasn't yet contacted,

 //               we can send them the reset information from the right address.

 //

 //               Can be called manually or through another protocol.

 //

 //  parameters:

 //      session (in)            session handle

 //      fpr (in)                fingerprint of key to reset. If NULL and ident is NULL,

 //                              we reset all keys for the own user. If NULL and ident is

 //                              an own identity, we reset the default key for that

 //                              identity. If that own identity has no default key, we

 //                              reset the user default.

 //                              if it is NULL and there is a non-own identity, this is

 //                              currently undefined and will return an error. Later, we

 //                              may decide on semantics for it (e.g. remove all keys

 //                              in the DB for that identity)

 //      ident (in)              identity for which the key reset should occur.

 //                              if NULL and fpr is non-NULL, we'll reset the key for all

 //                              associated identities. If both ident and fpr are NULL, see 

 //                              the fpr arg documentation.

 //

 //      Note: ident->fpr is always ignored

 //

 //

 DYNAMIC_API PEP_STATUS key_reset(

         PEP_SESSION session,

         const char* fpr,

         pEp_identity* ident

     );

 PEP_STATUS has_key_reset_been_sent(

         PEP_SESSION session, 

         const char* user_id, 

         const char* revoked_fpr,

         bool* contacted);

 PEP_STATUS set_reset_contact_notified(

         PEP_SESSION session,

         const char* revoke_fpr,

         const char* contact_id

     );

 PEP_STATUS receive_key_reset(PEP_SESSION session,

                              message* reset_msg);

 PEP_STATUS create_standalone_key_reset_message(PEP_SESSION session,

                                                message** dst, 

                                                pEp_identity* recip,

                                                const char* old_fpr,

                                                const char* new_fpr);

 PEP_STATUS send_key_reset_to_recents(PEP_SESSION session,

                                      const char* old_fpr, 

                                      const char* new_fpr);

 #ifdef __cplusplus

 }

 #endif