FAQ

Does RPC Plane add latency?

Sub-millisecond overhead. Health scores are pre-computed by background tasks and stored in a shared atomic snapshot. The router reads the snapshot and makes an O(N) sort — no I/O in the hot path.

Can I use a single provider?

Yes. With one provider you still get health monitoring, slot drift detection, circuit breaker, auto-retry on transient errors, and Prometheus metrics.

What happens if all providers are down?

When all circuits are open, the proxy routes to all providers anyway — it tries them all rather than returning an immediate error. Degraded behaviour is better than refusing to attempt.

Does it support WebSocket?

Not yet. The proxy handles HTTP JSON-RPC only. WebSocket support is planned.

Does it work with devnet or testnet?

Yes. Use devnet or testnet provider URLs in your config. Running against multiple networks requires separate proxy instances (each with its own config and port).

Can I run it in Docker?

Yes:

docker run \
  -v $(pwd)/rpc-plane.toml:/etc/rpc-plane.toml \
  -p 9400:9400 \
  -p 9401:9401 \
  ghcr.io/rpcplane/rpc-plane

Set server.listen = "0.0.0.0:9400" in your config when running in Docker so the port is reachable from the host.

How do I reload the config without restarting?

Edit rpc-plane.toml. Changes apply within 2 seconds — no restart needed.

server.listen and server.metrics_listen are the only values that require a restart.

Is it production-safe?

Yes. Panics are caught at the request handler level so one bad request or provider response cannot crash the proxy. Memory usage is constant under sustained load — error rate uses a fixed sliding window and slot history is a single atomic integer per provider.

Does it phone home?

No. The free binary has zero outbound connections beyond the provider URLs you configure. The optional [reporting] block is absent by default.

What is the license?

The binary is Elastic License 2.0 (ELv2) — source-available. You can use, modify, and self-host it. You cannot offer it as a managed/hosted service to third parties.