Skip to main content

​
Welcome to Sol RPC Router

Sol RPC Router is a production-ready reverse proxy designed specifically for Solana infrastructure. Built with Rust for maximum performance, it provides enterprise-grade API key authentication, per-key rate limiting, weighted load balancing, and automatic health monitoring for your Solana RPC endpoints.

Quick Start

Get up and running in 5 minutes with our quick start guide

Installation

Detailed installation instructions and prerequisites

Configuration

Configure backends, health checks, and routing rules

API Reference

Complete API documentation and endpoint reference

​
Key Features

API Key Authentication

Query parameter ?api-key= validated against Redis with local caching (60s TTL) for optimal performance

Per-Key Rate Limiting

Atomic RPS limits enforced in Redis using INCR + EXPIRE Lua scripts

Weighted Load Balancing

Distribute requests across backends by configurable weight. Unhealthy backends are automatically excluded

Method-Based Routing

Pin specific RPC methods (e.g. getSlot) to designated backends for optimal performance

WebSocket Proxying

Full WebSocket support with the same auth, rate limiting, and load balancing as HTTP requests

Health Monitoring

Background health checks with configurable thresholds control automatic backend failover

Prometheus Metrics

Comprehensive metrics for request counts, latencies, and backend health via /metrics endpoint

Admin CLI

Full-featured rpc-admin tool for creating, managing, and revoking API keys

​
Architecture Overview

Sol RPC Router acts as a smart gateway between your clients and Solana RPC providers:
Production Ready: Sol RPC Router is built with production workloads in mind, featuring atomic rate limiting, zero-downtime configuration reloads (SIGHUP), and comprehensive error handling.

​
Use Cases

Automatically route traffic across multiple Solana RPC providers with weighted distribution. When a provider goes down, traffic is seamlessly redirected to healthy backends.
Provide API keys to customers with individual rate limits. Track usage per key and revoke access instantly through the admin CLI.
Route expensive methods like getProgramAccounts to specific providers while using cheaper endpoints for simple queries like getSlot.
Protect your infrastructure from abuse with Redis-backed atomic rate limiting. Set different limits per customer or API key.

​
Next Steps

1

Quick Start

Follow the Quick Start guide to get Sol RPC Router running in minutes.
2

Configure Backends

Set up your Solana RPC backends and configure routing rules in the Configuration guide.
3

Create API Keys

Use the rpc-admin CLI to create and manage API keys for your users.
4

Monitor Performance

Connect Prometheus to the /metrics endpoint and build dashboards to monitor your infrastructure.

Build docs developers (and LLMs) love

Get started for freeTalk to us