Solana

Firehose chain-specific configuration for Solana

This page covers Reader Node configuration specific to Solana. For general Firehose architecture and deployment, see the Single Machine Deployment or Distributed Deployment guides.

This guide does not cover how to run a Solana validator. For validator setup, hardware requirements, and network configuration, refer to the official Solana documentation.

Architecture

Firehose for Solana uses a Geyser plugin approach. The plugin hooks into the Solana validator and emits Firehose Protocol data through a gRPC interface.

┌──────────────────────────────────────────────────────┐
│                  Solana Validator                    │
│  ┌────────────────────────────────────────────────┐  │
│  │           Firehose Geyser Plugin               │  │
│  │  (emits blocks via gRPC on port 10015)         │  │
│  └────────────────────────────────────────────────┘  │
└──────────────────────────────────────────────────────┘
                         │
                         ▼ gRPC
┌──────────────────────────────────────────────────────┐
│    firesolana (reader-node-firehose mode)            │
│    Consumes blocks and produces one-block files      │
└──────────────────────────────────────────────────────┘

Docker Image

ghcr.io/streamingfast/firehose-geyser-plugin:<version>

View available versions on GitHub Packages

The image contains the Solana validator with the Firehose Geyser plugin pre-installed.

Binary & Releases

Component	Repository	Binary
Firehose	firehose-solana	firesolana
Geyser Plugin	firehose-geyser-plugin	Shared library

Download releases from the GitHub releases pages.

Networks

Network	Chain Name
Solana Mainnet	solana-mainnet-beta
Solana Devnet	solana-devnet
Solana Testnet	solana-testnet

Reader Node Configuration

Solana Firehose uses reader-node-firehose mode, which connects to the Geyser plugin's gRPC endpoint instead of spawning a subprocess.

Reader Node (Firehose Mode)

firesolana start reader-node-firehose <apps> \
  --reader-node-firehose-grpc-listen-addr=<geyser-plugin-grpc-addr> \
  --advertise-chain-name="solana-mainnet-beta" \
  <other_flags...>

Geyser Plugin Configuration

The Geyser plugin is configured via a JSON file passed to the Solana validator. The plugin emits Firehose data on a gRPC endpoint.

Example Plugin Configuration

{
  "libpath": "/path/to/libfirehose_geyser_plugin.so",
  "blocks_grpc_listen_addr": "0.0.0.0:10015",
  "accounts_grpc_listen_addr": "0.0.0.0:10016"
}

Starting the Validator

solana-validator \
  --geyser-plugin-config /path/to/firehose-geyser-config.json \
  <other_validator_flags...>

Resources

• firehose-solana GitHub

• firehose-geyser-plugin GitHub

• Solana Documentation

• Solana Geyser Plugin Interface