Python Libraries and Tools for Building on TON

The Open Network (TON) is rapidly evolving into one of the most dynamic blockchain ecosystems, attracting developers from around the world. With Python ranking as the third most popular programming language globally—used by over 49% of developers as of 2023—it’s no surprise that the TON community is actively building robust Python tools to empower developers.

While Tact is emerging as the native smart contract language for TON, Python continues to play a vital role in backend development, data indexing, wallet integration, and tooling. Thanks to a growing number of open-source libraries, Python developers can now seamlessly interact with TON’s infrastructure, from querying blockchain data to deploying decentralized applications.

This guide explores the most useful and actively maintained Python libraries for TON, covering everything from low-level networking protocols to high-level development frameworks.

Core Python Libraries for TON Integration

Python’s versatility makes it ideal for interacting with blockchain networks. On TON, several key libraries enable developers to connect, query, and build on the network using familiar syntax and powerful abstractions.

ADNL Transport Libraries

At the heart of TON’s architecture lies the Abstract Datagram Network Layer (ADNL)—a lightweight, UDP-based protocol designed for fast peer-to-peer communication. ADNL enables direct interaction with TON’s LiteServers, forming the foundation for many client implementations.

• Pytoniq by Yungwine
  Pytoniq is widely regarded as the flagship Python SDK for TON. It extends pytoniq-core to support native LiteClient connections over UDP, DHT, and future RLDP protocols. Built with performance in mind, it allows direct ADNL communication without relying on HTTP intermediaries. This makes it ideal for high-frequency data retrieval and real-time monitoring applications.
• Mytonlib by Igroman787
  A native Python implementation that interfaces directly with TON without requiring libtonlibjson.so. While slightly slower due to its pure-Python nature, it offers greater transparency and ease of debugging. Originally based on TON Deep’s work by xssnick, this library remains a solid choice for developers who prefer minimal external dependencies.

👉 Discover how to integrate blockchain data directly into your Python apps

TonLib Wrappers

For developers who prefer working with JSON-based APIs, TonLib wrappers offer an accessible way to interact with TON through tonlibjson, a C++ library that implements LiteClient functionality.

• PyTONLib
  Developed by TonCenter, this standalone Python library wraps libtonlibjson and provides asynchronous access to TON nodes. While it supports only one LiteServer connection at a time and lacks request caching, its compatibility with existing TonCenter services makes it a practical option for prototyping and lightweight applications.

Flexible Libraries: HTTP API or TonLib

Some libraries are designed to work flexibly—either via HTTP API or TonLib, giving developers control over their connection strategy.

• TonTools by Yungwine
  A feature-rich, object-oriented library that simplifies common tasks such as:

  • Scanning custom smart contracts
  • Executing get methods
  • Creating and managing wallets
  • Tracking NFT collections, Jettons, and transactions
    With an intuitive interface and strong documentation, TonTools is perfect for full-stack Python developers building user-facing dApps.
• TONsdk by tonfactory (sasha1618), Yungwine, Psylopunk
  This low-level SDK contains valuable utilities and deep insights into TON’s internals. However, the codebase is incomplete and no longer under active development. While not recommended for production use, it serves as a useful reference for understanding advanced TON mechanics.
• Tonpy by Disintar
  A two-part solution combining C++ bindings with pre-built Python binaries. The core package offers high-performance data structures and APIs for efficient blockchain interaction. Its hybrid design ensures speed without sacrificing ease of use, making it suitable for data-intensive applications like indexers or analytics platforms.

Secure Wallet Connectivity with TON Connect

TON Connect is the standardized protocol enabling seamless communication between wallets and decentralized applications (dApps). By eliminating the need for password-based authentication, it enhances security and user experience across the ecosystem.

Two notable Python implementations support this protocol:

• PyTon Connect by XaBbl4
  A Python SDK for TON Connect 2.0, mirroring the functionality of the official @tonconnect/sdk. It allows developers to integrate wallet connectivity into web backends or desktop applications using familiar patterns. Full protocol specifications are available in the TON Connect documentation.
• TON Connect for Python by ClickoTON Foundation
  An actively maintained alternative with recent commits and community support. This library demonstrates strong momentum and is well-suited for new projects requiring reliable wallet integration.

👉 Learn how to securely connect wallets in your Python dApp

Development & Infrastructure Tools

Beyond direct blockchain interaction, several tools streamline the development process on TON.

• TON Indexer
  Stores blocks, transactions, and messages in a PostgreSQL database and exposes a clean API for querying historical data. Ideal for analytics dashboards, audit tools, or blockchain explorers.
• MyTonCtrl
  A console utility that wraps essential tools like fift, lite-client, and validator-engine-console. It simplifies node management, wallet operations, and domain registration—especially on Linux systems.
• TON HTTP API
  Acts as a middleware layer between HTTP clients and TON’s binary ADNL protocol. Using tonlibjson, it forwards requests to LiteServers. You can either use the public instance at toncenter.com or host your own for improved privacy and reliability.

Deprecated Libraries (Use with Caution)

While some libraries were once central to Python development on TON, they are now obsolete:

• TVM Value Types
  Replaced by more modern solutions like Pytoniq. Originally provided utilities for handling core TON data types such as Cell, Slice, Builder, and Tuple.
• Pytonlib by Psylopunk
  Fully deprecated. Though once popular for wallet creation, balance checks, and NFT transfers, it no longer receives updates or security patches.

We recommend avoiding these unless you're maintaining legacy systems.

Emerging Framework: Rift – Full-Stack Python on TON

One project stands out for its ambition to bring full-stack development to Python developers: Rift.

Rift is a full-stack development framework that allows you to build, test, and deploy smart contracts on TON using only Python—no need to learn FunC or Fift.

With Rift, developers can write smart contracts in a Python-like syntax, compile them into TON-compatible formats, and interact with deployed contracts—all within a unified environment. It significantly lowers the barrier to entry for new developers while accelerating development cycles.

🔗 Learn more at rift.skyring.io

👉 See how modern frameworks are transforming blockchain development

Frequently Asked Questions (FAQ)

Q: Can I build smart contracts on TON using Python?
A: Yes—through frameworks like Rift, which compiles Python-like code into TON-compatible bytecode. While Tact is the official language, Rift enables Python-first development without requiring knowledge of FunC.

Q: Which Python library should I use for real-time data?
A: Pytoniq is best for real-time, high-performance access due to its native ADNL support over UDP. It bypasses HTTP bottlenecks and connects directly to LiteServers.

Q: Is there a recommended library for beginners?
A: Start with TonTools—it offers an intuitive OOP interface and supports common tasks like wallet management and transaction scanning.

Q: Can I run my own node with these libraries?
A: These libraries typically connect to existing LiteServers. To run a full node, use official TON software; tools like MyTonCtrl help manage node operations.

Q: Are these libraries secure for production use?
A: Libraries like Pytoniq, TonTools, and PyTon Connect are actively maintained and used in production environments. Always verify source code and audit dependencies before deployment.

Q: How do I handle wallet authentication in my app?
A: Use TON Connect via PyTon Connect or the ClickoTON Foundation’s library. These implement secure session management and QR-based wallet linking.

Keywords:

• Python on TON
• TON blockchain Python library
• Pytoniq
• TON Connect Python
• ADNL protocol
• TonTools
• Rift framework
• TON HTTP API

This guide equips Python developers with everything needed to start building on The Open Network—from foundational protocols to cutting-edge frameworks. Whether you're indexing blockchain data or connecting wallets securely, there's a mature toolset ready to support your journey.