Перейти к основному содержанию

​
Что такое Node API

Node API даёт вашему бэкенду доступ к нашим полным нодам TRON. Это API самой ноды java-tron: те же HTTP-методы под /wallet/* и /walletsolidity/* и те же сервисы gRPC — за ключом, с квотой и лимитами в секунду, которые задаёт ваш тариф. Транзакции стройте и отправляйте через ноду, а подписывайте у себя. Приватный ключ не покидает ваш сервер.

​
Адреса

/walletsolidity/* отвечает только по солидифицированным (подтверждённым) блокам, как и java-tron. Доступен каждый метод, который нода обслуживает на этих двух путях. HTTP принимает GET и POST: при GET нода читает строку запроса, при POST — JSON-тело, но никогда не то и другое сразу. Имена методов чувствительны к регистру, как в java-tron: /wallet/getaccount, но /wallet/getReward. Ответы размером от 1 KB сжимаются gzip, если в запросе есть Accept-Encoding: gzip. Большинство HTTP-библиотек отправляют его по умолчанию; в curl добавьте --compressed.

​
Как получить ключ

1

Войдите

Зарегистрируйтесь или войдите на tronrental.com.
2

Выберите тариф

Откройте Личный кабинет → Node API. Запустите бесплатный 7-дневный триал (он открывается после депозитов на $5) или купите тариф — оплата с баланса аккаунта. См. Тарифы и оплата.
3

Создайте эндпоинт

Добавьте эндпоинт: название и, по желанию, белый список IP. Каждый эндпоинт — отдельный ключ. Ключ показывается один раз — скопируйте его и сохраните в надёжном месте. См. Эндпоинты и ключи.
4

Сделайте первый запрос

Передайте ключ в заголовке TRON-PRO-API-KEY.
В ответе — собственный JSON ноды. Заголовок ответа X-Node-API-WU показывает, сколько единиц квоты стоил вызов, — в этом случае 1. См. Единицы квоты.

​
Что входит

  • Все методы ноды под /wallet/* и /walletsolidity/*, а также унарные методы сервисов gRPC protocol.Wallet и protocol.WalletSolidity.
  • Ключ в заголовке, в пути URL или в метаданных gRPC.
  • До 10 эндпоинтов в зависимости от тарифа, у каждого свой ключ, белый список IP и счётчик.
  • Свежие блоки по фиксированной цене: блок в пределах 20 от головы стоит 3 WU, а его квитанции — 2 WU, независимо от размера.
  • Мягкий предел на тарифах Start, Growth и Pro: когда квота израсходована, запросы продолжают работать, а расход сверх неё оплачивается как перерасход.
  • CORS, чтобы браузерные приложения могли обращаться к ноде напрямую.

​
Что не входит

Это не часть API ноды, поэтому в Node API этого нет:
  • История адреса и индексированные данные — переводы адреса, переводы TRC-20 по адресу, запросы событий контрактов (пути вроде /v1/... и /event/...). Запросы к ним получают 404 not_found. Чтобы следить за переводами, читайте блоки и их квитанции — см. пример «Слежение за USDT» в разделе Примеры кода.
  • JSON-RPC (/jsonrpc, методы eth_*) не подключён.
  • Методы, принимающие приватный ключ, например gettransactionsign или easytransferbyprivate. Нода их не обслуживает: они получают 404 method_not_found и ничего не стоят. Подписывайте у себя.
  • Другие сервисы gRPC и gRPC server reflection. См. gRPC.
Чтобы оценить, сколько энергии израсходует вызов контракта, вызовите triggerconstantcontract с теми же параметрами и возьмите energy_used из ответа.

​
Заголовки ответа

По gRPC те же значения приходят в завершающих метаданных: x-node-api-wu, x-node-api-mode, retry-after, а при отказе — x-node-api-reason.

​
Следующие шаги

Эндпоинты и ключи

Как передавать ключ, белые списки IP, браузерные приложения.

Примеры кода

Подключение, перевод USDT и слежение за USDT с TronWeb, tronpy, curl и grpcurl.

Тарифы и оплата

Квоты, лимиты, перерасход, триал и продление.

Лимиты и ошибки

Все коды отказов, статусы gRPC и режим деградации.