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
🇩🇪 Frankfurtgrpc-fra1-1.erpc.global185.191.118.149
🇺🇸 New Yorkgrpc-ny6-1.erpc.global64.130.59.62
🇺🇸 Chicagogrpc-chi-1.erpc.global84.32.32.147
🇯🇵 Tokyogrpc-tokyo-6.erpc.global143.20.238.2
🇸🇬 Singaporegrpc-sgp6-1.erpc.global202.8.11.52

Geyser Client Example – TypeScript

  1. Rename .env.sample to .env
  2. Edit .env with your actual values. Shared gRPC endpoints no longer require an x-token:
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. Shared gRPC endpoints no longer require an x-token:
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 official Validators DAO Discord server.

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