Solana Geyser gRPC - Quickstart

Install SLV

bash
curl -fsSL https://storage.slv.dev/slv/install | sh

$ slv b init

slv b init
With a single command, slv b init, you can instantly scaffold a development environment for Solana bots using high-performance stream-based data.
bash
slv b init
  • Use geyser-ts if you prefer a TypeScript Geyser bot
  • Use geyser-rust if you prefer a Rust Geyser bot

Allowlist the gRPC load balancer IPs

The nearest node to your registered IP is picked using real-time ping checks from every regional gRPC load balancer. If ICMP is blocked by a firewall (ufw, security groups, etc.), the ping can show 9999ms, which may prevent the optimal nearby region from being selected. Allowlist the IPs below so your closest region is chosen automatically.
RegionDomainIP Address
πŸ‡³πŸ‡± Amsterdamgrpc-ams1.erpc.global84.32.103.245
πŸ‡³πŸ‡± Amsterdamgrpc-ams1.erpc.global84.32.64.77
πŸ‡ΊπŸ‡Έ New Yorkgrpc-ny6-1.erpc.global64.130.37.222
πŸ‡©πŸ‡ͺ Frankfurtgrpc-fra1-1.erpc.global185.191.118.149
πŸ‡©πŸ‡ͺ Frankfurtgrpc-fra1-1.erpc.global185.191.118.177
πŸ‡©πŸ‡ͺ Frankfurtgrpc-fra1-1.erpc.global185.191.118.206
πŸ‡¬πŸ‡§ Londongrpc-lon6-1.erpc.global67.209.52.250
πŸ‡―πŸ‡΅ Tokyogrpc-tokyo-6.erpc.global198.13.133.88
πŸ‡ΈπŸ‡¬ Singaporegrpc-sgp6-1.erpc.global202.8.11.52
πŸ‡¦πŸ‡Ί Sydneygrpc-syd-1.erpc.global82.26.116.36
πŸ›°οΈ Far Pointgrpc-far-point.erpc.global63.254.162.14

Burst gRPC endpoints

Geyser gRPC Burst is ERPC's low-latency shared gRPC tier for latency-sensitive Solana stream workloads. Burst uses the same Yellowstone/Geyser gRPC interface as the regular gRPC service, so existing gRPC clients can keep using standard account, transaction, slot, and block subscriptions.
Burst currently runs in Frankfurt, Amsterdam, New York, Tokyo, and Singapore. Latency selection still uses the regular gRPC ping-source IPs listed above; the Burst load balancer IPs below are the public Burst endpoints to allow for client connections.
RegionBurst DomainIP Address
πŸ‡©πŸ‡ͺ Frankfurtgrpc-fra1-burst.erpc.global64.130.41.234
πŸ‡³πŸ‡± Amsterdamgrpc-ams1-burst.erpc.global64.130.55.180
πŸ‡ΊπŸ‡Έ New Yorkgrpc-ny6-burst.erpc.global64.130.59.217
πŸ‡―πŸ‡΅ Tokyogrpc-tokyo-burst.erpc.global208.91.107.247
πŸ‡ΈπŸ‡¬ Singaporegrpc-singapore-burst.erpc.global67.209.55.15
Use the endpoint shown in the ERPC Web Dashboard after registering your IP. Burst remains a full Geyser gRPC stream; Direct Shreds/ShredStream is a separate UDP-based product for raw shred data.

Geyser Client Example – TypeScript

  1. Rename .env.sample to .env
  2. Edit .env with your actual values:
ini
GEYSER_ENDPOINT=http://grpc-ams1.erpc.global
SOLANA_RPC_ENDPOINT="https://edge.erpc.global?api-key=YOUR_API_KEY"
Please note:
This endpoint is a sample and cannot be used as is. Please obtain and configure the appropriate endpoint for your environment.
  1. Install dependencies and start the development server:
bash
pnpm i
pnpm dev
Geyser TypeScript VSCode

Geyser Client Example – Rust

  1. Rename .env.sample to .env
  2. Edit .env with your actual values:
ini
GEYSER_ENDPOINT=http://grpc-ams1.erpc.global
SOLANA_RPC_ENDPOINT="https://edge.erpc.global?api-key=YOUR_API_KEY"
Please note:
This endpoint is a sample and cannot be used as is. Please obtain and configure the appropriate endpoint for your environment.
  1. Build and run the client:
bash
RUST_LOG=info cargo run
Geyser Rust VSCode

βœ… 1-Day Free Trial Available

Both Geyser and Shreds bots can be tested for free for 1-Day via the ERPC Web Dashboard.

Solana Stream SDK

Solana Stream SDK
The Geyser adapter used in the starter code downloaded via the slv b init command
is provided by the open-source Solana Stream SDK.
It supports both Rust and TypeScript, enabling efficient implementation of Solana stream communication,
including Geyser subscriptions, transaction processing, and real-time account update monitoring.
The starter code you obtain is a direct example of this SDK in action,
making it easy to extend for your own bot development or custom logic.
For more details, visit the GitHub repository:
https://github.com/ValidatorsDAO/solana-stream