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

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?.

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, 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 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, 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, Helius, Triton, entre outros) rodam os validadores e plugins Geyser para você e expõem endpoints de streaming atrás de uma API key.
• Pipelines de indexação como Substreams, 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.

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 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 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:

A maioria das aplicações Solana modernas nunca toca no validador ou no plugin Geyser diretamente. Elas abrem uma conexão Yellowstone 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 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 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: 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 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 é 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 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 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: 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: compatibilidade drop-in, redundância multi-node, e $75/TB sem mínimo mensal.