TronGrid Руководство по API: TRON Доступ к узлу для разработчиков

TronGrid — это стандартный способ доступа разработчиков к данным блокчейна TRON без использования полного узла. Он предоставляет конечные точки REST для балансов счетов, истории транзакций, триггеров контрактов и журналов событий, которые используются напрямую через HTTP или через TronWeb.

В этом руководстве описываются настройка, аутентификация, общие конечные точки и лучшие практики производства.

TronGrid против автономного узла

Большинство приложений запускаются на TronGrid; На крупных биржах часто используются частные узлы.

Регистрация и ключ API

1. Посетите https://www.trongrid.io
2. Создать учетную запись → Панель управления → Создать ключ API.
3. Используйте ключ в заголовке: TRON-PRO-API-KEY: <your-key>.

Без ключа агрессивный опрос может привести к регулированию.

Конечные точки

Конфигурация TronWeb:

const tronWeb = new TronWeb({
  fullHost: 'https://api.trongrid.io',
  headers: { 'TRON-PRO-API-KEY': 'your-key' },
});

Общие операции REST

Получить информацию об аккаунте

⟦Т1⟧

Возвращает баланс TRX, ресурсы (энергия/пропускная способность) и баланс токенов TRC-20.

См. запрос TRC-20 API баланса.

Получить транзакцию по идентификатору

⟦Т2⟧

См. API проверки транзакции.

Широковещательная транзакция

⟦Т3⟧

Тело содержит подписанную транзакцию JSON из TronWeb.

Запуск смарт-контракта

⟦Т4⟧

Используется для вызовов контракта на чтение/запись — триггерный смарт-контракт.

Полная ссылка: TRON HTTP API.

Ограничения скорости и надежность

Образцы производства:

• Кэшировать неизменяемые данные (старые блоки, подтвержденные txs)
• Экспоненциальная отсрочка по 429 ответам

– Несколько ключей API для каждого уровня обслуживания, если это разрешено.

• Гибрид веб-перехватчика и опроса для обнаружения платежей

События и журналы

TronGrid поддерживает запросы плагинов событий для событий контракта — полезно для прослушивателей депозитов USDT. TronWeb оболочка: прослушиватели событий.

Безопасность

• Ключи API являются секретами: переменные окружения, а не пакеты внешнего интерфейса.
• Подписание транзакций на стороне сервера только защищенными ключами.
• Проверка адресов перед трансляцией

Рабочий процесс разработки Shasta

1. Конечная точка Shasta + тестовый ключ
2. Кран TRX
3. Развертывание контрактов через TronBox
4. Продвижение в основной сети с новыми адресами.

Советы по развертыванию рабочей среды

Запустите несколько ключей API в разных службах для изоляции квот. Кэшируйте неизменяемые данные (ABI контракта, проверенный источник). Используйте экспоненциальную отсрочку для 429 ответов. Для критически важного обнаружения платежей рассмотрите выделенный полный узел или премиум-уровень TronGrid.

Руководство по выбору конечной точки

