WarpCrypto

Fast Cryptography Extension Library — Rust Implementation

WarpCrypto is a high-performance cryptography library written in Rust as a Python extension (via PyO3 + maturin). It implements the cryptographic algorithms required by Telegram's MTProto protocol:

AES-256-IGE — used in MTProto v2.0
AES-256-CTR — used for CDN encrypted files
kdf — key derivation function per MTProto 2.0 spec
pack_message / unpack_message — combined KDF+AES-IGE in a single call (1 GIL release vs 3 for tgcrypto)

Features

3–5× faster than tgcrypto (C extension) in multi-client benchmarks
AES-NI hardware acceleration via the aes crate's runtime CPU feature detection (cpufeatures)
Zero-copy IGE with block-aligned GenericArray operations
Block-based CTR — processes 16-byte blocks with chunks_exact_mut, not byte-by-byte
Proper state propagation — IV and state bytearrays are mutated in-place matching tgcrypto exactly
Memory safe — Rust's type system guarantees no buffer overflows, use-after-free, or data races
Zero compiler warnings

Requirements

Python 3.8 or higher
Rust toolchain (for building from source; pre-built wheels available for most platforms)

Installation

pip install WarpCrypto

Install from source:

pip install maturin
maturin build --release
pip install target/wheels/*.whl

API

def ige256_encrypt(data: bytes, key: bytes, iv: bytes) -> bytes: ...
def ige256_decrypt(data: bytes, key: bytes, iv: bytes) -> bytes: ...

def ctr256_encrypt(data: bytes, key: bytes, iv: bytearray, state: bytearray) -> bytes: ...
def ctr256_decrypt(data: bytes, key: bytes, iv: bytearray, state: bytearray) -> bytes: ...

def kdf(auth_key: bytes, msg_key: bytes, outgoing: bool) -> tuple[bytes, bytes]: ...

def pack_message(data: bytes, salt: int, session_id: bytes, auth_key: bytes, auth_key_id: bytes) -> bytes: ...
def unpack_message(packed: bytes, session_id: bytes, auth_key: bytes, auth_key_id: bytes) -> bytes: ...

Usage

IGE Mode (MTProto 2.0)

import os
import warpcrypto

data = os.urandom(10 * 1024 * 1024)
key = os.urandom(32)
iv = os.urandom(32)

ige_encrypted = warpcrypto.ige256_encrypt(data, key, iv)
ige_decrypted = warpcrypto.ige256_decrypt(ige_encrypted, key, iv)
assert data == ige_decrypted

CTR Mode (CDN)

import os
import warpcrypto

data = os.urandom(10 * 1024 * 1024)
key = os.urandom(32)
enc_iv = bytearray(os.urandom(16))
dec_iv = bytearray(enc_iv)

ctr_encrypted = warpcrypto.ctr256_encrypt(data, key, enc_iv, bytearray(1))
ctr_decrypted = warpcrypto.ctr256_decrypt(ctr_encrypted, key, dec_iv, bytearray(1))
assert data == ctr_decrypted

KDF (MTProto 2.0 key derivation)

import warpcrypto

auth_key = bytes(range(256))
msg_key = os.urandom(16)

aes_key, aes_iv = warpcrypto.kdf(auth_key, msg_key, outgoing=True)   # x=0
aes_key, aes_iv = warpcrypto.kdf(auth_key, msg_key, outgoing=False)  # x=8

Testing

pip install pytest
pytest

Performance

WarpCrypto outperforms tgcrypto (C extension) by 3–5× across all client counts (1–128 concurrent clients). Performance scales with AES-NI availability (most x86_64 and Apple Silicon CPUs).

License

LGPLv3+ — Originally by Dan. Rust port maintained by Riajul.

Download files

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

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

warpcrypto-2.0.5-cp314-cp314-win_amd64.whl (150.9 kB view details)

Uploaded Jul 26, 2026 CPython 3.14Windows x86-64

warpcrypto-2.0.5-cp314-cp314-manylinux_2_34_x86_64.whl (240.8 kB view details)

Uploaded Jul 26, 2026 CPython 3.14manylinux: glibc 2.34+ x86-64

warpcrypto-2.0.5-cp314-cp314-manylinux_2_34_aarch64.whl (231.4 kB view details)

Uploaded Jul 26, 2026 CPython 3.14manylinux: glibc 2.34+ ARM64

warpcrypto-2.0.5-cp314-cp314-macosx_11_0_arm64.whl (210.7 kB view details)

Uploaded Jul 26, 2026 CPython 3.14macOS 11.0+ ARM64

warpcrypto-2.0.5-cp313-cp313-win_amd64.whl (150.7 kB view details)

Uploaded Jul 26, 2026 CPython 3.13Windows x86-64

warpcrypto-2.0.5-cp313-cp313-manylinux_2_34_x86_64.whl (240.3 kB view details)

Uploaded Jul 26, 2026 CPython 3.13manylinux: glibc 2.34+ x86-64

warpcrypto-2.0.5-cp313-cp313-manylinux_2_34_aarch64.whl (231.0 kB view details)

Uploaded Jul 26, 2026 CPython 3.13manylinux: glibc 2.34+ ARM64

warpcrypto-2.0.5-cp313-cp313-macosx_11_0_arm64.whl (210.4 kB view details)

Uploaded Jul 26, 2026 CPython 3.13macOS 11.0+ ARM64

warpcrypto-2.0.5-cp312-cp312-win_amd64.whl (150.7 kB view details)

Uploaded Jul 26, 2026 CPython 3.12Windows x86-64

warpcrypto-2.0.5-cp312-cp312-manylinux_2_34_x86_64.whl (240.4 kB view details)

Uploaded Jul 26, 2026 CPython 3.12manylinux: glibc 2.34+ x86-64

warpcrypto-2.0.5-cp312-cp312-manylinux_2_34_aarch64.whl (231.1 kB view details)

Uploaded Jul 26, 2026 CPython 3.12manylinux: glibc 2.34+ ARM64

warpcrypto-2.0.5-cp312-cp312-macosx_11_0_arm64.whl (210.5 kB view details)

Uploaded Jul 26, 2026 CPython 3.12macOS 11.0+ ARM64

warpcrypto-2.0.5-cp311-cp311-win_amd64.whl (152.7 kB view details)

Uploaded Jul 26, 2026 CPython 3.11Windows x86-64

warpcrypto-2.0.5-cp311-cp311-manylinux_2_34_x86_64.whl (240.8 kB view details)

Uploaded Jul 26, 2026 CPython 3.11manylinux: glibc 2.34+ x86-64

warpcrypto-2.0.5-cp311-cp311-manylinux_2_34_aarch64.whl (232.1 kB view details)

Uploaded Jul 26, 2026 CPython 3.11manylinux: glibc 2.34+ ARM64

warpcrypto-2.0.5-cp311-cp311-macosx_11_0_arm64.whl (212.4 kB view details)

Uploaded Jul 26, 2026 CPython 3.11macOS 11.0+ ARM64

warpcrypto-2.0.5-cp310-cp310-win_amd64.whl (152.9 kB view details)

Uploaded Jul 26, 2026 CPython 3.10Windows x86-64

warpcrypto-2.0.5-cp310-cp310-manylinux_2_34_x86_64.whl (241.1 kB view details)

Uploaded Jul 26, 2026 CPython 3.10manylinux: glibc 2.34+ x86-64

warpcrypto-2.0.5-cp310-cp310-manylinux_2_34_aarch64.whl (232.3 kB view details)

Uploaded Jul 26, 2026 CPython 3.10manylinux: glibc 2.34+ ARM64

warpcrypto-2.0.5-cp310-cp310-macosx_11_0_arm64.whl (212.5 kB view details)

Uploaded Jul 26, 2026 CPython 3.10macOS 11.0+ ARM64

warpcrypto-2.0.5-cp39-cp39-win_amd64.whl (153.6 kB view details)

Uploaded Jul 26, 2026 CPython 3.9Windows x86-64

warpcrypto-2.0.5-cp39-cp39-manylinux_2_34_x86_64.whl (242.0 kB view details)

Uploaded Jul 26, 2026 CPython 3.9manylinux: glibc 2.34+ x86-64

warpcrypto-2.0.5-cp39-cp39-manylinux_2_34_aarch64.whl (233.1 kB view details)

Uploaded Jul 26, 2026 CPython 3.9manylinux: glibc 2.34+ ARM64

warpcrypto-2.0.5-cp39-cp39-macosx_11_0_arm64.whl (213.3 kB view details)

Uploaded Jul 26, 2026 CPython 3.9macOS 11.0+ ARM64

File details

Details for the file warpcrypto-2.0.5-cp314-cp314-win_amd64.whl.

File metadata

Download URL: warpcrypto-2.0.5-cp314-cp314-win_amd64.whl
Upload date: Jul 26, 2026
Size: 150.9 kB
Tags: CPython 3.14, Windows x86-64
Uploaded using Trusted Publishing? No
Uploaded via: uv/0.11.32 {"installer":{"name":"uv","version":"0.11.32","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for warpcrypto-2.0.5-cp314-cp314-win_amd64.whl
Algorithm	Hash digest
SHA256	`eb83ec0728edc5ece594802ae9e0addda89a82005833ec264dc0044faea38803`
MD5	`f9360afa171fd972764e8b56dc9e62bc`
BLAKE2b-256	`c6a99823fb4c1dd4454441e3ddee84088166f0598de5da4874f4aa6e344c8c43`

Algorithm	Hash digest
SHA256	`6d8566f83ab09bad29b4945cd78a36c99095c21838347b30d2524778b63b9c0a`
MD5	`0632291828401dac51f1e013bef0f62c`
BLAKE2b-256	`09505ddfdd6107bbd46ae7409eb3d7c4c7e3cfb0b0324b530a16aa0cd89716c8`

Algorithm	Hash digest
SHA256	`6c852680a83c59c567c9c12ed70f7d88b5ccb4b54f096a0712aad12e4d79864d`
MD5	`66ffdcb351409ccf475f12d45d70f04a`
BLAKE2b-256	`6df2d7b0c77114514c45d429c80c5751ed0e73da2c49fe6e5e12e8a7a82913ab`

Algorithm	Hash digest
SHA256	`c25492f9be8da57fa12c2207c20a7507943e91acc22b81e54ee9aea672e3628c`
MD5	`cdf06ae96a483f3eeee54ed833578398`
BLAKE2b-256	`39769f337faf85fefa9424e9ca0ecd91b350fd70d4fec6f9047a74e14b07e6de`

Algorithm	Hash digest
SHA256	`b9f7fd4b4ab45f4b3dd1994231c146b6b6f484ca4a85837860a37d9c0c0fe2f1`
MD5	`70580204565932d2b9832fbcb191dacd`
BLAKE2b-256	`f8bfe1c444c1130de755a3464a90fd9c61d7cffeb9b58b61ec9285751fe360a7`

Algorithm	Hash digest
SHA256	`f1421dc337350821a0525cc7eb67a2ce3c9dce104972ff9e5d6d4d27ea6d2651`
MD5	`304612c5de5dd56ba03534e51b501665`
BLAKE2b-256	`c5efd68c42a1a35043b9070f33475fbe510bb237e8fa3620d09d9d2b9427b86a`

Algorithm	Hash digest
SHA256	`f72eba14782c65d110dd1757344368f378b712e7a0803407faf80660e01754bb`
MD5	`aa1d8da00232942046871e9b27a5c78a`
BLAKE2b-256	`d78ea63551aa963f04adb9707c9f3ab59a79834b32290866170813620d161f20`

Algorithm	Hash digest
SHA256	`a33f69721ebb8168e3031b279922890f22dae0dfbbb3639e1e494dc35da51385`
MD5	`8241982bd69036d2a3ee9c83b5d50594`
BLAKE2b-256	`1808add15a174119333e9e839661c7073f8127a1a80d3c03fde0ae60910152be`

Algorithm	Hash digest
SHA256	`02ebdd2a4bb49d02994b1b077813edc8e956c8ebfc844b097a29413a0f4d69a6`
MD5	`7b0080870946d9c4c6159673b1341f9a`
BLAKE2b-256	`a7fd4ae24e7706eafcccf52776defbcc6af8df2511db6ab7a7994e3424c8666c`

Algorithm	Hash digest
SHA256	`b7fc88936d4f60c3dd5a006edb7f498eb18ab9208f399fd7f47c0c40db5a4cde`
MD5	`7236755c3f37a4f7c72e27096e5fadb8`
BLAKE2b-256	`8ff1d27e473bc004ecdffc39e7a9ba8c27bed18387898b678ff2c57ece67c3b8`

Algorithm	Hash digest
SHA256	`5d1967f2052b83e12326bbfa0757eebc57fca34ddfbb0e7d0cfa57fdd98951bc`
MD5	`c7bc58a2078ed5e725514313dd11e0bf`
BLAKE2b-256	`5440909f3b337239056b492bdc42749984295417f33b14004ca9467c682f4d5a`

Algorithm	Hash digest
SHA256	`373889483a6fb037701ee5cef4078babd6c7ebd2d7b4e886492bfbc3a9bd40d5`
MD5	`f441127f072edd9c3be032e4af1f0216`
BLAKE2b-256	`a5ae56cae3e5ea8552935b497ed99769208a7c98cfc7d6bf9871ec36d118eafc`

Algorithm	Hash digest
SHA256	`ab67a465b3c1b85d11b4cf8d4ae6890e0f6b192aa5a07c9b9add1fb4eeaee8b3`
MD5	`91efa2ef11c8773c60c40939843a874a`
BLAKE2b-256	`00d8c6443e5018b39b5a0796b38049cb7ae6b056377ada013eb6dd6c5015fa4e`

Algorithm	Hash digest
SHA256	`bdc9f94e35434b1d1df04c99b57b713e5ce192d7619e603786d3b3364982071f`
MD5	`cccd84a3d98ae04979d54297604e5603`
BLAKE2b-256	`aecaab31432f1192fcb7927082143210aa8673cde6e667c237dd13a92bee355b`

Algorithm	Hash digest
SHA256	`210ed53c30643064e3bb3cbf7dc1ddb10c11b837f2edc71a3730e52e69f2ef2f`
MD5	`87848f1b2b5cc382974d96272d541191`
BLAKE2b-256	`49528ff0f84dd03982d64749d5a98699ef2ad3727d8dec3491f1beb6b411b4f4`

Algorithm	Hash digest
SHA256	`3a40a1de654b29e03d5b93b79fffc40cc40f58911d5ef2f5caed056f5360e50c`
MD5	`0caeb385edfae126bb84373bda43627e`
BLAKE2b-256	`c58776f04fecbf0a656f5aa4e91e1f2bc3fdabbf6581769f6d883682053443c4`

Algorithm	Hash digest
SHA256	`0517556d6be954708b7fd0f31a04eff09530ab7bd7c84ee222793528f5c63559`
MD5	`44046b72d497b09d76e85ace1dcaf3e2`
BLAKE2b-256	`e87116a8ce63e4375b651c2fed37aec89d8a46da1ec0e9a94305ce2baa3efe5a`

Algorithm	Hash digest
SHA256	`4ee9459617ffa71cf428f84fd293ce02e9c93f80efaf350e99a9f1afa0d2415b`
MD5	`df0caa9dd952159b05d06e1bc4854651`
BLAKE2b-256	`488abeb34a5ed09eb37381608c7bf8f7f7740962792b3eea5bb6f50d157e236d`

Algorithm	Hash digest
SHA256	`f72c29a3082ecfde86980766a08f9ce6e311c0e64ea233391f687b5bba2d884b`
MD5	`7a63d9876d05eeb0427184e321a1ea58`
BLAKE2b-256	`6c3d50dd0542ad8f6fd4dfc918c9f9385d76d2e31ab0f017c6d7ce07a348bc03`

Algorithm	Hash digest
SHA256	`58e2231af5781c8dd4c9dfd20af174e29e0493494971e85c7d2dfa4fb1d2a4c5`
MD5	`f9ecb819742b07d1cc0ba9102f71ce89`
BLAKE2b-256	`6983fc914325162fe0629269ab528a9e50e1ac23b4520d6b792370b0dc53bb99`

Algorithm	Hash digest
SHA256	`5b332d40ea6e9a66d655627c54240fec04ea0e1350b2025e7be30cb248b4509f`
MD5	`56599c041ba271b11bac2d2cd79c6400`
BLAKE2b-256	`ce48f8daec9e3917ac07a528265e46177b906ea2c188b836bda949218d7dbbf5`

WarpCrypto 2.0.5

WarpCrypto

Features

Requirements

Installation

API

Usage

IGE Mode (MTProto 2.0)

CTR Mode (CDN)

KDF (MTProto 2.0 key derivation)

Testing

Performance

License

Project links

Key dates

1 maintainer

Credits

License expression

Requires

Tags

Classifiers

Download files

Source Distributions

Built Distributions

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

Algorithm	Hash digest
SHA256	`ca5468645b8f5cee511936fe711928179d60e5b9baaa1275f008dfba6ebace08`
MD5	`df867dfea92364b8bbb5339d43c4e16f`
BLAKE2b-256	`f255890ceae8ef2b7390644824f17635f8f5c6ab135f17e3a07dc8733b4fa163`

Algorithm	Hash digest
SHA256	`0f9622d7176959d57dd80d44af27ed57e5d5820745ad46c674391c50884d823e`
MD5	`2afa66cdfb30daaf47c76dafd44e9e50`
BLAKE2b-256	`401665eeb67b1cc5f5068c0318ca5056a5a06827fa9a34fdaeda974d848d17df`

Algorithm	Hash digest
SHA256	`f614d3b1544d5e3f691aea62f0f5f38e5acbc8a0e4ddb87933a3579396531207`
MD5	`b4db75d0b2485e6bfcda744e3bff2fb4`
BLAKE2b-256	`1f8ff558577446494e3a844f9d652098734876c3b49d4df2dfc3838e2008bb08`