deltachat.h

#ifndef __DELTACHAT_H__
#define __DELTACHAT_H__
#ifdef __cplusplus
extern "C" {
#endif
 
 
#ifndef PY_CFFI
#include <stdint.h>
#include <time.h>
#endif
 
 
typedef struct _dc_context   dc_context_t;
typedef struct _dc_accounts  dc_accounts_t;
typedef struct _dc_array     dc_array_t;
typedef struct _dc_chatlist  dc_chatlist_t;
typedef struct _dc_chat      dc_chat_t;
typedef struct _dc_msg       dc_msg_t;
typedef struct _dc_contact   dc_contact_t;
typedef struct _dc_lot       dc_lot_t;
typedef struct _dc_provider  dc_provider_t;
typedef struct _dc_event     dc_event_t;
typedef struct _dc_event_emitter dc_event_emitter_t;
typedef struct _dc_jsonrpc_instance dc_jsonrpc_instance_t;
typedef struct _dc_backup_provider dc_backup_provider_t;
 
// Alias for backwards compatibility, use dc_event_emitter_t instead.
typedef struct _dc_event_emitter dc_accounts_event_emitter_t;

 

 
// create/open/config/information

dc_context_t*   dc_context_new               (const char* os_name, const char* dbfile, const char* blobdir);
 

dc_context_t*   dc_context_new_closed        (const char* dbfile);
 

int             dc_context_open              (dc_context_t *context, const char* passphrase);
 

int             dc_context_change_passphrase (dc_context_t* context, const char* passphrase);
 

int             dc_context_is_open           (dc_context_t *context);
 

void            dc_context_unref             (dc_context_t* context);
 

uint32_t        dc_get_id                    (dc_context_t* context);
 

dc_event_emitter_t* dc_get_event_emitter(dc_context_t* context);
 

char*           dc_get_blobdir               (const dc_context_t* context);
 

int             dc_set_config                (dc_context_t* context, const char* key, const char* value);
 

char*           dc_get_config                (dc_context_t* context, const char* key);
 

int             dc_set_stock_translation(dc_context_t* context, uint32_t stock_id, const char* stock_msg);
 

int             dc_set_config_from_qr   (dc_context_t* context, const char* qr);
 

char*           dc_get_info                  (const dc_context_t* context);
 

char*           dc_get_oauth2_url            (dc_context_t* context, const char* addr, const char* redirect_uri);
 
 
#define DC_CONNECTIVITY_NOT_CONNECTED        1000
#define DC_CONNECTIVITY_CONNECTING           2000
#define DC_CONNECTIVITY_WORKING              3000
#define DC_CONNECTIVITY_CONNECTED            4000
 

int             dc_get_connectivity          (dc_context_t* context);
 

char*           dc_get_connectivity_html     (dc_context_t* context);
 
 
#define DC_PUSH_NOT_CONNECTED 0
#define DC_PUSH_HEARTBEAT     1
#define DC_PUSH_CONNECTED     2

int              dc_get_push_state           (dc_context_t* context);
 
 
// connect

void            dc_configure                 (dc_context_t* context);
 

int             dc_is_configured   (const dc_context_t* context);
 

void            dc_start_io     (dc_context_t* context);

void            dc_stop_io(dc_context_t* context);

void            dc_maybe_network             (dc_context_t* context);
 
 

int             dc_preconfigure_keypair        (dc_context_t* context, const char *secret_data);
 
 
// handle chatlists
 
#define         DC_GCL_ARCHIVED_ONLY         0x01
#define         DC_GCL_NO_SPECIALS           0x02
#define         DC_GCL_ADD_ALLDONE_HINT      0x04
#define         DC_GCL_FOR_FORWARDING        0x08
 

dc_chatlist_t*  dc_get_chatlist              (dc_context_t* context, int flags, const char* query_str, uint32_t query_id);
 
 
// handle chats

uint32_t        dc_create_chat_by_contact_id (dc_context_t* context, uint32_t contact_id);
 

uint32_t        dc_get_chat_id_by_contact_id (dc_context_t* context, uint32_t contact_id);
 

uint32_t        dc_send_msg                  (dc_context_t* context, uint32_t chat_id, dc_msg_t* msg);

uint32_t        dc_send_msg_sync                  (dc_context_t* context, uint32_t chat_id, dc_msg_t* msg);
 

uint32_t        dc_send_text_msg             (dc_context_t* context, uint32_t chat_id, const char* text_to_send);
 

void            dc_send_edit_request         (dc_context_t* context, uint32_t msg_id, const char* new_text);
 

 void            dc_send_delete_request       (dc_context_t* context, const uint32_t* msg_ids, int msg_cnt);
 

uint32_t dc_send_videochat_invitation (dc_context_t* context, uint32_t chat_id);
 

int dc_send_webxdc_status_update (dc_context_t* context, uint32_t msg_id, const char* json, const char* descr);
 

char* dc_get_webxdc_status_updates (dc_context_t* context, uint32_t msg_id, uint32_t serial);
 

void             dc_set_webxdc_integration (dc_context_t* context, const char* file);
 

uint32_t        dc_init_webxdc_integration    (dc_context_t* context, uint32_t chat_id);
 

void            dc_set_draft                 (dc_context_t* context, uint32_t chat_id, dc_msg_t* msg);
 

uint32_t        dc_add_device_msg            (dc_context_t* context, const char* label, dc_msg_t* msg);

int             dc_was_device_msg_ever_added (dc_context_t* context, const char* label);
 

dc_msg_t*       dc_get_draft                 (dc_context_t* context, uint32_t chat_id);
 
 
#define         DC_GCM_ADDDAYMARKER          0x01
#define         DC_GCM_INFO_ONLY             0x02
 

dc_array_t*     dc_get_chat_msgs             (dc_context_t* context, uint32_t chat_id, uint32_t flags, uint32_t marker1before);
 

int             dc_get_msg_cnt               (dc_context_t* context, uint32_t chat_id);
 

int             dc_get_fresh_msg_cnt         (dc_context_t* context, uint32_t chat_id);
 

dc_chatlist_t*     dc_get_similar_chatlist   (dc_context_t* context, uint32_t chat_id);
 

int             dc_estimate_deletion_cnt    (dc_context_t* context, int from_server, int64_t seconds);
 

dc_array_t*     dc_get_fresh_msgs            (dc_context_t* context);
 

dc_array_t*     dc_get_next_msgs             (dc_context_t* context);
 

dc_array_t*     dc_wait_next_msgs            (dc_context_t* context);
 

void            dc_marknoticed_chat          (dc_context_t* context, uint32_t chat_id);
 

dc_array_t*     dc_get_chat_media            (dc_context_t* context, uint32_t chat_id, int msg_type, int msg_type2, int msg_type3);
 

void            dc_set_chat_visibility       (dc_context_t* context, uint32_t chat_id, int visibility);
 

void            dc_delete_chat               (dc_context_t* context, uint32_t chat_id);

void            dc_block_chat                (dc_context_t* context, uint32_t chat_id);

void            dc_accept_chat               (dc_context_t* context, uint32_t chat_id);

dc_array_t*     dc_get_chat_contacts         (dc_context_t* context, uint32_t chat_id);

char*           dc_get_chat_encrinfo (dc_context_t* context, uint32_t chat_id);

uint32_t dc_get_chat_ephemeral_timer (dc_context_t* context, uint32_t chat_id);

dc_array_t*     dc_search_msgs               (dc_context_t* context, uint32_t chat_id, const char* query);
 

dc_chat_t*      dc_get_chat                  (dc_context_t* context, uint32_t chat_id);
 
 
// handle group chats

uint32_t        dc_create_group_chat         (dc_context_t* context, int protect, const char* name);
 

uint32_t        dc_create_broadcast_list     (dc_context_t* context);
 

int             dc_is_contact_in_chat        (dc_context_t* context, uint32_t chat_id, uint32_t contact_id);
 

int             dc_add_contact_to_chat       (dc_context_t* context, uint32_t chat_id, uint32_t contact_id);
 

int             dc_remove_contact_from_chat  (dc_context_t* context, uint32_t chat_id, uint32_t contact_id);
 

int             dc_set_chat_name             (dc_context_t* context, uint32_t chat_id, const char* name);

int dc_set_chat_ephemeral_timer (dc_context_t* context, uint32_t chat_id, uint32_t timer);

int             dc_set_chat_profile_image    (dc_context_t* context, uint32_t chat_id, const char* image);
 
 

int             dc_set_chat_mute_duration             (dc_context_t* context, uint32_t chat_id, int64_t duration);
 
// handle messages

char*           dc_get_msg_info              (dc_context_t* context, uint32_t msg_id);
 

char*           dc_get_msg_html              (dc_context_t* context, uint32_t msg_id);
 

void dc_download_full_msg (dc_context_t* context, int msg_id);
 

void            dc_delete_msgs               (dc_context_t* context, const uint32_t* msg_ids, int msg_cnt);
 

void            dc_forward_msgs              (dc_context_t* context, const uint32_t* msg_ids, int msg_cnt, uint32_t chat_id);
 

void            dc_save_msgs                 (dc_context_t* context, const uint32_t* msg_ids, int msg_cnt);
 

int             dc_resend_msgs               (dc_context_t* context, const uint32_t* msg_ids, int msg_cnt);
 

void            dc_markseen_msgs             (dc_context_t* context, const uint32_t* msg_ids, int msg_cnt);
 

dc_msg_t*       dc_get_msg                   (dc_context_t* context, uint32_t msg_id);
 
 
// handle contacts

int             dc_may_be_valid_addr         (const char* addr);
 

uint32_t        dc_lookup_contact_id_by_addr (dc_context_t* context, const char* addr);
 

uint32_t        dc_create_contact            (dc_context_t* context, const char* name, const char* addr);
 
 
 
// Deprecated 2025-05-20, setting this flag is a no-op.
#define         DC_GCL_DEPRECATED_VERIFIED_ONLY         0x01
 
#define         DC_GCL_ADD_SELF              0x02
 

int             dc_add_address_book          (dc_context_t* context, const char* addr_book);
 

char*           dc_make_vcard                (dc_context_t* context, uint32_t contact_id);
 

dc_array_t*     dc_import_vcard              (dc_context_t* context, const char* vcard);
 

dc_array_t*     dc_get_contacts              (dc_context_t* context, uint32_t flags, const char* query);
 

int             dc_get_blocked_cnt           (dc_context_t* context);
 

dc_array_t*     dc_get_blocked_contacts      (dc_context_t* context);
 

void            dc_block_contact             (dc_context_t* context, uint32_t contact_id, int block);
 

char*           dc_get_contact_encrinfo      (dc_context_t* context, uint32_t contact_id);
 

int             dc_delete_contact            (dc_context_t* context, uint32_t contact_id);
 

dc_contact_t*   dc_get_contact               (dc_context_t* context, uint32_t contact_id);
 
 
// import/export and tools
 
#define         DC_IMEX_EXPORT_SELF_KEYS      1 // param1 is a directory where the keys are written to
#define         DC_IMEX_IMPORT_SELF_KEYS      2 // param1 is a directory where the keys are searched in and read from
#define         DC_IMEX_EXPORT_BACKUP        11 // param1 is a directory where the backup is written to, param2 is a passphrase to encrypt the backup
#define         DC_IMEX_IMPORT_BACKUP        12 // param1 is the file with the backup to import, param2 is the backup's passphrase
 

void            dc_imex                      (dc_context_t* context, int what, const char* param1, const char* param2);
 

char*           dc_imex_has_backup           (dc_context_t* context, const char* dir);
 

char*           dc_initiate_key_transfer     (dc_context_t* context);
 

int             dc_continue_key_transfer     (dc_context_t* context, uint32_t msg_id, const char* setup_code);
 

void            dc_stop_ongoing_process      (dc_context_t* context);
 
 
// out-of-band verification
 
#define         DC_QR_ASK_VERIFYCONTACT      200 // id=contact
#define         DC_QR_ASK_VERIFYGROUP        202 // text1=groupname
#define         DC_QR_FPR_OK                 210 // id=contact
#define         DC_QR_FPR_MISMATCH           220 // id=contact
#define         DC_QR_FPR_WITHOUT_ADDR       230 // test1=formatted fingerprint
#define         DC_QR_ACCOUNT                250 // text1=domain
#define         DC_QR_BACKUP                 251 // deprecated
#define         DC_QR_BACKUP2                252
#define         DC_QR_BACKUP_TOO_NEW         255
#define         DC_QR_WEBRTC_INSTANCE        260 // text1=domain, text2=instance pattern
#define         DC_QR_PROXY                  271 // text1=address (e.g. "127.0.0.1:9050")
#define         DC_QR_ADDR                   320 // id=contact
#define         DC_QR_TEXT                   330 // text1=text
#define         DC_QR_URL                    332 // text1=URL
#define         DC_QR_ERROR                  400 // text1=error string
#define         DC_QR_WITHDRAW_VERIFYCONTACT 500
#define         DC_QR_WITHDRAW_VERIFYGROUP   502 // text1=groupname
#define         DC_QR_REVIVE_VERIFYCONTACT   510
#define         DC_QR_REVIVE_VERIFYGROUP     512 // text1=groupname
#define         DC_QR_LOGIN                  520 // text1=email_address

dc_lot_t*       dc_check_qr                  (dc_context_t* context, const char* qr);
 

char*           dc_get_securejoin_qr         (dc_context_t* context, uint32_t chat_id);
 

char*           dc_get_securejoin_qr_svg         (dc_context_t* context, uint32_t chat_id);

uint32_t        dc_join_securejoin           (dc_context_t* context, const char* qr);
 
 
// location streaming
 

void        dc_send_locations_to_chat       (dc_context_t* context, uint32_t chat_id, int seconds);
 

int         dc_is_sending_locations_to_chat (dc_context_t* context, uint32_t chat_id);
 

int         dc_set_location                 (dc_context_t* context, double latitude, double longitude, double accuracy);
 

dc_array_t* dc_get_locations                (dc_context_t* context, uint32_t chat_id, uint32_t contact_id, int64_t timestamp_begin, int64_t timestamp_end);
 

void        dc_delete_all_locations         (dc_context_t* context);
 
 
// misc

char*           dc_create_qr_svg             (const char* payload);
 

char* dc_get_last_error (dc_context_t* context);
 

void dc_str_unref (char* str);
 


dc_backup_provider_t* dc_backup_provider_new (dc_context_t* context);
 

char* dc_backup_provider_get_qr (const dc_backup_provider_t* backup_provider);
 

char* dc_backup_provider_get_qr_svg (const dc_backup_provider_t* backup_provider);

void dc_backup_provider_wait (dc_backup_provider_t* backup_provider);

void dc_backup_provider_unref (dc_backup_provider_t* backup_provider);

int dc_receive_backup (dc_context_t* context, const char* qr);


dc_accounts_t* dc_accounts_new                  (const char* dir, int writable);
 

void           dc_accounts_unref                (dc_accounts_t* accounts);
 

uint32_t       dc_accounts_add_account          (dc_accounts_t* accounts);

uint32_t       dc_accounts_add_closed_account   (dc_accounts_t* accounts);

uint32_t       dc_accounts_migrate_account      (dc_accounts_t* accounts, const char* dbfile);
 

int            dc_accounts_remove_account       (dc_accounts_t* accounts, uint32_t account_id);
 

dc_array_t*    dc_accounts_get_all              (dc_accounts_t* accounts);
 

dc_context_t*  dc_accounts_get_account          (dc_accounts_t* accounts, uint32_t account_id);
 

dc_context_t*  dc_accounts_get_selected_account (dc_accounts_t* accounts);
 

int            dc_accounts_select_account       (dc_accounts_t* accounts, uint32_t account_id);
 

void           dc_accounts_start_io             (dc_accounts_t* accounts);
 

void           dc_accounts_stop_io              (dc_accounts_t* accounts);
 

void           dc_accounts_maybe_network        (dc_accounts_t* accounts);
 

void           dc_accounts_maybe_network_lost    (dc_accounts_t* accounts);
 

int            dc_accounts_background_fetch    (dc_accounts_t* accounts, uint64_t timeout);
 

void           dc_accounts_set_push_device_token (dc_accounts_t* accounts, const char *token);

dc_event_emitter_t* dc_accounts_get_event_emitter (dc_accounts_t* accounts);
 

 

void             dc_array_unref              (dc_array_t* array);
 

size_t           dc_array_get_cnt            (const dc_array_t* array);
 

uint32_t         dc_array_get_id             (const dc_array_t* array, size_t index);
 

double           dc_array_get_latitude       (const dc_array_t* array, size_t index);
 

double           dc_array_get_longitude      (const dc_array_t* array, size_t index);
 

double           dc_array_get_accuracy       (const dc_array_t* array, size_t index);
 

int64_t           dc_array_get_timestamp      (const dc_array_t* array, size_t index);
 

uint32_t         dc_array_get_chat_id        (const dc_array_t* array, size_t index);
 

uint32_t         dc_array_get_contact_id     (const dc_array_t* array, size_t index);
 

uint32_t         dc_array_get_msg_id         (const dc_array_t* array, size_t index);
 

char*            dc_array_get_marker         (const dc_array_t* array, size_t index);
 

int              dc_array_is_independent     (const dc_array_t* array, size_t index);
 

int              dc_array_search_id          (const dc_array_t* array, uint32_t needle, size_t* ret_index);
 

 

void             dc_chatlist_unref           (dc_chatlist_t* chatlist);
 

size_t           dc_chatlist_get_cnt         (const dc_chatlist_t* chatlist);
 

uint32_t         dc_chatlist_get_chat_id     (const dc_chatlist_t* chatlist, size_t index);
 

uint32_t         dc_chatlist_get_msg_id      (const dc_chatlist_t* chatlist, size_t index);
 

dc_lot_t*        dc_chatlist_get_summary     (const dc_chatlist_t* chatlist, size_t index, dc_chat_t* chat);
 

dc_lot_t*        dc_chatlist_get_summary2    (dc_context_t* context, uint32_t chat_id, uint32_t msg_id);
 

dc_context_t*    dc_chatlist_get_context     (dc_chatlist_t* chatlist);
 

char*            dc_chat_get_info_json       (dc_context_t* context, size_t chat_id);

 
 
#define         DC_CHAT_ID_TRASH             3 // messages that should be deleted get this chat ID; the messages are deleted from the working thread later then. This is also needed as rfc724_mid should be preset as long as the message is not deleted on the server (otherwise it is downloaded again)
#define         DC_CHAT_ID_ARCHIVED_LINK     6 // only an indicator in a chatlist
#define         DC_CHAT_ID_ALLDONE_HINT      7 // only an indicator in a chatlist
#define         DC_CHAT_ID_LAST_SPECIAL      9 // larger chat IDs are "real" chats, their messages are "real" messages
 

void            dc_chat_unref                (dc_chat_t* chat);
 

uint32_t        dc_chat_get_id               (const dc_chat_t* chat);
 

int             dc_chat_get_type             (const dc_chat_t* chat);
 

char*           dc_chat_get_mailinglist_addr (const dc_chat_t* chat);
 

char*           dc_chat_get_name             (const dc_chat_t* chat);
 

char*           dc_chat_get_profile_image    (const dc_chat_t* chat);
 

uint32_t        dc_chat_get_color            (const dc_chat_t* chat);
 

int             dc_chat_get_visibility       (const dc_chat_t* chat);
 

int             dc_chat_is_contact_request   (const dc_chat_t* chat);
 

int             dc_chat_is_unpromoted        (const dc_chat_t* chat);
 

int             dc_chat_is_self_talk         (const dc_chat_t* chat);
 

int             dc_chat_is_device_talk       (const dc_chat_t* chat);
 

int             dc_chat_can_send              (const dc_chat_t* chat);
 

int             dc_chat_is_protected         (const dc_chat_t* chat);
 

int             dc_chat_is_protection_broken (const dc_chat_t* chat);
 

int             dc_chat_is_sending_locations (const dc_chat_t* chat);
 

int             dc_chat_is_muted (const dc_chat_t* chat);
 

int64_t          dc_chat_get_remaining_mute_duration (const dc_chat_t* chat);
 

 
 
#define         DC_MSG_ID_MARKER1            1 // this is used by iOS to mark things in the message list
#define         DC_MSG_ID_DAYMARKER          9
#define         DC_MSG_ID_LAST_SPECIAL       9
 

dc_msg_t*       dc_msg_new                    (dc_context_t* context, int viewtype);
 

void            dc_msg_unref                  (dc_msg_t* msg);
 

uint32_t        dc_msg_get_id                 (const dc_msg_t* msg);
 

uint32_t        dc_msg_get_from_id            (const dc_msg_t* msg);
 

uint32_t        dc_msg_get_chat_id            (const dc_msg_t* msg);
 

int             dc_msg_get_viewtype           (const dc_msg_t* msg);
 

int             dc_msg_get_state              (const dc_msg_t* msg);
 

int64_t          dc_msg_get_timestamp          (const dc_msg_t* msg);
 

int64_t          dc_msg_get_received_timestamp (const dc_msg_t* msg);
 

int64_t          dc_msg_get_sort_timestamp     (const dc_msg_t* msg);
 

char*           dc_msg_get_text               (const dc_msg_t* msg);
 

char*           dc_msg_get_subject            (const dc_msg_t* msg);
 

char*           dc_msg_get_file               (const dc_msg_t* msg);
 

int             dc_msg_save_file              (const dc_msg_t* msg, const char* path);
 

char*           dc_msg_get_filename           (const dc_msg_t* msg);
 

char*           dc_msg_get_filemime           (const dc_msg_t* msg);
 

char*             dc_msg_get_webxdc_blob      (const dc_msg_t* msg, const char* filename, size_t* ret_bytes);
 

char*             dc_msg_get_webxdc_info      (const dc_msg_t* msg);
 

uint64_t        dc_msg_get_filebytes          (const dc_msg_t* msg);
 

int             dc_msg_get_width              (const dc_msg_t* msg);
 

int             dc_msg_get_height             (const dc_msg_t* msg);
 

int             dc_msg_get_duration           (const dc_msg_t* msg);
 

int             dc_msg_get_showpadlock        (const dc_msg_t* msg);

int             dc_msg_is_bot                 (const dc_msg_t* msg); 

uint32_t        dc_msg_get_ephemeral_timer    (const dc_msg_t* msg);

int64_t          dc_msg_get_ephemeral_timestamp (const dc_msg_t* msg);
 

dc_lot_t*       dc_msg_get_summary            (const dc_msg_t* msg, const dc_chat_t* chat);
 

char*           dc_msg_get_summarytext        (const dc_msg_t* msg, int approx_characters);
 

char*           dc_msg_get_override_sender_name(const dc_msg_t* msg);
 
 

int             dc_msg_has_deviating_timestamp(const dc_msg_t* msg);
 

int             dc_msg_has_location           (const dc_msg_t* msg);
 

int             dc_msg_is_sent                (const dc_msg_t* msg);
 

int             dc_msg_is_forwarded           (const dc_msg_t* msg);
 

 int             dc_msg_is_edited             (const dc_msg_t* msg);
 

int             dc_msg_is_info                (const dc_msg_t* msg);
 

int             dc_msg_get_info_type          (const dc_msg_t* msg);
 

uint32_t        dc_msg_get_info_contact_id    (const dc_msg_t* msg);
 
 
// DC_INFO* uses the same values as SystemMessage in rust-land
#define         DC_INFO_UNKNOWN                    0
#define         DC_INFO_GROUP_NAME_CHANGED         2
#define         DC_INFO_GROUP_IMAGE_CHANGED        3
#define         DC_INFO_MEMBER_ADDED_TO_GROUP      4
#define         DC_INFO_MEMBER_REMOVED_FROM_GROUP  5
#define         DC_INFO_AUTOCRYPT_SETUP_MESSAGE    6
#define         DC_INFO_SECURE_JOIN_MESSAGE        7
#define         DC_INFO_LOCATIONSTREAMING_ENABLED  8
#define         DC_INFO_LOCATION_ONLY              9
#define         DC_INFO_EPHEMERAL_TIMER_CHANGED   10
#define         DC_INFO_PROTECTION_ENABLED        11
#define         DC_INFO_PROTECTION_DISABLED       12
#define         DC_INFO_INVALID_UNENCRYPTED_MAIL  13
#define         DC_INFO_WEBXDC_INFO_MESSAGE       32
 

char*           dc_msg_get_webxdc_href        (const dc_msg_t* msg);
 

int             dc_msg_is_setupmessage        (const dc_msg_t* msg);
 

char*           dc_msg_get_setupcodebegin     (const dc_msg_t* msg);
 

char*           dc_msg_get_videochat_url (const dc_msg_t* msg);
 

char*           dc_msg_get_error               (const dc_msg_t* msg);
 

int dc_msg_get_videochat_type (const dc_msg_t* msg);
 
#define DC_VIDEOCHATTYPE_UNKNOWN     0
#define DC_VIDEOCHATTYPE_BASICWEBRTC 1
#define DC_VIDEOCHATTYPE_JITSI       2
 

int dc_msg_has_html (dc_msg_t* msg);
 

int dc_msg_get_download_state (const dc_msg_t* msg);
 

void            dc_msg_set_text               (dc_msg_t* msg, const char* text);
 

void            dc_msg_set_html               (dc_msg_t* msg, const char* html);
 

void            dc_msg_set_subject            (dc_msg_t* msg, const char* subject);
 

void            dc_msg_set_override_sender_name(dc_msg_t* msg, const char* name);
 

void            dc_msg_set_file_and_deduplicate(dc_msg_t* msg, const char* file, const char* name, const char* filemime);
 

void            dc_msg_set_dimension          (dc_msg_t* msg, int width, int height);
 

void            dc_msg_set_duration           (dc_msg_t* msg, int duration);
 

void            dc_msg_set_location           (dc_msg_t* msg, double latitude, double longitude);
 

void            dc_msg_latefiling_mediasize   (dc_msg_t* msg, int width, int height, int duration);
 

void             dc_msg_set_quote             (dc_msg_t* msg, const dc_msg_t* quote);
 

char*           dc_msg_get_quoted_text        (const dc_msg_t* msg);
 

dc_msg_t*       dc_msg_get_quoted_msg         (const dc_msg_t* msg);

dc_msg_t*       dc_msg_get_parent             (const dc_msg_t* msg);
 

uint32_t        dc_msg_get_original_msg_id    (const dc_msg_t* msg);
 

uint32_t        dc_msg_get_saved_msg_id     (const dc_msg_t* msg);
 

void            dc_msg_force_plaintext        (dc_msg_t* msg);

 
 
#define         DC_CONTACT_ID_SELF           1
#define         DC_CONTACT_ID_INFO           2 // centered messages as "member added", used in all chats
#define         DC_CONTACT_ID_DEVICE         5 // messages "update info" in the device-chat
#define         DC_CONTACT_ID_LAST_SPECIAL   9
 

void            dc_contact_unref             (dc_contact_t* contact);
 

uint32_t        dc_contact_get_id            (const dc_contact_t* contact);
 

char*           dc_contact_get_addr          (const dc_contact_t* contact);
 

char*           dc_contact_get_name          (const dc_contact_t* contact);
 

char*           dc_contact_get_auth_name     (const dc_contact_t* contact);
 

char*           dc_contact_get_display_name  (const dc_contact_t* contact);
 
 
// dc_contact_get_first_name is removed,
// the following define is to make upgrading more smoothly.
#define         dc_contact_get_first_name    dc_contact_get_display_name
 

char*           dc_contact_get_name_n_addr   (const dc_contact_t* contact);
 

char*           dc_contact_get_profile_image (const dc_contact_t* contact);
 

uint32_t        dc_contact_get_color         (const dc_contact_t* contact);
 

char*           dc_contact_get_status        (const dc_contact_t* contact);

int64_t         dc_contact_get_last_seen     (const dc_contact_t* contact);
 

int             dc_contact_was_seen_recently (const dc_contact_t* contact);
 

int             dc_contact_is_blocked        (const dc_contact_t* contact);
 

int             dc_contact_is_verified       (dc_contact_t* contact);

int             dc_contact_is_bot            (dc_contact_t* contact);
 

uint32_t       dc_contact_get_verifier_id      (dc_contact_t* contact);
 

 

dc_provider_t*  dc_provider_new_from_email            (const dc_context_t* context, const char* email);
 

dc_provider_t*  dc_provider_new_from_email_with_dns    (const dc_context_t* context, const char* email);
 

char*           dc_provider_get_overview_page         (const dc_provider_t* provider);
 

char*           dc_provider_get_before_login_hint     (const dc_provider_t* provider);
 

int             dc_provider_get_status                (const dc_provider_t* provider);
 

void            dc_provider_unref                     (dc_provider_t* provider);
 

 
 
#define         DC_TEXT1_DRAFT     1
#define         DC_TEXT1_USERNAME  2
#define         DC_TEXT1_SELF      3
 

void            dc_lot_unref             (dc_lot_t* lot);
 

char*           dc_lot_get_text1         (const dc_lot_t* lot);
 

char*           dc_lot_get_text2         (const dc_lot_t* lot);
 

int             dc_lot_get_text1_meaning (const dc_lot_t* lot);
 

int             dc_lot_get_state         (const dc_lot_t* lot);
 

uint32_t        dc_lot_get_id            (const dc_lot_t* lot);
 

int64_t         dc_lot_get_timestamp     (const dc_lot_t* lot);
 

 

#define DC_MSG_TEXT      10
 

#define DC_MSG_IMAGE     20
 

#define DC_MSG_GIF       21
 

#define DC_MSG_STICKER     23
 

#define DC_MSG_AUDIO     40
 

#define DC_MSG_VOICE     41
 

#define DC_MSG_VIDEO     50
 

#define DC_MSG_FILE      60
 

#define DC_MSG_VIDEOCHAT_INVITATION 70
 

#define DC_MSG_WEBXDC    80

#define DC_MSG_VCARD     90

 


#define         DC_STATE_UNDEFINED           0

#define         DC_STATE_IN_FRESH            10

#define         DC_STATE_IN_NOTICED          13

#define         DC_STATE_IN_SEEN             16

#define         DC_STATE_OUT_PREPARING       18

#define         DC_STATE_OUT_DRAFT           19

#define         DC_STATE_OUT_PENDING         20

#define         DC_STATE_OUT_FAILED          24

#define         DC_STATE_OUT_DELIVERED       26

#define         DC_STATE_OUT_MDN_RCVD        28

 


#define         DC_CHAT_TYPE_UNDEFINED       0

#define         DC_CHAT_TYPE_SINGLE          100

#define         DC_CHAT_TYPE_GROUP           120

#define         DC_CHAT_TYPE_MAILINGLIST     140

#define         DC_CHAT_TYPE_BROADCAST       160

 


#define DC_SOCKET_AUTO 0
 

#define DC_SOCKET_SSL 1
 

#define DC_SOCKET_STARTTLS 2
 

#define DC_SOCKET_PLAIN 3

 

 

#define DC_LP_AUTH_OAUTH2                0x2
 

#define DC_LP_AUTH_NORMAL                0x4
 

 
#define DC_LP_AUTH_FLAGS        (DC_LP_AUTH_OAUTH2|DC_LP_AUTH_NORMAL) // if none of these flags are set, the default is chosen


#define DC_CERTCK_AUTO 0

#define DC_CERTCK_STRICT 1

#define DC_CERTCK_ACCEPT_INVALID 2

#define DC_CERTCK_ACCEPT_INVALID_CERTIFICATES 3

 


dc_jsonrpc_instance_t* dc_jsonrpc_init(dc_accounts_t* account_manager);

void dc_jsonrpc_unref(dc_jsonrpc_instance_t* jsonrpc_instance);

void dc_jsonrpc_request(dc_jsonrpc_instance_t* jsonrpc_instance, const char* request);

char* dc_jsonrpc_next_response(dc_jsonrpc_instance_t* jsonrpc_instance);

char* dc_jsonrpc_blocking_call(dc_jsonrpc_instance_t* jsonrpc_instance, const char *input);


dc_event_t* dc_get_next_event(dc_event_emitter_t* emitter);
 
// Alias for backwards compatibility, use dc_get_next_event instead.
#define dc_accounts_get_next_event dc_get_next_event

void  dc_event_emitter_unref(dc_event_emitter_t* emitter);
 
// Alias for backwards compatibility, use dc_event_emtitter_unref instead.
#define dc_accounts_event_emitter_unref dc_event_emitter_unref


int dc_event_get_id(dc_event_t* event);
 

int dc_event_get_data1_int(dc_event_t* event);
 

int dc_event_get_data2_int(dc_event_t* event);
 

char* dc_event_get_data1_str(dc_event_t* event);
 

char* dc_event_get_data2_str(dc_event_t* event);
 

uint32_t dc_event_get_account_id(dc_event_t* event);
 

void dc_event_unref(dc_event_t* event);
 


#define DC_EVENT_INFO                     100
 

#define DC_EVENT_SMTP_CONNECTED           101
 

#define DC_EVENT_IMAP_CONNECTED           102

#define DC_EVENT_SMTP_MESSAGE_SENT        103

#define DC_EVENT_IMAP_MESSAGE_DELETED   104

#define DC_EVENT_IMAP_MESSAGE_MOVED   105

#define DC_EVENT_IMAP_INBOX_IDLE 106

#define DC_EVENT_NEW_BLOB_FILE 150

#define DC_EVENT_DELETED_BLOB_FILE 151

#define DC_EVENT_WARNING                  300
 

#define DC_EVENT_ERROR                    400
 

#define DC_EVENT_ERROR_SELF_NOT_IN_GROUP  410
 

#define DC_EVENT_MSGS_CHANGED             2000
 

#define DC_EVENT_REACTIONS_CHANGED        2001
 

#define DC_EVENT_INCOMING_REACTION        2002
 
 

#define DC_EVENT_INCOMING_WEBXDC_NOTIFY   2003
 

#define DC_EVENT_INCOMING_MSG             2005

#define DC_EVENT_INCOMING_MSG_BUNCH       2006
 

#define DC_EVENT_MSGS_NOTICED             2008
 

#define DC_EVENT_MSG_DELIVERED            2010
 

#define DC_EVENT_MSG_FAILED               2012
 

#define DC_EVENT_MSG_READ                 2015
 

#define DC_EVENT_MSG_DELETED              2016
 

#define DC_EVENT_CHAT_MODIFIED            2020

#define DC_EVENT_CHAT_EPHEMERAL_TIMER_MODIFIED 2021
 

#define DC_EVENT_CHAT_DELETED             2023
 

#define DC_EVENT_CONTACTS_CHANGED         2030
 
 

#define DC_EVENT_LOCATION_CHANGED         2035
 

#define DC_EVENT_CONFIGURE_PROGRESS       2041
 

#define DC_EVENT_IMEX_PROGRESS            2051
 

#define DC_EVENT_IMEX_FILE_WRITTEN        2052
 

#define DC_EVENT_SECUREJOIN_INVITER_PROGRESS      2060
 

#define DC_EVENT_SECUREJOIN_JOINER_PROGRESS       2061
 

#define DC_EVENT_CONNECTIVITY_CHANGED             2100
 

#define DC_EVENT_SELFAVATAR_CHANGED               2110
 

#define DC_EVENT_CONFIG_SYNCED                    2111
 

#define DC_EVENT_WEBXDC_STATUS_UPDATE             2120

 
#define DC_EVENT_WEBXDC_INSTANCE_DELETED          2121

 
#define DC_EVENT_WEBXDC_REALTIME_DATA             2150

 
#define DC_EVENT_WEBXDC_REALTIME_ADVERTISEMENT    2151

 
#define DC_EVENT_ACCOUNTS_BACKGROUND_FETCH_DONE   2200

 
#define DC_EVENT_CHATLIST_CHANGED              2300

 
#define DC_EVENT_CHATLIST_ITEM_CHANGED         2301

 
#define DC_EVENT_ACCOUNTS_CHANGED              2302

 
#define DC_EVENT_ACCOUNTS_ITEM_CHANGED         2303

#define DC_EVENT_CHANNEL_OVERFLOW              2400

 
 
#define DC_EVENT_DATA1_IS_STRING(e)  0    // not used anymore 
#define DC_EVENT_DATA2_IS_STRING(e)  ((e)==DC_EVENT_CONFIGURE_PROGRESS || (e)==DC_EVENT_IMEX_FILE_WRITTEN || ((e)>=100 && (e)<=499))
 
 
/*
 * Values for dc_get|set_config("show_emails")
 */
#define DC_SHOW_EMAILS_OFF               0
#define DC_SHOW_EMAILS_ACCEPTED_CONTACTS 1
#define DC_SHOW_EMAILS_ALL               2
 
 
/*
 * Values for dc_get|set_config("media_quality")
 */
#define DC_MEDIA_QUALITY_BALANCED 0
#define DC_MEDIA_QUALITY_WORSE    1
 


#define         DC_PROVIDER_STATUS_OK           1

#define         DC_PROVIDER_STATUS_PREPARATION  2

#define         DC_PROVIDER_STATUS_BROKEN       3

 


#define         DC_CHAT_VISIBILITY_NORMAL      0

#define         DC_CHAT_VISIBILITY_ARCHIVED    1

#define         DC_CHAT_VISIBILITY_PINNED      2

 


#define DC_DOWNLOAD_DONE           0

#define DC_DOWNLOAD_AVAILABLE      10

#define DC_DOWNLOAD_FAILURE        20

#define DC_DOWNLOAD_UNDECIPHERABLE 30

#define DC_DOWNLOAD_IN_PROGRESS    1000
 
 

 


#define DC_STR_NOMESSAGES                 1

#define DC_STR_SELF                       2

#define DC_STR_DRAFT                      3

#define DC_STR_VOICEMESSAGE               7

#define DC_STR_IMAGE                      9

#define DC_STR_VIDEO                      10

#define DC_STR_AUDIO                      11

#define DC_STR_FILE                       12

#define DC_STR_MSGGRPNAME                 15

#define DC_STR_MSGGRPIMGCHANGED           16

#define DC_STR_MSGADDMEMBER               17

#define DC_STR_MSGDELMEMBER               18

#define DC_STR_MSGGROUPLEFT               19

#define DC_STR_GIF                        23

#define DC_STR_ENCRYPTEDMSG               24

#define DC_STR_E2E_AVAILABLE              25

#define DC_STR_ENCR_TRANSP                27

#define DC_STR_ENCR_NONE                  28

#define DC_STR_CANTDECRYPT_MSG_BODY       29

#define DC_STR_FINGERPRINTS               30

#define DC_STR_READRCPT                   31

#define DC_STR_READRCPT_MAILBODY          32

#define DC_STR_MSGGRPIMGDELETED           33

#define DC_STR_E2E_PREFERRED              34

#define DC_STR_CONTACT_VERIFIED           35

#define DC_STR_CONTACT_NOT_VERIFIED       36

#define DC_STR_CONTACT_SETUP_CHANGED      37

#define DC_STR_ARCHIVEDCHATS              40

#define DC_STR_AC_SETUP_MSG_SUBJECT       42

#define DC_STR_AC_SETUP_MSG_BODY          43

#define DC_STR_CANNOT_LOGIN               60

#define DC_STR_MSGACTIONBYUSER            62

#define DC_STR_MSGACTIONBYME              63

#define DC_STR_MSGLOCATIONENABLED         64

#define DC_STR_MSGLOCATIONDISABLED        65

#define DC_STR_LOCATION                   66

#define DC_STR_STICKER                    67

#define DC_STR_DEVICE_MESSAGES            68

#define DC_STR_SAVED_MESSAGES             69

#define DC_STR_DEVICE_MESSAGES_HINT       70

#define DC_STR_WELCOME_MESSAGE            71

#define DC_STR_UNKNOWN_SENDER_FOR_CHAT    72

#define DC_STR_SUBJECT_FOR_NEW_CONTACT    73

#define DC_STR_FAILED_SENDING_TO          74

#define DC_STR_EPHEMERAL_DISABLED         75

#define DC_STR_EPHEMERAL_SECONDS          76

#define DC_STR_EPHEMERAL_MINUTE           77

#define DC_STR_EPHEMERAL_HOUR             78

#define DC_STR_EPHEMERAL_DAY              79

#define DC_STR_EPHEMERAL_WEEK             80

#define DC_STR_EPHEMERAL_FOUR_WEEKS       81

#define DC_STR_VIDEOCHAT_INVITATION       82

#define DC_STR_VIDEOCHAT_INVITE_MSG_BODY  83

#define DC_STR_CONFIGURATION_FAILED       84

#define DC_STR_BAD_TIME_MSG_BODY          85

#define DC_STR_UPDATE_REMINDER_MSG_BODY   86

#define DC_STR_ERROR_NO_NETWORK           87

#define DC_STR_REPLY_NOUN                 90

#define DC_STR_SELF_DELETED_MSG_BODY      91

#define DC_STR_SERVER_TURNED_OFF          92

#define DC_STR_EPHEMERAL_MINUTES          93

#define DC_STR_EPHEMERAL_HOURS            94

#define DC_STR_EPHEMERAL_DAYS             95

#define DC_STR_EPHEMERAL_WEEKS            96

#define DC_STR_FORWARDED                  97

#define DC_STR_QUOTA_EXCEEDING_MSG_BODY   98

#define DC_STR_PARTIAL_DOWNLOAD_MSG_BODY  99

#define DC_STR_DOWNLOAD_AVAILABILITY      100

#define DC_STR_SYNC_MSG_SUBJECT           101

#define DC_STR_SYNC_MSG_BODY              102

#define DC_STR_INCOMING_MESSAGES          103

#define DC_STR_OUTGOING_MESSAGES          104

#define DC_STR_STORAGE_ON_DOMAIN          105

#define DC_STR_ONE_MOMENT                 106

#define DC_STR_CONNECTED                  107

#define DC_STR_CONNTECTING                108

#define DC_STR_UPDATING                   109

#define DC_STR_SENDING                    110

#define DC_STR_LAST_MSG_SENT_SUCCESSFULLY 111

#define DC_STR_ERROR                      112

#define DC_STR_NOT_SUPPORTED_BY_PROVIDER  113

#define DC_STR_MESSAGES                   114

#define DC_STR_BROADCAST_LIST             115

#define DC_STR_PART_OF_TOTAL_USED         116

#define DC_STR_SECURE_JOIN_STARTED        117

#define DC_STR_SECURE_JOIN_REPLIES        118

#define DC_STR_SETUP_CONTACT_QR_DESC      119

#define DC_STR_SECURE_JOIN_GROUP_QR_DESC  120

#define DC_STR_NOT_CONNECTED              121

#define DC_STR_AEAP_ADDR_CHANGED          122

#define DC_STR_AEAP_EXPLANATION_AND_LINK  123

#define DC_STR_GROUP_NAME_CHANGED_BY_YOU 124

#define DC_STR_GROUP_NAME_CHANGED_BY_OTHER 125

#define DC_STR_GROUP_IMAGE_CHANGED_BY_YOU 126

#define DC_STR_GROUP_IMAGE_CHANGED_BY_OTHER 127

#define DC_STR_ADD_MEMBER_BY_YOU 128

#define DC_STR_ADD_MEMBER_BY_OTHER 129

#define DC_STR_REMOVE_MEMBER_BY_YOU 130

#define DC_STR_REMOVE_MEMBER_BY_OTHER 131

#define DC_STR_GROUP_LEFT_BY_YOU 132

#define DC_STR_GROUP_LEFT_BY_OTHER 133

#define DC_STR_GROUP_IMAGE_DELETED_BY_YOU 134

#define DC_STR_GROUP_IMAGE_DELETED_BY_OTHER 135

#define DC_STR_LOCATION_ENABLED_BY_YOU 136

#define DC_STR_LOCATION_ENABLED_BY_OTHER 137

#define DC_STR_EPHEMERAL_TIMER_DISABLED_BY_YOU 138

#define DC_STR_EPHEMERAL_TIMER_DISABLED_BY_OTHER 139

#define DC_STR_EPHEMERAL_TIMER_SECONDS_BY_YOU 140

#define DC_STR_EPHEMERAL_TIMER_SECONDS_BY_OTHER 141

#define DC_STR_EPHEMERAL_TIMER_1_MINUTE_BY_YOU 142

#define DC_STR_EPHEMERAL_TIMER_1_MINUTE_BY_OTHER 143

#define DC_STR_EPHEMERAL_TIMER_1_HOUR_BY_YOU 144

#define DC_STR_EPHEMERAL_TIMER_1_HOUR_BY_OTHER 145

#define DC_STR_EPHEMERAL_TIMER_1_DAY_BY_YOU 146

#define DC_STR_EPHEMERAL_TIMER_1_DAY_BY_OTHER 147

#define DC_STR_EPHEMERAL_TIMER_1_WEEK_BY_YOU 148

#define DC_STR_EPHEMERAL_TIMER_1_WEEK_BY_OTHER 149

#define DC_STR_EPHEMERAL_TIMER_MINUTES_BY_YOU 150

#define DC_STR_EPHEMERAL_TIMER_MINUTES_BY_OTHER 151

#define DC_STR_EPHEMERAL_TIMER_HOURS_BY_YOU 152

#define DC_STR_EPHEMERAL_TIMER_HOURS_BY_OTHER 153

#define DC_STR_EPHEMERAL_TIMER_DAYS_BY_YOU 154

#define DC_STR_EPHEMERAL_TIMER_DAYS_BY_OTHER 155

#define DC_STR_EPHEMERAL_TIMER_WEEKS_BY_YOU 156

#define DC_STR_EPHEMERAL_TIMER_WEEKS_BY_OTHER 157

#define DC_STR_BACKUP_TRANSFER_QR 162

#define DC_STR_BACKUP_TRANSFER_MSG_BODY 163

#define DC_STR_CHAT_PROTECTION_ENABLED 170

#define DC_STR_CHAT_PROTECTION_DISABLED 171

#define DC_STR_NEW_GROUP_SEND_FIRST_MESSAGE 172

#define DC_STR_MESSAGE_ADD_MEMBER 173

#define DC_STR_INVALID_UNENCRYPTED_MAIL 174

#define DC_STR_YOU_REACTED 176

#define DC_STR_REACTED_BY 177

#define DC_STR_SECUREJOIN_WAIT 190

#define DC_STR_SECUREJOIN_WAIT_TIMEOUT 191

#define DC_STR_SECUREJOIN_TAKES_LONGER 192

#define DC_STR_CONTACT 200

 
 
#ifdef PY_CFFI_INC
/* Helper utility to locate the header file when building python bindings. */
char* _dc_header_file_location(void) {
    return __FILE__;
}
#endif
 
 
#ifdef __cplusplus
}
#endif
#endif // __DELTACHAT_H__