tgl inside telegram

git-svn-id: http://svn.miranda-ng.org/main/trunk@16471 1316c22d-e87f-b044-9b9b-93d7a3e3ba9c

1 files changed, 659 insertions, 0 deletions

diff --git a/protocols/Telegram/src/tgl/tgl.h b/protocols/Telegram/src/tgl/tgl.h
new file mode 100644
index 0000000000..2da8c7a254
--- /dev/null
+++ b/protocols/Telegram/src/tgl/tgl.h
@@ -0,0 +1,659 @@
+/*
+    This file is part of tgl-library
+
+    This library is free software; you can redistribute it and/or
+    modify it under the terms of the GNU Lesser General Public
+    License as published by the Free Software Foundation; either
+    version 2.1 of the License, or (at your option) any later version.
+
+    This library 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
+    Lesser General Public License for more details.
+
+    You should have received a copy of the GNU Lesser General Public
+    License along with this library; if not, write to the Free Software
+    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
+
+    Copyright Vitaly Valtman 2014-2015
+*/
+#ifndef __TGL_H__
+#define __TGL_H__
+
+#include "tgl-layout.h"
+#include <string.h>
+#include <stdlib.h>
+#ifdef _WIN32
+#include "config.h"
+#define WIN32_LEAN_AND_MEAN
+#include <windows.h>
+#undef WIN32_LEAN_AND_MEAN
+#endif
+
+#define TGL_MAX_DC_NUM 100
+#define TG_SERVER_1 "149.154.175.50"
+#define TG_SERVER_2 "149.154.167.51"
+#define TG_SERVER_3 "149.154.175.100"
+#define TG_SERVER_4 "149.154.167.91"
+#define TG_SERVER_5 "149.154.171.5"
+#define TG_SERVER_IPV6_1 "2001:b28:f23d:f001::a"
+#define TG_SERVER_IPV6_2 "2001:67c:4e8:f002::a"
+#define TG_SERVER_IPV6_3 "2001:b28:f23d:f003::a"
+#define TG_SERVER_IPV6_4 "2001:67c:4e8:f004::a"
+#define TG_SERVER_IPV6_5 "2001:b28:f23f:f005::a"
+#define TG_SERVER_DEFAULT 2
+
+#define TG_SERVER_TEST_1 "149.154.175.10"
+#define TG_SERVER_TEST_2 "149.154.167.40"
+#define TG_SERVER_TEST_3 "149.154.175.117"
+#define TG_SERVER_TEST_IPV6_1 "2001:b28:f23d:f001::e"
+#define TG_SERVER_TEST_IPV6_2 "2001:67c:4e8:f002::e"
+#define TG_SERVER_TEST_IPV6_3 "2001:b28:f23d:f003::e"
+#define TG_SERVER_TEST_DEFAULT 2
+
+// JUST RANDOM STRING
+#define TGL_VERSION "2.0.3"
+
+#define TGL_ENCRYPTED_LAYER 17
+#define TGL_SCHEME_LAYER 31
+
+struct connection;
+struct mtproto_methods;
+struct tgl_session;
+struct tgl_dc;
+
+#define TGL_UPDATE_CREATED 1
+#define TGL_UPDATE_DELETED 2
+#define TGL_UPDATE_PHONE 4
+#define TGL_UPDATE_CONTACT 8
+#define TGL_UPDATE_PHOTO 16
+#define TGL_UPDATE_BLOCKED 32
+#define TGL_UPDATE_REAL_NAME 64
+#define TGL_UPDATE_NAME 128
+#define TGL_UPDATE_REQUESTED 256
+#define TGL_UPDATE_WORKING 512
+#define TGL_UPDATE_FLAGS 1024
+#define TGL_UPDATE_TITLE 2048
+#define TGL_UPDATE_ADMIN 4096
+#define TGL_UPDATE_MEMBERS 8192
+#define TGL_UPDATE_ACCESS_HASH 16384
+#define TGL_UPDATE_USERNAME (1 << 15)
+
+#if defined(WIN32) || defined(_WIN32)
+#   if !defined(__cplusplus) && ( !defined(__STDC_VERSION__) || __STDC_VERSION__ < 199901L )
+#      if __GNUC__ >= 2 || (defined(_MSC_VER) && _MSC_VER >= 1300)
+#         define __func__ __FUNCTION__
+#      else
+#         define __func__ "<unknown>"
+#      endif
+#   endif
+#   ifdef _MSC_VER
+#      define __attribute__(x)
+#   endif
+#   define _PRINTF_INT64_ "I64"
+#   define lrand48() rand()
+#   define srand48(x) srand(x)
+    inline const char* GetLastErrorStr(int err)
+    {
+	    static char errorText[256] = { 0 };
+	    FormatMessageA(
+		    FORMAT_MESSAGE_FROM_SYSTEM,
+		    NULL,
+		    err,
+		    MAKELANGID(LANG_NEUTRAL, SUBLANG_DEFAULT),
+		    (LPSTR)&errorText,
+		    256,
+		    NULL);
+	    return (const char*)errorText;
+    }
+
+    inline const char* GetErrnoStr(int err)
+    {
+	    static char errnoStr[256] = { 0 };
+	    strerror_s(errnoStr, 256, err);
+	    return (const char*)errnoStr;
+    }
+#else
+#   define _PRINTF_INT64_ "ll"
+#endif
+
+struct tgl_allocator {
+  void *(*alloc)(size_t size);
+  void *(*realloc)(void *ptr, size_t old_size, size_t size);
+  void (*free)(void *ptr, int size);
+  void (*check)(void);
+  void (*exists)(void *ptr, int size);
+};
+extern struct tgl_allocator tgl_allocator_release;
+extern struct tgl_allocator tgl_allocator_debug;
+struct tgl_state;
+
+enum tgl_value_type {
+    tgl_phone_number,           // user phone number
+    tgl_code,                   // telegram login code, or 'call' for phone call request
+    tgl_register_info,          // "Y/n" register?, first name, last name
+    tgl_new_password,           // new pass, confirm new pass
+    tgl_cur_and_new_password,   // curr pass, new pass, confirm new pass
+    tgl_cur_password,           // current pass
+    tgl_bot_hash
+};
+
+struct tgl_update_callback {
+  void (*new_msg)(struct tgl_state *TLS, struct tgl_message *M);
+  void (*marked_read)(struct tgl_state *TLS, int num, struct tgl_message *list[]);
+  void (*logprintf)(const char *format, ...)  __attribute__ ((format (printf, 1, 2)));
+  void (*get_values)(struct tgl_state *TLS, enum tgl_value_type type, const char *prompt, int num_values,
+          void (*callback)(struct tgl_state *TLS, const char *string[], void *arg), void *arg);
+  void (*logged_in)(struct tgl_state *TLS);
+  void (*started)(struct tgl_state *TLS);
+  void (*type_notification)(struct tgl_state *TLS, struct tgl_user *U, enum tgl_typing_status status);
+  void (*type_in_chat_notification)(struct tgl_state *TLS, struct tgl_user *U, struct tgl_chat *C, enum tgl_typing_status status);
+  void (*type_in_secret_chat_notification)(struct tgl_state *TLS, struct tgl_secret_chat *E);
+  void (*status_notification)(struct tgl_state *TLS, struct tgl_user *U);
+  void (*user_registered)(struct tgl_state *TLS, struct tgl_user *U);
+  void (*user_activated)(struct tgl_state *TLS, struct tgl_user *U);
+  void (*new_authorization)(struct tgl_state *TLS, const char *device, const char *location);
+  void (*chat_update)(struct tgl_state *TLS, struct tgl_chat *C, unsigned flags);
+  void (*user_update)(struct tgl_state *TLS, struct tgl_user *C, unsigned flags);
+  void (*secret_chat_update)(struct tgl_state *TLS, struct tgl_secret_chat *C, unsigned flags);
+  void (*msg_receive)(struct tgl_state *TLS, struct tgl_message *M);
+  void (*our_id)(struct tgl_state *TLS, int id);
+  void (*notification)(struct tgl_state *TLS, const char *type, const char *message);
+  void (*user_status_update)(struct tgl_state *TLS, struct tgl_user *U);
+  char *(*create_print_name) (struct tgl_state *TLS, tgl_peer_id_t id, const char *a1, const char *a2, const char *a3, const char *a4);
+};
+
+struct tgl_net_methods {
+  int (*write_out) (struct connection *c, const void *data, int len);
+  int (*read_in) (struct connection *c, void *data, int len);
+  int (*read_in_lookup) (struct connection *c, void *data, int len);
+  void (*flush_out) (struct connection *c);
+  void (*incr_out_packet_num) (struct connection *c);
+  void (*free) (struct connection *c);
+  struct tgl_dc *(*get_dc) (struct connection *c);
+  struct tgl_session *(*get_session) (struct connection *c);
+
+  struct connection *(*create_connection) (struct tgl_state *TLS, const char *host, int port, struct tgl_session *session, struct tgl_dc *dc, struct mtproto_methods *methods);
+};
+
+struct mtproto_methods {
+  int (*ready) (struct tgl_state *TLS, struct connection *c);
+  int (*close) (struct tgl_state *TLS, struct connection *c);
+  int (*execute) (struct tgl_state *TLS, struct connection *c, int op, int len);
+};
+
+struct tgl_timer;
+struct tree_random_id;
+
+struct tgl_timer_methods {
+  struct tgl_timer *(*alloc) (struct tgl_state *TLS, void (*cb)(struct tgl_state *TLS, void *arg), void *arg);
+  void (*insert) (struct tgl_timer *t, double timeout);
+  void (*remove) (struct tgl_timer *t);
+  void (*free) (struct tgl_timer *t);
+};
+
+#define E_ERROR 0
+#define E_WARNING 1
+#define E_NOTICE 2
+#define E_DEBUG 6
+
+#define TGL_LOCK_DIFF 1
+#define TGL_LOCK_PASSWORD 2
+
+#define TGL_MAX_RSA_KEYS_NUM 10
+// Do not modify this structure, unless you know what you do
+
+#pragma pack(push,4)
+struct tgl_state {
+  int our_id; // ID of logged in user
+  int encr_root;
+  unsigned char *encr_prime;
+  void *encr_prime_bn;
+  int encr_param_version;
+  int pts;
+  int qts;
+  int date;
+  int seq;
+  int binlog_enabled;
+  int test_mode;
+  int verbosity;
+  int unread_messages;
+  int active_queries;
+  int max_msg_id;
+  int started;
+  int disable_link_preview;
+
+  long long locks;
+  struct tgl_dc *DC_list[TGL_MAX_DC_NUM];
+  struct tgl_dc *DC_working;
+  int max_dc_num;
+  int dc_working_num;
+  int enable_pfs;
+  int temp_key_expire_time;
+
+  long long cur_uploading_bytes;
+  long long cur_uploaded_bytes;
+  long long cur_downloading_bytes;
+  long long cur_downloaded_bytes;
+
+  char *binlog_name;
+  char *auth_file;
+  char *downloads_directory;
+
+  struct tgl_update_callback callback;
+  struct tgl_net_methods *net_methods;
+  void *ev_base;
+
+  char *rsa_key_list[TGL_MAX_RSA_KEYS_NUM];
+  void *rsa_key_loaded[TGL_MAX_RSA_KEYS_NUM];
+  long long rsa_key_fingerprint[TGL_MAX_RSA_KEYS_NUM];
+  int rsa_key_num;
+
+  struct bignum_ctx *BN_ctx;
+
+  struct tgl_allocator allocator;
+
+  struct tree_peer *peer_tree;
+  struct tree_peer_by_name *peer_by_name_tree;
+  struct tree_message *message_tree;
+  struct tree_message *message_unsent_tree;
+  struct tree_photo *photo_tree;
+  struct tree_document *document_tree;
+  struct tree_webpage *webpage_tree;
+  struct tree_encr_document *encr_document_tree;
+
+  int users_allocated;
+  int chats_allocated;
+  int messages_allocated;
+  int peer_num;
+  int peer_size;
+  int encr_chats_allocated;
+  int geo_chats_allocated;
+
+  tgl_peer_t **Peers;
+  struct tgl_message message_list;
+
+  int binlog_fd;
+
+  struct tgl_timer_methods *timer_methods;
+
+  struct tree_query *queries_tree;
+
+  char *base_path;
+
+  struct tree_user *online_updates;
+
+  struct tgl_timer *online_updates_timer;
+
+  int app_id;
+  char *app_hash;
+
+  void *ev_login;
+
+  char *app_version;
+  int ipv6_enabled;
+
+  struct tree_random_id *random_id_tree;
+
+  char *error;
+  int error_code;
+
+  int is_bot;
+};
+#pragma pack(pop)
+//extern struct tgl_state tgl_state;
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+void tgl_reopen_binlog_for_writing (struct tgl_state *TLS);
+void tgl_replay_log (struct tgl_state *TLS);
+
+int tgl_print_stat (struct tgl_state *TLS, char *s, int len);
+tgl_peer_t *tgl_peer_get (struct tgl_state *TLS, tgl_peer_id_t id);
+tgl_peer_t *tgl_peer_get_by_name (struct tgl_state *TLS, const char *s);
+
+struct tgl_message *tgl_message_get (struct tgl_state *TLS, long long id);
+void tgl_peer_iterator_ex (struct tgl_state *TLS, void (*it)(tgl_peer_t *P, void *extra), void *extra);
+
+int tgl_complete_user_list (struct tgl_state *TLS, int index, const char *text, int len, char **R);
+int tgl_complete_chat_list (struct tgl_state *TLS, int index, const char *text, int len, char **R);
+int tgl_complete_encr_chat_list (struct tgl_state *TLS, int index, const char *text, int len, char **R);
+int tgl_complete_peer_list (struct tgl_state *TLS, int index, const char *text, int len, char **R);
+int tgl_secret_chat_for_user (struct tgl_state *TLS, tgl_peer_id_t user_id);
+int tgl_do_send_bot_auth (struct tgl_state *TLS, const char *code, int code_len, void (*callback)(struct tgl_state *TLS, void *callback_extra, int success, struct tgl_user *Self), void *callback_extra);
+
+#define TGL_PEER_USER 1
+#define TGL_PEER_CHAT 2
+#define TGL_PEER_GEO_CHAT 3
+#define TGL_PEER_ENCR_CHAT 4
+#define TGL_PEER_UNKNOWN 0
+
+#define TGL_MK_USER(id) tgl_set_peer_id (TGL_PEER_USER,id)
+#define TGL_MK_CHAT(id) tgl_set_peer_id (TGL_PEER_CHAT,id)
+#define TGL_MK_GEO_CHAT(id) tgl_set_peer_id (TGL_PEER_GEO_CHAT,id)
+#define TGL_MK_ENCR_CHAT(id) tgl_set_peer_id (TGL_PEER_ENCR_CHAT,id)
+
+void tgl_set_binlog_mode (struct tgl_state *TLS, int mode);
+void tgl_set_binlog_path (struct tgl_state *TLS, const char *path);
+void tgl_set_auth_file_path (struct tgl_state *TLS, const char *path);
+void tgl_set_download_directory (struct tgl_state *TLS, const char *path);
+void tgl_set_callback (struct tgl_state *TLS, struct tgl_update_callback *cb);
+void tgl_set_rsa_key (struct tgl_state *TLS, const char *key);
+void tgl_set_app_version (struct tgl_state *TLS, const char *app_version);
+
+static inline int tgl_get_peer_type (tgl_peer_id_t id) {
+  return id.type;
+}
+
+static inline int tgl_get_peer_id (tgl_peer_id_t id) {
+  return id.id;
+}
+
+static inline tgl_peer_id_t tgl_set_peer_id (int type, int id) {
+  tgl_peer_id_t ID;
+  ID.id = id;
+  ID.type = type;
+  return ID;
+}
+
+static inline int tgl_cmp_peer_id (tgl_peer_id_t a, tgl_peer_id_t b) {
+  return memcmp (&a, &b, sizeof (a));
+}
+
+void tgl_incr_verbosity (struct tgl_state *TLS);
+void tgl_set_verbosity (struct tgl_state *TLS, int val);
+void tgl_enable_pfs (struct tgl_state *TLS);
+void tgl_set_test_mode (struct tgl_state *TLS);
+void tgl_set_net_methods (struct tgl_state *TLS, struct tgl_net_methods *methods);
+void tgl_set_timer_methods (struct tgl_state *TLS, struct tgl_timer_methods *methods);
+void tgl_set_ev_base (struct tgl_state *TLS, void *ev_base);
+
+int tgl_authorized_dc (struct tgl_state *TLS, struct tgl_dc *DC);
+int tgl_signed_dc (struct tgl_state *TLS, struct tgl_dc *DC);
+
+void tgl_init (struct tgl_state *TLS);
+void tgl_dc_authorize (struct tgl_state *TLS, struct tgl_dc *DC);
+
+void tgl_dc_iterator (struct tgl_state *TLS, void (*iterator)(struct tgl_dc *DC));
+void tgl_dc_iterator_ex (struct tgl_state *TLS, void (*iterator)(struct tgl_dc *DC, void *extra), void *extra);
+
+#define TGL_SEND_MSG_FLAG_DISABLE_PREVIEW 1
+#define TGL_SEND_MSG_FLAG_ENABLE_PREVIEW 2
+
+#define TGL_SEND_MSG_FLAG_DOCUMENT_IMAGE TGLDF_IMAGE
+#define TGL_SEND_MSG_FLAG_DOCUMENT_STICKER TGLDF_STICKER
+#define TGL_SEND_MSG_FLAG_DOCUMENT_ANIMATED TGLDF_ANIMATED
+#define TGL_SEND_MSG_FLAG_DOCUMENT_AUDIO TGLDF_AUDIO
+#define TGL_SEND_MSG_FLAG_DOCUMENT_VIDEO TGLDF_VIDEO
+#define TGL_SEND_MSG_FLAG_DOCUMENT_AUTO 32
+#define TGL_SEND_MSG_FLAG_DOCUMENT_PHOTO 64
+
+#define TGL_SEND_MSG_FLAG_REPLY(x) (((unsigned long long)x) << 32)
+
+typedef tgl_peer_id_t tgl_user_id_t;
+typedef tgl_peer_id_t tgl_chat_id_t;
+typedef tgl_peer_id_t tgl_secret_chat_id_t;
+typedef tgl_peer_id_t tgl_user_or_chat_id_t;
+
+void tgl_insert_empty_user (struct tgl_state *TLS, int id);
+void tgl_insert_empty_chat (struct tgl_state *TLS, int id);
+
+
+void tgl_free_all (struct tgl_state *TLS);
+void tgl_register_app_id (struct tgl_state *TLS, int app_id, const char *app_hash);
+
+void tgl_login (struct tgl_state *TLS);
+void tgl_enable_ipv6 (struct tgl_state *TLS);
+void tgl_enable_bot (struct tgl_state *TLS);
+
+struct tgl_state *tgl_state_alloc (void);
+
+void tgl_disable_link_preview (struct tgl_state *TLS);
+void tgl_do_lookup_state (struct tgl_state *TLS);
+
+/* {{{ WORK WITH ACCOUNT */
+// sets account password
+// user will be requested to type his current password and new password (twice)
+void tgl_do_set_password (struct tgl_state *TLS, const char *hint, int hint_len, void (*callback)(struct tgl_state *TLS, void *extra, int success), void *extra);
+/* }}} */
+
+/* {{{ SENDING MESSAGES */
+
+struct tl_ds_reply_markup;
+
+// send plain text message to peer id
+// flags is combination of TGL_SEND_MSG_FLAG_*
+// reply markup can be NULL
+void tgl_do_send_message (struct tgl_state *TLS, tgl_peer_id_t id, const char *text, int text_len, unsigned long long flags, struct tl_ds_reply_markup *reply_markup, void (*callback)(struct tgl_state *TLS, void *callback_extra, int success, struct tgl_message *M), void *callback_extra);
+
+// sends plain text reply on message *reply_id*
+// message *reply_id* should be cached
+void tgl_do_reply_message (struct tgl_state *TLS, int reply_id, const char *text, int text_len, unsigned long long flags, void (*callback)(struct tgl_state *TLS, void *callback_extra, int success, struct tgl_message *M), void *callback_extra);
+
+// sends contents of text file *file_name* as plain text message
+void tgl_do_send_text (struct tgl_state *TLS, tgl_peer_id_t id, const char *file_name, unsigned long long flags, void (*callback)(struct tgl_state *TLS, void *callback_extra, int success, struct tgl_message *M), void *callback_extra);
+void tgl_do_reply_text (struct tgl_state *TLS, int reply_id, const char *file_name, unsigned long long flags, void (*callback)(struct tgl_state *TLS, void *callback_extra, int success, struct tgl_message *M), void *callback_extra);
+
+// send media from file *file_name* to peer *to_id*
+// if reply > 0 this message is sent as reply to message *reply*
+// *caption* is used only for photos
+void tgl_do_send_document (struct tgl_state *TLS, tgl_peer_id_t to_id, const char *file_name, const char *caption, int caption_len, unsigned long long flags, void (*callback)(struct tgl_state *TLS, void *callback_extra, int success, struct tgl_message *M), void *callback_extra);
+void tgl_do_reply_document (struct tgl_state *TLS, int reply_id, const char *file_name, const char *caption, int caption_len, unsigned long long flags, void (*callback)(struct tgl_state *TLS, void *callback_extra, int success, struct tgl_message *M), void *callback_extra);
+
+// forward message *msg_id* to peer *id*
+// message can not be encrypted and peer can not be secret chat
+void tgl_do_forward_message (struct tgl_state *TLS, tgl_user_or_chat_id_t id, int msg_id, unsigned long long flags, void (*callback)(struct tgl_state *TLS, void *callback_extra, int success, struct tgl_message *M), void *callback_extra);
+
+// forward messages *ids* to peer *id*
+// messages can not be encrypted and peer can not be secret chat
+void tgl_do_forward_messages (struct tgl_state *TLS, tgl_user_or_chat_id_t id, int size, const int ids[], unsigned long long flags, void (*callback)(struct tgl_state *TLS, void *callback_extra, int success, int count, struct tgl_message *ML[]), void *callback_extra);
+
+// sends contact to another user.
+// This contact may be or may not be telegram user
+void tgl_do_send_contact (struct tgl_state *TLS, tgl_peer_id_t id, const char *phone, int phone_len, const char *first_name, int first_name_len, const char *last_name, int last_name_len, unsigned long long flags, void (*callback)(struct tgl_state *TLS, void *callback_extra, int success, struct tgl_message *M), void *callback_extra);
+
+// reply on message *reply_id* with contact
+void tgl_do_reply_contact (struct tgl_state *TLS, int reply_id, const char *phone, int phone_len, const char *first_name, int first_name_len, const char *last_name, int last_name_len, unsigned long long flags, void (*callback)(struct tgl_state *TLS, void *callback_extra, int success, struct tgl_message *M), void *callback_extra);
+
+// sends media from message *msg_id* to another dialog
+// a bit different from forwarding message with media
+// secret message media can be forwarded to secret chats
+// and non-secret - to non-secret chats and users
+void tgl_do_forward_media (struct tgl_state *TLS, tgl_peer_id_t id, int msg_id, unsigned long long flags, void (*callback)(struct tgl_state *TLS, void *callback_extra, int success, struct tgl_message *M), void *callback_extra);
+
+// sends location to chat *id*
+void tgl_do_send_location (struct tgl_state *TLS, tgl_peer_id_t id, double latitude, double longitude, unsigned long long flags, void (*callback)(struct tgl_state *TLS, void *callback_extra, int success, struct tgl_message *M), void *callback_extra);
+
+// replies on message *reply_id* with location
+void tgl_do_reply_location (struct tgl_state *TLS, int reply_id, double latitude, double longitude, unsigned long long flags, void (*callback)(struct tgl_state *TLS, void *callback_extra, int success, struct tgl_message *M), void *callback_extra);
+
+// sends broadcast (i.e. message to several users at once)
+// flags are same as in tgl_do_send_message
+void tgl_do_send_broadcast (struct tgl_state *TLS, int num, tgl_user_id_t id[], const char *text, int text_len, unsigned long long flags, void (*callback)(struct tgl_state *TLS, void *extra, int success, int num, struct tgl_message *ML[]), void *callback_extra);
+
+/* }}} */
+
+/* {{{ EDITING SELF PROFILE */
+// sets self profile photo
+// server will cut central square from this photo
+void tgl_do_set_profile_photo (struct tgl_state *TLS, const char *file_name, void (*callback)(struct tgl_state *TLS, void *callback_extra, int success), void *callback_extra);
+
+// rename self account
+void tgl_do_set_profile_name (struct tgl_state *TLS, const char *first_name, int first_name_len, const char *last_name, int last_name_len, void (*callback)(struct tgl_state *TLS, void *callback_extra, int success, struct tgl_user *U), void *callback_extra);
+
+// sets self username
+void tgl_do_set_username (struct tgl_state *TLS, const char *username, int username_len, void (*callback)(struct tgl_state *TLS, void *callback_extra, int success, struct tgl_user *U), void *callback_extra);
+
+// updates online/offline status
+void tgl_do_update_status (struct tgl_state *TLS, int online, void (*callback)(struct tgl_state *TLS, void *callback_extra, int success), void *callback_extra);
+
+// exports card. This card can be later be used by another user to add you to dialog list.
+void tgl_do_export_card (struct tgl_state *TLS, void (*callback)(struct tgl_state *TLS, void *callback_extra, int success, int size, int *card), void *callback_extra);
+/* }}} */
+
+/* {{{ WORKING WITH GROUP CHATS */
+
+// sets chat photo
+// server will cut central square from this photo
+void tgl_do_set_chat_photo (struct tgl_state *TLS, tgl_chat_id_t chat_id, const char *file_name, void (*callback)(struct tgl_state *TLS, void *callback_extra, int success), void *callback_extra);
+
+// sets chat title
+void tgl_do_rename_chat (struct tgl_state *TLS, tgl_chat_id_t id, const char *new_title, int new_title_len, void (*callback)(struct tgl_state *TLS, void *callback_extra, int success), void *callback_extra);
+
+// requests full info about chat *id*.
+// if *offline_mode* is set no actual query is sent
+void tgl_do_get_chat_info (struct tgl_state *TLS, tgl_chat_id_t id, int offline_mode, void (*callback)(struct tgl_state *TLS, void *callback_extra, int success, struct tgl_chat *C), void *callback_extra);
+
+// adds user *id* to chat *chat_id*
+// sends *limit* last messages from this chat to user
+void tgl_do_add_user_to_chat (struct tgl_state *TLS, tgl_chat_id_t chat_id, tgl_user_id_t id, int limit, void (*callback)(struct tgl_state *TLS, void *callback_extra, int success), void *callback_extra);
+
+// deleted user *id* from chat *chat_id*
+// you can do it if you are admin (=creator) of chat or if you invited this user or if it is yourself
+void tgl_do_del_user_from_chat (struct tgl_state *TLS, tgl_chat_id_t chat_id, tgl_user_id_t id, void (*callback)(struct tgl_state *TLS, void *callback_extra, int success), void *callback_extra);
+
+// creates group chat with users ids
+// there should be at least one user other then you in chat
+void tgl_do_create_group_chat (struct tgl_state *TLS, int users_num, tgl_user_id_t ids[], const char *chat_topic, int chat_topic_len, void (*callback)(struct tgl_state *TLS, void *callback_extra, int success), void *callback_extra);
+
+// receives invitation link to this chat
+// only chat admin can create one
+// prevoius link invalidated, if existed
+void tgl_do_export_chat_link (struct tgl_state *TLS, tgl_peer_id_t id, void (*callback)(struct tgl_state *TLS, void *callback_extra, int success, const char *link), void *callback_extra);
+
+// joins to secret chat by link (or hash of this link)
+void tgl_do_import_chat_link (struct tgl_state *TLS, const char *link, int link_len, void (*callback)(struct tgl_state *TLS, void *callback_extra, int success), void *callback_extra);
+
+/* }}} */
+
+/* {{{ WORKING WITH USERS */
+
+// requests full info about user *id*.
+// if *offline_mode* is set no actual query is sent
+void tgl_do_get_user_info (struct tgl_state *TLS, tgl_user_id_t id, int offline_mode, void (*callback)(struct tgl_state *TLS, void *callback_extra, int success, struct tgl_user *U), void *callback_extra);
+
+// adds contact to contact list by phone number
+// user will be named  *first_name* *last_name* in contact list
+// force should be set to 0
+void tgl_do_add_contact (struct tgl_state *TLS, const char *phone, int phone_len, const char *first_name, int first_name_len, const char *last_name, int last_name_len, int force, void (*callback)(struct tgl_state *TLS, void *callback_extra, int success, int size, struct tgl_user *users[]), void *callback_extra);
+
+// deletes user *id* from contact list
+void tgl_do_del_contact (struct tgl_state *TLS, tgl_peer_id_t id, void (*callback)(struct tgl_state *TLS, void *callback_extra, int success), void *callback_extra);
+
+// imports card exported by another user
+void tgl_do_import_card (struct tgl_state *TLS, int size, int *card, void (*callback)(struct tgl_state *TLS, void *callback_extra, int success, struct tgl_user *U), void *callback_extra);
+
+// blocks user
+void tgl_do_block_user (struct tgl_state *TLS, tgl_peer_id_t id, void (*callback)(struct tgl_state *TLS, void *callback_extra, int success), void *callback_extra);
+
+// unblocks blocked user
+void tgl_do_unblock_user (struct tgl_state *TLS, tgl_peer_id_t id, void (*callback)(struct tgl_state *TLS, void *callback_extra, int success), void *callback_extra);
+/* }}} */
+
+/* {{{ WORKING WITH SECRET CHATS */
+
+// requests creation of secret chat with user *user_id*
+//void tgl_do_create_encr_chat_request (struct tgl_state *TLS, int user_id, void (*callback)(struct tgl_state *TLS, void *callback_extra, int success, struct tgl_secret_chat *E), void *callback_extra);
+
+// accepts secret chat request
+// method can fail if another device will be first to accept it
+void tgl_do_accept_encr_chat_request (struct tgl_state *TLS, struct tgl_secret_chat *E, void (*callback)(struct tgl_state *TLS, void *callback_extra, int success, struct tgl_secret_chat *E), void *callback_extra);
+
+// sets ttl of secret chat
+void tgl_do_set_encr_chat_ttl (struct tgl_state *TLS, struct tgl_secret_chat *E, int ttl, void (*callback)(struct tgl_state *TLS, void *callback_extra, int success, struct tgl_message *M), void *callback_extra);
+
+// returns secret chat fingerprint
+int tgl_do_visualize_key (struct tgl_state *TLS, tgl_secret_chat_id_t id, unsigned char buf[16]);
+
+// requests creation of secret chat with user id
+void tgl_do_create_secret_chat (struct tgl_state *TLS, tgl_user_id_t id, void (*callback)(struct tgl_state *TLS, void *callback_extra, int success, struct tgl_secret_chat *E), void *callback_extra);
+/* }}} */
+
+/* {{{ WORKING WITH DIALOG LIST */
+
+// receives all dialogs (except secret chats) from offset=*offset* with limit=*limit*
+// dialogs are sorted by last message received
+// if limit is > 100 there is a (small) chance of one dialog received twice
+void tgl_do_get_dialog_list (struct tgl_state *TLS, int limit, int offset, void (*callback)(struct tgl_state *TLS, void *callback_extra, int success, int size, tgl_peer_id_t peers[], int last_msg_id[], int unread_count[]), void *callback_extra);
+
+// resolves username
+void tgl_do_contact_search (struct tgl_state *TLS, const char *name, int name_len, void (*callback)(struct tgl_state *TLS, void *callback_extra, int success, struct tgl_user *U), void *callback_extra);
+
+// requests contact list
+void tgl_do_update_contact_list (struct tgl_state *TLS, void (*callback)(struct tgl_state *TLS, void *callback_extra, int success, int size, struct tgl_user *contacts[]), void *callback_extra);
+
+/* }}} */
+
+/* {{{ WORKING WITH ONE DIALOG */
+
+// marks all inbound messages from peer id as read
+void tgl_do_mark_read (struct tgl_state *TLS, tgl_peer_id_t id, void (*callback)(struct tgl_state *TLS, void *callback_extra, int success), void *callback_extra);
+
+// requests last *limit* from offset *offset* (offset = 0 means most recent) messages from dialog with peer id
+// if offline_mode=1 then no actual query is sent
+// only locally cached messages returned
+// also marks messages from this chat as read
+void tgl_do_get_history (struct tgl_state *TLS, tgl_peer_id_t id, int offset, int limit, int offline_mode, void (*callback)(struct tgl_state *TLS, void *callback_extra, int success, int size, struct tgl_message *list[]), void *callback_extra);
+
+// sends typing event to chat
+// set status=tgl_typing_typing for default typing event
+void tgl_do_send_typing (struct tgl_state *TLS, tgl_peer_id_t id, enum tgl_typing_status status, void (*callback)(struct tgl_state *TLS, void *callback_extra, int success), void *callback_extra);
+
+/* }}} */
+
+/* {{{ WORKING WITH MEDIA */
+
+// loads photo/document/document_thumb to downloads directory
+// if file is presented it is not redownloaded (but if it is shortened tail will be downloaded)
+// returns file name in callback
+void tgl_do_load_photo (struct tgl_state *TLS, struct tgl_photo *photo, void (*callback)(struct tgl_state *TLS, void *callback_extra, int success, const char *file_name), void *callback_extra);
+void tgl_do_load_encr_document (struct tgl_state *TLS, struct tgl_encr_document *V, void (*callback)(struct tgl_state *TLS, void *callback_extra, int success, const char *file_name), void *callback_extra);
+void tgl_do_load_document (struct tgl_state *TLS, struct tgl_document *V, void (*callback)(struct tgl_state *TLS, void *callback_extra, int success, const char *file_name), void *callback_extra);
+void tgl_do_load_document_thumb (struct tgl_state *TLS, struct tgl_document *video, void (*callback)(struct tgl_state *TLS, void *callback_extra, int success, const char *file_name), void *callback_extra);
+void tgl_do_load_video (struct tgl_state *TLS, struct tgl_document *V, void (*callback)(struct tgl_state *TLS, void *callback_extra, int success, const char *filename), void *callback_extra);
+void tgl_do_load_audio (struct tgl_state *TLS, struct tgl_document *V, void (*callback)(struct tgl_state *TLS, void *callback_extra, int success, const char *filename), void *callback_extra);
+
+
+// loads file by location. Use only for small files!
+void tgl_do_load_file_location (struct tgl_state *TLS, struct tgl_file_location *FL, void (*callback)(struct tgl_state *TLS, void *callback_extra, int success, const char *file_name), void *callback_extra);
+
+/* }}} */
+
+
+/* {{{ ANOTHER MESSAGES FUNCTIONS */
+// search messages with ids *from* .. *to* in dialog id
+// id type of id is UNKNOWN uses global search (in all dialogs) instead
+// if *from* or *to* is means *from*=0 and *to*=+INF
+// return up to *limit* entries from offset=*offset*
+void tgl_do_msg_search (struct tgl_state *TLS, tgl_user_or_chat_id_t id, int from, int to, int limit, int offset, const char *query, int query_len, void (*callback)(struct tgl_state *TLS, void *callback_extra, int success, int size, struct tgl_message *list[]), void *callback_extra);
+
+// deletes message *id*
+void tgl_do_delete_msg (struct tgl_state *TLS, long long msg_id, void (*callback)(struct tgl_state *TLS, void *callback_extra, int success), void *callback_extra);
+
+// gets message by *id*
+void tgl_do_get_message (struct tgl_state *TLS, long long id, void (*callback)(struct tgl_state *TLS, void *callback_extra, int success, struct tgl_message *M), void *callback_extra);
+
+/* }}} */
+
+
+/* {{{ EXTENDED QUERIES USE WITH CAUTION */
+// sends query with extended text syntax
+// use only for debug or when you known what are you doing
+// since answer is not interpretated by library in any way
+void tgl_do_send_extf (struct tgl_state *TLS, const char *data, int data_len, void (*callback)(struct tgl_state *TLS, void *callback_extra, int success, const char *data), void *callback_extra);
+int tglf_extf_autocomplete (struct tgl_state *TLS, const char *text, int text_len, int index, char **R, char *data, int data_len);
+struct paramed_type *tglf_extf_store (struct tgl_state *TLS, const char *data, int data_len);
+char *tglf_extf_fetch (struct tgl_state *TLS, struct paramed_type *T);
+/* }}} */
+
+/* {{{ BOT */
+void tgl_do_start_bot (struct tgl_state *TLS, tgl_peer_id_t bot, tgl_peer_id_t chat, const char *str, int str_len, void (*callback)(struct tgl_state *TLS, void *callback_extra, int success), void *callback_extra);
+/* }}} */
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif