JSON-RPC через HTTP

Копировать

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

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

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

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

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

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

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

Отправляйте стандартные JSON-RPC 2.0 запросы к блокчейн-нодам через единый HTTPS-эндпоинт.

Формат запроса

POST https://rpc.vilna.app/{chain}

Где {chain} - CAIP-2 идентификатор сети или алиас (см. поддерживаемые сети).

Примеры

Ethereum (EVM)

curl -X POST https://rpc.vilna.app/ethereum \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_blockNumber",
    "params": [],
    "id": 1
  }'

Все EVM-совместимые сети (Ethereum, BSC, Polygon, Avalanche, Arbitrum, Optimism, Base и др.) поддерживают один и тот же набор Ethereum JSON-RPC методов.

Solana

curl -X POST https://rpc.vilna.app/solana \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "getBalance",
    "params": ["83astBRguLMdt2h5U1Tpdq5tjFoJ6noeGwaY3mDLVcri"],
    "id": 1
  }'

Solana поддерживает свои нативные JSON-RPC API методы.

Bitcoin

curl -X POST https://rpc.vilna.app/bitcoin \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "getblockcount",
    "params": [],
    "id": 1
  }'

Bitcoin поддерживает стандартные Bitcoin Core JSON-RPC методы.

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

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

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

{"error": "описание проблемы"}

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

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

Если запрос достигает ноды, но нода возвращает ошибку, вы получаете нативный формат JSON-RPC ошибки:

{
  "jsonrpc": "2.0",
  "error": {
    "code": -32601,
    "message": "Method not found"
  },
  "id": 1
}

Эти ошибки приходят напрямую от блокчейн-ноды и следуют спецификации ошибок JSON-RPC 2.0.

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