tonutils 0.3.5

Tonutils is a high-level, object-oriented Python library designed to facilitate seamless interactions with the TON blockchain.

📦 Tonutils

Tonutils is a high-level object-oriented library for Python designed to facilitate interactions with the TON blockchain. It seamlessly integrates three prominent services for working with TON:

• tonapi.io - REST api to TON blockchain explorer.
• toncenter.com - Fast and reliable HTTP API for The Open Network.
• pytoniq - Library for direct interaction with Lite servers.
• quicknode.com - Low-latency HTTP API access to TON via global infrastructure.
• tatum.io – RPCs and APIs Powering Web3. Fast, Reliable, Affordable.

By combining these services, Tonutils provides a powerful and flexible toolset for developers, making it easier to work with the TON ecosystem.

Installation

pip install tonutils

To use the LiteserverClient, which requires the pytoniq library, install it with the optional dependencies:

pip install 'tonutils[pytoniq]'

Donations

Your donation supports the future of this project. Every contribution helps stimulate innovation and sustain development!

TON - UQCDrgGaI6gWK-qlyw69xWZosurGxrpRgIgSkVsgahUtxZR0

USDT (TRC-20) - TGKmm9H3FApFw8xcgRcZDHSku68vozAjo9

Usage

Providers

• TonapiClient 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)

• ToncenterClient 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)

• LiteserverClient 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)

• QuicknodeClient 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)

• TatumClient 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)

Guide

Getting Testnet Assets

• 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₮

Ton Connect Integration

• Wallet Connection
• Sending Transaction
• Telegram Bot Integration

Wallet Operations

• Create Wallet

• Deploy Wallet

• Encrypt Comment

• Get Wallet Balance

• Gasless Transaction (Wallet v5 only)

• Standard Wallet

  • Transfer TON
  • Transfer NFT
  • Transfer Jetton

• Highload Wallet

  • Transfer TON
  • Transfer NFT
  • Transfer Jetton

• Preprocessed Wallet

  • Transfer TON
  • Transfer NFT
  • Transfer Jetton

• DEX DeDust.io

  • Swap TON to Jetton
  • Swap Jetton to TON
  • Swap Jetton to Jetton
  • Batch Swap TON to Jetton
  • Batch Swap Jetton to TON
  • Batch Swap Jetton to Jetton

• DEX STON.fi

  • Swap TON to Jetton
  • Swap Jetton to TON
  • Swap Jetton to Jetton
  • Batch Swap TON to Jetton
  • Batch Swap Jetton to TON
  • Batch Swap Jetton to Jetton

Jetton Operations

• Transfer Jetton

• Get Jetton Wallet Balance

• Mintless Jetton (e.g. Hamster)

  • Claim Jetton
  • Transfer Jetton

• Standard Jetton

  • Deploy Jetton Master Offchain
  • Deploy Jetton Master Onchain
  • Mint Jetton
  • Burn Jetton
  • Change Admin
  • Change Content

• Stablecoin Jetton (by Notcoin)

  • Deploy Jetton Master
  • Upgrade Contract
  • Mint Jetton
  • Burn Jetton
  • Change Admin
  • Drop Admin
  • Change Content

• DEX DeDust.io

  • Swap TON to Jetton
  • Swap Jetton to TON
  • Swap Jetton to Jetton

• DEX STON.fi (v1)

  • Swap TON to Jetton
  • Swap Jetton to TON
  • Swap Jetton to Jetton

• DEX STON.fi (v2)

  • Swap TON to Jetton
  • Swap Jetton to TON
  • Swap Jetton to Jetton

NFT Operations

• Deploy Onchain Collection

• Mint Onchain NFT

• Transfer NFT

• Return Collection Balance

• Editable NFTs

  • Deploy Collection
  • Mint NFT
  • Batch Mint
  • Edit NFT Content
  • Change NFT Editorship
  • Edit Collection Content
  • Change Collection Owner

• Soulbound NFTs

  • Deploy Collection
  • Mint NFT
  • Batch Mint
  • Revoke NFT
  • Destroy NFT

• Standard NFTs

  • Deploy Collection
  • Mint NFT
  • Batch Mint

• Marketplace Getgems.io

  • Put NFT On Sale
  • Cancel NFT Sale
  • Change NFT Price

DNS Operations

• Set Site Record

• Set Wallet Record

• Set Storage Record

• Set Next Resolver Record

• Subdomain Collection

  • Deploy Collection
  • Mint Subdomain

• Simple Subdomain Manager

  • Deploy Manager
  • Set Site Record
  • Set Wallet Record
  • Set Storage Record
  • Set Next Resolver Record

Vanity Operations

• Deploy Contract

Contribution

We welcome your contributions! If you have ideas for improvement or have identified a bug, please create an issue or submit a pull request.

Support

Supported by TON Society, Grants and Bounties program.
With special thanks to Igroman787 for the support.

License

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.