Skip to main content
Tonutils is a high-level, object-oriented Python SDK for the TON blockchain. It provides wallets, transfers, smart contracts, and on-chain tools over both native lite servers (ADNL) and popular HTTP API providers.
Looking for versions below 2.0? The legacy documentation is still available.
For a better understanding of TON internal architecture and core principles, review the official TON documentation.

​
Features

  • Providers — HTTP APIs (Toncenter, Tonapi, Chainstack, QuickNode, Tatum) and native ADNL lite clients, plus balancers with automatic failover for both.
  • Wallets — create, import, and deploy all standard wallet versions (V1–V5, Highload, Preprocessed).
  • Transfers — TON, jettons, and NFTs, including batch, gasless, and encrypted transfers.
  • Contracts — deploy, mint, and manage jetton, NFT, and DNS contracts.
  • Tools — block scanner, lite server and DHT status monitors, and a CLI.
TON Connect is no longer part of tonutils. It lives in the separate ton-connect package, documented in the TON Connect section of this site.

​
Installation

​
Explore

Guide

Install the library and initialize HTTP or lite clients.

Usage Examples

Wallets, transfers, jettons, NFTs, and DNS operations.

How To

Focused recipes for common on-chain tasks.

Tools

Block scanner, status monitors, and the CLI.

TON Connect

Connect wallets, send transactions, and verify proofs with the ton-connect package.

Examples

Full runnable scripts: wallets, transfers, jettons, NFTs, and more.

​
Contribution

Contributions are welcome. If you have ideas for improvements or have identified a bug, create an issue or submit a pull request on GitHub.