RPC Proxy

The Solana RPC proxy (solana-rpc-proxy) sits between clients and the test validator, providing automatic failover to Helius devnet.

Architecture

Client --> nginx-proxy --> solana-rpc-proxy (nginx:alpine)
                               |
                               +-- Primary: testnet-solana-rpc-gateway:8899
                               |
                               +-- Fallback (on 502/503/504): Helius devnet

Configuration

The proxy uses an nginx template with the HELIUS_API_KEY environment variable substituted at startup via entrypoint.sh.

Set SOLANA_HELIUS_DEVNET_API_KEY in .env to enable the fallback.