gRPC

Копировать

• Копировать для LLM

  Копировать страницу как Markdown для LLM
• Просмотреть как Markdown

  Открыть эту страницу как Markdown
• Открыть в ChatGPT

  Получить анализ от ChatGPT
• Открыть в Claude

  Получить инсайты от Claude
• Подключиться к Cursor

  Установить сервер MCP в Cursor
• Подключиться к VS Code

  Установить сервер MCP в VS Code

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

Подключение

grpc.vilna.io:443

Соединение устанавливается через TLS. Аутентификация и идентификация сети передаются через gRPC metadata:

Tron

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

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

grpcurl \
  -H "x-api-key: your-api-key" \
  -H "x-chain-id: tron:mainnet" \
  -d '{}' \
  grpc.vilna.io:443 \
  protocol.Wallet/GetNowBlock2

Быстрая проверка подключения

grpcurl \
  -H "x-api-key: your-api-key" \
  -H "x-chain-id: tron:mainnet" \
  grpc.vilna.io:443 \
  protocol.Wallet/TotalTransaction

Получить конкретный блок по номеру

grpcurl \
  -H "x-api-key: your-api-key" \
  -H "x-chain-id: tron:mainnet" \
  -d '{"num":70000000}' \
  grpc.vilna.io:443 \
  protocol.Wallet/GetBlockByNum2

Если grpcurl не установлен, тот же вызов можно выполнить через Docker:

docker run --rm fullstorydev/grpcurl \
  -H "x-api-key: your-api-key" \
  -H "x-chain-id: tron:mainnet" \
  -d '{}' \
  grpc.vilna.io:443 \
  protocol.Wallet/GetNowBlock2

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

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

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

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

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

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

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

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

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

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