Metadata-Version: 2.4
Name: tonutils
Version: 2.0.4
Summary: Python SDK for The Open Network — lite servers (ADNL) and HTTP API providers.
Author: nessshon
Maintainer: nessshon
License-Expression: MIT
Project-URL: Homepage, https://github.com/nessshon/tonutils/
Project-URL: Examples, https://github.com/nessshon/tonutils/tree/main/examples/
Keywords: ADNL,AsyncIO,SDK,TON,TON blockchain,The Open Network,blockchain,crypto,lite server,smart contracts
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Framework :: AsyncIO
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Financial and Insurance Industry
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: <3.15,>=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: aiohttp>=3.7.0
Requires-Dist: pydantic<3.0,>=2.0
Requires-Dist: pytoniq-core~=0.1.46
Dynamic: license-file

# 📦 Tonutils

[![TON](https://img.shields.io/badge/TON-grey?logo=TON&logoColor=40AEF0)](https://ton.org)
![Python Versions](https://img.shields.io/badge/Python-3.10%20--%203.14-black?color=FFE873&labelColor=3776AB)
[![PyPI](https://img.shields.io/pypi/v/tonutils.svg?color=FFE873&labelColor=3776AB)](https://pypi.python.org/pypi/tonutils)
[![License](https://img.shields.io/github/license/nessshon/tonutils)](LICENSE)
[![Donate](https://img.shields.io/badge/Donate-TON-blue)](https://tonviewer.com/UQCZq3_Vd21-4y4m7Wc-ej9NFOhh_qvdfAkAYAOHoQ__Ness)

![Image](assets/banner.png)

![Downloads](https://pepy.tech/badge/tonutils)
![Downloads](https://pepy.tech/badge/tonutils/month)
![Downloads](https://pepy.tech/badge/tonutils/week)

### Python SDK for [The Open Network](https://ton.org)

Interact with the TON blockchain ecosystem via lite servers (ADNL) and HTTP API providers.

**Supported providers**

- [toncenter.com](https://toncenter.com/) – Fast and reliable HTTP API for The Open Network
- [tonapi.io](https://tonapi.io/) – REST API to the TON blockchain explorer
- [chainstack](https://chainstack.com/) – Fast and Reliable Blockchain Infrastructure Provider
- [tatum.io](https://tatum.io/) – RPCs and APIs powering Web3. Fast, reliable, affordable
- [quicknode.com](https://www.quicknode.com/) – Low-latency HTTP API access to TON via global infrastructure

> If this project has been useful to you, consider supporting its development.  
> **TON**: `UQCZq3_Vd21-4y4m7Wc-ej9NFOhh_qvdfAkAYAOHoQ__Ness`

## Installation

```bash
pip install tonutils
```

## Examples

Check out the **[examples](examples)** directory for practical usage across all features.

<details>
<summary>Show all examples</summary>

- [Client initialization](examples/client/)
- [Create Wallet](examples/wallet/create_wallet.py)
- [Import Wallet](examples/wallet/import_wallet.py)
- [Deploy Wallet](examples/wallet/deploy_wallet.py)
- [Wallet Info](examples/wallet/wallet_info.py)
- [TON Transfer](examples/wallet/ton_transfer.py)
- [Jetton Transfer](examples/wallet/jetton_transfer.py)
- [NFT Transfer](examples/wallet/nft_transfer.py)
- [Batch Transfer](examples/wallet/batch_transfer.py)
- [Gasless Transfer](examples/wallet/gasless_transfer.py)
- [Encrypt Message](examples/wallet/encrypt_message.py)
- [Decrypt Message](examples/wallet/decrypt_message.py)
- [Vanity Contract](examples/vanity/deploy_contract.py)
- [Block Scanner](examples/block_scanner.py)

**Jetton**

- [Stablecoin](examples/jetton/stablecoin/)
- [Standard](examples/jetton/standard/)

**NFT**

- [Editable](examples/nft/editable/)
- [Soulbound](examples/nft/soulbound/)
- [Standard](examples/nft/standard/)

**DNS**

- [Resolve](examples/dns/dns_resolve.py)
- [Get Records](examples/dns/get_records.py)
- [Set Records](examples/dns/set_records.py)

**TON Connect**

- [Connect Wallet](examples/tonconnect/connect_wallet/ton_addr.py)
- [Connect Wallet with TON Proof](examples/tonconnect/connect_wallet/ton_proof.py)
- [Send Transaction](examples/tonconnect/send_request/transaction.py)
- [Sign Data](examples/tonconnect/send_request/sign_data.py)
- [Check TON Proof](examples/tonconnect/check_ton_proof.py)
- [Check Sign Data](examples/tonconnect/check_sign_data.py)
- [Import Connection](examples/tonconnect/import_connection.py)

</details>

## CLI

Show version:

```bash
tonutils -v
```

Monitor lite-server availability:

```bash
tonutils status [-n mainnet|testnet] [-c PATH_OR_URL] [-r RPS]
```

## Support

Supported by [TON Society](https://github.com/ton-society/grants-and-bounties), Grants and Bounties program.  
With special thanks to [Igroman787](https://github.com/Igroman787) for the support.

## License

This repository is distributed under the [MIT License](LICENSE).
