TON · HTTP API · Jetton

TON API — нода TON
и Jetton по HTTP

Нода TON отвечает на именованные HTTP-методы в духе ton-http-api и TonCenter — getMasterchainInfo, getAddressInformation, runGetMethod и другие, а не через единую точку JSON-RPC. Прокси полностью прозрачен к пути — часть адреса после /proxy/ton передаётся ноде как есть, тело запроса не меняется.

Как подключиться

HTTP API

протокол ноды TON

Все методы

whitelist методов отсутствует

Старт сегодня

доступ открывается в день обращения

TON API — подключение

# имя ноды — ton — берётся из личного кабинета, здесь оно для примера
# getMasterchainInfo — состояние мастерчейна TON
curl https://nodes-api.cryptosafe.pro/proxy/ton/getMasterchainInfo \
  -H "Authorization: $CSN_TOKEN"

# getAddressInformation — баланс и состояние адреса
curl "https://nodes-api.cryptosafe.pro/proxy/ton/getAddressInformation?address=EQDedjwKuGTkpCBJgkLNp3tGc9NxzSUxgzHb_nqKDu35jI3t" \
  -H "Authorization: $CSN_TOKEN"

// sendBoc — отправка подписанной транзакции (BOC)
const res = await fetch(
  'https://nodes-api.cryptosafe.pro/proxy/ton/sendBoc',
  {
    method: 'POST',
    headers: {
      'Authorization': process.env.CSN_TOKEN,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ boc: '<base64 BOC>' })
  }
)
// путь ноды проксируется как есть — ответ тоже
const data = await res.json()

Путь ноды — после /proxy/ton, как есть

Возможности

Что открывает TON API

Нода TON экспонирует HTTP-методы в духе ton-http-api — открытого стандарта, на котором построены публичные API вроде TonCenter. Наш прокси передаёт путь и тело запроса ноде без изменений.

Мастерчейн и аккаунты

getMasterchainInfo возвращает текущее состояние мастерчейна. getAddressInformation — баланс и состояние по адресу, в raw- или user-friendly формате. Прокси прозрачен к любому методу ноды.

Jetton — аналог токенов

getTokenData возвращает данные Jetton-мастер-контракта, getWalletAddress — адрес Jetton-кошелька конкретного владельца. Тело запроса прокси не трогает и передаёт ноде как есть.

Get-методы и транзакции

runGetMethod вызывает get-метод смарт-контракта и возвращает результат вычисления с ноды. sendBoc принимает подписанную транзакцию в формате BOC и передаёт её сети без изменений.

Ключ с IP-ограничением

Ключ можно привязать к IP-адресам и подсетям CIDR ваших серверов. Запрос с незарегистрированного адреса получит ошибку 8003. Поддерживаются IPv4 и IPv6; до 50 записей на ключ.

Инфраструктура на нас

Синхронизация ноды TON, обновления клиента и мониторинг — наша ответственность. Адрес вашего эндпоинта не меняется при любых обновлениях с нашей стороны.

Статистика по запросам

В личном кабинете видно количество запросов к ноде TON, долю успешных и время ответа. Метрики собираются с первого дня без дополнительной настройки.

Подключение

Четыре шага до первых запросов к TON

От первого сообщения до рабочего TON API — обычно в тот же день.

Напишите нам

Напишите нам в чат поддержки на сайте: скажите, что нужен доступ к TON API. Мы откроем кабинет в день обращения.

Выпустите ключ

В личном кабинете создайте ключ. При необходимости добавьте IP-адреса серверов, с которых будут идти запросы к ноде TON.

Укажите базовый адрес

Базовый адрес для всех запросов — https://nodes-api.cryptosafe.pro/proxy/ton. Метод добавляется после него: .../ton/getMasterchainInfo. Ключ передаётся в заголовке Authorization.

Отправляйте запросы

Все методы TON API работают как обычно — прокси прозрачен. В кабинете сразу начнёт накапливаться статистика по вашим вызовам.

Вопросы

Частые вопросы о TON API

Как устроен TON API?

Нода TON отвечает по HTTP на именованные методы в духе ton-http-api и TonCenter — getMasterchainInfo, getAddressInformation и другие, а не по единой точке JSON-RPC. Прокси прозрачен к пути: часть адреса после /proxy/ton передаётся ноде как есть. Полный адрес выглядит так: https://nodes-api.cryptosafe.pro/proxy/ton/getMasterchainInfo.

Какие форматы адресов принимает TON API?

TON поддерживает два представления одного адреса: raw-формат workchain:hex и удобочитаемый base64url на 48 символов с префиксом EQ (bounceable) или UQ (non-bounceable). Прокси не меняет и не проверяет формат — какой адрес передан в запросе, такой и уходит ноде.

Как работать с Jetton — аналогом токенов в TON?

Данные Jetton-мастер-контракта возвращает getTokenData, а адрес Jetton-кошелька конкретного владельца — getWalletAddress. Дальше баланс и переводы читаются вызовом getWalletData или runGetMethod у самого Jetton-кошелька — прокси передаёт эти запросы ноде без изменений.

Как вызвать get-метод смарт-контракта TON?

Метод runGetMethod принимает адрес контракта, имя метода и стек параметров и возвращает результат вычисления прямо с ноды. Тело запроса прокси не парсит и передаёт ноде как есть.

Как правильно передавать ключ аутентификации?

Ключ передаётся в заголовке Authorization без префикса Bearer — именно как значение, без дополнительных слов. Пример: Authorization: ваш-ключ. Ключи выпускаются в личном кабинете; на компанию доступно до трёх ключей.

Можно ли ограничить доступ по IP?

Да. Каждый ключ можно привязать к списку IP-адресов и подсетей CIDR — до 50 записей. Поддерживаются IPv4 и IPv6. Пустой список означает доступ с любого адреса. Вспомогательный эндпоинт https://nodes-api.cryptosafe.pro/info/getip вернёт ваш текущий IP текстом.

Нужен TON API для вашего сервиса?

Напишите в чат поддержки — откроем доступ к ноде TON и Jetton API в день обращения. Ключ выпускаете сами в кабинете, инфраструктуру держим мы.

Вход в кабинет

TON API — нода TONи Jetton по HTTP