Установка и Инициализация

Этот раздел объясняет, как установить библиотеку tonutils и выбрать подходящий клиент в зависимости от ваших потребностей.

Установка

Чтобы установить базовый пакет tonutils:

pip install tonutils

Если вы хотите использовать подключение через Нативный ADNL, установите с дополнительными зависимостями:

pip install 'tonutils[pytoniq]'

Доступные клиенты

RPC API

Общие параметры

Все API клиенты библиотеки tonutils.client поддерживают параметры управления частотой запросов:

rps — лимит запросов в секунду.
Разные API имеют свои ограничения по частоте. Этот параметр позволяет не превышать лимиты и избежать ошибок rate limit.
max_retries — число повторных попыток в случае превышения лимита (HTTP 429).
Если сервер временно отклоняет запросы из-за слишком высокой нагрузки, клиент подождёт и попробует снова.

toncenter

toncenter.com — быстрый и надёжный HTTP API для The Open Network.

Note

API-ключ не обязателен, но для лучшей производительности рекомендуется получить его через @tonapibot.

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, rps=1)

# Using Toncenter V2 client (if needed)
# client_v2 = ToncenterV2Client(api_key=API_KEY, is_testnet=IS_TESTNET, rps=1)

tonapi

tonapi.io — REST API для работы с обозревателем блокчейна TON.

Note

Требуется API-ключ с сайта tonconsole.com.

from tonutils.client import TonapiClient

API_KEY = "your api key"
IS_TESTNET = True
client = TonapiClient(api_key=API_KEY, is_testnet=IS_TESTNET, rps=1)

quicknode

quicknode.com — HTTP API с низкой задержкой к TON через глобальную инфраструктуру.

Note

Требуется URL API с сайта quicknode.com.

Quicknode не поддерживает тестовую сеть!

from tonutils.client import QuicknodeClient

HTTP_PROVIDER_URL = "https://blissful-withered-surf.ton-mainnet.quiknode.pro/d6e8...1964"
client = QuicknodeClient(HTTP_PROVIDER_URL, rps=1)

tatum

tatum.io — RPC и API для Web3.

Note

Требуется API-ключ с сайта tatum.io.

from tonutils.client import TatumClient

API_KEY = "your api key"
IS_TESTNET = True
client = TatumClient(api_key=API_KEY, is_testnet=IS_TESTNET, rps=1)

Нативный ADNL

pytoniq

pytoniq — библиотека для прямого взаимодействия с лайт-серверами.

Note

Для лучшей производительности рекомендуется указать собственную конфигурацию, которую можно получить через бота liteserver.

from tonutils.client import LiteserverClient

IS_TESTNET = True
client = LiteserverClient(is_testnet=IS_TESTNET)

# Using custom configuration
# config = {}  # Your LiteServer config here 
# client = LiteserverClient(config=config)