Используйте /wallet/* для создания и трансляции транзакций. Используйте /v1/* для индексированной истории и событий. Неправильное их смешивание — например, опрос getaccount каждую секунду для обнаружения платежей вместо API событий — приводит к потере квоты и увеличению задержки. Сопоставьте каждую функцию продукта с правильным семейством конечных точек во время проверки проекта.

Контрольный список устранения неполадок

Если что-то пойдет не так на TRON, отнеситесь к этому как к проблеме структурированной отладки: подтвердите точный txid в цепочке, проверьте адрес целевого контракта и только затем решите, можно ли устранить сбой. В TRON многие «загадочные» проблемы — это просто одна из следующих: неправильная сеть (основная сеть или тестовая сеть), неправильный контракт токена (поддельный USDT / токены с одинаковым названием), недостаточность ресурсов (OUT_OF_ENERGY / пропускная способность) или задержка пользовательского интерфейса/индексатора между кошельком и проводником.

Начните с этих цепочек проверок:

• Всегда копируйте полный txid/хэш из своего кошелька или проводника.
• Подтвердите статус результата отправки на TronScan (SUCCESS, REVERT, OUT_OF_ENERGY или все еще в ожидании).
• Проверьте, соответствует ли адрес получателя/договора тому, что вы намеревались отправить.
• Если это вызов контракта, убедитесь, что селектор функций и параметры соответствуют стандарту токена, который, по вашему мнению, вы используете (TRC-20 vs TRC-10 vs BEP-20 на BSC).

Затем примените путь исправления для вашей категории:

• Подтвердите статус и параметры транзакции.
• Проверка адресов (контракт токена, получатель, маршрутизатор/отправитель).
• Добавляйте или делегируйте ресурсы (энергию/пропускную способность), если сбой связан с ресурсами.

Распространенные ошибки

Эти шаблоны вызывают большинство сбоев на уровне пользователя:- Использование адресов основной сети в тестовой сети (или наоборот).

• Копирование символа токена вместо фактического адреса контракта TRC-20.
• Подписание неправильного адреса одобрения/платежа, поскольку ссылка пользовательского интерфейса является вредоносной или устаревшей.
• Повторная попытка без изменения ошибочного ввода (например, REVERT продолжает возвращаться до тех пор, пока вы не исправите параметр).

Если вы не уверены, не «просто отправьте еще раз». Внесите одно контролируемое изменение, проверьте на TronScan, затем продолжайте.

Часто задаваемые вопросы

Как узнать, действительно ли транзакция подтверждена?

Используйте TronScan и проверьте статус результата передачи. Ярлыки кошелька «ожидающие» могут отставать; Статус цепочки является источником истины. Скопируйте txid и проверьте SUCCESS/REVERT/OUT_OF_ENERGY, а не только текст пользовательского интерфейса.

Почему пользовательский интерфейс отличается от TronScan?

Некоторые кошельки и децентрализованные приложения используют разные индексаторы или уровни кэша. Короткая задержка между трансляцией и индексированием является нормальной; сравните txid и подождите, пока цепочка стабилизируется, прежде чем сделать вывод об ошибке.

Что мне делать после REVERT?

Остановитесь и декодируйте неудачный вызов. Большинство ошибок REVERT вызваны недопустимыми параметрами, неправильным адресом контракта, отсутствием утверждений или несоответствием между стандартом токена и методом. Устраните причину и подпишите заново.

Безопасно ли подписывать неограниченное разрешение?

Неограниченное одобрение безопасно только для проверенных вами адресов доверенных отправителей (проверенный источник, правильный маршрутизатор и ожидаемый контракт токена). Для тестирования отдавайте предпочтение ограниченному утверждению и отзыву после завершения.

Какие ресурсы требуются TRON для вызовов контракта?

Выполнение смарт-контракта в основном потребляет энергию, а байты транзакций потребляют пропускную способность. Если вы получили OUT_OF_ENERGY, добавьте/заморозьте/делегируйте Энергию. Если полоса пропускания исчерпана, сосредоточьтесь на сохранении достаточного количества TRX для байтов и распределения ресурсов.

Как я могу уменьшить количество обращений в службу поддержки?

Покажите пользователям четкое сообщение «что произошло» на основе статуса цепочки и дайте прямую ссылку на соответствующее руководство (ожидание, сбой, отсутствие энергии или проверка). Сохраните txid, чтобы можно было быстро выполнить согласование.

Похожие руководства {#связанные}

• TRON Справочник по HTTP API
• API запроса баланса TRC-20
• API проверки транзакции
• Прослушиватели событий TronWeb

Часто задаваемые вопросы

Что такое TronGrid?

TronGrid — это служба API, размещенная на сервере TRON, обеспечивающая HTTP-доступ к полным данным узла — учетным записям, транзакциям, блокам и смарт-контрактам без запуска собственного узла.

Нужен ли мне ключ API для TronGrid?

Уровень бесплатного пользования работает с ограничениями. Производственные приложения должны зарегистрироваться для получения TRON-PRO-API-KEY, чтобы увеличить ограничения скорости и надежности.

Является ли TronGrid тем же самым, что и TronScan API?

TronScan предлагает API-интерфейсы проводника для удобочитаемых данных. TronGrid — это узловая инфраструктура из экосистемы TRON Foundation. Многие приложения используют оба.

Может ли TronGrid подписывать транзакции?

Нет. Вы подписываетесь локально с помощью TronWeb + закрытый ключ или TronLink; TronGrid транслирует подписанные txs.

Что произойдет, если TronGrid не работает?

Реализуйте повторные попытки, мониторинг страниц состояния и рассмотрите резервный полный узел для критически важных систем.