---
title: "O que é o Solana Geyser Plugin? Um guia de 2026 para desenvolvedores"
description: "Saiba o que é o Solana Geyser Plugin, como ele se relaciona com o Yellowstone gRPC e quando usar streaming em vez de RPC. Atualizado para 2026."
---

# O que é o Solana Geyser Plugin? Um guia de 2026 para desenvolvedores

<ImageBlock
  src="https://media.alchemy.com/1703182882-what-is-the-solana-geyser-plugin.jpg"
  alt="Stack de dados do Solana Geyser Plugin"
  width={1800}
  height={945}
  priority
/>

**TL;DR: Geyser, Yellowstone e quando usar streaming**

- **Geyser:** Um plugin do lado do validador que envia atualizações de contas, slots, transações, blocos e entries para sistemas externos. Sem polling.
- **Yellowstone gRPC:** O protocolo de rede que a maioria dos desenvolvedores usa hoje. Ele encapsula o Geyser e expõe streams pela rede.
- **Use streaming quando:** Você precisa de cada escrita de conta, confirmações em menos de um segundo, ou está fazendo loop de `getProgramAccounts` (indexers, MEV, fill engines, monitores de AMM).
- **Use RPC quando:** Leituras ocasionais (saldos, transações individuais, slot atual).
- **Alchemy:** Roda validador + Geyser + gRPC compatível com Yellowstone. Entrega média de 5-15ms, redundância multi-node, a partir de $75/TB sem mínimo mensal.

