The engine behind reliable Solana apps

Intelligent RPC load balancing with circuit breaking, automatic failover, and real-time observability. Ship without RPC anxiety.

Works with leading RPC providers

Helius
Alchemy
QuickNode
Solana
Triton
GenesysGo

Why runicRPC?

Single RPC endpoints are a single point of failure. runicRPC gives you the resilience your application deserves.

The Problem

Single endpoints fail

  • Rate limits hit during peak traffic
  • Network outages cause complete downtime
  • Latency spikes degrade user experience
  • No automatic failover or retry logic
  • Limited visibility into endpoint health
The Solution

runicRPC handles it all

  • Pool requests across multiple providers
  • Circuit breakers prevent cascading failures
  • Intelligent routing minimizes latency
  • Automatic retries with exponential backoff
  • Real-time health checks and metrics
Architecture

How It Works

runicRPC sits between your app and RPC providers, intelligently routing requests and protecting against failures.

Your App
runicRPC logo
Circuit BreakerLoad BalancerCache
Helius
QuickNode
Alchemy
RPC Providers
Features

Everything you need

Production-grade features designed for high-throughput Solana applications

Intelligent Routing

Four strategies plus provider-specific routing. Route to the best endpoint for each method.

Circuit Breakers

Automatically detect failures and stop sending requests to unhealthy endpoints until they recover.

Automatic Retries

Exponential backoff with custom error classification and overflow-safe calculations.

Health Checks

Configurable probe methods and fallbacks. URL validation and continuous monitoring.

Rate Limiting

Token bucket algorithm per endpoint prevents hitting provider limits.

Request Deduplication

Consolidates identical in-flight requests. Single network call, shared result.

Response Caching

LRU cache with fair eviction. Custom cacheable methods via configuration.

WebSocket Support

Auto-reconnect with proper error handling. Seamless failover for subscriptions.

Prometheus Metrics

Enhanced metrics with quantiles (p50, p95, p99), circuit breaker states, and success rates.

Batch Requests

JSON-RPC 2.0 batch support. Send multiple requests in a single network call.

Middleware Hooks

beforeRequest, afterResponse, and onError hooks for custom processing logic.

Environment Config

Full configuration via environment variables. Zero-code setup for production.

Developer Experience

Simple API,
powerful results

Drop-in replacement for @solana/web3.js Connection. TypeScript support out of the box with full IntelliSense.

Auto-loads from .env, runic.config.json, or env vars
Middleware hooks for request/response processing
Batch requests and provider-specific routing
Enhanced Prometheus metrics with quantiles
Full TypeScript types included
app.ts
import { runicRPC } from '@runic-rpc/sdk';

// Auto-loads from .env or runic.config.json
const rpc = runicRPC.create({
  strategy: 'latency-based',
  cache: { enabled: true }
});

// Make requests
const balance = await rpc.request(
  'getBalance',
  [pubkey]
);
Routing

Smart routing strategies

Choose the routing strategy that fits your needs

Even Distribution

Round Robin

Simple rotation through all healthy endpoints

Recommended

Latency-Based

Routes to endpoint with best score (success rate / latency)

Custom Priority

Weighted

Distribute based on configured priority weights

Simple

Random

Random selection for natural load distribution

Ready to ship without
RPC anxiety?

Join the teams building reliable Solana applications with runicRPC. Get started in minutes.