helius-laserstream SDK.
Pré-requisitos: Este guia pressupõe que você completou o Guia Rápido de LaserStream gRPC e possui uma chave de API.
Tipos de Monitoramento
- Atualizações de Slot
- Dados de Bloco
- Metadados de Bloco
Acompanhe a progressão do consenso da redeMonitore o avanço dos slots através dos níveis de compromisso:Os dados de slot incluem: número do slot, slot pai, status de compromisso (
processed / confirmed / finalized) e informações sobre o líder.Melhor para: Monitoramento da saúde da rede, análise de tempo de slot, acompanhamento de consenso.
Exemplos Práticos
Exemplo 1: Monitor de Saúde da Rede
Acompanhe a progressão dos slots e identifique problemas na rede:Exemplo 2: Monitor de Produção de Blocos
Acompanhe a produção de blocos e volume de transações:Exemplo 3: Monitor de Blocos Filtrados
Monitore blocos contendo atividades de programas específicos:Estruturas de Dados
Estrutura de Dados do Slot
Estrutura de Dados do Slot
processed (inicial), confirmed (supermaioria votada), finalized (irreversível).Estrutura de Metadados de Bloco
Estrutura de Metadados de Bloco
Estrutura de Blocos Completos
Estrutura de Blocos Completos
Number(...) para aritmética. Dentro de cada transação, meta.fee, meta.preBalances, meta.postBalances, etc. também são strings.Considerações de Desempenho
Monitoramento de Slots
Leve: muito baixa largura de banda, sobrecarga mínima de processamento. Bom para painéis de monitoramento.
Metadados de Blocos
Balanceado: largura de banda moderada, insights em nível de bloco sem dados completos. Adequado para análises.
Blocos Completos
Alto volume: dados completos de transações, requer processamento robusto. Sempre emparelhe com filtros.
Blocos Filtrados
Otimizado: use
accountInclude, desative includeAccounts/includeEntries que você não precisa.Casos de Uso
- Monitoramento de Rede
- Análises e Métricas
- Sincronização de Aplicação
Acompanhe a saúde e o desempenho da rede — tempo de slot, congestionamento, consenso.
Tratamento de Erros
Slots Perdidos
Slots Perdidos
Sintoma: Lacunas na progressão dos slots.Causas: Problemas de conectividade de rede, tempo de inatividade do validador, atrasos no processamento do cliente.Soluções: Acompanhe lacunas de slots e alerte; implemente lógica de recuperação via reprodução histórica; monitore a saúde da conexão.
Alto Volume
Alto Volume
Sintoma: Dados de blocos em excesso.Soluções: Use metadados de blocos em vez de blocos completos; aplique filtros de contas; desative inclusões desnecessárias (entradas, contas); processe de forma assíncrona.
Problemas de Tempo
Problemas de Tempo
Sintoma: Tempo de slot inconsistente.Análise: Calcule médias móveis; acompanhe desvios; monitore métricas de saúde da rede; correlacione com desempenho do validador.
Melhores Práticas
Diretrizes de Produção:
- Comece com metadados — use metadados de blocos antes de se inscrever em blocos completos
- Aplique filtros — use
accountIncludepara descartar dados irrelevantes - Monitore o tempo — acompanhe a progressão dos slots como um indicador de saúde da rede
- Lide com lacunas — combine com reprodução histórica para que slots perdidos sejam automaticamente preenchidos na reconexão
- Processe de forma assíncrona — não bloqueie o processamento de fluxo com cálculos pesados
- Correspondência de compromisso à necessidade —
processedpara UIs de baixa latência,confirmed/finalizedpara gravações de estado
Próximos Passos
Monitoramento de Transações
Filtre transações por programa, conta, voto ou status de falha.
Transmitir Dados AMM Pump
Exemplo do mundo real: monitore transações do Pump AMM.
Decodificação de Dados de Transação
Analise as cargas
transactionUpdate binárias em transações Solana legíveis.Referência do protocolo Yellowstone
O mesmo fluxo de trabalho contra o protocolo Yellowstone gRPC bruto.