# 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](https://app.vilna.io).

| Protocol | Header | Value |
|  --- | --- | --- |
| HTTP | `X-Api-Key` | Your API key |
| gRPC | `x-api-key` (metadata) | Your API key |


## Supported protocols

Vilna RPC supports two protocols depending on the blockchain:

- **[JSON-RPC over HTTP](/apis/rpc/json-rpc)** - for EVM chains, Solana, and Bitcoin. Standard JSON-RPC 2.0 format over HTTPS.
- **[gRPC](/apis/rpc/grpc)** - for Tron. Native gRPC protocol with metadata-based chain routing.


## Supported networks

| Network | CAIP-2 ID | Alias | Protocol |
|  --- | --- | --- | --- |
| Ethereum Mainnet | `eip155:1` | `ethereum` | JSON-RPC |
| BNB Smart Chain | `eip155:56` | `bsc` | JSON-RPC |
| BNB Smart Chain Testnet | `eip155:97` | `bsc-testnet` | JSON-RPC |
| Ethereum Hoodi | `eip155:560048` | `hoodi` | JSON-RPC |
| Ethereum Sepolia | `eip155:11155111` | `sepolia` | JSON-RPC |
| Solana Mainnet | `solana:mainnet` | `solana` | JSON-RPC |
| Solana Testnet | `solana:testnet` | `solana-testnet` | JSON-RPC |
| Bitcoin Mainnet | `bip122:000000000019d6689c085ae165831e93` | `bitcoin` | JSON-RPC |
| Bitcoin Testnet4 | `bip122:00000000da84f2bafbbc53dee25a72ae` | `bitcoin-testnet4` | JSON-RPC |
| Tron Mainnet | `tron:mainnet` | `tron` | gRPC |


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](/apis/platform/caip-standards) for details.

## Health check

Check service availability without authentication:


```bash
curl https://rpc.vilna.io/health
```


```json
{"status": "ok"}
```

## Further reading

JSON-RPC
HTTP requests for Ethereum, Solana, Bitcoin, and other chains

gRPC
gRPC node access for Tron

CAIP Standards
Chain and asset identification formats

Errors
Common API error handling and troubleshooting