tonutils 0.3.6

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 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.

Installation

pip install tonutils

To use pytoniq with Native ADNL connection, install it with the optional dependencies, including the pytoniq library:

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

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

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.