Skip to content

Solana

Smart Router serves Solana mainnet over JSON-RPC. This page covers the supported methods, the example config, and how to connect a client.

Endpoint
Default port 3360 (override per endpoints[] entry)
Calling convention POST / with a JSON-RPC body
chain-id SOLANA
Spec specs/solana.json

Supported method families

Solana uses its own JSON-RPC, not the Ethereum one.

Family Examples
State / accounts getAccountInfo, getBalance, getMultipleAccounts, getProgramAccounts, getTokenAccountBalance
Blocks / slots getSlot, getBlock, getBlockHeight, getBlockTime, getBlocks, getLatestBlockhash
Transactions getTransaction, getSignatureStatuses, sendTransaction, simulateTransaction
Network / node getHealth, getVersion, getEpochInfo, getClusterNodes, getGenesisHash

The spec file linked above has the full method list.

Slot vs. block height

Smart Router tracks the slot on both the chain-tracker and consistency sides, so cross-node consistency checks compare the same units. Solana's context.slot and lastValidBlockHeight differ by the skip rate (tens of millions on mainnet).

Run this example

The repo has a ready-to-run config at config/smartrouter_examples/smartrouter_solana.yml. It uses two public upstreams (PublicNode and the Solana Labs public RPC) and needs no API key. The example is HTTP-only, so run it with --skip-websocket-verification:

SR_CONFIG=config/smartrouter_examples/smartrouter_solana.yml \
  docker compose -f docker/docker-compose.yml up --build

smartrouter config/smartrouter_examples/smartrouter_solana.yml \
  --use-static-spec specs/ --skip-websocket-verification

Then call it:

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

Connect a client

import { Connection } from '@solana/web3.js';
const connection = new Connection('http://127.0.0.1:3360');
const slot = await connection.getSlot();

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

To use your own upstreams, edit the node-urls in the config. See The config file.