Skip to main content

Fast Telegram Crypto Library for Python

Project description

TgCrypto

Fast Telegram Crypto Library for Python

Table of Contents

About

TgCrypto is a high-performance, easy-to-install Telegram Crypto Library written in C as a Python extension. TgCrypto is intended for Pyrogram [1] 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

$ pip3 install --upgrade tgcrypto

Note: Being a C extension for Python, TgCrypto is an optional but highly recommended Pyrogram dependency; if TgCrypto is not detected in your system, Pyrogram will automatically fall back to the much slower 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_decrypted

Contribution

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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

TgCrypto-1.1.1.tar.gz (33.0 kB view hashes)

Uploaded Source

Built Distributions

TgCrypto-1.1.1-cp37-cp37m-win_amd64.whl (19.7 kB view hashes)

Uploaded CPython 3.7m Windows x86-64

TgCrypto-1.1.1-cp37-cp37m-win32.whl (19.3 kB view hashes)

Uploaded CPython 3.7m Windows x86

TgCrypto-1.1.1-cp37-cp37m-manylinux1_x86_64.whl (16.7 kB view hashes)

Uploaded CPython 3.7m

TgCrypto-1.1.1-cp37-cp37m-manylinux1_i686.whl (17.0 kB view hashes)

Uploaded CPython 3.7m

TgCrypto-1.1.1-cp37-cp37m-macosx_10_6_intel.macosx_10_9_intel.macosx_10_9_x86_64.macosx_10_10_intel.macosx_10_10_x86_64.whl (32.5 kB view hashes)

Uploaded CPython 3.7m macOS 10.10+ intel macOS 10.10+ x86-64 macOS 10.6+ intel macOS 10.9+ intel macOS 10.9+ x86-64

TgCrypto-1.1.1-cp36-cp36m-win_amd64.whl (19.7 kB view hashes)

Uploaded CPython 3.6m Windows x86-64

TgCrypto-1.1.1-cp36-cp36m-win32.whl (19.3 kB view hashes)

Uploaded CPython 3.6m Windows x86

TgCrypto-1.1.1-cp36-cp36m-manylinux1_x86_64.whl (16.7 kB view hashes)

Uploaded CPython 3.6m

TgCrypto-1.1.1-cp36-cp36m-manylinux1_i686.whl (17.0 kB view hashes)

Uploaded CPython 3.6m

TgCrypto-1.1.1-cp36-cp36m-macosx_10_6_intel.macosx_10_9_intel.macosx_10_9_x86_64.macosx_10_10_intel.macosx_10_10_x86_64.whl (32.5 kB view hashes)

Uploaded CPython 3.6m macOS 10.10+ intel macOS 10.10+ x86-64 macOS 10.6+ intel macOS 10.9+ intel macOS 10.9+ x86-64

TgCrypto-1.1.1-cp35-cp35m-win_amd64.whl (24.1 kB view hashes)

Uploaded CPython 3.5m Windows x86-64

TgCrypto-1.1.1-cp35-cp35m-win32.whl (24.0 kB view hashes)

Uploaded CPython 3.5m Windows x86

TgCrypto-1.1.1-cp35-cp35m-manylinux1_x86_64.whl (16.7 kB view hashes)

Uploaded CPython 3.5m

TgCrypto-1.1.1-cp35-cp35m-manylinux1_i686.whl (17.0 kB view hashes)

Uploaded CPython 3.5m

TgCrypto-1.1.1-cp35-cp35m-macosx_10_6_intel.macosx_10_9_intel.macosx_10_9_x86_64.macosx_10_10_intel.macosx_10_10_x86_64.whl (32.5 kB view hashes)

Uploaded CPython 3.5m macOS 10.10+ intel macOS 10.10+ x86-64 macOS 10.6+ intel macOS 10.9+ intel macOS 10.9+ x86-64

TgCrypto-1.1.1-cp34-cp34m-win_amd64.whl (15.9 kB view hashes)

Uploaded CPython 3.4m Windows x86-64

TgCrypto-1.1.1-cp34-cp34m-win32.whl (17.9 kB view hashes)

Uploaded CPython 3.4m Windows x86

TgCrypto-1.1.1-cp34-cp34m-manylinux1_x86_64.whl (16.6 kB view hashes)

Uploaded CPython 3.4m

TgCrypto-1.1.1-cp34-cp34m-manylinux1_i686.whl (16.9 kB view hashes)

Uploaded CPython 3.4m

TgCrypto-1.1.1-cp34-cp34m-macosx_10_6_intel.macosx_10_9_intel.macosx_10_9_x86_64.macosx_10_10_intel.macosx_10_10_x86_64.whl (32.5 kB view hashes)

Uploaded CPython 3.4m macOS 10.10+ intel macOS 10.10+ x86-64 macOS 10.6+ intel macOS 10.9+ intel macOS 10.9+ x86-64

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page