Smart Router Open Source

Three commands to a running Smart Router

Install the binary, point it at an RPC, send a request. Smart Router is a centralised RPC routing gateway with QoS-based provider selection, caching, hedging, retries, and cross-validation.

Read the full docs View on GitHub

docs.magmadevs.com

Full guides, API reference, configuration, and deployment runbooks for Smart Router.

QuickstartConfigurationAPI referenceDeploymentSupported chains

Get the binary

Clone the repo and build Smart Router from source.

git clone https://github.com/Magma-Devs/smart-router.git
cd smart-router
make install-all

Prefer a container? Jump to Docker.

Run

Generates a config from config/smartrouter_examples/ and starts the router on port 3360.

./scripts/pre_setups/init_smartrouter_eth.sh

Make a request

Send a JSON-RPC call through the router to confirm it's relaying traffic.

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

Full quickstart

Open core, free to run

Smart Router's core is open source. You can read exactly what's routing and validating your traffic. No black box between your app and the chain.

github.com/Magma-Devs/smart-router

Deploy it your way

Same config shape across dev, staging, and prod. Pick the substrate that fits your stack.

Docker

Distroless image, one command to run. Best for local dev and single-host deployments.

Docs

Kubernetes

Helm chart and reference manifests. Horizontal scaling with shared block-aware cache.

Docs

Bare metal / VM

Static binary, systemd unit. Pin it next to your validators or in a private VPC.

Docs

Run with Docker

The repo ships a multi-stage Dockerfile that produces a distroless image with the smart-router binary as the entrypoint. Build it locally, then run:

docker run --rm \
  -p 3360:3360 \
  -p 7779:7779 \
  -v "$(pwd)/config:/smart-router/config:ro" \
  -v "$(pwd)/specs:/smart-router/specs:ro" \
  smart-router:local \
  rpcsmartrouter \
  /smart-router/config/smartrouter_examples/smartrouter_eth.yml \
  --geolocation 1 \
  --use-static-spec /smart-router/specs/

· 3360: request listener
· 7779: Prometheus metrics
· Mount your config/ and specs/ as read-only volumes.

Docker deployment docs

Licensing

Open source

Noncommercial license

Free to read, run, and modify for evaluation, research, and personal use. Source is on GitHub: read what's routing and validating your traffic.

Production use

Commercial license

Required to run Smart Router commercially or in production. Talk to us for pricing.

Where to next

Integrating with an app → Using the API
Operating the router → Configuration, Deployment
Evaluating → Why Smart Router?
Supported chains → Ethereum, Solana, Bitcoin, and 100+ more

Want it managed?

This quickstart covers the self-hosted Smart Router. If you'd rather not operate it yourself, talk to us.

Need a hand getting started? Join our Telegram community, reach out to our team or browse all plans.