Skip to content
Last updated

Blockchain RPC

Vilna RPC provides access to blockchain nodes across multiple networks through a single endpoint. Send standard JSON-RPC requests over HTTP or gRPC calls - using one API key for all supported chains. No node infrastructure to manage, no per-chain configuration.

  • HTTP Base URL: https://rpc.vilna.io
  • gRPC endpoint: grpc.vilna.io:443

Authentication

Every request must include an RPC key (vilna_rpc_ prefix) in the appropriate header. Create RPC keys in your workspace settings at app.vilna.io.

ProtocolHeaderValue
HTTPX-Api-KeyYour API key
gRPCx-api-key (metadata)Your API key

Supported protocols

Vilna RPC supports two protocols depending on the blockchain:

  • JSON-RPC over HTTP - for EVM chains, Solana, and Bitcoin. Standard JSON-RPC 2.0 format over HTTPS.
  • gRPC - for Tron. Native gRPC protocol with metadata-based chain routing.

Supported networks

NetworkCAIP-2 IDAliasProtocol
Ethereum Mainneteip155:1ethereumJSON-RPC
BNB Smart Chaineip155:56bscJSON-RPC
BNB Smart Chain Testneteip155:97bsc-testnetJSON-RPC
Ethereum Hoodieip155:560048hoodiJSON-RPC
Ethereum Sepoliaeip155:11155111sepoliaJSON-RPC
Solana Mainnetsolana:mainnetsolanaJSON-RPC
Solana Testnetsolana:testnetsolana-testnetJSON-RPC
Bitcoin Mainnetbip122:000000000019d6689c085ae165831e93bitcoinJSON-RPC
Bitcoin Testnet4bip122:00000000da84f2bafbbc53dee25a72aebitcoin-testnet4JSON-RPC
Tron Mainnettron:mainnettrongRPC

The list of supported networks is expanding. Testnet networks are available for development and testing.

Chain identification

You can identify a chain by either its CAIP-2 ID or its alias - both are accepted in URLs (HTTP) and metadata (gRPC). See CAIP Standards for details.

Health check

Check service availability without authentication:

curl https://rpc.vilna.io/health
{"status": "ok"}

Further reading