Tonutils is a high-level, object-oriented Python library designed to simplify interactions with the TON blockchain. It seamlessly integrates several prominent services for working with TON:
-
RPC API
- tonapi.io – REST API to the TON blockchain explorer.
- toncenter.com – fast and reliable HTTP API for The Open Network.
- quicknode.com – low-latency HTTP API access to TON via global infrastructure.
- tatum.io – RPCs and APIs powering Web3. Fast, reliable, affordable.
-
Native ADNL
- pytoniq – library for direct interaction with Lite servers.
By combining these services, Tonutils provides a powerful and flexible toolset for developers, making it easier to build on top of the TON ecosystem.
pip install tonutilsTo use pytoniq with Native ADNL connection, install it with the optional dependencies, including
the pytoniq library:
pip install 'tonutils[pytoniq]'Your donation supports the future of this project. Every contribution helps stimulate innovation and sustain development!
TON - UQCDrgGaI6gWK-qlyw69xWZosurGxrpRgIgSkVsgahUtxZR0
USDT (TRC-20) - TGKmm9H3FApFw8xcgRcZDHSku68vozAjo9
-
RPC API
tonapi To use you need to obtain an API key on the tonconsole.com.
Client Initialization
from tonutils.client import TonapiClient API_KEY = "your api key" IS_TESTNET = True client = TonapiClient(api_key=API_KEY, is_testnet=IS_TESTNET)
toncenter To use you need to obtain an API key from the bot.
Client Initialization
from tonutils.client import ToncenterV2Client from tonutils.client import ToncenterV3Client API_KEY = "your api key" # optional IS_TESTNET = True # Using Toncenter V3 client client_v3 = ToncenterV3Client(api_key=API_KEY, is_testnet=IS_TESTNET) # If you want to use Toncenter V2 instead: # client_v2 = ToncenterV2Client(api_key=API_KEY, is_testnet=IS_TESTNET)
quicknode To use, obtain an API URL from quicknode.com.
Note: QuickNode does not support testnet.
Client Initialization:
from tonutils.client import QuicknodeClient HTTP_PROVIDER_URL = "https://blissful-withered-surf.ton-mainnet.quiknode.pro/d6e8...1964" client = QuicknodeClient(HTTP_PROVIDER_URL)
tatum To use it, you need to obtain an API key on tatum.io.
Client Initialization
from tonutils.client import TatumClient API_KEY = "your api key" IS_TESTNET = True client = TatumClient(api_key=API_KEY, is_testnet=IS_TESTNET)
-
Native ADNL
pytoniq For better performance, pass your own config, available from the bot.
Client Initialization:
from tonutils.client import LiteserverClient config = {} # your own config IS_TESTNET = True client = LiteserverClient(config=config, is_testnet=IS_TESTNET)
-
TON:
Obtain free testnet TON by interacting with the official bot:
Open Bot -
NOT Jettons (9 decimals):
Claim testnet NOT by scanning the QR code at the following link:
Scan to Claim Testnet NOT -
USD₮ Jettons (6 decimals):
Claim testnet USD₮ by scanning the QR code at the following link:
Scan to Claim Testnet USD₮
We welcome your contributions! If you have ideas for improvement or have identified a bug, please create an issue or submit a pull request.
Supported by TON Society, Grants and Bounties program.
With special thanks to Igroman787 for the support.
This repository is distributed under the MIT License. Feel free to use, modify, and distribute the code in accordance with the terms of the license.