Se você for ler apenas uma seção, leia [Quando sua equipe deveria se importar com o Geyser?](#when-should-your-team-care-about-geyser).

O Solana Geyser Plugin é uma interface do lado do validador que transmite mudanças de estado em tempo real (atualizações de contas, status de slot, transações, blocos e entries) de um validador Solana para sistemas externos como bancos de dados, filas de mensagens ou indexers.

Geyser é o *mecanismo dentro do validador*. O protocolo com o qual a maioria dos desenvolvedores interage hoje, **[Yellowstone gRPC](https://www.alchemy.com/solana-grpc)**, fica em cima do Geyser e expõe esses streams pela rede para que aplicações possam consumi-los sem rodar seu próprio validador. Use [Solana RPC](https://www.alchemy.com/solana) para consultas ocasionais. Use um stream Geyser compatível com Yellowstone quando você precisar de cada mudança de conta, transação ou slot em tempo real sem chamar `getProgramAccounts` em loop.

## O que mudou no Solana Geyser Plugin desde 2023

Geyser chegou no Solana 1.9 como um plugin trait dentro do validador. Em 2023, a maioria das equipes rodava seu próprio validador com um plugin PostgreSQL ou Kafka compilado diretamente nele. Esse padrão agora é raro.

Desde então:

- **Yellowstone gRPC** (originalmente desenvolvido pela [Triton One](https://github.com/rpcpool/yellowstone-grpc), agora mantido pela comunidade) surgiu como o protocolo padrão que encapsula o Geyser e expõe streams pela rede. A maioria dos "provedores de Geyser" hoje na verdade vende gRPC compatível com Yellowstone.
- **Provedores gerenciados** ([Alchemy](https://www.alchemy.com/solana-grpc), Helius, Triton, entre outros) rodam os validadores e plugins Geyser para você e expõem [endpoints de streaming](https://www.alchemy.com/solana-grpc) atrás de uma API key.
- **Pipelines de indexação** como Substreams, [Carbon](https://www.alchemy.com/dapps/carbon), e várias stacks proprietárias consomem streams Yellowstone em vez de fazer polling em RPC.

Se o seu blog ou documentação ainda diz "compile o plugin PostgreSQL no seu validador", esse workflow existe mas não é mais o caminho que a maioria das equipes segue. Para uma comparação lado a lado dos provedores que rodam essas stacks, veja nosso [guia dos melhores provedores de Solana RPC](https://www.alchemy.com/overviews/solana-rpc).

## O que o Solana Geyser Plugin realmente faz

Um plugin Geyser é uma biblioteca compartilhada que o validador carrega na inicialização. O validador implementa o [`GeyserPlugin` trait](https://docs.solana.com/developing/plugins/geyser-plugins) e chama o plugin toda vez que algo relevante acontece onchain. O plugin então decide o que fazer com esses dados: gravar em um banco de dados, enviar para uma fila, transmitir por um stream gRPC, descartar, etc.

O validador empurra os dados; o plugin reage. Esse é todo o modelo. Não há polling, não há chamada RPC, e não há rate limit. Os dados chegam no momento em que o validador os processa.

### O que é transmitido

Geyser expõe hooks para:

1. **Atualizações de contas:** Cada escrita em cada conta, com o slot, a write version e os dados completos da conta.
2. **Mudanças de status de slot:** `processed`, `confirmed`, `rooted`.
3. **Transações:** Detalhes completos da transação, incluindo logs e instruções internas, conforme o validador as confirma.
4. **Blocos:** Metadados do bloco, incluindo recompensas, slot pai e contagem de entries.
5. **Entries:** Unidades de sub-bloco (entries PoH), úteis para os consumidores mais sensíveis a latência.

Um plugin pode se inscrever em qualquer subconjunto. [Yellowstone gRPC](https://www.alchemy.com/solana-grpc) expõe o mesmo conjunto de hooks como streams de subscription com filtragem do lado do servidor (por conta, programa, owner, assinatura ou data slice).

## Quando sua equipe deveria se importar com o Geyser?

Use um stream baseado em Geyser quando **qualquer uma** destas condições for verdadeira:

- Você precisa de cada escrita de conta de um programa (por exemplo, um AMM, um orderbook, um mercado de lending). `getProgramAccounts` é lento e caro demais.
- Você está construindo um indexer, um fill engine, um bot de MEV, ou um pipeline de analytics em tempo real.
- Você precisa de eventos de confirmação de transação com latência abaixo de um segundo.
- Você está paginando por grandes conjuntos de dados e gastando créditos de RPC nisso.
- Você precisa de um histórico ordenado e sem lacunas do estado de um programa.

Você provavelmente *não* precisa do Geyser quando:

- Você faz leituras ocasionais (saldo de token, consulta de transação única, slot atual). RPC é a ferramenta certa.
- Sua aplicação é focada em leitura orientada por consultas do usuário, e não em consumo de stream de escrita.

## Como Geyser, Yellowstone, gRPC e indexers se encaixam

A stack moderna de dados da Solana tem quatro camadas:

<EmbeddedTable
  table={{
    columns: [
      { key: "1", width: 160, title: "Layer", dataType: "object" },
      { key: "2", width: 280, title: "What it is", dataType: "object" },
      { key: "3", width: 200, title: "Who runs it", dataType: "object" },
    ],
    data: [
      {
        "1": { title: "<p><strong>Validator</strong></p>", tooltip: "", icon: "" },
        "2": {
          title: "<p>The Solana node processing transactions</p>",
          tooltip: "",
          icon: "",
        },
        "3": {
          title: "<p>Validator operators (or your provider)</p>",
          tooltip: "",
          icon: "",
        },
        id: 0,
      },
      {
        "1": { title: "<p><strong>Geyser plugin</strong></p>", tooltip: "", icon: "" },
        "2": {
          title: "<p>Validator-loaded library that receives state-change callbacks</p>",
          tooltip: "",
          icon: "",
        },
        "3": {
          title: "<p>Compiled into the validator</p>",
          tooltip: "",
          icon: "",
        },
        id: 1,
      },
      {
        "1": { title: "<p><strong>Yellowstone gRPC</strong></p>", tooltip: "", icon: "" },
        "2": {
          title: "<p>Standardized streaming protocol on top of Geyser</p>",
          tooltip: "",
          icon: "",
        },
        "3": {
          title: "<p>Exposed by your provider's endpoint</p>",
          tooltip: "",
          icon: "",
        },
        id: 2,
      },
      {
        "1": { title: "<p><strong>Indexer / consumer</strong></p>", tooltip: "", icon: "" },
        "2": {
          title: "<p>Your app, your database, your pipeline</p>",
          tooltip: "",
          icon: "",
        },
        "3": { title: "<p>You</p>", tooltip: "", icon: "" },
        id: 3,
      },
    ],
  }}
/>

A maioria das aplicações Solana modernas nunca toca no validador ou no plugin Geyser diretamente. Elas abrem uma conexão [Yellowstone gRPC](https://www.alchemy.com/solana-grpc), se inscrevem nas fatias que interessam (filtrando por programa, owner, assinatura, etc.), e transmitem eventos para a camada de armazenamento ou processamento que construíram. O [provedor de streaming](https://www.alchemy.com/solana-grpc) roda o validador, carrega o plugin Geyser, e expõe o Yellowstone na outra ponta dessa conexão.

O gRPC compatível com Yellowstone é amplamente suportado em Rust, TypeScript, Go, e qualquer linguagem capaz de compilar um `.proto`, então a migração entre provedores é tipicamente uma troca de URL e chave.

## Onde a Alchemy se encaixa na stack moderna de dados da Solana

[Alchemy](https://www.alchemy.com/solana) roda o validador, o plugin Geyser, e a camada gRPC compatível com Yellowstone para você. Alguns pontos valem a pena conhecer se você está avaliando provedores:

- **[gRPC compatível com Yellowstone](https://www.alchemy.com/solana-grpc):** Compatibilidade drop-in em Rust, TypeScript, Go. A migração é uma mudança de URL.
- **Entrega média de 5-15ms:** Garantias de first-slot-data para consumidores sensíveis a latência.
- **Replay de blocos de 48 horas e mais de 6.000 slots históricos:** Recuperável sob demanda, então desconexões breves ou reinicializações não custam dados.
- **Redundância multi-node:** Cada subscription é distribuída entre múltiplos nós upstream, então um único nó lento ou travado nunca aparece no seu stream.
- **Endpoints regionais:** US East, US West, EU Central, Ásia-Pacífico.
- **Pague apenas pelo que você transmite:** $75 por TB, sem mínimo mensal.
- **Métricas compatíveis com Prometheus:** Telemetria por stream integrada ao dashboard da Alchemy.

A [stack Solana](https://www.alchemy.com/solana) da Alchemy foi construída do zero em colaboração com engenheiros Solana de referência da DexterLab e Bware Labs, e move Phantom, Solflare, Robinhood, OpenSea e Circle.

## Perguntas frequentes

### O que é o Solana Geyser Plugin?

O Geyser Plugin é uma interface do lado do validador que transmite mudanças de estado em tempo real (atualizações de contas, status de slot, transações, blocos e entries) de um validador Solana para sistemas externos. É um modelo push: o validador notifica os plugins conforme os dados chegam, sem polling ou overhead de RPC.

### Qual é a diferença entre Geyser e Yellowstone?

Geyser é a interface interna de plugin do validador. [Yellowstone](https://www.alchemy.com/solana-grpc) é o protocolo de rede (construído sobre gRPC) que expõe streams do Geyser para clientes remotos. Hoje, a maioria dos desenvolvedores interage com o Yellowstone, não com o Geyser diretamente. Eles se conectam a um endpoint gRPC Yellowstone operado por um provedor de streaming, em vez de compilar um plugin Geyser no próprio validador.

### Quando devo usar Geyser/Yellowstone em vez de RPC?

Use streaming quando precisar de cada escrita de conta, cada transação ou cada slot em tempo real. Isso é comum para indexers, bots de MEV, fill engines, monitores de AMM/orderbook, e analytics em tempo real. Use RPC para leituras ocasionais (saldos, transações individuais, contas individuais). Se você se pegar chamando `getProgramAccounts` em loop, esse é o sinal para migrar para streaming.

### Preciso rodar meu próprio validador para usar o Geyser?

Não. Em 2023 isso era comum; em 2026 a maioria das equipes usa um [endpoint gRPC gerenciado compatível com Yellowstone](https://www.alchemy.com/solana-grpc) de um provedor que cuida do validador e do plugin Geyser para elas. O self-hosting fica reservado para equipes com requisitos regulatórios ou de soberania.

### O que posso transmitir com uma subscription Geyser/Yellowstone?

Atualizações de contas, mudanças de status de slot (`processed`/`confirmed`/`rooted`), transações com logs e instruções internas, metadados de bloco, e entries PoH. [Yellowstone gRPC](https://www.alchemy.com/solana-grpc) suporta filtragem do lado do servidor por conta, programa, owner, assinatura ou data slice, então o stream carrega apenas o que sua aplicação precisa.

### Como faço para migrar entre provedores de Yellowstone?

Yellowstone é um protocolo padronizado, então a maioria das migrações é uma mudança de URL e API key. Verifique se o novo provedor suporta os streams e filtros que você usa, teste em staging, e libere o tráfego gradualmente. O comportamento de reconnect-with-backfill varia entre provedores, então confirme isso antes de migrar workloads de produção.

### Quanto custa o streaming Geyser/Yellowstone?

Os modelos de precificação variam. O preço por TB ([Alchemy](https://www.alchemy.com/solana-grpc): a partir de $75/TB, sem mínimo mensal) é o mais previsível para workloads com picos. Alguns provedores incluem o gRPC em planos mensais com dados incluídos, o que pode ser mais barato em volume estável mas caro se o tráfego tiver picos. Sempre faça benchmark contra seus filtros de subscription reais antes de se comprometer.

*Pronto para construir na Solana? [Faça streaming com o gRPC da Alchemy compatível com Yellowstone](https://www.alchemy.com/solana-grpc): compatibilidade drop-in, redundância multi-node, e $75/TB sem mínimo mensal.*