Skip to main content

Welcome to Yellowstone gRPC

Yellowstone Dragon’s Mouth is a high-performance gRPC interface for Solana, built around the Geyser plugin framework. It provides real-time streaming of blockchain data including accounts, transactions, blocks, and slots through a standardized gRPC API.

Quick Start

Get up and running with Yellowstone gRPC in minutes

Architecture

Understand how Yellowstone gRPC works

Geyser Plugin

Deploy the plugin to your Solana validator

Client SDKs

Connect using Rust, TypeScript, or other languages

Key Features

Real-time Streaming

Stream accounts, transactions, blocks, and slots as they happen on the Solana blockchain

Advanced Filtering

Filter data by account, owner, transaction signature, and custom memcmp conditions

High Performance

Built with gRPC for low latency and high throughput, with support for compression

Multiple SDKs

Official Rust and TypeScript clients, plus examples for Go and Python

Block Reconstruction

Get complete blocks with detailed transaction and account update information

Monitoring

Prometheus metrics for observability and performance tuning

What is Geyser?

Geyser is Solana’s plugin interface that allows validators to stream account updates, transaction data, and block information in real-time. Yellowstone gRPC implements a Geyser plugin that exposes this data through a gRPC API, making it accessible to external applications.

Use Cases

Monitor specific Solana accounts for balance changes, data updates, or ownership transfers. Perfect for tracking token accounts, program state, or NFT collections.
Build custom transaction indexers that process Solana transactions in real-time. Filter by program IDs, account involvement, or transaction signatures.
Power block explorers and analytics platforms with comprehensive block data including all transactions, account updates, and metadata.
Stream price feeds, liquidity pool updates, and trading activity for decentralized finance applications.
Track NFT mints, transfers, and marketplace activity across Solana NFT programs.

How It Works

  1. The Yellowstone gRPC plugin loads into a Solana validator via the Geyser interface
  2. Your application connects to the gRPC server and sends subscription requests with filters
  3. The plugin streams real-time updates matching your filters
  4. Your application processes the updates as they arrive

Getting Started

1

Choose Your Path

Decide whether you want to deploy the Geyser plugin or connect to an existing endpoint
2

Install a Client SDK

Use the Rust or TypeScript client, or connect with any gRPC-compatible library
3

Subscribe to Data

Configure filters to receive only the data you need
4

Process Updates

Handle incoming account, transaction, block, and slot updates in your application

Ready to start?

Follow our quickstart guide to connect to Yellowstone gRPC

Community and Support

Yellowstone gRPC is built and maintained by Triton One. For additional documentation and support:

Build docs developers (and LLMs) love