tonpy: powerful Python TON toolkit

August 16, 2025 · View on GitHub

tonpy: powerful Python TON toolkit

What is it?

tonpy is a Python package that provides data structures and API to interact with TON blockchain. Tonpy is separate for two packages: C++ bindings and main package that takes pre-built binaries compiled by workflow and creates complete python package with some python code on top of C++ bindings.

Installation

One command: pip install tonpy

Documentation

Documentation can be found on tonpy.dton.io

Supported systems / architectures / Python

System	Architecture	Python versions	CI status
🐧 Linux	`x86_64`	3.10 – 3.13	✅
🐧 Linux	`aarch64`	3.10 – 3.13	✅
🍎 macOS	`x86_64` (Intel)	3.10 – 3.13	✅
🍎 macOS	`aarch64` (Apple Silicon)	3.10 – 3.13	✅
🪟 Windows	`x86_64`	3.10 – 3.13	✅
🪟 Windows	`aarch64`	—	⛔

Speed compare

compare/pytoniq.py

Cell load tests

module	100.000 Cells, 1 ref, 1024 bits	vs tonpy
tonpy	0.02	1
pytoniq	1.39	69.5

compare/tvm_run.py

TVM Run

Be careful, enable_stack_dump=True increase time of execution

mode	Secs	TVM Instances Count
sync	3.53	10
multiprocessing	1.10	10
async	0.59	10

sync	36.36	100
multiprocessing	5.36	100
async	5.15	100

Donation

If you want to support our work, send any coins to:

dton.ton