Turbine

Multi-chain RPC proxy with intelligent endpoint rotation. Unlike EVM-only proxies, Turbine works with any blockchain that speaks JSON-RPC over HTTP.

Features

• Multi-chain — configure any number of chains, each with its own endpoint pool
• Round-robin rotation — distributes requests evenly across endpoints
• Passive health tracking — automatically detects and skips failing endpoints
• Auto-retry — retries with a different endpoint on failure
• Metrics — per-chain request/failure stats via /metrics

Install

cargo add turbine

As a Library

use turbine::Turbine;

#[tokio::main]
async fn main() {
    // Builder API — no config file needed
    let turbine = Turbine::builder()
        .add_chain("ethereum")
            .endpoint("https://eth.llamarpc.com")
            .endpoint("https://rpc.ankr.com/eth")
            .max_failures(3)
            .cooldown_secs(30)
            .done()
        .add_chain("solana")
            .endpoint("https://api.mainnet-beta.solana.com")
            .done()
        .build()
        .unwrap();

    // Run standalone
    turbine.serve("127.0.0.1:8080").await.unwrap();
}

Or embed in your existing axum app:

let turbine = Turbine::from_config("config.toml".as_ref()).unwrap();
let router = turbine.into_router();
// Merge with your own routes, add middleware, etc.

As a CLI

# Build
cargo build --release

# Run with default config
./target/release/turbine --config config.toml

# Or with overrides
./target/release/turbine --config config.toml --port 9090 --log-level debug

Configuration

See config.toml for a sample configuration.

[server]
host = "127.0.0.1"
port = 8080

[[chains]]
name = "ethereum"
route = "/ethereum"
endpoints = [
    "https://eth.llamarpc.com",
    "https://rpc.ankr.com/eth",
]

[chains.health]
max_consecutive_failures = 3
cooldown_seconds = 30

Usage

Send JSON-RPC requests to http://localhost:8080/<chain>:

# Ethereum
curl -X POST http://localhost:8080/ethereum \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}'

# Solana
curl -X POST http://localhost:8080/solana \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"getSlot","params":[],"id":1}'

# Metrics
curl http://localhost:8080/metrics