Telegram Crypto Library for Pyrogram
Project description
Telegram Crypto Library for Pyrogram
Table of Contents
About
TgCrypto is a high-performance, easy-to-install Telegram Crypto Library specifically written in C for Pyrogram [1] as a Python extension. TgCrypto is a replacement for the much slower PyAES and implements the crypto algorithms Telegram requires, namely AES-IGE 256 bit (used in MTProto v2.0) and AES-CTR 256 bit (used for CDN encrypted files).
Installation
$ pip install --upgrade tgcryptoNote: Being a C extension for Python, TgCrypto is an optional but highly recommended dependency; when TgCrypto is not detected in your system, Pyrogram will automatically fall back to PyAES and will show you a warning.
The reason about being an optional package is that TgCrypto requires some extra system tools in order to be compiled. The errors you receive when trying to install TgCrypto are system dependent, but also descriptive enough to understand what you should do next:
Windows: Install Visual C++ 2015 Build Tools.
macOS: A pop-up will automatically ask you to install the command line developer tools.
Linux: Install a proper C compiler (gcc, clang) and the Python header files (python3-dev).
Termux (Android): Install clang and python-dev packages.
API
TgCrypto API consists of these four functions:
def ige_encrypt(data: bytes, key: bytes, iv: bytes) -> bytes:def ige_decrypt(data: bytes, key: bytes, iv: bytes) -> bytes:def ctr_encrypt(data: bytes, key: bytes, iv: bytes) -> bytes:def ctr_decrypt(data: bytes, key: bytes, iv: bytes) -> bytes:Usage
TgCrypto is as simple as this example:
import os
import tgcrypto
data = os.urandom(10 * 1024 * 1024) # 10 MB of random data
key = os.urandom(32) # Random Key
iv = os.urandom(32) # Random IV
ige_encrypted = tgcrypto.ige_encrypt(data, key, iv)
ige_decrypted = tgcrypto.ige_decrypt(ige_encrypted, key, iv)
assert data == ige_decryptedContribution
You are very welcome to contribute by either submitting pull requests or reporting issues/bugs as well as suggesting best practices, ideas, enhancements on both code and documentation. Any help is appreciated!
Feedback
Means for getting in touch:
License
Copyright (C) 2017-2018 Dan Tès <https://github.com/delivrance>
Licensed under the terms of the GNU Lesser General Public License v3 or later (LGPLv3+)
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
