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 shows 9999ms and the Far Point node is selected even when a closer region exists. Allowlist the IPs below so your closest region is chosen automatically.
RegionDomainIP Address
🇳🇱 Amsterdamgrpc-ams6-1.erpc.global64.130.52.145
🇩🇪 Frankfurtgrpc-fra6-1.erpc.global64.130.50.30
🇺🇸 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
🛰️ Far Pointgrpc-far-point.erpc.global84.32.70.28

Geyser Client Example – TypeScript

  1. Rename .env.sample to .env
  2. Edit .env with your actual values:
env
X_TOKEN=YOUR_X_TOKEN_OR_API_KEY GEYSER_ENDPOINT=https://grpc-ams.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:
env
X_TOKEN=YOUR_X_TOKEN_OR_API_KEY GEYSER_ENDPOINT=https://grpc-ams.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