Перейти к содержимому
Последнее обновление

gRPC

Доступ к gRPC-блокчейн-нодам через единую точку входа с маршрутизацией через metadata.

Подключение

rpc.vilna.app:9090

Аутентификация и идентификация сети передаются через gRPC metadata:

Ключ metadataЗначение
x-api-keyВаш API-ключ
x-chain-idCAIP-2 ID или алиас сети (например, tron или tron:mainnet)

Tron

Любой gRPC-метод сервисов Tron может быть вызван через Vilna RPC. Запрос прозрачно маршрутизируется к ноде Tron.

Получить текущий блок

grpcurl \
  -H "x-api-key: your-api-key" \
  -H "x-chain-id: tron" \
  rpc.vilna.app:9090 \
  protocol.Wallet/GetNowBlock

Получить баланс аккаунта

grpcurl \
  -H "x-api-key: your-api-key" \
  -H "x-chain-id: tron" \
  -d '{"address": "QVZq..."}' \
  rpc.vilna.app:9090 \
  protocol.Wallet/GetAccount

Доступные сервисы

Vilna проксирует все стандартные gRPC-сервисы Tron:

СервисОписание
protocol.WalletОперации с аккаунтами, транзакциями и блоками
protocol.WalletSolidityRead-only запросы к подтверждённым блокам
protocol.DatabaseНизкоуровневый доступ к данным сети

Полный список доступных методов в документации протокола Tron.

Обработка ошибок

Системные ошибки

Возвращаются Vilna RPC, когда запрос не может достичь блокчейн-ноды:

СитуацияgRPC-статус
Отсутствует API-ключUNAUTHENTICATED
Невалидный API-ключUNAUTHENTICATED
Сеть не найденаNOT_FOUND
Несовпадение протоколаINVALID_ARGUMENT
Сеть недоступнаUNAVAILABLE

Общие ошибки API и их устранение описаны в руководстве по ошибкам.

Ошибки блокчейн-ноды

Если запрос достигает ноды, но нода возвращает ошибку, вы получаете нативную gRPC-ошибку. Эти ошибки приходят напрямую от блокчейн-ноды.

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

JSON-RPC

HTTP-запросы к нодам Ethereum, Solana и Bitcoin

Обзор RPC

Поддерживаемые сети, аутентификация и проверка доступности

Ошибки

Обработка ошибок и устранение неполадок

Предыдущая страница